fhir-data-utils-ts 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## Unreleased
 
+- Publish repository-safe Appointment/Communication and Encounter-transfer
+  fixtures from the explicit `fhir-data-utils-ts/data` entry point. Their
+  `*.data.ts` implementations are excluded from executable coverage while the
+  historical source modules remain compatibility reexports.
+- Remove notification-channel policy from the general root and `builders`
+  surfaces. The historical reminder subpath and non-standard `Task.channel`
+  claim remain deprecated compatibility only while product packages migrate;
+  SOS/Vet/UHC own channel choices and dispatch behavior.
+
+## 0.6.2 - 2026-09-30
+
+- Add strict FHIR `instant` to Unix epoch-second derivation while preserving
+  the boundary between clinical time, `Encounter.id`, provider business
+  identifiers and human display codes.
+
 ## 0.6.1 - 2026-09-30
 
 - Add canonical flat claims, a claims-first builder and native R5 projection

package/README.md

@@ -92,6 +92,12 @@ metadata and protected endpoint references only. DICOM instances and pixel
 payloads remain outside this neutral package and are never embedded as flat
 claims.
 
+FHIR instants, resource ids and provider business identifiers remain separate.
+Use `fhirInstantToEpochSeconds(...)` only when a downstream convention needs a
+derived whole-second value; retain the original timezone-bearing instant and
+an independent `Encounter.id`. See
+[`docs/ENCOUNTER_IDENTIFIERS_AND_TIME.md`](docs/ENCOUNTER_IDENTIFIERS_AND_TIME.md).
+
 No consumer should copy claim paths or rebuild these structures with literals.
 Use `fhir-data-utils-ts/claims`, `/converters`, `/fhir-bundle`,
 `/fhir-search-parameters`, `/clinical-terminology`, `/group-r5` or

package/dist/appointment-communication-test-data.d.ts

@@ -1,63 +1,2 @@
-import type { FhirBundle, FhirResource } from './fhir-types.js';
-/** Repository-safe reusable evidence for appointment Bundle and calendar tests. */
-export declare const FHIR_APPOINTMENT_COMMUNICATION_TEST_DATA: Readonly<{
-    release: "r5";
-    start: "2026-10-05T16:00:00.000Z";
-    end: "2026-10-05T16:30:00.000Z";
-    communicationId: "communication-one";
-    subjectReference: "Patient/animal-one";
-    senderReference: "Organization/clinic-one";
-    recipientReference: "RelatedPerson/controller-one";
-    appointmentReference: "Appointment/appointment-one";
-    calendarData: string;
-    appointment: Readonly<{
-        [key: string]: unknown;
-        resourceType: string;
-        id?: string;
-        language?: string;
-        meta?: Readonly<Record<string, unknown>>;
-        contained?: readonly FhirResource[];
-    }>;
-    calendarDocument: Readonly<{
-        [key: string]: unknown;
-        resourceType: string;
-        id?: string;
-        language?: string;
-        meta?: Readonly<Record<string, unknown>>;
-        contained?: readonly FhirResource[];
-    }>;
-    communication: Readonly<{
-        [key: string]: unknown;
-        resourceType: string;
-        id?: string;
-        language?: string;
-        meta?: Readonly<Record<string, unknown>>;
-        contained?: readonly FhirResource[];
-    }>;
-    outerBatch: FhirBundle;
-    outerBatchWithInvalidDocument: FhirBundle;
-    outerBatchWithInvalidInnerBatch: FhirBundle;
-    outerBatchWithBareAppointment: Readonly<{
-        resourceType: "Bundle";
-        type: "batch";
-        entry: {
-            resource: {
-                payload: {
-                    contentAttachment: {
-                        contentType: string;
-                        data: string;
-                    };
-                }[];
-                resourceType: string;
-                id?: string;
-                language?: string;
-                meta?: Readonly<Record<string, unknown>>;
-                contained?: readonly FhirResource[];
-            };
-            request: {
-                method: string;
-                url: string;
-            };
-        }[];
-    }>;
-}>;
+/** @deprecated Import reusable fixtures from `fhir-data-utils-ts/data`. */
+export * from './data/appointment-communication.data.js';

package/dist/appointment-communication-test-data.js

