gdc-common-utils-ts 2.1.0 → 2.3.0

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.js

@@ -1,4 +1,5 @@
 // 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.
@@ -9,7 +10,7 @@ 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_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';

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";
@@ -607,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: {
@@ -623,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';
@@ -590,7 +598,7 @@ export function buildExampleDocumentReferenceSearchPayload(subjectDid = EXAMPLE_
     return {
         thid: 'search-documentreference-example',
         body: {
-            resourceType: 'Bundle',
+            resourceType: ResourceTypesFhirR4.Bundle,
             type: 'batch',
             entry: [
                 {
@@ -640,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;
@@ -702,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.js

@@ -1,4 +1,6 @@
 // Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { DidcommMessageTypes } from '../constants/didcomm.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
 import { WalletMessagePriorities } from '../models/wallet.js';
 /**
  * Reusable synthetic wallet fixtures for docs and tests.
@@ -12,7 +14,7 @@ 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_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.';
@@ -31,7 +33,7 @@ export const EXAMPLE_WALLET_MESSAGE_PAYLOAD = {
                 id: 'wallet-entry-001',
                 type: EXAMPLE_WALLET_PAYLOAD_TYPE,
                 resource: {
-                    resourceType: 'Communication',
+                    resourceType: ResourceTypesFhirR4.Communication,
                     note: [{ text: EXAMPLE_WALLET_CONTENT_NOTE }],
                 },
             },

package/dist/i18n/role-codes.i18n.d.ts

@@ -1,4 +1,12 @@
-export type RoleCodeI18nKey = `org.ilo.isco-08.${string}` | `org.isco08.${string}` | `org.hl7.v3.personalRelationship.${string}` | `org.hl7.v3.roleCode.${string}`;
+export type RoleCodeI18nKey = `org.ilo.isco-08.${string}` | `org.isco08.${string}` | `org.hl7.terminology.CodeSystem.v3-RoleCode.${string}`
+/**
+ * @deprecated Use `org.hl7.terminology.CodeSystem.v3-RoleCode.<code>`.
+ */
+ | `org.hl7.v3.personalRelationship.${string}`
+/**
+ * @deprecated Use `org.hl7.terminology.CodeSystem.v3-RoleCode.<code>`.
+ */
+ | `org.hl7.v3.roleCode.${string}`;
 export type RoleCodeI18nMap = Readonly<Record<RoleCodeI18nKey, string>>;
 export declare const roleCodeI18nEn: Readonly<Record<RoleCodeI18nKey, string>>;
 export declare const healthcareRoleI18nEn: Readonly<Record<RoleCodeI18nKey, string>>;

package/dist/i18n/role-codes.i18n.js

@@ -6,7 +6,18 @@ function buildRoleCodeI18nMap() {
     const legacyIscoAliases = baseEntries
         .filter(([key]) => key.startsWith('org.ilo.isco-08.'))
         .map(([key, label]) => [key.replace('org.ilo.isco-08.', 'org.isco08.'), label]);
-    const entries = [...baseEntries, ...legacyIscoAliases];
+    const legacyHl7Aliases = baseEntries
+        .filter(([key]) => key.startsWith('org.hl7.terminology.CodeSystem.v3-RoleCode.'))
+        .flatMap(([key, label]) => {
+        const suffix = key.replace('org.hl7.terminology.CodeSystem.v3-RoleCode.', '');
+        return [
+            /** @deprecated Compatibility alias for older consumers. */
+            [`org.hl7.v3.personalRelationship.${suffix}`, label],
+            /** @deprecated Compatibility alias for older consumers. */
+            [`org.hl7.v3.roleCode.${suffix}`, label],
+        ];
+    });
+    const entries = [...baseEntries, ...legacyIscoAliases, ...legacyHl7Aliases];
     return Object.freeze(Object.fromEntries(entries));
 }
 export const roleCodeI18nEn = buildRoleCodeI18nMap();

package/dist/models/authority-resolution.d.ts

@@ -0,0 +1,56 @@
+export type AuthorityResolutionSource = 'catalog' | 'metadata' | 'cache' | 'legacy';
+export type AuthorityResolutionMatch = 'tenant-context' | 'subject-did' | 'subject-same-as' | 'authority-did' | 'authority-base-url';
+/**
+ * Runtime-neutral request shape used to resolve which authority/host is
+ * responsible for one tenant or subject identifier.
+ *
+ * Design rule:
+ * - business callers should prefer `tenantId + jurisdiction + sector`
+ * - callers may additionally provide `subjectDid` or `subjectSameAs` when that
+ *   is the only identifier already known
+ * - `authorityDidWeb` and `authorityBaseUrl` are optional technical hints, not
+ *   the preferred business inputs
+ */
+export type AuthorityResolutionInput = Readonly<{
+    tenantId?: string;
+    jurisdiction?: string;
+    sector?: string;
+    version?: string;
+    subjectDid?: string;
+    subjectSameAs?: string;
+    authorityDidWeb?: string;
+    authorityBaseUrl?: string;
+    metadataUrl?: string;
+}>;
+/**
+ * One published or preloaded authority catalog entry.
+ *
+ * The current minimal contract is intentionally small:
+ * - enough to route to one host/ICA quickly
+ * - enough to derive the hosted tenant DID when tenant context is known
+ * - enough to match by public subject alias prefixes in future registries
+ */
+export type AuthorityCatalogRecord = Readonly<{
+    authorityDidWeb: string;
+    authorityBaseUrl?: string;
+    tenantDidWeb?: string;
+    tenantId?: string;
+    jurisdiction?: string;
+    version?: string;
+    sector?: string;
+    metadataUrl?: string;
+    subjectDidPrefixes?: readonly string[];
+    subjectSameAsPrefixes?: readonly string[];
+}>;
+/**
+ * Normalized authority resolution output returned by shared discovery helpers.
+ */
+export type AuthorityResolution = Readonly<{
+    authorityDidWeb: string;
+    authorityBaseUrl?: string;
+    tenantDidWeb?: string;
+    metadataUrl?: string;
+    source: AuthorityResolutionSource;
+    matchedBy: AuthorityResolutionMatch;
+    record?: AuthorityCatalogRecord;
+}>;

package/dist/models/authority-resolution.js

@@ -0,0 +1,2 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+export {};

package/dist/models/bundle-editor-types.d.ts

@@ -0,0 +1,89 @@
+import { type BundleEntry, type BundleJsonApi, type BundleRequest } from './bundle';
+import { EmployeeBundleOperations, type EmployeeClaims } from '../utils/employee';
+import type { BundleEntryEditor } from '../utils/bundle-entry-editor';
+import type { EmployeeEntryEditor } from '../utils/employee-entry-editor';
+import type { VitalSignEntryEditor } from '../utils/vital-sign-entry-editor';
+import type { ObservationEntryEditor } from '../utils/observation-entry-editor';
+import type { AllergyIntoleranceEntryEditor } from '../utils/allergy-intolerance-entry-editor';
+import type { ConditionEntryEditor } from '../utils/condition-entry-editor';
+import type { MedicationStatementEntryEditor } from '../utils/medication-statement-entry-editor';
+import type { DocumentReferenceEntryEditor } from '../utils/document-reference-entry-editor';
+import type { CarePlanEntryEditor } from '../utils/care-plan-entry-editor';
+import type { FlagEntryEditor } from '../utils/flag-entry-editor';
+import type { ClinicalImpressionEntryEditor } from '../utils/clinical-impression-entry-editor';
+import type { DeviceEntryEditor } from '../utils/device-entry-editor';
+import type { DeviceUseStatementEntryEditor } from '../utils/device-use-statement-entry-editor';
+import type { EncounterEntryEditor } from '../utils/encounter-entry-editor';
+import type { CoverageEntryEditor } from '../utils/coverage-entry-editor';
+import type { ImmunizationEntryEditor } from '../utils/immunization-entry-editor';
+import type { ProcedureEntryEditor } from '../utils/procedure-entry-editor';
+import type { DiagnosticReportEntryEditor } from '../utils/diagnostic-report-entry-editor';
+export type BundleOperation = (typeof EmployeeBundleOperations)[keyof typeof EmployeeBundleOperations];
+/** Resource types that the shared bundle editors currently know how to open as typed entry editors. */
+export declare const BundleEditableResourceTypes: Readonly<{
+    readonly employee: "Employee";
+    readonly consent: "Consent";
+    readonly observation: "Observation";
+    readonly vitalSign: "Observation";
+    readonly allergyIntolerance: "AllergyIntolerance";
+    readonly condition: "Condition";
+    readonly medicationStatement: "MedicationStatement";
+    readonly documentReference: "DocumentReference";
+    readonly carePlan: "CarePlan";
+    readonly flag: "Flag";
+    readonly clinicalImpression: "ClinicalImpression";
+    readonly device: "Device";
+    readonly deviceUseStatement: "DeviceUseStatement";
+    readonly encounter: "Encounter";
+    readonly coverage: "Coverage";
+    readonly immunization: "Immunization";
+    readonly procedure: "Procedure";
+    readonly diagnosticReport: "DiagnosticReport";
+}>;
+export type AllowedResourceType = string;
+/** Mutable staged entry shape kept inside `BundleEditor` before final materialization. */
+export type BuiltBundleEntry = {
+    type: string;
+    request: {
+        method: BundleRequest['method'];
+        url?: string;
+    };
+    resource: {
+        resourceType: string;
+        id?: string;
+        meta: {
+            claims: EmployeeClaims;
+        };
+        [key: string]: unknown;
+    };
+    fullUrl?: string;
+};
+export declare const BundleTypes: Readonly<{
+    readonly batch: "batch";
+    readonly document: "document";
+    readonly collection: "collection";
+    readonly transaction: "transaction";
+}>;
+export type BundleType = (typeof BundleTypes)[keyof typeof BundleTypes];
+/** Canonical validation issues returned by `BundleEditor.validateDocumentAuthoring()`. */
+export declare const BundleEditorValidationIssues: Readonly<{
+    readonly DocumentModeRequired: "BundleEditor must be in document mode before document validation.";
+    readonly CompositionSubjectRequired: "Composition.subject is required before document transport.";
+    readonly CompositionTypeRequired: "Composition.type is required before document transport.";
+    readonly CompositionTitleRequired: "Composition.title is required before document transport.";
+    readonly CompositionDateRequired: "Composition.date is required before document transport.";
+    readonly CompositionAuthorRequired: "Composition.author is required before document transport.";
+    readonly DocumentEntryRequired: "Bundle.document requires at least one staged resource entry.";
+}>;
+export type BundleEditorValidationIssue = typeof BundleEditorValidationIssues[keyof typeof BundleEditorValidationIssues];
+/** Convenience alias for the in-memory JSON-API-like bundle shape returned by `buildJsonApi()`. */
+export type BundleJsonApiShape = BundleJsonApi<BundleEntry>;
+/**
+ * Type-level mapping from `BundleEditableResourceTypes.*` to the concrete
+ * editor class returned by `newEntryAs(...)` / `newContainedResourceAs(...)`.
+ *
+ * This exists so callers get the correct chainable editor surface from the
+ * resource type they requested, instead of falling back to the generic
+ * `BundleEntryEditor` API.
+ */
+export type ResourceTypeEntryEditor<T extends AllowedResourceType> = T extends typeof BundleEditableResourceTypes.employee ? EmployeeEntryEditor : T extends typeof BundleEditableResourceTypes.vitalSign ? VitalSignEntryEditor : T extends typeof BundleEditableResourceTypes.observation ? ObservationEntryEditor : T extends typeof BundleEditableResourceTypes.allergyIntolerance ? AllergyIntoleranceEntryEditor : T extends typeof BundleEditableResourceTypes.condition ? ConditionEntryEditor : T extends typeof BundleEditableResourceTypes.medicationStatement ? MedicationStatementEntryEditor : T extends typeof BundleEditableResourceTypes.documentReference ? DocumentReferenceEntryEditor : T extends typeof BundleEditableResourceTypes.carePlan ? CarePlanEntryEditor : T extends typeof BundleEditableResourceTypes.flag ? FlagEntryEditor : T extends typeof BundleEditableResourceTypes.clinicalImpression ? ClinicalImpressionEntryEditor : T extends typeof BundleEditableResourceTypes.device ? DeviceEntryEditor : T extends typeof BundleEditableResourceTypes.deviceUseStatement ? DeviceUseStatementEntryEditor : T extends typeof BundleEditableResourceTypes.encounter ? EncounterEntryEditor : T extends typeof BundleEditableResourceTypes.coverage ? CoverageEntryEditor : T extends typeof BundleEditableResourceTypes.immunization ? ImmunizationEntryEditor : T extends typeof BundleEditableResourceTypes.procedure ? ProcedureEntryEditor : T extends typeof BundleEditableResourceTypes.diagnosticReport ? DiagnosticReportEntryEditor : BundleEntryEditor;

package/dist/models/bundle-editor-types.js

@@ -0,0 +1,45 @@
+/**
+ * File discipline note:
+ * - Read `ARCHITECTURE.md` and `CONTRIBUTING.md` before changing this module.
+ * - This file owns only exported bundle-editor types and constants.
+ * - Do not move helper implementations or class logic here.
+ */
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
+import { EmployeeResourceTypes, } from '../utils/employee.js';
+/** Resource types that the shared bundle editors currently know how to open as typed entry editors. */
+export const BundleEditableResourceTypes = Object.freeze({
+    employee: EmployeeResourceTypes.employee,
+    consent: ResourceTypesFhirR4.Consent,
+    observation: ResourceTypesFhirR4.Observation,
+    vitalSign: ResourceTypesFhirR4.Observation,
+    allergyIntolerance: ResourceTypesFhirR4.AllergyIntolerance,
+    condition: ResourceTypesFhirR4.Condition,
+    medicationStatement: ResourceTypesFhirR4.MedicationStatement,
+    documentReference: ResourceTypesFhirR4.DocumentReference,
+    carePlan: ResourceTypesFhirR4.CarePlan,
+    flag: ResourceTypesFhirR4.Flag,
+    clinicalImpression: ResourceTypesFhirR4.ClinicalImpression,
+    device: ResourceTypesFhirR4.Device,
+    deviceUseStatement: ResourceTypesFhirR4.DeviceUseStatement,
+    encounter: ResourceTypesFhirR4.Encounter,
+    coverage: ResourceTypesFhirR4.Coverage,
+    immunization: ResourceTypesFhirR4.Immunization,
+    procedure: ResourceTypesFhirR4.Procedure,
+    diagnosticReport: ResourceTypesFhirR4.DiagnosticReport,
+});
+export const BundleTypes = Object.freeze({
+    batch: 'batch',
+    document: 'document',
+    collection: 'collection',
+    transaction: 'transaction',
+});
+/** Canonical validation issues returned by `BundleEditor.validateDocumentAuthoring()`. */
+export const BundleEditorValidationIssues = Object.freeze({
+    DocumentModeRequired: 'BundleEditor must be in document mode before document validation.',
+    CompositionSubjectRequired: 'Composition.subject is required before document transport.',
+    CompositionTypeRequired: 'Composition.type is required before document transport.',
+    CompositionTitleRequired: 'Composition.title is required before document transport.',
+    CompositionDateRequired: 'Composition.date is required before document transport.',
+    CompositionAuthorRequired: 'Composition.author is required before document transport.',
+    DocumentEntryRequired: 'Bundle.document requires at least one staged resource entry.',
+});

package/dist/models/bundle.d.ts

@@ -176,6 +176,11 @@ export type BundleEntry = {
  * const responseBundle: BundleJsonApi<BundleEntry | ErrorEntry> = { ... };
  */
 export interface BundleJsonApi<T = BundleEntry | ErrorEntry> {
+    id?: string;
+    meta?: {
+        claims?: Record<string, any>;
+        [key: string]: any;
+    };
     data: T[];
     resourceType: 'Bundle';
     total?: number;

package/dist/models/communication-attached-bundle-session.d.ts

@@ -16,11 +16,13 @@ export type CommunicationAttachedBundleSessionOptions = Readonly<{
  * Canonical `@context` for outer `Communication` claim payloads.
  *
  * Rationale:
- * - the outer container is materialized as one FHIR `Communication` resource
- * - the inner `resource.meta.claims` rows stay version-agnostic and therefore
- *   use `FHIR_API`
+ * - this value belongs to canonical claims, not to `resource.resourceType`
+ * - `resource.resourceType = Communication` may later be projected as FHIR R4
+ * - but `resource.meta.claims['@context']` should stay version-agnostic
  */
-export declare const CommunicationAttachmentClaimsContext: "org.hl7.fhir.r4";
+export declare const CommunicationClaimsContext: "org.hl7.fhir.api";
+/** @deprecated Prefer `CommunicationClaimsContext`. */
+export declare const CommunicationAttachmentClaimsContext: "org.hl7.fhir.api";
 /**
  * Canonical `@context` for bundle entry `resource.meta.claims`.
  *

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

@@ -4,11 +4,13 @@ import { Format } from '../constants/Schemas.js';
  * Canonical `@context` for outer `Communication` claim payloads.
  *
  * Rationale:
- * - the outer container is materialized as one FHIR `Communication` resource
- * - the inner `resource.meta.claims` rows stay version-agnostic and therefore
- *   use `FHIR_API`
+ * - this value belongs to canonical claims, not to `resource.resourceType`
+ * - `resource.resourceType = Communication` may later be projected as FHIR R4
+ * - but `resource.meta.claims['@context']` should stay version-agnostic
  */
-export const CommunicationAttachmentClaimsContext = Format.FHIR_R4;
+export const CommunicationClaimsContext = Format.FHIR_API;
+/** @deprecated Prefer `CommunicationClaimsContext`. */
+export const CommunicationAttachmentClaimsContext = CommunicationClaimsContext;
 /**
  * Canonical `@context` for bundle entry `resource.meta.claims`.
  *