gdc-common-utils-ts 2.0.18 → 2.2.2

package/dist/examples/lifecycle.js

@@ -1,7 +1,9 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { ClaimsOrganizationSchemaorg, ClaimsPersonSchemaorg, } from '../constants/schemaorg.js';
 import { LifecycleRequestType } from '../constants/lifecycle.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
 import { ClaimConsent } from '../models/consent-rule.js';
+import { BundleEntryClaimsContext } from '../models/communication-attached-bundle-session.js';
 import { IndividualOrganizationLifecycleEditor, IndividualOrganizationLifecycleOperations, } from '../utils/individual-organization-lifecycle.js';
 import { EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL, EXAMPLE_EMAIL_CONTROLLER_ORG, EXAMPLE_CLINICAL_SECTION_ALLERGIES, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_JURISDICTION, EXAMPLE_SECTOR, EXAMPLE_TENANT_IDENTIFIER, } from './shared.js';
 /**
@@ -16,8 +18,8 @@ export const EXAMPLE_LIFECYCLE_OPERATIONS = {
     disable: 'disable',
     delete: 'delete',
 };
-export const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE = 'Family-disable-request-v1.0';
-export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE = 'Family-purge-request-v1.0';
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE = LifecycleRequestType.IndividualOrganizationDisable;
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE = LifecycleRequestType.IndividualOrganizationPurge;
 export const EXAMPLE_TENANT_ENABLE_REQUEST_TYPE = LifecycleRequestType.TenantEnable;
 export const EXAMPLE_TENANT_DISABLE_REQUEST_TYPE = LifecycleRequestType.TenantDisable;
 export const EXAMPLE_TENANT_PURGE_REQUEST_TYPE = LifecycleRequestType.TenantPurge;
@@ -107,7 +109,7 @@ export const EXAMPLE_EMPLOYEE_DELETE_MESSAGE = {
 };
 export const EXAMPLE_TENANT_ENABLE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.enable,
-    resourceType: 'Organization',
+    resourceType: ResourceTypesFhirR4.Organization,
     routeContext: {
         tenantId: 'host',
         jurisdiction: EXAMPLE_JURISDICTION,
@@ -122,7 +124,7 @@ export const EXAMPLE_TENANT_ENABLE_MESSAGE = {
 };
 export const EXAMPLE_TENANT_DISABLE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.disable,
-    resourceType: 'Organization',
+    resourceType: ResourceTypesFhirR4.Organization,
     routeContext: {
         tenantId: 'host',
         jurisdiction: EXAMPLE_JURISDICTION,
@@ -142,7 +144,7 @@ export const EXAMPLE_TENANT_DISABLE_MESSAGE = {
 };
 export const EXAMPLE_TENANT_DELETE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.delete,
-    resourceType: 'Organization',
+    resourceType: ResourceTypesFhirR4.Organization,
     routeContext: {
         tenantId: 'host',
         jurisdiction: EXAMPLE_JURISDICTION,
@@ -234,14 +236,14 @@ export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_PAYLOAD = new IndividualOrgan
     .buildCurrentGwPayload();
 export const EXAMPLE_CONSENT_ENABLE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.enable,
-    resourceType: 'Consent',
+    resourceType: ResourceTypesFhirR4.Consent,
     routeContext: {
         tenantId: EXAMPLE_TENANT_IDENTIFIER,
         jurisdiction: EXAMPLE_JURISDICTION,
         sector: EXAMPLE_SECTOR,
     },
     claims: {
-        '@context': 'org.hl7.fhir.api',
+        '@context': BundleEntryClaimsContext,
         [ClaimConsent.identifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentIdentifier,
         [ClaimConsent.subject]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.individualSubjectDid,
         [ClaimConsent.actorIdentifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentActorIdentifier,
@@ -253,14 +255,14 @@ export const EXAMPLE_CONSENT_ENABLE_MESSAGE = {
 };
 export const EXAMPLE_CONSENT_DISABLE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.disable,
-    resourceType: 'Consent',
+    resourceType: ResourceTypesFhirR4.Consent,
     routeContext: {
         tenantId: EXAMPLE_TENANT_IDENTIFIER,
         jurisdiction: EXAMPLE_JURISDICTION,
         sector: EXAMPLE_SECTOR,
     },
     claims: {
-        '@context': 'org.hl7.fhir.api',
+        '@context': BundleEntryClaimsContext,
         [ClaimConsent.identifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentIdentifier,
         [ClaimConsent.subject]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.individualSubjectDid,
         [ClaimConsent.actorIdentifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentActorIdentifier,
@@ -272,14 +274,14 @@ export const EXAMPLE_CONSENT_DISABLE_MESSAGE = {
 };
 export const EXAMPLE_CONSENT_DELETE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.delete,
-    resourceType: 'Consent',
+    resourceType: ResourceTypesFhirR4.Consent,
     routeContext: {
         tenantId: EXAMPLE_TENANT_IDENTIFIER,
         jurisdiction: EXAMPLE_JURISDICTION,
         sector: EXAMPLE_SECTOR,
     },
     claims: {
-        '@context': 'org.hl7.fhir.api',
+        '@context': BundleEntryClaimsContext,
         [ClaimConsent.identifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentIdentifier,
         [ClaimConsent.subject]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.individualSubjectDid,
         [ClaimConsent.actorIdentifier]: EXAMPLE_LIFECYCLE_PLACEHOLDERS.consentActorIdentifier,

package/dist/examples/profile-manager-mem.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared synthetic fixtures for low-level profile/message-manager tests.
+ */
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_PROFILE_ID: "wallet-entity-sender-001";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_PROFILE_ID: "wallet-entity-recipient-001";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_DID: "did:web:portal.example.org";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_DID: "did:web:gw.example.org";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_DISPLAY_NAME: "Portal BFF Profile";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_DISPLAY_NAME: "GW Proxy Profile";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_TYPE: "Communication-response-v1.0";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_NOTE: "Gateway acknowledged the queued communication.";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_PORTAL_REPLY_AUD: "https://portal.example.org/reply";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_PORTAL_INBOX_AUD: "https://portal.example.org/inbox";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_PRIORITY_NORMAL: "normal";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_PRIORITY_EMERGENCY: "emergency";
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_PAYLOAD: {
+    readonly iss: "did:web:gw.example.org";
+    readonly aud: "https://portal.example.org/inbox";
+    readonly jti: "gateway-response-jti-001";
+    readonly thid: "wallet-thread-001";
+    readonly type: "Communication-response-v1.0";
+    readonly body: {
+        readonly ok: true;
+        readonly note: "Gateway acknowledged the queued communication.";
+    };
+};
+export declare const EXAMPLE_PROFILE_MANAGER_MEM_REQUEST_PAYLOAD: {
+    readonly iss: "did:web:sender.example.org";
+    readonly aud: "https://gw.example.org/submit";
+    readonly jti: "wallet-jti-001";
+    readonly thid: "wallet-thread-001";
+    readonly type: "Communication-bundle-submit-v1.0";
+    readonly body: {
+        readonly data: readonly [{
+            readonly id: "wallet-entry-001";
+            readonly type: "Communication-bundle-submit-v1.0";
+            readonly resource: {
+                readonly resourceType: "Communication";
+                readonly note: readonly [{
+                    readonly text: "Medication bundle ready for DIDComm transport.";
+                }];
+            };
+        }];
+    };
+};