@@ -1,77 +1,2 @@
-const APPOINTMENT_ID = 'appointment-one';
-const COMMUNICATION_ID = 'communication-one';
-const CALENDAR_DOCUMENT_ID = 'appointment-calendar-one';
-const SUBJECT_REFERENCE = 'Patient/animal-one';
-const SENDER_REFERENCE = 'Organization/clinic-one';
-const RECIPIENT_REFERENCE = 'RelatedPerson/controller-one';
-const APPOINTMENT_REFERENCE = `Appointment/${APPOINTMENT_ID}`;
-const CALENDAR_DOCUMENT_REFERENCE = `DocumentReference/${CALENDAR_DOCUMENT_ID}`;
-const APPOINTMENT_START = '2026-10-05T16:00:00.000Z';
-const APPOINTMENT_END = '2026-10-05T16:30:00.000Z';
-const CALENDAR_DATA = encodeBase64Utf8('BEGIN:VCALENDAR\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nDTSTART:20261005T160000Z\r\nDTEND:20261005T163000Z\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n');
-const APPOINTMENT = Object.freeze({
-    resourceType: 'Appointment', id: APPOINTMENT_ID, identifier: [{ value: APPOINTMENT_ID }], status: 'booked',
-    start: APPOINTMENT_START, end: APPOINTMENT_END,
-    participant: [{ actor: { reference: SUBJECT_REFERENCE }, status: 'accepted' }, { actor: { reference: 'PractitionerRole/veterinarian-one' }, status: 'accepted' }, { actor: { reference: 'Location/consultation-one' }, status: 'accepted' }],
-    slot: [{ reference: 'Slot/consultation-one' }], supportingInformation: [{ reference: CALENDAR_DOCUMENT_REFERENCE }],
-});
-const CALENDAR_DOCUMENT = Object.freeze({
-    resourceType: 'DocumentReference', id: CALENDAR_DOCUMENT_ID, identifier: [{ value: CALENDAR_DOCUMENT_ID }], status: 'current',
-    subject: { reference: SUBJECT_REFERENCE }, context: { related: [{ reference: APPOINTMENT_REFERENCE }] },
-    content: [{ attachment: { contentType: 'text/calendar', data: CALENDAR_DATA, title: 'appointment.ics' } }],
-});
-const INNER_BUNDLE = Object.freeze({ resourceType: 'Bundle', type: 'collection', entry: [{ resource: APPOINTMENT }, { resource: CALENDAR_DOCUMENT }] });
-const COMMUNICATION = Object.freeze({
-    resourceType: 'Communication', id: COMMUNICATION_ID, identifier: [{ value: COMMUNICATION_ID }], status: 'completed',
-    subject: { reference: SUBJECT_REFERENCE }, recipient: [{ reference: RECIPIENT_REFERENCE }], sender: { reference: SENDER_REFERENCE },
-    payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(INNER_BUNDLE)), title: 'appointment-bundle.json' } }],
-});
-function communicationWithInnerBundle(innerBundle) {
-    return Object.freeze({
-        ...COMMUNICATION,
-        payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(innerBundle)) } }],
-    });
-}
-function outerBatchWithCommunication(communication) {
-    return Object.freeze({
-        resourceType: 'Bundle',
-        type: 'batch',
-        entry: [{ resource: communication, request: { method: 'POST', url: 'Communication' } }],
-    });
-}
-/** Repository-safe reusable evidence for appointment Bundle and calendar tests. */
-export const FHIR_APPOINTMENT_COMMUNICATION_TEST_DATA = Object.freeze({
-    release: 'r5',
-    start: APPOINTMENT_START,
-    end: APPOINTMENT_END,
-    communicationId: COMMUNICATION_ID,
-    subjectReference: SUBJECT_REFERENCE,
-    senderReference: SENDER_REFERENCE,
-    recipientReference: RECIPIENT_REFERENCE,
-    appointmentReference: APPOINTMENT_REFERENCE,
-    calendarData: CALENDAR_DATA,
-    appointment: APPOINTMENT,
-    calendarDocument: CALENDAR_DOCUMENT,
-    communication: COMMUNICATION,
-    outerBatch: outerBatchWithCommunication(COMMUNICATION),
-    outerBatchWithInvalidDocument: outerBatchWithCommunication(communicationWithInnerBundle(Object.freeze({
-        resourceType: 'Bundle',
-        type: 'document',
-        entry: [{ resource: APPOINTMENT }],
-    }))),
-    outerBatchWithInvalidInnerBatch: outerBatchWithCommunication(communicationWithInnerBundle(Object.freeze({
-        resourceType: 'Bundle',
-        type: 'batch',
-        entry: [{ resource: APPOINTMENT }],
-    }))),
-    outerBatchWithBareAppointment: Object.freeze({
-        resourceType: 'Bundle', type: 'batch', entry: [{ resource: { ...COMMUNICATION, payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(APPOINTMENT)) } }] }, request: { method: 'POST', url: 'Communication' } }],
-    }),
-});
-function encodeBase64Utf8(value) {
-    const bytes = new TextEncoder().encode(value);
-    let binary = '';
-    for (const byte of bytes)
-        binary += String.fromCharCode(byte);
-    return globalThis.btoa(binary);
-}
+/** @deprecated Import reusable fixtures from `fhir-data-utils-ts/data`. */
+export * from './data/appointment-communication.data.js';

