gdc-sdk-node-ts 2.1.4 → 2.2.2

package/README.md

@@ -7,7 +7,10 @@ execution adapters, or orchestration tests.
 Short rule:
 
 - `101` tests must read like executable tutorials
-- shared fixtures/types belong in `gdc-common-utils-ts`, not as local literals
+- `gdc-common-utils-ts` owns the canonical step-by-step editors/readers,
+  shared fixtures, and reusable payload examples
+- `gdc-sdk-node-ts` starts after that shared authoring step and at
+  `ProfileRuntime -> loadProfile(...) -> workspace/session -> actor facade`
   in node runtime tests
 
 Node runtime package for consuming the shared GDC SDK contracts against real
@@ -69,7 +72,8 @@ If you are integrating this package for the first time, open these in order:
 2. [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
    Real backend setup plus the public runtime entrypoints:
    `HostOnboardingSdk`, `OrganizationControllerSdk`,
-   `IndividualControllerSdk`, `ProfessionalSdk`, and route-context usage.
+   `IndividualControllerSdk`, `ProfessionalSdk`, route-context usage, and the
+   canonical `ProfileRuntime -> loadProfile(...) -> workspace/session -> actor facade -> submit/poll` shape.
 3. [tests/101-live-full-cycle-bff-runtime.e2e.test.mjs](./tests/101-live-full-cycle-bff-runtime.e2e.test.mjs)
    Canonical live backend/BFF walkthrough on a fresh local GW lifecycle:
    host/tenant activation, employee provisioning, individual bootstrap,
@@ -194,7 +198,8 @@ Current live `101` flow covered by the test suite:
 2. provision one professional employee through the organization controller
 3. load the individual-controller profile and bootstrap one hosted individual
 4. confirm the returned order and verify the invoice bundle projection
-5. ingest one IPS/clinical `Communication` through the individual controller
+5. ingest one IPS/clinical `Communication` whose attached payload is the
+   canonical document `Bundle` with `Composition` first entry
 6. grant professional consent for one patient-summary section
 7. load the professional profile and request one SMART token
 8. read the allowed IPS bundle as the professional actor
@@ -293,8 +298,9 @@ npm run test:e2e:live-gw
 
 Implementation note:
 
-- the public runtime contract is still `Bundle/_search`
-- `gdc-sdk-node-ts` submits that request as-is
+- the beginner search story stays on FHIR parameters such as
+  `Composition.section`
+- `gdc-sdk-node-ts` submits the search request through the runtime facade
 - GW CORE resolves it internally from indexed subject sections and returns the
   consolidated IPS bundle document
 

package/dist/backend-profile-workspace.d.ts

@@ -0,0 +1,48 @@
+import type { ProfileLoadRequest, SubjectIndexCompositionRequest, SubjectIndexConnectionRequest, TrustedDeviceRegistrationRequest } from 'gdc-sdk-core-ts';
+import type { BackendLoadedActorProfile, BackendProfileRuntimeClient, BackendSubjectIndexCompositionResult, BackendSubjectIndexConnectionResult, BackendTrustedDeviceRegistrationResult } from './backend-profile-runtime.js';
+import { type OrganizationControllerProfileWorkspace, type ProfessionalProfileWorkspace } from './profile-workspace.js';
+import { HostOnboardingSdk } from './orchestration/host-onboarding-sdk.js';
+import { IndividualControllerSdk } from './orchestration/individual-controller-sdk.js';
+import { IndividualMemberSdk } from './orchestration/individual-member-sdk.js';
+import { OrganizationControllerSdk } from './orchestration/organization-controller-sdk.js';
+import { OrganizationEmployeeSdk } from './orchestration/organization-employee-sdk.js';
+import { ProfessionalSdk } from './orchestration/professional-sdk.js';
+/**
+ * Backend loaded-profile workspace that keeps the canonical
+ * `loadProfile -> workspace/session -> actor facade` story explicit.
+ */
+export declare class LoadedProfileWorkspace {
+    private readonly profileRuntime;
+    readonly profile: BackendLoadedActorProfile;
+    constructor(profileRuntime: BackendProfileRuntimeClient, profile: BackendLoadedActorProfile);
+    close(): Promise<void>;
+    registerTrustedDevice(input: TrustedDeviceRegistrationRequest): Promise<BackendTrustedDeviceRegistrationResult>;
+    connectToSubjectIndex(input: SubjectIndexConnectionRequest): Promise<BackendSubjectIndexConnectionResult>;
+    getSubjectIndexComposition(input: SubjectIndexCompositionRequest): Promise<BackendSubjectIndexCompositionResult>;
+    asHostOnboarding(): HostOnboardingSdk;
+    asOrganizationController(): OrganizationControllerSdk;
+    asOrganizationEmployee(): OrganizationEmployeeSdk;
+    asIndividualController(): IndividualControllerSdk;
+    asIndividualMember(): IndividualMemberSdk;
+    asProfessional(): ProfessionalSdk;
+    createOrganizationControllerWorkspace(): OrganizationControllerProfileWorkspace;
+    createProfessionalWorkspace(): ProfessionalProfileWorkspace;
+}
+export declare class ProfileRuntime {
+    private readonly profileRuntime;
+    constructor(profileRuntime: BackendProfileRuntimeClient);
+    loadProfile(input: ProfileLoadRequest): Promise<LoadedProfileWorkspace>;
+}
+export declare function createLoadedProfileWorkspace(profileRuntime: BackendProfileRuntimeClient, profile: BackendLoadedActorProfile): LoadedProfileWorkspace;
+/**
+ * @deprecated Prefer `LoadedProfileWorkspace`.
+ */
+export { LoadedProfileWorkspace as BackendProfileWorkspace };
+/**
+ * @deprecated Prefer `ProfileRuntime`.
+ */
+export { ProfileRuntime as BackendProfileWorkspaceRuntime };
+/**
+ * @deprecated Prefer `createLoadedProfileWorkspace`.
+ */
+export { createLoadedProfileWorkspace as createBackendProfileWorkspace };

package/dist/backend-profile-workspace.js

@@ -0,0 +1,91 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { ActorKinds } from 'gdc-common-utils-ts/constants/actor-session';
+import { closeBackendProfile, connectBackendToSubjectIndex, getBackendSubjectIndexComposition, registerBackendTrustedDevice, } from './backend-profile-runtime.js';
+import { createOrganizationControllerProfileWorkspace, createProfessionalProfileWorkspace, } from './profile-workspace.js';
+function requireActorSession(profile, actorKind) {
+    const session = profile.actorSessions.find((candidate) => candidate.actorKind === actorKind);
+    if (!session) {
+        throw new Error(`Loaded backend profile does not expose actor kind '${actorKind}'.`);
+    }
+    return session;
+}
+/**
+ * Backend loaded-profile workspace that keeps the canonical
+ * `loadProfile -> workspace/session -> actor facade` story explicit.
+ */
+export class LoadedProfileWorkspace {
+    constructor(profileRuntime, profile) {
+        this.profileRuntime = profileRuntime;
+        this.profile = profile;
+    }
+    close() {
+        return closeBackendProfile(this.profileRuntime, String(this.profile.descriptor.profileDid || this.profile.descriptor.profileId));
+    }
+    registerTrustedDevice(input) {
+        return registerBackendTrustedDevice(this.profileRuntime, input);
+    }
+    connectToSubjectIndex(input) {
+        return connectBackendToSubjectIndex(this.profileRuntime, input);
+    }
+    getSubjectIndexComposition(input) {
+        return getBackendSubjectIndexComposition(this.profileRuntime, input);
+    }
+    asHostOnboarding() {
+        return requireActorSession(this.profile, ActorKinds.HostOnboarding).asHostOnboarding();
+    }
+    asOrganizationController() {
+        return requireActorSession(this.profile, ActorKinds.OrganizationController).asOrganizationController();
+    }
+    asOrganizationEmployee() {
+        return requireActorSession(this.profile, ActorKinds.OrganizationEmployee).asOrganizationEmployee();
+    }
+    asIndividualController() {
+        return requireActorSession(this.profile, ActorKinds.IndividualController).asIndividualController();
+    }
+    asIndividualMember() {
+        return requireActorSession(this.profile, ActorKinds.IndividualMember).asIndividualMember();
+    }
+    asProfessional() {
+        return requireActorSession(this.profile, ActorKinds.Professional).asProfessional();
+    }
+    createOrganizationControllerWorkspace() {
+        const session = requireActorSession(this.profile, ActorKinds.OrganizationController);
+        return createOrganizationControllerProfileWorkspace({
+            profile: this.profile,
+            session,
+            sdk: this.asOrganizationController(),
+        });
+    }
+    createProfessionalWorkspace() {
+        const session = requireActorSession(this.profile, ActorKinds.Professional);
+        return createProfessionalProfileWorkspace({
+            profile: this.profile,
+            session,
+            sdk: this.asProfessional(),
+        });
+    }
+}
+export class ProfileRuntime {
+    constructor(profileRuntime) {
+        this.profileRuntime = profileRuntime;
+    }
+    async loadProfile(input) {
+        const profile = await this.profileRuntime.loadProfile(input);
+        return new LoadedProfileWorkspace(this.profileRuntime, profile);
+    }
+}
+export function createLoadedProfileWorkspace(profileRuntime, profile) {
+    return new LoadedProfileWorkspace(profileRuntime, profile);
+}
+/**
+ * @deprecated Prefer `LoadedProfileWorkspace`.
+ */
+export { LoadedProfileWorkspace as BackendProfileWorkspace };
+/**
+ * @deprecated Prefer `ProfileRuntime`.
+ */
+export { ProfileRuntime as BackendProfileWorkspaceRuntime };
+/**
+ * @deprecated Prefer `createLoadedProfileWorkspace`.
+ */
+export { createLoadedProfileWorkspace as createBackendProfileWorkspace };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './runtime-contracts.js';
 export * from './identity-bootstrap.js';
 export * from './async-polling.js';
 export * from './backend-profile-runtime.js';
+export * from './backend-profile-workspace.js';
 export * from './individual-controller-backend-runtime.js';
 export * from './organization-controller-backend-runtime.js';
 export * from './professional-backend-runtime.js';

package/dist/index.js

@@ -4,6 +4,7 @@ export * from './runtime-contracts.js';
 export * from './identity-bootstrap.js';
 export * from './async-polling.js';
 export * from './backend-profile-runtime.js';
+export * from './backend-profile-workspace.js';
 export * from './individual-controller-backend-runtime.js';
 export * from './organization-controller-backend-runtime.js';
 export * from './professional-backend-runtime.js';

package/dist/individual-controller-backend-runtime.d.ts

@@ -4,7 +4,7 @@ import type { IndividualOrganizationConfirmOrderInput, RouteContext } from './in
 import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from './individual-start.js';
 import type { EnsureFamilyOrganizationRegistrationInput, EnsureFamilyOrganizationRegistrationResult } from './family-organization-registration.js';
 import type { FamilyOrganizationSearchInput } from './family-organization-search.js';
-import type { ClinicalBundleSearchInput } from './resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput } from './resource-operations.js';
 import { type BackendIndividualControllerProfile, type BackendProfileRuntimeClient } from './backend-profile-runtime.js';
 import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
 /**
@@ -56,4 +56,9 @@ export declare class IndividualControllerBackendRuntime {
      * individual-controller facade.
      */
     getLatestIps(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: Omit<ClinicalBundleSearchInput, 'includedTypes'>): Promise<SubmitAndPollResult>;
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a subject communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
 }

