fhir-data-utils-ts 0.6.19 → 0.6.21

package/.codex/skills/govern-fhir-data-utilities/SKILL.md

@@ -1,25 +1,23 @@
 ---
 name: govern-fhir-data-utilities
-description: Complete or audit migrations, claim catalogs, converters, builders, tests and releases in fhir-data-utils-ts. Use for shared FHIR types or utilities copied from frozen gdc-common-utils, former UHC utilities, SOS, Vet or UHC packages; raw flat-claim literals; duplicate root and family modules; Observation components; Immunization graphs; Group or ResearchStudy projections; package exports; coverage gates; or downstream promotion.
+description: Complete or audit migrations, claim catalogs, converters, builders, tests and releases in fhir-data-utils-ts. Use for shared FHIR types or utilities recovered from standards-based compatibility evidence; raw flat-claim literals; duplicate root and family modules; Observation components; Immunization graphs; Group or ResearchStudy projections; package exports; coverage gates; or downstream promotion.
 ---
 
 # Govern FHIR Data Utilities
 
 ## Keep ownership explicit
 
-1. Read `docs/UHC_FHIR_UTILS_MIGRATION.md` and inventory every relevant source
-   family before declaring a migration complete.
+1. Inventory every relevant standards-based source family before declaring a
+   migration complete.
 2. Treat `gdc-*` repositories as read-only evidence unless the user explicitly
    changes that scope. Never patch them as part of this migration.
 3. Keep neutral FHIR data semantics here. Keep HTTP, SMART, DIDComm, storage,
    authorization and product policy in their owning services or sector packages.
 4. Define every flat key once in its owning named catalog. Import that symbol in
    converters, builders, tests and examples; never repeat a claim-path literal.
-5. For SHC and DGC archaeology, treat `uhc-helpers-typescript` as the early
-   flow source, the later UHC common models/data/common/crypto split as the
-   preferred implementation evidence, and `gdc-common-utils-ts` as its later
-   consolidation. Do not copy an earlier helper when a later governed contract
-   exists.
+5. For SHC and DGC archaeology, prefer the latest governed standards-based
+   implementation evidence. Do not copy an earlier helper when a later
+   governed contract exists.
 
 ## Separate catalogs, adapters and builders
 
@@ -68,9 +66,8 @@ description: Complete or audit migrations, claim catalogs, converters, builders,
   subscriber persistence, authentication or product notification policy.
 - Validate and project the canonical outer `Bundle[type=batch]` ->
   `Communication` -> inner `Bundle[type=document|batch|collection]` structure
-  here, but keep the cross-product high-level editor/reader in `sos-sdk-core`
-  and its data contracts in `sos-data-utils`. Neither replacement package may
-  import frozen `gdc-*`. Arbitrary files are DocumentReference entries in the
+  here, but keep high-level editors/readers and application data contracts in
+  downstream libraries. Arbitrary files are DocumentReference entries in the
   inner Bundle, never a second direct Communication attachment. Direct
   flat-claim CRUD is an internal persistence boundary, not this wire format.
 - Keep ImagingStudy searchable metadata, clinical references and protected

package/.codex/skills/govern-fhir-observation-components/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: govern-fhir-observation-components
-description: Implement or audit neutral FHIR Observation claim catalogs, vital-sign terminology, parent-owned component graphs, reduced component indexes, historical array and bp aliases, and R4/R5 projection adapters. Use when changing Observation.component, blood pressure, assessment scales, device readings, flat claims, portal or assistant vital-sign builders, or migrating code from gdc-common-utils-ts or uhc-fhir-utils-typescript.
+description: Implement or audit neutral FHIR Observation claim catalogs, vital-sign terminology, parent-owned component graphs, reduced component indexes, historical array and bp aliases, and R4/R5 projection adapters. Use when changing Observation.component, blood pressure, assessment scales, device readings, flat claims, portal or assistant vital-sign builders, or migrating neutral compatibility code.
 ---
 
 # Govern FHIR Observation Components
@@ -9,12 +9,12 @@ description: Implement or audit neutral FHIR Observation claim catalogs, vital-s
 
 1. Treat native FHIR import/export as an adapter boundary. Keep flat claims as
    the version-neutral internal contract.