package/dist/builders/immunization-reminders.d.ts

@@ -5,6 +5,10 @@ export declare const ImmunizationReminderTaskValues: Readonly<{
     readonly Code: "immunization-reminder";
     readonly TriggerType: "scheduled";
 }>;
+/**
+ * @deprecated Compatibility only. Notification-channel policy belongs to the
+ * consuming SOS/Vet/UHC data package, not to the general FHIR data package.
+ */
 export declare const ImmunizationReminderChannels: readonly ["push", "email", "sms", "whatsapp", "telephone"];
 export type ImmunizationReminderChannel = (typeof ImmunizationReminderChannels)[number];
 export type ImmunizationReminderPlanInput = Readonly<{

package/dist/builders/immunization-reminders.js

@@ -8,6 +8,10 @@ export const ImmunizationReminderTaskValues = Object.freeze({
     Code: 'immunization-reminder',
     TriggerType: 'scheduled',
 });
+/**
+ * @deprecated Compatibility only. Notification-channel policy belongs to the
+ * consuming SOS/Vet/UHC data package, not to the general FHIR data package.
+ */
 export const ImmunizationReminderChannels = Object.freeze([
     'push',
     'email',

package/dist/builders/index.d.ts

@@ -3,4 +3,3 @@ export * from './department-service-graph.js';
 export * from './service-schedule-graph.js';
 export * from './device-compliance-graph.js';
 export * from './immunization-graph.js';
-export * from './immunization-reminders.js';

package/dist/builders/index.js

@@ -3,4 +3,3 @@ export * from './department-service-graph.js';
 export * from './service-schedule-graph.js';
 export * from './device-compliance-graph.js';
 export * from './immunization-graph.js';
-export * from './immunization-reminders.js';

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

@@ -21,6 +21,7 @@ export declare enum TaskClaimsFhirApi {
     BasedOn = "Task.based-on",
     BasedOnDisplay = "Task.based-on-display",
     Language = "Task.language",
+    /** @deprecated Non-standard compatibility claim. Model delivery policy outside FHIR. */
     Channel = "Task.channel",
     AuthoredOn = "Task.authored-on",
     LastModified = "Task.last-modified",

package/dist/claims/task-claims.js

@@ -24,6 +24,7 @@ export var TaskClaimsFhirApi;
     TaskClaimsFhirApi["BasedOn"] = "Task.based-on";
     TaskClaimsFhirApi["BasedOnDisplay"] = "Task.based-on-display";
     TaskClaimsFhirApi["Language"] = "Task.language";
+    /** @deprecated Non-standard compatibility claim. Model delivery policy outside FHIR. */
     TaskClaimsFhirApi["Channel"] = "Task.channel";
     TaskClaimsFhirApi["AuthoredOn"] = "Task.authored-on";
     TaskClaimsFhirApi["LastModified"] = "Task.last-modified";

package/dist/data/appointment-communication.data.d.ts

@@ -0,0 +1,63 @@
+import type { FhirBundle, FhirResource } from '../fhir-types.js';
+/** Repository-safe reusable evidence for appointment Bundle and calendar tests. */
+export declare const FHIR_APPOINTMENT_COMMUNICATION_TEST_DATA: Readonly<{
+    release: "r5";
+    start: "2026-10-05T16:00:00.000Z";
+    end: "2026-10-05T16:30:00.000Z";
+    communicationId: "communication-one";
+    subjectReference: "Patient/animal-one";
+    senderReference: "Organization/clinic-one";
+    recipientReference: "RelatedPerson/controller-one";
+    appointmentReference: "Appointment/appointment-one";
+    calendarData: string;
+    appointment: Readonly<{
+        [key: string]: unknown;
+        resourceType: string;
+        id?: string;
+        language?: string;
+        meta?: Readonly<Record<string, unknown>>;
+        contained?: readonly FhirResource[];
+    }>;
+    calendarDocument: Readonly<{
+        [key: string]: unknown;
+        resourceType: string;
+        id?: string;
+        language?: string;
+        meta?: Readonly<Record<string, unknown>>;
+        contained?: readonly FhirResource[];
+    }>;
+    communication: Readonly<{
+        [key: string]: unknown;
+        resourceType: string;
+        id?: string;
+        language?: string;
+        meta?: Readonly<Record<string, unknown>>;
+        contained?: readonly FhirResource[];
+    }>;
+    outerBatch: FhirBundle;
+    outerBatchWithInvalidDocument: FhirBundle;
+    outerBatchWithInvalidInnerBatch: FhirBundle;
+    outerBatchWithBareAppointment: Readonly<{
+        resourceType: "Bundle";
+        type: "batch";
+        entry: {
+            resource: {
+                payload: {
+                    contentAttachment: {
+                        contentType: string;
+                        data: string;
+                    };
+                }[];
+                resourceType: string;
+                id?: string;
+                language?: string;
+                meta?: Readonly<Record<string, unknown>>;
+                contained?: readonly FhirResource[];
+            };
+            request: {
+                method: string;
+                url: string;
+            };
+        }[];
+    }>;
+}>;

package/dist/data/appointment-communication.data.js

@@ -0,0 +1,77 @@
+const APPOINTMENT_ID = 'appointment-one';
+const COMMUNICATION_ID = 'communication-one';
+const CALENDAR_DOCUMENT_ID = 'appointment-calendar-one';
+const SUBJECT_REFERENCE = 'Patient/animal-one';
+const SENDER_REFERENCE = 'Organization/clinic-one';
+const RECIPIENT_REFERENCE = 'RelatedPerson/controller-one';
+const APPOINTMENT_REFERENCE = `Appointment/${APPOINTMENT_ID}`;
+const CALENDAR_DOCUMENT_REFERENCE = `DocumentReference/${CALENDAR_DOCUMENT_ID}`;
+const APPOINTMENT_START = '2026-10-05T16:00:00.000Z';
+const APPOINTMENT_END = '2026-10-05T16:30:00.000Z';
+const CALENDAR_DATA = encodeBase64Utf8('BEGIN:VCALENDAR\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nDTSTART:20261005T160000Z\r\nDTEND:20261005T163000Z\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n');
+const APPOINTMENT = Object.freeze({
+    resourceType: 'Appointment', id: APPOINTMENT_ID, identifier: [{ value: APPOINTMENT_ID }], status: 'booked',
+    start: APPOINTMENT_START, end: APPOINTMENT_END,
+    participant: [{ actor: { reference: SUBJECT_REFERENCE }, status: 'accepted' }, { actor: { reference: 'PractitionerRole/veterinarian-one' }, status: 'accepted' }, { actor: { reference: 'Location/consultation-one' }, status: 'accepted' }],
+    slot: [{ reference: 'Slot/consultation-one' }], supportingInformation: [{ reference: CALENDAR_DOCUMENT_REFERENCE }],
+});
+const CALENDAR_DOCUMENT = Object.freeze({
+    resourceType: 'DocumentReference', id: CALENDAR_DOCUMENT_ID, identifier: [{ value: CALENDAR_DOCUMENT_ID }], status: 'current',
+    subject: { reference: SUBJECT_REFERENCE }, context: { related: [{ reference: APPOINTMENT_REFERENCE }] },
+    content: [{ attachment: { contentType: 'text/calendar', data: CALENDAR_DATA, title: 'appointment.ics' } }],
+});
+const INNER_BUNDLE = Object.freeze({ resourceType: 'Bundle', type: 'collection', entry: [{ resource: APPOINTMENT }, { resource: CALENDAR_DOCUMENT }] });
+const COMMUNICATION = Object.freeze({
+    resourceType: 'Communication', id: COMMUNICATION_ID, identifier: [{ value: COMMUNICATION_ID }], status: 'completed',
+    subject: { reference: SUBJECT_REFERENCE }, recipient: [{ reference: RECIPIENT_REFERENCE }], sender: { reference: SENDER_REFERENCE },
+    payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(INNER_BUNDLE)), title: 'appointment-bundle.json' } }],
+});
+function communicationWithInnerBundle(innerBundle) {
+    return Object.freeze({
+        ...COMMUNICATION,
+        payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(innerBundle)) } }],
+    });
+}
+function outerBatchWithCommunication(communication) {
+    return Object.freeze({
+        resourceType: 'Bundle',
+        type: 'batch',
+        entry: [{ resource: communication, request: { method: 'POST', url: 'Communication' } }],
+    });
+}
+/** Repository-safe reusable evidence for appointment Bundle and calendar tests. */
+export const FHIR_APPOINTMENT_COMMUNICATION_TEST_DATA = Object.freeze({
+    release: 'r5',
+    start: APPOINTMENT_START,
+    end: APPOINTMENT_END,
+    communicationId: COMMUNICATION_ID,
+    subjectReference: SUBJECT_REFERENCE,
+    senderReference: SENDER_REFERENCE,
+    recipientReference: RECIPIENT_REFERENCE,
+    appointmentReference: APPOINTMENT_REFERENCE,
+    calendarData: CALENDAR_DATA,
+    appointment: APPOINTMENT,
+    calendarDocument: CALENDAR_DOCUMENT,
+    communication: COMMUNICATION,
+    outerBatch: outerBatchWithCommunication(COMMUNICATION),
+    outerBatchWithInvalidDocument: outerBatchWithCommunication(communicationWithInnerBundle(Object.freeze({
+        resourceType: 'Bundle',
+        type: 'document',
+        entry: [{ resource: APPOINTMENT }],
+    }))),
+    outerBatchWithInvalidInnerBatch: outerBatchWithCommunication(communicationWithInnerBundle(Object.freeze({
+        resourceType: 'Bundle',
+        type: 'batch',
+        entry: [{ resource: APPOINTMENT }],
+    }))),
+    outerBatchWithBareAppointment: Object.freeze({
+        resourceType: 'Bundle', type: 'batch', entry: [{ resource: { ...COMMUNICATION, payload: [{ contentAttachment: { contentType: 'application/fhir+json', data: encodeBase64Utf8(JSON.stringify(APPOINTMENT)) } }] }, request: { method: 'POST', url: 'Communication' } }],
+    }),
+});
+function encodeBase64Utf8(value) {
+    const bytes = new TextEncoder().encode(value);
+    let binary = '';
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return globalThis.btoa(binary);
+}