package/dist/individual-controller-backend-runtime.js

@@ -64,4 +64,11 @@ export class IndividualControllerBackendRuntime {
     getLatestIps(profile, ctx, input) {
         return profile.sdk.getLatestIps(ctx, input);
     }
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a subject communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(profile, ctx, input) {
+        return profile.sdk.registerBlockchainArtifactAndUpdateIndex(ctx, input);
+    }
 }

package/dist/node-runtime-client.d.ts

@@ -10,7 +10,7 @@ import { type FamilyOrganizationSearchInput } from './family-organization-search
 import { type SmartTokenRequestInput } from './smart-token.js';
 import { type OrganizationLicenseOrderConfirmInput } from './organization-license-order.js';
 import { type IndividualOrganizationBootstrapInput, type IndividualOrganizationStartResult } from './individual-start.js';
-import { type CommunicationIngestionInput, type CommunicationParticipantRuntimeSearchInput, type ClinicalBundleSearchInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type LicenseListRuntimeSearchInput, type LicenseOfferRuntimeSearchInput, type LicenseOrderRuntimeSearchInput, type OrganizationEmployeeCreationInput, type OrganizationEmployeeLifecycleInput, type OrganizationEmployeeSearchInput, type RevokeProfessionalAccessInput, type RevokeProfessionalAccessResult, type RelatedPersonUpsertInput } from './resource-operations.js';
+import { type CommunicationIngestionInput, type BlockchainArtifactRegistrationInput, type VitalSignBatchCommunicationFromSearchResponseInput, type CommunicationParticipantRuntimeSearchInput, type ClinicalBundleSearchInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type LicenseListRuntimeSearchInput, type LicenseOfferRuntimeSearchInput, type LicenseOrderRuntimeSearchInput, type OrganizationEmployeeCreationInput, type OrganizationEmployeeLifecycleInput, type OrganizationEmployeeSearchInput, type RevokeProfessionalAccessInput, type RevokeProfessionalAccessResult, type RelatedPersonUpsertInput } from './resource-operations.js';
 import type { LegalOrganizationOrderInput } from './host-onboarding.js';
 import type { SmartTokenExchangeResult } from './smart-token.js';
 import type { NodeRuntimeClient, PollOptions, PollResult, SubmitAndPollResult, SubmitPayload, SubmitResponse } from './orchestration/client-port.js';
@@ -376,6 +376,16 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
      * @param input Communication payload plus route/format options.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain and waits until
