Release 18.0.0: add batch Lang2FHIR APIs

[fern-api]

17.13.0 → 18.0.0

Major release adding batch FHIR extraction and immutable profile-version clients. Core profile response accessors now return guaranteed values rather than Optional wrappers.

Breaking Changes

• ProfileSummary and ProfileGetResponse — getId(), getSource(), getResourceType(), getUrl(), getVersion(), getFhirVersion(), getImplementationGuide(), getCreatedAt(), and getUpdatedAt() now return required values instead of Optional; remove Optional handling for these accessors.
• ProfileListResponse.getProfiles() — changed from Optional<List<ProfileSummary>> to List<ProfileSummary>; remove Optional handling for this accessor.
• ProfileGetResponse.getStructureDefinition() — changed from Optional<Map<String, Object>> to Map<String, Object>; remove Optional handling for this accessor.

Added

• PhenomlClient.lang2FhirBatch() and AsyncPhenomlClient.lang2FhirBatch() — new clients for batch FHIR extraction, supporting create(), uploadItem(), finalize(), cancel(), get(), getResults(), getResult(), and list() across the job lifecycle.
• BatchJob, BatchItemStatus, BatchCounts, BatchError, JobDetailResponse, JobListResponse, ResultsPageResponse, and UploadItemResponse — new models supporting the batch extraction API.
• ProfilesClient.versions() and AsyncProfilesClient.versions() — new clients for immutable StructureDefinition versions, with list(), create(), get(), and delete() methods.
• ProfileSummary.getStatus(), getDate(), and getCanonical() — new optional accessors exposing each profile's publication status, authored date, and canonical URL; profile update and batch methods can now throw ConflictError for HTTP 409 responses.

Migration notes

Use the profile response accessors directly instead of unwrapping Optional; no endpoint method signatures were removed or renamed.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c596589. Configure here.}

[cursor]

Stream upload omits required fields

High Severity

The stream-based uploadItem overloads send only a file part and drop document, create, request_id, and id. The unused file argument is ignored. The API requires exactly one of document or create, so these public overloads cannot succeed and will get a 400.

Additional Locations (2)

• src/main/java/com/phenoml/api/resources/lang2fhirbatch/AsyncLang2FhirBatchClient.java#L316-L346
• src/main/java/com/phenoml/api/resources/lang2fhirbatch/Lang2FhirBatchClient.java#L313-L342

 

^{Reviewed by Cursor Bugbot for commit c596589. Configure here.}