gdc-common-utils-ts 2.0.18 → 2.1.0

package/README.md

@@ -655,4 +655,3 @@ When integrating the converged SDKs:
 
 ## Roadmap and Briefing
 - `docs/BRIEFING_DATASPACE_EN.md`
-- `TODO_ROADMAP.md`

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

@@ -0,0 +1,11 @@
+/**
+ * Shared synthetic DIDComm fixtures for direct Bundle payload tests.
+ */
+export declare const EXAMPLE_DIDCOMM_BUNDLE_ISS: "did:web:portal.example.org";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_AUD: "https://gateway.example.com/bundle";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_JTI: "didcomm-bundle-jti-001";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_THID: "didcomm-bundle-thread-001";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_TYPE: "Bundle-batch-request-v1.0";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_REPLY_AUD: "https://gateway.example.com/bundle-reply";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_REPLY_JTI: "didcomm-bundle-reply-jti-001";
+export declare const EXAMPLE_DIDCOMM_BUNDLE_ACK_TYPE: "Bundle-ack-v1.0";

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

@@ -0,0 +1,13 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { EXAMPLE_GATEWAY_PUBLIC_ORIGIN, } from './shared.js';
+/**
+ * Shared synthetic DIDComm fixtures for direct Bundle payload tests.
+ */
+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_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';

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, } 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';

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

@@ -0,0 +1,35 @@
+import { 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.r4";
+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_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: "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": "accepted";
+};

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

@@ -0,0 +1,38 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { Format } from '../constants/Schemas.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, AppointmentStatus, } from '../models/interoperable-claims/appointment-claims.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 = 'Communication-attached-bundle-v1.0';
+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 = Format.FHIR_R4;
+export const EXAMPLE_DIDCOMM_BUNDLE_ENTRY_CONTEXT = Format.FHIR_API;
+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_ACK_TYPE = 'Communication-ack-v1.0';
+export const EXAMPLE_DIDCOMM_ACK_BODY_OK_KEY = 'ok';
+export const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_MEDICATION_IDENTIFIER_KEY = 'receivedMedicationIdentifier';
+export const EXAMPLE_DIDCOMM_ACK_BODY_RECEIVED_DOCUMENT_IDENTIFIER_KEY = 'receivedDocumentIdentifier';
+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 = 'accepted';
+export const EXAMPLE_APPOINTMENT_CLAIMS = {
+    '@context': EXAMPLE_DIDCOMM_BUNDLE_ENTRY_CONTEXT,
+    [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/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/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,29 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+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 = 'Communication-response-v1.0';
+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/shared.d.ts

@@ -292,6 +292,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";

package/dist/examples/shared.js

@@ -335,6 +335,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';

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,40 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+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 = 'Communication-bundle-submit-v1.0';
+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: '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[]>;
+}

package/dist/interfaces/IWalletQueue.js

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

package/dist/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+export * from './ICryptoHelper';
+export * from './ICryptography';
+export * from './IWallet';
+export * from './IProfileOutboxRepository';
+export * from './IWalletQueue';
+export * from './MlDsa';
+export * from './MlKem';
+export * from './Cryptography.types';

package/dist/interfaces/index.js

@@ -0,0 +1,8 @@
+export * from './ICryptoHelper.js';
+export * from './ICryptography.js';
+export * from './IWallet.js';
+export * from './IProfileOutboxRepository.js';
+export * from './IWalletQueue.js';
+export * from './MlDsa.js';
+export * from './MlKem.js';
+export * from './Cryptography.types.js';