package/dist/data/encounter-transfer.data.d.ts

@@ -0,0 +1,41 @@
+import { EncounterStatusR5 } from '../claims/encounter-claims.js';
+/** Product-neutral identifiers and references for cross-package Encounter transfer contract tests. */
+export declare const FHIR_ENCOUNTER_TRANSFER_TEST_DATA: Readonly<{
+    communicationIdentifier: "urn:uuid:00000000-0000-4000-8000-000000000401";
+    subjectReference: "Patient/00000000-0000-4000-8000-000000000402";
+    senderReference: "Organization/00000000-0000-4000-8000-000000000403";
+    indexRecipientReference: "Organization/00000000-0000-4000-8000-000000000404";
+    occurredAt: "2026-09-30T10:10:00Z";
+    invalidOccurredAtWithoutTimezone: "2026-09-30T10:10:00";
+    class: Readonly<{
+        system: "http://terminology.hl7.org/CodeSystem/v3-ActCode";
+        code: "EMER";
+    }>;
+    source: Readonly<{
+        id: "00000000-0000-4000-8000-000000000405";
+        reference: "Encounter/00000000-0000-4000-8000-000000000405";
+        identifier: "urn:uuid:00000000-0000-4000-8000-000000000405";
+        serviceReference: "HealthcareService/00000000-0000-4000-8000-000000000406";
+        locationReference: "Location/00000000-0000-4000-8000-000000000407";
+        statusWhenReturning: EncounterStatusR5.OnHold;
+        statusWhenNotReturning: EncounterStatusR5.Completed;
+    }>;
+    destination: Readonly<{
+        id: "00000000-0000-4000-8000-000000000408";
+        reference: "Encounter/00000000-0000-4000-8000-000000000408";
+        identifier: "urn:uuid:00000000-0000-4000-8000-000000000408";
+        serviceReference: "HealthcareService/00000000-0000-4000-8000-000000000409";
+        locationReference: "Location/00000000-0000-4000-8000-000000000410";
+        statusOnArrival: EncounterStatusR5.InProgress;
+    }>;
+    sourceHistory: Readonly<{
+        id: "00000000-0000-4000-8000-000000000411";
+        identifier: "urn:uuid:00000000-0000-4000-8000-000000000411";
+        encounterReference: "Encounter/00000000-0000-4000-8000-000000000405";
+    }>;
+    destinationHistory: Readonly<{
+        id: "00000000-0000-4000-8000-000000000412";
+        identifier: "urn:uuid:00000000-0000-4000-8000-000000000412";
+        encounterReference: "Encounter/00000000-0000-4000-8000-000000000408";
+    }>;
+}>;

