gdc-common-utils-ts 2.9.21 → 2.9.23

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/v3-purpose-of-use-9972646913.generated.js

@@ -0,0 +1,37 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://terminology.hl7.org/ValueSet/v3-PurposeOfUse",
+    "canonicalUrl": "http://terminology.hl7.org/ValueSet/v3-PurposeOfUse",
+    "resolved": true,
+    "version": "2014-03-26",
+    "name": "v3.PurposeOfUse",
+    "title": "V3 Value SetPurposeOfUse",
+    "status": "active",
+    "description": " Supports communication of purpose of use at a general level.",
+    "immutable": false,
+    "compose": {
+        "include": [
+            {
+                "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
+                "filter": [
+                    {
+                        "property": "concept",
+                        "op": "is-a",
+                        "value": "PurposeOfUse"
+                    }
+                ]
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "Consent",
+            "profile": "http://hl7.org/fhir/StructureDefinition/Consent|4.0.1",
+            "elementId": "Consent.provision.purpose",
+            "path": "Consent.provision.purpose",
+            "purpose": "primary",
+            "strength": "extensible"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/v3-substance-admin-substitution-reason-6fc55e4316.generated.d.ts

@@ -0,0 +1,35 @@
+export declare const VALUE_SET: {
+    readonly canonicalReference: "http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason";
+    readonly canonicalUrl: "http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason";
+    readonly resolved: true;
+    readonly version: "2014-03-26";
+    readonly name: "v3.SubstanceAdminSubstitutionReason";
+    readonly title: "V3 Value SetSubstanceAdminSubstitutionReason";
+    readonly status: "active";
+    readonly description: "No Description Provided";
+    readonly immutable: false;
+    readonly compose: {
+        readonly include: readonly [{
+            readonly system: "http://terminology.hl7.org/CodeSystem/v3-ActReason";
+            readonly filter: readonly [{
+                readonly property: "concept";
+                readonly op: "is-a";
+                readonly value: "_SubstanceAdminSubstitutionReason";
+            }];
+        }];
+        readonly exclude: readonly [{
+            readonly system: "http://terminology.hl7.org/CodeSystem/v3-ActReason";
+            readonly concept: readonly [{
+                readonly code: "_SubstanceAdminSubstitutionReason";
+            }];
+        }];
+    };
+    readonly usages: readonly [{
+        readonly resourceType: "MedicationDispense";
+        readonly profile: "http://hl7.org/fhir/StructureDefinition/MedicationDispense|4.0.1";
+        readonly elementId: "MedicationDispense.substitution.reason";
+        readonly path: "MedicationDispense.substitution.reason";
+        readonly purpose: "primary";
+        readonly strength: "example";
+    }];
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/v3-substance-admin-substitution-reason-6fc55e4316.generated.js

@@ -0,0 +1,47 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason",
+    "canonicalUrl": "http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason",
+    "resolved": true,
+    "version": "2014-03-26",
+    "name": "v3.SubstanceAdminSubstitutionReason",
+    "title": "V3 Value SetSubstanceAdminSubstitutionReason",
+    "status": "active",
+    "description": "No Description Provided",
+    "immutable": false,
+    "compose": {
+        "include": [
+            {
+                "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
+                "filter": [
+                    {
+                        "property": "concept",
+                        "op": "is-a",
+                        "value": "_SubstanceAdminSubstitutionReason"
+                    }
+                ]
+            }
+        ],
+        "exclude": [
+            {
+                "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
+                "concept": [
+                    {
+                        "code": "_SubstanceAdminSubstitutionReason"
+                    }
+                ]
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "MedicationDispense",
+            "profile": "http://hl7.org/fhir/StructureDefinition/MedicationDispense|4.0.1",
+            "elementId": "MedicationDispense.substitution.reason",
+            "path": "MedicationDispense.substitution.reason",
+            "purpose": "primary",
+            "strength": "example"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccine-code-80418ac0a0.generated.d.ts

@@ -0,0 +1,32 @@
+export declare const VALUE_SET: {
+    readonly canonicalReference: "http://hl7.org/fhir/ValueSet/vaccine-code";
+    readonly canonicalUrl: "http://hl7.org/fhir/ValueSet/vaccine-code";
+    readonly resolved: true;
+    readonly version: "4.0.1";
+    readonly name: "VaccineAdministeredValueSet";
+    readonly title: "Vaccine Administered Value Set";
+    readonly status: "active";
+    readonly description: "This identifies the vaccine substance administered - CVX codes.";
+    readonly compose: {
+        readonly include: readonly [{
+            readonly system: "http://hl7.org/fhir/sid/cvx";
+        }, {
+            readonly system: "urn:oid:1.2.36.1.2001.1005.17";
+        }];
+    };
+    readonly usages: readonly [{
+        readonly resourceType: "ImmunizationRecommendation";
+        readonly profile: "http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation|4.0.1";
+        readonly elementId: "ImmunizationRecommendation.recommendation.vaccineCode";
+        readonly path: "ImmunizationRecommendation.recommendation.vaccineCode";
+        readonly purpose: "primary";
+        readonly strength: "example";
+    }, {
+        readonly resourceType: "ImmunizationRecommendation";
+        readonly profile: "http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation|4.0.1";
+        readonly elementId: "ImmunizationRecommendation.recommendation.contraindicatedVaccineCode";
+        readonly path: "ImmunizationRecommendation.recommendation.contraindicatedVaccineCode";
+        readonly purpose: "primary";
+        readonly strength: "example";
+    }];
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccine-code-80418ac0a0.generated.js

@@ -0,0 +1,40 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://hl7.org/fhir/ValueSet/vaccine-code",
+    "canonicalUrl": "http://hl7.org/fhir/ValueSet/vaccine-code",
+    "resolved": true,
+    "version": "4.0.1",
+    "name": "VaccineAdministeredValueSet",
+    "title": "Vaccine Administered Value Set",
+    "status": "active",
+    "description": "This identifies the vaccine substance administered - CVX codes.",
+    "compose": {
+        "include": [
+            {
+                "system": "http://hl7.org/fhir/sid/cvx"
+            },
+            {
+                "system": "urn:oid:1.2.36.1.2001.1005.17"
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "ImmunizationRecommendation",
+            "profile": "http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation|4.0.1",
+            "elementId": "ImmunizationRecommendation.recommendation.vaccineCode",
+            "path": "ImmunizationRecommendation.recommendation.vaccineCode",
+            "purpose": "primary",
+            "strength": "example"
+        },
+        {
+            "resourceType": "ImmunizationRecommendation",
+            "profile": "http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation|4.0.1",
+            "elementId": "ImmunizationRecommendation.recommendation.contraindicatedVaccineCode",
+            "path": "ImmunizationRecommendation.recommendation.contraindicatedVaccineCode",
+            "purpose": "primary",
+            "strength": "example"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccines-uv-ips-4385868b76.generated.d.ts

@@ -0,0 +1,36 @@
+export declare const VALUE_SET: {
+    readonly canonicalReference: "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-uv-ips|2.0.1";
+    readonly canonicalUrl: "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-uv-ips";
+    readonly resolved: true;
+    readonly version: "2.0.1";
+    readonly name: "VaccinesUvIps";
+    readonly title: "Vaccines - IPS";
+    readonly status: "active";
+    readonly description: "IPS Vaccine codes value set.  This value set includes codes from SNOMED CT®: all descendants of 787859002 \\|Vaccine product (product)\\|; all descendants or self of 787482006 \\|No known immunizations (situation)\\|\n\nSNOMED CT® ECL definition:\\\n< 787859002 \\|Vaccine product (product)\\| OR \\<\\< 787482006 \\|No known immunizations (situation)\\|";
+    readonly immutable: false;
+    readonly compose: {
+        readonly include: readonly [{
+            readonly system: "http://snomed.info/sct";
+            readonly filter: readonly [{
+                readonly property: "concept";
+                readonly op: "descendent-of";
+                readonly value: "787859002";
+            }];
+        }, {
+            readonly system: "http://snomed.info/sct";
+            readonly filter: readonly [{
+                readonly property: "concept";
+                readonly op: "is-a";
+                readonly value: "787482006";
+            }];
+        }];
+    };
+    readonly usages: readonly [{
+        readonly resourceType: "Immunization";
+        readonly profile: "http://hl7.org/fhir/uv/ips/StructureDefinition/Immunization-uv-ips|2.0.1";
+        readonly elementId: "Immunization.vaccineCode";
+        readonly path: "Immunization.vaccineCode";
+        readonly purpose: "primary";
+        readonly strength: "preferred";
+    }];
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccines-uv-ips-4385868b76.generated.js

@@ -0,0 +1,47 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-uv-ips|2.0.1",
+    "canonicalUrl": "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-uv-ips",
+    "resolved": true,
+    "version": "2.0.1",
+    "name": "VaccinesUvIps",
+    "title": "Vaccines - IPS",
+    "status": "active",
+    "description": "IPS Vaccine codes value set.  This value set includes codes from SNOMED CT®: all descendants of 787859002 \\|Vaccine product (product)\\|; all descendants or self of 787482006 \\|No known immunizations (situation)\\|\n\nSNOMED CT® ECL definition:\\\n< 787859002 \\|Vaccine product (product)\\| OR \\<\\< 787482006 \\|No known immunizations (situation)\\|",
+    "immutable": false,
+    "compose": {
+        "include": [
+            {
+                "system": "http://snomed.info/sct",
+                "filter": [
+                    {
+                        "property": "concept",
+                        "op": "descendent-of",
+                        "value": "787859002"
+                    }
+                ]
+            },
+            {
+                "system": "http://snomed.info/sct",
+                "filter": [
+                    {
+                        "property": "concept",
+                        "op": "is-a",
+                        "value": "787482006"
+                    }
+                ]
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "Immunization",
+            "profile": "http://hl7.org/fhir/uv/ips/StructureDefinition/Immunization-uv-ips|2.0.1",
+            "elementId": "Immunization.vaccineCode",
+            "path": "Immunization.vaccineCode",
+            "purpose": "primary",
+            "strength": "preferred"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccines-whoatc-uv-ips-d98435ab44.generated.d.ts

@@ -0,0 +1,29 @@
+export declare const VALUE_SET: {
+    readonly canonicalReference: "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-whoatc-uv-ips|2.0.1";
+    readonly canonicalUrl: "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-whoatc-uv-ips";
+    readonly resolved: true;
+    readonly version: "2.0.1";
+    readonly name: "VaccinesWhoAtcUvIps";
+    readonly title: "Vaccines WHO ATC - IPS";
+    readonly status: "active";
+    readonly description: "IPS Vaccine codes value set.  This value set includes codes from the World Health Organization Anatomical Therapeutic Chemical (ATC) classification system: all descendants of J07 \"VACCINES\"";
+    readonly immutable: false;
+    readonly compose: {
+        readonly include: readonly [{
+            readonly system: "http://www.whocc.no/atc";
+            readonly filter: readonly [{
+                readonly property: "concept";
+                readonly op: "descendent-of";
+                readonly value: "J07";
+            }];
+        }];
+    };
+    readonly usages: readonly [{
+        readonly resourceType: "Immunization";
+        readonly profile: "http://hl7.org/fhir/uv/ips/StructureDefinition/Immunization-uv-ips|2.0.1";
+        readonly elementId: "Immunization.vaccineCode";
+        readonly path: "Immunization.vaccineCode";
+        readonly purpose: "additional";
+        readonly strength: "preferred";
+    }];
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/vaccines-whoatc-uv-ips-d98435ab44.generated.js

@@ -0,0 +1,37 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-whoatc-uv-ips|2.0.1",
+    "canonicalUrl": "http://hl7.org/fhir/uv/ips/ValueSet/vaccines-whoatc-uv-ips",
+    "resolved": true,
+    "version": "2.0.1",
+    "name": "VaccinesWhoAtcUvIps",
+    "title": "Vaccines WHO ATC - IPS",
+    "status": "active",
+    "description": "IPS Vaccine codes value set.  This value set includes codes from the World Health Organization Anatomical Therapeutic Chemical (ATC) classification system: all descendants of J07 \"VACCINES\"",
+    "immutable": false,
+    "compose": {
+        "include": [
+            {
+                "system": "http://www.whocc.no/atc",
+                "filter": [
+                    {
+                        "property": "concept",
+                        "op": "descendent-of",
+                        "value": "J07"
+                    }
+                ]
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "Immunization",
+            "profile": "http://hl7.org/fhir/uv/ips/StructureDefinition/Immunization-uv-ips|2.0.1",
+            "elementId": "Immunization.vaccineCode",
+            "path": "Immunization.vaccineCode",
+            "purpose": "additional",
+            "strength": "preferred"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/whoatc-uv-ips-ba6ff6c38b.generated.d.ts

@@ -0,0 +1,31 @@
+export declare const VALUE_SET: {
+    readonly canonicalReference: "http://hl7.org/fhir/uv/ips/ValueSet/whoatc-uv-ips|2.0.1";
+    readonly canonicalUrl: "http://hl7.org/fhir/uv/ips/ValueSet/whoatc-uv-ips";
+    readonly resolved: true;
+    readonly version: "2.0.1";
+    readonly name: "WhoAtcUvIps";
+    readonly title: "WHO ATC - IPS";
+    readonly status: "active";
+    readonly description: "World Health Organization Anatomical Therapeutic Chemical (ATC) classification system.";
+    readonly immutable: false;
+    readonly compose: {
+        readonly include: readonly [{
+            readonly system: "http://www.whocc.no/atc";
+        }];
+    };
+    readonly usages: readonly [{
+        readonly resourceType: "AllergyIntolerance";
+        readonly profile: "http://hl7.org/fhir/uv/ips/StructureDefinition/AllergyIntolerance-uv-ips|2.0.1";
+        readonly elementId: "AllergyIntolerance.code";
+        readonly path: "AllergyIntolerance.code";
+        readonly purpose: "additional";
+        readonly strength: "preferred";
+    }, {
+        readonly resourceType: "Medication";
+        readonly profile: "http://hl7.org/fhir/uv/ips/StructureDefinition/Medication-uv-ips|2.0.1";
+        readonly elementId: "Medication.code";
+        readonly path: "Medication.code";
+        readonly purpose: "additional";
+        readonly strength: "preferred";
+    }];
+};

package/dist/models/interoperable-claims/ips-profile-catalog.generated/value-sets/whoatc-uv-ips-ba6ff6c38b.generated.js

@@ -0,0 +1,38 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// GENERATED FILE. DO NOT EDIT. See scripts/generate-ips-profile-catalog.mjs.
+export const VALUE_SET = {
+    "canonicalReference": "http://hl7.org/fhir/uv/ips/ValueSet/whoatc-uv-ips|2.0.1",
+    "canonicalUrl": "http://hl7.org/fhir/uv/ips/ValueSet/whoatc-uv-ips",
+    "resolved": true,
+    "version": "2.0.1",
+    "name": "WhoAtcUvIps",
+    "title": "WHO ATC - IPS",
+    "status": "active",
+    "description": "World Health Organization Anatomical Therapeutic Chemical (ATC) classification system.",
+    "immutable": false,
+    "compose": {
+        "include": [
+            {
+                "system": "http://www.whocc.no/atc"
+            }
+        ]
+    },
+    "usages": [
+        {
+            "resourceType": "AllergyIntolerance",
+            "profile": "http://hl7.org/fhir/uv/ips/StructureDefinition/AllergyIntolerance-uv-ips|2.0.1",
+            "elementId": "AllergyIntolerance.code",
+            "path": "AllergyIntolerance.code",
+            "purpose": "additional",
+            "strength": "preferred"
+        },
+        {
+            "resourceType": "Medication",
+            "profile": "http://hl7.org/fhir/uv/ips/StructureDefinition/Medication-uv-ips|2.0.1",
+            "elementId": "Medication.code",
+            "path": "Medication.code",
+            "purpose": "additional",
+            "strength": "preferred"
+        }
+    ]
+};

package/dist/models/interoperable-claims/ips-profile-catalog.js

@@ -0,0 +1,3 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+export * from './ips-profile-types.js';
+export * from './ips-profile-catalog.generated/index.js';

package/dist/models/interoperable-claims/ips-profile-types.d.ts

@@ -0,0 +1,76 @@
+export type FhirSearchParameterType = 'number' | 'date' | 'string' | 'token' | 'reference' | 'composite' | 'quantity' | 'uri' | 'special';
+export type IpsElementBinding = Readonly<{
+    strength: 'required' | 'extensible' | 'preferred' | 'example';
+    valueSet: string;
+    additionalValueSets: readonly string[];
+}>;
+export type IpsProfileElement = Readonly<{
+    id: string;
+    path: string;
+    min: number;
+    max: string;
+    mustSupport: boolean;
+    fhirTypes: readonly string[];
+    typeProfiles: readonly string[];
+    targetProfiles: readonly string[];
+    contentReference?: string;
+    fixedValue?: Readonly<{
+        fhirType: string;
+        value: unknown;
+    }>;
+    patternValue?: Readonly<{
+        fhirType: string;
+        value: unknown;
+    }>;
+    binding?: IpsElementBinding;
+    creatorObligations: readonly string[];
+    consumerObligations: readonly string[];
+}>;
+export type IpsProfileDefinition = Readonly<{
+    resourceType: string;
+    canonicalUrl: string;
+    version: string;
+    name: string;
+    elements: readonly IpsProfileElement[];
+}>;
+export type FhirSearchParameterDefinition = Readonly<{
+    code: string;
+    type: FhirSearchParameterType;
+    url: string;
+    expression?: string;
+    fhirVersions: readonly string[];
+}>;
+export type IpsResourceCapability = Readonly<{
+    resourceType: string;
+    /** Profiles explicitly advertised by the IPS CapabilityStatement. */
+    supportedProfiles: readonly string[];
+    /** Effective field contracts: advertised profiles, or the R4 base resource when IPS declares none. */
+    profiles: readonly string[];
+    interactions: readonly string[];
+    /** Canonical flat-claim names from the applicable R4 FHIR SearchParameter definitions. */
+    searchParameters: readonly FhirSearchParameterDefinition[];
+}>;
+export type IpsProfileCatalog = Readonly<Record<string, IpsProfileDefinition>>;
+export type IpsValueSetUsage = Readonly<{
+    resourceType: string;
+    profile: string;
+    elementId: string;
+    path: string;
+    purpose: 'primary' | 'additional';
+    strength: 'required' | 'extensible' | 'preferred' | 'example';
+}>;
+export type IpsValueSetDefinition = Readonly<{
+    canonicalReference: string;
+    canonicalUrl: string;
+    resolved: boolean;
+    version?: string;
+    name?: string;
+    title?: string;
+    status?: string;
+    description?: string;
+    immutable?: boolean;
+    compose?: unknown;
+    expansion?: unknown;
+    usages: readonly IpsValueSetUsage[];
+}>;
+export type IpsValueSetCatalog = Readonly<Record<string, IpsValueSetDefinition>>;

package/dist/models/interoperable-claims/ips-profile-types.js

@@ -0,0 +1,2 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+export {};

package/dist/models/interoperable-claims/medication-statement-claims.d.ts

@@ -22,7 +22,7 @@ export declare const MedicationStatementAdherenceCodes: {
 };
 export type MedicationStatementAdherenceCode = typeof MedicationStatementAdherenceCodes[keyof typeof MedicationStatementAdherenceCodes];
 /**
- * Canonical flat claim keys for the lightweight `MedicationStatement.*` mapping
+ * FHIR-like flat claim keys for the lightweight `MedicationStatement.*` mapping
  * used by shared examples, GW ingestion, and converter roundtrip tests.
  */
 export declare const MedicationStatementClaim: {

package/dist/models/interoperable-claims/medication-statement-claims.js

@@ -22,7 +22,7 @@ export const MedicationStatementAdherenceCodes = {
     Unknown: 'unknown',
 };
 /**
- * Canonical flat claim keys for the lightweight `MedicationStatement.*` mapping
+ * FHIR-like flat claim keys for the lightweight `MedicationStatement.*` mapping
  * used by shared examples, GW ingestion, and converter roundtrip tests.
  */
 export const MedicationStatementClaim = {

package/dist/models/interoperable-claims/observation-claims.d.ts

@@ -1,6 +1,6 @@
 import type { ClaimSpec } from './types.js';
 /**
- * Canonical flat claims for a persisted Observation.
+ * FHIR-like flat claims for a persisted Observation.
  *
  * Naming contract:
  * - version-specific suffixes go at the end of helper names, e.g.

package/dist/models/interoperable-claims/observation-claims.js

@@ -2,7 +2,7 @@
 // File: src/models/interoperable-claims/observation-claims.ts
 import { ObservationCategoryCodes } from '../../constants/observation-category.js';
 /**
- * Canonical flat claims for a persisted Observation.
+ * FHIR-like flat claims for a persisted Observation.
  *
  * Naming contract:
  * - version-specific suffixes go at the end of helper names, e.g.

package/dist/models/interoperable-claims/types.d.ts

@@ -1,9 +1,22 @@
 /**
- * Canonical interoperable-claims keys used by claims-first payloads.
- * Keep this separated from strict FHIR resource typings.
+ * FHIR-like flat-claim metadata used by claims-first payloads.
+ *
+ * Only names published under the resource's official FHIR `#search` section
+ * are canonical flat-search claims. Every other key is either a documented
+ * FHIR standard extension or a documented custom extension; being a native
+ * FHIR element does not by itself make a flat claim canonical.
+ * Applicable IPS profiles govern creation/card support and ValueSet bindings;
+ * the IPS Server CapabilityStatement governs the server interaction surface.
+ *
+ * @see ../../../../docs/FHIR-LIKE-FLAT-CLAIMS.md
  */
 export type ClaimSpec = {
     key: string;
     meaning: string;
     example: string;
 };
+export type FhirStandardExtensionClaimSpec = ClaimSpec & {
+    origin: 'fhir-standard-extension';
+    canonicalUrl: `http${string}/StructureDefinition/${string}`;
+    fhirType: string;
+};

package/dist/utils/consent.d.ts

@@ -110,7 +110,8 @@ export declare function isValidConsentPeriodBoundary(value: string): boolean;
  * Parses a single canonical consent actor token into its resolved kind/value.
  *
  * @param rawToken Raw actor token such as `did:...`, `user@example.org`,
- * `tel:+34600111222`, or `ES`.
+ * `tel:+34600111222`, `ES`, `urn:iso:3166:ES`, or
+ * `urn:iso:3166-2:CA-BC`.
  * @returns The normalized parsed token or `undefined` when the token cannot be resolved.
  */
 export declare function parseConsentActorToken(rawToken: string): ParsedConsentActorToken | undefined;

package/dist/utils/consent.js

@@ -49,7 +49,8 @@ export function isValidConsentPeriodBoundary(value) {
  * Parses a single canonical consent actor token into its resolved kind/value.
  *
  * @param rawToken Raw actor token such as `did:...`, `user@example.org`,
- * `tel:+34600111222`, or `ES`.
+ * `tel:+34600111222`, `ES`, `urn:iso:3166:ES`, or
+ * `urn:iso:3166-2:CA-BC`.
  * @returns The normalized parsed token or `undefined` when the token cannot be resolved.
  */
 export function parseConsentActorToken(rawToken) {
@@ -71,6 +72,14 @@ export function parseConsentActorToken(rawToken) {
     if (/^[A-Z]{2}$/.test(token)) {
         return { kind: 'country', value: token };
     }
+    const isoCountry = token.match(/^urn:iso:3166:([a-z]{2})$/i);
+    if (isoCountry) {
+        return { kind: 'country', value: `urn:iso:3166:${isoCountry[1].toUpperCase()}` };
+    }
+    const isoSubdivision = token.match(/^urn:iso:3166-2:([a-z]{2}-[a-z0-9]{1,3})$/i);
+    if (isoSubdivision) {
+        return { kind: 'country', value: `urn:iso:3166-2:${isoSubdivision[1].toUpperCase()}` };
+    }
     return undefined;
 }
 /**

package/package.json

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