phenoml 17.1.0 → 17.3.0

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phenoml",
-        "X-Fern-SDK-Version": "17.1.0",
-        "User-Agent": "phenoml/17.1.0",
+        "X-Fern-SDK-Version": "17.3.0",
+        "User-Agent": "phenoml/17.3.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/fhir2Omop/client/Client.d.ts

@@ -11,26 +11,32 @@ export declare class Fhir2OmopClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<Fhir2OmopClient.Options>;
     constructor(options?: Fhir2OmopClient.Options);
     /**
-     * Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
+     * Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
      * (person, visit_occurrence, condition_occurrence, drug_exposure,
      * procedure_occurrence, measurement, observation).
      *
-     * **This is a structural mapping (`mode: "structural"`).** Rows are
-     * structurally valid OMOP, but every clinical and source `concept_id` is `0`:
-     * the vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned
-     * follow-up. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the
-     * response `report` lists a standard-code *suggestion* for each source coding
-     * (already-standard, an unchecked normalization suggestion, or unmapped). Do
-     * not treat the output as analytically resolved OMOP until `concept_id`s are
-     * populated.
+     * Each resource's primary clinical coding is resolved to a standard OMOP
+     * `concept_id`. Alongside the OMOP rows grouped by table (`tables`), the
+     * response carries `mappings` (how each source coding resolved, linked back
+     * to the row it produced), `dropped` (resources that could not be shaped
+     * into a row), `vocab_version` (the OMOP vocabulary release codes were
+     * resolved against), and a small `summary` of the resolution outcomes.
+     *
+     * A `concept_id` of `0` means "no matching standard concept" (OMOP
+     * semantics) and is reported, not omitted — a coding with no match is
+     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
+     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
+     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,
      * relative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.
-     * A medication with no usable code, resolvable reference, or display is
-     * reported under `scan_summary.dropped_resources` rather than emitted as a
-     * blank row. The bundle must contain at least one Patient resource.
+     * Resources that cannot be shaped into a row — a medication with no usable
+     * code, resolvable reference, or display, or any clinical resource whose
+     * subject/patient reference cannot be tied to a person — are reported under
+     * `dropped` rather than emitted as blank rows. The
+     * bundle must contain at least one Patient resource.
      *
      * @param {phenoml.fhir2Omop.CreateOmopRequest} request
      * @param {Fhir2OmopClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -38,6 +44,7 @@ export declare class Fhir2OmopClient {
      * @throws {@link phenoml.fhir2Omop.BadRequestError}
      * @throws {@link phenoml.fhir2Omop.UnauthorizedError}
      * @throws {@link phenoml.fhir2Omop.InternalServerError}
+     * @throws {@link phenoml.fhir2Omop.ServiceUnavailableError}
      *
      * @example
      *     await client.fhir2Omop.create({

package/dist/cjs/api/resources/fhir2Omop/client/Client.js

@@ -56,26 +56,32 @@ class Fhir2OmopClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
+     * Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
      * (person, visit_occurrence, condition_occurrence, drug_exposure,
      * procedure_occurrence, measurement, observation).
      *
-     * **This is a structural mapping (`mode: "structural"`).** Rows are
-     * structurally valid OMOP, but every clinical and source `concept_id` is `0`:
-     * the vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned
-     * follow-up. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the
-     * response `report` lists a standard-code *suggestion* for each source coding
-     * (already-standard, an unchecked normalization suggestion, or unmapped). Do
-     * not treat the output as analytically resolved OMOP until `concept_id`s are
-     * populated.
+     * Each resource's primary clinical coding is resolved to a standard OMOP
+     * `concept_id`. Alongside the OMOP rows grouped by table (`tables`), the
+     * response carries `mappings` (how each source coding resolved, linked back
+     * to the row it produced), `dropped` (resources that could not be shaped
+     * into a row), `vocab_version` (the OMOP vocabulary release codes were
+     * resolved against), and a small `summary` of the resolution outcomes.
+     *
+     * A `concept_id` of `0` means "no matching standard concept" (OMOP
+     * semantics) and is reported, not omitted — a coding with no match is
+     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
+     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
+     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,
      * relative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.
-     * A medication with no usable code, resolvable reference, or display is
-     * reported under `scan_summary.dropped_resources` rather than emitted as a
-     * blank row. The bundle must contain at least one Patient resource.
+     * Resources that cannot be shaped into a row — a medication with no usable
+     * code, resolvable reference, or display, or any clinical resource whose
+     * subject/patient reference cannot be tied to a person — are reported under
+     * `dropped` rather than emitted as blank rows. The
+     * bundle must contain at least one Patient resource.
      *
      * @param {phenoml.fhir2Omop.CreateOmopRequest} request
      * @param {Fhir2OmopClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -83,6 +89,7 @@ class Fhir2OmopClient {
      * @throws {@link phenoml.fhir2Omop.BadRequestError}
      * @throws {@link phenoml.fhir2Omop.UnauthorizedError}
      * @throws {@link phenoml.fhir2Omop.InternalServerError}
+     * @throws {@link phenoml.fhir2Omop.ServiceUnavailableError}
      *
      * @example
      *     await client.fhir2Omop.create({
@@ -183,6 +190,8 @@ class Fhir2OmopClient {
                         throw new phenoml.fhir2Omop.UnauthorizedError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new phenoml.fhir2Omop.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new phenoml.fhir2Omop.ServiceUnavailableError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.phenomlError({
                             statusCode: _response.error.statusCode,

package/dist/cjs/api/resources/fhir2Omop/errors/ServiceUnavailableError.d.ts

@@ -0,0 +1,5 @@
+import type * as core from "../../../../core/index.js";
+import * as errors from "../../../../errors/index.js";
+export declare class ServiceUnavailableError extends errors.phenomlError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/resources/fhir2Omop/errors/ServiceUnavailableError.js

@@ -0,0 +1,54 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceUnavailableError = void 0;
+const errors = __importStar(require("../../../../errors/index.js"));
+class ServiceUnavailableError extends errors.phenomlError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ServiceUnavailableError",
+            statusCode: 503,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.ServiceUnavailableError = ServiceUnavailableError;

package/dist/cjs/api/resources/fhir2Omop/errors/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./BadRequestError.js";
 export * from "./InternalServerError.js";
+export * from "./ServiceUnavailableError.js";
 export * from "./UnauthorizedError.js";

package/dist/cjs/api/resources/fhir2Omop/errors/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BadRequestError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
+__exportStar(require("./ServiceUnavailableError.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);

package/dist/cjs/api/resources/fhir2Omop/types/CreateOmopResponse.d.ts

@@ -2,10 +2,16 @@ import type * as phenoml from "../../../index.js";
 export interface CreateOmopResponse {
     success?: boolean | undefined;
     message?: string | undefined;
-    /** Resolution mode. `structural` means all clinical concept_ids are 0 (vocabulary crosswalk pending). */
-    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;
+    /** 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;
+    /**
+     * The OMOP vocabulary release the clinical codes were resolved against
+     * (e.g. "v20240229"), for reproducibility. Present when at least one
+     * coded concept was resolved.
+     */
+    vocab_version?: string | undefined;
+    summary?: phenoml.fhir2Omop.Summary | undefined;
 }

package/dist/cjs/api/resources/fhir2Omop/types/MappingEntry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 code, when present. Populated only for an
+     * `UNCHECKED` suggestion (where the API normalized a text-only resource
+     * to a suggested code); omitted for codings resolved through concept
+     * resolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are
+     * identified by `target_vocabulary`, `target_name`, and the row's
+     * `*_concept_id` rather than by code.
+     */
+    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/cjs/api/resources/fhir2Omop/types/Summary.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+export interface Summary {
+    /** Codings already a standard OMOP concept. */
+    codes_already_standard?: number | undefined;
+    /** Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
+    codes_normalized?: number | undefined;
+    /** Codings with no standard concept found. */
+    codes_unmapped?: number | undefined;
+    /** Share of coded concepts not already standard ((normalized + unmapped) / total). */
+    off_vocab_rate?: number | undefined;
+}

package/dist/cjs/api/resources/fhir2Omop/types/index.d.ts

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

package/dist/cjs/api/resources/fhir2Omop/types/index.js

@@ -18,11 +18,11 @@ __exportStar(require("./ConditionOccurrenceRow.js"), exports);
 __exportStar(require("./CreateOmopResponse.js"), exports);
 __exportStar(require("./DroppedResource.js"), exports);
 __exportStar(require("./DrugExposureRow.js"), exports);
-__exportStar(require("./MappingReportEntry.js"), exports);
+__exportStar(require("./MappingEntry.js"), exports);
 __exportStar(require("./MeasurementRow.js"), exports);
 __exportStar(require("./ObservationRow.js"), exports);
 __exportStar(require("./OmopTables.js"), exports);
 __exportStar(require("./PersonRow.js"), exports);
 __exportStar(require("./ProcedureOccurrenceRow.js"), exports);
-__exportStar(require("./ScanSummary.js"), exports);
+__exportStar(require("./Summary.js"), exports);
 __exportStar(require("./VisitOccurrenceRow.js"), exports);

package/dist/cjs/core/fetcher/signals.js

@@ -14,11 +14,19 @@ 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/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "17.1.0";
+export declare const SDK_VERSION = "17.3.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "17.1.0";
+exports.SDK_VERSION = "17.3.0";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "phenoml",
-        "X-Fern-SDK-Version": "17.1.0",
-        "User-Agent": "phenoml/17.1.0",
+        "X-Fern-SDK-Version": "17.3.0",
+        "User-Agent": "phenoml/17.3.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/fhir2Omop/client/Client.d.mts

@@ -11,26 +11,32 @@ export declare class Fhir2OmopClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<Fhir2OmopClient.Options>;
     constructor(options?: Fhir2OmopClient.Options);
     /**
-     * Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
+     * Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
      * (person, visit_occurrence, condition_occurrence, drug_exposure,
      * procedure_occurrence, measurement, observation).
      *
-     * **This is a structural mapping (`mode: "structural"`).** Rows are
-     * structurally valid OMOP, but every clinical and source `concept_id` is `0`:
-     * the vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned
-     * follow-up. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the
-     * response `report` lists a standard-code *suggestion* for each source coding
-     * (already-standard, an unchecked normalization suggestion, or unmapped). Do
-     * not treat the output as analytically resolved OMOP until `concept_id`s are
-     * populated.
+     * Each resource's primary clinical coding is resolved to a standard OMOP
+     * `concept_id`. Alongside the OMOP rows grouped by table (`tables`), the
+     * response carries `mappings` (how each source coding resolved, linked back
+     * to the row it produced), `dropped` (resources that could not be shaped
+     * into a row), `vocab_version` (the OMOP vocabulary release codes were
+     * resolved against), and a small `summary` of the resolution outcomes.
+     *
+     * A `concept_id` of `0` means "no matching standard concept" (OMOP
+     * semantics) and is reported, not omitted — a coding with no match is
+     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
+     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
+     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,
      * relative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.
-     * A medication with no usable code, resolvable reference, or display is
-     * reported under `scan_summary.dropped_resources` rather than emitted as a
-     * blank row. The bundle must contain at least one Patient resource.
+     * Resources that cannot be shaped into a row — a medication with no usable
+     * code, resolvable reference, or display, or any clinical resource whose
+     * subject/patient reference cannot be tied to a person — are reported under
+     * `dropped` rather than emitted as blank rows. The
+     * bundle must contain at least one Patient resource.
      *
      * @param {phenoml.fhir2Omop.CreateOmopRequest} request
      * @param {Fhir2OmopClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -38,6 +44,7 @@ export declare class Fhir2OmopClient {
      * @throws {@link phenoml.fhir2Omop.BadRequestError}
      * @throws {@link phenoml.fhir2Omop.UnauthorizedError}
      * @throws {@link phenoml.fhir2Omop.InternalServerError}
+     * @throws {@link phenoml.fhir2Omop.ServiceUnavailableError}
      *
      * @example
      *     await client.fhir2Omop.create({

package/dist/esm/api/resources/fhir2Omop/client/Client.mjs

@@ -20,26 +20,32 @@ export class Fhir2OmopClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
+     * Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
      * (person, visit_occurrence, condition_occurrence, drug_exposure,
      * procedure_occurrence, measurement, observation).
      *
-     * **This is a structural mapping (`mode: "structural"`).** Rows are
-     * structurally valid OMOP, but every clinical and source `concept_id` is `0`:
-     * the vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned
-     * follow-up. Each `*_source_value` carries the verbatim FHIR coding
-     * (`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the
-     * response `report` lists a standard-code *suggestion* for each source coding
-     * (already-standard, an unchecked normalization suggestion, or unmapped). Do
-     * not treat the output as analytically resolved OMOP until `concept_id`s are
-     * populated.
+     * Each resource's primary clinical coding is resolved to a standard OMOP
+     * `concept_id`. Alongside the OMOP rows grouped by table (`tables`), the
+     * response carries `mappings` (how each source coding resolved, linked back
+     * to the row it produced), `dropped` (resources that could not be shaped
+     * into a row), `vocab_version` (the OMOP vocabulary release codes were
+     * resolved against), and a small `summary` of the resolution outcomes.
+     *
+     * A `concept_id` of `0` means "no matching standard concept" (OMOP
+     * semantics) and is reported, not omitted — a coding with no match is
+     * `UNMAPPED`. Only the primary clinical coding is resolved;
+     * `gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
+     * always `0`. Each `*_source_value` carries the verbatim FHIR coding
+     * (`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
      *
      * Medication codes are resolved whether they appear inline
      * (`medicationCodeableConcept`) or via a `medicationReference` to a contained,
      * relative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.
-     * A medication with no usable code, resolvable reference, or display is
-     * reported under `scan_summary.dropped_resources` rather than emitted as a
-     * blank row. The bundle must contain at least one Patient resource.
+     * Resources that cannot be shaped into a row — a medication with no usable
+     * code, resolvable reference, or display, or any clinical resource whose
+     * subject/patient reference cannot be tied to a person — are reported under
+     * `dropped` rather than emitted as blank rows. The
+     * bundle must contain at least one Patient resource.
      *
      * @param {phenoml.fhir2Omop.CreateOmopRequest} request
      * @param {Fhir2OmopClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -47,6 +53,7 @@ export class Fhir2OmopClient {
      * @throws {@link phenoml.fhir2Omop.BadRequestError}
      * @throws {@link phenoml.fhir2Omop.UnauthorizedError}
      * @throws {@link phenoml.fhir2Omop.InternalServerError}
+     * @throws {@link phenoml.fhir2Omop.ServiceUnavailableError}
      *
      * @example
      *     await client.fhir2Omop.create({
@@ -147,6 +154,8 @@ export class Fhir2OmopClient {
                         throw new phenoml.fhir2Omop.UnauthorizedError(_response.error.body, _response.rawResponse);
                     case 500:
                         throw new phenoml.fhir2Omop.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new phenoml.fhir2Omop.ServiceUnavailableError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.phenomlError({
                             statusCode: _response.error.statusCode,

package/dist/esm/api/resources/fhir2Omop/errors/ServiceUnavailableError.d.mts

@@ -0,0 +1,5 @@
+import type * as core from "../../../../core/index.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export declare class ServiceUnavailableError extends errors.phenomlError {
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/resources/fhir2Omop/errors/ServiceUnavailableError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../../../errors/index.mjs";
+export class ServiceUnavailableError extends errors.phenomlError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ServiceUnavailableError",
+            statusCode: 503,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}

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

@@ -1,3 +1,4 @@
 export * from "./BadRequestError.mjs";
 export * from "./InternalServerError.mjs";
+export * from "./ServiceUnavailableError.mjs";
 export * from "./UnauthorizedError.mjs";

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

@@ -1,3 +1,4 @@
 export * from "./BadRequestError.mjs";
 export * from "./InternalServerError.mjs";
+export * from "./ServiceUnavailableError.mjs";
 export * from "./UnauthorizedError.mjs";

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

@@ -2,10 +2,16 @@ import type * as phenoml from "../../../index.mjs";
 export interface CreateOmopResponse {
     success?: boolean | undefined;
     message?: string | undefined;
-    /** Resolution mode. `structural` means all clinical concept_ids are 0 (vocabulary crosswalk pending). */
-    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;
+    /** 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;
+    /**
+     * The OMOP vocabulary release the clinical codes were resolved against
+     * (e.g. "v20240229"), for reproducibility. Present when at least one
+     * coded concept was resolved.
+     */
+    vocab_version?: string | undefined;
+    summary?: phenoml.fhir2Omop.Summary | undefined;
 }

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

@@ -0,0 +1,37 @@
+/**
+ * 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 code, when present. Populated only for an
+     * `UNCHECKED` suggestion (where the API normalized a text-only resource
+     * to a suggested code); omitted for codings resolved through concept
+     * resolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are
+     * identified by `target_vocabulary`, `target_name`, and the row's
+     * `*_concept_id` rather than by code.
+     */
+    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/Summary.d.mts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+export interface Summary {
+    /** Codings already a standard OMOP concept. */
+    codes_already_standard?: number | undefined;
+    /** Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED). */
+    codes_normalized?: number | undefined;
+    /** Codings with no standard concept found. */
+    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.1.0";
+export declare const SDK_VERSION = "17.3.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "17.1.0";
+export const SDK_VERSION = "17.3.0";

package/openapi/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Phenoml API",
-    "version": "f063af0e8ddd9e9322b47bb8bc90c378af75764a"
+    "version": "5084e3096e5bd89bf2e86ea44d96e3407f6f5c6b"
   },
   "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**This is a structural mapping (`mode: \"structural\"`).** Rows are\nstructurally valid OMOP, but every clinical and source `concept_id` is `0`:\nthe vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned\nfollow-up. Each `*_source_value` carries the verbatim FHIR coding\n(`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the\nresponse `report` lists a standard-code *suggestion* for each source coding\n(already-standard, an unchecked normalization suggestion, or unmapped). Do\nnot treat the output as analytically resolved OMOP until `concept_id`s are\npopulated.\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.\nA medication with no usable code, resolvable reference, or display is\nreported under `scan_summary.dropped_resources` rather than emitted as a\nblank row. The bundle 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` means \"no matching standard concept\" (OMOP\nsemantics) and is reported, not omitted \u2014 a coding with no match is\n`UNMAPPED`. Only the primary clinical coding is resolved;\n`gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are\nalways `0`. Each `*_source_value` carries the verbatim FHIR coding\n(`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": {
@@ -3104,19 +3104,19 @@
         },
         "responses": {
           "200": {
-            "description": "FHIR resources mapped to OMOP CDM v5.4 (structural)",
+            "description": "FHIR resources mapped to OMOP CDM v5.4",
             "content": {
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/fhir2omop_CreateOmopResponse"
                 },
                 "examples": {
-                  "structural_mapping": {
-                    "summary": "Structural mapping result",
+                  "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. `target_code` is omitted for a\nresolved concept \u2014 it is identified by `target_vocabulary` and\n`target_name` (and the row's `*_concept_id`). Illustrative\n`concept_id` values.\n",
                     "value": {
                       "success": true,
-                      "message": "FHIR resources mapped to OMOP CDM v5.4 (structural; concept_ids pending vocabulary crosswalk)",
-                      "mode": "structural",
+                      "message": "FHIR resources mapped to OMOP CDM v5.4",
                       "tables": {
                         "person": [
                           {
@@ -3136,37 +3136,37 @@
                           {
                             "condition_occurrence_id": 1,
                             "person_id": 1,
-                            "condition_concept_id": 0,
+                            "condition_concept_id": 201826,
                             "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
+                            "condition_source_concept_id": 201826
                           }
                         ],
                         "drug_exposure": [
                           {
                             "drug_exposure_id": 1,
                             "person_id": 1,
-                            "drug_concept_id": 0,
+                            "drug_concept_id": 40163924,
                             "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
+                            "drug_source_concept_id": 40163924
                           }
                         ]
                       },
-                      "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",
                           "target_vocabulary": "SNOMED",
-                          "target_code": "44054006",
                           "target_name": "Type 2 diabetes mellitus",
                           "mapping_status": "ALREADY_STANDARD"
                         },
@@ -3174,31 +3174,17 @@
                           "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",
                           "target_vocabulary": "RXNORM",
-                          "target_code": "860975",
                           "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
-                        },
+                      "vocab_version": "v20240229",
+                      "summary": {
                         "codes_already_standard": 2,
                         "codes_normalized": 0,
                         "codes_unmapped": 0,
@@ -3211,7 +3197,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": {
@@ -3225,6 +3211,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": [
@@ -8559,22 +8555,29 @@
           "message": {
             "type": "string"
           },
-          "mode": {
-            "type": "string",
-            "description": "Resolution mode. `structural` means all clinical concept_ids are 0 (vocabulary crosswalk pending)."
-          },
           "tables": {
             "$ref": "#/components/schemas/fhir2omop_OmopTables"
           },
-          "report": {
+          "mappings": {
             "type": "array",
-            "description": "One Usagi-shaped entry per source coding routed through concept resolution.",
+            "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_MappingReportEntry"
+              "$ref": "#/components/schemas/fhir2omop_MappingEntry"
             }
           },
-          "scan_summary": {
-            "$ref": "#/components/schemas/fhir2omop_ScanSummary"
+          "dropped": {
+            "type": "array",
+            "description": "Resources that could not be shaped into an OMOP row (rather than emitted as blank rows).",
+            "items": {
+              "$ref": "#/components/schemas/fhir2omop_DroppedResource"
+            }
+          },
+          "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"
           }
         }
       },
@@ -8939,9 +8942,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"
@@ -8952,6 +8955,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"
           },
@@ -8965,66 +8973,41 @@
             "type": "string"
           },
           "target_code": {
-            "type": "string"
+            "type": "string",
+            "description": "The standard concept's code, when present. Populated only for an\n`UNCHECKED` suggestion (where the API normalized a text-only resource\nto a suggested code); omitted for codings resolved through concept\nresolution (`ALREADY_STANDARD` / `MAPPED` / `UNMAPPED`), which are\nidentified by `target_vocabulary`, `target_name`, and the row's\n`*_concept_id` rather than by code.\n"
           },
           "target_name": {
             "type": "string"
           },
           "mapping_status": {
             "type": "string",
-            "description": "ALREADY_STANDARD (source already in target vocabulary), UNCHECKED (unreviewed suggestion), or UNMAPPED (no candidate found)."
-          },
-          "equivalence": {
-            "type": "string"
+            "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.\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": "Codings already a standard OMOP concept."
           },
           "codes_normalized": {
-            "type": "integer"
+            "type": "integer",
+            "description": "Codings mapped or suggested to a standard concept (MAPPED or UNCHECKED)."
           },
           "codes_unmapped": {
-            "type": "integer"
+            "type": "integer",
+            "description": "Codings with no standard concept found."
           },
           "off_vocab_rate": {
             "type": "number",
-            "format": "double"
-          },
-          "dropped_resources": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/fhir2omop_DroppedResource"
-            }
+            "format": "double",
+            "description": "Share of coded concepts not already standard ((normalized + unmapped) / total)."
           }
         }
       },

package/package.json

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

package/reference.md

@@ -2673,26 +2673,32 @@ The ID of the FHIR provider to use. Can be either:
 <dl>
 <dd>
 
-Shapes a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
+Maps a FHIR R4 resource or Bundle into OMOP Common Data Model v5.4 rows
 (person, visit_occurrence, condition_occurrence, drug_exposure,
 procedure_occurrence, measurement, observation).
 
-**This is a structural mapping (`mode: "structural"`).** Rows are
-structurally valid OMOP, but every clinical and source `concept_id` is `0`:
-the vocabulary crosswalk that assigns real OMOP `concept_id`s is a planned
-follow-up. Each `*_source_value` carries the verbatim FHIR coding
-(`system#code`), `*_type_concept_id` is set to `32817` (EHR), and the
-response `report` lists a standard-code *suggestion* for each source coding
-(already-standard, an unchecked normalization suggestion, or unmapped). Do
-not treat the output as analytically resolved OMOP until `concept_id`s are
-populated.
+Each resource's primary clinical coding is resolved to a standard OMOP
+`concept_id`. Alongside the OMOP rows grouped by table (`tables`), the
+response carries `mappings` (how each source coding resolved, linked back
+to the row it produced), `dropped` (resources that could not be shaped
+into a row), `vocab_version` (the OMOP vocabulary release codes were
+resolved against), and a small `summary` of the resolution outcomes.
+
+A `concept_id` of `0` means "no matching standard concept" (OMOP
+semantics) and is reported, not omitted — a coding with no match is
+`UNMAPPED`. Only the primary clinical coding is resolved;
+`gender`/`race`/`ethnicity`/`visit`/`value`/`unit` `concept_id`s are
+always `0`. Each `*_source_value` carries the verbatim FHIR coding
+(`system#code`), and `*_type_concept_id` is set to `32817` (EHR).
 
 Medication codes are resolved whether they appear inline
 (`medicationCodeableConcept`) or via a `medicationReference` to a contained,
 relative (`Type/id`), or bundle-entry (`urn:uuid`) `Medication` resource.