package/dist/data/encounter-transfer.data.js

@@ -0,0 +1,38 @@
+import { EncounterStatusR5 } from '../claims/encounter-claims.js';
+/** Product-neutral identifiers and references for cross-package Encounter transfer contract tests. */
+export const FHIR_ENCOUNTER_TRANSFER_TEST_DATA = Object.freeze({
+    communicationIdentifier: 'urn:uuid:00000000-0000-4000-8000-000000000401',
+    subjectReference: 'Patient/00000000-0000-4000-8000-000000000402',
+    senderReference: 'Organization/00000000-0000-4000-8000-000000000403',
+    indexRecipientReference: 'Organization/00000000-0000-4000-8000-000000000404',
+    occurredAt: '2026-09-30T10:10:00Z',
+    invalidOccurredAtWithoutTimezone: '2026-09-30T10:10:00',
+    class: Object.freeze({ system: 'http://terminology.hl7.org/CodeSystem/v3-ActCode', code: 'EMER' }),
+    source: Object.freeze({
+        id: '00000000-0000-4000-8000-000000000405',
+        reference: 'Encounter/00000000-0000-4000-8000-000000000405',
+        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000405',
+        serviceReference: 'HealthcareService/00000000-0000-4000-8000-000000000406',
+        locationReference: 'Location/00000000-0000-4000-8000-000000000407',
+        statusWhenReturning: EncounterStatusR5.OnHold,
+        statusWhenNotReturning: EncounterStatusR5.Completed,
+    }),
+    destination: Object.freeze({
+        id: '00000000-0000-4000-8000-000000000408',
+        reference: 'Encounter/00000000-0000-4000-8000-000000000408',
+        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000408',
+        serviceReference: 'HealthcareService/00000000-0000-4000-8000-000000000409',
+        locationReference: 'Location/00000000-0000-4000-8000-000000000410',
+        statusOnArrival: EncounterStatusR5.InProgress,
+    }),
+    sourceHistory: Object.freeze({
+        id: '00000000-0000-4000-8000-000000000411',
+        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000411',
+        encounterReference: 'Encounter/00000000-0000-4000-8000-000000000405',
+    }),
+    destinationHistory: Object.freeze({
+        id: '00000000-0000-4000-8000-000000000412',
+        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000412',
+        encounterReference: 'Encounter/00000000-0000-4000-8000-000000000408',
+    }),
+});

