fhir-data-utils-ts 0.6.12 → 0.6.16

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## Unreleased
 
+## 0.6.16 - 2026-10-07
+
+- Export the required FHIR R4 code bindings used by reusable IPS authoring
+  forms, keyed by their exact flat claim. The canonical code is stable while
+  English and Spanish presentation labels follow the user's locale. Fields
+  with extensible or example bindings remain terminology searches instead of
+  being incorrectly constrained to a closed dropdown.
+
+## 0.6.14 - 2026-10-06
+
+- Own the product-neutral HL7 v2-0203 person and healthcare identifier-type
+  catalog used by FHIR adapters, including national, passport, driving licence,
+  health, insurance-member/subscriber, donor and patient identifiers. Contact
+  points and veterinary evidence remain in their respective standards.
+
+- Add a reusable, data-only `CommunicationRequest` form schema backed by
+  canonical flat claims, including exact Patient, RelatedPerson or Group
+  recipients, information providers, Encounter context and referenced or
+  attached payloads. Projection adapters are deliberately limited to the
+  published FHIR R4 and R5 specifications; no R6 API is exposed.
+
 - Canonicalize native FHIR relative subject references at the shared clinical
   editor boundary before claims-first operations, while preserving governed
   URN and `did:web` identifiers unchanged.

package/README.md

@@ -216,6 +216,20 @@ CommunicationRequest against a frozen Group snapshot. See
 [the contract guide](docs/CARE_EMERGENCY_ALERT_CONTRACTS.md). Product policy,
 access, encryption and delivery do not belong in these builders.
 
+## Communication request authoring
+
+`FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA` and its typed adapters are exported
+from `fhir-data-utils-ts/data`. They let Personal and Professional portals use
+the same fields while keeping UI labels, widgets and authorization outside this
+package. Recipients remain exact FHIR references, so a request can target the
+patient and only the authorized `RelatedPerson` records selected for that
+message. `requester` records who prepared the request and
+`informationProviders` records the professionals expected to supply or review
+its content; neither field grants permission by itself.
+
+The package exposes separate `CommunicationRequest` projections for published
+FHIR R4 and FHIR R5. It intentionally exposes no R6 or combined R5/R6 adapter.
+
 ## Clinical documents and Encounter journeys
 
 A FHIR document always starts with `Composition`; `Encounter` is its optional

package/dist/claims/communication-request-claims.d.ts

@@ -3,19 +3,31 @@ import type { ClaimSpec } from './claim-types.js';
 export declare const CommunicationRequestClaim: Readonly<{
     readonly Identifier: "CommunicationRequest.identifier";
     readonly BasedOn: "CommunicationRequest.based-on";
+    readonly Replaces: "CommunicationRequest.replaces";
+    readonly GroupIdentifier: "CommunicationRequest.group-identifier";
     readonly Status: "CommunicationRequest.status";
+    readonly StatusReason: "CommunicationRequest.status-reason";
+    readonly Intent: "CommunicationRequest.intent";
     readonly Priority: "CommunicationRequest.priority";
     readonly Category: "CommunicationRequest.category";
+    readonly DoNotPerform: "CommunicationRequest.do-not-perform";
+    readonly Medium: "CommunicationRequest.medium";
     readonly Subject: "CommunicationRequest.subject";
     readonly About: "CommunicationRequest.about";
     readonly Encounter: "CommunicationRequest.encounter";
     readonly Requester: "CommunicationRequest.requester";
     readonly Recipient: "CommunicationRequest.recipient";
+    readonly InformationProvider: "CommunicationRequest.information-provider";
     readonly AuthoredOn: "CommunicationRequest.authored-on";
     readonly Occurrence: "CommunicationRequest.occurrence";
     readonly ReasonCode: "CommunicationRequest.reason-code";
     readonly ReasonReference: "CommunicationRequest.reason-reference";
     readonly PayloadContent: "CommunicationRequest.payload-content";
+    readonly PayloadReference: "CommunicationRequest.payload-reference";
+    readonly PayloadAttachmentContentType: "CommunicationRequest.payload-attachment-content-type";
+    readonly PayloadAttachmentData: "CommunicationRequest.payload-attachment-data";
+    readonly PayloadAttachmentTitle: "CommunicationRequest.payload-attachment-title";
+    readonly Note: "CommunicationRequest.note";
 }>;
 export type CommunicationRequestClaimKey = typeof CommunicationRequestClaim[keyof typeof CommunicationRequestClaim];
 export declare const CommunicationRequestClaimSpecs: readonly ClaimSpec[];

package/dist/claims/communication-request-claims.js