-A medication with no usable code, resolvable reference, or display is
-reported under `scan_summary.dropped_resources` rather than emitted as a
-blank row. The bundle must contain at least one Patient resource.
+Resources that cannot be shaped into a row — a medication with no usable
+code, resolvable reference, or display, or any clinical resource whose
+subject/patient reference cannot be tied to a person — are reported under
+`dropped` rather than emitted as blank rows. The
+bundle must contain at least one Patient resource.
 </dd>
 </dl>
 </dd>

package/dist/cjs/api/resources/fhir2Omop/types/MappingReportEntry.d.ts

@@ -1,18 +0,0 @@
-/**
- * One source_to_concept_map-style mapping suggestion (Usagi-shaped).
- */
-export interface MappingReportEntry {
-    resource_type?: string | undefined;
-    resource_id?: string | undefined;
-    omop_table?: string | undefined;
-    source_system?: string | undefined;
-    source_code?: string | undefined;
-    source_name?: string | undefined;
-    target_vocabulary?: string | undefined;
-    target_code?: string | undefined;
-    target_name?: string | undefined;
-    /** ALREADY_STANDARD (source already in target vocabulary), UNCHECKED (unreviewed suggestion), or UNMAPPED (no candidate found). */
-    mapping_status?: string | undefined;
-    equivalence?: string | undefined;
-    note?: string | undefined;
-}