-2. Read `src/observation-claims.ts`, `src/vital-sign-observations.ts`, their
-   tests, and `docs/UHC_FHIR_UTILS_MIGRATION.md` before changing behavior.
-3. Treat every `gdc-*` repository and `uhc-fhir-utils-typescript` as read-only
-   compatibility evidence unless the user explicitly changes that scope.
-4. Keep product policies in SOS, Vet or UHC packages. This package owns only
-   neutral FHIR data semantics.
+2. Read `src/observation-claims.ts`, `src/vital-sign-observations.ts` and their
+   tests before changing behavior.
+3. Treat external compatibility repositories as read-only evidence unless the
+   user explicitly changes that scope.
+4. Keep product policies downstream. This package owns only neutral FHIR data
+   semantics.
 
 ## Preserve the component contract
 
@@ -79,15 +79,13 @@ description: Implement or audit neutral FHIR Observation claim catalogs, vital-s
 
 ## Audit migrations completely
 
-- Inventory the old UHC package, `gdc-common-utils-ts`, `sos-data-utils-ts`,
-  `vet-data-utils-ts`, and the UHC/Vet/SOS SDKs before calling a migration
-  complete.
+- Inventory the relevant standards-based source and compatibility evidence
+  before calling a migration complete.
 - Move only neutral FHIR data types, claim catalogs, conversion rules and pure
   helpers here. Keep transport clients and sector authorization/policy in
   their owning package.
-- Record every migrated, retired or intentionally retained family in
-  `docs/UHC_FHIR_UTILS_MIGRATION.md`; an unmentioned file is an incomplete
-  audit.
+- Record every migrated, retired or intentionally retained family in neutral
+  repository documentation; an unmentioned file is an incomplete audit.
 - Expose each supported family through a stable package subpath and prove the
   packed artifact, not only root source imports.
 

package/.codex/skills/preserve-fhir-flat-coding-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: preserve-fhir-flat-coding-review
-description: Preserve the neutral flat-claim contract for imported local clinical text, terminology proposals and confirmed codings. Use when changing DataConv, Vet or UHC ingestion, ResearchSubject batches, contained clinical resources, coding-review UI/API contracts, examples, fixtures or tests.
+description: Preserve the neutral flat-claim contract for imported local clinical text, terminology proposals and confirmed codings. Use when changing ingestion, ResearchSubject batches, contained clinical resources, coding-review UI/API contracts, examples, fixtures or tests.
 ---
 
 # Preserve FHIR Flat Coding Review
@@ -24,7 +24,7 @@ redeclare governed claim paths, code systems, UUIDs or example values.
   `userSelected` as a draft or promotion flag.
 - Group review UI with the package-owned clinical families: allergies and
   intolerances, procedures, diagnostics and immunizations. Do not duplicate
-  resource-type lists in Vet, UHC or DataConv consumers.
+  resource-type lists in downstream consumers.
 - A localized generated label may use a language-qualified `-text_<BCP47>`
   companion. It must not overwrite the imported local text before explicit
   review.
@@ -60,9 +60,9 @@ redeclare governed claim paths, code systems, UUIDs or example values.
 ## Boundaries
 
 - This is FHIR-neutral shared data behavior. It belongs in
-  `fhir-data-utils-ts`, not SOSChain, Vet, UHC or frozen `gdc-*` packages.
-- DataConv applies the contract during import. Vet and UHC consume the same
-  contract and may add sector policy without forking its claim shape.
+  `fhir-data-utils-ts`, not in downstream or frozen compatibility packages.
+- Importers and sector applications consume the same contract and may add
+  policy without forking its claim shape.
 - Do not put HTTP clients, gateway policy, product authorization or terminology
   catalogs in this package.
 - Tests and examples import package-owned fixtures/builders. Do not scatter raw

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## Unreleased
 
+- Re-establish the public repository from a clean source snapshot while
+  retaining this changelog as the package release record.
+
+## 0.6.21 - 2026-10-21
+
+- Add the shared CommunicationRequest form, flat-claim and materialization
+  fields needed for categorized public alerts, related attachments and bounded
+  occurrence periods without introducing a proprietary alert resource.
+
+## 0.6.20 - 2026-10-12
+
+- Export the deduplicated official LOINC Document Ontology subject-matter-
+  domain catalogue supplied from the LOINC Knowledge Base for human-health
+  selectors. Keep it explicitly separate from veterinary service types.
+
+## 0.6.19 - 2026-10-12
+
 - Add the official `HealthcareService.appointmentRequired` flat claim and
   R4/R5 materialization round trip. Availability remains authoritative in the
   associated Schedule and Slot resources and is not duplicated on the service.
