gdc-common-utils-ts 2.0.18 → 2.2.2

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

@@ -6,7 +6,8 @@ import { CommunicationCategoryCodes } from '../constants/communication.js';
 import { DataspaceSectors } from '../constants/sectors.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_CONSENT_PURPOSE_EMERGENCY_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_GENERALIST_MEDICAL_PRACTITIONER, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_HEALTHCARE_JURISDICTION, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_PROVIDER_ORGANIZATION_DID, EXAMPLE_SECONDARY_HEALTHCARE_JURISDICTION, EXAMPLE_SUBJECT_DID, } from './shared.js';
-import { CommunicationAttachedBundleSession, createConsentAccessEditor, } from '../utils/communication-attached-bundle-session.js';
+import { CommunicationAttachedBundleSession, CommunicationClaimsContext, BundleEntryClaimsContext, } from '../utils/communication-attached-bundle-session.js';
+import { createConsentAccessEditor, } from '../utils/communication-consent-access-editor.js';
 import { setCommunicationCategory, setCommunicationIdentifier, setCommunicationSubject, setCommunicationText, setCommunicationTopic, } from '../claims/claims-helpers-communication.js';
 import { setActorIdentifierList, setActorRoleList, setConsentDate, setConsentDecision, setConsentIdentifier, setConsentPeriodEnd, setConsentPeriodStart, setConsentSubject, setPurposeList, setSectionList, } from '../claims/claims-helpers-consent.js';
 import { setClaimValues } from '../claims/claim-list-helpers.js';
