fhir-data-utils-ts 0.2.4 → 0.3.1

package/dist/claims/procedure-claims.js

@@ -0,0 +1,44 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/procedure-claims.ts
+export const ProcedureClaim = {
+    BasedOn: 'Procedure.based-on',
+    BodySite: 'Procedure.body-site',
+    Code: 'Procedure.code',
+    CodeText: 'Procedure.code-text',
+    CodeDisplay: 'Procedure.code-display',
+    Date: 'Procedure.date',
+    Encounter: 'Procedure.encounter',
+    Identifier: 'Procedure.identifier',
+    InstantiatesCanonical: 'Procedure.instantiates-canonical',
+    InstantiatesUri: 'Procedure.instantiates-uri',
+    Location: 'Procedure.location',
+    PartOf: 'Procedure.part-of',
+    Patient: 'Procedure.patient',
+    Performer: 'Procedure.performer',
+    ReasonCode: 'Procedure.reason-code',
+    ReasonReference: 'Procedure.reason-reference',
+    Status: 'Procedure.status',
+    Subject: 'Procedure.subject',
+    Note: 'Procedure.note',
+};
+export const ProcedureClaimSpecs = [
+    { key: ProcedureClaim.BasedOn, meaning: 'Request or order reference.', example: 'ServiceRequest/sr-1' },
+    { key: ProcedureClaim.BodySite, meaning: 'Body site token.', example: 'http://snomed.info/sct|66754008' },
+    { key: ProcedureClaim.Code, meaning: 'Procedure code token.', example: 'http://snomed.info/sct|80146002' },
+    { key: ProcedureClaim.CodeText, meaning: 'Local-language procedure label used by forms/UI.', example: 'Apendicectomia' },
+    { key: ProcedureClaim.CodeDisplay, meaning: 'Canonical/international procedure display label.', example: 'Appendectomy' },
+    { key: ProcedureClaim.Date, meaning: 'Performed date/time.', example: '2026-06-01T10:00:00Z' },
+    { key: ProcedureClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
+    { key: ProcedureClaim.Identifier, meaning: 'Business identifier.', example: 'procedure-001' },
+    { key: ProcedureClaim.InstantiatesCanonical, meaning: 'Instantiated canonical plan/protocol.', example: 'http://example.org/PlanDefinition/appendectomy' },
+    { key: ProcedureClaim.InstantiatesUri, meaning: 'Instantiated URI.', example: 'urn:procedure-protocol:appendectomy' },
+    { key: ProcedureClaim.Location, meaning: 'Location reference.', example: 'Location/loc-1' },
+    { key: ProcedureClaim.PartOf, meaning: 'Parent procedure reference.', example: 'Procedure/proc-parent' },
+    { key: ProcedureClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: ProcedureClaim.Performer, meaning: 'Performer references (CSV).', example: 'Practitioner/prac-1' },
+    { key: ProcedureClaim.ReasonCode, meaning: 'Reason code token.', example: 'http://snomed.info/sct|233604007' },
+    { key: ProcedureClaim.ReasonReference, meaning: 'Reason reference.', example: 'Condition/cond-1' },
+    { key: ProcedureClaim.Status, meaning: 'Procedure status.', example: 'completed' },
+    { key: ProcedureClaim.Subject, meaning: 'Canonical subject reference.', example: 'did:web:patient.example.org' },
+    { key: ProcedureClaim.Note, meaning: 'Clinical note text.', example: 'Procedure tolerated well.' },
+];

package/dist/claims/related-person-claims.d.ts

@@ -0,0 +1,30 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const RelatedPersonClaim: {
+    /** Canonical FHIR API identifier search parameter. */
+    readonly Identifier: "RelatedPerson.identifier";
+    /** @deprecated Use `Identifier`; retained as a source-compatible property alias. */
+    readonly IdentifierValue: "RelatedPerson.identifier";
+    readonly Active: "RelatedPerson.active";
+    readonly Patient: "RelatedPerson.patient";
+    readonly Relationship: "RelatedPerson.relationship";
+    /**
+     * GDC flat-claim extension for comma-separated functional HL7 role codes.
+     * FHIR R4 RelatedPerson has no native `role` property; relationship/kinship
+     * remains in `RelatedPerson.relationship`.
+     */
+    readonly Role: "RelatedPerson.role";
+    readonly Name: "RelatedPerson.name";
+    readonly Telecom: "RelatedPerson.telecom";
+    readonly Gender: "RelatedPerson.gender";
+    readonly BirthDate: "RelatedPerson.birthdate";
+    readonly Address: "RelatedPerson.address";
+    /** Logical kind used when a RelatedPerson record acts as a related entity. */
+    readonly RelatedEntityType: "RelatedPerson.related-entity-type";
+    /**
+     * Original public values used to calculate the Consent rule/asset id.
+     * These values must not be replaced by the opaque RelatedPerson resource id.
+     */
+    readonly ActorIdentifier: "RelatedPerson.actor-identifier";
+};
+export type RelatedPersonClaimKey = typeof RelatedPersonClaim[keyof typeof RelatedPersonClaim];
+export declare const RelatedPersonClaimSpecs: ClaimSpec[];

package/dist/claims/related-person-claims.js

@@ -0,0 +1,44 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/related-person-claims.ts
+export const RelatedPersonClaim = {
+    /** Canonical FHIR API identifier search parameter. */
+    Identifier: 'RelatedPerson.identifier',
+    /** @deprecated Use `Identifier`; retained as a source-compatible property alias. */
+    IdentifierValue: 'RelatedPerson.identifier',
+    Active: 'RelatedPerson.active',
+    Patient: 'RelatedPerson.patient',
+    Relationship: 'RelatedPerson.relationship',
+    /**
+     * GDC flat-claim extension for comma-separated functional HL7 role codes.
+     * FHIR R4 RelatedPerson has no native `role` property; relationship/kinship
+     * remains in `RelatedPerson.relationship`.
+     */
+    Role: 'RelatedPerson.role',
+    Name: 'RelatedPerson.name',
+    Telecom: 'RelatedPerson.telecom',
+    Gender: 'RelatedPerson.gender',
+    BirthDate: 'RelatedPerson.birthdate',
+    Address: 'RelatedPerson.address',
+    /** Logical kind used when a RelatedPerson record acts as a related entity. */
+    RelatedEntityType: 'RelatedPerson.related-entity-type',
+    /**
+     * Original public values used to calculate the Consent rule/asset id.
+     * These values must not be replaced by the opaque RelatedPerson resource id.
+     */
+    ActorIdentifier: 'RelatedPerson.actor-identifier',
+};
+export const RelatedPersonClaimSpecs = [
+    { key: RelatedPersonClaim.IdentifierValue, meaning: 'Business identifier value.', example: 'rel-001' },
+    { key: RelatedPersonClaim.Identifier, meaning: 'Legacy business identifier alias.', example: 'rel-001' },
+    { key: RelatedPersonClaim.Active, meaning: 'Active flag.', example: 'true' },
+    { key: RelatedPersonClaim.Patient, meaning: 'Linked patient reference.', example: 'did:web:patient.example.org' },
+    { key: RelatedPersonClaim.Relationship, meaning: 'Relationship token.', example: 'http://terminology.hl7.org/CodeSystem/v3-RoleCode|MTH' },
+    { key: RelatedPersonClaim.Role, meaning: 'Comma-separated functional HL7 role values; this is a GDC flat-claim extension, not a native FHIR R4 RelatedPerson property. Known codes resolve to their canonical RoleClass or RoleCode system.', example: 'CAREGIVER,ECON,BILL' },
+    { key: RelatedPersonClaim.Name, meaning: 'Display name.', example: 'Jane Doe' },
+    { key: RelatedPersonClaim.Telecom, meaning: 'Contact value.', example: 'mailto:jane@example.org' },
+    { key: RelatedPersonClaim.Gender, meaning: 'Administrative gender.', example: 'female' },
+    { key: RelatedPersonClaim.BirthDate, meaning: 'Birth date.', example: '1980-02-01' },
+    { key: RelatedPersonClaim.Address, meaning: 'Display address.', example: '123 Main St, Vancouver' },
+    { key: RelatedPersonClaim.RelatedEntityType, meaning: 'Logical related-entity kind.', example: 'country-set' },
+    { key: RelatedPersonClaim.ActorIdentifier, meaning: 'Original public Consent actor identifiers as CSV.', example: 'ES,PT' },
+];

package/dist/claims/research-subject-claims.d.ts

@@ -0,0 +1,4 @@
+/** Claims projected by GW for a FHIR ResearchSubject search result. */
+export declare const ResearchSubjectClaim: Readonly<{
+    readonly Identifier: "ResearchSubject.identifier";
+}>;

package/dist/claims/research-subject-claims.js

@@ -0,0 +1,4 @@
+/** Claims projected by GW for a FHIR ResearchSubject search result. */
+export const ResearchSubjectClaim = Object.freeze({
+    Identifier: 'ResearchSubject.identifier',
+});

package/dist/claims/task-claims.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Canonical claims keys for Task (FHIR-oriented claims-first payloads).
+ * These keys are the source of truth for GW/SDK Task claim mapping.
+ */
+export declare enum TaskClaimsFhirApi {
+    Id = "Task.id",
+    Identifier = "Task.identifier",
+    GroupIdentifier = "Task.group-identifier",
+    Status = "Task.status",
+    StatusReason = "Task.status-reason",
+    BusinessStatus = "Task.business-status",
+    Intent = "Task.intent",
+    Code = "Task.code",
+    Description = "Task.description",
+    Subject = "Task.subject",
+    For = "Task.for",
+    Requester = "Task.requester",
+    Owner = "Task.owner",
+    Focus = "Task.focus",
+    PartOf = "Task.part-of",
+    BasedOn = "Task.based-on",
+    BasedOnDisplay = "Task.based-on-display",
+    Language = "Task.language",
+    Channel = "Task.channel",
+    AuthoredOn = "Task.authored-on",
+    LastModified = "Task.last-modified",
+    ScheduledAt = "Task.scheduled-at",
+    RetryIntervalMinutes = "Task.retry-interval-minutes",
+    MaxAttempts = "Task.max-attempts",
+    TriggerType = "Task.trigger-type",
+    Attempt = "Task.attempt",
+    WindowStart = "Task.window-start",
+    WindowEnd = "Task.window-end",
+    AutoCloseAt = "Task.auto-close-at",
+    EscalationRecipient = "Task.escalation-recipient",
+    Confirmed = "Task.confirmed",
+    ConfirmedAt = "Task.confirmed-at",
+    Repetitions = "Task.repetitions",
+    DaysOfWeek = "Task.days-of-week",
+    RepeatCount = "Task.repeat-count",
+    RepeatDurationValue = "Task.repeat-duration-value",
+    RepeatDurationUnit = "Task.repeat-duration-unit",
+    Modified = "Task.modified",
+    Priority = "Task.priority",
+    RestrictionPeriodStart = "Task.restriction-period-start",
+    RestrictionPeriodEnd = "Task.restriction-period-end",
+    ExecutionPeriodStart = "Task.execution-period-start",
+    ExecutionPeriodEnd = "Task.execution-period-end",
+    OutputType = "Task.output-type",
+    OutputValueReference = "Task.output-value-reference",
+    OutputValueString = "Task.output-value-string",
+    UserSelected = "Task.user-selected"
+}
+/** Complete product-neutral Task authoring contract shared by all sectors. */
+export declare const TaskArtifactSchema: Readonly<{
+    resourceType: "Task";
+    requiredClaims: readonly TaskClaimsFhirApi[];
+    optionalClaims: readonly (TaskClaimsFhirApi.Id | TaskClaimsFhirApi.Identifier | TaskClaimsFhirApi.GroupIdentifier | TaskClaimsFhirApi.StatusReason | TaskClaimsFhirApi.BusinessStatus | TaskClaimsFhirApi.Code | TaskClaimsFhirApi.Description | TaskClaimsFhirApi.Subject | TaskClaimsFhirApi.For | TaskClaimsFhirApi.Requester | TaskClaimsFhirApi.Owner | TaskClaimsFhirApi.Focus | TaskClaimsFhirApi.PartOf | TaskClaimsFhirApi.BasedOn | TaskClaimsFhirApi.BasedOnDisplay | TaskClaimsFhirApi.Language | TaskClaimsFhirApi.Channel | TaskClaimsFhirApi.AuthoredOn | TaskClaimsFhirApi.LastModified | TaskClaimsFhirApi.ScheduledAt | TaskClaimsFhirApi.RetryIntervalMinutes | TaskClaimsFhirApi.MaxAttempts | TaskClaimsFhirApi.TriggerType | TaskClaimsFhirApi.Attempt | TaskClaimsFhirApi.WindowStart | TaskClaimsFhirApi.WindowEnd | TaskClaimsFhirApi.AutoCloseAt | TaskClaimsFhirApi.EscalationRecipient | TaskClaimsFhirApi.Confirmed | TaskClaimsFhirApi.ConfirmedAt | TaskClaimsFhirApi.Repetitions | TaskClaimsFhirApi.DaysOfWeek | TaskClaimsFhirApi.RepeatCount | TaskClaimsFhirApi.RepeatDurationValue | TaskClaimsFhirApi.RepeatDurationUnit | TaskClaimsFhirApi.Modified | TaskClaimsFhirApi.Priority | TaskClaimsFhirApi.RestrictionPeriodStart | TaskClaimsFhirApi.RestrictionPeriodEnd | TaskClaimsFhirApi.ExecutionPeriodStart | TaskClaimsFhirApi.ExecutionPeriodEnd | TaskClaimsFhirApi.OutputType | TaskClaimsFhirApi.OutputValueReference | TaskClaimsFhirApi.OutputValueString | TaskClaimsFhirApi.UserSelected)[];
+}>;
+/** Common singular catalog name used consistently with the other resources. */
+export declare const TaskClaim: typeof TaskClaimsFhirApi;

package/dist/claims/task-claims.js

@@ -0,0 +1,64 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/task-claims.ts
+/**
+ * Canonical claims keys for Task (FHIR-oriented claims-first payloads).
+ * These keys are the source of truth for GW/SDK Task claim mapping.
+ */
+export var TaskClaimsFhirApi;
+(function (TaskClaimsFhirApi) {
+    TaskClaimsFhirApi["Id"] = "Task.id";
+    TaskClaimsFhirApi["Identifier"] = "Task.identifier";
+    TaskClaimsFhirApi["GroupIdentifier"] = "Task.group-identifier";
+    TaskClaimsFhirApi["Status"] = "Task.status";
+    TaskClaimsFhirApi["StatusReason"] = "Task.status-reason";
+    TaskClaimsFhirApi["BusinessStatus"] = "Task.business-status";
+    TaskClaimsFhirApi["Intent"] = "Task.intent";
+    TaskClaimsFhirApi["Code"] = "Task.code";
+    TaskClaimsFhirApi["Description"] = "Task.description";
+    TaskClaimsFhirApi["Subject"] = "Task.subject";
+    TaskClaimsFhirApi["For"] = "Task.for";
+    TaskClaimsFhirApi["Requester"] = "Task.requester";
+    TaskClaimsFhirApi["Owner"] = "Task.owner";
+    TaskClaimsFhirApi["Focus"] = "Task.focus";
+    TaskClaimsFhirApi["PartOf"] = "Task.part-of";
+    TaskClaimsFhirApi["BasedOn"] = "Task.based-on";
+    TaskClaimsFhirApi["BasedOnDisplay"] = "Task.based-on-display";
+    TaskClaimsFhirApi["Language"] = "Task.language";
+    TaskClaimsFhirApi["Channel"] = "Task.channel";
+    TaskClaimsFhirApi["AuthoredOn"] = "Task.authored-on";
+    TaskClaimsFhirApi["LastModified"] = "Task.last-modified";
+    TaskClaimsFhirApi["ScheduledAt"] = "Task.scheduled-at";
+    TaskClaimsFhirApi["RetryIntervalMinutes"] = "Task.retry-interval-minutes";
+    TaskClaimsFhirApi["MaxAttempts"] = "Task.max-attempts";
+    TaskClaimsFhirApi["TriggerType"] = "Task.trigger-type";
+    TaskClaimsFhirApi["Attempt"] = "Task.attempt";
+    TaskClaimsFhirApi["WindowStart"] = "Task.window-start";
+    TaskClaimsFhirApi["WindowEnd"] = "Task.window-end";
+    TaskClaimsFhirApi["AutoCloseAt"] = "Task.auto-close-at";
+    TaskClaimsFhirApi["EscalationRecipient"] = "Task.escalation-recipient";
+    TaskClaimsFhirApi["Confirmed"] = "Task.confirmed";
+    TaskClaimsFhirApi["ConfirmedAt"] = "Task.confirmed-at";
+    TaskClaimsFhirApi["Repetitions"] = "Task.repetitions";
+    TaskClaimsFhirApi["DaysOfWeek"] = "Task.days-of-week";
+    TaskClaimsFhirApi["RepeatCount"] = "Task.repeat-count";
+    TaskClaimsFhirApi["RepeatDurationValue"] = "Task.repeat-duration-value";
+    TaskClaimsFhirApi["RepeatDurationUnit"] = "Task.repeat-duration-unit";
+    TaskClaimsFhirApi["Modified"] = "Task.modified";
+    TaskClaimsFhirApi["Priority"] = "Task.priority";
+    TaskClaimsFhirApi["RestrictionPeriodStart"] = "Task.restriction-period-start";
+    TaskClaimsFhirApi["RestrictionPeriodEnd"] = "Task.restriction-period-end";
+    TaskClaimsFhirApi["ExecutionPeriodStart"] = "Task.execution-period-start";
+    TaskClaimsFhirApi["ExecutionPeriodEnd"] = "Task.execution-period-end";
+    TaskClaimsFhirApi["OutputType"] = "Task.output-type";
+    TaskClaimsFhirApi["OutputValueReference"] = "Task.output-value-reference";
+    TaskClaimsFhirApi["OutputValueString"] = "Task.output-value-string";
+    TaskClaimsFhirApi["UserSelected"] = "Task.user-selected";
+})(TaskClaimsFhirApi || (TaskClaimsFhirApi = {}));
+/** Complete product-neutral Task authoring contract shared by all sectors. */
+export const TaskArtifactSchema = Object.freeze({
+    resourceType: 'Task',
+    requiredClaims: Object.freeze([TaskClaimsFhirApi.Status, TaskClaimsFhirApi.Intent]),
+    optionalClaims: Object.freeze(Object.values(TaskClaimsFhirApi).filter(claim => claim !== TaskClaimsFhirApi.Status && claim !== TaskClaimsFhirApi.Intent)),
+});
+/** Common singular catalog name used consistently with the other resources. */
+export const TaskClaim = TaskClaimsFhirApi;

package/dist/clinical-terminology.d.ts

@@ -0,0 +1,73 @@
+/** Canonical code-system URIs shared by human and animal clinical channels. */
+export declare const ClinicalTerminologySystems: Readonly<{
+    readonly Loinc: "http://loinc.org";
+    readonly SnomedCt: "http://snomed.info/sct";
+    readonly Icd10: "http://hl7.org/fhir/sid/icd-10";
+    readonly Atc: "http://www.whocc.no/atc";
+    readonly AtcVet: "http://www.whocc.no/atcvet";
+}>;
+/** Authorization/content scopes; several scopes may share one Coding.system. */
+export declare const ClinicalTerminologySourceScopes: Readonly<{
+    readonly Loinc: "LNC";
+    readonly SnomedGps: "SNOMED_GPS";
+    readonly SnomedIps: "SNOMED_IPS";
+    readonly SnomedCt: "SNOMED_CT";
+    readonly SnomedVeterinary: "SNOMEDCT_VET";
+    readonly Icd10: "ICD10";
+    readonly Atc: "ATC";
+    readonly AtcVet: "ATCVET";
+}>;
+export type ClinicalTerminologySourceScope = typeof ClinicalTerminologySourceScopes[keyof typeof ClinicalTerminologySourceScopes];
+/** Product-neutral terminology candidate returned to SOS, Vet or UHC channels. */
+export type ClinicalTerminologyCandidate = Readonly<{
+    /** Governed source-scope identifier returned by the deployment capability. */
+    source: string;
+    system: string;
+    code: string;
+    display: string;
+    text?: string;
+    language?: string;
+    terminologyVersion?: string;
+}>;
+/** Preserves canonical English display separately from an asserted local label. */
+export declare function buildClinicalTerminologyCandidate(input: ClinicalTerminologyCandidate): ClinicalTerminologyCandidate;
+/** Deterministic cross-sector fixtures for isolated terminology and channel tests. */
+export declare const CLINICAL_TERMINOLOGY_TEST_DATA: Readonly<{
+    readonly localApiKey: "local-playwright-umls-key";
+    readonly bodyTemperature: Readonly<{
+        source: "LNC";
+        system: "http://loinc.org";
+        code: "8310-5";
+        display: "Body temperature:Temp:Pt:^Patient:Qn";
+    }>;
+    readonly otitisExternaSpanish: Readonly<{
+        scope: "SNOMED_CT";
+        umlsSource: "SCTSPA";
+        system: "http://snomed.info/sct";
+        code: "3135009";
+        display: "otitis externa";
+    }>;
+    readonly canineRabiesVaccine: Readonly<{
+        scope: "ATCVET";
+        system: "http://www.whocc.no/atcvet";
+        code: "QI07AA02";
+        text: "virus de la rabia";
+        display: "rabies virus";
+        ncbiTaxonomyId: "9615";
+    }>;
+    readonly humanInactivatedInfluenzaVaccine: Readonly<{
+        scope: "ATC";
+        system: "http://www.whocc.no/atc";
+        code: "J07BB02";
+        text: "vacuna contra la gripe inactivada de virus fraccionados o antígeno de superficie";
+        display: "influenza, inactivated, split virus or surface antigen";
+        ncbiTaxonomyId: "9606";
+    }>;
+    readonly rabiesDisease: Readonly<{
+        scope: "SNOMED_GPS";
+        umlsSource: "SNOMEDCT_US";
+        system: "http://snomed.info/sct";
+        code: "14168008";
+        display: "Rabies";
+    }>;
+}>;

package/dist/clinical-terminology.js

@@ -0,0 +1,77 @@
+/** Canonical code-system URIs shared by human and animal clinical channels. */
+export const ClinicalTerminologySystems = Object.freeze({
+    Loinc: 'http://loinc.org',
+    SnomedCt: 'http://snomed.info/sct',
+    Icd10: 'http://hl7.org/fhir/sid/icd-10',
+    Atc: 'http://www.whocc.no/atc',
+    AtcVet: 'http://www.whocc.no/atcvet',
+});
+/** Authorization/content scopes; several scopes may share one Coding.system. */
+export const ClinicalTerminologySourceScopes = Object.freeze({
+    Loinc: 'LNC',
+    SnomedGps: 'SNOMED_GPS',
+    SnomedIps: 'SNOMED_IPS',
+    SnomedCt: 'SNOMED_CT',
+    SnomedVeterinary: 'SNOMEDCT_VET',
+    Icd10: 'ICD10',
+    Atc: 'ATC',
+    AtcVet: 'ATCVET',
+});
+/** Preserves canonical English display separately from an asserted local label. */
+export function buildClinicalTerminologyCandidate(input) {
+    const required = (value, error) => {
+        const normalized = value.trim();
+        if (!normalized)
+            throw new TypeError(error);
+        return normalized;
+    };
+    return Object.freeze({
+        source: input.source,
+        system: required(input.system, 'clinical_terminology_system_required'),
+        code: required(input.code, 'clinical_terminology_code_required'),
+        display: required(input.display, 'clinical_terminology_display_required'),
+        ...(input.text?.trim() ? { text: input.text.trim() } : {}),
+        ...(input.language?.trim() ? { language: input.language.trim() } : {}),
+        ...(input.terminologyVersion?.trim() ? { terminologyVersion: input.terminologyVersion.trim() } : {}),
+    });
+}
+/** Deterministic cross-sector fixtures for isolated terminology and channel tests. */
+export const CLINICAL_TERMINOLOGY_TEST_DATA = Object.freeze({
+    localApiKey: 'local-playwright-umls-key',
+    bodyTemperature: Object.freeze({
+        source: ClinicalTerminologySourceScopes.Loinc,
+        system: ClinicalTerminologySystems.Loinc,
+        code: '8310-5',
+        display: 'Body temperature:Temp:Pt:^Patient:Qn',
+    }),
+    otitisExternaSpanish: Object.freeze({
+        scope: ClinicalTerminologySourceScopes.SnomedCt,
+        umlsSource: 'SCTSPA',
+        system: ClinicalTerminologySystems.SnomedCt,
+        code: '3135009',
+        display: 'otitis externa',
+    }),
+    canineRabiesVaccine: Object.freeze({
+        scope: ClinicalTerminologySourceScopes.AtcVet,
+        system: ClinicalTerminologySystems.AtcVet,
+        code: 'QI07AA02',
+        text: 'virus de la rabia',
+        display: 'rabies virus',
+        ncbiTaxonomyId: '9615',
+    }),
+    humanInactivatedInfluenzaVaccine: Object.freeze({
+        scope: ClinicalTerminologySourceScopes.Atc,
+        system: ClinicalTerminologySystems.Atc,
+        code: 'J07BB02',
+        text: 'vacuna contra la gripe inactivada de virus fraccionados o antígeno de superficie',
+        display: 'influenza, inactivated, split virus or surface antigen',
+        ncbiTaxonomyId: '9606',
+    }),
+    rabiesDisease: Object.freeze({
+        scope: ClinicalTerminologySourceScopes.SnomedGps,
+        umlsSource: 'SNOMEDCT_US',
+        system: ClinicalTerminologySystems.SnomedCt,
+        code: '14168008',
+        display: 'Rabies',
+    }),
+});

package/dist/constants/clinical-statuses.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Canonical shared FHIR R4 status vocabularies for IPS-facing clinical
+ * resource families.
+ *
+ * Use these constants in docs, examples, fixtures, and tests instead of
+ * retyping raw clinical literals when a shared catalog already exists.
+ *
+ * When a needed status is missing, add it here first following the canonical
+ * FHIR/HL7 code value for that resource family.
+ */
+/** Canonical `AllergyIntolerance.clinicalStatus` codes. */
+export declare const AllergyIntoleranceClinicalStatuses: Readonly<{
+    readonly Active: "active";
+    readonly Inactive: "inactive";
+    readonly Resolved: "resolved";
+}>;
+export type AllergyIntoleranceClinicalStatus = typeof AllergyIntoleranceClinicalStatuses[keyof typeof AllergyIntoleranceClinicalStatuses];
+/** Canonical `AllergyIntolerance.verificationStatus` codes. */
+export declare const AllergyIntoleranceVerificationStatuses: Readonly<{
+    readonly Unconfirmed: "unconfirmed";
+    readonly Confirmed: "confirmed";
+    readonly Refuted: "refuted";
+    readonly EnteredInError: "entered-in-error";
+}>;
+export type AllergyIntoleranceVerificationStatus = typeof AllergyIntoleranceVerificationStatuses[keyof typeof AllergyIntoleranceVerificationStatuses];
+/** Canonical `Condition.clinicalStatus` codes. */
+export declare const ConditionClinicalStatuses: Readonly<{
+    readonly Active: "active";
+    readonly Recurrence: "recurrence";
+    readonly Relapse: "relapse";
+    readonly Inactive: "inactive";
+    readonly Remission: "remission";
+    readonly Resolved: "resolved";
+}>;
+export type ConditionClinicalStatus = typeof ConditionClinicalStatuses[keyof typeof ConditionClinicalStatuses];
+/** Canonical `Condition.verificationStatus` codes. */
+export declare const ConditionVerificationStatuses: Readonly<{
+    readonly Unconfirmed: "unconfirmed";
+    readonly Provisional: "provisional";
+    readonly Differential: "differential";
+    readonly Confirmed: "confirmed";
+    readonly Refuted: "refuted";
+    readonly EnteredInError: "entered-in-error";
+}>;
+export type ConditionVerificationStatus = typeof ConditionVerificationStatuses[keyof typeof ConditionVerificationStatuses];
+/** Canonical `MedicationStatement.status` codes. */
+export declare const MedicationStatementStatuses: Readonly<{
+    readonly Active: "active";
+    readonly Completed: "completed";
+    readonly EnteredInError: "entered-in-error";
+    readonly Intended: "intended";
+    readonly Stopped: "stopped";
+    readonly OnHold: "on-hold";
+    readonly Unknown: "unknown";
+    readonly NotTaken: "not-taken";
+}>;
+export type MedicationStatementStatus = typeof MedicationStatementStatuses[keyof typeof MedicationStatementStatuses];
+/** Canonical `Immunization.status` codes. */
+export declare const ImmunizationStatuses: Readonly<{
+    readonly Completed: "completed";
+    readonly EnteredInError: "entered-in-error";
+    readonly NotDone: "not-done";
+}>;
+export type ImmunizationStatus = typeof ImmunizationStatuses[keyof typeof ImmunizationStatuses];
+/** Canonical `Procedure.status` codes. */
+export declare const ProcedureStatuses: Readonly<{
+    readonly Preparation: "preparation";
+    readonly InProgress: "in-progress";
+    readonly NotDone: "not-done";
+    readonly OnHold: "on-hold";
+    readonly Stopped: "stopped";
+    readonly Completed: "completed";
+    readonly EnteredInError: "entered-in-error";
+    readonly Unknown: "unknown";
+}>;
+export type ProcedureStatus = typeof ProcedureStatuses[keyof typeof ProcedureStatuses];
+/** Canonical `DiagnosticReport.status` codes. */
+export declare const DiagnosticReportStatuses: Readonly<{
+    readonly Registered: "registered";
+    readonly Partial: "partial";
+    readonly Preliminary: "preliminary";
+    readonly Final: "final";
+    readonly Amended: "amended";
+    readonly Corrected: "corrected";
+    readonly Appended: "appended";
+    readonly Cancelled: "cancelled";
+    readonly EnteredInError: "entered-in-error";
+    readonly Unknown: "unknown";
+}>;
+export type DiagnosticReportStatus = typeof DiagnosticReportStatuses[keyof typeof DiagnosticReportStatuses];
+/** Canonical `Observation.status` codes. */
+export declare const ObservationStatuses: Readonly<{
+    readonly Registered: "registered";
+    readonly Preliminary: "preliminary";
+    readonly Final: "final";
+    readonly Amended: "amended";
+    readonly Corrected: "corrected";
+    readonly Cancelled: "cancelled";
+    readonly EnteredInError: "entered-in-error";
+    readonly Unknown: "unknown";
+}>;
+export type ObservationStatus = typeof ObservationStatuses[keyof typeof ObservationStatuses];

package/dist/constants/clinical-statuses.js

@@ -0,0 +1,93 @@
+/**
+ * Canonical shared FHIR R4 status vocabularies for IPS-facing clinical
+ * resource families.
+ *
+ * Use these constants in docs, examples, fixtures, and tests instead of
+ * retyping raw clinical literals when a shared catalog already exists.
+ *
+ * When a needed status is missing, add it here first following the canonical
+ * FHIR/HL7 code value for that resource family.
+ */
+/** Canonical `AllergyIntolerance.clinicalStatus` codes. */
+export const AllergyIntoleranceClinicalStatuses = Object.freeze({
+    Active: 'active',
+    Inactive: 'inactive',
+    Resolved: 'resolved',
+});
+/** Canonical `AllergyIntolerance.verificationStatus` codes. */
+export const AllergyIntoleranceVerificationStatuses = Object.freeze({
+    Unconfirmed: 'unconfirmed',
+    Confirmed: 'confirmed',
+    Refuted: 'refuted',
+    EnteredInError: 'entered-in-error',
+});
+/** Canonical `Condition.clinicalStatus` codes. */
+export const ConditionClinicalStatuses = Object.freeze({
+    Active: 'active',
+    Recurrence: 'recurrence',
+    Relapse: 'relapse',
+    Inactive: 'inactive',
+    Remission: 'remission',
+    Resolved: 'resolved',
+});
+/** Canonical `Condition.verificationStatus` codes. */
+export const ConditionVerificationStatuses = Object.freeze({
+    Unconfirmed: 'unconfirmed',
+    Provisional: 'provisional',
+    Differential: 'differential',
+    Confirmed: 'confirmed',
+    Refuted: 'refuted',
+    EnteredInError: 'entered-in-error',
+});
+/** Canonical `MedicationStatement.status` codes. */
+export const MedicationStatementStatuses = Object.freeze({
+    Active: 'active',
+    Completed: 'completed',
+    EnteredInError: 'entered-in-error',
+    Intended: 'intended',
+    Stopped: 'stopped',
+    OnHold: 'on-hold',
+    Unknown: 'unknown',
+    NotTaken: 'not-taken',
+});
+/** Canonical `Immunization.status` codes. */
+export const ImmunizationStatuses = Object.freeze({
+    Completed: 'completed',
+    EnteredInError: 'entered-in-error',
+    NotDone: 'not-done',
+});
+/** Canonical `Procedure.status` codes. */
+export const ProcedureStatuses = Object.freeze({
+    Preparation: 'preparation',
+    InProgress: 'in-progress',
+    NotDone: 'not-done',
+    OnHold: 'on-hold',
+    Stopped: 'stopped',
+    Completed: 'completed',
+    EnteredInError: 'entered-in-error',
+    Unknown: 'unknown',
+});
+/** Canonical `DiagnosticReport.status` codes. */
+export const DiagnosticReportStatuses = Object.freeze({
+    Registered: 'registered',
+    Partial: 'partial',
+    Preliminary: 'preliminary',
+    Final: 'final',
+    Amended: 'amended',
+    Corrected: 'corrected',
+    Appended: 'appended',
+    Cancelled: 'cancelled',
+    EnteredInError: 'entered-in-error',
+    Unknown: 'unknown',
+});
+/** Canonical `Observation.status` codes. */
+export const ObservationStatuses = Object.freeze({
+    Registered: 'registered',
+    Preliminary: 'preliminary',
+    Final: 'final',
+    Amended: 'amended',
+    Corrected: 'corrected',
+    Cancelled: 'cancelled',
+    EnteredInError: 'entered-in-error',
+    Unknown: 'unknown',
+});

package/dist/constants/fhir-code-systems.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Canonical FHIR/HL7 code system URLs shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline system strings when building
+ * FHIR codings, filters, or test fixtures.
+ */
+export declare const FhirCodeSystems: Readonly<{
+    readonly Loinc: "http://loinc.org";
+    readonly SnomedCt: "http://snomed.info/sct";
+    readonly Ucum: "http://unitsofmeasure.org";
+    readonly CommunicationCategory: "http://terminology.hl7.org/CodeSystem/communication-category";
+    readonly ActReason: "http://terminology.hl7.org/CodeSystem/v3-ActReason";
+    readonly ObservationCategory: "http://terminology.hl7.org/CodeSystem/observation-category";
+    readonly EventTiming: "http://hl7.org/fhir/event-timing";
+}>;

package/dist/constants/fhir-code-systems.js

@@ -0,0 +1,15 @@
+/**
+ * Canonical FHIR/HL7 code system URLs shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline system strings when building
+ * FHIR codings, filters, or test fixtures.
+ */
+export const FhirCodeSystems = Object.freeze({
+    Loinc: 'http://loinc.org',
+    SnomedCt: 'http://snomed.info/sct',
+    Ucum: 'http://unitsofmeasure.org',
+    CommunicationCategory: 'http://terminology.hl7.org/CodeSystem/communication-category',
+    ActReason: 'http://terminology.hl7.org/CodeSystem/v3-ActReason',
+    ObservationCategory: 'http://terminology.hl7.org/CodeSystem/observation-category',
+    EventTiming: 'http://hl7.org/fhir/event-timing',
+});