gdc-sdk-node-ts 2.9.1 → 2.9.3

package/README.md

@@ -69,46 +69,50 @@ If you are integrating this package for the first time, open these in order:
 2. [docs/101-SDK_END_TO_END.md](./docs/101-SDK_END_TO_END.md)
   Ordered onboarding guide with end-to-end journeys, copy/paste snippets, and
   the recommended reading path for new backend integrators.
-3. [docs/101-PROFESSIONAL-CONSENT-SMART.md](./docs/101-PROFESSIONAL-CONSENT-SMART.md)
+3. [docs/101-HIGH_LEVEL_CLINICAL_PROFILE_WRITES.md](./docs/101-HIGH_LEVEL_CLINICAL_PROFILE_WRITES.md)
+   Focused subset of the end-to-end guide: load a professional or individual
+   member/controller profile, create or import clinical data in the selected
+   index provider, and verify it through an authoritative summary readback.
+4. [docs/101-PROFESSIONAL-CONSENT-SMART.md](./docs/101-PROFESSIONAL-CONSENT-SMART.md)
    Canonical professional DID, consent, VP and SMART flow without literal
    sections or caller-built audience URLs.
-4. [docs/101-AUTHORIZED_SUBJECT_DIRECTORY.md](./docs/101-AUTHORIZED_SUBJECT_DIRECTORY.md)
+5. [docs/101-AUTHORIZED_SUBJECT_DIRECTORY.md](./docs/101-AUTHORIZED_SUBJECT_DIRECTORY.md)
    Signed OpenID account discovery of already-authorized subjects without
    treating the account token as VP, SMART or wallet proof.