package/dist/data/index.d.ts

@@ -0,0 +1,3 @@
+/** Reusable, repository-safe examples for tests, docs and portal demos. */
+export * from './appointment-communication.data.js';
+export * from './encounter-transfer.data.js';

package/dist/data/index.js

@@ -0,0 +1,3 @@
+/** Reusable, repository-safe examples for tests, docs and portal demos. */
+export * from './appointment-communication.data.js';
+export * from './encounter-transfer.data.js';

package/dist/encounter-transfer-test-data.d.ts

@@ -1,40 +1,2 @@
-import { EncounterStatusR5 } from './claims/encounter-claims.js';
-/** Product-neutral identifiers and references for cross-package Encounter transfer contract tests. */
-export declare const FHIR_ENCOUNTER_TRANSFER_TEST_DATA: Readonly<{
-    communicationIdentifier: "urn:uuid:00000000-0000-4000-8000-000000000401";
-    subjectReference: "Patient/00000000-0000-4000-8000-000000000402";
-    senderReference: "Organization/00000000-0000-4000-8000-000000000403";
-    indexRecipientReference: "Organization/00000000-0000-4000-8000-000000000404";
-    occurredAt: "2026-09-30T10:10:00Z";
-    class: Readonly<{
-        system: "http://terminology.hl7.org/CodeSystem/v3-ActCode";
-        code: "EMER";
-    }>;
-    source: Readonly<{
-        id: "00000000-0000-4000-8000-000000000405";
-        reference: "Encounter/00000000-0000-4000-8000-000000000405";
-        identifier: "urn:uuid:00000000-0000-4000-8000-000000000405";
-        serviceReference: "HealthcareService/00000000-0000-4000-8000-000000000406";
-        locationReference: "Location/00000000-0000-4000-8000-000000000407";
-        statusWhenReturning: EncounterStatusR5.OnHold;
-        statusWhenNotReturning: EncounterStatusR5.Completed;
-    }>;
-    destination: Readonly<{
-        id: "00000000-0000-4000-8000-000000000408";
-        reference: "Encounter/00000000-0000-4000-8000-000000000408";
-        identifier: "urn:uuid:00000000-0000-4000-8000-000000000408";
-        serviceReference: "HealthcareService/00000000-0000-4000-8000-000000000409";
-        locationReference: "Location/00000000-0000-4000-8000-000000000410";
-        statusOnArrival: EncounterStatusR5.InProgress;
-    }>;
-    sourceHistory: Readonly<{
-        id: "00000000-0000-4000-8000-000000000411";
-        identifier: "urn:uuid:00000000-0000-4000-8000-000000000411";
-        encounterReference: "Encounter/00000000-0000-4000-8000-000000000405";
-    }>;
-    destinationHistory: Readonly<{
-        id: "00000000-0000-4000-8000-000000000412";
-        identifier: "urn:uuid:00000000-0000-4000-8000-000000000412";
-        encounterReference: "Encounter/00000000-0000-4000-8000-000000000408";
-    }>;
-}>;
+/** @deprecated Import reusable fixtures from `fhir-data-utils-ts/data`. */
+export * from './data/encounter-transfer.data.js';