@@ -2,26 +2,58 @@
 export const CommunicationRequestClaim = Object.freeze({
     Identifier: 'CommunicationRequest.identifier',
     BasedOn: 'CommunicationRequest.based-on',
+    Replaces: 'CommunicationRequest.replaces',
+    GroupIdentifier: 'CommunicationRequest.group-identifier',
     Status: 'CommunicationRequest.status',
+    StatusReason: 'CommunicationRequest.status-reason',
+    Intent: 'CommunicationRequest.intent',
     Priority: 'CommunicationRequest.priority',
     Category: 'CommunicationRequest.category',
+    DoNotPerform: 'CommunicationRequest.do-not-perform',
+    Medium: 'CommunicationRequest.medium',
     Subject: 'CommunicationRequest.subject',
     About: 'CommunicationRequest.about',
     Encounter: 'CommunicationRequest.encounter',
     Requester: 'CommunicationRequest.requester',
     Recipient: 'CommunicationRequest.recipient',
+    InformationProvider: 'CommunicationRequest.information-provider',
     AuthoredOn: 'CommunicationRequest.authored-on',
     Occurrence: 'CommunicationRequest.occurrence',
     ReasonCode: 'CommunicationRequest.reason-code',
     ReasonReference: 'CommunicationRequest.reason-reference',
     PayloadContent: 'CommunicationRequest.payload-content',
+    PayloadReference: 'CommunicationRequest.payload-reference',
+    PayloadAttachmentContentType: 'CommunicationRequest.payload-attachment-content-type',
+    PayloadAttachmentData: 'CommunicationRequest.payload-attachment-data',
+    PayloadAttachmentTitle: 'CommunicationRequest.payload-attachment-title',
+    Note: 'CommunicationRequest.note',
 });
 export const CommunicationRequestClaimSpecs = Object.freeze([
     { key: CommunicationRequestClaim.Identifier, meaning: 'Business identifier.', example: 'urn:uuid:campaign-1' },
+    { key: CommunicationRequestClaim.BasedOn, meaning: 'Requests fulfilled in whole or in part.', example: 'ServiceRequest/request-1' },
+    { key: CommunicationRequestClaim.Replaces, meaning: 'Earlier requests superseded by this request.', example: 'CommunicationRequest/request-0' },
+    { key: CommunicationRequestClaim.GroupIdentifier, meaning: 'Shared identifier for one request group.', example: 'urn:uuid:request-group-1' },
     { key: CommunicationRequestClaim.Status, meaning: 'Request lifecycle status.', example: 'active' },
+    { key: CommunicationRequestClaim.StatusReason, meaning: 'Coded explanation for the lifecycle status.', example: 'http://terminology.hl7.org/CodeSystem/request-status-reason|paused' },
+    { key: CommunicationRequestClaim.Intent, meaning: 'Published R5 request intent.', example: 'proposal' },
     { key: CommunicationRequestClaim.Priority, meaning: 'Delivery priority.', example: 'routine' },
     { key: CommunicationRequestClaim.Category, meaning: 'Communication category token.', example: 'http://terminology.hl7.org/CodeSystem/communication-category|notification' },
+    { key: CommunicationRequestClaim.DoNotPerform, meaning: 'Whether the requested communication must not occur.', example: 'false' },
+    { key: CommunicationRequestClaim.Medium, meaning: 'Requested communication medium token.', example: 'http://terminology.hl7.org/CodeSystem/v3-ParticipationMode|WRITTEN' },
     { key: CommunicationRequestClaim.Subject, meaning: 'Subject or evaluated Group reference.', example: 'Group/snapshot-1' },
+    { key: CommunicationRequestClaim.About, meaning: 'Resources that the communication request concerns.', example: 'DiagnosticReport/report-1' },
+    { key: CommunicationRequestClaim.Encounter, meaning: 'Encounter context for the request.', example: 'Encounter/emergency-1' },
     { key: CommunicationRequestClaim.Requester, meaning: 'Requesting organization or service.', example: 'Organization/blood-bank-1' },
+    { key: CommunicationRequestClaim.Recipient, meaning: 'Exact intended recipient references.', example: 'Patient/patient-1,RelatedPerson/family-1' },
+    { key: CommunicationRequestClaim.InformationProvider, meaning: 'Actors expected to provide or review message information.', example: 'PractitionerRole/doctor-1' },
     { key: CommunicationRequestClaim.AuthoredOn, meaning: 'Request authoring time.', example: '2026-09-26T11:00:00Z' },
+    { key: CommunicationRequestClaim.Occurrence, meaning: 'Requested delivery time.', example: '2026-09-26T11:30:00Z' },
+    { key: CommunicationRequestClaim.ReasonCode, meaning: 'Coded reasons for the request.', example: 'http://snomed.info/sct|246205007' },
+    { key: CommunicationRequestClaim.ReasonReference, meaning: 'Resource references supporting the request reason.', example: 'Condition/condition-1' },
+    { key: CommunicationRequestClaim.PayloadContent, meaning: 'R4 string payload compatibility value.', example: 'Family update ready for review.' },
+    { key: CommunicationRequestClaim.PayloadReference, meaning: 'Referenced message content.', example: 'DocumentReference/update-1' },
+    { key: CommunicationRequestClaim.PayloadAttachmentContentType, meaning: 'Attachment media type.', example: 'application/pdf' },
+    { key: CommunicationRequestClaim.PayloadAttachmentData, meaning: 'Base64-encoded attachment data.', example: 'JVBERi0xLjQ=' },
+    { key: CommunicationRequestClaim.PayloadAttachmentTitle, meaning: 'Human-readable attachment title.', example: 'Clinical update' },
+    { key: CommunicationRequestClaim.Note, meaning: 'Request note.', example: 'Call before sending.' },
 ]);

package/dist/clinical-artifact-coded-options.d.ts

@@ -0,0 +1,26 @@
+export type FhirClinicalCodedOption = Readonly<{
+    code: string;
+    labels: Readonly<{
+        en: string;
+        es: string;
+    }>;
+}>;
+export type FhirClinicalCodedOptionSet = Readonly<{
+    fhirVersion: 'R4';
+    binding: 'required';
+    system: string;
+    options: readonly FhirClinicalCodedOption[];
+}>;
+/**
+ * Required FHIR R4 code bindings used by the reusable IPS artifact editor.
+ *
+ * Extensible and example bindings deliberately stay out of this catalog: they
+ * require terminology search or free entry and must not be rendered as closed
+ * dropdowns.
+ */
+export declare const FHIR_IPS_CLINICAL_CODED_OPTION_SETS: Readonly<Record<string, FhirClinicalCodedOptionSet>>;
+/** Returns localized labels while preserving the exact canonical code value. */
+export declare function clinicalArtifactCodedOptionsForClaim(claim: string, locale: string): readonly Readonly<{
+    code: string;
+    label: string;
+}>[];

package/dist/clinical-artifact-coded-options.js