-5. [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
+6. [docs/101-SDK_INTEGRATION.md](./docs/101-SDK_INTEGRATION.md)
    Real backend setup plus the public runtime entrypoints:
    `HostOnboardingSdk`, `OrganizationControllerSdk`,
    `IndividualControllerSdk`, `ProfessionalSdk`, route-context usage, and the
    canonical `ProfileRuntime -> loadProfile(...) -> workspace/session -> actor facade -> submit/poll` shape.
-6. [tests/101-live-full-cycle-bff-runtime.e2e.test.mjs](./tests/101-live-full-cycle-bff-runtime.e2e.test.mjs)
+7. [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,
    consent grant, professional SMART token, clinical read, and final cleanup.
-7. [docs/101-LIVE_GW_LOCAL.md](./docs/101-LIVE_GW_LOCAL.md)
+8. [docs/101-LIVE_GW_LOCAL.md](./docs/101-LIVE_GW_LOCAL.md)
    Exact TTY/local/Docker commands for running the SDK against a real local GW
    CORE, including tenant bootstrap and employee-seat setup.
-8. [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
+9. [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
    Node/BFF dataspace discovery, hosting-operator resolution, provider
    resolution, and the correct integration boundary for fallback and cache.
-9. [gdc-sdk-core-ts/docs/101-SDK_FLOWS.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_FLOWS.md)
+10. [gdc-sdk-core-ts/docs/101-SDK_FLOWS.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_FLOWS.md)
    Actor split and business-flow map across organization, individual,
    permissions, invitation, import, and SMART flows.
-10. [gwtemplate-node-ts/docs/PORTAL_API_TO_GW_CORE.md](https://github.com/Global-DataCare/gwtemplate-node-ts/blob/main/docs/PORTAL_API_TO_GW_CORE.md)
+11. [gwtemplate-node-ts/docs/PORTAL_API_TO_GW_CORE.md](https://github.com/Global-DataCare/gwtemplate-node-ts/blob/main/docs/PORTAL_API_TO_GW_CORE.md)
    Canonical portal/BFF functional map over GW CORE, including the domain
    split between `employees`, `related persons`, `members`, and `consents`.
-11. [gdc-common-utils-ts/src/examples/](https://github.com/Global-DataCare/gdc-common-utils-ts/tree/main/src/examples)
+12. [gdc-common-utils-ts/src/examples/](https://github.com/Global-DataCare/gdc-common-utils-ts/tree/main/src/examples)
    Shared payload values used by the docs and tests.
-12. [gdc-common-utils-ts/docs/101-LIFECYCLE.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-LIFECYCLE.md)
+13. [gdc-common-utils-ts/docs/101-LIFECYCLE.md](https://github.com/Global-DataCare/gdc-common-utils-ts/blob/main/docs/101-LIFECYCLE.md)
    Canonical `enable/disable/delete` semantics and copy/paste placeholders.
-13. [tests/101-backend-profile-runtime.test.mjs](./tests/101-backend-profile-runtime.test.mjs)
+14. [tests/101-backend-profile-runtime.test.mjs](./tests/101-backend-profile-runtime.test.mjs)
    Technical runtime slice for profile/device/session orchestration internals.
    Read this after the public actor SDK guides, not before them.
-14. [tests/101-individual-controller-backend-runtime.test.mjs](./tests/101-individual-controller-backend-runtime.test.mjs)
+15. [tests/101-individual-controller-backend-runtime.test.mjs](./tests/101-individual-controller-backend-runtime.test.mjs)
    Technical wrapper slice around the generic profile runtime. This is not the
    main onboarding path for new integrators.
-15. [docs/V2_INDIVIDUAL_REGISTRATION_RECONCILIATION.md](./docs/V2_INDIVIDUAL_REGISTRATION_RECONCILIATION.md)
+16. [docs/V2_INDIVIDUAL_REGISTRATION_RECONCILIATION.md](./docs/V2_INDIVIDUAL_REGISTRATION_RECONCILIATION.md)
    Historical reconciliation note for the current CORE registration baseline.
-16. [docs/NEXT_STEPS.md](./docs/NEXT_STEPS.md)
+17. [docs/NEXT_STEPS.md](./docs/NEXT_STEPS.md)
    Follow-up scope after GW CORE live validation, including the future user job
    manager boundary.
 
@@ -674,7 +678,7 @@ modules below.
   - function: `confirmLegalOrganizationOrderWithDeps(...)`
 - [`src/individual-start.ts`](src/individual-start.ts)
   - types: `IndividualOrganizationBootstrapInput`, `OfferPreview`, `IndividualOrganizationStartResult`
-  - function: `startIndividualOrganizationWithDeps(...)`
+  - function: `registerIndividualOrganizationWithDeps(...)`
 - [`src/individual-onboarding.ts`](src/individual-onboarding.ts)
   - types: `RouteContext`, `IndividualOrganizationConfirmOrderInput`
   - function: `confirmIndividualOrganizationOrderWithDeps(...)`

package/dist/family-organization-registration.js

@@ -1,5 +1,5 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-import { startIndividualOrganizationWithDeps, } from './individual-start.js';
+import { registerIndividualOrganizationWithDeps, } from './individual-start.js';
 import { searchFamilyOrganizationWithDeps, } from './family-organization-search.js';
 import { extractOfferIdFromResponseBody, extractOfferPreviewFromResponseBody } from './order-offer-summary.js';
 /**
@@ -24,7 +24,7 @@ export async function ensureFamilyOrganizationRegistrationWithDeps(deps) {
             summary,
         };
     }
-    const started = await startIndividualOrganizationWithDeps({
+    const started = await registerIndividualOrganizationWithDeps({
         input: {
             serviceProviderDid: deps.input.serviceProviderDid,
             tenantId: deps.input.tenantId,

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

@@ -1,7 +1,7 @@
 import type { SubmitAndPollResult } from 'gdc-sdk-core-ts';
 import type { FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
 import type { IndividualOrganizationConfirmOrderInput, IndividualOrganizationOrderResult, RouteContext } from './individual-onboarding.js';
-import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from './individual-start.js';
+import type { IndividualOrganizationRegistrationInput, IndividualOrganizationRegistrationResult } 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, ClinicalSectionUpdateInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, ClinicalSummaryUpdateInput, CommunicationIngestionInput, IpsOrFhirImportInput } from './resource-operations.js';
@@ -15,7 +15,7 @@ import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
  * consumers need first:
  *
  * - load an individual-controller profile
- * - start individual registration/bootstrap
+ * - register an individual organization/subject index
  * - confirm the returned order/offer
  * - request the available subject clinical summary through Communication
  * - use direct index searches only for compatibility/specialized queries
@@ -29,9 +29,12 @@ export declare class IndividualControllerBackendRuntime {
      */
     loadProfile(input: ProfileLoadRequest): Promise<BackendIndividualControllerProfile>;
     /**
-     * Starts the current CORE individual/family bootstrap flow.
+     * Registers the personal organization/subject index and returns its Offer.
+     * This does not enroll a wallet or a DCR device.
      */
-    startIndividualOrganization(profile: BackendIndividualControllerProfile, input: IndividualOrganizationBootstrapInput): Promise<IndividualOrganizationStartResult>;
+    registerIndividualOrganization(profile: BackendIndividualControllerProfile, input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
+    /** @deprecated Use `registerIndividualOrganization`. */
+    startIndividualOrganization(profile: BackendIndividualControllerProfile, input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
     /**
      * Searches one existing family/individual registration before deciding
      * whether the backend should create or resume it.
@@ -43,7 +46,8 @@ export declare class IndividualControllerBackendRuntime {
      */
     ensureFamilyOrganizationRegistration(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: EnsureFamilyOrganizationRegistrationInput): Promise<EnsureFamilyOrganizationRegistrationResult>;
     /**
-     * Confirms the order returned by the individual bootstrap flow.
+     * Confirms the Offer returned by the individual registration and returns the
+     * opaque controller activation code for managed profile enrollment.
      */
     confirmIndividualOrganizationOrder(profile: BackendIndividualControllerProfile, input: IndividualOrganizationConfirmOrderInput): Promise<IndividualOrganizationOrderResult>;
     /**

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

@@ -8,7 +8,7 @@ import { loadBackendIndividualControllerProfile, } from './backend-profile-runti
  * consumers need first:
  *
  * - load an individual-controller profile
- * - start individual registration/bootstrap
+ * - register an individual organization/subject index
  * - confirm the returned order/offer
  * - request the available subject clinical summary through Communication
  * - use direct index searches only for compatibility/specialized queries
@@ -25,10 +25,15 @@ export class IndividualControllerBackendRuntime {
         return loadBackendIndividualControllerProfile(this.profileRuntime, input);
     }
     /**
-     * Starts the current CORE individual/family bootstrap flow.
+     * Registers the personal organization/subject index and returns its Offer.
+     * This does not enroll a wallet or a DCR device.
      */
+    registerIndividualOrganization(profile, input) {
+        return profile.sdk.registerIndividualOrganization(input);
+    }
+    /** @deprecated Use `registerIndividualOrganization`. */
     startIndividualOrganization(profile, input) {
-        return profile.sdk.startIndividualOrganization(input);
+        return this.registerIndividualOrganization(profile, input);
     }
     /**
      * Searches one existing family/individual registration before deciding
@@ -45,7 +50,8 @@ export class IndividualControllerBackendRuntime {
         return profile.sdk.ensureFamilyOrganizationRegistration(ctx, input);
     }
     /**
-     * Confirms the order returned by the individual bootstrap flow.
+     * Confirms the Offer returned by the individual registration and returns the
+     * opaque controller activation code for managed profile enrollment.
      */
     confirmIndividualOrganizationOrder(profile, input) {
         return profile.sdk.confirmIndividualOrganizationOrder(input);

package/dist/individual-start.d.ts

@@ -4,7 +4,7 @@ import type { FamilyRegistrationStatus } from 'gdc-common-utils-ts/utils/family-
 import type { PollOptions, SubmitAndPollResult } from './orchestration/client-port.js';
 import type { RouteContext } from './individual-onboarding.js';
 import type { OfferPreview } from './order-offer-summary.js';
-export type IndividualOrganizationBootstrapInput = {
+export type IndividualOrganizationRegistrationInput = {
     /**
      * Preferred route identifier for the selected personal indexing service provider.
      *
@@ -58,7 +58,9 @@ export type IndividualOrganizationBootstrapInput = {
     timeoutSeconds?: number;
     intervalSeconds?: number;
 };
-export type IndividualOrganizationStartResult = {
+/** @deprecated Use `IndividualOrganizationRegistrationInput`. */
+export type IndividualOrganizationBootstrapInput = IndividualOrganizationRegistrationInput;
+export type IndividualOrganizationRegistrationResult = {
     registration: SubmitAndPollResult;
     offerId: string;
     offerPreview: OfferPreview;
@@ -76,6 +78,8 @@ export type IndividualOrganizationStartResult = {
      */
     identity?: IndividualOrganizationBootstrapIdentity;
 };
+/** @deprecated Use `IndividualOrganizationRegistrationResult`. */
+export type IndividualOrganizationStartResult = IndividualOrganizationRegistrationResult;
 export type IndividualOrganizationBootstrapIdentity = {
     /** Technical UUID returned as `Bundle.data[0].resource.id`. */
     resourceId: string;
@@ -88,8 +92,8 @@ export type IndividualOrganizationBootstrapIdentity = {
     /** Canonical child DID built beneath the exact provider DID returned by GW. */
     subjectDid: string;
 };
-type StartIndividualOrganizationDeps = {
-    input: IndividualOrganizationBootstrapInput;
+type RegisterIndividualOrganizationDeps = {
+    input: IndividualOrganizationRegistrationInput;
     routeCtx: RouteContext;
     defaultTimeoutMs?: number;
     defaultIntervalMs?: number;
@@ -102,7 +106,14 @@ type StartIndividualOrganizationDeps = {
     getOfferIdFromResponse: (result: SubmitAndPollResult) => string | undefined;
     getOfferPreviewFromResponse: (result: SubmitAndPollResult) => OfferPreview;
 };
-export declare function startIndividualOrganizationWithDeps(deps: StartIndividualOrganizationDeps): Promise<IndividualOrganizationStartResult>;
+/**
+ * Registers the hosted personal organization/subject index and returns its
+ * commercial Offer. This phase does not create a managed wallet, exchange an
+ * activation code, register DCR keys, or open a profile session.
+ */
+export declare function registerIndividualOrganizationWithDeps(deps: RegisterIndividualOrganizationDeps): Promise<IndividualOrganizationRegistrationResult>;
+/** @deprecated Use `registerIndividualOrganizationWithDeps`. */
+export declare function startIndividualOrganizationWithDeps(deps: RegisterIndividualOrganizationDeps): Promise<IndividualOrganizationRegistrationResult>;
 /**
  * Projects the reusable subject identity from an individual bootstrap receipt.
  *

package/dist/individual-start.js

@@ -4,7 +4,12 @@ import { buildIndividualDidWeb, buildSecureIdValueIndividual, extractPrimaryClai
 export { buildIndividualMemberDidWebFromPrivateIdentifiers } from 'gdc-common-utils-ts';
 import { GwCoreLifecycleRequestType } from './constants/lifecycle.js';
 import { resolvePollOptionsFromSeconds } from './poll-options.js';
-export async function startIndividualOrganizationWithDeps(deps) {
+/**
+ * Registers the hosted personal organization/subject index and returns its
+ * commercial Offer. This phase does not create a managed wallet, exchange an
+ * activation code, register DCR keys, or open a profile session.
+ */
+export async function registerIndividualOrganizationWithDeps(deps) {
     /**
      * Important semantic split:
      *
@@ -19,12 +24,12 @@ export async function startIndividualOrganizationWithDeps(deps) {
      */
     const alternateName = String(deps.input.alternateName || '').trim();
     if (!alternateName) {
-        throw new Error('bootstrapIndividualOrganization requires alternateName.');
+        throw new Error('registerIndividualOrganization requires alternateName.');
     }
     const controllerEmail = String(deps.input.controllerEmail || '').trim();
     const controllerTelephone = String(deps.input.controllerTelephone || '').trim();
     if (!controllerEmail && !controllerTelephone) {
-        throw new Error('bootstrapIndividualOrganization requires controllerEmail, or controllerTelephone only for compatibility/extension flows.');
+        throw new Error('registerIndividualOrganization requires controllerEmail, or controllerTelephone only for compatibility/extension flows.');
     }
     const controllerRole = String(deps.input.controllerRole || 'RESPRSN').trim();
     const claims = {
@@ -64,7 +69,7 @@ export async function startIndividualOrganizationWithDeps(deps) {
         intervalMs: deps.defaultIntervalMs,
     });
     const registration = await deps.submitAndPoll(deps.individualFamilyOrganizationBatchPath(deps.routeCtx), deps.individualFamilyOrganizationPollPath(deps.routeCtx), registrationPayload, pollOptions);
-    deps.assertFirstDidcommEntrySuccess?.(registration, 'startIndividualOrganization.registration');
+    deps.assertFirstDidcommEntrySuccess?.(registration, 'registerIndividualOrganization.registration');
     /**
      * Commercial contract for this SDK path:
      * - this helper targets the family/individual commercial bootstrap flow
@@ -76,7 +81,7 @@ export async function startIndividualOrganizationWithDeps(deps) {
      */
     const offerId = deps.getOfferIdFromResponse(registration);
     if (!offerId) {
-        throw new Error('startIndividualOrganization failed: missing offerId in registration response.');
+        throw new Error('registerIndividualOrganization failed: missing offerId in registration response.');
     }
     const registrationSummary = readFamilyOrganizationSummaryFromResponseBody(registration.poll.body);
     return {
@@ -88,6 +93,10 @@ export async function startIndividualOrganizationWithDeps(deps) {
         identity: readIndividualOrganizationBootstrapIdentity(registration.poll.body),
     };
 }
+/** @deprecated Use `registerIndividualOrganizationWithDeps`. */
+export async function startIndividualOrganizationWithDeps(deps) {
+    return registerIndividualOrganizationWithDeps(deps);
+}
 /**
  * Projects the reusable subject identity from an individual bootstrap receipt.
  *

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

@@ -11,7 +11,7 @@ import { type FamilyOrganizationSearchInput } from './family-organization-search
 import { type SmartTokenRequestInput } from './smart-token.js';
 import { type EmployeeDeviceActivationRequestInput, type EmployeeDeviceActivationResult, type EmployeeDeviceOtpRecoveryInput, type EmployeeDeviceOtpRecoveryResult, type EmployeeDeviceRevocationInput } from './device-activation.js';
 import { type OrganizationLicenseOrderConfirmInput } from './organization-license-order.js';
-import { type IndividualOrganizationBootstrapInput, type IndividualOrganizationStartResult } from './individual-start.js';
+import { type IndividualOrganizationRegistrationInput, type IndividualOrganizationRegistrationResult } from './individual-start.js';
 import { type CommunicationIngestionInput, type BlockchainArtifactRegistrationInput, type VitalSignBatchCommunicationFromSearchResponseInput, type CommunicationParticipantRuntimeSearchInput, type ClinicalBundleSearchInput, type ClinicalSectionUpdateInput, type ClinicalSummaryReadResult, type ClinicalSummaryRequestInput, type ClinicalSummaryUpdateInput, type GrantProfessionalAccessInput, type GrantProfessionalAccessResult, type DigitalTwinSecondaryUseConsentInput, type DigitalTwinSecondaryUseConsentResult, type DigitalTwinSubjectLinkPurgeInput, type DigitalTwinSubjectLinkPurgeResult, type SubjectConsentSearchInput, type IndividualMemberLifecycleInput, type IndividualMemberLicenseAddInput, type IndividualMemberLicenseInvitationInput, type IndividualMemberLicenseTransitionInput, type LicenseListRuntimeSearchInput, type LicenseOfferRuntimeSearchInput, type LicenseOrderRuntimeSearchInput, type OrganizationEmployeeCreationInput, type OrganizationEmployeeLicenseAddInput, type OrganizationEmployeeLicenseOfferInput, type OrganizationEmployeeLicenseInvitationInput, type OrganizationEmployeeLifecycleInput, type OrganizationEmployeeSearchInput, type ProfessionalAccessRequestInput, type ProfessionalAccessRequestResult, type RevokeProfessionalAccessInput, type RevokeProfessionalAccessResult, type RelatedPersonUpsertInput } from './resource-operations.js';
 import type { LegalOrganizationOrderInput } from './host-onboarding.js';
 import type { SmartTokenExchangeResult } from './smart-token.js';
@@ -349,18 +349,21 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
      */
     confirmOrganizationLicenseOrder(ctx: RouteContext, input: OrganizationLicenseOrderConfirmInput, pollOptions?: PollOptions): Promise<SubmitAndPollResult>;
     /**
-     * Starts the onboarding flow for an individual-oriented tenant or index.
+     * Registers an individual-oriented personal organization/subject index.
      *
      * Commercial contract:
      * - this SDK method targets the family/individual commercial bootstrap flow
      * - the registration poll response is expected to return one Offer id
      * - callers should then confirm it through
      *   `confirmIndividualOrganizationOrder(...)`
+     * - this phase does not create a wallet, perform DCR, or open a profile
      *
      * This is distinct from embedded legacy individual registration helpers in
      * GW CORE that may persist an individual record without minting an Offer.
      */
-    startIndividualOrganization(input: IndividualOrganizationBootstrapInput): Promise<IndividualOrganizationStartResult>;
+    registerIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
+    /** @deprecated Use `registerIndividualOrganization`. */
+    startIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
     /**
      * Searches one existing family/individual registration by controller phone +
      * usualname, with optional birth-date disambiguation.
@@ -380,10 +383,14 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     ensureFamilyOrganizationRegistration(ctx: RouteContext, input: EnsureFamilyOrganizationRegistrationInput): Promise<Readonly<{
         status: "already_exists" | "resume_required" | "new_created";
         summary?: import("gdc-common-utils-ts").FamilyOrganizationSummary;
-        started?: IndividualOrganizationStartResult;
+        started?: import("./individual-start.js").IndividualOrganizationStartResult;
     }>>;
     /**
-     * Confirms the order returned by `startIndividualOrganization(...)`.
+     * Confirms the Offer returned by `registerIndividualOrganization(...)`, waits
+     * for the terminal Order, and exposes its controller `activationCode`.
+     * The caller passes that opaque value directly to
+     * `ServerProfileSessionManager.enroll(...)`; it does not traverse claims or
+     * call a separate licence reader.
      */
     confirmIndividualOrganizationOrder(input: IndividualOrganizationConfirmOrderInput): Promise<IndividualOrganizationOrderResult>;
     /**

package/dist/node-runtime-client.js

@@ -9,7 +9,7 @@ import { requestSmartTokenWithDeps } from './smart-token.js';
 import { activateEmployeeDeviceWithActivationCodeWithDeps, activateEmployeeDeviceWithActivationRequestWithDeps, recoverEmployeeDeviceWithOtpWithDeps, revokeEmployeeDeviceWithDeps, } from './device-activation.js';
 import { extractOfferIdFromResponseBody, extractOfferPreviewFromResponseBody, } from './order-offer-summary.js';
 import { confirmOrganizationLicenseOrderWithDeps } from './organization-license-order.js';
-import { startIndividualOrganizationWithDeps } from './individual-start.js';
+import { registerIndividualOrganizationWithDeps } from './individual-start.js';
 import { createOrganizationEmployeeWithDeps, issueOrganizationEmployeeLicenseWithDeps, disableIndividualMemberWithDeps, disableIndividualOrganizationWithDeps, disableOrganizationEmployeeWithDeps, listIndividualLicenseOffersWithDeps, listIndividualLicenseOrdersWithDeps, listIndividualLicensesWithDeps, addFreeIndividualMemberLicensesWithDeps, issueIndividualMemberLicenseWithDeps, transitionIndividualMemberLicenseWithDeps, listOrganizationLicenseOffersWithDeps, listOrganizationLicenseOrdersWithDeps, listOrganizationLicensesWithDeps, grantProfessionalAccessWithDeps, setDigitalTwinSecondaryUseConsentWithDeps, purgeDigitalTwinSubjectLinkWithDeps, searchSubjectConsentsWithDeps, buildClinicalSectionUpdateIngestion, buildClinicalSummaryUpdateIngestion, ingestCommunicationAndUpdateIndexWithDeps, requestProfessionalAccessWithDeps, buildVitalSignBatchCommunicationFromSearchResponse, registerBlockchainArtifactAndUpdateIndexWithDeps, requestClinicalSummaryWithDeps, revokeProfessionalAccessWithDeps, searchCommunicationParticipantsWithDeps, purgeIndividualMemberWithDeps, purgeIndividualOrganizationWithDeps, purgeOrganizationEmployeeWithDeps, prepareEmployeeLifecycleMessageForTransport, searchIndividualLicensesWithDeps, searchIndividualLicenseOffersWithDeps, searchIndividualLicenseOrdersWithDeps, searchOrganizationLicensesWithDeps, searchOrganizationLicenseOffersWithDeps, searchOrganizationLicenseOrdersWithDeps, searchOrganizationEmployeesWithDeps, searchClinicalBundleWithDeps, searchLatestIpsWithDeps, upsertRelatedPersonAndPollWithDeps, normalizeCommunicationPathFormatSegment, addFreeOrganizationEmployeeLicensesWithDeps, requestOrganizationEmployeeLicenseOfferWithDeps, } from './resource-operations.js';
 import { listOrganizationEmployeeLifecycleWithDeps, provisionOrganizationEmployeeWithDeps, } from './organization-employee-lifecycle.js';
 import { buildRuntimeHeaders, fetchWithTimeout, parseResponseBody, postRenderedWithRuntimeConfig, } from './runtime-transport.js';
@@ -620,20 +620,21 @@ export class HttpRuntimeClient {
         });
     }
     /**
-     * Starts the onboarding flow for an individual-oriented tenant or index.
+     * Registers an individual-oriented personal organization/subject index.
      *
      * Commercial contract:
      * - this SDK method targets the family/individual commercial bootstrap flow
      * - the registration poll response is expected to return one Offer id
      * - callers should then confirm it through
      *   `confirmIndividualOrganizationOrder(...)`
+     * - this phase does not create a wallet, perform DCR, or open a profile
      *
      * This is distinct from embedded legacy individual registration helpers in
      * GW CORE that may persist an individual record without minting an Offer.
      */
-    async startIndividualOrganization(input) {
+    async registerIndividualOrganization(input) {
         const routeCtx = this.paths.routeCtxFromInput(input);
-        return startIndividualOrganizationWithDeps({
+        return registerIndividualOrganizationWithDeps({
             input,
             routeCtx,
             individualFamilyOrganizationBatchPath: this.paths.individualFamilyOrganizationTransactionPath.bind(this.paths),
@@ -643,6 +644,10 @@ export class HttpRuntimeClient {
             getOfferPreviewFromResponse: (result) => extractOfferPreviewFromResponseBody(result.poll.body),
         });
     }
+    /** @deprecated Use `registerIndividualOrganization`. */
+    async startIndividualOrganization(input) {
+        return this.registerIndividualOrganization(input);
+    }
     /**
      * Searches one existing family/individual registration by controller phone +
      * usualname, with optional birth-date disambiguation.
@@ -676,7 +681,11 @@ export class HttpRuntimeClient {
         });
     }
     /**
-     * Confirms the order returned by `startIndividualOrganization(...)`.
+     * Confirms the Offer returned by `registerIndividualOrganization(...)`, waits
+     * for the terminal Order, and exposes its controller `activationCode`.
+     * The caller passes that opaque value directly to
+     * `ServerProfileSessionManager.enroll(...)`; it does not traverse claims or
+     * call a separate licence reader.
      */
     async confirmIndividualOrganizationOrder(input) {
         const routeCtx = this.paths.routeCtxFromInput(input);

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

@@ -10,7 +10,7 @@ import type { OrganizationEmployeeProvisioningInput, OrganizationEmployeeProvisi
 import type { OrganizationEmployeeLifecycleRecord } from 'gdc-common-utils-ts/models/organization-employee-lifecycle';
 import type { HostRouteContext, HostedTenantLifecycleInput, LegalOrganizationOrderInput } from '../host-onboarding.js';
 import type { IndividualOrganizationConfirmOrderInput, IndividualOrganizationOrderResult, RouteContext } from '../individual-onboarding.js';
-import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
+import type { IndividualOrganizationBootstrapInput, IndividualOrganizationRegistrationInput, IndividualOrganizationRegistrationResult, IndividualOrganizationStartResult } from '../individual-start.js';
 import type { FamilyOrganizationSearchInput } from '../family-organization-search.js';
 import type { FhirR5SubscriptionTopic } from 'gdc-common-utils-ts/models/fhir-r5-subscription';
 import type { FhirR5SubscriptionBatchInput } from '../fhir-r5-subscription-runtime.js';
@@ -104,7 +104,9 @@ export type RuntimeClient = {
     activateEmployeeDeviceWithActivationRequest?: (input: EmployeeDeviceActivationRequestInput) => Promise<EmployeeDeviceActivationResult>;
     revokeEmployeeDevice?: (ctx: RouteContext, input: EmployeeDeviceRevocationInput) => Promise<SubmitAndPollResult>;
     requestSmartToken?: (input: SmartTokenRequestInput) => Promise<SmartTokenExchangeResult>;
-    startIndividualOrganization?: (input: IndividualOrganizationBootstrapInput) => Promise<IndividualOrganizationStartResult>;
+    registerIndividualOrganization?: (input: IndividualOrganizationRegistrationInput) => Promise<IndividualOrganizationRegistrationResult>;
+    /** @deprecated Use `registerIndividualOrganization`. */
+    startIndividualOrganization?: (input: IndividualOrganizationRegistrationInput) => Promise<IndividualOrganizationRegistrationResult>;
     searchFamilyOrganization?: (ctx: RouteContext, input: FamilyOrganizationSearchInput) => Promise<FamilyOrganizationSummary | null>;
     ensureFamilyOrganizationRegistration?: (ctx: RouteContext, input: EnsureFamilyOrganizationRegistrationInput) => Promise<EnsureFamilyOrganizationRegistrationResult>;
     confirmIndividualOrganizationOrder?: (input: IndividualOrganizationConfirmOrderInput) => Promise<IndividualOrganizationOrderResult>;

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

@@ -4,7 +4,7 @@ import type { FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family
 import type { EnsureFamilyOrganizationRegistrationInput, EnsureFamilyOrganizationRegistrationResult } from '../family-organization-registration.js';
 import type { FamilyOrganizationSearchInput } from '../family-organization-search.js';
 import type { IndividualOrganizationConfirmOrderInput, IndividualOrganizationOrderResult, RouteContext } from '../individual-onboarding.js';
-import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
+import type { IndividualOrganizationRegistrationInput, IndividualOrganizationRegistrationResult } from '../individual-start.js';
 import type { NodeCapability } from '../session.js';
 import type { IndividualOrganizationLifecycleInput } from 'gdc-sdk-core-ts';
 import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, ClinicalSectionUpdateInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, ClinicalSummaryUpdateInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, DigitalTwinSecondaryUseConsentInput, DigitalTwinSecondaryUseConsentResult, DigitalTwinSubjectLinkPurgeInput, DigitalTwinSubjectLinkPurgeResult, GrantProfessionalAccessInput, GrantProfessionalAccessResult, IndividualMemberLifecycleInput, IndividualMemberLicenseAddInput, IndividualMemberLicenseInvitationInput, IndividualMemberLicenseTransitionInput, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput, RevokeProfessionalAccessInput, RevokeProfessionalAccessResult, ProfessionalAccessRequestDecisionInput, ProfessionalAccessRequestSearchInput, RelatedPersonUpsertInput } from '../resource-operations.js';
@@ -23,9 +23,13 @@ export declare class IndividualControllerSdk {
      */
     constructor(client: NodeRuntimeClient, capabilities?: readonly NodeCapability[] | undefined);
     /**
-     * Starts the individual onboarding/bootstrap flow.
+     * Registers the personal organization/subject index and returns its Offer.
+     * Wallet creation, activation exchange, DCR, and session opening are later
+     * `ServerProfileSessionManager` phases.
      */
-    startIndividualOrganization(input: IndividualOrganizationBootstrapInput): Promise<IndividualOrganizationStartResult>;
+    registerIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
+    /** @deprecated Use `registerIndividualOrganization`. */
+    startIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
     /**
      * Searches one existing family/individual registration by the phone-first
      * business key used by channel apps.
@@ -37,7 +41,9 @@ export declare class IndividualControllerSdk {
      */
     ensureFamilyOrganizationRegistration(ctx: RouteContext, input: EnsureFamilyOrganizationRegistrationInput): Promise<EnsureFamilyOrganizationRegistrationResult>;
     /**
-     * Confirms the order returned by `startIndividualOrganization(...)`.
+     * Confirms the Offer returned by `registerIndividualOrganization(...)` and
+     * returns the opaque controller `activationCode` required by profile
+     * enrollment.
      */
     confirmIndividualOrganizationOrder(input: IndividualOrganizationConfirmOrderInput): Promise<IndividualOrganizationOrderResult>;
     /**

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

@@ -23,11 +23,17 @@ export class IndividualControllerSdk {
         this.capabilities = capabilities;
     }
     /**
-     * Starts the individual onboarding/bootstrap flow.
+     * Registers the personal organization/subject index and returns its Offer.
+     * Wallet creation, activation exchange, DCR, and session opening are later
+     * `ServerProfileSessionManager` phases.
      */
+    registerIndividualOrganization(input) {
+        assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualBootstrap, ActorKinds.IndividualController, 'registerIndividualOrganization');
+        return requireClientMethod(this.client, 'registerIndividualOrganization')(input);
+    }
+    /** @deprecated Use `registerIndividualOrganization`. */
     startIndividualOrganization(input) {
-        assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualBootstrap, ActorKinds.IndividualController, 'startIndividualOrganization');
-        return requireClientMethod(this.client, 'startIndividualOrganization')(input);
+        return this.registerIndividualOrganization(input);
     }
     /**
      * Searches one existing family/individual registration by the phone-first
@@ -44,7 +50,9 @@ export class IndividualControllerSdk {
         return requireClientMethod(this.client, 'ensureFamilyOrganizationRegistration')(ctx, input);
     }
     /**
-     * Confirms the order returned by `startIndividualOrganization(...)`.
+     * Confirms the Offer returned by `registerIndividualOrganization(...)` and
+     * returns the opaque controller `activationCode` required by profile
+     * enrollment.
      */
     confirmIndividualOrganizationOrder(input) {
         assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualBootstrap, ActorKinds.IndividualController, 'confirmIndividualOrganizationOrder');

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

@@ -1,13 +1,15 @@
 import { type NodeRuntimeClient, type PollOptions, type SubmitAndPollResult, type SubmitPayload } from './client-port.js';
-import type { IndividualOrganizationBootstrapInput, IndividualOrganizationStartResult } from '../individual-start.js';
+import type { IndividualOrganizationRegistrationInput, IndividualOrganizationRegistrationResult } from '../individual-start.js';
 import type { RouteContext } from '../individual-onboarding.js';
 import type { BlockchainArtifactRegistrationInput, ClinicalBundleSearchInput, ClinicalSectionUpdateInput, ClinicalSummaryReadResult, ClinicalSummaryRequestInput, ClinicalSummaryUpdateInput, CommunicationIngestionInput, CommunicationParticipantRuntimeSearchInput, DigitalTwinGenerationInput, GrantProfessionalAccessInput, GrantProfessionalAccessResult, ProfessionalAccessRequestDecisionInput, ProfessionalAccessRequestSearchInput, IpsOrFhirImportInput, LicenseListRuntimeSearchInput, LicenseOfferRuntimeSearchInput, LicenseOrderRuntimeSearchInput } from '../resource-operations.js';
 import type { SmartTokenExchangeResult, SmartTokenRequestInput } from '../smart-token.js';
 export declare class PersonalSdk {
     private readonly client;
     constructor(client: NodeRuntimeClient);
-    /** Starts individual subject onboarding (organization profile) and returns offer preview. */
-    startIndividualOrganization(input: IndividualOrganizationBootstrapInput): Promise<IndividualOrganizationStartResult>;
+    /** Registers the personal organization/subject index and returns its Offer. */
+    registerIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
+    /** @deprecated Use `registerIndividualOrganization`. */
+    startIndividualOrganization(input: IndividualOrganizationRegistrationInput): Promise<IndividualOrganizationRegistrationResult>;
     /** Grants professional access via Consent for a subject. */
     grantProfessionalAccess(ctx: RouteContext, input: GrantProfessionalAccessInput): Promise<GrantProfessionalAccessResult>;
     /** Approves or denies a permission request while retaining its correlation. */

package/dist/orchestration/personal-sdk.js

@@ -6,9 +6,13 @@ export class PersonalSdk {
     constructor(client) {
         this.client = client;
     }
-    /** Starts individual subject onboarding (organization profile) and returns offer preview. */
+    /** Registers the personal organization/subject index and returns its Offer. */
+    registerIndividualOrganization(input) {
+        return requireClientMethod(this.client, 'registerIndividualOrganization')(input);
+    }
+    /** @deprecated Use `registerIndividualOrganization`. */
     startIndividualOrganization(input) {
-        return requireClientMethod(this.client, 'startIndividualOrganization')(input);
+        return this.registerIndividualOrganization(input);
     }
     /** Grants professional access via Consent for a subject. */
     grantProfessionalAccess(ctx, input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "2.9.1",
+  "version": "2.9.3",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -13,7 +13,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "prepare": "npm run build",
-    "type-check": "tsc -p tsconfig.json --noEmit",
+    "type-check": "tsc -p tsconfig.json --noEmit && tsc -p docs/snippets/tsconfig.json",
     "check:product-neutrality": "node scripts/check-product-neutrality.mjs",
     "prepublishOnly": "npm run check:product-neutrality && npm run type-check && npm test",
     "local:close": "PORTS=3000 bash ./scripts/local-close.sh",
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "gdc-common-utils-ts": "2.9.4",
-    "gdc-sdk-core-ts": "2.9.1"
+    "gdc-sdk-core-ts": "2.9.2"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",