package/dist/encounter-transfer-test-data.js

@@ -1,37 +1,2 @@
-import { EncounterStatusR5 } from './claims/encounter-claims.js';
-/** Product-neutral identifiers and references for cross-package Encounter transfer contract tests. */
-export const FHIR_ENCOUNTER_TRANSFER_TEST_DATA = Object.freeze({
-    communicationIdentifier: 'urn:uuid:00000000-0000-4000-8000-000000000401',
-    subjectReference: 'Patient/00000000-0000-4000-8000-000000000402',
-    senderReference: 'Organization/00000000-0000-4000-8000-000000000403',
-    indexRecipientReference: 'Organization/00000000-0000-4000-8000-000000000404',
-    occurredAt: '2026-09-30T10:10:00Z',
-    class: Object.freeze({ system: 'http://terminology.hl7.org/CodeSystem/v3-ActCode', code: 'EMER' }),
-    source: Object.freeze({
-        id: '00000000-0000-4000-8000-000000000405',
-        reference: 'Encounter/00000000-0000-4000-8000-000000000405',
-        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000405',
-        serviceReference: 'HealthcareService/00000000-0000-4000-8000-000000000406',
-        locationReference: 'Location/00000000-0000-4000-8000-000000000407',
-        statusWhenReturning: EncounterStatusR5.OnHold,
-        statusWhenNotReturning: EncounterStatusR5.Completed,
-    }),
-    destination: Object.freeze({
-        id: '00000000-0000-4000-8000-000000000408',
-        reference: 'Encounter/00000000-0000-4000-8000-000000000408',
-        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000408',
-        serviceReference: 'HealthcareService/00000000-0000-4000-8000-000000000409',
-        locationReference: 'Location/00000000-0000-4000-8000-000000000410',
-        statusOnArrival: EncounterStatusR5.InProgress,
-    }),
-    sourceHistory: Object.freeze({
-        id: '00000000-0000-4000-8000-000000000411',
-        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000411',
-        encounterReference: 'Encounter/00000000-0000-4000-8000-000000000405',
-    }),
-    destinationHistory: Object.freeze({
-        id: '00000000-0000-4000-8000-000000000412',
-        identifier: 'urn:uuid:00000000-0000-4000-8000-000000000412',
-        encounterReference: 'Encounter/00000000-0000-4000-8000-000000000408',
-    }),
-});
+/** @deprecated Import reusable fixtures from `fhir-data-utils-ts/data`. */
+export * from './data/encounter-transfer.data.js';

package/dist/fhir-instant.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Derives whole Unix epoch seconds from a valid FHIR `instant`.
+ *
+ * A FHIR instant remains the authoritative ISO 8601 value with a timezone.
+ * Epoch seconds are a derived numeric representation and must never replace
+ * `Encounter.id`, `Encounter.identifier`, or the original clinical time.
+ */
+export declare function fhirInstantToEpochSeconds(instant: string): number;

package/dist/fhir-instant.js

