gdc-sdk-node-ts 2.3.2 → 2.3.4

package/dist/gdc-session-bridge.js

@@ -21,6 +21,7 @@ const capabilityMap = {
     [ActorCapabilities.IndividualImportIps]: ActorCapabilities.IndividualImportIps,
     [ActorCapabilities.IndividualGenerateDigitalTwin]: ActorCapabilities.IndividualGenerateDigitalTwin,
     [ActorCapabilities.IndividualIngestCommunication]: ActorCapabilities.IndividualIngestCommunication,
+    [ActorCapabilities.IndividualReadClinicalSummary]: ActorCapabilities.IndividualReadClinicalSummary,
     [ActorCapabilities.IndividualUpsertRelatedPerson]: ActorCapabilities.IndividualUpsertRelatedPerson,
     [ActorCapabilities.IndividualMemberDisable]: ActorCapabilities.IndividualMemberDisable,
     [ActorCapabilities.IndividualMemberPurge]: ActorCapabilities.IndividualMemberPurge,

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 { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput } from './resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput } from './resource-operations.js';
 import { type BackendIndividualControllerProfile, type BackendProfileRuntimeClient } from './backend-profile-runtime.js';
 import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
 /**
@@ -17,8 +17,8 @@ import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
  * - load an individual-controller profile
  * - start individual registration/bootstrap
  * - confirm the returned order/offer
- * - search the subject clinical index
- * - request the latest IPS-oriented bundle
+ * - request the available subject clinical summary through Communication
+ * - use direct index searches only for compatibility/specialized queries
  */
 export declare class IndividualControllerBackendRuntime {
     private readonly profileRuntime;
@@ -47,8 +47,13 @@ export declare class IndividualControllerBackendRuntime {
      */
     confirmIndividualOrganizationOrder(profile: BackendIndividualControllerProfile, input: IndividualOrganizationConfirmOrderInput): Promise<SubmitAndPollResult>;
     /**
-     * Searches the current subject clinical bundle index through the loaded
-     * individual-controller facade.
+     * Reads the authoritative subject document through the canonical
+     * `Communication -> Subject/$summary -> FHIR Parameters` lifecycle.
+     */
+    requestClinicalSummary(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
+    /**
+     * Compatibility/specialized direct search over the subject bundle index.
+     * Prefer `requestClinicalSummary(...)` for the available clinical document.
      */
     searchClinicalBundle(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: ClinicalBundleSearchInput): Promise<SubmitAndPollResult>;
     /**

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

@@ -10,8 +10,8 @@ import { loadBackendIndividualControllerProfile, } from './backend-profile-runti
  * - load an individual-controller profile
  * - start individual registration/bootstrap
  * - confirm the returned order/offer
- * - search the subject clinical index
- * - request the latest IPS-oriented bundle
+ * - request the available subject clinical summary through Communication
+ * - use direct index searches only for compatibility/specialized queries
  */
 export class IndividualControllerBackendRuntime {
     constructor(profileRuntime) {
@@ -51,8 +51,15 @@ export class IndividualControllerBackendRuntime {
         return profile.sdk.confirmIndividualOrganizationOrder(input);
     }
     /**
-     * Searches the current subject clinical bundle index through the loaded
-     * individual-controller facade.
+     * Reads the authoritative subject document through the canonical
+     * `Communication -> Subject/$summary -> FHIR Parameters` lifecycle.
+     */
+    requestClinicalSummary(profile, ctx, input) {
+        return profile.sdk.requestClinicalSummary(ctx, input);
+    }
+    /**
+     * Compatibility/specialized direct search over the subject bundle index.
+     * Prefer `requestClinicalSummary(...)` for the available clinical document.
      */
     searchClinicalBundle(profile, ctx, input) {
         return profile.sdk.searchClinicalBundle(ctx, input);

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

@@ -11,7 +11,7 @@ import { type SmartTokenRequestInput } from './smart-token.js';
 import { type EmployeeDeviceActivationRequestInput, type EmployeeDeviceActivationResult } from './device-activation.js';
 import { type OrganizationLicenseOrderConfirmInput } from './organization-license-order.js';
 import { type IndividualOrganizationBootstrapInput, type IndividualOrganizationStartResult } from './individual-start.js';
-import { type CommunicationIngestionInput, type BlockchainArtifactRegistrationInput, type VitalSignBatchCommunicationFromSearchResponseInput, type CommunicationParticipantRuntimeSearchInput, type ClinicalBundleSearchInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type IndividualMemberLicenseAddInput, type IndividualMemberLicenseInvitationInput, type IndividualMemberLicenseTransitionInput, 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 ClinicalSummaryReadResult, type ClinicalSummaryRequestInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type IndividualMemberLifecycleInput, type IndividualMemberLicenseAddInput, type IndividualMemberLicenseInvitationInput, type IndividualMemberLicenseTransitionInput, 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';
@@ -402,6 +402,15 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
      * @param input Communication payload plus route/format options.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /**
+     * Reads the authoritative clinical document currently available for one
+     * subject through an auditable `Communication` request to `Subject/$summary`.
+     *
+     * Unlike `ingestCommunicationAndUpdateIndex(...)`, this method does not
+     * represent a write or projection lifecycle. It returns the GW document and
+     * a `BundleReader` for section-by-section navigation.
+     */
+    requestClinicalSummary(ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
     /**
      * Renders and submits one canonical clinical outbox job without requiring
      * BFF, portal or assistant consumers to know GW wire envelopes.

package/dist/node-runtime-client.js

@@ -12,7 +12,7 @@ import { activateEmployeeDeviceWithActivationCodeWithDeps, activateEmployeeDevic
 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, addFreeIndividualMemberLicensesWithDeps, issueIndividualMemberLicenseWithDeps, transitionIndividualMemberLicenseWithDeps, listOrganizationLicenseOffersWithDeps, listOrganizationLicenseOrdersWithDeps, listOrganizationLicensesWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, buildVitalSignBatchCommunicationFromSearchResponse, registerBlockchainArtifactAndUpdateIndexWithDeps, revokeProfessionalAccessWithDeps, searchCommunicationParticipantsWithDeps, purgeIndividualMemberWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchIndividualLicensesWithDeps, searchIndividualLicenseOffersWithDeps, searchIndividualLicenseOrdersWithDeps, searchOrganizationLicensesWithDeps, searchOrganizationLicenseOffersWithDeps, searchOrganizationLicenseOrdersWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, normalizeCommunicationPathFormatSegment, } from './resource-operations.js';
+import { createOrganizationEmployeeWithDeps, disableIndividualMemberWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, listIndividualLicenseOffersWithDeps, listIndividualLicenseOrdersWithDeps, listIndividualLicensesWithDeps, addFreeIndividualMemberLicensesWithDeps, issueIndividualMemberLicenseWithDeps, transitionIndividualMemberLicenseWithDeps, listOrganizationLicenseOffersWithDeps, listOrganizationLicenseOrdersWithDeps, listOrganizationLicensesWithDeps, grantProfessionalAccessWithDeps, ingestCommunicationAndUpdateIndexWithDeps, buildVitalSignBatchCommunicationFromSearchResponse, registerBlockchainArtifactAndUpdateIndexWithDeps, requestClinicalSummaryWithDeps, revokeProfessionalAccessWithDeps, searchCommunicationParticipantsWithDeps, purgeIndividualMemberWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, searchIndividualLicensesWithDeps, searchIndividualLicenseOffersWithDeps, searchIndividualLicenseOrdersWithDeps, searchOrganizationLicensesWithDeps, searchOrganizationLicenseOffersWithDeps, searchOrganizationLicenseOrdersWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, normalizeCommunicationPathFormatSegment, } from './resource-operations.js';
 import { submitAndPollWithMethods } from './orchestration/client-port.js';
 import { buildRuntimeHeaders, fetchWithTimeout, parseResponseBody, pollBatchResponseWithRuntimeConfig, postJsonWithRuntimeConfig, postRenderedWithRuntimeConfig, } from './runtime-transport.js';
 import { activateOrganizationInGatewayFromIcaProofWithDeps, submitLegalOrganizationIssueWithDeps, submitLegalOrganizationVerificationTransactionWithDeps, submitOrganizationDidBindingWithDeps, } from './runtime-host-submission.js';
@@ -743,6 +743,19 @@ export class HttpRuntimeClient {
             submitAndPoll: this.submitAndPoll.bind(this),
         });
     }
+    /**
+     * Reads the authoritative clinical document currently available for one
+     * subject through an auditable `Communication` request to `Subject/$summary`.
+     *
+     * Unlike `ingestCommunicationAndUpdateIndex(...)`, this method does not
+     * represent a write or projection lifecycle. It returns the GW document and
+     * a `BundleReader` for section-by-section navigation.
+     */
+    async requestClinicalSummary(ctx, input) {
+        return requestClinicalSummaryWithDeps(ctx, input, {
+            submitSummaryCommunication: this.submitCommunicationOutboxJobAndPoll.bind(this),
+        });
+    }
     /**
      * Renders and submits one canonical clinical outbox job without requiring
      * BFF, portal or assistant consumers to know GW wire envelopes.

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, BlockchainArtifactRegistrationInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, VitalSignBatchCommunicationFromSearchResponseInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualMemberLicenseAddInput, IndividualMemberLicenseInvitationInput, IndividualMemberLicenseTransitionInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, OrganizationEmployeeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { CommunicationIngestionInput, BlockchainArtifactRegistrationInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, VitalSignBatchCommunicationFromSearchResponseInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualMemberLicenseAddInput, IndividualMemberLicenseInvitationInput, IndividualMemberLicenseTransitionInput, IpsOrFhirImportInput, OrganizationEmployeeCreationInput, OrganizationEmployeeLifecycleInput, OrganizationEmployeeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
 /**
  * Shared node-runtime activation input.
  *
@@ -89,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>;
+    requestClinicalSummary?: (ctx: RouteContext, input: ClinicalSummaryRequestInput) => Promise<ClinicalSummaryReadResult>;
     registerBlockchainArtifactAndUpdateIndex?: (ctx: RouteContext, input: BlockchainArtifactRegistrationInput) => Promise<SubmitAndPollResult>;
     searchCommunicationParticipants?: (ctx: RouteContext, input: CommunicationParticipantRuntimeSearchInput) => Promise<SubmitAndPollResult>;
     grantProfessionalAccess?: (ctx: RouteContext, input: GrantProfessionalAccessInput) => Promise<GrantProfessionalAccessResult>;

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

@@ -7,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 { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualMemberLicenseAddInput, IndividualMemberLicenseInvitationInput, IndividualMemberLicenseTransitionInput, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualMemberLicenseAddInput, IndividualMemberLicenseInvitationInput, IndividualMemberLicenseTransitionInput, 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`.
@@ -90,6 +90,14 @@ export declare class IndividualControllerSdk {
      * Ingests a FHIR `Communication` and waits for indexing.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<SubmitAndPollResult>;
+    /**
+     * Reads the subject's available clinical document through
+     * `Communication -> Subject/$summary -> FHIR Parameters`.
+     *
+     * The returned `BundleReader` navigates the authoritative GW document by
+     * section. This method never ingests resources or updates the index.
+     */
+    requestClinicalSummary(ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
     /**
      * Registers one FHIR resource or raw artifact on blockchain before it is
      * attached to a subject communication.

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

@@ -128,6 +128,17 @@ export class IndividualControllerSdk {
         assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualIngestCommunication, ActorKinds.IndividualController, 'ingestCommunicationAndUpdateIndex');
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /**
+     * Reads the subject's available clinical document through
+     * `Communication -> Subject/$summary -> FHIR Parameters`.
+     *
+     * The returned `BundleReader` navigates the authoritative GW document by
+     * section. This method never ingests resources or updates the index.
+     */
+    requestClinicalSummary(ctx, input) {
+        assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualReadClinicalSummary, ActorKinds.IndividualController, 'requestClinicalSummary');
+        return requireClientMethod(this.client, 'requestClinicalSummary')(ctx, input);
+    }
     /**
      * Registers one FHIR resource or raw artifact on blockchain before it is
      * attached to a subject communication.

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

@@ -2,7 +2,7 @@ import { type IndividualMemberCredentialInput, type IndividualMemberVpPayloadInp
 import { type NodeRuntimeClient } from './client-port.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
 import type { RouteContext } from '../individual-onboarding.js';
-import type { ClinicalBundleSearchInput, CommunicationIngestionInput, RelatedPersonUpsertInput } from '../resource-operations.js';
+import type { ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, CommunicationIngestionInput, RelatedPersonUpsertInput } from '../resource-operations.js';
 export declare class IndividualMemberSdk {
     private readonly client;
     constructor(client: NodeRuntimeClient);
@@ -23,6 +23,8 @@ export declare class IndividualMemberSdk {
      * SMART token and accepted RelatedPerson/Consent relationship.
      */
     ingestCommunicationAndUpdateIndex(ctx: RouteContext, input: CommunicationIngestionInput): Promise<import("gdc-sdk-core-ts/polling-model.js").SubmitAndPollResult>;
+    /** Reads the member-authorized `$summary` document without mutating the subject index. */
+    requestClinicalSummary(ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
     /** Reads subject-scoped clinical documents permitted to this member. */
     searchClinicalBundle(ctx: RouteContext, input: ClinicalBundleSearchInput): Promise<import("gdc-sdk-core-ts/polling-model.js").SubmitAndPollResult>;
     /** Reads the latest permitted IPS document for the selected subject. */

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

@@ -28,6 +28,10 @@ export class IndividualMemberSdk {
     ingestCommunicationAndUpdateIndex(ctx, input) {
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /** Reads the member-authorized `$summary` document without mutating the subject index. */
+    requestClinicalSummary(ctx, input) {
+        return requireClientMethod(this.client, 'requestClinicalSummary')(ctx, input);
+    }
     /** Reads subject-scoped clinical documents permitted to this member. */
     searchClinicalBundle(ctx, input) {
         return requireClientMethod(this.client, 'searchClinicalBundle')(ctx, input);

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 { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, 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>;
+    /** Reads the current subject through Communication `$summary`; it performs no ingestion. */
+    requestClinicalSummary(ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
     /** 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. */

package/dist/orchestration/personal-sdk.js

@@ -20,6 +20,10 @@ export class PersonalSdk {
     ingestCommunicationAndUpdateIndex(ctx, input) {
         return requireClientMethod(this.client, 'ingestCommunicationAndUpdateIndex')(ctx, input);
     }
+    /** Reads the current subject through Communication `$summary`; it performs no ingestion. */
+    requestClinicalSummary(ctx, input) {
+        return requireClientMethod(this.client, 'requestClinicalSummary')(ctx, input);
+    }
     /** Registers one FHIR resource or raw artifact on blockchain before communication. */
     registerBlockchainArtifactAndUpdateIndex(ctx, input) {
         return requireClientMethod(this.client, 'registerBlockchainArtifactAndUpdateIndex')(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 { BlockchainArtifactRegistrationInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, VitalSignBatchCommunicationFromSearchResponseInput } from '../resource-operations.js';
+import type { BlockchainArtifactRegistrationInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, ClinicalBundleSearchInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, 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
@@ -59,6 +59,8 @@ export declare class ProfessionalSdk {
      * session and tenant route context.
      */
     searchClinicalBundle(ctx: RouteContext, input: ClinicalBundleSearchInput): Promise<SubmitAndPollResult>;
+    /** Reads the consent-authorized clinical `$summary` document without ingestion. */
+    requestClinicalSummary(ctx: RouteContext, input: ClinicalSummaryRequestInput): Promise<ClinicalSummaryReadResult>;
     /**
      * Reads the latest IPS-oriented document projection available to the
      * professional actor for one subject.

package/dist/orchestration/professional-sdk.js

@@ -67,6 +67,10 @@ export class ProfessionalSdk {
     searchClinicalBundle(ctx, input) {
         return requireClientMethod(this.client, 'searchClinicalBundle')(ctx, input);
     }
+    /** Reads the consent-authorized clinical `$summary` document without ingestion. */
+    requestClinicalSummary(ctx, input) {
+        return requireClientMethod(this.client, 'requestClinicalSummary')(ctx, input);
+    }
     /**
      * Reads the latest IPS-oriented document projection available to the
      * professional actor for one subject.

package/dist/resource-operations.d.ts

@@ -1,10 +1,12 @@
 import type { DeviceAppType } from 'gdc-common-utils-ts/constants/device';
+import { type ClinicalSummaryReadResult, type ClinicalSummaryRequestInput } from 'gdc-sdk-core-ts';
 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, CommMsgExtendedCommunicationOutboxJob, CommunicationOutboxJob, CommunicationInput, DateRange, EmployeeSearchValue, IndividualOrganizationLifecycleInput, TransportProfile } 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 { ClinicalSummaryReadResult, ClinicalSummaryRequestInput, } from 'gdc-sdk-core-ts';
 export type OrganizationEmployeeCreationInput = {
     /**
      * Canonical employee/person claims sent to CORE GW.
@@ -675,6 +677,19 @@ export declare function searchCommunicationParticipantsWithDeps(routeCtx: RouteC
         intervalMs?: number;
     }) => Promise<SubmitAndPollResult>;
 }): Promise<SubmitAndPollResult>;
+/**
+ * Requests the subject's available clinical document through the canonical
+ * auditable read lifecycle:
+ *
+ * `Communication -> Subject/$summary -> FHIR Parameters -> Bundle document`.
+ *
+ * The dependency name intentionally says `submit`, not `ingest`: GW receives a
+ * Communication transport record, but the business operation is a read and
+ * must not be exposed to applications as index ingestion.
+ */
+export declare function requestClinicalSummaryWithDeps(routeCtx: RouteContext, input: ClinicalSummaryRequestInput, deps: {
+    submitSummaryCommunication: (ctx: RouteContext, input: CommunicationIngestionInput) => Promise<SubmitAndPollResult>;
+}): Promise<ClinicalSummaryReadResult>;
 export declare function searchClinicalBundleWithDeps(routeCtx: RouteContext, input: ClinicalBundleSearchInput, deps: {
     bundleSearchPath: (ctx: RouteContext) => string;
     bundleSearchPollPath: (ctx: RouteContext) => string;
@@ -757,4 +772,3 @@ export declare function generateDigitalTwinFromSubjectDataWithDeps(routeCtx: Rou
     }) => Promise<SubmitAndPollResult>;
 }): Promise<SubmitAndPollResult>;
 export declare function normalizeCommunicationPathFormatSegment(raw?: string): string;
-export {};

package/dist/resource-operations.js

@@ -3,7 +3,7 @@ import { HealthcareBasicSections, ResourceTypesFhirR4 } from 'gdc-common-utils-t
 import { Format } from 'gdc-common-utils-ts/constants/Schemas';
 import { RelatedPersonClaim } from 'gdc-common-utils-ts/models/interoperable-claims/related-person-claims';
 import { buildCommunicationParticipantSearchBundle, buildBlockchainArtifactDocumentReference, BundleQuery, createInteroperableResourceOperationEditor, IndividualOrganizationLifecycleEditor, LicenseOfferSearchEditor, LicenseOrderSearchEditor, InteroperableLifecycleStatuses, LicenseListSearchEditor, buildLicenseIssueEntry, buildLicensePurchaseEntry, } from 'gdc-common-utils-ts';
-import { addFhirResourceToCommunication, createCommunicationResource, } from 'gdc-sdk-core-ts';
+import { addFhirResourceToCommunication, createCommunicationResource, buildClinicalSummaryCommunicationJob, readClinicalSummaryOperationResult, } 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) {
@@ -390,6 +390,26 @@ export async function searchCommunicationParticipantsWithDeps(routeCtx, input, d
     };
     return deps.submitAndPoll(deps.communicationSearchPath(routeCtx), deps.communicationSearchPollPath(routeCtx), payload, input.pollOptions);
 }
+/**
+ * Requests the subject's available clinical document through the canonical
+ * auditable read lifecycle:
+ *
+ * `Communication -> Subject/$summary -> FHIR Parameters -> Bundle document`.
+ *
+ * The dependency name intentionally says `submit`, not `ingest`: GW receives a
+ * Communication transport record, but the business operation is a read and
+ * must not be exposed to applications as index ingestion.
+ */
+export async function requestClinicalSummaryWithDeps(routeCtx, input, deps) {
+    const communicationJob = buildClinicalSummaryCommunicationJob(input);
+    const operation = await deps.submitSummaryCommunication(routeCtx, {
+        communicationJob,
+        clinicalFormat: input.clinicalFormat || 'api',
+        transportProfile: input.transportProfile,
+        pollOptions: input.pollOptions,
+    });
+    return readClinicalSummaryOperationResult(operation);
+}
 export async function searchClinicalBundleWithDeps(routeCtx, input, deps) {
     const query = buildBundleSearchQuery(input);
     const payload = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -13,6 +13,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "type-check": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run type-check && npm test",
     "local:close": "PORTS=3000 bash ./scripts/local-close.sh",
     "docker:close": "PORTS=8000 bash ./scripts/local-close.sh",
     "test": "npm run build && node --test tests/*.test.mjs",