@@ -50,8 +67,8 @@
 - Give every reusable IPS authoring schema canonical initial claims so portal
   components do not invent resource status defaults.
 
-- Recover the useful locale-aware intent of the historical UHC
-  internationalization helpers as strict FHIR temporal presentation tools.
+- Recover useful locale-aware behavior from historical compatibility helpers
+  as strict FHIR temporal presentation tools.
   Date-only values retain their calendar day, instants render with the user's
   locale and IANA time zone, editor date/time fields compose a canonical FHIR
   instant with optional seconds defaulted to `00`, and inclusive ranges treat
@@ -78,8 +95,8 @@
   document so portals can update the Composition without duplicating LOINC
   section codes.
 
-- Recover neutral SHC and EU DGC QR prefix classification from the later UHC
-  data-utility lineage, with exported repository-safe `*.data.ts` examples.
+- Recover neutral SHC and EU DGC QR prefix classification from compatibility
+  evidence, with exported repository-safe `*.data.ts` examples.
   Recognition explicitly provides no decoding, verification or authorization.
 
 - Export one repository-safe, telephone-free IPS demo document with all sixteen
@@ -91,8 +108,8 @@
   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.
+  claim remain deprecated compatibility only while consumers migrate;
+  downstream applications own channel choices and dispatch behavior.
 
 ## 0.6.2 - 2026-09-30
 
@@ -115,7 +132,7 @@
   the frozen shared implementation: outer batch Bundle, one FHIR Bundle
   attachment per Communication, and validated document/batch/collection inner
   Bundles. Reject direct clinical or binary Communication payloads while
-  leaving high-level mutable editors to `sos-sdk-core`.
+  leaving high-level mutable editors downstream.
 - Add a typed Appointment exchange projection that preserves start/end,
   participants, slots and supporting information while keeping an ICS calendar
   file as an independent DocumentReference flat-claim resource.
@@ -246,9 +263,9 @@
   modifying that frozen source repository.
 - Recover strict FHIR primitives, value/search/token utilities, Bundle readers,
   resource search/template types, terminology model types, RelatedPerson and
-  telecom helpers, and DICOMDIR structural types from the retired UHC package.
+  telecom helpers, and DICOMDIR structural types from compatibility evidence.
 - Move cross-sector terminology, Immunization graph/reminder, Group R5 and
-  ResearchStudy R5 contracts that existed only in SOS or Vet data packages.
+  ResearchStudy R5 contracts into their neutral standards-based owner.
 - Require component Observations to use independently indexable graph entries;
   deprecated JSON-array component claims remain read-only compatibility input.
 - Add stable package subpaths for every migrated contract family.
@@ -285,12 +302,12 @@
   JSON repeatable-component encoding, generic component index projection and
   explicit R4/R5 projection boundary. Historical component CSV and `bp-*`
   aliases remain read-only compatibility inputs.
-- Record the reuse/rewrite/retire audit of the original
-  `uhc-fhir-utils-typescript` architecture without adding its obsolete product,
-  transport, SHA-1, DICOM or build dependencies to the neutral package.
+- Record the reuse/rewrite/retire audit of historical compatibility utilities
+  without adding obsolete product, transport, SHA-1, DICOM or build
+  dependencies to the neutral package.
 - Add the neutral contained-resource coding-review contract: canonical imported
   `*-text`, resource-scoped `meta.codingProposals[]`, batch traversal, candidate
-  confirmation and reusable governed fixtures for DataConv, Vet and UHC.
+  confirmation and reusable governed fixtures for downstream consumers.
 - Add channel-neutral FHIR-like vital-sign Observation builders and lossless device-batch normalization while preserving device source without inventing professional attestation.
 - Introduce product-neutral flat-claim resource graphs, parent-owned
   `contained-reference-list`, narrative `language`/`xhtml`, and governed

package/README.md

@@ -2,26 +2,24 @@
 
 FHIR-neutral data contracts for flat claims, governed SearchParameter names,
 resource graphs and explicit R4/R5/R6 projection adapters. This package has no
-network clients and no dependency on GDC, SOS, Vet or UHC packages.
+network clients and no dependency on downstream product packages.
 
 Release order is local-first: local tarball consumers, complete local matrix,
 merge and push `main`, publish bottom-up, install exact registry versions, then
 staging. Never commit `file:`, Git or workspace dependencies.
 