@@ -0,0 +1,38 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+import { AllergyIntoleranceClaim } from './claims/allergy-intolerance-claims.js';
+import { ConditionClaim } from './claims/condition-claims.js';
+import { ImmunizationClaim } from './claims/immunization-claims.js';
+import { MedicationStatementClaim } from './claims/medication-statement-claims.js';
+import { ProcedureClaim } from './claims/procedure-claims.js';
+import { ObservationClaim } from './observation-claims.js';
+const option = (code, en, es) => Object.freeze({ code, labels: Object.freeze({ en, es }) });
+const requiredSet = (system, options) => Object.freeze({ fhirVersion: 'R4', binding: 'required', system, options: Object.freeze(options) });
+const enteredInError = option('entered-in-error', 'Entered in error', 'Introducido por error');
+const unknown = option('unknown', 'Unknown', 'Desconocido');
+/**
+ * Required FHIR R4 code bindings used by the reusable IPS artifact editor.
+ *
+ * Extensible and example bindings deliberately stay out of this catalog: they
+ * require terminology search or free entry and must not be rendered as closed
+ * dropdowns.
+ */
+export const FHIR_IPS_CLINICAL_CODED_OPTION_SETS = Object.freeze({
+    [AllergyIntoleranceClaim.ClinicalStatus]: requiredSet('http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical', [option('active', 'Active', 'Activo'), option('inactive', 'Inactive', 'Inactivo'), option('resolved', 'Resolved', 'Resuelto')]),
+    [AllergyIntoleranceClaim.VerificationStatus]: requiredSet('http://terminology.hl7.org/CodeSystem/allergyintolerance-verification', [option('unconfirmed', 'Unconfirmed', 'No confirmado'), option('confirmed', 'Confirmed', 'Confirmado'), option('refuted', 'Refuted', 'Refutado'), enteredInError]),
+    [AllergyIntoleranceClaim.Category]: requiredSet('http://hl7.org/fhir/allergy-intolerance-category', [option('food', 'Food', 'Alimento'), option('medication', 'Medication', 'Medicamento'), option('environment', 'Environment', 'Entorno'), option('biologic', 'Biologic', 'Biológico')]),
+    [AllergyIntoleranceClaim.Criticality]: requiredSet('http://hl7.org/fhir/allergy-intolerance-criticality', [option('low', 'Low risk', 'Riesgo bajo'), option('high', 'High risk', 'Riesgo alto'), option('unable-to-assess', 'Unable to assess', 'No se puede evaluar')]),
+    [MedicationStatementClaim.Status]: requiredSet('http://hl7.org/fhir/CodeSystem/medication-statement-status', [option('active', 'Active', 'Activo'), option('completed', 'Completed', 'Completado'), enteredInError, option('intended', 'Intended', 'Previsto'), option('stopped', 'Stopped', 'Interrumpido'), option('on-hold', 'On hold', 'En espera'), unknown, option('not-taken', 'Not taken', 'No tomado')]),
+    [ImmunizationClaim.Status]: requiredSet('http://hl7.org/fhir/event-status', [option('completed', 'Completed', 'Completado'), enteredInError, option('not-done', 'Not done', 'No realizado')]),
+    [ConditionClaim.ClinicalStatus]: requiredSet('http://terminology.hl7.org/CodeSystem/condition-clinical', [option('active', 'Active', 'Activo'), option('recurrence', 'Recurrence', 'Recurrencia'), option('relapse', 'Relapse', 'Recaída'), option('inactive', 'Inactive', 'Inactivo'), option('remission', 'Remission', 'Remisión'), option('resolved', 'Resolved', 'Resuelto')]),
+    [ConditionClaim.VerificationStatus]: requiredSet('http://terminology.hl7.org/CodeSystem/condition-ver-status', [option('unconfirmed', 'Unconfirmed', 'No confirmado'), option('provisional', 'Provisional', 'Provisional'), option('differential', 'Differential', 'Diferencial'), option('confirmed', 'Confirmed', 'Confirmado'), option('refuted', 'Refuted', 'Refutado'), enteredInError]),
+    [ProcedureClaim.Status]: requiredSet('http://hl7.org/fhir/event-status', [option('preparation', 'Preparation', 'Preparación'), option('in-progress', 'In progress', 'En curso'), option('not-done', 'Not done', 'No realizado'), option('on-hold', 'On hold', 'En espera'), option('stopped', 'Stopped', 'Detenido'), option('completed', 'Completed', 'Completado'), enteredInError, unknown]),
+    [ObservationClaim.Status]: requiredSet('http://hl7.org/fhir/observation-status', [option('registered', 'Registered', 'Registrado'), option('preliminary', 'Preliminary', 'Preliminar'), option('final', 'Final', 'Final'), option('amended', 'Amended', 'Modificado'), option('corrected', 'Corrected', 'Corregido'), option('cancelled', 'Cancelled', 'Cancelado'), enteredInError, unknown]),
+});
+/** Returns localized labels while preserving the exact canonical code value. */
+export function clinicalArtifactCodedOptionsForClaim(claim, locale) {
+    const set = FHIR_IPS_CLINICAL_CODED_OPTION_SETS[claim];
+    if (!set)
+        return Object.freeze([]);
+    const language = locale.trim().toLowerCase().split('-')[0] === 'es' ? 'es' : 'en';
+    return Object.freeze(set.options.map(entry => Object.freeze({ code: entry.code, label: entry.labels[language] })));
+}

package/dist/converters/convert-communication-request.d.ts

@@ -3,3 +3,7 @@ import type { FhirResource, FlatClaims } from './convert-shared.js';
 export declare function communicationRequestFlatToFhirR4(claims: FlatClaims): FhirResource;
 /** Reads a FHIR R4 CommunicationRequest into canonical flat claims. */
 export declare function communicationRequestFhirR4ToFlat(resource: FhirResource): FlatClaims;
+/** Projects canonical claims to the published FHIR R5 shape. */
+export declare function communicationRequestFlatToFhirR5(claims: FlatClaims): FhirResource;
+/** Reads a published FHIR R5 CommunicationRequest into canonical flat claims. */
+export declare function communicationRequestFhirR5ToFlat(resource: FhirResource): FlatClaims;

package/dist/converters/convert-communication-request.js

