Skip to content

feat: add DerivedReadinessColumnExpr support and update API types#70

Open
fern-api[bot] wants to merge 1 commit intomainfrom
fern-bot/2026-03-18T14-46Z
Open

feat: add DerivedReadinessColumnExpr support and update API types#70
fern-api[bot] wants to merge 1 commit intomainfrom
fern-bot/2026-03-18T14-46Z

Conversation

@fern-api
Copy link
Contributor

@fern-api fern-api bot commented Mar 18, 2026

Version Bump: Removed ParsingJob.JobId field and changed BodyCreateLabReportParserJob.File from io.Reader to []io.Reader - existing callers will get compile errors.

  • The SDK now supports derived readiness columns in query expressions, enabling queries against readiness metrics like chronotype, sleep score, recovery score, strain score, and recovery zones. Lab report parsing has been enhanced with multi-file upload support and structured failure reasons. Several API types have been updated to use optional fields for better null handling.
  • The SDK now supports PSC appointment booking with idempotency keys and async confirmation controls. New appointment notes can be included when booking or rescheduling appointments. Added support for Sonora Quest lab provider and expanded query filters for orders and markers.
  • The SDK now supports Samsung Health as a manual provider through the new ManualProvidersSamsungHealth enum value. The ManualConnectionData struct has been enhanced with new fields for tracking SDK versions (VitalIosSdkVersion, VitalAndroidSdkVersion) and granted permissions (GrantedPermissions).
  • The SDK now supports lab report parsing job events and enhanced biomarker result types. New event types include ClientFacingLabReportParsingJobCreatedEvent and ClientFacingLabReportParsingJobUpdatedEvent. The enhanced BiomarkerResult type includes reference ranges, LOINC codes, source markers, and performing laboratory information. Additional support includes new sample data structures with clinical information, enhanced address fields for delivery notes, and expanded provider/lab support including Samsung Health and Sonora Quest.
  • The SDK now uses a new UserAddress type for address fields in UserInfo and UserInfoCreateRequest. New client packages are available: Compendium, LabAccount, and OrderTransaction.
  • The SDK now supports form URL-encoded request bodies and improved multipart file uploads. Lab report parsing now accepts multiple files in a single request, and the HTTP client automatically handles different content types including application/x-www-form-urlencoded.
  • The Go SDK has migrated to a versioned module path. Update all imports from github.com/tryVital/vital-go to github.com/tryVital/vital-go/v505. All API functionality remains identical.
  • Breaking Change: The Go module path has been updated from github.com/tryVital/vital-go to github.com/tryVital/vital-go/v505. All import statements must be updated to reference the new versioned module path. Replace import "github.com/tryVital/vital-go" with import v505 "github.com/tryVital/vital-go/v505" in your code.
  • Breaking change: All import paths have been updated to use the versioned module path github.com/tryVital/vital-go/v505. Update your imports from github.com/tryVital/vital-go to github.com/tryVital/vital-go/v505 and replace vitalgo type references with v505.
  • The SDK has migrated to a versioned package structure. All import statements must be updated from github.com/tryVital/vital-go to github.com/tryVital/vital-go/v505. All type references that previously used vitalgo.TypeName should now use v505.TypeName. Update your imports and type references to use the new v505 package structure.
  • Import paths have changed from "github.com/tryVital/vital-go" to "github.com/tryVital/vital-go/v505". Update your import statements to use the new versioned module path. All function signatures and behavior remain unchanged.
  • New compendium types available for laboratory test search and provider conversion functionality, including comprehensive search request/response structures and lab provider enums.
  • The SDK now supports three new client capabilities: compendium operations for medical data search and conversion, lab account management for retrieving team lab accounts, and order transaction tracking with support for retrieving transaction details, results, and PDF reports.
  • New ordertransaction.RawClient available with methods for retrieving transaction data, lab results, and PDF reports. Includes GetTransaction(), GetTransactionResult(), and GetTransactionResultPdf() methods.

This SDK regeneration adds support for derived readiness columns in query expressions, 
updates several API types for improved data handling, and restructures lab report parsing 
functionality. The changes expand querying capabilities for readiness data while maintaining 
backward compatibility.

Key changes:
- Add DerivedReadinessColumnExpr with readiness metrics (chronotype, sleep_score, recovery_score, etc.)
- Support derived_readiness index in IndexColumnExpr enum
- Update QueryBatch to require timeframe and queries fields (remove optional markers)
- Change BodyCreateLabReportParserJob.File from io.Reader to []io.Reader for multi-file support
- Remove ParsingJob.JobId field and add FailureReason field with machine-readable error codes
- Update ResultMetadata fields to be optional pointers and add Gender field
- Add ParsingJobFailureReason enum (invalid_input, low_quality, not_english)
- Add ResultMetadataGender enum (male, female, other)
- Update import paths to include version prefix

🌿 Generated with Fern
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants