gdc-common-utils-ts 1.14.10 → 1.14.14

package/README.md

@@ -1,9 +1,27 @@
 # gdc-common-utils-ts
 
+Employee shared examples live in `src/examples/employee.ts`.
+Employee pure helper functions live in `src/utils/employee.ts`.
+
+The canonical employee contract note lives in
+`gdc-sdk-core-ts/docs/EMPLOYEES_101.md`.
+
 Shared TypeScript utilities for GDC client and connector code. This package provides low-level primitives for cryptography, DID/DIDComm-related helpers, and the shared models and interfaces used across SDKs.
 
 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).
@@ -27,11 +45,14 @@ The published package exposes these entry points through `package.json`:
 - `gdc-common-utils-ts/hmac`
 - `gdc-common-utils-ts/examples`
 - `gdc-common-utils-ts/examples/*`
+- `gdc-common-utils-ts/claims`
 - `gdc-common-utils-ts/constants`
+- `gdc-common-utils-ts/convert`
 - `gdc-common-utils-ts/models`
 - `gdc-common-utils-ts/utils`
 - `gdc-common-utils-ts/interfaces`
-- File-level subpaths under `constants/*`, `models/*`, `utils/*`, and `interfaces/*`
+- File-level subpaths under `claims/*`, `constants/*`, `models/*`, `utils/*`,
+  and `interfaces/*` plus `convert/*`
 
 ### Root crypto exports
 