@@ -4,37 +4,174 @@ import { codingFromValue, codingListFromCsv, codingListToCsv, codingToValue, ref
 export function communicationRequestFlatToFhirR4(claims) {
     return {
         resourceType: 'CommunicationRequest', identifier: claims[CommunicationRequestClaim.Identifier] ? [{ value: claims[CommunicationRequestClaim.Identifier] }] : undefined,
-        basedOn: referenceCsv(claims[CommunicationRequestClaim.BasedOn]), status: claims[CommunicationRequestClaim.Status], priority: claims[CommunicationRequestClaim.Priority],
+        basedOn: referenceCsv(claims[CommunicationRequestClaim.BasedOn]),
+        replaces: referenceCsv(claims[CommunicationRequestClaim.Replaces]),
+        groupIdentifier: claims[CommunicationRequestClaim.GroupIdentifier] ? { value: claims[CommunicationRequestClaim.GroupIdentifier] } : undefined,
+        status: claims[CommunicationRequestClaim.Status],
+        statusReason: codeableConcept(claims[CommunicationRequestClaim.StatusReason]),
+        priority: claims[CommunicationRequestClaim.Priority],
         category: claims[CommunicationRequestClaim.Category] ? [{ coding: codingFromValue(claims[CommunicationRequestClaim.Category]) }] : undefined,
+        doNotPerform: optionalBoolean(claims[CommunicationRequestClaim.DoNotPerform]),
+        medium: claims[CommunicationRequestClaim.Medium] ? [{ coding: codingFromValue(claims[CommunicationRequestClaim.Medium]) }] : undefined,
         subject: claims[CommunicationRequestClaim.Subject] ? { reference: claims[CommunicationRequestClaim.Subject] } : undefined,
         about: referenceCsv(claims[CommunicationRequestClaim.About]), encounter: claims[CommunicationRequestClaim.Encounter] ? { reference: claims[CommunicationRequestClaim.Encounter] } : undefined,
         requester: claims[CommunicationRequestClaim.Requester] ? { reference: claims[CommunicationRequestClaim.Requester] } : undefined,
+        sender: firstReference(claims[CommunicationRequestClaim.InformationProvider]),
         recipient: referenceCsv(claims[CommunicationRequestClaim.Recipient]), authoredOn: claims[CommunicationRequestClaim.AuthoredOn],
         occurrenceDateTime: claims[CommunicationRequestClaim.Occurrence],
         reasonCode: claims[CommunicationRequestClaim.ReasonCode] ? [{ coding: codingListFromCsv(claims[CommunicationRequestClaim.ReasonCode]) }] : undefined,
         reasonReference: referenceCsv(claims[CommunicationRequestClaim.ReasonReference]),
-        payload: claims[CommunicationRequestClaim.PayloadContent] ? [{ contentString: claims[CommunicationRequestClaim.PayloadContent] }] : undefined,
+        payload: payloadR4(claims),
+        note: annotation(claims[CommunicationRequestClaim.Note]),
     };
 }
 /** Reads a FHIR R4 CommunicationRequest into canonical flat claims. */
 export function communicationRequestFhirR4ToFlat(resource) {
-    return {
+    return compact({
         [CommunicationRequestClaim.Identifier]: resource.identifier?.[0]?.value,
         [CommunicationRequestClaim.BasedOn]: referenceListToCsv(resource.basedOn),
-        [CommunicationRequestClaim.Status]: resource.status, [CommunicationRequestClaim.Priority]: resource.priority,
+        [CommunicationRequestClaim.Replaces]: referenceListToCsv(resource.replaces),
+        [CommunicationRequestClaim.GroupIdentifier]: resource.groupIdentifier?.value,
+        [CommunicationRequestClaim.Status]: resource.status,
+        [CommunicationRequestClaim.StatusReason]: codeableConceptToValue(resource.statusReason),
+        [CommunicationRequestClaim.Priority]: resource.priority,
         [CommunicationRequestClaim.Category]: codingToValue(resource.category?.[0]?.coding?.[0]),
+        [CommunicationRequestClaim.DoNotPerform]: typeof resource.doNotPerform === 'boolean' ? String(resource.doNotPerform) : undefined,
+        [CommunicationRequestClaim.Medium]: codingToValue(resource.medium?.[0]?.coding?.[0]),
         [CommunicationRequestClaim.Subject]: referenceToValue(resource.subject),
         [CommunicationRequestClaim.About]: referenceListToCsv(resource.about),
         [CommunicationRequestClaim.Encounter]: referenceToValue(resource.encounter),
         [CommunicationRequestClaim.Requester]: referenceToValue(resource.requester),
+        [CommunicationRequestClaim.InformationProvider]: referenceToValue(resource.sender),
         [CommunicationRequestClaim.Recipient]: referenceListToCsv(resource.recipient),
         [CommunicationRequestClaim.AuthoredOn]: resource.authoredOn, [CommunicationRequestClaim.Occurrence]: resource.occurrenceDateTime,
         [CommunicationRequestClaim.ReasonCode]: codingListToCsv(resource.reasonCode?.flatMap(value => value.coding ?? [])),
         [CommunicationRequestClaim.ReasonReference]: referenceListToCsv(resource.reasonReference),
-        [CommunicationRequestClaim.PayloadContent]: resource.payload?.[0]?.contentString,
+        ...payloadToFlat(resource),
+        [CommunicationRequestClaim.Note]: annotationText(resource.note),
+    });
+}
+/** Projects canonical claims to the published FHIR R5 shape. */
+export function communicationRequestFlatToFhirR5(claims) {
+    return communicationRequestFlatToFhirR5Resource(claims);
+}
+/** Reads a published FHIR R5 CommunicationRequest into canonical flat claims. */
+export function communicationRequestFhirR5ToFlat(resource) {
+    return communicationRequestFhirR5ResourceToFlat(resource);
+}
+function communicationRequestFlatToFhirR5Resource(claims) {
+    const intent = claims[CommunicationRequestClaim.Intent];
+    if (!intent)
+        throw new TypeError('communication_request_intent_required');
+    return {
+        resourceType: 'CommunicationRequest',
+        identifier: claims[CommunicationRequestClaim.Identifier] ? [{ value: claims[CommunicationRequestClaim.Identifier] }] : undefined,
+        basedOn: referenceCsv(claims[CommunicationRequestClaim.BasedOn]),
+        replaces: referenceCsv(claims[CommunicationRequestClaim.Replaces]),
+        groupIdentifier: claims[CommunicationRequestClaim.GroupIdentifier] ? { value: claims[CommunicationRequestClaim.GroupIdentifier] } : undefined,
+        status: claims[CommunicationRequestClaim.Status],
+        statusReason: codeableConcept(claims[CommunicationRequestClaim.StatusReason]),
+        intent,
+        priority: claims[CommunicationRequestClaim.Priority],
+        category: claims[CommunicationRequestClaim.Category] ? [{ coding: codingFromValue(claims[CommunicationRequestClaim.Category]) }] : undefined,
+        doNotPerform: optionalBoolean(claims[CommunicationRequestClaim.DoNotPerform]),
+        medium: claims[CommunicationRequestClaim.Medium] ? [{ coding: codingFromValue(claims[CommunicationRequestClaim.Medium]) }] : undefined,
+        subject: claims[CommunicationRequestClaim.Subject] ? { reference: claims[CommunicationRequestClaim.Subject] } : undefined,
+        about: referenceCsv(claims[CommunicationRequestClaim.About]),
+        encounter: claims[CommunicationRequestClaim.Encounter] ? { reference: claims[CommunicationRequestClaim.Encounter] } : undefined,
+        requester: claims[CommunicationRequestClaim.Requester] ? { reference: claims[CommunicationRequestClaim.Requester] } : undefined,
+        recipient: referenceCsv(claims[CommunicationRequestClaim.Recipient]),
+        informationProvider: referenceCsv(claims[CommunicationRequestClaim.InformationProvider]),
+        authoredOn: claims[CommunicationRequestClaim.AuthoredOn], occurrenceDateTime: claims[CommunicationRequestClaim.Occurrence],
+        reason: reasonsR5(claims), payload: payloadR5(claims), note: annotation(claims[CommunicationRequestClaim.Note]),
     };
 }
+function communicationRequestFhirR5ResourceToFlat(resource) {
+    const reasons = resource.reason;
+    return compact({
+        [CommunicationRequestClaim.Identifier]: resource.identifier?.[0]?.value,
+        [CommunicationRequestClaim.BasedOn]: referenceListToCsv(resource.basedOn),
+        [CommunicationRequestClaim.Replaces]: referenceListToCsv(resource.replaces),
+        [CommunicationRequestClaim.GroupIdentifier]: resource.groupIdentifier?.value,
+        [CommunicationRequestClaim.Status]: resource.status,
+        [CommunicationRequestClaim.StatusReason]: codeableConceptToValue(resource.statusReason),
+        [CommunicationRequestClaim.Intent]: resource.intent,
+        [CommunicationRequestClaim.Priority]: resource.priority,
+        [CommunicationRequestClaim.Category]: codingToValue(resource.category?.[0]?.coding?.[0]),
+        [CommunicationRequestClaim.DoNotPerform]: typeof resource.doNotPerform === 'boolean' ? String(resource.doNotPerform) : undefined,
+        [CommunicationRequestClaim.Medium]: codingToValue(resource.medium?.[0]?.coding?.[0]),
+        [CommunicationRequestClaim.Subject]: referenceToValue(resource.subject),
+        [CommunicationRequestClaim.About]: referenceListToCsv(resource.about),
+        [CommunicationRequestClaim.Encounter]: referenceToValue(resource.encounter),
+        [CommunicationRequestClaim.Requester]: referenceToValue(resource.requester),
+        [CommunicationRequestClaim.Recipient]: referenceListToCsv(resource.recipient),
+        [CommunicationRequestClaim.InformationProvider]: referenceListToCsv(resource.informationProvider),
+        [CommunicationRequestClaim.AuthoredOn]: resource.authoredOn,
+        [CommunicationRequestClaim.Occurrence]: resource.occurrenceDateTime,
+        [CommunicationRequestClaim.ReasonCode]: codingListToCsv(reasons?.flatMap(value => value.concept?.coding ?? [])),
+        [CommunicationRequestClaim.ReasonReference]: reasons?.map(value => value.reference?.reference).filter((value) => Boolean(value)).join(',') || undefined,
+        ...payloadToFlat(resource), [CommunicationRequestClaim.Note]: annotationText(resource.note),
+    });
+}
 function referenceCsv(value) {
     const references = value?.split(',').map(reference => reference.trim()).filter(Boolean) ?? [];
     return references.length ? references.map(reference => ({ reference })) : undefined;
 }
+function firstReference(value) { return referenceCsv(value)?.[0]; }
+function codeableConcept(value) {
+    const coding = codingFromValue(value);
+    return coding ? { coding } : undefined;
+}
+function codeableConceptToValue(value) {
+    return codingToValue(value?.coding?.[0]);
+}
+function optionalBoolean(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'true' && value !== 'false')
+        throw new TypeError('communication_request_boolean_invalid');
+    return value === 'true';
+}
+function annotation(value) { return value ? [{ text: value }] : undefined; }
+function annotationText(value) { return value?.[0]?.text; }
+function payloadR4(claims) {
+    if (claims[CommunicationRequestClaim.PayloadReference])
+        return [{ contentReference: { reference: claims[CommunicationRequestClaim.PayloadReference] } }];
+    if (claims[CommunicationRequestClaim.PayloadAttachmentData])
+        return [{ contentAttachment: attachment(claims) }];
+    return claims[CommunicationRequestClaim.PayloadContent] ? [{ contentString: claims[CommunicationRequestClaim.PayloadContent] }] : undefined;
+}
+function payloadR5(claims) {
+    if (claims[CommunicationRequestClaim.PayloadReference])
+        return [{ contentReference: { reference: claims[CommunicationRequestClaim.PayloadReference] } }];
+    if (claims[CommunicationRequestClaim.PayloadAttachmentData])
+        return [{ contentAttachment: attachment(claims) }];
+    if (claims[CommunicationRequestClaim.PayloadContent])
+        throw new TypeError('communication_request_string_payload_not_supported_in_r5');
+    return undefined;
+}
+function attachment(claims) {
+    const contentType = claims[CommunicationRequestClaim.PayloadAttachmentContentType];
+    if (!contentType)
+        throw new TypeError('communication_request_attachment_content_type_required');
+    return { contentType, data: claims[CommunicationRequestClaim.PayloadAttachmentData], title: claims[CommunicationRequestClaim.PayloadAttachmentTitle] };
+}
+function payloadToFlat(resource) {
+    const payload = resource.payload?.[0];
+    return compact({
+        [CommunicationRequestClaim.PayloadContent]: payload?.contentString,
+        [CommunicationRequestClaim.PayloadReference]: payload?.contentReference?.reference,
+        [CommunicationRequestClaim.PayloadAttachmentContentType]: payload?.contentAttachment?.contentType,
+        [CommunicationRequestClaim.PayloadAttachmentData]: payload?.contentAttachment?.data,
+        [CommunicationRequestClaim.PayloadAttachmentTitle]: payload?.contentAttachment?.title,
+    });
+}
+function reasonsR5(claims) {
+    const result = [];
+    for (const coding of codingListFromCsv(claims[CommunicationRequestClaim.ReasonCode]) ?? [])
+        result.push({ concept: { coding: [coding] } });
+    for (const item of referenceCsv(claims[CommunicationRequestClaim.ReasonReference]) ?? [])
+        result.push({ reference: item });
+    return result.length ? result : undefined;
+}
+function compact(value) { return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined)); }

package/dist/data/communication-request-form-schema.data.d.ts

@@ -0,0 +1,108 @@
+import type { FlatClaims } from '../converters/convert-shared.js';
+export declare const CommunicationRequestStatuses: readonly ["draft", "active", "on-hold", "revoked", "completed", "entered-in-error", "unknown"];
+export declare const CommunicationRequestIntents: readonly ["proposal", "plan", "directive", "order", "original-order", "reflex-order", "filler-order", "instance-order", "option"];
+export declare const CommunicationRequestPriorities: readonly ["routine", "urgent", "asap", "stat"];
+export type CommunicationRequestFormData = Readonly<{
+    identifier?: string;
+    status: typeof CommunicationRequestStatuses[number];
+    intent: typeof CommunicationRequestIntents[number];
+    priority?: typeof CommunicationRequestPriorities[number];
+    subject: string;
+    encounter?: string;
+    requester: string;
+    recipients: readonly string[];
+    informationProviders?: readonly string[];
+    authoredOn?: string;
+    occurrence?: string;
+    payloadReference?: string;
+    payloadAttachmentContentType?: string;
+    payloadAttachmentData?: string;
+    payloadAttachmentTitle?: string;
+    note?: string;
+}>;
+/** Data-only JSON Schema. Portals own localized labels, widgets and authorization. */
+export declare const FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA: Readonly<{
+    $schema: "https://json-schema.org/draft/2020-12/schema";
+    $id: "https://globaldatacare.com/schemas/fhir/communication-request-form.json";
+    title: "CommunicationRequest";
+    type: "object";
+    additionalProperties: false;
+    required: readonly string[];
+    properties: Readonly<{
+        identifier: Readonly<{
+            type: "string";
+            minLength: 1;
+        }>;
+        status: Readonly<{
+            type: "string";
+            enum: readonly ["draft", "active", "on-hold", "revoked", "completed", "entered-in-error", "unknown"];
+        }>;
+        intent: Readonly<{
+            type: "string";
+            enum: readonly ["proposal", "plan", "directive", "order", "original-order", "reflex-order", "filler-order", "instance-order", "option"];
+        }>;
+        priority: Readonly<{
+            type: "string";
+            enum: readonly ["routine", "urgent", "asap", "stat"];
+        }>;
+        subject: Readonly<{
+            type: "string";
+            pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+        }>;
+        encounter: Readonly<{
+            type: "string";
+            pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+        }>;
+        requester: Readonly<{
+            type: "string";
+            pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+        }>;
+        recipients: Readonly<{
+            type: "array";
+            minItems: 1;
+            uniqueItems: true;
+            items: Readonly<{
+                type: "string";
+                pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+            }>;
+        }>;
+        informationProviders: Readonly<{
+            type: "array";
+            uniqueItems: true;
+            items: Readonly<{
+                type: "string";
+                pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+            }>;
+        }>;
+        authoredOn: Readonly<{
+            type: "string";
+            format: "date-time";
+        }>;
+        occurrence: Readonly<{
+            type: "string";
+            format: "date-time";
+        }>;
+        payloadReference: Readonly<{
+            type: "string";
+            pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
+        }>;
+        payloadAttachmentContentType: Readonly<{
+            type: "string";
+            minLength: 1;
+        }>;
+        payloadAttachmentData: Readonly<{
+            type: "string";
+            minLength: 1;
+            contentEncoding: "base64";
+        }>;
+        payloadAttachmentTitle: Readonly<{
+            type: "string";
+            minLength: 1;
+        }>;
+        note: Readonly<{
+            type: "string";
+        }>;
+    }>;
+}>;
+export declare function communicationRequestFormDataToFlatClaims(input: CommunicationRequestFormData): FlatClaims;
+export declare function communicationRequestFlatClaimsToFormData(claims: FlatClaims): CommunicationRequestFormData;

