feat: add visit_occurrence_id and operator_concept_id to OMOP row types

[fern-api]

17.3.0 → 17.4.0

Added

• ConditionOccurrenceRow.getVisitOccurrenceId(), DrugExposureRow.getVisitOccurrenceId(), MeasurementRow.getVisitOccurrenceId(), ObservationRow.getVisitOccurrenceId(), and ProcedureOccurrenceRow.getVisitOccurrenceId() — new optional accessor linking each clinical OMOP row back to its visit_occurrence row.
• MeasurementRow.getOperatorConceptId() — new optional accessor carrying the OMOP "Meas Value Operator" standard concept (<, <=, >, >=) parsed from a FHIR valueQuantity.comparator or numeric-string value; 0 when no operator is present.

Changed

• MappingEntry.getTargetCode() — value semantics updated: now the standard concept's own code for ALREADY_STANDARD, MAPPED, and UNCHECKED rows; empty for UNMAPPED rows.
• Summary — count-field docs clarify each total is counted once per resolved concept (not per coding), unlike mappings, which has one entry per coding.
• PhenomlClient.fhir2Omop().create(...) Javadoc — clarifies that a clinical concept_id of 0 covers both UNMAPPED and UNCHECKED, and that operator_concept_id is the one non-zero non-resolved concept on measurement rows.

---

Note

Medium Risk
Additive JSON fields are backward compatible for deserialization, but changed target_code population and updated mapping semantics can break integrators that assumed the old UNCHECKED-only behavior.

Overview
17.4.0 regenerates the Java SDK from an updated FHIR→OMOP API spec (Fern), bumping the package to 17.4.0 and refreshing OpenAPI, examples, and wire tests.

Clinical OMOP row types gain optional visit_occurrence_id on condition, drug, measurement, observation, and procedure rows so each event can reference its visit_occurrence row. MeasurementRow also adds operator_concept_id for OMOP “Meas Value Operator” concepts from FHIR comparators or qualified numeric strings.

MappingEntry.getTargetCode() semantics change: the field is now the standard concept’s code for ALREADY_STANDARD, MAPPED, and UNCHECKED mappings and omitted/empty for UNMAPPED. Summary and fhir2Omop().create() Javadoc are updated to clarify concept_id 0 (both unmapped and unchecked), summary counts per resolved concept vs one mapping per coding, and operator_concept_id on measurements.

^{Reviewed by Cursor Bugbot for commit 689cf3a. Bugbot is set up for automated code reviews on this repo. Configure here.}