gdc-common-utils-ts 2.3.26 → 2.3.28

package/dist/utils/ips-bundle-claims.d.ts

@@ -17,10 +17,9 @@ export type FhirMetaTagCoding = Readonly<{
     display?: string;
 }>;
 /**
- * Removes the versioned/contextualized FHIR prefix from a flattened claim key.
+ * Removes the version-independent FHIR API context from a flattened claim key.
  *
  * Examples:
- * - `org.hl7.fhir.r4.Immunization.vaccine-code` -> `Immunization.vaccine-code`
  * - `org.hl7.fhir.api.MedicationStatement.subject` -> `MedicationStatement.subject`
  * - `Consent.identifier` -> `Consent.identifier`
  */
@@ -35,8 +34,8 @@ export declare function extractResourceMetaClaimsFromBundle(bundle: BundleLike):
 /**
  * Builds FHIR `meta.tag[]` codings from a flat claims record.
  *
- * The generated `code` is version-agnostic so UI/frontends can use the same
- * tag keys across `org.hl7.fhir.r4.*` and `org.hl7.fhir.api.*` payloads.
+ * The generated `code` removes the sole valid FHIR claims context,
+ * `org.hl7.fhir.api`, so UI/frontends receive the canonical short key.
  */
 export declare function createFhirMetaTagsFromClaims(claims: Record<string, unknown>, options?: Readonly<{
     system?: string;

package/dist/utils/ips-bundle-claims.js

@@ -1,10 +1,9 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 export const DEFAULT_META_CLAIM_TAG_SYSTEM = 'urn:gdc:fhir:meta-claim';
 /**
- * Removes the versioned/contextualized FHIR prefix from a flattened claim key.
+ * Removes the version-independent FHIR API context from a flattened claim key.
  *
  * Examples:
- * - `org.hl7.fhir.r4.Immunization.vaccine-code` -> `Immunization.vaccine-code`
  * - `org.hl7.fhir.api.MedicationStatement.subject` -> `MedicationStatement.subject`
  * - `Consent.identifier` -> `Consent.identifier`
  */
@@ -12,9 +11,10 @@ export function toVersionAgnosticMetaClaimKey(claimKey) {
     const raw = String(claimKey || '').trim();
     if (!raw)
         return '';
-    return raw
-        .replace(/^org\.hl7\.fhir\.[a-z0-9]+\./i, '')
-        .replace(/^org\.hl7\.fhir\.api\./i, '');
+    if (raw.startsWith('org.hl7.fhir.') && !raw.startsWith('org.hl7.fhir.api.')) {
+        throw new Error('FHIR claims require @context org.hl7.fhir.api.');
+    }
+    return raw.replace(/^org\.hl7\.fhir\.api\./i, '');
 }
 /**
  * Extracts all `resource.meta.claims` blocks from a FHIR/JSON:API bundle.
@@ -35,8 +35,8 @@ export function extractResourceMetaClaimsFromBundle(bundle) {
 /**
  * Builds FHIR `meta.tag[]` codings from a flat claims record.
  *
- * The generated `code` is version-agnostic so UI/frontends can use the same
- * tag keys across `org.hl7.fhir.r4.*` and `org.hl7.fhir.api.*` payloads.
+ * The generated `code` removes the sole valid FHIR claims context,
+ * `org.hl7.fhir.api`, so UI/frontends receive the canonical short key.
  */
 export function createFhirMetaTagsFromClaims(claims, options) {
     const system = String(options?.system || DEFAULT_META_CLAIM_TAG_SYSTEM).trim();

package/dist/utils/medication-statement-entry-editor.js

@@ -63,25 +63,25 @@ export class MedicationStatementEntryEditor extends ClinicalResourceEntryEditor
     /** Returns the medication category/section tags. */
     getCategoryList() { return this.getCsvClaimList(MedicationStatementClaim.Category); }
     /** Sets the numeric dose quantity value. */
-    setDoseQuantityValue(value) { return this.setNumberClaim(MedicationStatementClaimsFhirApiExtended.DoseQuantityValue, value); }
+    setDoseQuantityValue(value) { return this.setNumberClaim(MedicationStatementClaim.DoseQuantityValue, value); }
     /** Returns the numeric dose quantity value. */
-    getDoseQuantityValue() { return this.getNumberClaim(MedicationStatementClaimsFhirApiExtended.DoseQuantityValue); }
+    getDoseQuantityValue() { return this.getNumberClaim(MedicationStatementClaim.DoseQuantityValue); }
     /** Sets the dose quantity unit token. */
-    setDoseQuantityUnit(value) { return this.setScalarClaim(MedicationStatementClaimsFhirApiExtended.DoseQuantityUnit, value); }
+    setDoseQuantityUnit(value) { return this.setScalarClaim(MedicationStatementClaim.DoseQuantityUnit, value); }
     /** Returns the dose quantity unit token. */
-    getDoseQuantityUnit() { return this.getScalarClaim(MedicationStatementClaimsFhirApiExtended.DoseQuantityUnit); }
+    getDoseQuantityUnit() { return this.getScalarClaim(MedicationStatementClaim.DoseQuantityUnit); }
     /** Sets the timing frequency for structured dosage authoring. */
-    setTimingFrequency(value) { return this.setNumberClaim(MedicationStatementClaimsFhirApiExtended.TimingFrequency, value); }
+    setTimingFrequency(value) { return this.setNumberClaim(MedicationStatementClaim.TimingFrequency, value); }
     /** Returns the timing frequency. */
-    getTimingFrequency() { return this.getNumberClaim(MedicationStatementClaimsFhirApiExtended.TimingFrequency); }
+    getTimingFrequency() { return this.getNumberClaim(MedicationStatementClaim.TimingFrequency); }
     /** Sets the timing period for structured dosage authoring. */
-    setTimingPeriod(value) { return this.setNumberClaim(MedicationStatementClaimsFhirApiExtended.TimingPeriod, value); }
+    setTimingPeriod(value) { return this.setNumberClaim(MedicationStatementClaim.TimingPeriod, value); }
     /** Returns the timing period. */
-    getTimingPeriod() { return this.getNumberClaim(MedicationStatementClaimsFhirApiExtended.TimingPeriod); }
+    getTimingPeriod() { return this.getNumberClaim(MedicationStatementClaim.TimingPeriod); }
     /** Sets the timing period unit token. */
-    setTimingPeriodUnit(value) { return this.setScalarClaim(MedicationStatementClaimsFhirApiExtended.TimingPeriodUnit, value); }
+    setTimingPeriodUnit(value) { return this.setScalarClaim(MedicationStatementClaim.TimingPeriodUnit, value); }
     /** Returns the timing period unit token. */
-    getTimingPeriodUnit() { return this.getScalarClaim(MedicationStatementClaimsFhirApiExtended.TimingPeriodUnit); }
+    getTimingPeriodUnit() { return this.getScalarClaim(MedicationStatementClaim.TimingPeriodUnit); }
     /** Marks whether this dosage is `as needed`. */
     setDosageAsNeeded(value) { return this.setBooleanClaim(MedicationStatementClaimsFhirApiExtended.DosageAsNeeded, value); }
     /** Returns whether this dosage is `as needed`. */

package/dist/utils/observation-component-entry-editor.d.ts

@@ -6,14 +6,14 @@
  * - Move shared helpers to reusable helper/base modules instead of duplicating logic here.
  */
 import { type CodingDescriptor } from '../constants/vital-signs';
-import { BundleEntryEditor } from './bundle-entry-editor';
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
 /**
  * Typed editor for one staged ObservationComponent resource entry.
  *
  * Keep this surface thin and claim-focused so 101 tests can teach one
  * resource at a time without exposing bundle-internal plumbing.
  */
-export declare class ObservationComponentEntryEditor extends BundleEntryEditor {
+export declare class ObservationComponentEntryEditor extends ClinicalResourceEntryEditor {
     setCode(code: CodingDescriptor | string): this;
     getCode(): string | undefined;
     setCodeSystem(system: string): this;

package/dist/utils/observation-component-entry-editor.js

@@ -1,13 +1,13 @@
 import { ObservationClaim } from '../models/interoperable-claims/observation-claims.js';
 import { normalizeOptionalIdentifier } from './bundle-editor-helpers.js';
-import { BundleEntryEditor } from './bundle-entry-editor.js';
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
 /**
  * Typed editor for one staged ObservationComponent resource entry.
  *
  * Keep this surface thin and claim-focused so 101 tests can teach one
  * resource at a time without exposing bundle-internal plumbing.
  */
-export class ObservationComponentEntryEditor extends BundleEntryEditor {
+export class ObservationComponentEntryEditor extends ClinicalResourceEntryEditor {
     setCode(code) {
         const token = typeof code === 'string' ? code.trim() : code.claim;
         this.setClaim(ObservationClaim.Code, token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.3.26",
+  "version": "2.3.28",
   "publishConfig": {
     "access": "public"
   },