package/dist/data/communication-request-form-schema.data.js

@@ -0,0 +1,91 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+import { CommunicationRequestClaim } from '../claims/communication-request-claims.js';
+export const CommunicationRequestStatuses = Object.freeze([
+    'draft', 'active', 'on-hold', 'revoked', 'completed', 'entered-in-error', 'unknown',
+]);
+export const CommunicationRequestIntents = Object.freeze([
+    'proposal', 'plan', 'directive', 'order', 'original-order', 'reflex-order', 'filler-order', 'instance-order', 'option',
+]);
+export const CommunicationRequestPriorities = Object.freeze(['routine', 'urgent', 'asap', 'stat']);
+/** Data-only JSON Schema. Portals own localized labels, widgets and authorization. */
+export const FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA = Object.freeze({
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://globaldatacare.com/schemas/fhir/communication-request-form.json',
+    title: 'CommunicationRequest',
+    type: 'object',
+    additionalProperties: false,
+    required: Object.freeze(['status', 'intent', 'subject', 'requester', 'recipients']),
+    properties: Object.freeze({
+        identifier: Object.freeze({ type: 'string', minLength: 1 }),
+        status: Object.freeze({ type: 'string', enum: CommunicationRequestStatuses }),
+        intent: Object.freeze({ type: 'string', enum: CommunicationRequestIntents }),
+        priority: Object.freeze({ type: 'string', enum: CommunicationRequestPriorities }),
+        subject: referenceSchema(), encounter: referenceSchema(), requester: referenceSchema(),
+        recipients: Object.freeze({ type: 'array', minItems: 1, uniqueItems: true, items: referenceSchema() }),
+        informationProviders: Object.freeze({ type: 'array', uniqueItems: true, items: referenceSchema() }),
+        authoredOn: dateTimeSchema(), occurrence: dateTimeSchema(), payloadReference: referenceSchema(),
+        payloadAttachmentContentType: Object.freeze({ type: 'string', minLength: 1 }),
+        payloadAttachmentData: Object.freeze({ type: 'string', minLength: 1, contentEncoding: 'base64' }),
+        payloadAttachmentTitle: Object.freeze({ type: 'string', minLength: 1 }),
+        note: Object.freeze({ type: 'string' }),
+    }),
+});
+export function communicationRequestFormDataToFlatClaims(input) {
+    requiredEnum(input.status, CommunicationRequestStatuses, 'communication_request_status_invalid');
+    requiredEnum(input.intent, CommunicationRequestIntents, 'communication_request_intent_invalid');
+    if (input.priority)
+        requiredEnum(input.priority, CommunicationRequestPriorities, 'communication_request_priority_invalid');
+    const recipients = references(input.recipients, 'communication_request_recipient_required');
+    const providers = input.informationProviders?.length
+        ? references(input.informationProviders, 'communication_request_information_provider_invalid') : undefined;
+    if (input.payloadAttachmentData && !input.payloadAttachmentContentType) {
+        throw new TypeError('communication_request_attachment_content_type_required');
+    }
+    return compact({
+        [CommunicationRequestClaim.Identifier]: optional(input.identifier),
+        [CommunicationRequestClaim.Status]: input.status,
+        [CommunicationRequestClaim.Intent]: input.intent,
+        [CommunicationRequestClaim.Priority]: optional(input.priority),
+        [CommunicationRequestClaim.Subject]: reference(input.subject, 'communication_request_subject_invalid'),
+        [CommunicationRequestClaim.Encounter]: input.encounter ? reference(input.encounter, 'communication_request_encounter_invalid') : undefined,
+        [CommunicationRequestClaim.Requester]: reference(input.requester, 'communication_request_requester_invalid'),
+        [CommunicationRequestClaim.Recipient]: recipients.join(','),
+        [CommunicationRequestClaim.InformationProvider]: providers?.join(','),
+        [CommunicationRequestClaim.AuthoredOn]: dateTime(input.authoredOn),
+        [CommunicationRequestClaim.Occurrence]: dateTime(input.occurrence),
+        [CommunicationRequestClaim.PayloadReference]: input.payloadReference ? reference(input.payloadReference, 'communication_request_payload_reference_invalid') : undefined,
+        [CommunicationRequestClaim.PayloadAttachmentContentType]: optional(input.payloadAttachmentContentType),
+        [CommunicationRequestClaim.PayloadAttachmentData]: optional(input.payloadAttachmentData),
+        [CommunicationRequestClaim.PayloadAttachmentTitle]: optional(input.payloadAttachmentTitle),
+        [CommunicationRequestClaim.Note]: optional(input.note),
+    });
+}
+export function communicationRequestFlatClaimsToFormData(claims) {
+    return compact({
+        identifier: claims[CommunicationRequestClaim.Identifier], status: claims[CommunicationRequestClaim.Status],
+        intent: claims[CommunicationRequestClaim.Intent], priority: claims[CommunicationRequestClaim.Priority],
+        subject: claims[CommunicationRequestClaim.Subject], encounter: claims[CommunicationRequestClaim.Encounter],
+        requester: claims[CommunicationRequestClaim.Requester], recipients: split(claims[CommunicationRequestClaim.Recipient]),
+        informationProviders: splitOptional(claims[CommunicationRequestClaim.InformationProvider]),
+        authoredOn: claims[CommunicationRequestClaim.AuthoredOn], occurrence: claims[CommunicationRequestClaim.Occurrence],
+        payloadReference: claims[CommunicationRequestClaim.PayloadReference],
+        payloadAttachmentContentType: claims[CommunicationRequestClaim.PayloadAttachmentContentType],
+        payloadAttachmentData: claims[CommunicationRequestClaim.PayloadAttachmentData],
+        payloadAttachmentTitle: claims[CommunicationRequestClaim.PayloadAttachmentTitle], note: claims[CommunicationRequestClaim.Note],
+    });
+}
+function referenceSchema() { return Object.freeze({ type: 'string', pattern: '^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$' }); }
+function dateTimeSchema() { return Object.freeze({ type: 'string', format: 'date-time' }); }
+function optional(value) { const text = String(value ?? '').trim(); return text || undefined; }
+function dateTime(value) { const text = optional(value); if (text && Number.isNaN(Date.parse(text)))
+    throw new TypeError('communication_request_datetime_invalid'); return text; }
+function reference(value, error) { const text = optional(value); if (!text || !/^[A-Za-z][A-Za-z0-9]+\/[A-Za-z0-9.-]{1,64}$/u.test(text))
+    throw new TypeError(error); return text; }
+function references(values, error) { if (!Array.isArray(values) || !values.length)
+    throw new TypeError(error); const result = [...new Set(values.map(value => reference(value, error)))]; if (result.length !== values.length)
+    throw new TypeError(error); return result; }
+function split(value) { return Object.freeze(String(value || '').split(',').map(item => item.trim()).filter(Boolean)); }
+function splitOptional(value) { const values = split(value); return values.length ? values : undefined; }
+function requiredEnum(value, allowed, error) { if (!allowed.includes(value))
+    throw new TypeError(error); }
+function compact(value) { return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined)); }

