gdc-common-utils-ts 2.1.0 → 2.2.2

package/README.md

@@ -143,6 +143,23 @@ read first:
 - [`docs/REFERENCE-CLINICAL-IPS-API.md`](docs/REFERENCE-CLINICAL-IPS-API.md)
 - [`docs/101-CONSENT_PERMISSION_TEMPLATES.md`](docs/101-CONSENT_PERMISSION_TEMPLATES.md)
 
+Shared batch model for high-frequency clinical measurements:
+
+- one day-level vital-sign batch is an atomic clinical artifact
+- several day batches from the same actor are a collection of atomic batch
+  artifacts
+- the batch is what moves through Communication and ledger paths; the
+  individual observations remain the facts inside it
+
+For high-frequency clinical measurements, keep the same mental model across
+packages:
+
+- one day-level vital-sign batch is an atomic clinical artifact
+- several day batches from the same actor are a collection of atomic batch
+  artifacts
+- the batch is what gets moved through Communication and ledger paths; the
+  underlying observations remain the facts inside it
+
 ## Install
 
 ```bash
@@ -191,6 +208,7 @@ The `utils` export exposes reusable helpers for DID and message handling, such a
 - `utils/jwt`
 - `utils/content`
 - `utils/normalize`
+- `utils/unified-health-id` for provider-scoped Damm control digits over normalized provider + personal numeric sequences
 - `utils/fhir-cid` for recursive FHIR canonicalization + CID generation + `meta.versionId` assignment
 - `utils/fhir-validator` for adapter-based FHIR validation (`validateFhirResource`, pluggable formal validator)
 - conversion, formatting, and multibase helpers

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

@@ -4,7 +4,15 @@ export declare function getAllergyIntoleranceClaimList(claims: AllergyIntoleranc
 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 getAllergyIntoleranceContainedResourceReferenceList(claims: AllergyIntoleranceInteroperableClaims): string[];
+export declare function setAllergyIntoleranceContainedResourceReferenceList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function addAllergyIntoleranceContainedResourceReferenceList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+export declare function removeAllergyIntoleranceContainedResourceReferenceList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+/** @deprecated Use `getAllergyIntoleranceContainedResourceReferenceList`. */
 export declare function getAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims): string[];
+/** @deprecated Use `setAllergyIntoleranceContainedResourceReferenceList`. */
 export declare function setAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+/** @deprecated Use `addAllergyIntoleranceContainedResourceReferenceList`. */
 export declare function addAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;
+/** @deprecated Use `removeAllergyIntoleranceContainedResourceReferenceList`. */
 export declare function removeAllergyIntoleranceContainedDocumentIdentifierList(claims: AllergyIntoleranceInteroperableClaims, values: string | readonly string[]): AllergyIntoleranceInteroperableClaims;

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

@@ -13,32 +13,50 @@ export function addAllergyIntoleranceClaimList(claims, claimKey, values) {
 export function removeAllergyIntoleranceClaimList(claims, claimKey, values) {
     return removeClaimValues(claims, claimKey, values);
 }
-export function getAllergyIntoleranceContainedDocumentIdentifierList(claims) {
+export function getAllergyIntoleranceContainedResourceReferenceList(claims) {
     return uniqueCsvLists([
+        getAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedReferenceList),
         getAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedDocuments),
         getAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.AttachmentContentIds),
     ]);
 }
-export function setAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
-    return setContainedDocuments(claims, values);
+export function setAllergyIntoleranceContainedResourceReferenceList(claims, values) {
+    return setContainedResources(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 addAllergyIntoleranceContainedResourceReferenceList(claims, values) {
+    return setContainedResources(claims, uniqueCsvLists([
+        getAllergyIntoleranceContainedResourceReferenceList(claims),
+        Array.isArray(values) ? [...values] : getAllergyIntoleranceClaimList({ [AllergyIntoleranceClaim.ContainedReferenceList]: values }, AllergyIntoleranceClaim.ContainedReferenceList),
     ]));
 }
-export function removeAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
-    const toRemove = new Set((Array.isArray(values) ? values : getAllergyIntoleranceClaimList({ [AllergyIntoleranceClaim.ContainedDocuments]: values }, AllergyIntoleranceClaim.ContainedDocuments))
+export function removeAllergyIntoleranceContainedResourceReferenceList(claims, values) {
+    const toRemove = new Set((Array.isArray(values) ? values : getAllergyIntoleranceClaimList({ [AllergyIntoleranceClaim.ContainedReferenceList]: values }, AllergyIntoleranceClaim.ContainedReferenceList))
         .map((item) => String(item || '').trim())
         .filter(Boolean));
-    return setContainedDocuments(claims, getAllergyIntoleranceContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
+    return setContainedResources(claims, getAllergyIntoleranceContainedResourceReferenceList(claims).filter((item) => !toRemove.has(item)));
+}
+/** @deprecated Use `getAllergyIntoleranceContainedResourceReferenceList`. */
+export function getAllergyIntoleranceContainedDocumentIdentifierList(claims) {
+    return getAllergyIntoleranceContainedResourceReferenceList(claims);
+}
+/** @deprecated Use `setAllergyIntoleranceContainedResourceReferenceList`. */
+export function setAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    return setAllergyIntoleranceContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `addAllergyIntoleranceContainedResourceReferenceList`. */
+export function addAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    return addAllergyIntoleranceContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `removeAllergyIntoleranceContainedResourceReferenceList`. */
+export function removeAllergyIntoleranceContainedDocumentIdentifierList(claims, values) {
+    return removeAllergyIntoleranceContainedResourceReferenceList(claims, values);
 }
-function setContainedDocuments(claims, values) {
-    const next = setAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedDocuments, values);
+function setContainedResources(claims, values) {
+    const next = setAllergyIntoleranceClaimList(claims, AllergyIntoleranceClaim.ContainedReferenceList, values);
     const cleaned = {
         ...next,
     };
+    delete cleaned[AllergyIntoleranceClaim.ContainedDocuments];
     delete cleaned[AllergyIntoleranceClaim.AttachmentContentIds];
     return cleaned;
 }

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

@@ -4,7 +4,15 @@ export declare function getConditionClaimList(claims: ConditionInteroperableClai
 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 getConditionContainedResourceReferenceList(claims: ConditionInteroperableClaims): string[];
+export declare function setConditionContainedResourceReferenceList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function addConditionContainedResourceReferenceList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+export declare function removeConditionContainedResourceReferenceList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+/** @deprecated Use `getConditionContainedResourceReferenceList`. */
 export declare function getConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims): string[];
+/** @deprecated Use `setConditionContainedResourceReferenceList`. */
 export declare function setConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+/** @deprecated Use `addConditionContainedResourceReferenceList`. */
 export declare function addConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;
+/** @deprecated Use `removeConditionContainedResourceReferenceList`. */
 export declare function removeConditionContainedDocumentIdentifierList(claims: ConditionInteroperableClaims, values: string | readonly string[]): ConditionInteroperableClaims;

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

@@ -13,32 +13,50 @@ export function addConditionClaimList(claims, claimKey, values) {
 export function removeConditionClaimList(claims, claimKey, values) {
     return removeClaimValues(claims, claimKey, values);
 }
-export function getConditionContainedDocumentIdentifierList(claims) {
+export function getConditionContainedResourceReferenceList(claims) {
     return uniqueCsvLists([
+        getConditionClaimList(claims, ConditionClaim.ContainedReferenceList),
         getConditionClaimList(claims, ConditionClaim.ContainedDocuments),
         getConditionClaimList(claims, ConditionClaim.AttachmentContentIds),
     ]);
 }
-export function setConditionContainedDocumentIdentifierList(claims, values) {
-    return setContainedDocuments(claims, values);
+export function setConditionContainedResourceReferenceList(claims, values) {
+    return setContainedResources(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 addConditionContainedResourceReferenceList(claims, values) {
+    return setContainedResources(claims, uniqueCsvLists([
+        getConditionContainedResourceReferenceList(claims),
+        Array.isArray(values) ? [...values] : getConditionClaimList({ [ConditionClaim.ContainedReferenceList]: values }, ConditionClaim.ContainedReferenceList),
     ]));
 }
-export function removeConditionContainedDocumentIdentifierList(claims, values) {
-    const toRemove = new Set((Array.isArray(values) ? values : getConditionClaimList({ [ConditionClaim.ContainedDocuments]: values }, ConditionClaim.ContainedDocuments))
+export function removeConditionContainedResourceReferenceList(claims, values) {
+    const toRemove = new Set((Array.isArray(values) ? values : getConditionClaimList({ [ConditionClaim.ContainedReferenceList]: values }, ConditionClaim.ContainedReferenceList))
         .map((item) => String(item || '').trim())
         .filter(Boolean));
-    return setContainedDocuments(claims, getConditionContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
+    return setContainedResources(claims, getConditionContainedResourceReferenceList(claims).filter((item) => !toRemove.has(item)));
+}
+/** @deprecated Use `getConditionContainedResourceReferenceList`. */
+export function getConditionContainedDocumentIdentifierList(claims) {
+    return getConditionContainedResourceReferenceList(claims);
+}
+/** @deprecated Use `setConditionContainedResourceReferenceList`. */
+export function setConditionContainedDocumentIdentifierList(claims, values) {
+    return setConditionContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `addConditionContainedResourceReferenceList`. */
+export function addConditionContainedDocumentIdentifierList(claims, values) {
+    return addConditionContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `removeConditionContainedResourceReferenceList`. */
+export function removeConditionContainedDocumentIdentifierList(claims, values) {
+    return removeConditionContainedResourceReferenceList(claims, values);
 }
-function setContainedDocuments(claims, values) {
-    const next = setConditionClaimList(claims, ConditionClaim.ContainedDocuments, values);
+function setContainedResources(claims, values) {
+    const next = setConditionClaimList(claims, ConditionClaim.ContainedReferenceList, values);
     const cleaned = {
         ...next,
     };
+    delete cleaned[ConditionClaim.ContainedDocuments];
     delete cleaned[ConditionClaim.AttachmentContentIds];
     return cleaned;
 }

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

@@ -77,9 +77,13 @@ export declare function removeSectors(claims: InteroperableClaims, values: strin
  * Returns linked DocumentReference identifiers carried by the consent.
  */
 export declare function getContainedDocumentIdentifierList(claims: InteroperableClaims): string[];
+export declare function getContainedResourceReferenceList(claims: InteroperableClaims): string[];
 export declare function setContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function setContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 export declare function addContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 export declare function removeContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function addContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function removeContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 /**
  * Reads the canonical consent date claim.
  */

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

@@ -167,13 +167,20 @@ export function removeSectors(claims, values) {
  */
 export function getContainedDocumentIdentifierList(claims) {
     return uniqueCsvLists([
+        getClaimValues(claims, ClaimConsent.containedReferenceList),
         getClaimValues(claims, ClaimConsent.containedDocuments),
         getClaimValues(claims, ClaimConsent.attachmentContentIds),
     ]);
 }
+export function getContainedResourceReferenceList(claims) {
+    return getContainedDocumentIdentifierList(claims);
+}
 export function setContainedDocumentIdentifierList(claims, values) {
     return setContainedDocuments(claims, values);
 }
+export function setContainedResourceReferenceList(claims, values) {
+    return setContainedDocuments(claims, values);
+}
 export function addContainedDocumentIdentifierList(claims, values) {
     return setContainedDocuments(claims, uniqueCsvLists([
         getContainedDocumentIdentifierList(claims),
@@ -186,11 +193,18 @@ export function removeContainedDocumentIdentifierList(claims, values) {
         .filter(Boolean));
     return setContainedDocuments(claims, getContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
 }
+export function addContainedResourceReferenceList(claims, values) {
+    return addContainedDocumentIdentifierList(claims, values);
+}
+export function removeContainedResourceReferenceList(claims, values) {
+    return removeContainedDocumentIdentifierList(claims, values);
+}
 function setContainedDocuments(claims, values) {
-    const next = setClaimValues(claims, ClaimConsent.containedDocuments, values);
+    const next = setClaimValues(claims, ClaimConsent.containedReferenceList, values);
     const cleaned = {
         ...next,
     };
+    delete cleaned[ClaimConsent.containedDocuments];
     delete cleaned[ClaimConsent.attachmentContentIds];
     return cleaned;
 }

package/dist/claims/claims-helpers-diagnostic-report.d.ts

@@ -8,5 +8,9 @@ export declare function getDiagnosticReportIdentifier(claims: DiagnosticReportIn
 export declare function setDiagnosticReportIdentifier(claims: DiagnosticReportInteroperableClaims, value: string): DiagnosticReportInteroperableClaims;
 export declare function getDiagnosticReportResultList(claims: DiagnosticReportInteroperableClaims): string[];
 export declare function setDiagnosticReportResultList(claims: DiagnosticReportInteroperableClaims, values: string | readonly string[]): DiagnosticReportInteroperableClaims;
+export declare function getDiagnosticReportContainedResourceReferenceList(claims: DiagnosticReportInteroperableClaims): string[];
+export declare function setDiagnosticReportContainedResourceReferenceList(claims: DiagnosticReportInteroperableClaims, values: string | readonly string[]): DiagnosticReportInteroperableClaims;
+/** @deprecated Use `getDiagnosticReportContainedResourceReferenceList`. */
 export declare function getDiagnosticReportContainedDocumentIdentifierList(claims: DiagnosticReportInteroperableClaims): string[];
+/** @deprecated Use `setDiagnosticReportContainedResourceReferenceList`. */
 export declare function setDiagnosticReportContainedDocumentIdentifierList(claims: DiagnosticReportInteroperableClaims, values: string | readonly string[]): DiagnosticReportInteroperableClaims;

package/dist/claims/claims-helpers-diagnostic-report.js

@@ -24,9 +24,24 @@ export function getDiagnosticReportResultList(claims) {
 export function setDiagnosticReportResultList(claims, values) {
     return setDiagnosticReportClaimList(claims, DiagnosticReportClaim.Result, values);
 }
+export function getDiagnosticReportContainedResourceReferenceList(claims) {
+    const canonical = getDiagnosticReportClaimList(claims, DiagnosticReportClaim.ContainedReferenceList);
+    const legacy = getDiagnosticReportClaimList(claims, DiagnosticReportClaim.ContainedDocuments);
+    return [...new Set([...canonical, ...legacy].map((item) => String(item || '').trim()).filter(Boolean))];
+}
+export function setDiagnosticReportContainedResourceReferenceList(claims, values) {
+    const next = setDiagnosticReportClaimList(claims, DiagnosticReportClaim.ContainedReferenceList, values);
+    const cleaned = {
+        ...next,
+    };
+    delete cleaned[DiagnosticReportClaim.ContainedDocuments];
+    return cleaned;
+}
+/** @deprecated Use `getDiagnosticReportContainedResourceReferenceList`. */
 export function getDiagnosticReportContainedDocumentIdentifierList(claims) {
-    return getDiagnosticReportClaimList(claims, DiagnosticReportClaim.ContainedDocuments);
+    return getDiagnosticReportContainedResourceReferenceList(claims);
 }
+/** @deprecated Use `setDiagnosticReportContainedResourceReferenceList`. */
 export function setDiagnosticReportContainedDocumentIdentifierList(claims, values) {
-    return setDiagnosticReportClaimList(claims, DiagnosticReportClaim.ContainedDocuments, values);
+    return setDiagnosticReportContainedResourceReferenceList(claims, values);
 }

package/dist/claims/claims-helpers-medication-statement.d.ts

@@ -78,11 +78,19 @@ export declare function setMedicationSubjectList(claims: MedicationInteroperable
 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`.
