gdc-common-utils-ts 2.0.12 → 2.0.14

package/README.md

@@ -601,15 +601,19 @@ These helpers are the shared base for consent claim construction across GW and S
 
 ### Interfaces
 
-The `interfaces` export contains the shared type contracts and cryptography types, including:
+The `interfaces` export contains the shared low-level type contracts and cryptography types, including:
 
 - `ICryptography`
 - `ICryptoHelper`
-- `IWallet`
 - `Cryptography.types`
 - `MlDsa`
 - `MlKem`
 
+Wallet contracts and runtime adapters live in higher layers:
+
+- `gdc-sdk-core-ts` owns the runtime-neutral `IWallet` contract
+- `gdc-sdk-node-ts` owns concrete Node wallet/runtime adapters
+
 Example:
 
 ```ts

package/dist/examples/employee.d.ts

@@ -2,11 +2,16 @@
  * Canonical employee directory fixture shared by docs and tests.
  *
  * Semantics:
- * - `identifier` points to one technical employee profile
+ * - `resourceId` is the current internal GW profile id
+ * - `resourceId` is a transport/runtime locator and should remain one
+ *   `urn:uuid:*` technical anchor
+ * - `identifier` is the exportable/interoperable employee identity and may be
+ *   public, DID-based, or another stable external identifier
  * - `email` can map to multiple active roles
  * - a purged profile remains historically addressable by `identifier`
  */
 export type ExampleEmployeeRecord = Readonly<{
+    resourceId: string;
     identifier: string;
     email: string;
     role: string;
@@ -23,16 +28,19 @@ export declare const EXAMPLE_EMPLOYEE_CONTROLLER_ACTIVE: ExampleEmployeeRecord;
 export declare const EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE: ExampleEmployeeRecord;
 export declare const EXAMPLE_EMPLOYEE_DOCTOR_PURGED_HISTORICAL: ExampleEmployeeRecord;
 export declare const EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS: readonly [Readonly<{
+    resourceId: string;
     identifier: string;
     email: string;
     role: string;
     status: "active" | "inactive" | "purged";
 }>, Readonly<{
+    resourceId: string;
     identifier: string;
     email: string;
     role: string;
     status: "active" | "inactive" | "purged";
 }>, Readonly<{
+    resourceId: string;
     identifier: string;
     email: string;
     role: string;

package/dist/examples/employee.js

@@ -7,19 +7,22 @@ export const ExampleEmployeeRoles = Object.freeze({
     Doctor: 'ISCO-08|2211',
 });
 export const EXAMPLE_EMPLOYEE_CONTROLLER_ACTIVE = Object.freeze({
-    identifier: 'urn:uuid:employee-controller-active-001',
+    resourceId: 'urn:uuid:11111111-1111-4111-8111-111111111111',
+    identifier: 'did:web:api.example.org:employee:shared.professional@example.org:ISCO-08|1120',
     email: ExampleEmployeeEmails.SharedProfessional,
     role: ExampleEmployeeRoles.Controller,
     status: 'active',
 });
 export const EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE = Object.freeze({
-    identifier: 'urn:uuid:employee-doctor-active-001',
+    resourceId: 'urn:uuid:22222222-2222-4222-8222-222222222222',
+    identifier: 'did:web:api.example.org:employee:shared.professional@example.org:ISCO-08|2211',
     email: ExampleEmployeeEmails.SharedProfessional,
     role: ExampleEmployeeRoles.Doctor,
     status: 'active',
 });
 export const EXAMPLE_EMPLOYEE_DOCTOR_PURGED_HISTORICAL = Object.freeze({
-    identifier: 'urn:uuid:employee-doctor-purged-000',
+    resourceId: 'urn:uuid:33333333-3333-4333-8333-333333333333',
+    identifier: 'did:web:api.example.org:employee:shared.professional@example.org:ISCO-08|2211:historical:000',
     email: ExampleEmployeeEmails.SharedProfessional,
     role: ExampleEmployeeRoles.Doctor,
     status: 'purged',
@@ -45,7 +48,7 @@ export function buildExampleEmployeeClaims(record) {
  */
 export const EXAMPLE_EMPLOYEE_SEARCH_RESPONSE_BODY = Object.freeze({
     data: EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS.map((record) => ({
-        id: record.identifier,
+        id: record.resourceId,
         meta: {
             status: record.status,
             claims: buildExampleEmployeeClaims(record),

package/dist/examples/shared.d.ts

@@ -105,7 +105,7 @@ export declare const EXAMPLE_CONTROLLER_EMAIL: "controller@acme.org";
 export declare const EXAMPLE_CONTROLLER_SAME_AS: "mailto:controller@acme.org";
 export declare const EXAMPLE_API_ORGANIZATION_DID: "did:web:api.acme.org";
 export declare const EXAMPLE_SERVICE_PUBLIC_DID: "did:web:public.acme.org";
-export declare const EXAMPLE_PROFESSIONAL_DID: "did:web:api.acme.org:professional:1";
+export declare const EXAMPLE_PROFESSIONAL_DID: string;
 export declare const EXAMPLE_PROVIDER_ORGANIZATION_DID: "did:web:hospital.acme.org";
 export declare const EXAMPLE_PROVIDER_ORGANIZATION_URL: "https://hospital.acme.org";
 export declare const EXAMPLE_GATEWAY_PUBLIC_ORIGIN: "https://gateway.example.com";

package/dist/examples/shared.js

@@ -11,7 +11,7 @@ import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurpose
 import { CommunicationCategoryCodes } from '../constants/communication.js';
 import { LOINC_SYSTEM_URL } from '../models/clinical-sections.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
-import { buildHostedProviderDidWeb, buildIndividualDidWeb, buildIndividualMemberDidWeb, buildProviderSectorDidWeb, } from '../utils/did.js';
+import { buildHostedProviderDidWeb, buildIndividualDidWeb, buildIndividualMemberDidWeb, buildProfessionalDidWeb, buildProviderSectorDidWeb, } from '../utils/did.js';
 import { encodeHexToMultibase58btc } from '../utils/multibase58.js';
 import { MedicationStatementClaim, MedicationStatementClaimsFhirApiExtended, } from '../models/interoperable-claims/medication-statement-claims.js';
 import { medicationStatementFlatToFhirR4 } from '../utils/clinical-resource-converters.js';
@@ -120,7 +120,11 @@ export const EXAMPLE_CONTROLLER_EMAIL = EXAMPLE_EMAIL_CONTROLLER_ORG;
 export const EXAMPLE_CONTROLLER_SAME_AS = `mailto:${EXAMPLE_CONTROLLER_EMAIL}`;
 export const EXAMPLE_API_ORGANIZATION_DID = 'did:web:api.acme.org';
 export const EXAMPLE_SERVICE_PUBLIC_DID = 'did:web:public.acme.org';
-export const EXAMPLE_PROFESSIONAL_DID = 'did:web:api.acme.org:professional:1';
+export const EXAMPLE_PROFESSIONAL_DID = buildProfessionalDidWeb({
+    organizationDidWeb: 'did:web:api.acme.org',
+    email: 'doctor.oncall@example.org',
+    role: HealthcareActorRoles.Physician,
+});
 export const EXAMPLE_PROVIDER_ORGANIZATION_DID = 'did:web:hospital.acme.org';
 export const EXAMPLE_PROVIDER_ORGANIZATION_URL = 'https://hospital.acme.org';
 export const EXAMPLE_GATEWAY_PUBLIC_ORIGIN = 'https://gateway.example.com';

package/dist/utils/actor.d.ts

@@ -2,13 +2,15 @@ export type ParsedActor = {
     /**
      * The token subject / authenticated actor identifier (as provided in the token request).
      * Examples:
+     * - did:web:api.acme.org:employee:z6MksExampleHashedEmployeeId:ISCO-08|2211
+     * - did:web:api.acme.org:employee:z6MksExampleHashedEmployeeId:ISCO-08|2211:<device-uuid>
      * - did:web:api.acme.org:employee:doctor1@acme.org:ISCO-08|2211
      * - did:web:api.acme.org:employee:doctor1@acme.org:ISCO-08|2211:<device-uuid>
      * - did:web:api.acme.org:family:<id>:v3-RoleCode|ONESELF
      * - did:web:api.acme.org:family:<id>:v3-RoleCode|CHILD:<device-uuid>
      */
     sub: string;
-    /** The actor identifier (employee email, familyId, or raw email). */
+    /** The actor identifier (employee hashed-id/email token, familyId, or raw email). */
     identifier?: string;
     /** The employee role code if present (e.g. "ISCO-08|2211"). */
     role?: string;

package/dist/utils/medication-claim-helpers.d.ts

@@ -1,88 +1,8 @@
-import { type GenericInteroperableClaims } from './claim-list-helpers.js';
-export type MedicationInteroperableClaims = GenericInteroperableClaims;
-export declare function getMedicationIdentifier(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationIdentifier(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationSubject(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationSubject(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationStatus(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationStatus(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationEffective(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationEffective(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationText(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationText(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationDoseQuantityValue(claims: MedicationInteroperableClaims): number | undefined;
-export declare function setMedicationDoseQuantityValue(claims: MedicationInteroperableClaims, value: number): MedicationInteroperableClaims;
-export declare function getMedicationDoseQuantityUnit(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationDoseQuantityUnit(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationTimingFrequency(claims: MedicationInteroperableClaims): number | undefined;
-export declare function setMedicationTimingFrequency(claims: MedicationInteroperableClaims, value: number): MedicationInteroperableClaims;
-export declare function getMedicationTimingPeriod(claims: MedicationInteroperableClaims): number | undefined;
-export declare function setMedicationTimingPeriod(claims: MedicationInteroperableClaims, value: number): MedicationInteroperableClaims;
-export declare function getMedicationTimingPeriodUnit(claims: MedicationInteroperableClaims): string;
-export declare function setMedicationTimingPeriodUnit(claims: MedicationInteroperableClaims, value: string): MedicationInteroperableClaims;
-export declare function getMedicationDosageAsNeeded(claims: MedicationInteroperableClaims): boolean | undefined;
-export declare function setMedicationDosageAsNeeded(claims: MedicationInteroperableClaims, value: boolean): MedicationInteroperableClaims;
 /**
- * Returns tokenized values from a medication claim key stored as CSV.
- */
-export declare function getMedicationClaimList(claims: MedicationInteroperableClaims, claimKey: string): string[];
-/**
- * Replaces a medication claim list from array/string input and stores canonical CSV.
- */
-export declare function setMedicationClaimList(claims: MedicationInteroperableClaims, claimKey: string, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Adds values to a medication claim list preserving uniqueness.
- */
-export declare function addMedicationClaimList(claims: MedicationInteroperableClaims, claimKey: string, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Removes values from a medication claim list while preserving uniqueness.
- */
-export declare function removeMedicationClaimList(claims: MedicationInteroperableClaims, claimKey: string, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Medication category list getter/setter/add.
- */
-export declare function getMedicationCategoryList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationCategoryList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationCategoryList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationCategoryList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Medication part-of list getter/setter/add.
- */
-export declare function getMedicationPartOfList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationPartOfList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationPartOfList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationPartOfList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Medication code list getter/setter/add.
+ * Compatibility re-export for the historical medication claim-helper subpath.
  *
- * Note:
- * - many flows use a single code, but CSV list is supported for UI preview/edit
- *   where multiple coded values can be staged before normalization.
- */
-export declare function getMedicationCodeList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationCodeList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationCodeList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationCodeList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Medication source list getter/setter/add.
- */
-export declare function getMedicationSourceList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationSourceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationSourceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationSourceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Medication subject list getter/setter/add.
- */
-export declare function getMedicationSubjectList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationSubjectList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationSubjectList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationSubjectList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-/**
- * Linked DocumentReference identifiers associated to the medication statement.
- * Canonical claim key: `MedicationStatement.contained-documents`.
- * Legacy alias accepted on read: `MedicationStatement.attachment-content-ids`.
+ * `gdc-sdk-core-ts` and older consumers still import
+ * `gdc-common-utils-ts/utils/medication-claim-helpers`, while the canonical
+ * implementation file is `claims-helpers-medication-statement`.
  */
-export declare function getMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims): string[];
-export declare function setMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function addMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
-export declare function removeMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+export * from './claims-helpers-medication-statement';

package/dist/utils/medication-claim-helpers.js

@@ -1,259 +1,9 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-import { MedicationStatementClaim, MedicationStatementClaimsFhirApiExtended, } from '../models/interoperable-claims/medication-statement-claims.js';
-import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
-export function getMedicationIdentifier(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaim.Identifier);
-}
-export function setMedicationIdentifier(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaim.Identifier, value);
-}
-export function getMedicationSubject(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaim.Subject);
-}
-export function setMedicationSubject(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaim.Subject, value);
-}
-export function getMedicationStatus(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaim.Status);
-}
-export function setMedicationStatus(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaim.Status, value);
-}
-export function getMedicationEffective(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaim.Effective);
-}
-export function setMedicationEffective(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaim.Effective, value);
-}
-export function getMedicationText(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaim.MedicationText);
-}
-export function setMedicationText(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaim.MedicationText, value);
-}
-export function getMedicationDoseQuantityValue(claims) {
-    return getMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.DoseQuantityValue);
-}
-export function setMedicationDoseQuantityValue(claims, value) {
-    return setMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.DoseQuantityValue, value);
-}
-export function getMedicationDoseQuantityUnit(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaimsFhirApiExtended.DoseQuantityUnit);
-}
-export function setMedicationDoseQuantityUnit(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaimsFhirApiExtended.DoseQuantityUnit, value);
-}
-export function getMedicationTimingFrequency(claims) {
-    return getMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.TimingFrequency);
-}
-export function setMedicationTimingFrequency(claims, value) {
-    return setMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.TimingFrequency, value);
-}
-export function getMedicationTimingPeriod(claims) {
-    return getMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.TimingPeriod);
-}
-export function setMedicationTimingPeriod(claims, value) {
-    return setMedicationNumber(claims, MedicationStatementClaimsFhirApiExtended.TimingPeriod, value);
-}
-export function getMedicationTimingPeriodUnit(claims) {
-    return getMedicationScalar(claims, MedicationStatementClaimsFhirApiExtended.TimingPeriodUnit);
-}
-export function setMedicationTimingPeriodUnit(claims, value) {
-    return setMedicationScalar(claims, MedicationStatementClaimsFhirApiExtended.TimingPeriodUnit, value);
-}
-export function getMedicationDosageAsNeeded(claims) {
-    return getMedicationBoolean(claims, MedicationStatementClaimsFhirApiExtended.DosageAsNeeded);
-}
-export function setMedicationDosageAsNeeded(claims, value) {
-    return setMedicationBoolean(claims, MedicationStatementClaimsFhirApiExtended.DosageAsNeeded, value);
-}
 /**
- * Returns tokenized values from a medication claim key stored as CSV.
- */
-export function getMedicationClaimList(claims, claimKey) {
-    return getClaimValues(claims, claimKey);
-}
-/**
- * Replaces a medication claim list from array/string input and stores canonical CSV.
- */
-export function setMedicationClaimList(claims, claimKey, values) {
-    return setClaimValues(claims, claimKey, values);
-}
-/**
- * Adds values to a medication claim list preserving uniqueness.
- */
-export function addMedicationClaimList(claims, claimKey, values) {
-    return addClaimValues(claims, claimKey, values);
-}
-/**
- * Removes values from a medication claim list while preserving uniqueness.
- */
-export function removeMedicationClaimList(claims, claimKey, values) {
-    return removeClaimValues(claims, claimKey, values);
-}
-/**
- * Medication category list getter/setter/add.
- */
-export function getMedicationCategoryList(claims) {
-    return getMedicationClaimList(claims, MedicationStatementClaim.Category);
-}
-export function setMedicationCategoryList(claims, values) {
-    return setMedicationClaimList(claims, MedicationStatementClaim.Category, values);
-}
-export function addMedicationCategoryList(claims, values) {
-    return addMedicationClaimList(claims, MedicationStatementClaim.Category, values);
-}
-export function removeMedicationCategoryList(claims, values) {
-    return removeMedicationClaimList(claims, MedicationStatementClaim.Category, values);
-}
-/**
- * Medication part-of list getter/setter/add.
- */
-export function getMedicationPartOfList(claims) {
-    return getMedicationClaimList(claims, MedicationStatementClaim.PartOf);
-}
-export function setMedicationPartOfList(claims, values) {
-    return setMedicationClaimList(claims, MedicationStatementClaim.PartOf, values);
-}
-export function addMedicationPartOfList(claims, values) {
-    return addMedicationClaimList(claims, MedicationStatementClaim.PartOf, values);
-}
-export function removeMedicationPartOfList(claims, values) {
-    return removeMedicationClaimList(claims, MedicationStatementClaim.PartOf, values);
-}
-/**
- * Medication code list getter/setter/add.
+ * Compatibility re-export for the historical medication claim-helper subpath.
  *
- * Note:
- * - many flows use a single code, but CSV list is supported for UI preview/edit
- *   where multiple coded values can be staged before normalization.
- */
-export function getMedicationCodeList(claims) {
-    return getMedicationClaimList(claims, MedicationStatementClaim.Code);
-}
-export function setMedicationCodeList(claims, values) {
-    return setMedicationClaimList(claims, MedicationStatementClaim.Code, values);
-}
-export function addMedicationCodeList(claims, values) {
-    return addMedicationClaimList(claims, MedicationStatementClaim.Code, values);
-}
-export function removeMedicationCodeList(claims, values) {
-    return removeMedicationClaimList(claims, MedicationStatementClaim.Code, values);
-}
-/**
- * Medication source list getter/setter/add.
- */
-export function getMedicationSourceList(claims) {
-    return getMedicationClaimList(claims, MedicationStatementClaim.Source);
-}
-export function setMedicationSourceList(claims, values) {
-    return setMedicationClaimList(claims, MedicationStatementClaim.Source, values);
-}
-export function addMedicationSourceList(claims, values) {
-    return addMedicationClaimList(claims, MedicationStatementClaim.Source, values);
-}
-export function removeMedicationSourceList(claims, values) {
-    return removeMedicationClaimList(claims, MedicationStatementClaim.Source, values);
-}
-/**
- * Medication subject list getter/setter/add.
- */
-export function getMedicationSubjectList(claims) {
-    return getMedicationClaimList(claims, MedicationStatementClaim.Subject);
-}
-export function setMedicationSubjectList(claims, values) {
-    return setMedicationClaimList(claims, MedicationStatementClaim.Subject, values);
-}
-export function addMedicationSubjectList(claims, values) {
-    return addMedicationClaimList(claims, MedicationStatementClaim.Subject, values);
-}
-export function removeMedicationSubjectList(claims, values) {
-    return removeMedicationClaimList(claims, MedicationStatementClaim.Subject, values);
-}
-/**
- * Linked DocumentReference identifiers associated to the medication statement.
- * Canonical claim key: `MedicationStatement.contained-documents`.
- * Legacy alias accepted on read: `MedicationStatement.attachment-content-ids`.
+ * `gdc-sdk-core-ts` and older consumers still import
+ * `gdc-common-utils-ts/utils/medication-claim-helpers`, while the canonical
+ * implementation file is `claims-helpers-medication-statement`.
  */
-export function getMedicationContainedDocumentIdentifierList(claims) {
-    return uniqueCsvLists([
-        getMedicationClaimList(claims, MedicationStatementClaim.ContainedDocuments),
-        getMedicationClaimList(claims, MedicationStatementClaim.AttachmentContentIds),
-    ]);
-}
-export function setMedicationContainedDocumentIdentifierList(claims, values) {
-    return setContainedDocuments(claims, values);
-}
-export function addMedicationContainedDocumentIdentifierList(claims, values) {
-    return setContainedDocuments(claims, uniqueCsvLists([
-        getMedicationContainedDocumentIdentifierList(claims),
-        Array.isArray(values) ? [...values] : getMedicationClaimList({ [MedicationStatementClaim.ContainedDocuments]: values }, MedicationStatementClaim.ContainedDocuments),
-    ]));
-}
-export function removeMedicationContainedDocumentIdentifierList(claims, values) {
-    const toRemove = new Set((Array.isArray(values) ? values : getMedicationClaimList({ [MedicationStatementClaim.ContainedDocuments]: values }, MedicationStatementClaim.ContainedDocuments))
-        .map((item) => String(item || '').trim())
-        .filter(Boolean));
-    return setContainedDocuments(claims, getMedicationContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
-}
-function setContainedDocuments(claims, values) {
-    const next = setMedicationClaimList(claims, MedicationStatementClaim.ContainedDocuments, values);
-    const cleaned = {
-        ...next,
-    };
-    delete cleaned[MedicationStatementClaim.AttachmentContentIds];
-    return cleaned;
-}
-function uniqueCsvLists(lists) {
-    return [...new Set(lists.flatMap((list) => list.map((item) => String(item || '').trim()).filter(Boolean)))];
-}
-function getMedicationScalar(claims, claimKey) {
-    return normalizeClaimScalar(claims[claimKey]);
-}
-function setMedicationScalar(claims, claimKey, value) {
-    return {
-        ...claims,
-        [claimKey]: normalizeClaimScalar(value),
-    };
-}
-function getMedicationNumber(claims, claimKey) {
-    const raw = claims[claimKey];
-    if (typeof raw === 'number' && Number.isFinite(raw)) {
-        return raw;
-    }
-    const normalized = normalizeClaimScalar(raw);
-    if (!normalized) {
-        return undefined;
-    }
-    const parsed = Number(normalized);
-    return Number.isFinite(parsed) ? parsed : undefined;
-}
-function setMedicationNumber(claims, claimKey, value) {
-    return {
-        ...claims,
-        [claimKey]: value,
-    };
-}
-function getMedicationBoolean(claims, claimKey) {
-    const raw = claims[claimKey];
-    if (typeof raw === 'boolean') {
-        return raw;
-    }
-    const normalized = normalizeClaimScalar(raw).toLowerCase();
-    if (!normalized) {
-        return undefined;
-    }
-    if (normalized === 'true') {
-        return true;
-    }
-    if (normalized === 'false') {
-        return false;
-    }
-    return undefined;
-}
-function setMedicationBoolean(claims, claimKey, value) {
-    return {
-        ...claims,
-        [claimKey]: value,
-    };
-}
+export * from './claims-helpers-medication-statement.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "2.0.12",
+  "version": "2.0.14",
   "publishConfig": {
     "access": "public"
   },
@@ -102,10 +102,6 @@
     "./storage/*": {
       "types": "./dist/storage/*.d.ts",
       "default": "./dist/storage/*.js"
-    },
-    "./adapters/node/crypto": {
-      "types": "./dist/adapters/node/crypto.d.ts",
-      "default": "./dist/adapters/node/crypto.js"
     }
   },
   "files": [

package/dist/examples/communication-bundle-session.d.ts

@@ -1,22 +0,0 @@
-import { BundleEntry, BundleJsonApi } from '../models/bundle';
-/**
- * First developer use case:
- * - edit a Consent entry inside a Communication-attached Bundle
- * - keep active entry in memory
- * - serialize full Bundle to Communication.content-attachment-data on save
- * - release active entry memory when finished
- */
-export declare function buildConsentEditingCommunicationSessionExample(): {
-    communicationClaims: Record<string, unknown>;
-    bundleInMemory: BundleJsonApi<BundleEntry>;
-};
-/**
- * Second developer use case:
- * - edit MedicationStatement claims to drive a health view
- * - keep bundle attached to Communication as base64 payload
- * - apply save/release lifecycle consistently
- */
-export declare function buildMedicationEditingCommunicationSessionExample(): {
-    communicationClaims: Record<string, unknown>;
-    bundleInMemory: BundleJsonApi<BundleEntry>;
-};

package/dist/examples/communication-bundle-session.js

@@ -1,79 +0,0 @@
-// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
-// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
-import { HealthcareBasicSections } from '../constants/healthcare.js';
-import { CommunicationCategoryCodes } from '../constants/communication.js';
-import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
-import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_IDENTIFIER, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_CONSENT_PERIOD_START, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
-import { CommunicationBundleSession } from '../utils/communication-bundle-session.js';
-import { setCommunicationCategory, setCommunicationIdentifier, setCommunicationSubject, setCommunicationText, } from '../claims/claims-helpers-communication.js';
-import { setActorIdentifierList, setActorRoleList, setConsentDate, setConsentDecision, setConsentIdentifier, setConsentPeriodEnd, setConsentPeriodStart, setConsentSubject, setPurposeList, setSectionList, } from '../claims/claims-helpers-consent.js';
-/**
- * First developer use case:
- * - edit a Consent entry inside a Communication-attached Bundle
- * - keep active entry in memory
- * - serialize full Bundle to Communication.content-attachment-data on save
- * - release active entry memory when finished
- */
-export function buildConsentEditingCommunicationSessionExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
-    communicationClaims = setCommunicationIdentifier(communicationClaims, EXAMPLE_COMMUNICATION_IDENTIFIER);
-    communicationClaims = setCommunicationSubject(communicationClaims, EXAMPLE_SUBJECT_DID);
-    communicationClaims = setCommunicationCategory(communicationClaims, CommunicationCategoryCodes.Notification.attributeValue);
-    communicationClaims = setCommunicationText(communicationClaims, EXAMPLE_IPS_BUNDLE_NOTE_TEXT);
-    const bundleEditor = new CommunicationBundleSession({
-        communicationClaims,
-    });
-    let consentClaims = { '@context': 'org.hl7.fhir.api' };
-    consentClaims = setConsentDecision(consentClaims, 'permit');
-    consentClaims = setConsentSubject(consentClaims, EXAMPLE_SUBJECT_DID);
-    consentClaims = setConsentIdentifier(consentClaims, EXAMPLE_CONSENT_IDENTIFIER);
-    consentClaims = setConsentDate(consentClaims, EXAMPLE_CONSENT_DATE);
-    consentClaims = setConsentPeriodStart(consentClaims, EXAMPLE_CONSENT_PERIOD_START);
-    consentClaims = setConsentPeriodEnd(consentClaims, EXAMPLE_CONSENT_PERIOD_END);
-    consentClaims = setPurposeList(consentClaims, [EXAMPLE_CONSENT_PURPOSE_TREATMENT]);
-    consentClaims = setSectionList(consentClaims, [
-        HealthcareBasicSections.AllergiesAndIntolerances.attributeValue,
-    ]);
-    consentClaims = setActorIdentifierList(consentClaims, [EXAMPLE_EMAIL_PROFESSIONAL]);
-    consentClaims = setActorRoleList(consentClaims, [EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN]);
-    bundleEditor.upsertActiveConsentEntry({
-        claims: consentClaims,
-        fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
-    });
-    bundleEditor.saveAndReleaseActiveEntry();
-    return {
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
-    };
-}
-/**
- * Second developer use case:
- * - edit MedicationStatement claims to drive a health view
- * - keep bundle attached to Communication as base64 payload
- * - apply save/release lifecycle consistently
- */
-export function buildMedicationEditingCommunicationSessionExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
-    communicationClaims = setCommunicationIdentifier(communicationClaims, EXAMPLE_COMMUNICATION_IDENTIFIER);
-    communicationClaims = setCommunicationSubject(communicationClaims, EXAMPLE_SUBJECT_DID);
-    communicationClaims = setCommunicationCategory(communicationClaims, CommunicationCategoryCodes.Reminder.attributeValue);
-    communicationClaims = setCommunicationText(communicationClaims, EXAMPLE_IPS_BUNDLE_NOTE_TEXT);
-    const bundleEditor = new CommunicationBundleSession({
-        communicationClaims,
-    });
-    bundleEditor.upsertActiveMedicationStatementEntry({
-        claims: {
-            '@context': 'org.hl7.fhir.api',
-            [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
-            [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
-            [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
-            [MedicationStatementClaim.MedicationText]: EXAMPLE_MEDICATION_STATEMENT_TEXT,
-        },
-        fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
-    });
-    bundleEditor.saveAndReleaseActiveEntry();
-    return {
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
-    };
-}