package/dist/data/index.d.ts

@@ -5,3 +5,4 @@ export * from './ips-all-sections.data.js';
 export * from './health-credential-qr.data.js';
 export * from './ips-clinical-artifact-schemas.data.js';
 export * from './clinical-document-encounter-journey.data.js';
+export * from './communication-request-form-schema.data.js';

package/dist/data/index.js

@@ -5,3 +5,4 @@ export * from './ips-all-sections.data.js';
 export * from './health-credential-qr.data.js';
 export * from './ips-clinical-artifact-schemas.data.js';
 export * from './clinical-document-encounter-journey.data.js';
+export * from './communication-request-form-schema.data.js';

package/dist/data/ips-all-sections.data.d.ts

@@ -67,7 +67,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 status: string;
                 subject: {
@@ -84,7 +84,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                     }[];
                 };
                 effectiveDateTime: string;
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -103,7 +103,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                     }[];
                 };
                 occurrenceDateTime: string;
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -119,7 +119,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                     }[];
                 };
                 effectiveDateTime: string;
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -135,7 +135,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                     }[];
                 };
                 performedDateTime: string;
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -145,7 +145,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                 device: {
                     display: "Corrective lens use";
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -166,7 +166,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                     system: string;
                     code: string;
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 status: string;
                 subject: {
@@ -190,7 +190,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 status: string;
                 subject: {
@@ -206,7 +206,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -221,7 +221,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 status: string;
                 subject: {
@@ -248,7 +248,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                 patient: {
                     reference: string;
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -257,7 +257,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                 status: string;
                 description: "Independent daily activities";
                 summary: "Independent daily activities";
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -274,7 +274,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 }[];
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 subject: {
                     reference: string;
@@ -291,7 +291,7 @@ export declare const FHIR_IPS_ALL_SECTIONS_DEMO_DATA: Readonly<{
                         display: string;
                     }[];
                 };
-                resourceType: "Condition" | "Goal" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation" | "Procedure";
+                resourceType: "Condition" | "Goal" | "Procedure" | "AllergyIntolerance" | "CarePlan" | "ClinicalImpression" | "Consent" | "DeviceUseStatement" | "DiagnosticReport" | "Flag" | "Immunization" | "MedicationStatement" | "Observation";
                 id: string;
                 status: string;
                 subject: {

package/dist/hl7-v2-0203-identifier-types.d.ts

@@ -0,0 +1,40 @@
+/** Canonical HL7 v2-0203 CodeSystem used by FHIR Identifier.type coding. */
+export declare const HL7_V2_0203_IDENTIFIER_TYPE_SYSTEM: "http://terminology.hl7.org/CodeSystem/v2-0203";
+/** Published FHIR value set that selects commonly used Identifier.type codes. */
+export declare const FHIR_IDENTIFIER_TYPE_VALUE_SET_URL: "https://hl7.org/fhir/valueset-identifier-type.html";
+/** Normative registries used to validate the shared catalog. */
+export declare const HL7_IDENTIFIER_REGISTRY_SOURCES: Readonly<{
+    CodeSystem: "http://terminology.hl7.org/CodeSystem/v2-0203";
+    FhirIdentifierTypeValueSet: "https://hl7.org/fhir/valueset-identifier-type.html";
+    Hl7TerminologySource: "https://terminology.hl7.org/6.5.0/CodeSystem-v2-0203.html";
+}>;
+/**
+ * Product-neutral person and healthcare identifier codes used by the shared
+ * FHIR adapters. Contact points and veterinary identifiers belong to their
+ * own standards and are deliberately absent.
+ */
+export declare const HL7_V2_0203_IDENTIFIER_CODES: Readonly<{
+    readonly DriverLicense: "DL";
+    readonly CitizenshipCard: "CZ";
+    readonly NationalNumber: "NN";
+    readonly PassportNumber: "PPN";
+    readonly JurisdictionalHealthNumber: "JHN";
+    readonly PermanentResidentCard: "PRC";
+    readonly WorkPermit: "WP";
+    readonly StudyPermit: "SP";
+    readonly Visa: "VS";
+    readonly VisitorPermit: "VP";
+    readonly TemporaryPermanentResident: "TPR";
+    readonly HealthCard: "HC";
+    readonly MemberNumber: "MB";
+    readonly SubscriberNumber: "SN";
+    readonly DonorRecord: "DR";
+    readonly PatientIdentifier: "PI";
+}>;
+export type Hl7V20203IdentifierCode = typeof HL7_V2_0203_IDENTIFIER_CODES[keyof typeof HL7_V2_0203_IDENTIFIER_CODES];
+/** Product-neutral organization identifier codes from the same CodeSystem. */
+export declare const HL7_V2_0203_ORGANIZATION_IDENTIFIER_CODES: Readonly<{
+    readonly TaxIdentifier: "TAX";
+    readonly EmployerNumber: "EN";
+}>;
+export type Hl7V20203OrganizationIdentifierCode = typeof HL7_V2_0203_ORGANIZATION_IDENTIFIER_CODES[keyof typeof HL7_V2_0203_ORGANIZATION_IDENTIFIER_CODES];

package/dist/hl7-v2-0203-identifier-types.js

@@ -0,0 +1,38 @@
+/** Canonical HL7 v2-0203 CodeSystem used by FHIR Identifier.type coding. */
+export const HL7_V2_0203_IDENTIFIER_TYPE_SYSTEM = 'http://terminology.hl7.org/CodeSystem/v2-0203';
+/** Published FHIR value set that selects commonly used Identifier.type codes. */
+export const FHIR_IDENTIFIER_TYPE_VALUE_SET_URL = 'https://hl7.org/fhir/valueset-identifier-type.html';
+/** Normative registries used to validate the shared catalog. */
+export const HL7_IDENTIFIER_REGISTRY_SOURCES = Object.freeze({
+    CodeSystem: HL7_V2_0203_IDENTIFIER_TYPE_SYSTEM,
+    FhirIdentifierTypeValueSet: FHIR_IDENTIFIER_TYPE_VALUE_SET_URL,
+    Hl7TerminologySource: 'https://terminology.hl7.org/6.5.0/CodeSystem-v2-0203.html',
+});
+/**
+ * Product-neutral person and healthcare identifier codes used by the shared
+ * FHIR adapters. Contact points and veterinary identifiers belong to their
+ * own standards and are deliberately absent.
+ */
+export const HL7_V2_0203_IDENTIFIER_CODES = Object.freeze({
+    DriverLicense: 'DL',
+    CitizenshipCard: 'CZ',
+    NationalNumber: 'NN',
+    PassportNumber: 'PPN',
+    JurisdictionalHealthNumber: 'JHN',
+    PermanentResidentCard: 'PRC',
+    WorkPermit: 'WP',
+    StudyPermit: 'SP',
+    Visa: 'VS',
+    VisitorPermit: 'VP',
+    TemporaryPermanentResident: 'TPR',
+    HealthCard: 'HC',
+    MemberNumber: 'MB',
+    SubscriberNumber: 'SN',
+    DonorRecord: 'DR',
+    PatientIdentifier: 'PI',
+});
+/** Product-neutral organization identifier codes from the same CodeSystem. */
+export const HL7_V2_0203_ORGANIZATION_IDENTIFIER_CODES = Object.freeze({
+    TaxIdentifier: 'TAX',
+    EmployerNumber: 'EN',
+});

package/dist/index.d.ts

@@ -29,3 +29,5 @@ export * from './fhir-instant.js';
 export * from './health-credential-qr.js';
 export * from './fhir-temporal-presentation.js';
 export * from './clinical-artifact-editor.js';
+export * from './clinical-artifact-coded-options.js';
+export * from './hl7-v2-0203-identifier-types.js';

package/dist/index.js

@@ -29,3 +29,5 @@ export * from './fhir-instant.js';
 export * from './health-credential-qr.js';
 export * from './fhir-temporal-presentation.js';
 export * from './clinical-artifact-editor.js';
+export * from './clinical-artifact-coded-options.js';
+export * from './hl7-v2-0203-identifier-types.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-data-utils-ts",
-  "version": "0.6.12",
+  "version": "0.6.16",
   "description": "FHIR-version-neutral flat-claim and SearchParameter data utilities",
   "license": "Apache-2.0",
   "type": "module",
@@ -55,6 +55,10 @@
       "types": "./dist/fhir-values.d.ts",
       "default": "./dist/fhir-values.js"
     },
+    "./hl7-v2-0203-identifier-types": {
+      "types": "./dist/hl7-v2-0203-identifier-types.d.ts",
+      "default": "./dist/hl7-v2-0203-identifier-types.js"
+    },
     "./fhir-search-parameters": {
       "types": "./dist/fhir-search-parameters.d.ts",
       "default": "./dist/fhir-search-parameters.js"
@@ -83,6 +87,10 @@
       "types": "./dist/clinical-terminology.d.ts",
       "default": "./dist/clinical-terminology.js"
     },
+    "./clinical-artifact-coded-options": {
+      "types": "./dist/clinical-artifact-coded-options.d.ts",
+      "default": "./dist/clinical-artifact-coded-options.js"
+    },
     "./immunization-flat-claims": {
       "types": "./dist/immunization-flat-claims.d.ts",
       "default": "./dist/immunization-flat-claims.js"