package/dist/examples/profile-manager-mem.js

@@ -0,0 +1,30 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { DidcommMessageTypes } from '../constants/didcomm.js';
+import { EXAMPLE_WALLET_ENTITY_ID_RECIPIENT, EXAMPLE_WALLET_ENTITY_ID_SENDER, EXAMPLE_WALLET_MESSAGE_PAYLOAD, EXAMPLE_WALLET_PRIORITY_EMERGENCY, EXAMPLE_WALLET_PRIORITY_NORMAL, EXAMPLE_WALLET_THREAD_ID, } from './wallet-mem.js';
+/**
+ * Shared synthetic fixtures for low-level profile/message-manager tests.
+ */
+export const EXAMPLE_PROFILE_MANAGER_MEM_PROFILE_ID = EXAMPLE_WALLET_ENTITY_ID_SENDER;
+export const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_PROFILE_ID = EXAMPLE_WALLET_ENTITY_ID_RECIPIENT;
+export const EXAMPLE_PROFILE_MANAGER_MEM_DID = 'did:web:portal.example.org';
+export const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_DID = 'did:web:gw.example.org';
+export const EXAMPLE_PROFILE_MANAGER_MEM_DISPLAY_NAME = 'Portal BFF Profile';
+export const EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_DISPLAY_NAME = 'GW Proxy Profile';
+export const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_TYPE = DidcommMessageTypes.CommunicationResponse;
+export const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_NOTE = 'Gateway acknowledged the queued communication.';
+export const EXAMPLE_PROFILE_MANAGER_MEM_PORTAL_REPLY_AUD = 'https://portal.example.org/reply';
+export const EXAMPLE_PROFILE_MANAGER_MEM_PORTAL_INBOX_AUD = 'https://portal.example.org/inbox';
+export const EXAMPLE_PROFILE_MANAGER_MEM_PRIORITY_NORMAL = EXAMPLE_WALLET_PRIORITY_NORMAL;
+export const EXAMPLE_PROFILE_MANAGER_MEM_PRIORITY_EMERGENCY = EXAMPLE_WALLET_PRIORITY_EMERGENCY;
+export const EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_PAYLOAD = {
+    iss: EXAMPLE_PROFILE_MANAGER_MEM_GATEWAY_DID,
+    aud: EXAMPLE_PROFILE_MANAGER_MEM_PORTAL_INBOX_AUD,
+    jti: 'gateway-response-jti-001',
+    thid: EXAMPLE_WALLET_THREAD_ID,
+    type: EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_TYPE,
+    body: {
+        ok: true,
+        note: EXAMPLE_PROFILE_MANAGER_MEM_RESPONSE_NOTE,
+    },
+};
+export const EXAMPLE_PROFILE_MANAGER_MEM_REQUEST_PAYLOAD = EXAMPLE_WALLET_MESSAGE_PAYLOAD;