+     * GW has indexed the resulting DocumentReference projection.
+     */
+    registerBlockchainArtifactAndUpdateIndex(ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
+    /**
+     * Builds and submits a Communication carrying the selected vital-sign day
+     * batch artifacts from a paginated search response.
+     */
+    submitVitalSignBatchCommunicationFromSearchResponse(ctx: RouteContext, input: VitalSignBatchCommunicationFromSearchResponseInput): Promise<SubmitAndPollResult>;
     /**
      * Searches communication channel records by subject and participant
      * identifiers through `Communication/_search`.
@@ -483,6 +493,8 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     individualCommunicationPollPath(ctx: RouteContext, format: 'org.hl7.fhir.api' | 'org.hl7.fhir.r4'): string;
     individualCommunicationSearchPath(ctx: RouteContext): string;
     individualCommunicationSearchPollPath(ctx: RouteContext): string;
+    individualDocumentReferenceBatchPath(ctx: RouteContext): string;
+    individualDocumentReferencePollPath(ctx: RouteContext): string;
     individualBundleSearchPath(ctx: RouteContext): string;
     individualBundleSearchPollPath(ctx: RouteContext): string;
     identityTokenExchangePath(ctx: RouteContext): string;

package/dist/node-runtime-client.js

@@ -11,7 +11,7 @@ import { requestSmartTokenWithDeps } from './smart-token.js';
 import { extractOfferIdFromResponseBody, extractOfferPreviewFromResponseBody, } from './order-offer-summary.js';
 import { confirmOrganizationLicenseOrderWithDeps } from './organization-license-order.js';
 import { startIndividualOrganizationWithDeps } from './individual-start.js';
-import { createOrganizationEmployeeWithDeps, disableIndividualMemberWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, listIndividualLicenseOffersWithDeps, listIndividualLicenseOrdersWithDeps, listIndividualLicensesWithDeps, listOrganizationLicenseOffersWithDeps, listOrganizationLicenseOrdersWithDeps, listOrganizationLicensesWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, revokeProfessionalAccessWithDeps, searchCommunicationParticipantsWithDeps, purgeIndividualMemberWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchIndividualLicensesWithDeps, searchIndividualLicenseOffersWithDeps, searchIndividualLicenseOrdersWithDeps, searchOrganizationLicensesWithDeps, searchOrganizationLicenseOffersWithDeps, searchOrganizationLicenseOrdersWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, } from './resource-operations.js';
+import { createOrganizationEmployeeWithDeps, disableIndividualMemberWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, listIndividualLicenseOffersWithDeps, listIndividualLicenseOrdersWithDeps, listIndividualLicensesWithDeps, listOrganizationLicenseOffersWithDeps, listOrganizationLicenseOrdersWithDeps, listOrganizationLicensesWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, buildVitalSignBatchCommunicationFromSearchResponse, registerBlockchainArtifactAndUpdateIndexWithDeps, revokeProfessionalAccessWithDeps, searchCommunicationParticipantsWithDeps, purgeIndividualMemberWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchIndividualLicensesWithDeps, searchIndividualLicenseOffersWithDeps, searchIndividualLicenseOrdersWithDeps, searchOrganizationLicensesWithDeps, searchOrganizationLicenseOffersWithDeps, searchOrganizationLicenseOrdersWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, } from './resource-operations.js';
 import { submitAndPollWithMethods } from './orchestration/client-port.js';
 import { buildRuntimeHeaders, fetchWithTimeout, parseResponseBody, pollBatchResponseWithRuntimeConfig, postJsonWithRuntimeConfig, } from './runtime-transport.js';
 import { activateOrganizationInGatewayFromIcaProofWithDeps, submitLegalOrganizationIssueWithDeps, submitLegalOrganizationVerificationTransactionWithDeps, submitOrganizationDidBindingWithDeps, } from './runtime-host-submission.js';
@@ -680,6 +680,28 @@ export class HttpRuntimeClient {
             submitAndPoll: this.submitAndPoll.bind(this),
         });
     }
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain and waits until
+     * GW has indexed the resulting DocumentReference projection.
+     */
+    async registerBlockchainArtifactAndUpdateIndex(ctx, input) {
+        return registerBlockchainArtifactAndUpdateIndexWithDeps(ctx, input, {
+            individualDocumentReferenceBatchPath: this.paths.individualDocumentReferenceBatchPath.bind(this.paths),
+            individualDocumentReferencePollPath: this.paths.individualDocumentReferencePollPath.bind(this.paths),
+            submitAndPoll: this.submitAndPoll.bind(this),
+        });
+    }
+    /**
+     * Builds and submits a Communication carrying the selected vital-sign day
+     * batch artifacts from a paginated search response.
+     */
+    async submitVitalSignBatchCommunicationFromSearchResponse(ctx, input) {
+        return ingestCommunicationAndUpdateIndexWithDeps(ctx, buildVitalSignBatchCommunicationFromSearchResponse(input), {
+            individualCommunicationBatchPath: this.paths.individualCommunicationBatchPath.bind(this.paths),
+            individualCommunicationPollPath: this.paths.individualCommunicationPollPath.bind(this.paths),
+            submitAndPoll: this.submitAndPoll.bind(this),
+        });
+    }
     /**
      * Searches communication channel records by subject and participant
      * identifiers through `Communication/_search`.
@@ -824,6 +846,8 @@ export class HttpRuntimeClient {
     individualCommunicationPollPath(ctx, format) { return this.paths.individualCommunicationPollPath(ctx, format); }
     individualCommunicationSearchPath(ctx) { return this.paths.individualCommunicationSearchPath(ctx); }
     individualCommunicationSearchPollPath(ctx) { return this.paths.individualCommunicationSearchPollPath(ctx); }
+    individualDocumentReferenceBatchPath(ctx) { return this.paths.individualDocumentReferenceBatchPath(ctx); }
+    individualDocumentReferencePollPath(ctx) { return this.paths.individualDocumentReferencePollPath(ctx); }
     individualBundleSearchPath(ctx) { return this.paths.individualBundleSearchPath(ctx); }
     individualBundleSearchPollPath(ctx) { return this.paths.individualBundleSearchPollPath(ctx); }
     identityTokenExchangePath(ctx) { return this.paths.identityTokenExchangePath(ctx); }

package/dist/orchestration/client-port.d.ts

@@ -13,7 +13,7 @@ import type { FamilyOrganizationSearchInput } from '../family-organization-searc
 import type { EnsureFamilyOrganizationRegistrationInput, EnsureFamilyOrganizationRegistrationResult } from '../family-organization-registration.js';
 import type { OrganizationLicenseOrderConfirmInput } from '../organization-license-order.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
-import type { CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, OrganizationEmployeeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { CommunicationIngestionInput, BlockchainArtifactRegistrationInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, VitalSignBatchCommunicationFromSearchResponseInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, OrganizationEmployeeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
 /**
  * Shared node-runtime activation input.
  *
@@ -58,6 +58,7 @@ export type RuntimeClient = {
     submitOrganizationDidBinding?: (ctx: RouteContext, input: NodeOrganizationDidBindingInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     activateOrganizationInGatewayFromIcaProof?: (hostCtx: HostRouteContext, input: NodeOrganizationActivationInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     confirmLegalOrganizationOrder?: (hostCtx: HostRouteContext, input: LegalOrganizationOrderInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
+    submitVitalSignBatchCommunicationFromSearchResponse?: (ctx: RouteContext, input: VitalSignBatchCommunicationFromSearchResponseInput) => Promise<SubmitAndPollResult>;
     disableHost?: (hostCtx: HostRouteContext, input: HostedTenantLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     purgeHost?: (hostCtx: HostRouteContext, input: HostedTenantLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     disableTenant?: (hostCtx: HostRouteContext, input: HostedTenantLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
@@ -88,6 +89,7 @@ export type RuntimeClient = {
     disableIndividualOrganization?: (ctx: RouteContext, input: IndividualOrganizationLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     purgeIndividualOrganization?: (ctx: RouteContext, input: IndividualOrganizationLifecycleInput, pollOptions?: PollOptions) => Promise<SubmitAndPollResult>;
     ingestCommunicationAndUpdateIndex?: (ctx: RouteContext, input: CommunicationIngestionInput) => Promise<SubmitAndPollResult>;
+    registerBlockchainArtifactAndUpdateIndex?: (ctx: RouteContext, input: BlockchainArtifactRegistrationInput) => Promise<SubmitAndPollResult>;
     searchCommunicationParticipants?: (ctx: RouteContext, input: CommunicationParticipantRuntimeSearchInput) => Promise<SubmitAndPollResult>;
     grantProfessionalAccess?: (ctx: RouteContext, input: GrantProfessionalAccessInput) => Promise<GrantProfessionalAccessResult>;
     revokeProfessionalAccess?: (ctx: RouteContext, input: RevokeProfessionalAccessInput) => Promise<RevokeProfessionalAccessResult>;

package/dist/orchestration/individual-controller-sdk.d.ts

@@ -1,3 +1,4 @@
+import { type IndividualControllerCredentialInput, type IndividualControllerVpPayloadInput, type IndividualSubjectCredentialInput } from 'gdc-common-utils-ts';
 import { type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
 import type { FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
 import type { EnsureFamilyOrganizationRegistrationInput, EnsureFamilyOrganizationRegistrationResult } from '../family-organization-registration.js';
@@ -6,7 +7,7 @@ import type { IndividualOrganizationConfirmOrderInput, RouteContext } from '../i
 import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
 import type { NodeCapability } from '../session.js';
 import type { IndividualOrganizationLifecycleInput } from 'gdc-sdk-core-ts';
-import type { ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
 /**
  * Individual-controller oriented facade over a `NodeRuntimeClient`.
@@ -85,6 +86,11 @@ export declare class IndividualControllerSdk {
      * Ingests a FHIR `Communication` and waits for indexing.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a subject communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
     /**
      * Searches indexed communication channel records by subject and participant
      * identifiers.
@@ -133,6 +139,36 @@ export declare class IndividualControllerSdk {
      * Requests a SMART/OpenID token for subsequent data access flows.
      */
     requestSmartToken(input: SmartTokenRequestInput): Promise<SmartTokenExchangeResult>;
+    /**
+     * Returns the normalized public continuity aliases that would be embedded in
+     * the individual-controller identity VC for SMART/OpenID4VP flows.
+     */
+    getIdentitySameAs(input: IndividualControllerCredentialInput): string[];
+    /**
+     * Builds the canonical individual-controller identity VC used by shared
+     * SMART VP helpers.
+     */
+    getIdentityVC(input: IndividualControllerCredentialInput): Record<string, unknown>;
+    /**
+     * Builds one canonical subject VC for the dependent subject managed by the
+     * current controller, for example a child, pet, or another represented
+     * individual.
+     */
+    getSubjectVC(input: IndividualSubjectCredentialInput): Record<string, unknown>;
+    /**
+     * Builds the canonical individual-controller identity VP payload used by
+     * shared SMART/OpenID4VP helpers.
+     */
+    buildIdentityVpPayload(input: IndividualControllerVpPayloadInput): Record<string, unknown>;
+    /**
+     * Builds one unsigned compact VP JWT for the canonical
+     * individual-controller identity payload.
+     */
+    buildUnsignedIdentityVpJwt(input: IndividualControllerVpPayloadInput, options?: Readonly<{
+        nowSeconds?: number;
+        ttlSeconds?: number;
+        nonce?: string;
+    }>): string;
     /**
      * Low-level escape hatch for direct submit/poll flows.
      */

package/dist/orchestration/individual-controller-sdk.js

@@ -1,5 +1,6 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { ActorCapabilities, ActorKinds } from 'gdc-common-utils-ts/constants/actor-session';
+import { buildIndividualControllerIdentityVpPayload, buildUnsignedIndividualControllerIdentityVpJwt, getIndividualControllerIdentitySameAs, getIndividualControllerIdentityVC, getIndividualSubjectVC, } from 'gdc-common-utils-ts';
 import { requireClientMethod, submitAndPollWithClient, } from './client-port.js';
 import { assertFacadeCapability } from './capability-guard.js';
 /**
@@ -123,6 +124,13 @@ export class IndividualControllerSdk {
         assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualIngestCommunication, ActorKinds.IndividualController, 'ingestCommunicationAndUpdateIndex');
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a subject communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(ctx, input) {
+        return requireClientMethod(this.client, 'registerBlockchainArtifactAndUpdateIndex')(ctx, input);
+    }
     /**
      * Searches indexed communication channel records by subject and participant
      * identifiers.
@@ -194,6 +202,42 @@ export class IndividualControllerSdk {
     requestSmartToken(input) {
         return requireClientMethod(this.client, 'requestSmartToken')(input);
     }
+    /**
+     * Returns the normalized public continuity aliases that would be embedded in
+     * the individual-controller identity VC for SMART/OpenID4VP flows.
+     */
+    getIdentitySameAs(input) {
+        return getIndividualControllerIdentitySameAs(input);
+    }
+    /**
+     * Builds the canonical individual-controller identity VC used by shared
+     * SMART VP helpers.
+     */
+    getIdentityVC(input) {
+        return getIndividualControllerIdentityVC(input);
+    }
+    /**
+     * Builds one canonical subject VC for the dependent subject managed by the
+     * current controller, for example a child, pet, or another represented
+     * individual.
+     */
+    getSubjectVC(input) {
+        return getIndividualSubjectVC(input);
+    }
+    /**
+     * Builds the canonical individual-controller identity VP payload used by
+     * shared SMART/OpenID4VP helpers.
+     */
+    buildIdentityVpPayload(input) {
+        return buildIndividualControllerIdentityVpPayload(input);
+    }
+    /**
+     * Builds one unsigned compact VP JWT for the canonical
+     * individual-controller identity payload.
+     */
+    buildUnsignedIdentityVpJwt(input, options = {}) {
+        return buildUnsignedIndividualControllerIdentityVpJwt(input, options);
+    }
     /**
      * Low-level escape hatch for direct submit/poll flows.
      */

package/dist/orchestration/individual-member-sdk.d.ts

@@ -1,3 +1,4 @@
+import { type IndividualMemberCredentialInput, type IndividualMemberVpPayloadInput } from 'gdc-common-utils-ts';
 import { type NodeRuntimeClient } from './client-port.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
 import type { RouteContext } from '../individual-onboarding.js';
@@ -14,4 +15,28 @@ export declare class IndividualMemberSdk {
      * caregiver, guardian, or family member.
      */
     requestSmartToken(input: SmartTokenRequestInput): Promise<SmartTokenExchangeResult>;
+    /**
+     * Returns the normalized public continuity aliases that would be embedded in
+     * the individual-member identity VC for SMART/OpenID4VP flows.
+     */
+    getIdentitySameAs(input: IndividualMemberCredentialInput): string[];
+    /**
+     * Builds the canonical individual-member identity VC used by shared SMART VP
+     * helpers.
+     */
+    getIdentityVC(input: IndividualMemberCredentialInput): Record<string, unknown>;
+    /**
+     * Builds the canonical individual-member identity VP payload used by shared
+     * SMART/OpenID4VP helpers.
+     */
+    buildIdentityVpPayload(input: IndividualMemberVpPayloadInput): Record<string, unknown>;
+    /**
+     * Builds one unsigned compact VP JWT for the canonical individual-member
+     * identity payload.
+     */
+    buildUnsignedIdentityVpJwt(input: IndividualMemberVpPayloadInput, options?: Readonly<{
+        nowSeconds?: number;
+        ttlSeconds?: number;
+        nonce?: string;
+    }>): string;
 }

package/dist/orchestration/individual-member-sdk.js

@@ -1,4 +1,5 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { buildIndividualMemberIdentityVpPayload, buildUnsignedIndividualMemberIdentityVpJwt, getIndividualMemberIdentitySameAs, getIndividualMemberIdentityVC, } from 'gdc-common-utils-ts';
 import { requireClientMethod } from './client-port.js';
 export class IndividualMemberSdk {
     constructor(client) {
@@ -17,4 +18,32 @@ export class IndividualMemberSdk {
     requestSmartToken(input) {
         return requireClientMethod(this.client, 'requestSmartToken')(input);
     }
+    /**
+     * Returns the normalized public continuity aliases that would be embedded in
+     * the individual-member identity VC for SMART/OpenID4VP flows.
+     */
+    getIdentitySameAs(input) {
+        return getIndividualMemberIdentitySameAs(input);
+    }
+    /**
+     * Builds the canonical individual-member identity VC used by shared SMART VP
+     * helpers.
+     */
+    getIdentityVC(input) {
+        return getIndividualMemberIdentityVC(input);
+    }
+    /**
+     * Builds the canonical individual-member identity VP payload used by shared
+     * SMART/OpenID4VP helpers.
+     */
+    buildIdentityVpPayload(input) {
+        return buildIndividualMemberIdentityVpPayload(input);
+    }
+    /**
+     * Builds one unsigned compact VP JWT for the canonical individual-member
+     * identity payload.
+     */
+    buildUnsignedIdentityVpJwt(input, options = {}) {
+        return buildUnsignedIndividualMemberIdentityVpJwt(input, options);
+    }
 }

package/dist/orchestration/personal-sdk.d.ts

@@ -1,7 +1,7 @@
 import { type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
 import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
 import type { RouteContext } from '../individual-onboarding.js';
-import type { ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput } from '../resource-operations.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
 export declare class PersonalSdk {
     private readonly client;
@@ -14,6 +14,8 @@ export declare class PersonalSdk {
     importIpsOrFhirAndUpdateIndex(ctx: RouteContext, input: IpsOrFhirImportInput): Promise<SubmitAndPollResult>;
     /** Ingests canonical Communication and waits for projection completion. */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /** Registers one FHIR resource or raw artifact on blockchain before communication. */
+    registerBlockchainArtifactAndUpdateIndex(ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
     /** Searches indexed communication channel records by subject and participant identifiers. */
     searchCommunicationParticipants(ctx: RouteContext, input: CommunicationParticipantRuntimeSearchInput): Promise<SubmitAndPollResult>;
     /** Triggers digital twin generation from subject data. */

package/dist/orchestration/personal-sdk.js

@@ -20,6 +20,10 @@ export class PersonalSdk {
     ingestCommunicationAndUpdateIndex(ctx, input) {
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /** Registers one FHIR resource or raw artifact on blockchain before communication. */
+    registerBlockchainArtifactAndUpdateIndex(ctx, input) {
+        return requireClientMethod(this.client, 'registerBlockchainArtifactAndUpdateIndex')(ctx, input);
+    }
     /** Searches indexed communication channel records by subject and participant identifiers. */
     searchCommunicationParticipants(ctx, input) {
         return requireClientMethod(this.client, 'searchCommunicationParticipants')(ctx, input);

package/dist/orchestration/professional-sdk.d.ts

@@ -2,7 +2,7 @@ import { type ProfessionalEmployeeCredentialInput, type ProfessionalSmartVpPaylo
 import { type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
 import type { RouteContext } from '../individual-onboarding.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
-import type { CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, VitalSignBatchCommunicationFromSearchResponseInput } from '../resource-operations.js';
 /**
  * Professional-oriented facade for runtime actions that belong to the
  * professional actor itself after tenant and employee provisioning have already
@@ -68,6 +68,16 @@ export declare class ProfessionalSdk {
      * Ingests a FHIR `Communication` and waits for indexing.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /**
+     * Registers one FHIR resource or raw document artifact on blockchain before
+     * the artifact is attached to a Communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
+    /**
+     * Converts a paginated vital-sign search response into one Communication
+     * carrying the selected day-batch artifacts and submits it.
+     */
+    submitVitalSignBatchCommunicationFromSearchResponse(ctx: RouteContext, input: VitalSignBatchCommunicationFromSearchResponseInput): Promise<SubmitAndPollResult>;
     /**
      * Searches indexed communication channel records by subject and participant
      * identifiers.

package/dist/orchestration/professional-sdk.js

@@ -80,6 +80,20 @@ export class ProfessionalSdk {
     ingestCommunicationAndUpdateIndex(ctx, input) {
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /**
+     * Registers one FHIR resource or raw document artifact on blockchain before
+     * the artifact is attached to a Communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(ctx, input) {
+        return requireClientMethod(this.client, 'registerBlockchainArtifactAndUpdateIndex')(ctx, input);
+    }
+    /**
+     * Converts a paginated vital-sign search response into one Communication
+     * carrying the selected day-batch artifacts and submits it.
+     */
+    submitVitalSignBatchCommunicationFromSearchResponse(ctx, input) {
+        return requireClientMethod(this.client, 'submitVitalSignBatchCommunicationFromSearchResponse')(ctx, input);
+    }
     /**
      * Searches indexed communication channel records by subject and participant
      * identifiers.

package/dist/professional-backend-runtime.d.ts

@@ -2,7 +2,7 @@ import type { SubmitAndPollResult } from 'gdc-sdk-core-ts';
 import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
 import type { RouteContext } from './individual-onboarding.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from './smart-token.js';
-import type { ClinicalBundleSearchInput } from './resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput } from './resource-operations.js';
 import { type BackendProfessionalProfile, type BackendProfileRuntimeClient } from './backend-profile-runtime.js';
 /**
  * Backend use-case facade for the current professional happy path.
@@ -33,4 +33,9 @@ export declare class ProfessionalBackendRuntime {
      * Reads the latest IPS-oriented bundle through the professional facade.
      */
     getLatestIps(profile: BackendProfessionalProfile, ctx: RouteContext, input: Omit<ClinicalBundleSearchInput, 'includedTypes'>): Promise<SubmitAndPollResult>;
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(profile: BackendProfessionalProfile, ctx: RouteContext, input: BlockchainArtifactRegistrationInput): Promise<SubmitAndPollResult>;
 }

package/dist/professional-backend-runtime.js

@@ -38,4 +38,11 @@ export class ProfessionalBackendRuntime {
     getLatestIps(profile, ctx, input) {
         return profile.sdk.getLatestIps(ctx, input);
     }
+    /**
+     * Registers one FHIR resource or raw artifact on blockchain before it is
+     * attached to a communication.
+     */
+    registerBlockchainArtifactAndUpdateIndex(profile, ctx, input) {
+        return profile.sdk.registerBlockchainArtifactAndUpdateIndex(ctx, input);
+    }
 }

package/dist/profile-workspace.d.ts

@@ -1,4 +1,5 @@
 import { CommunicationAttachedBundleSession, IndividualBundleVault, buildVitalSignObservationClaims, createSummaryOperationRequestParameters, createSummaryOperationRequestParametersResource, summarizeClinicalBundle, toClinicalResourceExpandedViews, type BuildVitalSignObservationClaimsInput } from 'gdc-common-utils-ts';
+import type { BundleEntry, BundleJsonApi } from 'gdc-common-utils-ts/models/bundle';
 import type { BackendOrganizationControllerProfile, BackendProfessionalProfile } from './backend-profile-runtime.js';
 export type IpsRequestDraft = Readonly<{
     subjectId: string;
@@ -29,6 +30,17 @@ declare class ProfessionalSubjectIpsWorkspace {
     processResponseBundleIps(body: unknown): ProcessedClinicalBundleResponse;
     rememberResponseBundleIps(body: unknown): Promise<IndividualBundleVault>;
     addVitalSign(input: BuildVitalSignObservationClaimsInput): Promise<IndividualBundleVault>;
+    buildVitalSignBatchCommunicationFromSearchResponse(searchResponse: unknown, selectedResourceIds?: readonly string[]): import("./resource-operations.js").CommunicationIngestionInput;
+    buildBlockchainArtifactBundleFromSearchResponse(searchResponse: unknown, selectedResourceIds?: readonly string[]): Readonly<{
+        availableResourceIds: readonly string[];
+        anchoredResourceIds: readonly string[];
+        unanchoredResourceIds: readonly string[];
+        selectedResourceIds: readonly string[];
+        missingResourceIds: readonly string[];
+        returnedCount: number;
+        totalCount: number;
+        bundle: BundleJsonApi<BundleEntry>;
+    }>;
     get cache(): IndividualBundleVault;
 }
 declare class ProfessionalSubjectWorkspace {

package/dist/profile-workspace.js

@@ -1,5 +1,6 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { CommunicationAttachedBundleSession, IndividualBundleVault, VaultMemRepository, buildVitalSignObservationClaims, createConsentAccessEditor, createInvoiceBundleEditor, createSummaryOperationRequestParameters, createSummaryOperationRequestParametersResource, createSummaryOperationRequestReferencePath, readEmployeeSearchResults, summarizeClinicalBundle, summarizeLicenseListRecords, toClinicalResourceExpandedViews, } from 'gdc-common-utils-ts';
+import { buildBlockchainArtifactBundleFromSearchResponse, buildVitalSignBatchCommunicationFromSearchResponse } from './resource-operations.js';
 function normalizeSectionList(sectionList) {
     return Array.from(new Set((sectionList || []).map((item) => String(item || '').trim()).filter(Boolean)));
 }
@@ -69,6 +70,20 @@ class ProfessionalSubjectIpsWorkspace {
         await this.bundleVault.upsertVitalSign(input);
         return this.bundleVault;
     }
+    buildVitalSignBatchCommunicationFromSearchResponse(searchResponse, selectedResourceIds) {
+        return buildVitalSignBatchCommunicationFromSearchResponse({
+            subject: this.subjectId,
+            searchResponse,
+            selectedResourceIds,
+        });
+    }
+    buildBlockchainArtifactBundleFromSearchResponse(searchResponse, selectedResourceIds) {
+        return buildBlockchainArtifactBundleFromSearchResponse({
+            subject: this.subjectId,
+            searchResponse,
+            selectedResourceIds,
+        });
+    }
     get cache() {
         return this.bundleVault;
     }

package/dist/resource-operations.d.ts

@@ -1,6 +1,7 @@
 import type { LicenseOfferSearchState, LicenseOrderSearchState } from 'gdc-common-utils-ts/utils/license-commercial-search';
 import type { LicenseListSearchState } from 'gdc-common-utils-ts/utils/license-list-search';
 import type { BundleSearchQuery, CommunicationInput, DateRange, EmployeeSearchValue, IndividualOrganizationLifecycleInput } from 'gdc-sdk-core-ts';
+import type { BundleEntry, BundleJsonApi } from 'gdc-common-utils-ts/models/bundle';
 import type { SubmitAndPollResult } from './orchestration/client-port.js';
 import type { RouteContext } from './individual-onboarding.js';
 export type OrganizationEmployeeCreationInput = {
@@ -160,6 +161,53 @@ export type CommunicationIngestionInput = {
         intervalMs?: number;
     };
 };
+export type BlockchainArtifactRegistrationInput = {
+    subject: string;
+    resource?: Record<string, unknown>;
+    contentDataBase64?: string;
+    contentType?: string;
+    identifier?: string;
+    title?: string;
+    description?: string;
+    date?: string;
+    location?: string;
+    language?: string;
+    requestThid?: string;
+    pollOptions?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    };
+};
+export type BlockchainArtifactSearchSelectionInput = Readonly<{
+    subject: string;
+    searchResponse: unknown;
+    selectedResourceIds?: readonly string[];
+}>;
+export type BlockchainArtifactSearchSelectionResult = Readonly<{
+    availableResourceIds: readonly string[];
+    anchoredResourceIds: readonly string[];
+    unanchoredResourceIds: readonly string[];
+    selectedResourceIds: readonly string[];
+    missingResourceIds: readonly string[];
+    returnedCount: number;
+    totalCount: number;
+    bundle: BundleJsonApi<BundleEntry>;
+}>;
+export type VitalSignBatchCommunicationFromSearchResponseInput = Readonly<{
+    subject: string;
+    searchResponse: unknown;
+    selectedResourceIds?: readonly string[];
+    sender?: string;
+    recipient?: string | string[];
+    sent?: string;
+    status?: string;
+    noteText?: string;
+    requestThid?: string;
+    pollOptions?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    };
+}>;
 /**
  * Runtime participant query for `Communication/_search`.
  *
@@ -532,11 +580,37 @@ export declare function searchClinicalBundleWithDeps(routeCtx: RouteContext, inp
         intervalMs?: number;
     }) => Promise<SubmitAndPollResult>;
 }): Promise<SubmitAndPollResult>;
+/**
+ * Builds one Communication-ready ingestion payload from a paginated search
+ * response that already selected the day batches to be anchored.
+ *
+ * The search response is normalized into a `Bundle.type=batch` attachment,
+ * and the resulting `Communication` is ready for `ingestCommunication...`.
+ */
+export declare function buildVitalSignBatchCommunicationFromSearchResponse(input: VitalSignBatchCommunicationFromSearchResponseInput): CommunicationIngestionInput;
+/**
+ * Builds one blockchain-ready batch bundle from a paginated search response.
+ *
+ * The helper keeps the original search result as the source of truth and only
+ * projects the selected `resource.id` values into a `Bundle.type=batch`
+ * payload for subsequent communication/registration.
+ */
+export declare function buildBlockchainArtifactBundleFromSearchResponse(input: BlockchainArtifactSearchSelectionInput): BlockchainArtifactSearchSelectionResult;
 export declare function searchLatestIpsWithDeps(routeCtx: RouteContext, input: Omit<ClinicalBundleSearchInput, 'includedTypes' | 'section'> & {
     section?: string | string[];
 }, deps: {
     searchClinicalBundle: (routeCtx: RouteContext, input: ClinicalBundleSearchInput) => Promise<SubmitAndPollResult>;
 }): Promise<SubmitAndPollResult>;
+export declare function registerBlockchainArtifactAndUpdateIndexWithDeps(routeCtx: RouteContext, input: BlockchainArtifactRegistrationInput, deps: {
+    individualDocumentReferenceBatchPath: (ctx: RouteContext) => string;
+    individualDocumentReferencePollPath: (ctx: RouteContext) => string;
+    submitAndPoll: (submitPath: string, pollPath: string, payload: {
+        thid?: string;
+    } & Record<string, unknown>, pollOptions?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }) => Promise<SubmitAndPollResult>;
+}): Promise<SubmitAndPollResult>;
 export declare function grantProfessionalAccessWithDeps(routeCtx: RouteContext, input: GrantProfessionalAccessInput, deps: {
     buildConsentClaimsWithCid: (input: GrantProfessionalAccessInput, options?: {
         consentIdentifierFactory: () => string;

package/dist/resource-operations.js

@@ -2,7 +2,8 @@
 import { HealthcareBasicSections, ResourceTypesFhirR4 } from 'gdc-common-utils-ts/constants';
 import { Format } from 'gdc-common-utils-ts/constants/Schemas';
 import { RelatedPersonClaim } from 'gdc-common-utils-ts/models/interoperable-claims/related-person-claims';
-import { buildCommunicationParticipantSearchBundle, createInteroperableResourceOperationEditor, IndividualOrganizationLifecycleEditor, LicenseOfferSearchEditor, LicenseOrderSearchEditor, InteroperableLifecycleStatuses, LicenseListSearchEditor, } from 'gdc-common-utils-ts';
+import { buildCommunicationParticipantSearchBundle, buildBlockchainArtifactDocumentReference, BundleQuery, createInteroperableResourceOperationEditor, IndividualOrganizationLifecycleEditor, LicenseOfferSearchEditor, LicenseOrderSearchEditor, InteroperableLifecycleStatuses, LicenseListSearchEditor, } from 'gdc-common-utils-ts';
+import { addFhirResourceToCommunication, createCommunicationResource, } from 'gdc-sdk-core-ts';
 import { GwCoreLifecycleRequestMethod, GwCoreLifecycleRequestType, GwCoreLifecycleTodo, } from './constants/lifecycle.js';
 import { buildEmployeeBatchEntry, buildEmployeeSearchBundle, ConsentClaims, } from 'gdc-sdk-core-ts';
 export async function createOrganizationEmployeeWithDeps(routeCtx, input, options, deps) {
@@ -323,6 +324,117 @@ export async function searchClinicalBundleWithDeps(routeCtx, input, deps) {
     };
     return deps.submitAndPoll(deps.bundleSearchPath(routeCtx), deps.bundleSearchPollPath(routeCtx), payload, input.pollOptions);
 }
+/**
+ * Builds one Communication-ready ingestion payload from a paginated search
+ * response that already selected the day batches to be anchored.
+ *
+ * The search response is normalized into a `Bundle.type=batch` attachment,
+ * and the resulting `Communication` is ready for `ingestCommunication...`.
+ */
+export function buildVitalSignBatchCommunicationFromSearchResponse(input) {
+    const selection = buildBlockchainArtifactBundleFromSearchResponse({
+        subject: input.subject,
+        searchResponse: input.searchResponse,
+        selectedResourceIds: input.selectedResourceIds,
+    });
+    const communication = addFhirResourceToCommunication(createCommunicationResource({
+        subject: input.subject,
+        sender: input.sender,
+        recipient: input.recipient,
+        sent: input.sent,
+        status: input.status || 'completed',
+        noteText: input.noteText || `Selected ${selection.selectedResourceIds.length} vital-sign batch item(s) for blockchain anchoring.`,
+        claims: {
+            'Communication.vital-sign-batch-selection.subject': input.subject,
+            'Communication.vital-sign-batch-selection.selected-count': selection.selectedResourceIds.length,
+            'Communication.vital-sign-batch-selection.unanchored-count': selection.unanchoredResourceIds.length,
+            'Communication.vital-sign-batch-selection.selected-ids': selection.selectedResourceIds.join(','),
+            'Communication.vital-sign-batch-selection.missing-ids': selection.missingResourceIds.join(','),
+        },
+    }), selection.bundle, {
+        attachmentContentType: 'application/fhir+json',
+        attachmentTitle: 'vital-sign-batch-selection.json',
+    });
+    return {
+        communicationPayload: communication,
+        pathFormatSegment: 'org.hl7.fhir.r4',
+        pollOptions: input.pollOptions,
+        autoConvertClaimsToFhirR4: false,
+    };
+}
+/**
+ * Builds one blockchain-ready batch bundle from a paginated search response.
+ *
+ * The helper keeps the original search result as the source of truth and only
+ * projects the selected `resource.id` values into a `Bundle.type=batch`
+ * payload for subsequent communication/registration.
+ */
+export function buildBlockchainArtifactBundleFromSearchResponse(input) {
+    const bundle = normalizeBundleLike(input.searchResponse);
+    const query = new BundleQuery(bundle);
+    const availableResourceIds = query.getResourceIds();
+    const availableEntries = query.getResourceEntriesByIds(availableResourceIds);
+    const anchoredResourceIds = availableEntries
+        .filter((entry) => hasAuditTxId(entry))
+        .map((entry, index) => resolveBundleEntryStableId(entry, index));
+    const unanchoredResourceIds = availableResourceIds.filter((resourceId) => !anchoredResourceIds.includes(resourceId));
+    const requestedResourceIds = normalizeIdList(input.selectedResourceIds);
+    const selectedResourceIds = requestedResourceIds.length > 0
+        ? requestedResourceIds.filter((resourceId) => availableResourceIds.includes(resourceId))
+        : unanchoredResourceIds;
+    const missingResourceIds = requestedResourceIds.filter((resourceId) => !availableResourceIds.includes(resourceId));
+    if (requestedResourceIds.length > 0 && selectedResourceIds.length === 0) {
+        throw new Error('buildBlockchainArtifactBundleFromSearchResponse could not match any selected resource ids.');
+    }
+    const selectedEntries = query.getResourceEntriesByIds(selectedResourceIds);
+    const artifactEntries = selectedEntries.map((entry, index) => {
+        const resource = entry.resource && typeof entry.resource === 'object' ? entry.resource : undefined;
+        if (!resource) {
+            throw new Error(`buildBlockchainArtifactBundleFromSearchResponse requires resource data for selected entry at index ${index}.`);
+        }
+        const logicalIdentifier = asTrimmedString(resource.id || entry.id || entry.fullUrl || selectedResourceIds[index]);
+        const artifact = buildBlockchainArtifactDocumentReference({
+            subject: input.subject,
+            resource,
+            identifier: logicalIdentifier || undefined,
+            title: `${asTrimmedString(resource.resourceType) || 'resource'}.json`,
+        });
+        return {
+            type: 'DocumentReference',
+            meta: { claims: artifact.documentReference.meta?.claims || {} },
+            resource: artifact.documentReference,
+            request: {
+                method: 'POST',
+                url: 'individual/org.hl7.fhir.r4/DocumentReference/_batch',
+            },
+        };
+    });
+    return {
+        availableResourceIds,
+        anchoredResourceIds,
+        unanchoredResourceIds,
+        selectedResourceIds,
+        missingResourceIds,
+        returnedCount: query.getResourceIds().length,
+        totalCount: typeof bundle.total === 'number'
+            ? Number(bundle.total)
+            : query.getResourceIds().length,
+        bundle: {
+            resourceType: 'Bundle',
+            type: 'batch',
+            meta: {
+                claims: {
+                    'BlockchainArtifactSelection.subject': input.subject,
+                    'BlockchainArtifactSelection.availableCount': availableResourceIds.length,
+                    'BlockchainArtifactSelection.selectedCount': selectedResourceIds.length,
+                    'BlockchainArtifactSelection.missingCount': missingResourceIds.length,
+                    'BlockchainArtifactSelection.selectedResourceIds': selectedResourceIds.join(','),
+                },
+            },
+            data: artifactEntries,
+        },
+    };
+}
 export async function searchLatestIpsWithDeps(routeCtx, input, deps) {
     return deps.searchClinicalBundle(routeCtx, {
         ...input,
@@ -330,6 +442,78 @@ export async function searchLatestIpsWithDeps(routeCtx, input, deps) {
         includedTypes: ['Composition', 'DocumentReference'],
     });
 }
+export async function registerBlockchainArtifactAndUpdateIndexWithDeps(routeCtx, input, deps) {
+    const artifact = buildBlockchainArtifactDocumentReference({
+        subject: input.subject,
+        resource: input.resource,
+        contentDataBase64: input.contentDataBase64,
+        contentType: input.contentType,
+        identifier: input.identifier,
+        title: input.title,
+        description: input.description,
+        date: input.date,
+        location: input.location,
+        language: input.language,
+    });
+    const payload = {
+        thid: input.requestThid || `blockchain-artifact-${createRuntimeUuid()}`,
+        body: {
+            resourceType: 'Bundle',
+            type: 'batch',
+            data: [{
+                    type: 'DocumentReference',
+                    meta: { claims: artifact.documentReference.meta?.claims || {} },
+                    resource: artifact.documentReference,
+                    request: {
+                        method: 'POST',
+                        url: 'individual/org.hl7.fhir.r4/DocumentReference/_batch',
+                    },
+                }],
+        },
+    };
+    return deps.submitAndPoll(deps.individualDocumentReferenceBatchPath(routeCtx), deps.individualDocumentReferencePollPath(routeCtx), payload, input.pollOptions);
+}
+function normalizeBundleLike(value) {
+    const root = value && typeof value === 'object' ? value : {};
+    const body = root.body && typeof root.body === 'object' ? root.body : root;
+    const resourceType = asTrimmedString(body.resourceType) || 'Bundle';
+    const type = asTrimmedString(body.type) || 'batch';
+    const data = Array.isArray(body.data)
+        ? body.data
+        : (Array.isArray(body.entry) ? body.entry : []);
+    return {
+        ...(typeof body.id === 'string' ? { id: asTrimmedString(body.id) || undefined } : {}),
+        resourceType: resourceType,
+        type,
+        total: typeof body.total === 'number' ? body.total : undefined,
+        meta: body.meta && typeof body.meta === 'object' ? body.meta : undefined,
+        data: data,
+    };
+}
+function normalizeIdList(value) {
+    return [...(value || [])]
+        .map((item) => asTrimmedString(item))
+        .filter(Boolean);
+}
+function asTrimmedString(value) {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    return String(value).trim();
+}
+function resolveBundleEntryStableId(entry, index) {
+    const resource = entry.resource && typeof entry.resource === 'object' ? entry.resource : {};
+    return asTrimmedString(resource.id || entry.id || entry.fullUrl || `entry-${index}`);
+}
+function hasAuditTxId(entry) {
+    const entryAudit = entry && typeof entry === 'object' ? entry.audit : undefined;
+    const entryMeta = entry && typeof entry === 'object' ? entry.meta : undefined;
+    const resource = entry.resource && typeof entry.resource === 'object' ? entry.resource : {};
+    const resourceMeta = resource.meta && typeof resource.meta === 'object' ? resource.meta : {};
+    const audit = [entryAudit, entryMeta && typeof entryMeta === 'object' ? entryMeta.audit : undefined, resourceMeta.audit]
+        .find((candidate) => candidate && typeof candidate === 'object');
+    return Boolean(asTrimmedString(audit?.txId));
+}
 export async function grantProfessionalAccessWithDeps(routeCtx, input, deps) {
     const built = deps.buildConsentClaimsWithCid({
         subjectDid: input.subjectDid,

package/dist/runtime-client-paths.d.ts

@@ -68,6 +68,8 @@ export declare class RuntimeClientPaths {
     individualCommunicationPollPath(ctx: RouteContext, format: 'org.hl7.fhir.api' | 'org.hl7.fhir.r4'): string;
     individualCommunicationSearchPath(ctx: RouteContext): string;
     individualCommunicationSearchPollPath(ctx: RouteContext): string;
+    individualDocumentReferenceBatchPath(ctx: RouteContext): string;
+    individualDocumentReferencePollPath(ctx: RouteContext): string;
     individualBundleSearchPath(ctx: RouteContext): string;
     individualBundleSearchPollPath(ctx: RouteContext): string;
     identityTokenExchangePath(ctx: RouteContext): string;

package/dist/runtime-client-paths.js

@@ -82,6 +82,8 @@ export class RuntimeClientPaths {
     individualCommunicationPollPath(ctx, format) { return this.v1Path(ctx, 'individual', format, 'Communication', '_batch-response'); }
     individualCommunicationSearchPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'Communication', '_search'); }
     individualCommunicationSearchPollPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'Communication', '_search-response'); }
+    individualDocumentReferenceBatchPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'DocumentReference', '_batch'); }
+    individualDocumentReferencePollPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'DocumentReference', '_batch-response'); }
     individualBundleSearchPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'Bundle', '_search'); }
     individualBundleSearchPollPath(ctx) { return this.v1Path(ctx, 'individual', 'org.hl7.fhir.r4', 'Bundle', '_search-response'); }
     identityTokenExchangePath(ctx) { return buildIdentityTokenExchangePath(ctx); }

package/dist/runtime-route-context.js

@@ -1,4 +1,6 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { extractTenantIdFromHostedDidWeb } from 'gdc-common-utils-ts';
+let warnedServiceProviderDidRouteTenant = false;
 export function requireRouteContext(ctx, defaultCtx) {
     const resolved = ctx || defaultCtx;
     const tenantId = String(resolved?.tenantId || '').trim();
@@ -10,7 +12,22 @@ export function requireRouteContext(ctx, defaultCtx) {
     return { tenantId, jurisdiction, sector };
 }
 export function routeCtxFromInput(input, defaultCtx) {
-    const tenantId = String(input.serviceProviderDid || input.tenantId || '').trim();
+    const explicitTenantId = String(input.tenantId || '').trim();
+    const serviceProviderDid = String(input.serviceProviderDid || '').trim();
+    let tenantId = explicitTenantId;
+    if (!tenantId && serviceProviderDid) {
+        const extractedTenantId = extractTenantIdFromHostedDidWeb(serviceProviderDid);
+        if (extractedTenantId) {
+            if (!warnedServiceProviderDidRouteTenant) {
+                warnedServiceProviderDidRouteTenant = true;
+                console.warn(`[gdc-sdk-node-ts] serviceProviderDid is a compatibility alias for route tenant ids. Pass tenantId instead. Extracted tenantId='${extractedTenantId}' from hosted did:web '${serviceProviderDid}'.`);
+            }
+            tenantId = extractedTenantId;
+        }
+        else {
+            tenantId = serviceProviderDid;
+        }
+    }
     return requireRouteContext(tenantId && input.jurisdiction && input.sector
         ? { tenantId, jurisdiction: input.jurisdiction, sector: input.sector }
         : undefined, defaultCtx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "2.1.4",
+  "version": "2.2.2",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -35,8 +35,8 @@
     "test:e2e:live-gw:clean": "bash ./scripts/run-live-gw-clean.sh"
   },
   "dependencies": {
-    "gdc-common-utils-ts": "^2.1.2",
-    "gdc-sdk-core-ts": "~2.1.2"
+    "gdc-common-utils-ts": "^2.2.2",
+    "gdc-sdk-core-ts": "~2.2.1"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",