@@ -0,0 +1,16 @@
+const FHIR_INSTANT_PATTERN = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
+/**
+ * Derives whole Unix epoch seconds from a valid FHIR `instant`.
+ *
+ * A FHIR instant remains the authoritative ISO 8601 value with a timezone.
+ * Epoch seconds are a derived numeric representation and must never replace
+ * `Encounter.id`, `Encounter.identifier`, or the original clinical time.
+ */
+export function fhirInstantToEpochSeconds(instant) {
+    if (!FHIR_INSTANT_PATTERN.test(instant))
+        throw new TypeError('fhir_instant_invalid');
+    const epochMilliseconds = Date.parse(instant);
+    if (!Number.isFinite(epochMilliseconds))
+        throw new TypeError('fhir_instant_invalid');
+    return Math.floor(epochMilliseconds / 1000);
+}

package/dist/index.d.ts

@@ -16,7 +16,6 @@ export * from './constants/index.js';
 export * from './clinical-terminology.js';
 export * from './care-emergency-alert.js';
 export * from './immunization-flat-claims.js';
-export * from './immunization-reminder-plan.js';
 export * from './builders/index.js';
 export * from './group-r5.js';
 export * from './research-study-r5.js';
@@ -25,5 +24,5 @@ export * from './related-person.js';
 export * from './imaging-types.js';
 export * from './subscription-r5.js';
 export * from './healthcare-service-specialty-map.js';
-export * from './appointment-communication-test-data.js';
-export * from './encounter-transfer-test-data.js';
+export * from './data/index.js';
+export * from './fhir-instant.js';

package/dist/index.js

@@ -16,7 +16,6 @@ export * from './constants/index.js';
 export * from './clinical-terminology.js';
 export * from './care-emergency-alert.js';
 export * from './immunization-flat-claims.js';
-export * from './immunization-reminder-plan.js';
 export * from './builders/index.js';
 export * from './group-r5.js';
 export * from './research-study-r5.js';
@@ -25,5 +24,5 @@ export * from './related-person.js';
 export * from './imaging-types.js';
 export * from './subscription-r5.js';
 export * from './healthcare-service-specialty-map.js';
-export * from './appointment-communication-test-data.js';
-export * from './encounter-transfer-test-data.js';
+export * from './data/index.js';
+export * from './fhir-instant.js';

package/docs/ENCOUNTER_IDENTIFIERS_AND_TIME.md

@@ -0,0 +1,19 @@
+# Encounter identifiers and time
+
+FHIR time and encounter identity are separate concepts.
+
+- A FHIR `instant` is an ISO 8601 date and time with at least second precision
+  and an explicit timezone. It is not a Unix timestamp.
+- Unix epoch seconds may be derived for sorting, interoperability or a
+  provider-owned business identifier, but they never replace the original
+  instant.
+- `Encounter.id` is the FHIR resource identifier.
+- `Encounter.identifier` contains the business identifiers assigned by the
+  care provider. Their namespace and uniqueness belong to the assigning
+  organization.
+- A display code is not sufficient authorization or subject resolution. An
+  authoritative lookup must also verify the assigner and exact subject.
+
+Reusable test data lives in `FHIR_ENCOUNTER_TRANSFER_TEST_DATA`. Tests and
+downstream documentation import its named fields instead of duplicating raw
+identifiers, timestamps or references.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-data-utils-ts",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "FHIR-version-neutral flat-claim and SearchParameter data utilities",
   "license": "Apache-2.0",
   "type": "module",
@@ -122,6 +122,10 @@
     "./constants": {
       "types": "./dist/constants/index.d.ts",
       "default": "./dist/constants/index.js"
+    },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "default": "./dist/data/index.js"
     }
   },
   "files": [
@@ -136,7 +140,7 @@
     "build": "npm run clean && tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test tests/*.test.mjs",
-    "test:coverage": "node --test --experimental-test-coverage --test-coverage-include='dist/converters/*.js' --test-coverage-include='dist/builders/*.js' --test-coverage-include='dist/fhir-*.js' --test-coverage-lines=95 --test-coverage-functions=80 --test-coverage-branches=40 tests/*.test.mjs",
+    "test:coverage": "node --test --experimental-test-coverage --test-coverage-include='dist/converters/*.js' --test-coverage-include='dist/builders/*.js' --test-coverage-include='dist/fhir-*.js' --test-coverage-exclude='dist/**/*.data.js' --test-coverage-lines=95 --test-coverage-functions=80 --test-coverage-branches=40 tests/*.test.mjs",
     "check": "npm run typecheck && npm test && npm run test:coverage",
     "prepack": "npm run check"
   },