-## Where this package sits
+## Public source history
 
-```text
-fhir-data-utils-ts
-  └─ FHIR SearchParameters, flat-claim graphs and R4/R5/R6 projection rules
-      ↓
-sos-data-utils-ts
-  └─ cross-sector clinical catalogs and shared SOS/Vet/UHC data contracts
-      ├─ vet-data-utils-ts: animal species and veterinary policy
-      └─ uhc-data-utils-ts: human-health policy
+The public repository begins from a clean 2026 source snapshot. The retained
+[`CHANGELOG.md`](CHANGELOG.md) records package releases without republishing
+the former Git push history.
 
-terminology-api-node-ts reads the neutral FHIR and shared SOS contracts.
-It never depends on Vet or UHC product packages.
-```
+## Ownership boundary
+
+This package owns only standards-based FHIR SearchParameters, flat-claim
+graphs, validation and explicit R4/R5/R6 projection rules. Sector terminology,
+product policy, transport, authorization, mutable editors, network clients and
+application workflows belong downstream and are deliberately unnamed here.
 
 FHIR resource graphs use independent entries. A parent links children only
 through `<ResourceType>.contained-reference-list`; children do not carry
@@ -48,8 +46,8 @@ Cross-participant data always uses an outer FHIR batch Bundle containing
 Communication entries. Each Communication carries exactly one
 `application/fhir+json` inner document, batch or collection Bundle; arbitrary
 files are DocumentReference resources inside that Bundle. This package owns
-strict parsing and projection tools; the shared high-level editor/reader belongs
-to `sos-sdk-core`, with cross-sector contracts in `sos-data-utils`. See
+strict parsing and projection tools; mutable editors, transport and
+cross-sector policy belong downstream. See
 [Communication Bundle contract](docs/COMMUNICATION_BUNDLE_CONTRACT.md).
 
 Reservable equipment remains a `Device` actor of its service-specific
@@ -70,10 +68,10 @@ The root export and stable subpaths provide:
 - complete flat-claim catalogs and claim helpers for the resource families
   formerly scattered through `gdc-common-utils-ts`;
 - explicit R4/R5 conversion adapters, including Consent and PractitionerRole;
-- the recovered UHC resource search/template types, terminology model types,
+- resource search/template types, terminology model types,
   RelatedPerson/telecom helpers and type-only DICOMDIR tree contract;
 - cross-sector terminology, Immunization graphs/reminders, and FHIR R5 Group
-  and ResearchStudy contracts previously located only in SOS or Vet packages.
+  and ResearchStudy contracts;
 - native FHIR R5 SubscriptionTopic/Subscription configuration builders,
   official search catalogs and a strict notification-Bundle parser; terminal
   asynchronous job messages remain claims-first Communication resources.
@@ -156,18 +154,13 @@ top-level Observations with a professional attester. Ledger hashing, index
 updates, Digital Twin and research eligibility remain owning-service policy.
 See [Daily vital-sign document lifecycle](docs/VITAL_SIGN_DAILY_DOCUMENT.md).
 
-See [the UHC FHIR utilities migration](docs/UHC_FHIR_UTILS_MIGRATION.md) for the
-reuse/rewrite/retire inventory and the rule for moving frozen contracts without
-changing any `gdc-*` repository.
-
 See [Clinical typed accessor boundary](docs/CLINICAL_TYPED_ACCESSOR_BOUNDARY.md)
 for the exact division between canonical clinical claims/converters here,
-shared SOS multichannel schemas and the mutable Bundle getters/setters exposed
-by runtime SDKs.
+downstream schemas and mutable Bundle getters/setters.
 
 ## Coding review for imported clinical text
 
-DataConv, Vet and UHC share one neutral review contract from
+Coding review uses one neutral contract from
 `fhir-data-utils-ts/coding-review-flat-claims`:
 
 - imported wording is the canonical `<ResourceType>.<code-field>-text` claim;
@@ -209,8 +202,7 @@ packed artifact and installs it in an isolated consumer before publication.
 
 ## Care, emergency and population-alert graphs
 