package/dist/cjs/api/resources/fhir2Omop/types/ScanSummary.d.ts

@@ -1,15 +0,0 @@
-import type * as phenoml from "../../../index.js";
-/**
- * White Rabbit-style aggregate profile of the mapping request.
- */
-export interface ScanSummary {
-    total_resources?: number | undefined;
-    resource_counts?: Record<string, number> | undefined;
-    tables_populated?: Record<string, number> | undefined;
-    coding_systems?: Record<string, number> | undefined;
-    codes_already_standard?: number | undefined;
-    codes_normalized?: number | undefined;
-    codes_unmapped?: number | undefined;
-    off_vocab_rate?: number | undefined;
-    dropped_resources?: phenoml.fhir2Omop.DroppedResource[] | undefined;
-}

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

@@ -1,18 +0,0 @@
-/**
- * One source_to_concept_map-style mapping suggestion (Usagi-shaped).
- */
-export interface MappingReportEntry {
-    resource_type?: string | undefined;
-    resource_id?: string | undefined;
-    omop_table?: string | undefined;
-    source_system?: string | undefined;
-    source_code?: string | undefined;
-    source_name?: string | undefined;
-    target_vocabulary?: string | undefined;
-    target_code?: string | undefined;
-    target_name?: string | undefined;
-    /** ALREADY_STANDARD (source already in target vocabulary), UNCHECKED (unreviewed suggestion), or UNMAPPED (no candidate found). */
-    mapping_status?: string | undefined;
-    equivalence?: string | undefined;
-    note?: string | undefined;
-}

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

@@ -1,15 +0,0 @@
-import type * as phenoml from "../../../index.mjs";
-/**
- * White Rabbit-style aggregate profile of the mapping request.
- */
-export interface ScanSummary {
-    total_resources?: number | undefined;
-    resource_counts?: Record<string, number> | undefined;
-    tables_populated?: Record<string, number> | undefined;
-    coding_systems?: Record<string, number> | undefined;
-    codes_already_standard?: number | undefined;
-    codes_normalized?: number | undefined;
-    codes_unmapped?: number | undefined;
-    off_vocab_rate?: number | undefined;
-    dropped_resources?: phenoml.fhir2Omop.DroppedResource[] | undefined;
-}