gdc-common-utils-ts 2.3.11 → 2.3.13

package/README.md

@@ -40,18 +40,6 @@ Shared TypeScript utilities for GDC client and connector code. This package prov
 
 It is intentionally not a full backend orchestration layer.
 
-## Prior Work
-
-Part of the FHIR conversion layer in this repository builds on earlier work
-from the Universal Health Chain repository:
-
-- `uhc-fhir-utils-ts`
-- https://github.com/Universal-Health-Chain/uhc-fhir-utils-ts
-
-The current `src/convert` and `src/claims` layers adapt and extend that prior
-work to the claims-first contracts, IPS bundle workflows, and package
-boundaries used in `gdc-common-utils-ts`.
-
 ## Non-Negotiable Conventions
 
 - FHIR SearchParameter names must use canonical FHIR naming (lowercase, with `-` when defined by FHIR).

package/dist/constants/data-collections.d.ts

@@ -15,8 +15,10 @@ export declare const DataCollectionIds: Readonly<{
     readonly conditions: "conditions";
     readonly consents: "consents";
     readonly diagnosticReports: "diagnostic-reports";
+    readonly deviceUseStatements: "device-use-statements";
     readonly documentReferences: "document-references";
     readonly encounters: "encounters";
+    readonly flags: "flags";
     readonly imagingStudies: "imaging-studies";
     readonly immunizations: "immunizations";
     readonly medications: "medications";
@@ -43,7 +45,9 @@ export declare const FhirResourceTypeDataCollections: Readonly<{
     readonly Condition: "conditions";
     readonly Consent: "consents";
     readonly DiagnosticReport: "diagnostic-reports";
+    readonly DeviceUseStatement: "device-use-statements";
     readonly Encounter: "encounters";
+    readonly Flag: "flags";
     readonly ImagingStudy: "imaging-studies";
     readonly Immunization: "immunizations";
     readonly MedicationStatement: "medications";

package/dist/constants/data-collections.js

@@ -17,8 +17,10 @@ export const DataCollectionIds = Object.freeze({
     conditions: 'conditions',
     consents: 'consents',
     diagnosticReports: 'diagnostic-reports',
+    deviceUseStatements: 'device-use-statements',
     documentReferences: 'document-references',
     encounters: 'encounters',
+    flags: 'flags',
     imagingStudies: 'imaging-studies',
     immunizations: 'immunizations',
     medications: 'medications',
@@ -51,8 +53,8 @@ export const HealthcareSummarySectionDataCollections = Object.freeze({
     [HealthcareSummarySections.HistoryOfPastIllness.attributeValue]: Object.freeze([DataCollectionIds.conditions]),
     [HealthcareSummarySections.PregnancyHistory.attributeValue]: Object.freeze([DataCollectionIds.observations]),
     [HealthcareSummarySections.GoalsAndPreferences.attributeValue]: Object.freeze([DataCollectionIds.consents]),
-    [HealthcareSummarySections.Alert.attributeValue]: Object.freeze([]),
-    [HealthcareSummarySections.MedicalDevices.attributeValue]: Object.freeze([]),
+    [HealthcareSummarySections.Alert.attributeValue]: Object.freeze([DataCollectionIds.flags]),
+    [HealthcareSummarySections.MedicalDevices.attributeValue]: Object.freeze([DataCollectionIds.deviceUseStatements]),
 });
 /**
  * Canonical FHIR R4 resource family -> collection mapping for normalized
@@ -65,7 +67,9 @@ export const FhirResourceTypeDataCollections = Object.freeze({
     [ResourceTypesFhirR4.Condition]: DataCollectionIds.conditions,
     [ResourceTypesFhirR4.Consent]: DataCollectionIds.consents,
     [ResourceTypesFhirR4.DiagnosticReport]: DataCollectionIds.diagnosticReports,
+    [ResourceTypesFhirR4.DeviceUseStatement]: DataCollectionIds.deviceUseStatements,
     [ResourceTypesFhirR4.Encounter]: DataCollectionIds.encounters,
+    [ResourceTypesFhirR4.Flag]: DataCollectionIds.flags,
     [ResourceTypesFhirR4.ImagingStudy]: DataCollectionIds.imagingStudies,
     [ResourceTypesFhirR4.Immunization]: DataCollectionIds.immunizations,
     [ResourceTypesFhirR4.MedicationStatement]: DataCollectionIds.medications,

package/dist/convert/convert-device-use-statement.js

@@ -10,7 +10,12 @@ export function deviceUseStatementFlatToFhirR4(claims) {
         resourceType: 'DeviceUseStatement',
         identifier: claims[DeviceUseStatementClaim.Identifier] ? [{ value: claims[DeviceUseStatementClaim.Identifier] }] : undefined,
         subject: { reference: subject },
-        device: { reference: device },
+        device: {
+            reference: device,
+            ...(claims[DeviceUseStatementClaim.DeviceDisplay]
+                ? { display: claims[DeviceUseStatementClaim.DeviceDisplay] }
+                : {}),
+        },
         status,
         recordedOn: claims[DeviceUseStatementClaim.RecordedOn],
         timingDateTime: claims[DeviceUseStatementClaim.TimingDateTime],
@@ -21,6 +26,7 @@ export function deviceUseStatementFhirR4ToFlat(resource) {
         [DeviceUseStatementClaim.Identifier]: resource.identifier?.[0]?.value,
         [DeviceUseStatementClaim.Subject]: resource.subject?.reference,
         [DeviceUseStatementClaim.Device]: resource.device?.reference,
+        [DeviceUseStatementClaim.DeviceDisplay]: resource.device?.display,
         [DeviceUseStatementClaim.Status]: resource.status,
         [DeviceUseStatementClaim.RecordedOn]: resource.recordedOn,
         [DeviceUseStatementClaim.TimingDateTime]: resource.timingDateTime,

package/dist/examples/individual-controller.d.ts

@@ -3,7 +3,7 @@
  *
  * CORE canonical examples in this file avoid phone-specific subject/controller
  * fields unless the flow truly requires them. Telephone-driven notification or
- * consent targeting is treated as an extension concern (for example UNID GW),
+ * consent targeting is treated as an extension concern,
  * not a CORE GW contract requirement.
  *
  * Semantic split:

package/dist/models/device-license.d.ts

@@ -46,7 +46,7 @@ export interface DeviceLicense {
      * Organization that owns this seat pool.
      *
      * This is essential for hosted individual organizations because many
-     * households can share one UNID tenant vault. It is distinct from
+     * households can share one tenant vault. It is distinct from
      * `subjectId`, which identifies the member currently assigned to the seat.
      */
     ownerOrganizationId?: string;

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

@@ -5,7 +5,6 @@
  * This model aligns with FHIR R5 conventions (using `note.text` instead of `comment`)
  * for forward compatibility and consistency with other resources like Communication.
  *
- * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-ts/blob/main/src/models/templates/Appointment.template.model.ts
  */
 /**
  * Contains claims representing fields specific to the FHIR R4/R5 data model for an Appointment.

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

@@ -6,7 +6,6 @@
  * This model aligns with FHIR R5 conventions (using `note.text` instead of `comment`)
  * for forward compatibility and consistency with other resources like Communication.
  *
- * @basedon https://github.com/Universal-Health-Chain/uhc-fhir-utils-ts/blob/main/src/models/templates/Appointment.template.model.ts
  */
 /**
  * Contains claims representing fields specific to the FHIR R4/R5 data model for an Appointment.

package/dist/models/interoperable-claims/device-use-statement-claims.d.ts

@@ -4,6 +4,7 @@ export declare const DeviceUseStatementClaim: {
     readonly Subject: "DeviceUseStatement.subject";
     readonly Status: "DeviceUseStatement.status";
     readonly Device: "DeviceUseStatement.device";
+    readonly DeviceDisplay: "DeviceUseStatement.device-display";
     readonly RecordedOn: "DeviceUseStatement.recordedon";
     readonly TimingDateTime: "DeviceUseStatement.timing-datetime";
     readonly ReasonCode: "DeviceUseStatement.reasoncode";

package/dist/models/interoperable-claims/device-use-statement-claims.js

@@ -6,6 +6,7 @@ export const DeviceUseStatementClaim = {
     Subject: 'DeviceUseStatement.subject',
     Status: 'DeviceUseStatement.status',
     Device: 'DeviceUseStatement.device',
+    DeviceDisplay: 'DeviceUseStatement.device-display',
     RecordedOn: 'DeviceUseStatement.recordedon',
     TimingDateTime: 'DeviceUseStatement.timing-datetime',
     ReasonCode: 'DeviceUseStatement.reasoncode',
@@ -16,6 +17,7 @@ export const DeviceUseStatementClaimSpecs = [
     { key: DeviceUseStatementClaim.Subject, meaning: 'Patient subject reference.', example: 'Patient/pat-123' },
     { key: DeviceUseStatementClaim.Status, meaning: 'Use statement status.', example: 'active' },
     { key: DeviceUseStatementClaim.Device, meaning: 'Device reference.', example: 'Device/dev-777' },
+    { key: DeviceUseStatementClaim.DeviceDisplay, meaning: 'Human-readable device name accompanying the reference.', example: 'Hip prosthesis' },
     { key: DeviceUseStatementClaim.RecordedOn, meaning: 'Record creation date/time.', example: '2026-03-01T12:00:00Z' },
     { key: DeviceUseStatementClaim.TimingDateTime, meaning: 'When the use happened.', example: '2026-03-01T08:00:00Z' },
     { key: DeviceUseStatementClaim.ReasonCode, meaning: 'Reason code for use.', example: 'http://snomed.info/sct|182840001' },

package/dist/models/oidc4ida.evidence.model.d.ts

@@ -2,7 +2,7 @@ import { EvidenceDocumentDLT } from "./oidc4ida.document.model";
 import { EvidenceElectronicRecordDLT } from "./oidc4ida.electronicRecord.model";
 /** W3C Evidence for VCs can be generated by the API from some OpenID evidence stored on blockchain.
  *  See EBSI v2: https://ec.europa.eu/digital-building-blocks/wikis/display/EBSIDOC/Verifiable+Attestation
- *  - id: OPTIONAL. If present, it MUST contain a URL that points to where more information about this instance of evidence can be found (e.g.: urn:unid:uhc:vc:xyz or e.g.: "https://example.edu/evidence/f2aeec97-fc0d-42bf-8ca7-0548192dxyzab")
+ *  - id: OPTIONAL. If present, it MUST contain a URL that points to where more information about this instance of evidence can be found (e.g. `urn:example:vc:xyz`).
  *  - type: REQUIRED. Defines the evidence type, e.g.: ["DocumentVerification"], ["id_document"], ["utility_bill"], ["qes"]
  *  - verifier: REQUIRED. Defines entity that has verified documents before Verifiable Attestation issuance, e.g.: "https://example.edu/issuers/14"
  *  - evidenceDocument: REQUIRED. Defines document(s) which have been verified before Verifiable Attestation issuance, e.g.: "DriversLicense" (TODO: can be used HL7 instead?). QUESTION: Should it be the universal ID instead a description? RESPONSE: No, because it is linked to a credentialSubject within a credential

package/dist/storage/IVaultRepository.js

@@ -12,12 +12,12 @@
 export class IVaultRepository {
 }
 // ---------------------------------------------------------------------------
-// Server/multi-tenant extension — used by GW nodes (gdc-unid-node-ts, gwtemplate-node-ts)
+// Server/multi-tenant extension — used by GW node implementations.
 //
 // Adds multi-vault management, sections, history, and purge operations
 // needed by server-side vault repositories (Firestore, Postgres, Mem-backend).
 //
-// TODO: migrate gdc-unid-node-ts and gwtemplate-node-ts vault.repository.ts
+// TODO: migrate GW vault.repository.ts implementations
 //       to extend this interface once storage-sdk-firestore-ts and
 //       storage-sdk-postgres-ts are created as separate packages.
 // ---------------------------------------------------------------------------

package/dist/storage/VaultMemRepository.d.ts

@@ -8,7 +8,7 @@ import { IVaultRepository, VaultQuery } from './IVaultRepository';
  * - Short-lived runtime contexts (transient sessions)
  *
  * Each instance is independent — instantiate one per actor/session context
- * (e.g. one per CallSid in uhc-unid-chat-node) and discard on cleanup.
+ * (e.g. one per channel session) and discard on cleanup.
  *
  * TODO: For text channels with persistent sessions, use:
  *   - storage-sdk-firestore-ts → FirestoreVaultRepository (Google Cloud)

package/dist/storage/VaultMemRepository.js

@@ -9,7 +9,7 @@ import { IVaultRepository } from './IVaultRepository.js';
  * - Short-lived runtime contexts (transient sessions)
  *
  * Each instance is independent — instantiate one per actor/session context
- * (e.g. one per CallSid in uhc-unid-chat-node) and discard on cleanup.
+ * (e.g. one per channel session) and discard on cleanup.
  *
  * TODO: For text channels with persistent sessions, use:
  *   - storage-sdk-firestore-ts → FirestoreVaultRepository (Google Cloud)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.3.11",
+  "version": "2.3.13",
   "publishConfig": {
     "access": "public"
   },
@@ -22,8 +22,9 @@
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "npm run clean && tsc -p tsconfig.build.json && node patch-esm-imports.mjs",
     "verify:dist": "node scripts/verify-dist-syntax.mjs",
+    "check:product-neutrality": "node scripts/check-product-neutrality.mjs",
     "prepack": "npm run verify:dist",
-    "prepublishOnly": "npm run typecheck && npm test -- --watchman=false && npm run build"
+    "prepublishOnly": "npm run check:product-neutrality && npm run typecheck && npm test -- --watchman=false && npm run build"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",