@@ -69,6 +90,44 @@ import { normalizeDidWeb, generateServiceId } from 'gdc-common-utils-ts/utils/di
 import { fhirResourceToCid, assignCidToFhirResourceVersionId } from 'gdc-common-utils-ts/utils/fhir-cid';
 ```
 
+### Convert
+
+The `convert` export exposes resource-specific FHIR R4 conversion helpers such as:
+
+- `medicationStatementFlatToFhirR4`
+- `medicationStatementFhirR4ToFlat`
+- `observationFlatToFhirR4`
+- `documentReferenceFlatToFhirR4`
+- `compositionFlatToFhirR4`
+
+Example:
+
+```ts
+import {
+  medicationStatementFlatToFhirR4,
+  observationFhirR4ToFlat,
+} from 'gdc-common-utils-ts/convert';
+```
+
+### Claims
+
+The `claims` export exposes resource-specific flat claim helpers such as:
+
+- `setMedicationIdentifier`
+- `getMedicationCategoryList`
+- `setCommunicationCategory`
+- `setActorRoleList`
+- `addSectionList`
+
+Example:
+
+```ts
+import {
+  setMedicationIdentifier,
+  setMedicationCategoryList,
+} from 'gdc-common-utils-ts/claims/claims-helpers-medication-statement';
+```
+
 ### Models
 
 The `models` export contains the shared data shapes used by the SDKs, including:

package/dist/claims/claim-list-helpers.d.ts

@@ -0,0 +1,21 @@
+export type GenericInteroperableClaims = Record<string, unknown>;
+export declare function splitClaimCsv(value: unknown): string[];
+export declare function normalizeClaimTokens(values: readonly string[]): string[];
+export declare function normalizeClaimInput(values: string | readonly string[]): string[];
+export declare function normalizeClaimScalar(value: unknown): string;
+/**
+ * Returns the tokenized values for a claims field stored as CSV.
+ */
+export declare function getClaimValues(claims: GenericInteroperableClaims, claimKey: string): string[];
+/**
+ * Replaces a claims CSV field with the provided values.
+ */
+export declare function setClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;
+/**
+ * Adds one or many values into a claims CSV field while preserving uniqueness.
+ */
+export declare function addClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;
+/**
+ * Removes one or many values from a claims CSV field while preserving uniqueness.
+ */
+export declare function removeClaimValues(claims: GenericInteroperableClaims, claimKey: string, values: string | readonly string[]): GenericInteroperableClaims;

package/dist/claims/claim-list-helpers.js

@@ -0,0 +1,50 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+export function splitClaimCsv(value) {
+    return String(value || '')
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+export function normalizeClaimTokens(values) {
+    return [...new Set(values.map((value) => String(value || '').trim()).filter(Boolean))];
+}
+export function normalizeClaimInput(values) {
+    return Array.isArray(values)
+        ? normalizeClaimTokens(values)
+        : normalizeClaimTokens(splitClaimCsv(values));
+}
+export function normalizeClaimScalar(value) {
+    return String(value || '').trim();
+}
+/**
+ * Returns the tokenized values for a claims field stored as CSV.
+ */
+export function getClaimValues(claims, claimKey) {
+    return normalizeClaimTokens(splitClaimCsv(claims[claimKey]));
+}
+/**
+ * Replaces a claims CSV field with the provided values.
+ */
+export function setClaimValues(claims, claimKey, values) {
+    const nextValues = normalizeClaimInput(values);
+    return {
+        ...claims,
+        [claimKey]: nextValues.join(','),
+    };
+}
+/**
+ * Adds one or many values into a claims CSV field while preserving uniqueness.
+ */
+export function addClaimValues(claims, claimKey, values) {
+    const current = getClaimValues(claims, claimKey);
+    const additions = normalizeClaimInput(values);
+    return setClaimValues(claims, claimKey, [...current, ...additions]);
+}
+/**
+ * Removes one or many values from a claims CSV field while preserving uniqueness.
+ */
+export function removeClaimValues(claims, claimKey, values) {
+    const removals = new Set(normalizeClaimInput(values));
+    const nextValues = getClaimValues(claims, claimKey).filter((value) => !removals.has(value));
+    return setClaimValues(claims, claimKey, nextValues);
+}

package/dist/claims/claims-helpers-allergy-intolerance.d.ts

@@ -0,0 +1,10 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type AllergyIntoleranceInteroperableClaims = GenericInteroperableClaims;
+export declare function getAllergyIntoleranceClaimList(claims: AllergyIntoleranceInteroperableClaims, claimKey: string): string[];
+export declare function setAllergyIntoleranceClaimList(claims: AllergyIntoleranceInteroperableClaims, claimKey: string, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function addAllergyIntoleranceClaimList(claims: AllergyIntoleranceInteroperableClaims, claimKey: string, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function removeAllergyIntoleranceClaimList(claims: AllergyIntoleranceInteroperableClaims, claimKey: string, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function getAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims): string[];
+export declare function setAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function addAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function removeAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;

package/dist/claims/claims-helpers-allergy-intolerance.js

@@ -0,0 +1,47 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-intolerance-claims.js';
+import { addClaimValues, getClaimValues, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getAllergyIntoleranceClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setAllergyIntoleranceClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addAllergyIntoleranceClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeAllergyIntoleranceClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getAllergyIntoleranceContainedDocumentIdentifierList(claims) {
+    return uniqueCsvLists([
+        getAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedDocuments),
+        getAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.AttachmentContentIds),
+    ]);
+}
+export function setAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    return setContainedDocuments(claims, values);
+}
+export function addAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    return setContainedDocuments(claims, uniqueCsvLists([
+        getAllergyIntoleranceContainedDocumentIdentifierList(claims),
+        Array.isArray(values) ? [...values] : getAllergyIntoleranceClaimList({ [AllergyIntoleranceClaim.ContainedDocuments]: values }, AllergyIntoleranceClaim.ContainedDocuments),
+    ]));
+}
+export function removeAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    const toRemove = new Set((Array.isArray(values) ? values : getAllergyIntoleranceClaimList({ [AllergyIntoleranceClaim.ContainedDocuments]: values }, AllergyIntoleranceClaim.ContainedDocuments))
+        .map((item) => String(item || '').trim())
+        .filter(Boolean));
+    return setContainedDocuments(claims, getAllergyIntoleranceContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
+}
+function setContainedDocuments(claims, values) {
+    const next = setAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedDocuments, values);
+    const cleaned = {
+        ...next,
+    };
+    delete cleaned[AllergyIntoleranceClaim.AttachmentContentIds];
+    return cleaned;
+}
+function uniqueCsvLists(lists) {
+    return [...new Set(lists.flatMap((list) => list.map((item) => String(item || '').trim()).filter(Boolean)))];
+}

package/dist/claims/claims-helpers-appointment-response.d.ts

@@ -0,0 +1,8 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type AppointmentResponseInteroperableClaims = GenericInteroperableClaims;
+export declare function getAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string): string[];
+export declare function setAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
+export declare function addAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
+export declare function removeAppointmentResponseClaimList(claims: AppointmentResponseInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentResponseInteroperableClaims;
+export declare function getAppointmentResponseIdentifier(claims: AppointmentResponseInteroperableClaims): string;
+export declare function setAppointmentResponseIdentifier(claims: AppointmentResponseInteroperableClaims, value: string): AppointmentResponseInteroperableClaims;

package/dist/claims/claims-helpers-appointment-response.js

@@ -0,0 +1,20 @@
+import { AppointmentResponseClaim } from '../models/interoperable-claims/appointment-response-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getAppointmentResponseClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setAppointmentResponseClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addAppointmentResponseClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeAppointmentResponseClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getAppointmentResponseIdentifier(claims) {
+    return normalizeClaimScalar(claims[AppointmentResponseClaim.Identifier]);
+}
+export function setAppointmentResponseIdentifier(claims, value) {
+    return { ...claims, [AppointmentResponseClaim.Identifier]: normalizeClaimScalar(value) };
+}

package/dist/claims/claims-helpers-appointment.d.ts

@@ -0,0 +1,10 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type AppointmentInteroperableClaims = GenericInteroperableClaims;
+export declare function getAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string): string[];
+export declare function setAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
+export declare function addAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
+export declare function removeAppointmentClaimList(claims: AppointmentInteroperableClaims, claimKey: string, values: string | readonly string[]): AppointmentInteroperableClaims;
+export declare function getAppointmentIdentifier(claims: AppointmentInteroperableClaims): string;
+export declare function setAppointmentIdentifier(claims: AppointmentInteroperableClaims, value: string): AppointmentInteroperableClaims;
+export declare function getAppointmentParticipantActorList(claims: AppointmentInteroperableClaims): string[];
+export declare function setAppointmentParticipantActorList(claims: AppointmentInteroperableClaims, values: string | readonly string[]): AppointmentInteroperableClaims;

package/dist/claims/claims-helpers-appointment.js

@@ -0,0 +1,26 @@
+import { AppointmentClaim } from '../models/interoperable-claims/appointment-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getAppointmentClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setAppointmentClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addAppointmentClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeAppointmentClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getAppointmentIdentifier(claims) {
+    return normalizeClaimScalar(claims[AppointmentClaim.Identifier]);
+}
+export function setAppointmentIdentifier(claims, value) {
+    return { ...claims, [AppointmentClaim.Identifier]: normalizeClaimScalar(value) };
+}
+export function getAppointmentParticipantActorList(claims) {
+    return getAppointmentClaimList(claims, AppointmentClaim.ParticipantActor);
+}
+export function setAppointmentParticipantActorList(claims, values) {
+    return setAppointmentClaimList(claims, AppointmentClaim.ParticipantActor, values);
+}

package/dist/claims/claims-helpers-care-plan.d.ts

@@ -0,0 +1,8 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type CarePlanInteroperableClaims = GenericInteroperableClaims;
+export declare function getCarePlanClaimList(claims: CarePlanInteroperableClaims, claimKey: string): string[];
+export declare function setCarePlanClaimList(claims: CarePlanInteroperableClaims, claimKey: string, values: string | readonly string[]): CarePlanInteroperableClaims;
+export declare function addCarePlanClaimList(claims: CarePlanInteroperableClaims, claimKey: string, values: string | readonly string[]): CarePlanInteroperableClaims;
+export declare function removeCarePlanClaimList(claims: CarePlanInteroperableClaims, claimKey: string, values: string | readonly string[]): CarePlanInteroperableClaims;
+export declare function getCarePlanIdentifier(claims: CarePlanInteroperableClaims): string;
+export declare function setCarePlanIdentifier(claims: CarePlanInteroperableClaims, value: string): CarePlanInteroperableClaims;

package/dist/claims/claims-helpers-care-plan.js

@@ -0,0 +1,20 @@
+import { CarePlanClaim } from '../models/interoperable-claims/care-plan-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getCarePlanClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setCarePlanClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addCarePlanClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeCarePlanClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getCarePlanIdentifier(claims) {
+    return normalizeClaimScalar(claims[CarePlanClaim.Identifier]);
+}
+export function setCarePlanIdentifier(claims, value) {
+    return { ...claims, [CarePlanClaim.Identifier]: normalizeClaimScalar(value) };
+}

package/dist/claims/claims-helpers-clinical-impression.d.ts

@@ -0,0 +1,10 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type ClinicalImpressionInteroperableClaims = GenericInteroperableClaims;
+export declare function getClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string): string[];
+export declare function setClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
+export declare function addClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
+export declare function removeClinicalImpressionClaimList(claims: ClinicalImpressionInteroperableClaims, claimKey: string, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;
+export declare function getClinicalImpressionIdentifier(claims: ClinicalImpressionInteroperableClaims): string;
+export declare function setClinicalImpressionIdentifier(claims: ClinicalImpressionInteroperableClaims, value: string): ClinicalImpressionInteroperableClaims;
+export declare function getClinicalImpressionProblemList(claims: ClinicalImpressionInteroperableClaims): string[];
+export declare function setClinicalImpressionProblemList(claims: ClinicalImpressionInteroperableClaims, values: string | readonly string[]): ClinicalImpressionInteroperableClaims;

package/dist/claims/claims-helpers-clinical-impression.js

@@ -0,0 +1,26 @@
+import { ClinicalImpressionClaim } from '../models/interoperable-claims/clinical-impression-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getClinicalImpressionClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setClinicalImpressionClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addClinicalImpressionClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeClinicalImpressionClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getClinicalImpressionIdentifier(claims) {
+    return normalizeClaimScalar(claims[ClinicalImpressionClaim.Identifier]);
+}
+export function setClinicalImpressionIdentifier(claims, value) {
+    return { ...claims, [ClinicalImpressionClaim.Identifier]: normalizeClaimScalar(value) };
+}
+export function getClinicalImpressionProblemList(claims) {
+    return getClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem);
+}
+export function setClinicalImpressionProblemList(claims, values) {
+    return setClinicalImpressionClaimList(claims, ClinicalImpressionClaim.Problem, values);
+}

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

@@ -0,0 +1,17 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type CommunicationInteroperableClaims = GenericInteroperableClaims;
+export declare function getCommunicationIdentifier(claims: CommunicationInteroperableClaims): string;
+export declare function setCommunicationIdentifier(claims: CommunicationInteroperableClaims, value: unknown): CommunicationInteroperableClaims;
+export declare function getCommunicationSubject(claims: CommunicationInteroperableClaims): string;
+export declare function setCommunicationSubject(claims: CommunicationInteroperableClaims, value: unknown): CommunicationInteroperableClaims;
+export declare function getCommunicationCategory(claims: CommunicationInteroperableClaims): string;
+export declare function getCommunicationCategoryList(claims: CommunicationInteroperableClaims): string[];
+export declare function setCommunicationCategory(claims: CommunicationInteroperableClaims, value: string | readonly string[]): CommunicationInteroperableClaims;
+export declare function addCommunicationCategoryList(claims: CommunicationInteroperableClaims, value: string | readonly string[]): CommunicationInteroperableClaims;
+export declare function removeCommunicationCategoryList(claims: CommunicationInteroperableClaims, value: string | readonly string[]): CommunicationInteroperableClaims;
+export declare function getCommunicationText(claims: CommunicationInteroperableClaims): string;
+export declare function setCommunicationText(claims: CommunicationInteroperableClaims, value: unknown): CommunicationInteroperableClaims;
+export declare function getCommunicationContentAttachmentData(claims: CommunicationInteroperableClaims): string;
+export declare function setCommunicationContentAttachmentData(claims: CommunicationInteroperableClaims, value: unknown): CommunicationInteroperableClaims;
+export declare function getCommunicationContentAttachmentType(claims: CommunicationInteroperableClaims): string;
+export declare function setCommunicationContentAttachmentType(claims: CommunicationInteroperableClaims, value: unknown): CommunicationInteroperableClaims;

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

@@ -0,0 +1,57 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+function getCommunicationScalar(claims, claimKey) {
+    return normalizeClaimScalar(claims[claimKey]);
+}
+function setCommunicationScalar(claims, claimKey, value) {
+    return {
+        ...claims,
+        [claimKey]: normalizeClaimScalar(value),
+    };
+}
+export function getCommunicationIdentifier(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.Identifier);
+}
+export function setCommunicationIdentifier(claims, value) {
+    return setCommunicationScalar(claims, CommunicationClaim.Identifier, value);
+}
+export function getCommunicationSubject(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.Subject);
+}
+export function setCommunicationSubject(claims, value) {
+    return setCommunicationScalar(claims, CommunicationClaim.Subject, value);
+}
+export function getCommunicationCategory(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.Category);
+}
+export function getCommunicationCategoryList(claims) {
+    return getClaimValues(claims, CommunicationClaim.Category);
+}
+export function setCommunicationCategory(claims, value) {
+    return setClaimValues(claims, CommunicationClaim.Category, value);
+}
+export function addCommunicationCategoryList(claims, value) {
+    return addClaimValues(claims, CommunicationClaim.Category, value);
+}
+export function removeCommunicationCategoryList(claims, value) {
+    return removeClaimValues(claims, CommunicationClaim.Category, value);
+}
+export function getCommunicationText(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.Text);
+}
+export function setCommunicationText(claims, value) {
+    return setCommunicationScalar(claims, CommunicationClaim.Text, value);
+}
+export function getCommunicationContentAttachmentData(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.ContentAttachmentData);
+}
+export function setCommunicationContentAttachmentData(claims, value) {
+    return setCommunicationScalar(claims, CommunicationClaim.ContentAttachmentData, value);
+}
+export function getCommunicationContentAttachmentType(claims) {
+    return getCommunicationScalar(claims, CommunicationClaim.ContentAttachmentType);
+}
+export function setCommunicationContentAttachmentType(claims, value) {
+    return setCommunicationScalar(claims, CommunicationClaim.ContentAttachmentType, value);
+}

package/dist/claims/claims-helpers-composition.d.ts

@@ -0,0 +1,12 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type CompositionInteroperableClaims = GenericInteroperableClaims;
+export declare function getCompositionClaimList(claims: CompositionInteroperableClaims, claimKey: string): string[];
+export declare function setCompositionClaimList(claims: CompositionInteroperableClaims, claimKey: string, values: string | readonly string[]): CompositionInteroperableClaims;
+export declare function addCompositionClaimList(claims: CompositionInteroperableClaims, claimKey: string, values: string | readonly string[]): CompositionInteroperableClaims;
+export declare function removeCompositionClaimList(claims: CompositionInteroperableClaims, claimKey: string, values: string | readonly string[]): CompositionInteroperableClaims;
+export declare function getCompositionTypeList(claims: CompositionInteroperableClaims): string[];
+export declare function setCompositionTypeList(claims: CompositionInteroperableClaims, values: string | readonly string[]): CompositionInteroperableClaims;
+export declare function getCompositionSectionList(claims: CompositionInteroperableClaims): string[];
+export declare function setCompositionSectionList(claims: CompositionInteroperableClaims, values: string | readonly string[]): CompositionInteroperableClaims;
+export declare function getCompositionSubject(claims: CompositionInteroperableClaims): string;
+export declare function setCompositionSubject(claims: CompositionInteroperableClaims, value: string): CompositionInteroperableClaims;

package/dist/claims/claims-helpers-composition.js

@@ -0,0 +1,32 @@
+import { CompositionClaim } from '../models/interoperable-claims/composition-claims.js';
+import { addClaimValues, getClaimValues, normalizeClaimScalar, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getCompositionClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setCompositionClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addCompositionClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeCompositionClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getCompositionTypeList(claims) {
+    return getCompositionClaimList(claims, CompositionClaim.Type);
+}
+export function setCompositionTypeList(claims, values) {
+    return setCompositionClaimList(claims, CompositionClaim.Type, values);
+}
+export function getCompositionSectionList(claims) {
+    return getCompositionClaimList(claims, CompositionClaim.Section);
+}
+export function setCompositionSectionList(claims, values) {
+    return setCompositionClaimList(claims, CompositionClaim.Section, values);
+}
+export function getCompositionSubject(claims) {
+    return normalizeClaimScalar(claims[CompositionClaim.Subject]);
+}
+export function setCompositionSubject(claims, value) {
+    return { ...claims, [CompositionClaim.Subject]: normalizeClaimScalar(value) };
+}

package/dist/claims/claims-helpers-condition.d.ts

@@ -0,0 +1,10 @@
+import { type GenericInteroperableClaims } from './claim-list-helpers.js';
+export type ConditionInteroperableClaims = GenericInteroperableClaims;
+export declare function getConditionClaimList(claims: ConditionInteroperableClaims, claimKey: string): string[];
+export declare function setConditionClaimList(claims: ConditionInteroperableClaims, claimKey: string, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function addConditionClaimList(claims: ConditionInteroperableClaims, claimKey: string, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function removeConditionClaimList(claims: ConditionInteroperableClaims, claimKey: string, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function getConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims): string[];
+export declare function setConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function addConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function removeConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;

package/dist/claims/claims-helpers-condition.js

@@ -0,0 +1,47 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { ConditionClaim } from '../models/interoperable-claims/condition-claims.js';
+import { addClaimValues, getClaimValues, removeClaimValues, setClaimValues, } from './claim-list-helpers.js';
+export function getConditionClaimList(claims, claimKey) {
+    return getClaimValues(claims, claimKey);
+}
+export function setConditionClaimList(claims, claimKey, values) {
+    return setClaimValues(claims, claimKey, values);
+}
+export function addConditionClaimList(claims, claimKey, values) {
+    return addClaimValues(claims, claimKey, values);
+}
+export function removeConditionClaimList(claims, claimKey, values) {
+    return removeClaimValues(claims, claimKey, values);
+}
+export function getConditionContainedDocumentIdentifierList(claims) {
+    return uniqueCsvLists([
+        getConditionClaimList(claims, ConditionClaim.ContainedDocuments),
+        getConditionClaimList(claims, ConditionClaim.AttachmentContentIds),
+    ]);
+}
+export function setConditionContainedDocumentIdentifierList(claims, values) {
+    return setContainedDocuments(claims, values);
+}
+export function addConditionContainedDocumentIdentifierList(claims, values) {
+    return setContainedDocuments(claims, uniqueCsvLists([
+        getConditionContainedDocumentIdentifierList(claims),
+        Array.isArray(values) ? [...values] : getConditionClaimList({ [ConditionClaim.ContainedDocuments]: values }, ConditionClaim.ContainedDocuments),
+    ]));
+}
+export function removeConditionContainedDocumentIdentifierList(claims, values) {
+    const toRemove = new Set((Array.isArray(values) ? values : getConditionClaimList({ [ConditionClaim.ContainedDocuments]: values }, ConditionClaim.ContainedDocuments))
+        .map((item) => String(item || '').trim())
+        .filter(Boolean));
+    return setContainedDocuments(claims, getConditionContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
+}
+function setContainedDocuments(claims, values) {
+    const next = setConditionClaimList(claims, ConditionClaim.ContainedDocuments, values);
+    const cleaned = {
+        ...next,
+    };
+    delete cleaned[ConditionClaim.AttachmentContentIds];
+    return cleaned;
+}
+function uniqueCsvLists(lists) {
+    return [...new Set(lists.flatMap((list) => list.map((item) => String(item || '').trim()).filter(Boolean)))];
+}