package/dist/examples/related-person.d.ts

@@ -7,6 +7,20 @@ export declare const EXAMPLE_RELATED_PERSON_PURGE_REQUEST_TYPE: "RelatedPerson-p
 export declare const EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID: "related-person-internal-001";
 export declare const EXAMPLE_RELATED_PERSON_SEARCH_URL: string;
 export declare const EXAMPLE_RELATED_PERSON_DISPLAY_NAME: "Jose Example";
+export declare const EXAMPLE_INDIVIDUAL_MEMBER_IDENTITY: Readonly<{
+    readonly actorDid: string;
+    readonly subjectDid: string;
+    readonly relationship: "v3-RoleCode|RESPRSN";
+    readonly authorityBasis: "family-book";
+    readonly email: "parent.guardian@example.org";
+    readonly telephone: "+34000000001";
+    readonly credentialMaterial: `${string}#signing-key-1`;
+    readonly evidence: readonly [{
+        readonly type: readonly ["DocumentVerification"];
+        readonly evidenceDocument: "LibroDeFamilia";
+        readonly verifier: "did:web:kyc.example.org";
+    }];
+}>;
 /**
  * Minimal semantic input used by SDK helpers to disable one subject-side
  * relationship record through the identifier-first lifecycle contract.

package/dist/examples/related-person.js

@@ -2,7 +2,7 @@
 import { RelatedPersonClaim } from '../models/interoperable-claims/related-person-claims.js';
 import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
 import { HL7_CODING_SYSTEM_V3_ROLE_CODE } from '../constants/hl7-roles.js';
-import { EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API, EXAMPLE_EMAIL_RELATED_PERSON, EXAMPLE_RELATED_PERSON_ACTIVE_NAME, EXAMPLE_RELATED_PERSON_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL, EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_NAME, EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP, EXAMPLE_RELATED_PERSON_ROLE, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API, EXAMPLE_EMAIL_RELATED_PERSON, EXAMPLE_FORM_CONTROLLER_PHONE, EXAMPLE_RELATED_PERSON_MEMBER_DID, EXAMPLE_RELATED_PERSON_ACTIVE_NAME, EXAMPLE_RELATED_PERSON_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL, EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_NAME, EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP, EXAMPLE_RELATED_PERSON_ROLE, EXAMPLE_SUBJECT_DID, } from './shared.js';
 import { createInteroperableResourceOperationEditor, InteroperableOperationMethods, buildInteroperableSearchPath, InteroperableLifecycleStatuses, } from '../utils/interoperable-resource-operation.js';
 import { LifecycleRequestType } from '../constants/lifecycle.js';
 /**
@@ -14,6 +14,20 @@ export const EXAMPLE_RELATED_PERSON_PURGE_REQUEST_TYPE = LifecycleRequestType.Re
 export const EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID = 'related-person-internal-001';
 export const EXAMPLE_RELATED_PERSON_SEARCH_URL = buildInteroperableSearchPath(EXAMPLE_RELATED_PERSON_RESOURCE_TYPE);
 export const EXAMPLE_RELATED_PERSON_DISPLAY_NAME = EXAMPLE_RELATED_PERSON_ACTIVE_NAME;
+export const EXAMPLE_INDIVIDUAL_MEMBER_IDENTITY = Object.freeze({
+    actorDid: EXAMPLE_RELATED_PERSON_MEMBER_DID,
+    subjectDid: EXAMPLE_SUBJECT_DID,
+    relationship: EXAMPLE_RELATED_PERSON_ROLE,
+    authorityBasis: 'family-book',
+    email: EXAMPLE_EMAIL_RELATED_PERSON,
+    telephone: EXAMPLE_FORM_CONTROLLER_PHONE,
+    credentialMaterial: `${EXAMPLE_RELATED_PERSON_MEMBER_DID}#signing-key-1`,
+    evidence: [{
+            type: ['DocumentVerification'],
+            evidenceDocument: 'LibroDeFamilia',
+            verifier: 'did:web:kyc.example.org',
+        }],
+});
 /**
  * Minimal semantic input used by SDK helpers to disable one subject-side
  * relationship record through the identifier-first lifecycle contract.
@@ -59,7 +73,7 @@ export const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_ENTRY = {
 export const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_PAYLOAD = {
     thid: 'relatedperson-disable-example-001',
     body: {
-        resourceType: 'Bundle',
+        resourceType: ResourceTypesFhirR4.Bundle,
         type: 'batch',
         entry: [EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_ENTRY],
     },
@@ -83,7 +97,7 @@ export const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_ENTRY = {
 export const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_PAYLOAD = {
     thid: 'relatedperson-purge-example-001',
     body: {
-        resourceType: 'Bundle',
+        resourceType: ResourceTypesFhirR4.Bundle,
         type: 'batch',
         entry: [EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_ENTRY],
     },
@@ -98,7 +112,7 @@ export const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_PAYLOAD = {
 export const EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD = {
     thid: 'relatedperson-upsert-example-001',
     body: {
-        resourceType: 'Bundle',
+        resourceType: ResourceTypesFhirR4.Bundle,
         type: 'batch',
         entry: [{
                 resource: {

package/dist/examples/shared.d.ts

@@ -217,17 +217,20 @@ export declare const EXAMPLE_CONTENT_TYPE_FHIR_JSON: "application/fhir+json";
 export declare const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE: "IPS Document Bundle";
 export declare const EXAMPLE_BUNDLE_RESOURCE_TYPE: "Bundle";
 export declare const EXAMPLE_BUNDLE_TYPE_BATCH: "batch";
+export declare const EXAMPLE_BUNDLE_TYPE_DOCUMENT: "document";
 export declare const EXAMPLE_MEDICATION_STATEMENT_UUID: "urn:uuid:medication-statement-example-001";
 export declare const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER: "urn:uuid:medication-statement-example-001";
 export declare const EXAMPLE_MEDICATION_STATEMENT_STATUS: "active";
 export declare const EXAMPLE_MEDICATION_STATEMENT_CODE: "http://www.nlm.nih.gov/research/umls/rxnorm|313782";
 export declare const EXAMPLE_MEDICATION_STATEMENT_TEXT: "atorvastatin 20 mg oral tablet";
+export declare const EXAMPLE_MEDICATION_STATEMENT_TEXT_CORRECTED: "atorvastatin 20 mg oral tablet - corrected text";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER: "docref-example-001";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER_SECONDARY: "docref-example-002";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF: "application/pdf";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_URL: "https://example.org/prescription.pdf";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION: "Prescription PDF";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DATE: "2026-06-12T10:00:00Z";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_DATA_BASE64: string;
 export declare const EXAMPLE_CLINICAL_EVENT_DATE_TIME: "2026-06-01T10:00:00Z";
 export declare const EXAMPLE_VITAL_SIGNS_EFFECTIVE_DATE_TIME: "2026-06-11T08:30:00Z";
 export declare const EXAMPLE_VITAL_SIGNS_PANEL_DATE_TIME: "2026-06-11T09:00:00Z";
@@ -239,6 +242,11 @@ export declare const EXAMPLE_VAULT_QUATERNARY_DATE_TIME: "2026-06-11T13:00:00Z";
 export declare const EXAMPLE_VAULT_CONDITION_DATE_TIME: "2026-06-11T14:00:00Z";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH: "z-document-reference-example-hash";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE: "en";
+export declare const EXAMPLE_COMPOSITION_IDENTIFIER_MEDICATION_DOCUMENT: "urn:uuid:composition-medication-document-001";
+export declare const EXAMPLE_COMPOSITION_TITLE_MEDICATION_DOCUMENT: "Medication document authored from the self-managed frontend";
+export declare const EXAMPLE_COMPOSITION_DATE_MEDICATION_DOCUMENT: "2026-07-06T10:15:00Z";
+export declare const EXAMPLE_COMMUNICATION_TOPIC_MEDICATION_DOCUMENT: "medication-document";
+export declare const EXAMPLE_COMMUNICATION_TEXT_MEDICATION_DOCUMENT_READY: "One corrected medication document ready to travel.";
 export declare const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE: "application/pdf";
 export declare const EXAMPLE_CONSENT_ATTACHMENT_DATA_BASE64: "JVBERi0xLjQKJUZha2UgY29uc2VudCBQREYgZm9yIGxvY2FsIHNtb2tlIHRlc3QK";
 export declare const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER: "zQmYwAPJzv5CZsnAzt8auVZRnGi2C31WnH8D9N6A7h7vY2";
@@ -292,6 +300,7 @@ export declare const EXAMPLE_OBSERVATION_PANEL_IDENTIFIER: "urn:uuid:observation
 export declare const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER: "urn:uuid:observation-component-example-001";
 export declare const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER_SECONDARY: "urn:uuid:observation-component-example-002";
 export declare const EXAMPLE_IPS_COMPOSITION_IDENTIFIER: "ips-composition";
+export declare const EXAMPLE_APPOINTMENT_RESPONSE_IDENTIFIER: "appointment-response-example-001";
 export declare const EXAMPLE_CONDITION_IDENTIFIER: "condition-example-001";
 export declare const EXAMPLE_VITAL_SIGNS_NOTE: "Measured after rest.";
 export declare const EXAMPLE_FHIR_STATUS_FINAL: "final";
@@ -606,7 +615,7 @@ export declare function buildExampleCommunicationIngestionPayload({ subjectDid,
 export declare function buildExampleDocumentReferenceSearchPayload(subjectDid?: string): {
     thid: string;
     body: {
-        resourceType: string;
+        resourceType: "Bundle";
         type: string;
         entry: {
             request: {
@@ -622,8 +631,9 @@ export declare function buildExampleLiveMedicationCases(seed?: number): ExampleL
  * Builds a minimal IPS `Bundle.type=document` containing one
  * `MedicationStatement` under the `History of medication use` section.
  *
- * This helper exists so live GW tests and demos do not handcraft one-off
- * bundle structures inline.
+ * This is a shared fixture/secondary setup helper for transport demos and
+ * tests. The canonical step-by-step authoring walkthrough lives in the IPS
+ * bundle-editor tests, not here.
  */
 export declare function buildExampleMedicationIpsDocumentBundle(input: ExampleMedicationIpsDocumentBundleInput): ExampleMedicationIpsDocumentBundle;
 export type ExampleHostedTenantRouteContext = Readonly<{

package/dist/examples/shared.js

@@ -260,17 +260,20 @@ export const EXAMPLE_CONTENT_TYPE_FHIR_JSON = 'application/fhir+json';
 export const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE = 'IPS Document Bundle';
 export const EXAMPLE_BUNDLE_RESOURCE_TYPE = 'Bundle';
 export const EXAMPLE_BUNDLE_TYPE_BATCH = 'batch';
+export const EXAMPLE_BUNDLE_TYPE_DOCUMENT = 'document';
 export const EXAMPLE_MEDICATION_STATEMENT_UUID = 'urn:uuid:medication-statement-example-001';
 export const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER = EXAMPLE_MEDICATION_STATEMENT_UUID;
 export const EXAMPLE_MEDICATION_STATEMENT_STATUS = 'active';
 export const EXAMPLE_MEDICATION_STATEMENT_CODE = 'http://www.nlm.nih.gov/research/umls/rxnorm|313782';
 export const EXAMPLE_MEDICATION_STATEMENT_TEXT = 'atorvastatin 20 mg oral tablet';
+export const EXAMPLE_MEDICATION_STATEMENT_TEXT_CORRECTED = 'atorvastatin 20 mg oral tablet - corrected text';
 export const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER = 'docref-example-001';
 export const EXAMPLE_DOCUMENT_REFERENCE_IDENTIFIER_SECONDARY = 'docref-example-002';
 export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF = 'application/pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_URL = 'https://example.org/prescription.pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION = 'Prescription PDF';
 export const EXAMPLE_DOCUMENT_REFERENCE_DATE = '2026-06-12T10:00:00Z';
+export const EXAMPLE_DOCUMENT_REFERENCE_DATA_BASE64 = Buffer.from('example-medication-leaflet', 'utf8').toString('base64');
 export const EXAMPLE_CLINICAL_EVENT_DATE_TIME = '2026-06-01T10:00:00Z';
 export const EXAMPLE_VITAL_SIGNS_EFFECTIVE_DATE_TIME = '2026-06-11T08:30:00Z';
 export const EXAMPLE_VITAL_SIGNS_PANEL_DATE_TIME = '2026-06-11T09:00:00Z';
@@ -282,6 +285,11 @@ export const EXAMPLE_VAULT_QUATERNARY_DATE_TIME = '2026-06-11T13:00:00Z';
 export const EXAMPLE_VAULT_CONDITION_DATE_TIME = '2026-06-11T14:00:00Z';
 export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH = 'z-document-reference-example-hash';
 export const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE = 'en';
+export const EXAMPLE_COMPOSITION_IDENTIFIER_MEDICATION_DOCUMENT = 'urn:uuid:composition-medication-document-001';
+export const EXAMPLE_COMPOSITION_TITLE_MEDICATION_DOCUMENT = 'Medication document authored from the self-managed frontend';
+export const EXAMPLE_COMPOSITION_DATE_MEDICATION_DOCUMENT = '2026-07-06T10:15:00Z';
+export const EXAMPLE_COMMUNICATION_TOPIC_MEDICATION_DOCUMENT = 'medication-document';
+export const EXAMPLE_COMMUNICATION_TEXT_MEDICATION_DOCUMENT_READY = 'One corrected medication document ready to travel.';
 export const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE = EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF;
 export const EXAMPLE_CONSENT_ATTACHMENT_DATA_BASE64 = 'JVBERi0xLjQKJUZha2UgY29uc2VudCBQREYgZm9yIGxvY2FsIHNtb2tlIHRlc3QK';
 export const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER = 'zQmYwAPJzv5CZsnAzt8auVZRnGi2C31WnH8D9N6A7h7vY2';
@@ -335,6 +343,7 @@ export const EXAMPLE_OBSERVATION_PANEL_IDENTIFIER = 'urn:uuid:observation-panel-
 export const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER = 'urn:uuid:observation-component-example-001';
 export const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER_SECONDARY = 'urn:uuid:observation-component-example-002';
 export const EXAMPLE_IPS_COMPOSITION_IDENTIFIER = 'ips-composition';
+export const EXAMPLE_APPOINTMENT_RESPONSE_IDENTIFIER = 'appointment-response-example-001';
 export const EXAMPLE_CONDITION_IDENTIFIER = 'condition-example-001';
 export const EXAMPLE_VITAL_SIGNS_NOTE = 'Measured after rest.';
 export const EXAMPLE_FHIR_STATUS_FINAL = 'final';
@@ -589,7 +598,7 @@ export function buildExampleDocumentReferenceSearchPayload(subjectDid = EXAMPLE_
     return {
         thid: 'search-documentreference-example',
         body: {
-            resourceType: 'Bundle',
+            resourceType: ResourceTypesFhirR4.Bundle,
             type: 'batch',
             entry: [
                 {
@@ -639,8 +648,9 @@ export function buildExampleLiveMedicationCases(seed = Date.now()) {
  * Builds a minimal IPS `Bundle.type=document` containing one
  * `MedicationStatement` under the `History of medication use` section.
  *
- * This helper exists so live GW tests and demos do not handcraft one-off
- * bundle structures inline.
+ * This is a shared fixture/secondary setup helper for transport demos and
+ * tests. The canonical step-by-step authoring walkthrough lives in the IPS
+ * bundle-editor tests, not here.
  */
 export function buildExampleMedicationIpsDocumentBundle(input) {
     const subjectDid = input.subjectDid || EXAMPLE_SUBJECT_DID;
@@ -701,7 +711,7 @@ export function buildExampleMedicationIpsDocumentBundle(input) {
             },
             {
                 resource: {
-                    resourceType: 'Patient',
+                    resourceType: ResourceTypesFhirR4.Patient,
                     id: `patient-${input.medication.identifier}`,
                 },
             },

package/dist/examples/vital-signs.js

@@ -115,7 +115,7 @@ export function buildVitalSignObservationEntry(input) {
  */
 export function buildExampleVitalSignsObservationBundle() {
     return {
-        resourceType: 'Bundle',
+        resourceType: ResourceTypesFhirR4.Bundle,
         type: 'collection',
         data: [
             buildVitalSignObservationEntry(EXAMPLE_VITAL_SIGN_HEART_RATE_INPUT),

package/dist/examples/wallet-mem.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Reusable synthetic wallet fixtures for docs and tests.
+ *
+ * Rule:
+ * - wallet-related tests must import these values instead of re-hardcoding
+ *   queue ids, entity ids, thread ids, or payload strings inline
+ */
+export declare const EXAMPLE_WALLET_ENTITY_ID_SENDER: "wallet-entity-sender-001";
+export declare const EXAMPLE_WALLET_ENTITY_ID_RECIPIENT: "wallet-entity-recipient-001";
+export declare const EXAMPLE_WALLET_MESSAGE_ID_EMERGENCY: "wallet-message-emergency-001";
+export declare const EXAMPLE_WALLET_MESSAGE_ID_NORMAL: "wallet-message-normal-001";
+export declare const EXAMPLE_WALLET_THREAD_ID: "wallet-thread-001";
+export declare const EXAMPLE_WALLET_PAYLOAD_TYPE: "Communication-bundle-submit-v1.0";
+export declare const EXAMPLE_WALLET_CREATED_AT: "2026-06-30T10:00:00.000Z";
+export declare const EXAMPLE_WALLET_CONTENT_NOTE: "Medication bundle ready for DIDComm transport.";
+export declare const EXAMPLE_WALLET_FAILURE_MESSAGE: "Gateway temporary failure.";
+export declare const EXAMPLE_WALLET_PROTECTED_DOC_ID: "wallet-doc-001";
+export declare const EXAMPLE_WALLET_PRIORITY_EMERGENCY: "emergency";
+export declare const EXAMPLE_WALLET_PRIORITY_NORMAL: "normal";
+export declare const EXAMPLE_WALLET_MESSAGE_PAYLOAD: {
+    readonly iss: "did:web:sender.example.org";
+    readonly aud: "https://gw.example.org/submit";
+    readonly jti: "wallet-jti-001";
+    readonly thid: "wallet-thread-001";
+    readonly type: "Communication-bundle-submit-v1.0";
+    readonly body: {
+        readonly data: readonly [{
+            readonly id: "wallet-entry-001";
+            readonly type: "Communication-bundle-submit-v1.0";
+            readonly resource: {
+                readonly resourceType: "Communication";
+                readonly note: readonly [{
+                    readonly text: "Medication bundle ready for DIDComm transport.";
+                }];
+            };
+        }];
+    };
+};

package/dist/examples/wallet-mem.js

@@ -0,0 +1,42 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { DidcommMessageTypes } from '../constants/didcomm.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
+import { WalletMessagePriorities } from '../models/wallet.js';
+/**
+ * Reusable synthetic wallet fixtures for docs and tests.
+ *
+ * Rule:
+ * - wallet-related tests must import these values instead of re-hardcoding
+ *   queue ids, entity ids, thread ids, or payload strings inline
+ */
+export const EXAMPLE_WALLET_ENTITY_ID_SENDER = 'wallet-entity-sender-001';
+export const EXAMPLE_WALLET_ENTITY_ID_RECIPIENT = 'wallet-entity-recipient-001';
+export const EXAMPLE_WALLET_MESSAGE_ID_EMERGENCY = 'wallet-message-emergency-001';
+export const EXAMPLE_WALLET_MESSAGE_ID_NORMAL = 'wallet-message-normal-001';
+export const EXAMPLE_WALLET_THREAD_ID = 'wallet-thread-001';
+export const EXAMPLE_WALLET_PAYLOAD_TYPE = DidcommMessageTypes.CommunicationBundleSubmit;
+export const EXAMPLE_WALLET_CREATED_AT = '2026-06-30T10:00:00.000Z';
+export const EXAMPLE_WALLET_CONTENT_NOTE = 'Medication bundle ready for DIDComm transport.';
+export const EXAMPLE_WALLET_FAILURE_MESSAGE = 'Gateway temporary failure.';
+export const EXAMPLE_WALLET_PROTECTED_DOC_ID = 'wallet-doc-001';
+export const EXAMPLE_WALLET_PRIORITY_EMERGENCY = WalletMessagePriorities.Emergency;
+export const EXAMPLE_WALLET_PRIORITY_NORMAL = WalletMessagePriorities.Normal;
+export const EXAMPLE_WALLET_MESSAGE_PAYLOAD = {
+    iss: 'did:web:sender.example.org',
+    aud: 'https://gw.example.org/submit',
+    jti: 'wallet-jti-001',
+    thid: EXAMPLE_WALLET_THREAD_ID,
+    type: EXAMPLE_WALLET_PAYLOAD_TYPE,
+    body: {
+        data: [
+            {
+                id: 'wallet-entry-001',
+                type: EXAMPLE_WALLET_PAYLOAD_TYPE,
+                resource: {
+                    resourceType: ResourceTypesFhirR4.Communication,
+                    note: [{ text: EXAMPLE_WALLET_CONTENT_NOTE }],
+                },
+            },
+        ],
+    },
+};

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './examples';
 export * from './hmac';
 export * from './i18n/clinical-sections.i18n';
 export * from './i18n/role-codes.i18n';
+export * from './interfaces';
 export * from './models';
 export * from './storage';
 export * from './utils';

package/dist/index.js

@@ -7,6 +7,7 @@ export * from './examples/index.js';
 export * from './hmac.js';
 export * from './i18n/clinical-sections.i18n.js';
 export * from './i18n/role-codes.i18n.js';
+export * from './interfaces/index.js';
 export * from './models/index.js';
 export * from './storage/index.js';
 export * from './utils/index.js';

package/dist/interfaces/IProfileOutboxRepository.d.ts

@@ -0,0 +1,36 @@
+import type { BackendMessageResponseRecord, ProfileOutboxMessageRecord } from '../models/profile-manager';
+/**
+ * Runtime-neutral repository for profile-scoped outbox history and decoded
+ * responses.
+ *
+ * Separation rule:
+ * - `IWalletQueue` controls ordering and mutable pending state
+ * - `IProfileOutboxRepository` preserves historical records and decoded
+ *   responses that the profile/runtime may want to inspect later
+ */
+export interface IProfileOutboxRepository {
+    /**
+     * Stores one immutable message history record.
+     */
+    putMessage(record: ProfileOutboxMessageRecord): Promise<ProfileOutboxMessageRecord>;
+    /**
+     * Returns one historical message record by id.
+     */
+    getMessage(messageId: string): Promise<ProfileOutboxMessageRecord | undefined>;
+    /**
+     * Lists all historical message records.
+     */
+    listMessages(): Promise<ProfileOutboxMessageRecord[]>;
+    /**
+     * Stores one decoded response record.
+     */
+    putResponse(record: BackendMessageResponseRecord): Promise<BackendMessageResponseRecord>;
+    /**
+     * Returns the latest decoded response for one thread id.
+     */
+    getLatestResponseByThreadId(thid: string): Promise<BackendMessageResponseRecord | undefined>;
+    /**
+     * Lists all decoded responses.
+     */
+    listResponses(): Promise<BackendMessageResponseRecord[]>;
+}

package/dist/interfaces/IProfileOutboxRepository.js

@@ -0,0 +1,2 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+export {};

package/dist/interfaces/IWallet.d.ts

@@ -0,0 +1,74 @@
+import type { WalletEnqueueMessageInput, WalletManagedEntityDescriptor, WalletQueuedMessage } from '../models/wallet';
+import type { JWK, JwkSet } from '../models/jwk';
+/**
+ * Shared wallet contract reused by tests, apps, frontend adapters, and simple
+ * backend or BFF flows.
+ *
+ * Backward-compatibility rule:
+ * - the legacy methods (`provisionKeys`, `digest`,
+ *   `protectConfidentialData`, `unprotectConfidentialData`, `unpack`) remain
+ *   the stable minimum contract expected by older consumers
+ * - richer transport and queue helpers are optional so older platform-specific
+ *   adapters do not need to implement them immediately
+ */
+export interface IWallet {
+    /**
+     * Provisions or retrieves the wallet key set for one logical entity.
+     */
+    provisionKeys(entityId: string): Promise<JwkSet>;
+    /**
+     * Computes one digest string using the provided algorithm name.
+     */
+    digest(data: string, algorithm: string): Promise<string>;
+    /**
+     * Protects one local document for confidential at-rest storage.
+     */
+    protectConfidentialData(doc: unknown, entityId?: string): Promise<unknown>;
+    /**
+     * Unprotects one local confidential document.
+     */
+    unprotectConfidentialData(doc: unknown, entityId?: string): Promise<unknown>;
+    /**
+     * Unpacks one transport message into business content plus JOSE metadata.
+     */
+    unpack?(packedMessage: string, entityId?: string): Promise<{
+        content: unknown;
+        meta: Record<string, unknown>;
+    }>;
+    /**
+     * Packs one business payload for one recipient public key.
+     */
+    pack?(content: Record<string, unknown>, recipientJwk: JWK, entityId: string): Promise<string>;
+    /**
+     * Returns the public keys currently provisioned for one entity.
+     */
+    getPublicKeys?(entityId: string): Promise<WalletManagedEntityDescriptor>;
+    /**
+     * Signs one JSON payload into a compact JWS.
+     */
+    signCompactJws?(entityId: string, claims: Record<string, unknown>): Promise<string>;
+    /**
+     * Builds one compact JWE for the provided recipient.
+     */
+    buildCompactJwe?(entityId: string, plaintext: string | Uint8Array, recipientJwk: JWK, contentType?: string): Promise<string>;
+    /**
+     * Enqueues one local outbound message with an optional priority.
+     */
+    enqueueMessage?(input: WalletEnqueueMessageInput): Promise<WalletQueuedMessage>;
+    /**
+     * Returns the next pending message without mutating queue state.
+     */
+    peekNextMessage?(): Promise<WalletQueuedMessage | undefined>;
+    /**
+     * Marks one message as delivered.
+     */
+    markMessageDelivered?(messageId: string): Promise<WalletQueuedMessage>;
+    /**
+     * Marks one message as failed.
+     */
+    markMessageFailed?(messageId: string, errorMessage: string): Promise<WalletQueuedMessage>;
+    /**
+     * Lists all locally tracked queued messages.
+     */
+    listMessages?(): Promise<WalletQueuedMessage[]>;
+}

package/dist/interfaces/IWallet.js

@@ -0,0 +1,2 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+export {};

package/dist/interfaces/IWalletQueue.d.ts

@@ -0,0 +1,30 @@
+import type { WalletEnqueueMessageInput, WalletQueuedMessage } from '../models/wallet';
+/**
+ * Runtime-neutral queue/outbox contract for low-level wallet-backed message
+ * scheduling.
+ *
+ * Design intent:
+ * - `common-utils` provides the contract plus one in-memory implementation
+ * - BFF/server runtimes may later plug Redis, Google, filesystem, or database
+ *   adapters without changing `WalletMem`
+ * - mobile/native runtimes may plug SQLite-backed outbox adapters
+ */
+export interface IWalletQueue {
+    /**
+     * Enqueues one outbound message and returns the stored queued record.
+     */
+    enqueue(input: WalletEnqueueMessageInput): Promise<WalletQueuedMessage>;
+    /**
+     * Returns the next pending message according to queue ordering rules without
+     * mutating queue state.
+     */
+    peekNextPending(): Promise<WalletQueuedMessage | undefined>;
+    /**
+     * Updates one queued message by identifier and returns the stored result.
+     */
+    update(messageId: string, patch: Partial<WalletQueuedMessage>): Promise<WalletQueuedMessage>;
+    /**
+     * Lists all queued messages in current processing order.
+     */
+    list(): Promise<WalletQueuedMessage[]>;
+}