phenoml 17.2.0 → 17.4.0

package/dist/esm/api/resources/fhir2Omop/types/ConditionOccurrenceRow.d.mts

@@ -6,6 +6,7 @@ export interface ConditionOccurrenceRow {
     condition_start_datetime?: string | undefined;
     condition_end_date?: string | undefined;
     condition_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     condition_source_value?: string | undefined;
     condition_source_concept_id?: number | undefined;
     condition_status_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/CreateOmopResponse.d.mts

@@ -2,16 +2,16 @@ import type * as phenoml from "../../../index.mjs";
 export interface CreateOmopResponse {
     success?: boolean | undefined;
     message?: string | undefined;
+    tables?: phenoml.fhir2Omop.OmopTables | undefined;
+    /** One entry per source coding (or one entry for a text-only resource with no coding), describing how it resolved and linking back to the row it produced. */
+    mappings?: phenoml.fhir2Omop.MappingEntry[] | undefined;
+    /** Resources that could not be shaped into an OMOP row (rather than emitted as blank rows). */
+    dropped?: phenoml.fhir2Omop.DroppedResource[] | undefined;
     /**
-     * Resolution mode. `resolved` (default) means clinical `concept_id`s were
-     * filled by the concept-resolver service; `structural` means no resolver
-     * was configured, so all clinical `concept_id`s are `0`. Reflects which
-     * resolver is wired, not the path an individual coding took — per-coding
-     * degradation is surfaced in `scan_summary`, not the mode.
+     * The OMOP vocabulary release the clinical codes were resolved against
+     * (e.g. "v20240229"), for reproducibility. Present when at least one
+     * coded concept was resolved.
      */
-    mode?: string | undefined;
-    tables?: phenoml.fhir2Omop.OmopTables | undefined;
-    /** One Usagi-shaped entry per source coding routed through concept resolution. */
-    report?: phenoml.fhir2Omop.MappingReportEntry[] | undefined;
-    scan_summary?: phenoml.fhir2Omop.ScanSummary | undefined;
+    vocab_version?: string | undefined;
+    summary?: phenoml.fhir2Omop.Summary | undefined;
 }

package/dist/esm/api/resources/fhir2Omop/types/DrugExposureRow.d.mts

@@ -8,6 +8,7 @@ export interface DrugExposureRow {
     drug_type_concept_id?: number | undefined;
     stop_reason?: string | undefined;
     sig?: string | undefined;
+    visit_occurrence_id?: number | undefined;
     drug_source_value?: string | undefined;
     drug_source_concept_id?: number | undefined;
 }

package/dist/esm/api/resources/fhir2Omop/types/MappingEntry.d.mts

@@ -0,0 +1,35 @@
+/**
+ * How one source coding (or a text-only resource's free text) resolved to an OMOP standard concept.
+ */
+export interface MappingEntry {
+    resource_type?: string | undefined;
+    resource_id?: string | undefined;
+    omop_table?: string | undefined;
+    /**
+     * The id of the OMOP row this coding produced (e.g. `condition_occurrence_id`),
+     * within `omop_table`. A resource with multiple codings yields one entry
+     * per coding, all sharing this id.
+     */
+    omop_id?: number | undefined;
+    source_system?: string | undefined;
+    source_code?: string | undefined;
+    source_name?: string | undefined;
+    target_vocabulary?: string | undefined;
+    /**
+     * The standard concept's own code: the source code itself for an
+     * ALREADY_STANDARD row, the standard concept's code for a MAPPED row,
+     * or the suggested code for an UNCHECKED row. Omitted for UNMAPPED
+     * rows.
+     */
+    target_code?: string | undefined;
+    target_name?: string | undefined;
+    /**
+     * ALREADY_STANDARD (source coding is already a standard OMOP concept),
+     * MAPPED (source coding was mapped to a standard concept), UNCHECKED (a
+     * standard code was suggested — e.g. for a text-only resource — but not
+     * verified against the OMOP vocabulary, so `concept_id` stays `0`), or
+     * UNMAPPED (no standard concept found).
+     */
+    mapping_status?: string | undefined;
+    note?: string | undefined;
+}

package/dist/esm/api/resources/fhir2Omop/types/MeasurementRow.d.mts

@@ -6,10 +6,13 @@ export interface MeasurementRow {
     measurement_datetime?: string | undefined;
     measurement_type_concept_id?: number | undefined;
     value_as_number?: number | undefined;
+    /** OMOP "Meas Value Operator" standard concept qualifying value_as_number (<, <=, >, >=), parsed from a numeric-string value or a FHIR valueQuantity.comparator. 0 when no operator (a bare number). */
+    operator_concept_id?: number | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
     range_low?: number | undefined;
     range_high?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     measurement_source_value?: string | undefined;
     measurement_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/ObservationRow.d.mts

@@ -9,6 +9,7 @@ export interface ObservationRow {
     value_as_string?: string | undefined;
     value_as_concept_id?: number | undefined;
     unit_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     observation_source_value?: string | undefined;
     observation_source_concept_id?: number | undefined;
     unit_source_value?: string | undefined;

package/dist/esm/api/resources/fhir2Omop/types/ProcedureOccurrenceRow.d.mts

@@ -5,6 +5,7 @@ export interface ProcedureOccurrenceRow {
     procedure_date?: string | undefined;
     procedure_datetime?: string | undefined;
     procedure_type_concept_id?: number | undefined;
+    visit_occurrence_id?: number | undefined;
     procedure_source_value?: string | undefined;
     procedure_source_concept_id?: number | undefined;
 }

package/dist/esm/api/resources/fhir2Omop/types/Summary.d.mts

@@ -0,0 +1,17 @@
+/**
+ * The request's data-quality headline: how the coded concepts split across
+ * resolution outcomes, and the share that was not already in a target
+ * standard vocabulary. Each coded resource is counted once (per resolved
+ * concept), even when it carried several codings — unlike `mappings`, which
+ * has one entry per coding.
+ */
+export interface Summary {
+    /** Coded concepts already a standard OMOP concept (ALREADY_STANDARD). */
+    codes_already_standard?: number | undefined;
+    /** Coded concepts mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
+    codes_normalized?: number | undefined;
+    /** Coded concepts with no standard concept found (UNMAPPED). */
+    codes_unmapped?: number | undefined;
+    /** Share of coded concepts not already standard ((normalized + unmapped) / total). */
+    off_vocab_rate?: number | undefined;
+}

package/dist/esm/api/resources/fhir2Omop/types/index.d.mts

@@ -2,11 +2,11 @@ export * from "./ConditionOccurrenceRow.mjs";
 export * from "./CreateOmopResponse.mjs";
 export * from "./DroppedResource.mjs";
 export * from "./DrugExposureRow.mjs";
-export * from "./MappingReportEntry.mjs";
+export * from "./MappingEntry.mjs";
 export * from "./MeasurementRow.mjs";
 export * from "./ObservationRow.mjs";
 export * from "./OmopTables.mjs";
 export * from "./PersonRow.mjs";
 export * from "./ProcedureOccurrenceRow.mjs";
-export * from "./ScanSummary.mjs";
+export * from "./Summary.mjs";
 export * from "./VisitOccurrenceRow.mjs";

package/dist/esm/api/resources/fhir2Omop/types/index.mjs

@@ -2,11 +2,11 @@ export * from "./ConditionOccurrenceRow.mjs";
 export * from "./CreateOmopResponse.mjs";
 export * from "./DroppedResource.mjs";
 export * from "./DrugExposureRow.mjs";
-export * from "./MappingReportEntry.mjs";
+export * from "./MappingEntry.mjs";
 export * from "./MeasurementRow.mjs";
 export * from "./ObservationRow.mjs";
 export * from "./OmopTables.mjs";
 export * from "./PersonRow.mjs";
 export * from "./ProcedureOccurrenceRow.mjs";
-export * from "./ScanSummary.mjs";
+export * from "./Summary.mjs";
 export * from "./VisitOccurrenceRow.mjs";

package/dist/esm/core/fetcher/signals.mjs

@@ -10,11 +10,19 @@ export function anySignal(...args) {
     for (const signal of signals) {
         if (signal.aborted) {
             controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
-            break;
+            return controller.signal;
         }
         signal.addEventListener("abort", () => controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason), {
             signal: controller.signal,
         });
+        // Re-check after adding listener: the signal may have aborted
+        // between the initial `signal.aborted` check and the `addEventListener`
+        // call above. If it did, the abort event was already dispatched and
+        // the listener will never fire — we must manually abort.
+        if (signal.aborted) {
+            controller.abort(signal === null || signal === void 0 ? void 0 : signal.reason);
+            return controller.signal;
+        }
     }
     return controller.signal;
 }

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.2.0";
+export declare const SDK_VERSION = "17.4.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "17.2.0";
+export const SDK_VERSION = "17.4.0";

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Phenoml API",
-    "version": "f96459701356d9f1fe1acbeab0f6f2eccc498046"
+    "version": "788cec0a9a7651caf2b106634631d487dfa16704"
   },
   "x-services": [
     {
@@ -3021,7 +3021,7 @@
       "post": {
         "operationId": "fhir2omop_create",
         "summary": "Map FHIR resources to OMOP CDM v5.4",
-        "description": "Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows\n(person, visit_occurrence, condition_occurrence, drug_exposure,\nprocedure_occurrence, measurement, observation).\n\n**Two resolution modes, reported in `mode`.** `mode` reflects which\nresolver is wired, not the path an individual coding took. With a\nconcept-resolver configured (the default), `mode` is `\"resolved\"` and the\nresource's primary clinical coding is resolved to a real OMOP `concept_id`;\nwith no resolver configured, `mode` is `\"structural\"` and every clinical\nand source `concept_id` is `0`. In `\"resolved\"` mode individual codings can\nstill land at `concept_id` `0` without changing the mode: a coding the\nservice finds no match for is `UNMAPPED`, and a coding that fell back to the\nstructural tier (the resolver was briefly unavailable, or the resource was\ntext-only) is surfaced in `scan_summary` (`concept_resolver_note`,\n`construe_resolutions`). A `concept_id` of `0` is \"no matching concept\" per\nOMOP semantics, deliberately not omitted. Only the primary clinical coding\nis resolved \u2014 `gender`/`race`/`ethnicity`/`visit`/`value`/`unit`\n`concept_id`s are always `0`.\n\nIn every mode each `*_source_value` carries the verbatim FHIR coding\n(`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the\nresponse `report` lists one Usagi-shaped entry per source coding describing\nhow it resolved (`ALREADY_STANDARD`, `MAPPED`, an `UNCHECKED` suggestion,\nor `UNMAPPED`).\n\nMedication codes are resolved whether they appear inline\n(`medicationCodeableConcept`) or via a `medicationReference` to a contained,\nrelative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.\nResources that cannot be shaped into a row \u2014 a medication with no usable\ncode, resolvable reference, or display, or any clinical resource whose\nsubject/patient reference cannot be tied to a person \u2014 are reported under\n`scan_summary.dropped_resources` rather than emitted as blank rows. The\nbundle must contain at least one Patient resource.\n",
+        "description": "Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows\n(person, visit_occurrence, condition_occurrence, drug_exposure,\nprocedure_occurrence, measurement, observation).\n\nEach resource's primary clinical coding is resolved to a standard OMOP\n`concept_id`. Alongside the OMOP rows grouped by table (`tables`), the\nresponse carries `mappings` (how each source coding resolved, linked back\nto the row it produced), `dropped` (resources that could not be shaped\ninto a row), `vocab_version` (the OMOP vocabulary release codes were\nresolved against), and a small `summary` of the resolution outcomes.\n\nA `concept_id` of `0` is reported, not omitted (OMOP \"no matching\nconcept\" semantics): it covers both a coding with no standard match\n(`UNMAPPED`) and an unverified suggestion for a text-only resource\n(`UNCHECKED`). Only the primary clinical coding is resolved, so\n`gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are\nalways `0`; the one populated non-resolved concept is measurement\n`operator_concept_id`, set from a value comparator (`<`, `<=`, `>`, `>=`)\nrather than the resolver. Each `*_source_value` carries the verbatim FHIR\ncoding (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).\n\nMedication codes are resolved whether they appear inline\n(`medicationCodeableConcept`) or via a `medicationReference` to a contained,\nrelative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.\nResources that cannot be shaped into a row \u2014 a medication with no usable\ncode, resolvable reference, or display, or any clinical resource whose\nsubject/patient reference cannot be tied to a person \u2014 are reported under\n`dropped` rather than emitted as blank rows. The\nbundle must contain at least one Patient resource.\n",
         "requestBody": {
           "required": true,
           "content": {
@@ -3111,13 +3111,12 @@
                   "$ref": "#/components/schemas/fhir2omop_CreateOmopResponse"
                 },
                 "examples": {
-                  "resolved_mapping": {
-                    "summary": "Resolved mapping result (default)",
-                    "description": "Same bundle with `concept_id`s filled by the concept-resolver\nservice. Both source codes are already standard, so each carries\nits own OMOP `concept_id` with `ALREADY_STANDARD` status;\n`target_code` is omitted because the service returns the standard\nconcept's id, name, and vocabulary rather than its `concept_code`.\nIllustrative `concept_id` values.\n",
+                  "mapping_result": {
+                    "summary": "Mapping result",
+                    "description": "The example bundle mapped to OMOP. Both source codes are already\nstandard, so each clinical row carries its own OMOP `concept_id`\nwith `ALREADY_STANDARD` status and a `target_code` equal to the\nsource code. Illustrative `concept_id` values.\n",
                     "value": {
                       "success": true,
-                      "message": "FHIR resources mapped to OMOP CDM v5.4 with vocabulary concept resolution",
-                      "mode": "resolved",
+                      "message": "FHIR resources mapped to OMOP CDM v5.4",
                       "tables": {
                         "person": [
                           {
@@ -3158,105 +3157,12 @@
                           }
                         ]
                       },
-                      "report": [
-                        {
-                          "resource_type": "Condition",
-                          "resource_id": "condition-1",
-                          "omop_table": "condition_occurrence",
-                          "source_system": "http://snomed.info/sct",
-                          "source_code": "44054006",
-                          "source_name": "Type 2 diabetes mellitus",
-                          "target_vocabulary": "SNOMED",
-                          "target_name": "Type 2 diabetes mellitus",
-                          "mapping_status": "ALREADY_STANDARD"
-                        },
-                        {
-                          "resource_type": "MedicationRequest",
-                          "resource_id": "medreq-1",
-                          "omop_table": "drug_exposure",
-                          "source_system": "http://www.nlm.nih.gov/research/umls/rxnorm",
-                          "source_code": "860975",
-                          "source_name": "metformin hydrochloride 500 MG",
-                          "target_vocabulary": "RXNORM",
-                          "target_name": "metformin hydrochloride 500 MG",
-                          "mapping_status": "ALREADY_STANDARD"
-                        }
-                      ],
-                      "scan_summary": {
-                        "total_resources": 3,
-                        "resource_counts": {
-                          "Patient": 1,
-                          "Condition": 1,
-                          "MedicationRequest": 1
-                        },
-                        "tables_populated": {
-                          "person": 1,
-                          "condition_occurrence": 1,
-                          "drug_exposure": 1
-                        },
-                        "coding_systems": {
-                          "http://snomed.info/sct": 1,
-                          "http://www.nlm.nih.gov/research/umls/rxnorm": 1
-                        },
-                        "codes_already_standard": 2,
-                        "codes_normalized": 0,
-                        "codes_unmapped": 0,
-                        "off_vocab_rate": 0,
-                        "resolved_vocab_version": "v20240229"
-                      }
-                    }
-                  },
-                  "structural_mapping": {
-                    "summary": "Structural mapping result (fallback / no resolver configured)",
-                    "value": {
-                      "success": true,
-                      "message": "FHIR resources mapped to OMOP CDM v5.4 (structural; concept_ids pending vocabulary crosswalk)",
-                      "mode": "structural",
-                      "tables": {
-                        "person": [
-                          {
-                            "person_id": 1,
-                            "gender_concept_id": 0,
-                            "year_of_birth": 1985,
-                            "month_of_birth": 7,
-                            "day_of_birth": 22,
-                            "birth_datetime": "1985-07-22",
-                            "race_concept_id": 0,
-                            "ethnicity_concept_id": 0,
-                            "person_source_value": "patient-1",
-                            "gender_source_value": "female"
-                          }
-                        ],
-                        "condition_occurrence": [
-                          {
-                            "condition_occurrence_id": 1,
-                            "person_id": 1,
-                            "condition_concept_id": 0,
-                            "condition_start_date": "2024-01-15",
-                            "condition_start_datetime": "2024-01-15",
-                            "condition_type_concept_id": 32817,
-                            "condition_source_value": "http://snomed.info/sct#44054006",
-                            "condition_source_concept_id": 0
-                          }
-                        ],
-                        "drug_exposure": [
-                          {
-                            "drug_exposure_id": 1,
-                            "person_id": 1,
-                            "drug_concept_id": 0,
-                            "drug_exposure_start_date": "2024-01-16",
-                            "drug_exposure_start_datetime": "2024-01-16",
-                            "drug_type_concept_id": 32817,
-                            "drug_source_value": "http://www.nlm.nih.gov/research/umls/rxnorm#860975",
-                            "drug_source_concept_id": 0
-                          }
-                        ]
-                      },
-                      "report": [
+                      "mappings": [
                         {
                           "resource_type": "Condition",
                           "resource_id": "condition-1",
                           "omop_table": "condition_occurrence",
+                          "omop_id": 1,
                           "source_system": "http://snomed.info/sct",
                           "source_code": "44054006",
                           "source_name": "Type 2 diabetes mellitus",
@@ -3269,6 +3175,7 @@
                           "resource_type": "MedicationRequest",
                           "resource_id": "medreq-1",
                           "omop_table": "drug_exposure",
+                          "omop_id": 1,
                           "source_system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                           "source_code": "860975",
                           "source_name": "metformin hydrochloride 500 MG",
@@ -3278,22 +3185,8 @@
                           "mapping_status": "ALREADY_STANDARD"
                         }
                       ],
-                      "scan_summary": {
-                        "total_resources": 3,
-                        "resource_counts": {
-                          "Patient": 1,
-                          "Condition": 1,
-                          "MedicationRequest": 1
-                        },
-                        "tables_populated": {
-                          "person": 1,
-                          "condition_occurrence": 1,
-                          "drug_exposure": 1
-                        },
-                        "coding_systems": {
-                          "http://snomed.info/sct": 1,
-                          "http://www.nlm.nih.gov/research/umls/rxnorm": 1
-                        },
+                      "vocab_version": "v20240229",
+                      "summary": {
                         "codes_already_standard": 2,
                         "codes_normalized": 0,
                         "codes_unmapped": 0,
@@ -3306,7 +3199,7 @@
             }
           },
           "400": {
-            "description": "Bad request - invalid input. Possible reasons:\n- Invalid FHIR input (missing or non-Bundle/non-resource payload)\n- No Patient resource found (OMOP requires at least one person)\n",
+            "description": "Bad request - invalid input. Possible reasons:\n- Missing or malformed request body (no `fhir_resources`)\n- Invalid FHIR input (non-Bundle/non-resource payload)\n- No Patient resource found (OMOP requires at least one person)\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -3320,6 +3213,16 @@
           },
           "500": {
             "description": "Internal server error"
+          },
+          "503": {
+            "description": "Service unavailable due to a server configuration error. No rows are\nreturned.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/fhir2omop_CreateOmopResponse"
+                }
+              }
+            }
           }
         },
         "security": [
@@ -8654,22 +8557,29 @@
           "message": {
             "type": "string"
           },
-          "mode": {
-            "type": "string",
-            "description": "Resolution mode. `resolved` (default) means clinical `concept_id`s were\nfilled by the concept-resolver service; `structural` means no resolver\nwas configured, so all clinical `concept_id`s are `0`. Reflects which\nresolver is wired, not the path an individual coding took \u2014 per-coding\ndegradation is surfaced in `scan_summary`, not the mode.\n"
-          },
           "tables": {
             "$ref": "#/components/schemas/fhir2omop_OmopTables"
           },
-          "report": {
+          "mappings": {
+            "type": "array",
+            "description": "One entry per source coding (or one entry for a text-only resource with no coding), describing how it resolved and linking back to the row it produced.",
+            "items": {
+              "$ref": "#/components/schemas/fhir2omop_MappingEntry"
+            }
+          },
+          "dropped": {
             "type": "array",
-            "description": "One Usagi-shaped entry per source coding routed through concept resolution.",
+            "description": "Resources that could not be shaped into an OMOP row (rather than emitted as blank rows).",
             "items": {
-              "$ref": "#/components/schemas/fhir2omop_MappingReportEntry"
+              "$ref": "#/components/schemas/fhir2omop_DroppedResource"
             }
           },
-          "scan_summary": {
-            "$ref": "#/components/schemas/fhir2omop_ScanSummary"
+          "vocab_version": {
+            "type": "string",
+            "description": "The OMOP vocabulary release the clinical codes were resolved against\n(e.g. \"v20240229\"), for reproducibility. Present when at least one\ncoded concept was resolved.\n"
+          },
+          "summary": {
+            "$ref": "#/components/schemas/fhir2omop_Summary"
           }
         }
       },
@@ -8830,6 +8740,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "condition_source_value": {
             "type": "string"
           },
@@ -8876,6 +8790,10 @@
           "sig": {
             "type": "string"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "drug_source_value": {
             "type": "string"
           },
@@ -8910,6 +8828,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "procedure_source_value": {
             "type": "string"
           },
@@ -8948,6 +8870,11 @@
             "type": "number",
             "format": "double"
           },
+          "operator_concept_id": {
+            "type": "integer",
+            "format": "int64",
+            "description": "OMOP \"Meas Value Operator\" standard concept qualifying value_as_number (<, <=, >, >=), parsed from a numeric-string value or a FHIR valueQuantity.comparator. 0 when no operator (a bare number)."
+          },
           "value_as_concept_id": {
             "type": "integer",
             "format": "int64"
@@ -8964,6 +8891,10 @@
             "type": "number",
             "format": "double"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "measurement_source_value": {
             "type": "string"
           },
@@ -9019,6 +8950,10 @@
             "type": "integer",
             "format": "int64"
           },
+          "visit_occurrence_id": {
+            "type": "integer",
+            "format": "int64"
+          },
           "observation_source_value": {
             "type": "string"
           },
@@ -9034,9 +8969,9 @@
           }
         }
       },
-      "fhir2omop_MappingReportEntry": {
+      "fhir2omop_MappingEntry": {
         "type": "object",
-        "description": "One source_to_concept_map-style mapping suggestion (Usagi-shaped).",
+        "description": "How one source coding (or a text-only resource's free text) resolved to an OMOP standard concept.",
         "properties": {
           "resource_type": {
             "type": "string"
@@ -9047,6 +8982,11 @@
           "omop_table": {
             "type": "string"
           },
+          "omop_id": {
+            "type": "integer",
+            "format": "int64",
+            "description": "The id of the OMOP row this coding produced (e.g. `condition_occurrence_id`),\nwithin `omop_table`. A resource with multiple codings yields one entry\nper coding, all sharing this id.\n"
+          },
           "source_system": {
             "type": "string"
           },
@@ -9061,83 +9001,40 @@
           },
           "target_code": {
             "type": "string",
-            "description": "Standard concept code. Set when a coding is matched by the structural\n(construe) tier \u2014 an already-standard code taken verbatim, or a\nconstrue-suggested code \u2014 which is every match in structural mode and,\nin resolved mode, codings for text-only resources or ones that fell back\nwhen the resolver was unavailable. Omitted for codings resolved directly\nby the concept-resolver service, which returns the standard concept's\nid, name, and vocabulary but not its `concept_code`.\n"
+            "description": "The standard concept's own code: the source code itself for an\nALREADY_STANDARD row, the standard concept's code for a MAPPED row,\nor the suggested code for an UNCHECKED row. Omitted for UNMAPPED\nrows.\n"
           },
           "target_name": {
             "type": "string"
           },
           "mapping_status": {
             "type": "string",
-            "description": "ALREADY_STANDARD (source already in the target standard vocabulary),\nMAPPED (resolved to a standard concept via the OMOP \"Maps to\" crosswalk\nor UMLS-CUI bridge; resolved mode only), UNCHECKED (an unreviewed\nconstrue suggestion; structural / fallback only), or UNMAPPED (no\ncandidate found).\n"
+            "description": "ALREADY_STANDARD (source coding is already a standard OMOP concept),\nMAPPED (source coding was mapped to a standard concept), UNCHECKED (a\nstandard code was suggested \u2014 e.g. for a text-only resource \u2014 but not\nverified against the OMOP vocabulary, so `concept_id` stays `0`), or\nUNMAPPED (no standard concept found).\n"
           },
           "note": {
             "type": "string"
           }
         }
       },
-      "fhir2omop_ScanSummary": {
+      "fhir2omop_Summary": {
         "type": "object",
-        "description": "White Rabbit-style aggregate profile of the mapping request.",
+        "description": "The request's data-quality headline: how the coded concepts split across\nresolution outcomes, and the share that was not already in a target\nstandard vocabulary. Each coded resource is counted once (per resolved\nconcept), even when it carried several codings \u2014 unlike `mappings`, which\nhas one entry per coding.\n",
         "properties": {
-          "total_resources": {
-            "type": "integer"
-          },
-          "resource_counts": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "integer"
-            }
-          },
-          "tables_populated": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "integer"
-            }
-          },
-          "coding_systems": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "integer"
-            }
-          },
           "codes_already_standard": {
-            "type": "integer"
+            "type": "integer",
+            "description": "Coded concepts already a standard OMOP concept (ALREADY_STANDARD)."
           },
           "codes_normalized": {
-            "type": "integer"
+            "type": "integer",
+            "description": "Coded concepts mapped or suggested to a standard concept (MAPPED or UNCHECKED)."
           },
           "codes_unmapped": {
-            "type": "integer"
+            "type": "integer",
+            "description": "Coded concepts with no standard concept found (UNMAPPED)."
           },
           "off_vocab_rate": {
             "type": "number",
-            "format": "double"
-          },
-          "dropped_resources": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/fhir2omop_DroppedResource"
-            }
-          },
-          "resolved_vocab_version": {
-            "type": "string",
-            "description": "OMOP vocabulary release the resolver mapped against (e.g. \"v20240229\").\nResolved mode only; empty when no coded concept reached the service.\n"
-          },
-          "concept_resolver_note": {
-            "type": "string",
-            "description": "Set when concept resolution was degraded \u2014 the resolver was unavailable\nfor one or more codings, whose `concept_id`s fell back to the structural\n(construe) tier. Empty when resolution was clean.\n"
-          },
-          "concepts_bridged": {
-            "type": "integer",
-            "description": "Count of `concept_id`s chosen via the lower-confidence UMLS-CUI bridge\n(no direct OMOP crosswalk existed). Resolved mode only.\n"
-          },
-          "concept_candidates_truncated": {
-            "type": "integer",
-            "description": "Count of codings whose candidate list the resolver capped, so the best\nconcept may not have been among those returned.\n"
-          },
-          "construe_resolutions": {
-            "type": "integer",
-            "description": "Count of codings resolved via the construe ML extractor \u2014 the text-only\nor availability fallback path. A non-zero value bills the construe tier.\n"
+            "format": "double",
+            "description": "Share of coded concepts not already standard ((normalized + unmapped) / total)."
           }
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "phenoml",
-    "version": "17.2.0",
+    "version": "17.4.0",
     "private": false,
     "repository": {
         "type": "git",