-The package provides the neutral FHIR foundation for the three SOSChain
-journeys proven first in VetChain/PetChain: Location-linked Encounter care
+The package provides the neutral FHIR foundation for Location-linked Encounter care
 journeys, emergency ServiceRequest plus triage Task, and cohort
 CommunicationRequest against a frozen Group snapshot. See
 [the contract guide](docs/CARE_EMERGENCY_ALERT_CONTRACTS.md). Product policy,

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

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

package/dist/builders/immunization-reminders.js

@@ -10,7 +10,7 @@ export const ImmunizationReminderTaskValues = Object.freeze({
 });
 /**
  * @deprecated Compatibility only. Notification-channel policy belongs to the
- * consuming SOS/Vet/UHC data package, not to the general FHIR data package.
+ * consuming downstream package, not to the general FHIR data package.
  */
 export const ImmunizationReminderChannels = Object.freeze([
     'push',

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

@@ -20,6 +20,8 @@ export declare const CommunicationRequestClaim: Readonly<{
     readonly InformationProvider: "CommunicationRequest.information-provider";
     readonly AuthoredOn: "CommunicationRequest.authored-on";
     readonly Occurrence: "CommunicationRequest.occurrence";
+    readonly OccurrencePeriodStart: "CommunicationRequest.occurrence-period-start";
+    readonly OccurrencePeriodEnd: "CommunicationRequest.occurrence-period-end";
     readonly ReasonCode: "CommunicationRequest.reason-code";
     readonly ReasonReference: "CommunicationRequest.reason-reference";
     readonly PayloadContent: "CommunicationRequest.payload-content";

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

@@ -19,6 +19,8 @@ export const CommunicationRequestClaim = Object.freeze({
     InformationProvider: 'CommunicationRequest.information-provider',
     AuthoredOn: 'CommunicationRequest.authored-on',
     Occurrence: 'CommunicationRequest.occurrence',
+    OccurrencePeriodStart: 'CommunicationRequest.occurrence-period-start',
+    OccurrencePeriodEnd: 'CommunicationRequest.occurrence-period-end',
     ReasonCode: 'CommunicationRequest.reason-code',
     ReasonReference: 'CommunicationRequest.reason-reference',
     PayloadContent: 'CommunicationRequest.payload-content',
@@ -48,6 +50,8 @@ export const CommunicationRequestClaimSpecs = Object.freeze([
     { 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.OccurrencePeriodStart, meaning: 'Start of the requested delivery period.', example: '2026-09-26T11:30:00Z' },
+    { key: CommunicationRequestClaim.OccurrencePeriodEnd, meaning: 'End of the requested delivery period.', example: '2026-09-27T11: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.' },

package/dist/clinical-terminology.d.ts

@@ -18,7 +18,7 @@ export declare const ClinicalTerminologySourceScopes: Readonly<{
     readonly AtcVet: "ATCVET";
 }>;
 export type ClinicalTerminologySourceScope = typeof ClinicalTerminologySourceScopes[keyof typeof ClinicalTerminologySourceScopes];
-/** Product-neutral terminology candidate returned to SOS, Vet or UHC channels. */
+/** Product-neutral terminology candidate returned to downstream channels. */
 export type ClinicalTerminologyCandidate = Readonly<{
     /** Governed source-scope identifier returned by the deployment capability. */
     source: string;

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

@@ -18,7 +18,7 @@ export function communicationRequestFlatToFhirR4(claims) {
         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],
+        ...occurrenceToFhir(claims),
         reasonCode: claims[CommunicationRequestClaim.ReasonCode] ? [{ coding: codingListFromCsv(claims[CommunicationRequestClaim.ReasonCode]) }] : undefined,
         reasonReference: referenceCsv(claims[CommunicationRequestClaim.ReasonReference]),
         payload: payloadR4(claims),
@@ -44,7 +44,8 @@ export function communicationRequestFhirR4ToFlat(resource) {
         [CommunicationRequestClaim.Requester]: referenceToValue(resource.requester),
         [CommunicationRequestClaim.InformationProvider]: referenceToValue(resource.sender),
         [CommunicationRequestClaim.Recipient]: referenceListToCsv(resource.recipient),
-        [CommunicationRequestClaim.AuthoredOn]: resource.authoredOn, [CommunicationRequestClaim.Occurrence]: resource.occurrenceDateTime,
+        [CommunicationRequestClaim.AuthoredOn]: resource.authoredOn,
+        ...occurrenceToFlat(resource),
         [CommunicationRequestClaim.ReasonCode]: codingListToCsv(resource.reasonCode?.flatMap(value => value.coding ?? [])),
         [CommunicationRequestClaim.ReasonReference]: referenceListToCsv(resource.reasonReference),
         ...payloadToFlat(resource),
@@ -82,7 +83,7 @@ function communicationRequestFlatToFhirR5Resource(claims) {
         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],
+        authoredOn: claims[CommunicationRequestClaim.AuthoredOn], ...occurrenceToFhir(claims),
         reason: reasonsR5(claims), payload: payloadR5(claims), note: annotation(claims[CommunicationRequestClaim.Note]),
     };
 }
@@ -107,7 +108,7 @@ function communicationRequestFhirR5ResourceToFlat(resource) {
         [CommunicationRequestClaim.Recipient]: referenceListToCsv(resource.recipient),
         [CommunicationRequestClaim.InformationProvider]: referenceListToCsv(resource.informationProvider),
         [CommunicationRequestClaim.AuthoredOn]: resource.authoredOn,
-        [CommunicationRequestClaim.Occurrence]: resource.occurrenceDateTime,
+        ...occurrenceToFlat(resource),
         [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),
@@ -134,6 +135,24 @@ function optionalBoolean(value) {
 }
 function annotation(value) { return value ? [{ text: value }] : undefined; }
 function annotationText(value) { return value?.[0]?.text; }
+function occurrenceToFhir(claims) {
+    const occurrenceDateTime = claims[CommunicationRequestClaim.Occurrence];
+    const start = claims[CommunicationRequestClaim.OccurrencePeriodStart];
+    const end = claims[CommunicationRequestClaim.OccurrencePeriodEnd];
+    if (occurrenceDateTime && (start || end))
+        throw new TypeError('communication_request_occurrence_choice_invalid');
+    return occurrenceDateTime ? { occurrenceDateTime } : start || end ? { occurrencePeriod: compact({ start, end }) } : {};
+}
+function occurrenceToFlat(resource) {
+    const period = resource.occurrencePeriod;
+    if (resource.occurrenceDateTime && period)
+        throw new TypeError('communication_request_occurrence_choice_invalid');
+    return compact({
+        [CommunicationRequestClaim.Occurrence]: resource.occurrenceDateTime,
+        [CommunicationRequestClaim.OccurrencePeriodStart]: period?.start,
+        [CommunicationRequestClaim.OccurrencePeriodEnd]: period?.end,
+    });
+}
 function payloadR4(claims) {
     if (claims[CommunicationRequestClaim.PayloadReference])
         return [{ contentReference: { reference: claims[CommunicationRequestClaim.PayloadReference] } }];

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

@@ -7,13 +7,17 @@ export type CommunicationRequestFormData = Readonly<{
     status: typeof CommunicationRequestStatuses[number];
     intent: typeof CommunicationRequestIntents[number];
     priority?: typeof CommunicationRequestPriorities[number];
+    category?: string;
     subject: string;
+    about?: readonly string[];
     encounter?: string;
     requester: string;
     recipients: readonly string[];
     informationProviders?: readonly string[];
     authoredOn?: string;
     occurrence?: string;
+    occurrencePeriodStart?: string;
+    occurrencePeriodEnd?: string;
     payloadReference?: string;
     payloadAttachmentContentType?: string;
     payloadAttachmentData?: string;
@@ -45,10 +49,22 @@ export declare const FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA: Readonly<{
             type: "string";
             enum: readonly ["routine", "urgent", "asap", "stat"];
         }>;
+        category: Readonly<{
+            type: "string";
+            pattern: "^https?://[^|,]+\\|[^|,]+$";
+        }>;
         subject: Readonly<{
             type: "string";
             pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";
         }>;
+        about: Readonly<{
+            type: "array";
+            uniqueItems: true;
+            items: 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}$";
@@ -82,6 +98,14 @@ export declare const FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA: Readonly<{
             type: "string";
             format: "date-time";
         }>;
+        occurrencePeriodStart: Readonly<{
+            type: "string";
+            format: "date-time";
+        }>;
+        occurrencePeriodEnd: Readonly<{
+            type: "string";
+            format: "date-time";
+        }>;
         payloadReference: Readonly<{
             type: "string";
             pattern: "^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$";

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

@@ -20,10 +20,14 @@ export const FHIR_COMMUNICATION_REQUEST_FORM_SCHEMA = Object.freeze({
         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(),
+        category: codingSchema(),
+        subject: referenceSchema(),
+        about: Object.freeze({ type: 'array', uniqueItems: true, items: 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(),
+        authoredOn: dateTimeSchema(), occurrence: dateTimeSchema(),
+        occurrencePeriodStart: dateTimeSchema(), occurrencePeriodEnd: 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 }),
@@ -38,21 +42,34 @@ export function communicationRequestFormDataToFlatClaims(input) {
     const recipients = references(input.recipients, 'communication_request_recipient_required');
     const providers = input.informationProviders?.length
         ? references(input.informationProviders, 'communication_request_information_provider_invalid') : undefined;
+    const about = input.about?.length ? references(input.about, 'communication_request_about_invalid') : undefined;
     if (input.payloadAttachmentData && !input.payloadAttachmentContentType) {
         throw new TypeError('communication_request_attachment_content_type_required');
     }
+    const occurrence = dateTime(input.occurrence);
+    const occurrencePeriodStart = dateTime(input.occurrencePeriodStart);
+    const occurrencePeriodEnd = dateTime(input.occurrencePeriodEnd);
+    if (occurrence && (occurrencePeriodStart || occurrencePeriodEnd))
+        throw new TypeError('communication_request_occurrence_choice_invalid');
+    if (occurrencePeriodStart && occurrencePeriodEnd && Date.parse(occurrencePeriodEnd) <= Date.parse(occurrencePeriodStart)) {
+        throw new TypeError('communication_request_occurrence_period_invalid');
+    }
     return compact({
         [CommunicationRequestClaim.Identifier]: optional(input.identifier),
         [CommunicationRequestClaim.Status]: input.status,
         [CommunicationRequestClaim.Intent]: input.intent,
         [CommunicationRequestClaim.Priority]: optional(input.priority),
+        [CommunicationRequestClaim.Category]: coding(input.category),
         [CommunicationRequestClaim.Subject]: reference(input.subject, 'communication_request_subject_invalid'),
+        [CommunicationRequestClaim.About]: about?.join(','),
         [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.Occurrence]: occurrence,
+        [CommunicationRequestClaim.OccurrencePeriodStart]: occurrencePeriodStart,
+        [CommunicationRequestClaim.OccurrencePeriodEnd]: occurrencePeriodEnd,
         [CommunicationRequestClaim.PayloadReference]: input.payloadReference ? reference(input.payloadReference, 'communication_request_payload_reference_invalid') : undefined,
         [CommunicationRequestClaim.PayloadAttachmentContentType]: optional(input.payloadAttachmentContentType),
         [CommunicationRequestClaim.PayloadAttachmentData]: optional(input.payloadAttachmentData),
@@ -64,10 +81,14 @@ 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],
+        category: claims[CommunicationRequestClaim.Category],
+        subject: claims[CommunicationRequestClaim.Subject], about: splitOptional(claims[CommunicationRequestClaim.About]),
+        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],
+        occurrencePeriodStart: claims[CommunicationRequestClaim.OccurrencePeriodStart],
+        occurrencePeriodEnd: claims[CommunicationRequestClaim.OccurrencePeriodEnd],
         payloadReference: claims[CommunicationRequestClaim.PayloadReference],
         payloadAttachmentContentType: claims[CommunicationRequestClaim.PayloadAttachmentContentType],
         payloadAttachmentData: claims[CommunicationRequestClaim.PayloadAttachmentData],
@@ -75,12 +96,15 @@ export function communicationRequestFlatClaimsToFormData(claims) {
     });
 }
 function referenceSchema() { return Object.freeze({ type: 'string', pattern: '^[A-Za-z][A-Za-z0-9]+/[A-Za-z0-9.-]{1,64}$' }); }
+function codingSchema() { return Object.freeze({ type: 'string', pattern: '^https?://[^|,]+\\|[^|,]+$' }); }
 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 coding(value) { const text = optional(value); if (text && !/^https?:\/\/[^|,]+\|[^|,]+$/u.test(text))
+    throw new TypeError('communication_request_category_invalid'); 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; }

package/dist/data/index.d.ts

@@ -6,3 +6,4 @@ 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';
+export * from './loinc-subject-matter-domain.data.js';

package/dist/data/index.js

@@ -6,3 +6,4 @@ 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';
+export * from './loinc-subject-matter-domain.data.js';