+ * Linked contained resource references associated to the medication statement.
+ * Canonical claim key: `MedicationStatement.contained-reference-list`.
  * Legacy alias accepted on read: `MedicationStatement.attachment-content-ids`.
  */
+export declare function getMedicationContainedResourceReferenceList(claims: MedicationInteroperableClaims): string[];
+export declare function setMedicationContainedResourceReferenceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+export declare function addMedicationContainedResourceReferenceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+export declare function removeMedicationContainedResourceReferenceList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+/** @deprecated Use `getMedicationContainedResourceReferenceList`. */
 export declare function getMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims): string[];
+/** @deprecated Use `setMedicationContainedResourceReferenceList`. */
 export declare function setMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+/** @deprecated Use `addMedicationContainedResourceReferenceList`. */
 export declare function addMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;
+/** @deprecated Use `removeMedicationContainedResourceReferenceList`. */
 export declare function removeMedicationContainedDocumentIdentifierList(claims: MedicationInteroperableClaims, values: string | readonly string[]): MedicationInteroperableClaims;

package/dist/claims/claims-helpers-medication-statement.js

@@ -171,36 +171,54 @@ 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`.
+ * Linked contained resource references associated to the medication statement.
+ * Canonical claim key: `MedicationStatement.contained-reference-list`.
  * Legacy alias accepted on read: `MedicationStatement.attachment-content-ids`.
  */
-export function getMedicationContainedDocumentIdentifierList(claims) {
+export function getMedicationContainedResourceReferenceList(claims) {
     return uniqueCsvLists([
+        getMedicationClaimList(claims, MedicationStatementClaim.ContainedReferenceList),
         getMedicationClaimList(claims, MedicationStatementClaim.ContainedDocuments),
         getMedicationClaimList(claims, MedicationStatementClaim.AttachmentContentIds),
     ]);
 }
-export function setMedicationContainedDocumentIdentifierList(claims, values) {
-    return setContainedDocuments(claims, values);
+export function setMedicationContainedResourceReferenceList(claims, values) {
+    return setContainedResources(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 addMedicationContainedResourceReferenceList(claims, values) {
+    return setContainedResources(claims, uniqueCsvLists([
+        getMedicationContainedResourceReferenceList(claims),
+        Array.isArray(values) ? [...values] : getMedicationClaimList({ [MedicationStatementClaim.ContainedReferenceList]: values }, MedicationStatementClaim.ContainedReferenceList),
     ]));
 }
-export function removeMedicationContainedDocumentIdentifierList(claims, values) {
-    const toRemove = new Set((Array.isArray(values) ? values : getMedicationClaimList({ [MedicationStatementClaim.ContainedDocuments]: values }, MedicationStatementClaim.ContainedDocuments))
+export function removeMedicationContainedResourceReferenceList(claims, values) {
+    const toRemove = new Set((Array.isArray(values) ? values : getMedicationClaimList({ [MedicationStatementClaim.ContainedReferenceList]: values }, MedicationStatementClaim.ContainedReferenceList))
         .map((item) => String(item || '').trim())
         .filter(Boolean));
-    return setContainedDocuments(claims, getMedicationContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
+    return setContainedResources(claims, getMedicationContainedResourceReferenceList(claims).filter((item) => !toRemove.has(item)));
+}
+/** @deprecated Use `getMedicationContainedResourceReferenceList`. */
+export function getMedicationContainedDocumentIdentifierList(claims) {
+    return getMedicationContainedResourceReferenceList(claims);
+}
+/** @deprecated Use `setMedicationContainedResourceReferenceList`. */
+export function setMedicationContainedDocumentIdentifierList(claims, values) {
+    return setMedicationContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `addMedicationContainedResourceReferenceList`. */
+export function addMedicationContainedDocumentIdentifierList(claims, values) {
+    return addMedicationContainedResourceReferenceList(claims, values);
+}
+/** @deprecated Use `removeMedicationContainedResourceReferenceList`. */
+export function removeMedicationContainedDocumentIdentifierList(claims, values) {
+    return removeMedicationContainedResourceReferenceList(claims, values);
 }
-function setContainedDocuments(claims, values) {
-    const next = setMedicationClaimList(claims, MedicationStatementClaim.ContainedDocuments, values);
+function setContainedResources(claims, values) {
+    const next = setMedicationClaimList(claims, MedicationStatementClaim.ContainedReferenceList, values);
     const cleaned = {
         ...next,
     };
+    delete cleaned[MedicationStatementClaim.ContainedDocuments];
     delete cleaned[MedicationStatementClaim.AttachmentContentIds];
     return cleaned;
 }

package/dist/constants/didcomm.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canonical low-level DIDComm-style message types reused by examples, tests,
+ * and runtime-neutral transport helpers in this package.
+ */
+export declare const DidcommMessageTypes: Readonly<{
+    readonly BundleAck: "Bundle-ack-v1.0";
+    readonly BundleBatchRequest: "Bundle-batch-request-v1.0";
+    readonly BundleDocumentRequest: "Bundle-document-request-v1.0";
+    readonly CommunicationAck: "Communication-ack-v1.0";
+    readonly CommunicationAttachedBundle: "Communication-attached-bundle-v1.0";
+    readonly CommunicationBundleSubmit: "Communication-bundle-submit-v1.0";
+    readonly CommunicationResponse: "Communication-response-v1.0";
+}>;
+/**
+ * Canonical low-level DIDComm acknowledgement body keys used in shared tests
+ * and examples.
+ */
+export declare const DidcommAckBodyKeys: Readonly<{
+    readonly Ok: "ok";
+    readonly ReceivedDocumentIdentifier: "receivedDocumentIdentifier";
+    readonly ReceivedMedicationIdentifier: "receivedMedicationIdentifier";
+}>;

package/dist/constants/didcomm.js

@@ -0,0 +1,22 @@
+/**
+ * Canonical low-level DIDComm-style message types reused by examples, tests,
+ * and runtime-neutral transport helpers in this package.
+ */
+export const DidcommMessageTypes = Object.freeze({
+    BundleAck: 'Bundle-ack-v1.0',
+    BundleBatchRequest: 'Bundle-batch-request-v1.0',
+    BundleDocumentRequest: 'Bundle-document-request-v1.0',
+    CommunicationAck: 'Communication-ack-v1.0',
+    CommunicationAttachedBundle: 'Communication-attached-bundle-v1.0',
+    CommunicationBundleSubmit: 'Communication-bundle-submit-v1.0',
+    CommunicationResponse: 'Communication-response-v1.0',
+});
+/**
+ * Canonical low-level DIDComm acknowledgement body keys used in shared tests
+ * and examples.
+ */
+export const DidcommAckBodyKeys = Object.freeze({
+    Ok: 'ok',
+    ReceivedDocumentIdentifier: 'receivedDocumentIdentifier',
+    ReceivedMedicationIdentifier: 'receivedMedicationIdentifier',
+});

package/dist/constants/fhir-resource-types.d.ts

@@ -30,6 +30,7 @@ export declare const ResourceTypesFhirR4: Readonly<{
     readonly MedicationStatement: "MedicationStatement";
     readonly Observation: "Observation";
     readonly Organization: "Organization";
+    readonly Patient: "Patient";
     readonly Procedure: "Procedure";
     readonly RelatedPerson: "RelatedPerson";
 }>;
@@ -65,6 +66,7 @@ export declare const FhirResourceTypes: Readonly<{
     readonly MedicationStatement: "MedicationStatement";
     readonly Observation: "Observation";
     readonly Organization: "Organization";
+    readonly Patient: "Patient";
     readonly Procedure: "Procedure";
     readonly RelatedPerson: "RelatedPerson";
 }>;

package/dist/constants/fhir-resource-types.js

@@ -30,6 +30,7 @@ export const ResourceTypesFhirR4 = Object.freeze({
     MedicationStatement: 'MedicationStatement',
     Observation: 'Observation',
     Organization: 'Organization',
+    Patient: 'Patient',
     Procedure: 'Procedure',
     RelatedPerson: 'RelatedPerson',
 });

package/dist/constants/index.d.ts

@@ -6,6 +6,7 @@ export * from './data-collections';
 export * from './data-capabilities';
 export * from './dataspace-discovery';
 export * from './dataspace-protocol';
+export * from './didcomm';
 export * from './device';
 export * from './did-services';
 export * from './eu-countries';

package/dist/constants/index.js

@@ -6,6 +6,7 @@ export * from './data-collections.js';
 export * from './data-capabilities.js';
 export * from './dataspace-discovery.js';
 export * from './dataspace-protocol.js';
+export * from './didcomm.js';
 export * from './device.js';
 export * from './did-services.js';
 export * from './eu-countries.js';

package/dist/constants/lifecycle.d.ts

@@ -12,6 +12,8 @@ export declare const InteroperableContext: Readonly<{
  * adapters for the currently deployed GW CORE contract.
  */
 export declare const LifecycleRequestType: Readonly<{
+    readonly IndividualOrganizationDisable: "Family-disable-request-v1.0";
+    readonly IndividualOrganizationPurge: "Family-purge-request-v1.0";
     readonly RelatedPersonDisable: "RelatedPerson-disable-request-v1.0";
     readonly RelatedPersonPurge: "RelatedPerson-purge-request-v1.0";
     readonly TenantEnable: "Organization-enable-request-v1.0";

package/dist/constants/lifecycle.js

@@ -13,6 +13,8 @@ export const InteroperableContext = Object.freeze({
  * adapters for the currently deployed GW CORE contract.
  */
 export const LifecycleRequestType = Object.freeze({
+    IndividualOrganizationDisable: 'Family-disable-request-v1.0',
+    IndividualOrganizationPurge: 'Family-purge-request-v1.0',
     RelatedPersonDisable: 'RelatedPerson-disable-request-v1.0',
     RelatedPersonPurge: 'RelatedPerson-purge-request-v1.0',
     TenantEnable: 'Organization-enable-request-v1.0',

package/dist/constants/verifiable-credentials.d.ts

@@ -36,6 +36,15 @@ export declare const ActivationCredentialTypes: Readonly<{
 export declare const ProfessionalCredentialTypes: Readonly<{
     EmployeeCredential: "EmployeeCredential";
 }>;
+/**
+ * Canonical credential subtype names used by individual-controller and
+ * subject-side member access flows.
+ */
+export declare const IndividualCredentialTypes: Readonly<{
+    IndividualControllerCredential: "IndividualControllerCredential";
+    IndividualMemberCredential: "IndividualMemberCredential";
+    IndividualSubjectCredential: "IndividualSubjectCredential";
+}>;
 /**
  * Canonical credential subtype names used by inter-tenant authorization
  * contracts for cross-organization access.

package/dist/constants/verifiable-credentials.js

@@ -38,6 +38,15 @@ export const ActivationCredentialTypes = Object.freeze({
 export const ProfessionalCredentialTypes = Object.freeze({
     EmployeeCredential: 'EmployeeCredential',
 });
+/**
+ * Canonical credential subtype names used by individual-controller and
+ * subject-side member access flows.
+ */
+export const IndividualCredentialTypes = Object.freeze({
+    IndividualControllerCredential: 'IndividualControllerCredential',
+    IndividualMemberCredential: 'IndividualMemberCredential',
+    IndividualSubjectCredential: 'IndividualSubjectCredential',
+});
 /**
  * Canonical credential subtype names used by inter-tenant authorization
  * contracts for cross-organization access.

package/dist/examples/bundle-didcomm-payload.js

@@ -1,4 +1,6 @@
 // Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { DidcommMessageTypes } from '../constants/didcomm.js';
+import { BundleDidcommEntryTypes } from '../utils/bundle-didcomm-payload.js';
 import { EXAMPLE_GATEWAY_PUBLIC_ORIGIN, } from './shared.js';
 /**
  * Shared synthetic DIDComm fixtures for direct Bundle payload tests.
@@ -7,7 +9,7 @@ export const EXAMPLE_DIDCOMM_BUNDLE_ISS = 'did:web:portal.example.org';
 export const EXAMPLE_DIDCOMM_BUNDLE_AUD = `${EXAMPLE_GATEWAY_PUBLIC_ORIGIN}/bundle`;
 export const EXAMPLE_DIDCOMM_BUNDLE_JTI = 'didcomm-bundle-jti-001';
 export const EXAMPLE_DIDCOMM_BUNDLE_THID = 'didcomm-bundle-thread-001';
-export const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_TYPE = 'Bundle-batch-request-v1.0';
+export const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_TYPE = BundleDidcommEntryTypes.Batch;
 export const EXAMPLE_DIDCOMM_BUNDLE_REPLY_AUD = `${EXAMPLE_GATEWAY_PUBLIC_ORIGIN}/bundle-reply`;
 export const EXAMPLE_DIDCOMM_BUNDLE_REPLY_JTI = 'didcomm-bundle-reply-jti-001';
-export const EXAMPLE_DIDCOMM_BUNDLE_ACK_TYPE = 'Bundle-ack-v1.0';
+export const EXAMPLE_DIDCOMM_BUNDLE_ACK_TYPE = DidcommMessageTypes.BundleAck;