@@ -21,16 +22,16 @@ const CONSENT_BUNDLE_COMMUNICATION_TOPIC = HealthcareKindOfDocumentSections['LP1
  * - release active entry memory when finished
  */
 export function buildConsentEditingCommunicationSessionExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
+    let communicationClaims = { '@context': CommunicationClaimsContext };
     communicationClaims = setCommunicationIdentifier(communicationClaims, EXAMPLE_COMMUNICATION_IDENTIFIER);
     communicationClaims = setCommunicationSubject(communicationClaims, EXAMPLE_SUBJECT_DID);
     communicationClaims = setCommunicationCategory(communicationClaims, CommunicationCategoryCodes.Notification.attributeValue);
     communicationClaims = setCommunicationTopic(communicationClaims, CONSENT_BUNDLE_COMMUNICATION_TOPIC);
     communicationClaims = setCommunicationText(communicationClaims, EXAMPLE_IPS_BUNDLE_NOTE_TEXT);
-    const bundleEditor = new CommunicationAttachedBundleSession({
+    const consentBundleEditor = new CommunicationAttachedBundleSession({
         communicationClaims,
     });
-    let consentClaims = { '@context': 'org.hl7.fhir.api' };
+    let consentClaims = { '@context': BundleEntryClaimsContext };
     consentClaims = setConsentDecision(consentClaims, ConsentDecisions.Permit);
     consentClaims = setConsentSubject(consentClaims, EXAMPLE_SUBJECT_DID);
     consentClaims = setConsentIdentifier(consentClaims, EXAMPLE_CONSENT_IDENTIFIER);
@@ -43,14 +44,14 @@ export function buildConsentEditingCommunicationSessionExample() {
     ]);
     consentClaims = setActorIdentifierList(consentClaims, [EXAMPLE_EMAIL_PROFESSIONAL]);
     consentClaims = setActorRoleList(consentClaims, [EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN]);
-    bundleEditor.upsertActiveConsentEntry({
+    consentBundleEditor.upsertActiveConsentEntry({
         claims: consentClaims,
         fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
     });
-    bundleEditor.saveAndReleaseActiveEntry();
+    consentBundleEditor.saveAndReleaseActiveEntry();
     return {
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
+        communicationClaims: consentBundleEditor.getCommunicationClaims(),
+        bundleInMemory: consentBundleEditor.getBundleInMemory(),
     };
 }
 /**
@@ -60,17 +61,17 @@ export function buildConsentEditingCommunicationSessionExample() {
  * - apply save/release lifecycle consistently
  */
 export function buildMedicationEditingCommunicationSessionExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
+    let communicationClaims = { '@context': CommunicationClaimsContext };
     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 CommunicationAttachedBundleSession({
+    const clinicalBundleEditor = new CommunicationAttachedBundleSession({
         communicationClaims,
     });
-    bundleEditor.upsertActiveMedicationStatementEntry({
+    clinicalBundleEditor.upsertActiveMedicationStatementEntry({
         claims: {
-            '@context': 'org.hl7.fhir.api',
+            '@context': BundleEntryClaimsContext,
             [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
             [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
@@ -78,10 +79,10 @@ export function buildMedicationEditingCommunicationSessionExample() {
         },
         fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
     });
-    bundleEditor.saveAndReleaseActiveEntry();
+    clinicalBundleEditor.saveAndReleaseActiveEntry();
     return {
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
+        communicationClaims: clinicalBundleEditor.getCommunicationClaims(),
+        bundleInMemory: clinicalBundleEditor.getBundleInMemory(),
     };
 }
 /**
@@ -93,7 +94,7 @@ export function buildMedicationEditingCommunicationSessionExample() {
  * the roundtrip keeps the same claims.
  */
 export function buildConsentPermissionTemplateImportExportSessionExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
+    let communicationClaims = { '@context': CommunicationClaimsContext };
     communicationClaims = setCommunicationIdentifier(communicationClaims, EXAMPLE_COMMUNICATION_IDENTIFIER);
     communicationClaims = setCommunicationSubject(communicationClaims, EXAMPLE_SUBJECT_DID);
     communicationClaims = setCommunicationCategory(communicationClaims, CommunicationCategoryCodes.Notification.attributeValue);
@@ -127,7 +128,7 @@ export function buildConsentPermissionTemplateImportExportSessionExample() {
             ResourceTypesFhirR4.DocumentReference,
         ],
     };
-    let consentClaims = { '@context': 'org.hl7.fhir.api' };
+    let consentClaims = { '@context': BundleEntryClaimsContext };
     consentClaims = setConsentDecision(consentClaims, templateDraft.decision);
     consentClaims = setConsentSubject(consentClaims, EXAMPLE_SUBJECT_DID);
     consentClaims = setConsentIdentifier(consentClaims, EXAMPLE_CONSENT_IDENTIFIER);
@@ -139,16 +140,16 @@ export function buildConsentPermissionTemplateImportExportSessionExample() {
     consentClaims = setActorRoleList(consentClaims, templateDraft.actorRoles);
     consentClaims = setSectionList(consentClaims, templateDraft.sections);
     consentClaims = setClaimValues(consentClaims, ClaimConsent.resourceType, templateDraft.resourceTypes);
-    const bundleEditor = createConsentAccessEditor({
+    const consentBundleEditor = createConsentAccessEditor({
         communicationClaims,
     });
-    bundleEditor.upsertActiveConsentEntry({
+    consentBundleEditor.upsertActiveConsentEntry({
         claims: consentClaims,
         fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
     });
-    bundleEditor.saveAndReleaseActiveEntry();
+    consentBundleEditor.saveAndReleaseActiveEntry();
     const reloadedEditor = createConsentAccessEditor({
-        communicationClaims: bundleEditor.getCommunicationClaims(),
+        communicationClaims: consentBundleEditor.getCommunicationClaims(),
     });
     reloadedEditor.selectActiveEntry({
         fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
@@ -171,7 +172,7 @@ export function buildConsentPermissionTemplateImportExportSessionExample() {
  * deterministic coverage and reusable fixtures.
  */
 export function buildSeparateConsentPermissionBundleExample() {
-    let communicationClaims = { '@context': 'org.hl7.fhir.r4' };
+    let communicationClaims = { '@context': CommunicationClaimsContext };
     communicationClaims = setCommunicationIdentifier(communicationClaims, EXAMPLE_COMMUNICATION_IDENTIFIER);
     communicationClaims = setCommunicationSubject(communicationClaims, EXAMPLE_SUBJECT_DID);
     communicationClaims = setCommunicationCategory(communicationClaims, CommunicationCategoryCodes.Notification.attributeValue);
@@ -239,7 +240,7 @@ export function buildSeparateConsentPermissionBundleExample() {
             },
         ],
     });
-    const bundleEditor = createConsentAccessEditor({
+    const consentBundleEditor = createConsentAccessEditor({
         communicationClaims,
     });
     const decisions = [
@@ -253,7 +254,7 @@ export function buildSeparateConsentPermissionBundleExample() {
             subject: EXAMPLE_SUBJECT_DID,
             fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}-${index + 1}`,
         });
-        bundleEditor.upsertActiveConsentEntry({
+        consentBundleEditor.upsertActiveConsentEntry({
             claims: {
                 ...(consentEntry.resource?.meta?.claims || {}),
             },
@@ -261,10 +262,10 @@ export function buildSeparateConsentPermissionBundleExample() {
             type: consentEntry.type,
         });
     });
-    bundleEditor.saveAndReleaseActiveEntry();
+    consentBundleEditor.saveAndReleaseActiveEntry();
     return {
         decisions,
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
+        communicationClaims: consentBundleEditor.getCommunicationClaims(),
+        bundleInMemory: consentBundleEditor.getBundleInMemory(),
     };
 }

package/dist/examples/communication-didcomm-payload.d.ts

@@ -0,0 +1,39 @@
+import { AppointmentParticipantStatus, AppointmentStatus } from '../models/interoperable-claims/appointment-claims';
+/**
+ * Shared synthetic DIDComm fixtures for Communication-attached bundle tests.
+ */
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_ISS: "did:web:portal.example.org";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_AUD: "https://gateway.example.com/request";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_JTI: "didcomm-communication-jti-001";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_THID: "didcomm-communication-thread-001";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_ENTRY_TYPE: "Communication-attached-bundle-v1.0";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_TEXT: "IPS ingestion request";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_ID: "urn:uuid:communication-example-001";
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_SUBJECT: string;
+export declare const EXAMPLE_DIDCOMM_COMMUNICATION_ATTACHMENT_CONTEXT: "org.hl7.fhir.api";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_CONTEXT: "org.hl7.fhir.api";
+export declare const EXAMPLE_DIDCOMM_REPLY_AUD: "https://gateway.example.com/reply";
+export declare const EXAMPLE_DIDCOMM_REPLY_JTI: "didcomm-communication-reply-jti-001";
+export declare const EXAMPLE_DIDCOMM_REPLY_TYPE: "Communication-ack-v1.0";
+export declare const EXAMPLE_DIDCOMM_REPLY_BODY_OK_KEY: "ok";
+export declare const EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY: "receivedMedicationIdentifier";
+export declare const EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY: "receivedDocumentIdentifier";
+export declare const EXAMPLE_DIDCOMM_ACK_TYPE: "Communication-ack-v1.0";
+export declare const EXAMPLE_DIDCOMM_ACK_BODY_OK_KEY: "ok";
+export declare const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY: "receivedMedicationIdentifier";
+export declare const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY: "receivedDocumentIdentifier";
+export declare const EXAMPLE_APPOINTMENT_IDENTIFIER: "appointment-001";
+export declare const EXAMPLE_APPOINTMENT_START: "2026-07-01T09:00:00Z";
+export declare const EXAMPLE_APPOINTMENT_END: "2026-07-01T09:30:00Z";
+export declare const EXAMPLE_APPOINTMENT_DESCRIPTION: "Medication follow-up visit.";
+export declare const EXAMPLE_APPOINTMENT_PARTICIPANT_STATUS = AppointmentParticipantStatus.Accepted;
+export declare const EXAMPLE_APPOINTMENT_CLAIMS: {
+    readonly '@context': "org.hl7.fhir.api";
+    readonly "Appointment.identifier": "appointment-001";
+    readonly "Appointment.status": AppointmentStatus.Booked;
+    readonly "Appointment.description": "Medication follow-up visit.";
+    readonly "Appointment.start": "2026-07-01T09:00:00Z";
+    readonly "Appointment.end": "2026-07-01T09:30:00Z";
+    readonly "Appointment.participant.actor": `${string},${string}`;
+    readonly "Appointment.participant.status": AppointmentParticipantStatus.Accepted;
+};

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

@@ -0,0 +1,44 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { DidcommAckBodyKeys, DidcommMessageTypes, } from '../constants/didcomm.js';
+import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_GATEWAY_PUBLIC_ORIGIN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_PROFESSIONAL_DID, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { AppointmentClaim, AppointmentParticipantStatus, AppointmentStatus, } from '../models/interoperable-claims/appointment-claims.js';
+import { BundleEntryClaimsContext, CommunicationClaimsContext, } from '../models/communication-attached-bundle-session.js';
+import { CommunicationDidcommEntryTypes } from '../utils/communication-didcomm-payload.js';
+/**
+ * Shared synthetic DIDComm fixtures for Communication-attached bundle tests.
+ */
+export const EXAMPLE_DIDCOMM_COMMUNICATION_ISS = 'did:web:portal.example.org';
+export const EXAMPLE_DIDCOMM_COMMUNICATION_AUD = `${EXAMPLE_GATEWAY_PUBLIC_ORIGIN}/request`;
+export const EXAMPLE_DIDCOMM_COMMUNICATION_JTI = 'didcomm-communication-jti-001';
+export const EXAMPLE_DIDCOMM_COMMUNICATION_THID = 'didcomm-communication-thread-001';
+export const EXAMPLE_DIDCOMM_COMMUNICATION_ENTRY_TYPE = CommunicationDidcommEntryTypes.AttachedBundle;
+export const EXAMPLE_DIDCOMM_COMMUNICATION_TEXT = EXAMPLE_IPS_BUNDLE_NOTE_TEXT;
+export const EXAMPLE_DIDCOMM_COMMUNICATION_ID = EXAMPLE_COMMUNICATION_IDENTIFIER;
+export const EXAMPLE_DIDCOMM_COMMUNICATION_SUBJECT = EXAMPLE_SUBJECT_DID;
+export const EXAMPLE_DIDCOMM_COMMUNICATION_ATTACHMENT_CONTEXT = CommunicationClaimsContext;
+export const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_CONTEXT = BundleEntryClaimsContext;
+export const EXAMPLE_DIDCOMM_REPLY_AUD = `${EXAMPLE_GATEWAY_PUBLIC_ORIGIN}/reply`;
+export const EXAMPLE_DIDCOMM_REPLY_JTI = 'didcomm-communication-reply-jti-001';
+export const EXAMPLE_DIDCOMM_REPLY_TYPE = DidcommMessageTypes.CommunicationAck;
+export const EXAMPLE_DIDCOMM_REPLY_BODY_OK_KEY = DidcommAckBodyKeys.Ok;
+export const EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY = DidcommAckBodyKeys.ReceivedMedicationIdentifier;
+export const EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY = DidcommAckBodyKeys.ReceivedDocumentIdentifier;
+export const EXAMPLE_DIDCOMM_ACK_TYPE = EXAMPLE_DIDCOMM_REPLY_TYPE;
+export const EXAMPLE_DIDCOMM_ACK_BODY_OK_KEY = EXAMPLE_DIDCOMM_REPLY_BODY_OK_KEY;
+export const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY = EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY;
+export const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY = EXAMPLE_DIDCOMM_REPLY_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY;
+export const EXAMPLE_APPOINTMENT_IDENTIFIER = 'appointment-001';
+export const EXAMPLE_APPOINTMENT_START = '2026-07-01T09:00:00Z';
+export const EXAMPLE_APPOINTMENT_END = '2026-07-01T09:30:00Z';
+export const EXAMPLE_APPOINTMENT_DESCRIPTION = 'Medication follow-up visit.';
+export const EXAMPLE_APPOINTMENT_PARTICIPANT_STATUS = AppointmentParticipantStatus.Accepted;
+export const EXAMPLE_APPOINTMENT_CLAIMS = {
+    '@context': BundleEntryClaimsContext,
+    [AppointmentClaim.Identifier]: EXAMPLE_APPOINTMENT_IDENTIFIER,
+    [AppointmentClaim.Status]: AppointmentStatus.Booked,
+    [AppointmentClaim.Description]: EXAMPLE_APPOINTMENT_DESCRIPTION,
+    [AppointmentClaim.Start]: EXAMPLE_APPOINTMENT_START,
+    [AppointmentClaim.End]: EXAMPLE_APPOINTMENT_END,
+    [AppointmentClaim.ParticipantActor]: `${EXAMPLE_SUBJECT_DID},${EXAMPLE_PROFESSIONAL_DID}`,
+    [AppointmentClaim.ParticipantStatus]: EXAMPLE_APPOINTMENT_PARTICIPANT_STATUS,
+};

package/dist/examples/consent-access.js

@@ -1,6 +1,7 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, } from '../constants/healthcare.js';
 import { ClaimConsent } from '../models/consent-rule.js';
+import { BundleEntryClaimsContext } from '../models/communication-attached-bundle-session.js';
 import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
 import { EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON, EXAMPLE_HEALTHCARE_JURISDICTION, EXAMPLE_PROVIDER_ORGANIZATION_DID, EXAMPLE_RELATED_PERSON_ROLE, EXAMPLE_SUBJECT_DID, } from './shared.js';
 export const EXAMPLE_INDIVIDUAL_DID_WEB = EXAMPLE_SUBJECT_DID;
@@ -25,7 +26,7 @@ export const EXAMPLE_CONSENT_ACCESS_RELATED_PERSON_EMAIL = EXAMPLE_EMAIL_RELATED
  */
 function buildRule(input) {
     return {
-        '@context': 'org.hl7.fhir.api',
+        '@context': BundleEntryClaimsContext,
         [ClaimConsent.identifier]: input.identifier,
         [ClaimConsent.subject]: EXAMPLE_INDIVIDUAL_DID_WEB,
         [ClaimConsent.actorIdentifier]: input.actorIdentifier,

package/dist/examples/employee.d.ts

@@ -20,6 +20,12 @@ export type ExampleEmployeeRecord = Readonly<{
 export declare const ExampleEmployeeEmails: Readonly<{
     readonly SharedProfessional: "shared.professional@example.org";
 }>;
+export declare const ExampleEmployeeTelephones: Readonly<{
+    readonly SharedProfessional: "+34 600 111 222";
+}>;
+export declare const ExampleEmployeeCredentialMaterials: Readonly<{
+    readonly SharedProfessionalSigningKid: "did:key:z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t#z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t";
+}>;
 export declare const ExampleEmployeeRoles: Readonly<{
     readonly Controller: "ISCO-08|1120";
     readonly Doctor: "ISCO-08|2211";
@@ -46,6 +52,21 @@ export declare const EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS: readonly [Readonly<{
     role: string;
     status: "active" | "inactive" | "purged";
 }>];
+/**
+ * Canonical professional identity fixture reused by SMART/OpenID4VP tests and
+ * SDK facade helpers.
+ *
+ * The public continuity alias is intentionally the employee email; phone is
+ * kept separate so callers can hash/project it into
+ * `org.schema.Person.telephone` without overloading `sameAs`.
+ */
+export declare const EXAMPLE_PROFESSIONAL_IDENTITY: Readonly<{
+    readonly actorDid: string;
+    readonly role: string;
+    readonly email: string;
+    readonly telephone: "+34 600 111 222";
+    readonly credentialMaterial: "did:key:z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t#z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t";
+}>;
 export declare function buildExampleEmployeeClaims(record: ExampleEmployeeRecord): Readonly<Record<string, string>>;
 /**
  * Canonical employee search/list response body reused by runtime and doc tests.

package/dist/examples/employee.js

@@ -2,6 +2,12 @@ import { ClaimsPersonSchemaorg } from '../constants/schemaorg.js';
 export const ExampleEmployeeEmails = Object.freeze({
     SharedProfessional: 'shared.professional@example.org',
 });
+export const ExampleEmployeeTelephones = Object.freeze({
+    SharedProfessional: '+34 600 111 222',
+});
+export const ExampleEmployeeCredentialMaterials = Object.freeze({
+    SharedProfessionalSigningKid: 'did:key:z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t#z6Mkt2p7vKov6R6By7QjFv2F5x8f4H9g2m3c4n5p6q7r8s9t',
+});
 export const ExampleEmployeeRoles = Object.freeze({
     Controller: 'ISCO-08|1120',
     Doctor: 'ISCO-08|2211',
@@ -32,6 +38,21 @@ export const EXAMPLE_EMPLOYEE_DIRECTORY_RECORDS = Object.freeze([
     EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE,
     EXAMPLE_EMPLOYEE_DOCTOR_PURGED_HISTORICAL,
 ]);
+/**
+ * Canonical professional identity fixture reused by SMART/OpenID4VP tests and
+ * SDK facade helpers.
+ *
+ * The public continuity alias is intentionally the employee email; phone is
+ * kept separate so callers can hash/project it into
+ * `org.schema.Person.telephone` without overloading `sameAs`.
+ */
+export const EXAMPLE_PROFESSIONAL_IDENTITY = Object.freeze({
+    actorDid: EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.identifier,
+    role: EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.role,
+    email: EXAMPLE_EMPLOYEE_DOCTOR_ACTIVE.email,
+    telephone: ExampleEmployeeTelephones.SharedProfessional,
+    credentialMaterial: ExampleEmployeeCredentialMaterials.SharedProfessionalSigningKid,
+});
 export function buildExampleEmployeeClaims(record) {
     return Object.freeze({
         '@context': 'org.schema',

package/dist/examples/index.d.ts

@@ -20,6 +20,10 @@ export * from './lifecycle';
 export * from './api-flow-examples';
 export * from './contract-examples';
 export * from './communication-attached-bundle-session';
+export * from './bundle-didcomm-payload';
 export * from './communication-bundle-document-request';
+export * from './communication-didcomm-payload';
 export * from './ips-bundle';
 export * from './vital-signs';
+export * from './wallet-mem';
+export * from './profile-manager-mem';

package/dist/examples/index.js

@@ -20,6 +20,10 @@ export * from './lifecycle.js';
 export * from './api-flow-examples.js';
 export * from './contract-examples.js';
 export * from './communication-attached-bundle-session.js';
+export * from './bundle-didcomm-payload.js';
 export * from './communication-bundle-document-request.js';
+export * from './communication-didcomm-payload.js';
 export * from './ips-bundle.js';
 export * from './vital-signs.js';
+export * from './wallet-mem.js';
+export * from './profile-manager-mem.js';

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

@@ -52,6 +52,33 @@ export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_ORDER_RESPONSE: {
         readonly attempts: 1;
     };
 };
+export declare const EXAMPLE_INDIVIDUAL_CONTROLLER_IDENTITY: Readonly<{
+    readonly actorDid: "did:web:people.acme.org:controllers:primary";
+    readonly subjectDid: string;
+    readonly relationship: "v3-RoleCode|RESPRSN";
+    readonly authorityBasis: "parental-authority";
+    readonly email: "ana.parent@example.org";
+    readonly telephone: "+34000000001";
+    readonly credentialMaterial: "did:web:people.acme.org:controllers:primary#signing-key-1";
+    readonly evidence: readonly [{
+        readonly type: readonly ["DocumentVerification"];
+        readonly evidenceDocument: "LibroDeFamilia";
+        readonly verifier: "did:web:kyc.example.org";
+    }];
+}>;
+export declare const EXAMPLE_INDIVIDUAL_SUBJECT_IDENTITY: Readonly<{
+    readonly subjectDid: string;
+    readonly sameAs: "mailto:subject.guardian.record@example.org";
+    readonly telephone: "+34000000001";
+    readonly evidence: readonly [{
+        readonly type: readonly ["DocumentVerification"];
+        readonly evidenceDocument: "DNI";
+        readonly verifier: "did:web:kyc.example.org";
+    }];
+    readonly additionalCredentialSubject: {
+        readonly alternateName: "Ana";
+    };
+}>;
 export declare const EXAMPLE_CONSENT_GRANT_INPUT: {
     readonly actor: "did:web:practitioner.example,ES";
     readonly actorRole: "physician";

package/dist/examples/individual-controller.js

@@ -1,5 +1,5 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-import { EXAMPLE_API_ORGANIZATION_DID, EXAMPLE_CLINICAL_CODE_PROBLEM, EXAMPLE_CLINICAL_DATE_RANGE, EXAMPLE_CLINICAL_SECTION_ALLERGIES, EXAMPLE_CLINICAL_SECTION_PATIENT_SUMMARY, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL, EXAMPLE_GENERIC_SUBJECT_DID, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_HEALTHCARE_JURISDICTION, EXAMPLE_HEALTHCARE_ROLE_PHYSICIAN_TEXT, EXAMPLE_PRACTITIONER_DID, EXAMPLE_PROFESSIONAL_DID, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { EXAMPLE_CONTROLLER_DID, EXAMPLE_API_ORGANIZATION_DID, EXAMPLE_CLINICAL_CODE_PROBLEM, EXAMPLE_CLINICAL_DATE_RANGE, EXAMPLE_CLINICAL_SECTION_ALLERGIES, EXAMPLE_CLINICAL_SECTION_PATIENT_SUMMARY, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL, EXAMPLE_GENERIC_SUBJECT_DID, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_HEALTHCARE_JURISDICTION, EXAMPLE_HEALTHCARE_ROLE_PHYSICIAN_TEXT, EXAMPLE_PRACTITIONER_DID, EXAMPLE_PROFESSIONAL_DID, EXAMPLE_SUBJECT_DID, EXAMPLE_FORM_CONTROLLER_PHONE, } from './shared.js';
 export const EXAMPLE_INDIVIDUAL_ORGANIZATION_START_INPUT = {
     alternateName: 'ana',
     controllerEmail: EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL,
@@ -21,6 +21,33 @@ export const EXAMPLE_INDIVIDUAL_ORGANIZATION_ORDER_RESPONSE = {
     submit: { status: 202, body: {} },
     poll: { status: 200, body: {}, attempts: 1 },
 };
+export const EXAMPLE_INDIVIDUAL_CONTROLLER_IDENTITY = Object.freeze({
+    actorDid: EXAMPLE_CONTROLLER_DID,
+    subjectDid: EXAMPLE_SUBJECT_DID,
+    relationship: 'v3-RoleCode|RESPRSN',
+    authorityBasis: 'parental-authority',
+    email: EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL,
+    telephone: EXAMPLE_FORM_CONTROLLER_PHONE,
+    credentialMaterial: `${EXAMPLE_CONTROLLER_DID}#signing-key-1`,
+    evidence: [{
+            type: ['DocumentVerification'],
+            evidenceDocument: 'LibroDeFamilia',
+            verifier: 'did:web:kyc.example.org',
+        }],
+});
+export const EXAMPLE_INDIVIDUAL_SUBJECT_IDENTITY = Object.freeze({
+    subjectDid: EXAMPLE_SUBJECT_DID,
+    sameAs: 'mailto:subject.guardian.record@example.org',
+    telephone: EXAMPLE_FORM_CONTROLLER_PHONE,
+    evidence: [{
+            type: ['DocumentVerification'],
+            evidenceDocument: 'DNI',
+            verifier: 'did:web:kyc.example.org',
+        }],
+    additionalCredentialSubject: {
+        alternateName: 'Ana',
+    },
+});
 export const EXAMPLE_CONSENT_GRANT_INPUT = {
     actor: `${EXAMPLE_PRACTITIONER_DID},${EXAMPLE_HEALTHCARE_JURISDICTION}`,
     actorRole: EXAMPLE_HEALTHCARE_ROLE_PHYSICIAN_TEXT,

package/dist/examples/inter-tenant-access-contract.js

@@ -3,6 +3,7 @@ import { ServiceCapability } from '../constants/service-capabilities.js';
 import { DataspaceSectors } from '../constants/sectors.js';
 import { ClaimConsent } from '../models/consent-rule.js';
 import { ClaimInterTenantAccessContract } from '../models/inter-tenant-access-contract.js';
+import { BundleEntryClaimsContext } from '../models/communication-attached-bundle-session.js';
 import { buildInterTenantAccessContractCredential, buildInterTenantAccessContractResource, getInterTenantAccessContractBlockchainReference, } from '../utils/inter-tenant-access-contract.js';
 import { buildMemberAuthorizationUrn, buildOrganizationAuthorizationUrn, } from '../utils/organization-authorization-urn.js';
 import { EXAMPLE_API_ORGANIZATION_DID, EXAMPLE_CONTROLLER_DID, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_JURISDICTION, EXAMPLE_RESEARCH_API_ORGANIZATION_DID, EXAMPLE_RESEARCH_CONTROLLER_DID, EXAMPLE_RESEARCH_TENANT_IDENTIFIER, EXAMPLE_SECTOR, EXAMPLE_TENANT_IDENTIFIER, } from './shared.js';
@@ -105,7 +106,7 @@ export const EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_CONTEXT_WITH_URNS = Object.fre
  *   reference that was or will be anchored on-chain
  */
 export const EXAMPLE_INTER_TENANT_EMPLOYEE_CONTRACT_AUTHORIZATION_CONSENT = Object.freeze({
-    '@context': 'org.hl7.fhir.api',
+    '@context': BundleEntryClaimsContext,
     [ClaimConsent.identifier]: 'urn:uuid:employee-contract-authorization-001',
     [ClaimConsent.subject]: EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_CONSUMER_ORGANIZATION_URN,
     [ClaimConsent.actorIdentifier]: EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_CONSUMER_MEMBER_URN,
@@ -119,7 +120,7 @@ export const EXAMPLE_INTER_TENANT_EMPLOYEE_CONTRACT_AUTHORIZATION_CONSENT = Obje
     [ClaimConsent.periodEnd]: EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_VALID_UNTIL,
 });
 export const EXAMPLE_INTER_TENANT_PROVIDER_CONTRACT_AUTHORIZATION_CONSENT = Object.freeze({
-    '@context': 'org.hl7.fhir.api',
+    '@context': BundleEntryClaimsContext,
     [ClaimConsent.identifier]: 'urn:uuid:provider-contract-authorization-001',
     [ClaimConsent.subject]: EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_PROVIDER_ORGANIZATION_URN,
     [ClaimConsent.actorIdentifier]: EXAMPLE_INTER_TENANT_ACCESS_CONTRACT_CONSUMER_ORGANIZATION_URN,

package/dist/examples/ips-bundle.js

@@ -6,6 +6,7 @@ import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
 import { ConditionClaim } from '../models/interoperable-claims/condition-claims.js';
 import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
+import { BundleEntryClaimsContext, CommunicationClaimsContext, } from '../models/communication-attached-bundle-session.js';
 import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF, EXAMPLE_DOCUMENT_REFERENCE_DATE, EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION, EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER, EXAMPLE_DOCUMENT_REFERENCE_URL, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
 import { toClinicalResourceCardViews, toClinicalResourceCommonViews, } from '../utils/clinical-resource-view.js';
 import { CommunicationAttachedBundleSession } from '../utils/communication-attached-bundle-session.js';
@@ -14,18 +15,18 @@ import { CommunicationAttachedBundleSession } from '../utils/communication-attac
  * authored as `resource.meta.claims`.
  */
 export function buildIpsClinicalHistoryBundleExample() {
-    const bundleEditor = new CommunicationAttachedBundleSession({
+    const clinicalBundleEditor = new CommunicationAttachedBundleSession({
         communicationClaims: {
-            '@context': 'org.hl7.fhir.r4',
+            '@context': CommunicationClaimsContext,
             [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
             [CommunicationClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [CommunicationClaim.Category]: CommunicationCategoryCodes.Notification.claim,
             [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
         },
     });
-    bundleEditor.upsertActiveAllergyIntoleranceEntry({
+    clinicalBundleEditor.upsertActiveAllergyIntoleranceEntry({
         claims: {
-            '@context': 'org.hl7.fhir.api',
+            '@context': BundleEntryClaimsContext,
             [AllergyIntoleranceClaim.Identifier]: 'allergy-1',
             [AllergyIntoleranceClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [AllergyIntoleranceClaim.Code]: 'http://snomed.info/sct|227493005',
@@ -37,9 +38,9 @@ export function buildIpsClinicalHistoryBundleExample() {
         },
         fullUrl: 'urn:uuid:allergy-1',
     });
-    bundleEditor.upsertActiveConditionEntry({
+    clinicalBundleEditor.upsertActiveConditionEntry({
         claims: {
-            '@context': 'org.hl7.fhir.api',
+            '@context': BundleEntryClaimsContext,
             [ConditionClaim.Identifier]: 'condition-1',
             [ConditionClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [ConditionClaim.Code]: 'http://snomed.info/sct|44054006',
@@ -51,9 +52,9 @@ export function buildIpsClinicalHistoryBundleExample() {
         },
         fullUrl: 'urn:uuid:condition-1',
     });
-    bundleEditor.upsertActiveMedicationStatementEntry({
+    clinicalBundleEditor.upsertActiveMedicationStatementEntry({
         claims: {
-            '@context': 'org.hl7.fhir.api',
+            '@context': BundleEntryClaimsContext,
             [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
             [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [MedicationStatementClaim.Category]: HealthcareBasicSections.HistoryOfMedicationUse.attributeValue,
@@ -63,17 +64,17 @@ export function buildIpsClinicalHistoryBundleExample() {
         },
         fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
     });
-    bundleEditor.addContainedDocumentToActiveEntry({
+    clinicalBundleEditor.addContainedDocumentToActiveEntry({
         identifier: EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER,
         attachmentContentType: EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF,
         attachmentUrl: EXAMPLE_DOCUMENT_REFERENCE_URL,
         description: EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION,
         date: EXAMPLE_DOCUMENT_REFERENCE_DATE,
     });
-    bundleEditor.saveAndReleaseActiveEntry();
+    clinicalBundleEditor.saveAndReleaseActiveEntry();
     return {
-        communicationClaims: bundleEditor.getCommunicationClaims(),
-        bundleInMemory: bundleEditor.getBundleInMemory(),
+        communicationClaims: clinicalBundleEditor.getCommunicationClaims(),
+        bundleInMemory: clinicalBundleEditor.getBundleInMemory(),
     };
 }
 /**
@@ -82,22 +83,22 @@ export function buildIpsClinicalHistoryBundleExample() {
  */
 export function buildIpsBundleFrontCardsExample() {
     const { communicationClaims, bundleInMemory } = buildIpsClinicalHistoryBundleExample();
-    const bundleEditor = new CommunicationAttachedBundleSession({
+    const clinicalBundleEditor = new CommunicationAttachedBundleSession({
         communicationClaims,
         initialBundle: bundleInMemory,
     });
     return {
         communicationClaims,
         bundleInMemory,
-        medicationEntryIds: bundleEditor.getResourceIds({
+        medicationEntryIds: clinicalBundleEditor.getResourceIds({
             sections: [HealthcareBasicSections.HistoryOfMedicationUse.attributeValue],
             resourceTypes: [ResourceTypesFhirR4.MedicationStatement],
         }),
-        allergyEntryIds: bundleEditor.getResourceIds({
+        allergyEntryIds: clinicalBundleEditor.getResourceIds({
             sections: [HealthcareBasicSections.AllergiesAndIntolerances.attributeValue],
             resourceTypes: [ResourceTypesFhirR4.AllergyIntolerance],
         }),
-        conditionEntryIds: bundleEditor.getResourceIds({
+        conditionEntryIds: clinicalBundleEditor.getResourceIds({
             sections: [HealthcareBasicSections.ProblemList.attributeValue],
             resourceTypes: [ResourceTypesFhirR4.Condition],
         }),