gdc-sdk-node-ts 2.0.2 → 2.0.4

package/README.md

@@ -42,6 +42,13 @@ Important live-run rule:
 - if sandboxed runs disagree with the user's terminal, trust the user's
   terminal for live GW validation
 
+Required live validation order:
+
+1. local process E2E from real TTY
+2. local Docker image/container E2E
+3. staging E2E
+4. production image/deploy only after staging is green
+
 Architectural rule:
 
 - shared contracts and actor boundaries come from `gdc-sdk-core-ts`
@@ -56,6 +63,10 @@ If you are integrating this package for the first time, open these in order:
 1. [gdc-sdk-core-ts/docs/101-SDK_PACKAGE_BOUNDARIES.md](https://github.com/Global-DataCare/gdc-sdk-core-ts/blob/main/docs/101-SDK_PACKAGE_BOUNDARIES.md)
    Why `core`, `node`, and `front` are separate packages, what belongs in each
    one, and why actor-scoped facades must stay aligned across runtimes.
+1. [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.
 1. [tests/101-backend-profile-runtime.test.mjs](./tests/101-backend-profile-runtime.test.mjs)
    Minimal backend-generic walkthrough for loading one actor profile,
    registering one trusted device/runtime context, connecting to one subject
@@ -115,21 +126,15 @@ If you need the shortest path:
 - dataspace discovery and fallback/cache boundary:
   [docs/101-DISCOVERY.md](./docs/101-DISCOVERY.md)
 
-Immediate live validation target:
-
-- the next profile-runtime validation must be treated as an actor-profile suite,
-  not as a replay of the GW CORE platform lifecycle
-- the standalone current entry point for that is:
-  [tests/live-profile-runtime-individual.e2e.test.mjs](tests/live-profile-runtime-individual.e2e.test.mjs)
-- it should begin with `loadProfile(...)` for the target actor and then prove:
-  - `startIndividualOrganization(...)`
-  - `confirmIndividualOrganizationOrder(...)`
-  - the canonical current index/`Composition` read helper
-- if that actor flow creates lifecycle-owned state, `disable` / `purge` belong
-  at the end of that scenario as cleanup
-- until that live proof exists, treat `getLatestIps(...)` and
-  `searchClinicalBundle(...)` as candidate read contracts, not yet final
-  wording
+Current live teaching target:
+
+- the main executable tutorial for integrators is now:
+  [tests/101-live-full-cycle-bff-runtime.e2e.test.mjs](tests/101-live-full-cycle-bff-runtime.e2e.test.mjs)
+- the standalone actor-profile suites still exist as focused technical slices:
+  - [tests/live-profile-runtime-individual.e2e.test.mjs](tests/live-profile-runtime-individual.e2e.test.mjs)
+  - [tests/live-profile-runtime-professional.e2e.test.mjs](tests/live-profile-runtime-professional.e2e.test.mjs)
+- the larger runtime suite remains the regression-oriented environment proof:
+  [tests/live-gw-node-runtime.e2e.test.mjs](tests/live-gw-node-runtime.e2e.test.mjs)
 
 ## Executable Usage Examples
 
@@ -149,6 +154,9 @@ Open these tests when you want to see exact method calls and exact inputs:
   SMART token request flow.
 - [tests/live-gw-node-runtime.e2e.test.mjs](tests/live-gw-node-runtime.e2e.test.mjs)
   End-to-end runtime wiring against a real GW environment.
+- [tests/101-live-full-cycle-bff-runtime.e2e.test.mjs](tests/101-live-full-cycle-bff-runtime.e2e.test.mjs)
+  Single live BFF-oriented `101` that chains tenant, professional, individual,
+  consent, SMART, read, and cleanup in one executable conversation.
 - [tests/live-profile-runtime-individual.e2e.test.mjs](tests/live-profile-runtime-individual.e2e.test.mjs)
   Standalone actor-profile E2E for the individual controller on an already
   operational tenant, including scenario-owned cleanup.
@@ -160,8 +168,11 @@ Open these tests when you want to see exact method calls and exact inputs:
 
 ## Live GW CORE Flow
 
+Use [tests/101-live-full-cycle-bff-runtime.e2e.test.mjs](tests/101-live-full-cycle-bff-runtime.e2e.test.mjs)
+as the canonical live `101` for backend/BFF integrators.
+
 Use [tests/live-gw-node-runtime.e2e.test.mjs](tests/live-gw-node-runtime.e2e.test.mjs)
-as the canonical runtime flow.
+as the broader runtime-regression suite.
 
 Before running that suite, read:
 
@@ -182,18 +193,23 @@ Teaching rule:
 - `LIVE_GW_E2E_EXECUTION_MODE=direct` is the current and only supported mode
   for live validation; queued app-side job management is a later phase
 
-Current live flow covered by the test suite:
+Current live `101` flow covered by the test suite:
 
-1. bootstrap tenant / legal organization
-2. bootstrap doctor or controller employee
-3. bootstrap individual and grant consent for the doctor
-   default example: `INDIVIDUAL_ALTERNATE_NAME=Doraemon`
-4. ingest two IPS `Communication` bundles, each with one `MedicationStatement`
-5. read the IPS/clinical index and verify both medications are present
-6. request the consolidated IPS bundle through
-   `Bundle?type=document&composition.subject=<did>&composition.type=http://loinc.org|60591-5`
-7. verify the returned bundle document contains both medication statements
-8. persist audit/debug traces in `test-results/*.jsonl`
+1. activate one hosted tenant / legal organization
+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
+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
+9. clean up consent, individual, employee, tenant, and host state
+
+Run the main live `101`:
+
+```bash
+npm run test:e2e:101:live-full-cycle
+```
 
 What is still not fully covered as one single root lifecycle:
 
@@ -659,9 +675,9 @@ modules below.
 
 For legal-organization onboarding from a Node BFF/runtime, keep the host steps separate:
 
-1. `Organization/_transaction`
-2. legacy `Organization/_activate` after ICA `_verify`
-3. `Order/_batch`
+1. new flow: `Organization/_transaction`
+2. legacy compatibility flow: `ICA _verify -> Organization/_activate`
+3. downstream business continuation: `Order/_batch`
 
 Use `OrganizationControllerSdk.submitLegalOrganizationVerificationTransaction(...)` or
 `NodeHttpClient.submitLegalOrganizationVerificationTransaction(...)` for step 1.
@@ -672,3 +688,29 @@ Rules:
 - transport/runtime communication keys stay outside the business payload
 - controller binding key stays in `body.data[].resource.controller.*`
 - do not mix this path with `requestIcaEnrollment` or Fabric
+
+Legacy compatibility coverage in the live suite:
+
+- the canonical test is `LIVE professional lifecycle on GW`
+- set `RUN_LIVE_GW_E2E_HOST_VERIFICATION_TRANSACTION=1` to exercise:
+  - `Organization/_transaction -> Order/_batch`
+- set `RUN_LIVE_GW_E2E_HOST_VERIFICATION_TRANSACTION=0` to exercise the older:
+  - `ICA _verify -> Organization/_activate -> Order/_batch`
+
+Dedicated legacy live command:
+
+```bash
+cd /Users/fernando/GITS/gdc-workspace/gdc-sdk-node-ts
+RUN_LIVE_GW_E2E=1 \
+RUN_LIVE_GW_E2E_ACTOR_CHAIN=1 \
+RUN_LIVE_GW_E2E_HOST_VERIFICATION_TRANSACTION=0 \
+LIVE_GW_E2E_SUITE=professional \
+node --test tests/live-gw-node-runtime.e2e.test.mjs
+```
+
+Live E2E legal PDF source:
+
+- local file: set `LIVE_GW_HOST_VERIFICATION_PDF_PATH=/abs/path/file.pdf`
+- public URL: set `LIVE_GW_HOST_VERIFICATION_PDF_URL=https://.../file.pdf`
+- if both are present, the live suite prefers `LIVE_GW_HOST_VERIFICATION_PDF_URL`
+- Dropbox-style links are normalized to `dl=1` direct-download mode automatically

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

@@ -2,6 +2,8 @@ import type { ActorProfileDescriptor, IJobManager, ActorKind, LoadedActorProfile
 import type { ActorSession } from './session.js';
 import type { RuntimeClient } from './orchestration/client-port.js';
 import { IndividualControllerSdk } from './orchestration/individual-controller-sdk.js';
+import { OrganizationControllerSdk } from './orchestration/organization-controller-sdk.js';
+import { ProfessionalSdk } from './orchestration/professional-sdk.js';
 import type { RouteContext } from './individual-onboarding.js';
 /**
  * Result of registering one trusted backend runtime device/profile context.
@@ -49,6 +51,16 @@ export type BackendIndividualControllerProfile = {
     session: ActorSession;
     sdk: IndividualControllerSdk;
 };
+export type BackendOrganizationControllerProfile = {
+    profile: BackendLoadedActorProfile;
+    session: ActorSession;
+    sdk: OrganizationControllerSdk;
+};
+export type BackendProfessionalProfile = {
+    profile: BackendLoadedActorProfile;
+    session: ActorSession;
+    sdk: ProfessionalSdk;
+};
 /**
  * Canonical backend runtime contract for loading one actor profile after
  * authentication and then working with trusted device registration and subject
@@ -153,6 +165,15 @@ export declare class DirectBackendProfileRuntime implements BackendProfileRuntim
     private forgetLoadedProfile;
     private resolveLoadedProfile;
 }
+/**
+ * Preferred developer-facing factory for the current backend profile runtime.
+ *
+ * Use this helper in tutorials and app/BFF code when you already have one
+ * configured runtime client and want the canonical
+ * `loadProfile(...) -> session -> actor facade` entrypoint without exposing the
+ * concrete class name in every example.
+ */
+export declare function createBackendProfileRuntime(options: DirectBackendProfileRuntimeOptions): BackendProfileRuntimeClient;
 /**
  * Minimal in-memory `JobManager` for backend runtimes that do not need durable
  * persistence during one live session.
@@ -203,6 +224,24 @@ export declare function requireBackendIndividualControllerSession(profile: Backe
  * backend profile.
  */
 export declare function requireBackendIndividualControllerSdk(profile: BackendLoadedActorProfile): IndividualControllerSdk;
+/**
+ * Returns the organization-controller session from one loaded backend profile.
+ */
+export declare function requireBackendOrganizationControllerSession(profile: BackendLoadedActorProfile): ActorSession;
+/**
+ * Materializes the organization-controller facade directly from one loaded
+ * backend profile.
+ */
+export declare function requireBackendOrganizationControllerSdk(profile: BackendLoadedActorProfile): OrganizationControllerSdk;
+/**
+ * Returns the professional session from one loaded backend profile.
+ */
+export declare function requireBackendProfessionalSession(profile: BackendLoadedActorProfile): ActorSession;
+/**
+ * Materializes the professional facade directly from one loaded backend
+ * profile.
+ */
+export declare function requireBackendProfessionalSdk(profile: BackendLoadedActorProfile): ProfessionalSdk;
 /**
  * Loads one backend profile and resolves the individual-controller session in
  * one step.
@@ -212,3 +251,12 @@ export declare function requireBackendIndividualControllerSdk(profile: BackendLo
  * from the individual-controller flow.
  */
 export declare function loadBackendIndividualControllerProfile(client: BackendProfileRuntimeClient, input: ProfileLoadRequest): Promise<BackendIndividualControllerProfile>;
+/**
+ * Loads one backend profile and resolves the organization-controller session in
+ * one step.
+ */
+export declare function loadBackendOrganizationControllerProfile(client: BackendProfileRuntimeClient, input: ProfileLoadRequest): Promise<BackendOrganizationControllerProfile>;
+/**
+ * Loads one backend profile and resolves the professional session in one step.
+ */
+export declare function loadBackendProfessionalProfile(client: BackendProfileRuntimeClient, input: ProfileLoadRequest): Promise<BackendProfessionalProfile>;

package/dist/backend-profile-runtime.js

@@ -185,6 +185,17 @@ export class DirectBackendProfileRuntime {
         throw new Error(`DirectBackendProfileRuntime has not loaded one backend profile for '${normalizedUserId}'.`);
     }
 }
+/**
+ * Preferred developer-facing factory for the current backend profile runtime.
+ *
+ * Use this helper in tutorials and app/BFF code when you already have one
+ * configured runtime client and want the canonical
+ * `loadProfile(...) -> session -> actor facade` entrypoint without exposing the
+ * concrete class name in every example.
+ */
+export function createBackendProfileRuntime(options) {
+    return new DirectBackendProfileRuntime(options);
+}
 /**
  * Minimal in-memory `JobManager` for backend runtimes that do not need durable
  * persistence during one live session.
@@ -410,6 +421,32 @@ export function requireBackendIndividualControllerSession(profile) {
 export function requireBackendIndividualControllerSdk(profile) {
     return requireBackendIndividualControllerSession(profile).asIndividualController();
 }
+/**
+ * Returns the organization-controller session from one loaded backend profile.
+ */
+export function requireBackendOrganizationControllerSession(profile) {
+    return requireBackendActorSession(profile, ActorKinds.OrganizationController);
+}
+/**
+ * Materializes the organization-controller facade directly from one loaded
+ * backend profile.
+ */
+export function requireBackendOrganizationControllerSdk(profile) {
+    return requireBackendOrganizationControllerSession(profile).asOrganizationController();
+}
+/**
+ * Returns the professional session from one loaded backend profile.
+ */
+export function requireBackendProfessionalSession(profile) {
+    return requireBackendActorSession(profile, ActorKinds.Professional);
+}
+/**
+ * Materializes the professional facade directly from one loaded backend
+ * profile.
+ */
+export function requireBackendProfessionalSdk(profile) {
+    return requireBackendProfessionalSession(profile).asProfessional();
+}
 /**
  * Loads one backend profile and resolves the individual-controller session in
  * one step.
@@ -427,6 +464,31 @@ export async function loadBackendIndividualControllerProfile(client, input) {
         sdk: session.asIndividualController(),
     };
 }
+/**
+ * Loads one backend profile and resolves the organization-controller session in
+ * one step.
+ */
+export async function loadBackendOrganizationControllerProfile(client, input) {
+    const profile = await loadBackendProfile(client, input);
+    const session = requireBackendOrganizationControllerSession(profile);
+    return {
+        profile,
+        session,
+        sdk: session.asOrganizationController(),
+    };
+}
+/**
+ * Loads one backend profile and resolves the professional session in one step.
+ */
+export async function loadBackendProfessionalProfile(client, input) {
+    const profile = await loadBackendProfile(client, input);
+    const session = requireBackendProfessionalSession(profile);
+    return {
+        profile,
+        session,
+        sdk: session.asProfessional(),
+    };
+}
 function createRuntimeUuid() {
     const fromCrypto = globalThis.crypto?.randomUUID?.();
     if (fromCrypto) {

package/dist/family-organization-registration.d.ts

@@ -0,0 +1,40 @@
+import type { FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
+import type { RouteContext } from './individual-onboarding.js';
+import { type IndividualOrganizationStartResult } from './individual-start.js';
+import { type FamilyOrganizationSearchInput } from './family-organization-search.js';
+import type { PollOptions, SubmitAndPollResult } from './orchestration/client-port.js';
+export type EnsureFamilyOrganizationRegistrationInput = FamilyOrganizationSearchInput & Readonly<{
+    controllerEmail?: string;
+    controllerRole?: string;
+    serviceProviderDid?: string;
+    tenantId?: string;
+    jurisdiction?: string;
+    sector?: string;
+    additionalClaims?: Record<string, unknown>;
+}>;
+export type EnsureFamilyOrganizationRegistrationResult = Readonly<{
+    status: 'already_exists' | 'resume_required' | 'new_created';
+    summary?: FamilyOrganizationSummary;
+    started?: IndividualOrganizationStartResult;
+}>;
+type EnsureFamilyOrganizationRegistrationDeps = {
+    routeCtx: RouteContext;
+    input: EnsureFamilyOrganizationRegistrationInput;
+    defaultTimeoutMs?: number;
+    defaultIntervalMs?: number;
+    individualFamilyOrganizationSearchPath: (ctx: RouteContext) => string;
+    individualFamilyOrganizationSearchPollPath: (ctx: RouteContext) => string;
+    individualFamilyOrganizationBatchPath: (ctx: RouteContext) => string;
+    individualFamilyOrganizationPollPath: (ctx: RouteContext) => string;
+    submitAndPoll: (submitPath: string, pollPath: string, payload: {
+        thid?: string;
+    } & Record<string, unknown>, options?: PollOptions) => Promise<SubmitAndPollResult>;
+};
+/**
+ * High-level controller orchestration for phone-first onboarding channels:
+ * - first search whether the family/individual registration already exists
+ * - if it exists, return the normalized summary
+ * - otherwise start the bootstrap flow using the same business input
+ */
+export declare function ensureFamilyOrganizationRegistrationWithDeps(deps: EnsureFamilyOrganizationRegistrationDeps): Promise<EnsureFamilyOrganizationRegistrationResult>;
+export {};

package/dist/family-organization-registration.js

@@ -0,0 +1,54 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { startIndividualOrganizationWithDeps, } from './individual-start.js';
+import { searchFamilyOrganizationWithDeps, } from './family-organization-search.js';
+import { extractOfferIdFromResponseBody, extractOfferPreviewFromResponseBody } from './order-offer-summary.js';
+/**
+ * High-level controller orchestration for phone-first onboarding channels:
+ * - first search whether the family/individual registration already exists
+ * - if it exists, return the normalized summary
+ * - otherwise start the bootstrap flow using the same business input
+ */
+export async function ensureFamilyOrganizationRegistrationWithDeps(deps) {
+    const summary = await searchFamilyOrganizationWithDeps({
+        routeCtx: deps.routeCtx,
+        input: deps.input,
+        defaultTimeoutMs: deps.defaultTimeoutMs,
+        defaultIntervalMs: deps.defaultIntervalMs,
+        individualFamilyOrganizationSearchPath: deps.individualFamilyOrganizationSearchPath,
+        individualFamilyOrganizationSearchPollPath: deps.individualFamilyOrganizationSearchPollPath,
+        submitAndPoll: deps.submitAndPoll,
+    });
+    if (summary?.status === 'already_exists' || summary?.status === 'resume_required') {
+        return {
+            status: summary.status,
+            summary,
+        };
+    }
+    const started = await startIndividualOrganizationWithDeps({
+        input: {
+            serviceProviderDid: deps.input.serviceProviderDid,
+            tenantId: deps.input.tenantId,
+            jurisdiction: deps.input.jurisdiction,
+            sector: deps.input.sector,
+            alternateName: deps.input.usualname,
+            controllerEmail: deps.input.controllerEmail,
+            controllerTelephone: deps.input.controllerPhone,
+            controllerRole: deps.input.controllerRole,
+            additionalClaims: deps.input.additionalClaims,
+            timeoutSeconds: deps.input.timeoutSeconds,
+            intervalSeconds: deps.input.intervalSeconds,
+        },
+        routeCtx: deps.routeCtx,
+        defaultTimeoutMs: deps.defaultTimeoutMs,
+        defaultIntervalMs: deps.defaultIntervalMs,
+        individualFamilyOrganizationBatchPath: deps.individualFamilyOrganizationBatchPath,
+        individualFamilyOrganizationPollPath: deps.individualFamilyOrganizationPollPath,
+        submitAndPoll: deps.submitAndPoll,
+        getOfferIdFromResponse: (result) => extractOfferIdFromResponseBody(result.poll.body),
+        getOfferPreviewFromResponse: (result) => extractOfferPreviewFromResponseBody(result.poll.body),
+    });
+    return {
+        status: 'new_created',
+        started,
+    };
+}

package/dist/family-organization-search.d.ts

@@ -0,0 +1,30 @@
+import { type FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
+import type { PollOptions, SubmitAndPollResult } from './orchestration/client-port.js';
+import type { RouteContext } from './individual-onboarding.js';
+export type FamilyOrganizationSearchInput = Readonly<{
+    controllerPhone: string;
+    usualname: string;
+    birthDate?: string;
+    timeoutSeconds?: number;
+    intervalSeconds?: number;
+}>;
+type SearchFamilyOrganizationWithDeps = {
+    routeCtx: RouteContext;
+    input: FamilyOrganizationSearchInput;
+    defaultTimeoutMs?: number;
+    defaultIntervalMs?: number;
+    individualFamilyOrganizationSearchPath: (ctx: RouteContext) => string;
+    individualFamilyOrganizationSearchPollPath: (ctx: RouteContext) => string;
+    submitAndPoll: (submitPath: string, pollPath: string, payload: {
+        thid?: string;
+    } & Record<string, unknown>, options?: PollOptions) => Promise<SubmitAndPollResult>;
+};
+/**
+ * Searches one existing family/individual organization registration by the
+ * current phone-first business key used by UHC/UNID channel flows.
+ *
+ * Returns one normalized summary when the registration exists, otherwise
+ * `null`.
+ */
+export declare function searchFamilyOrganizationWithDeps(deps: SearchFamilyOrganizationWithDeps): Promise<FamilyOrganizationSummary | null>;
+export {};

package/dist/family-organization-search.js

@@ -0,0 +1,59 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { readFamilyOrganizationSummaryFromResponseBody, } from 'gdc-common-utils-ts/utils/family-organization-summary';
+import { ClaimsOrganizationSchemaorg, ClaimsServiceSchemaorg } from 'gdc-common-utils-ts/constants';
+import { resolvePollOptionsFromSeconds } from './poll-options.js';
+/**
+ * Searches one existing family/individual organization registration by the
+ * current phone-first business key used by UHC/UNID channel flows.
+ *
+ * Returns one normalized summary when the registration exists, otherwise
+ * `null`.
+ */
+export async function searchFamilyOrganizationWithDeps(deps) {
+    const controllerPhone = String(deps.input.controllerPhone || '').trim();
+    const usualname = String(deps.input.usualname || '').trim();
+    const birthDate = String(deps.input.birthDate || '').trim();
+    if (!controllerPhone) {
+        throw new Error('searchFamilyOrganization requires controllerPhone.');
+    }
+    if (!usualname) {
+        throw new Error('searchFamilyOrganization requires usualname.');
+    }
+    const claims = {
+        '@context': 'org.schema',
+        [ClaimsOrganizationSchemaorg.ownerTelephone]: controllerPhone,
+        [ClaimsOrganizationSchemaorg.alternateName]: usualname,
+        [ClaimsServiceSchemaorg.category]: deps.routeCtx.sector,
+        ...(birthDate ? { 'org.schema.Organization.foundingDate': birthDate } : {}),
+    };
+    const payload = {
+        jti: `jti-${createRuntimeUuid()}`,
+        thid: `family-search-${createRuntimeUuid()}`,
+        iss: deps.routeCtx.tenantId,
+        aud: deps.routeCtx.tenantId,
+        type: 'application/api+json',
+        body: {
+            data: [{
+                    type: 'Family-search-v1.0',
+                    meta: { claims },
+                    resource: { meta: { claims } },
+                }],
+        },
+    };
+    const pollOptions = resolvePollOptionsFromSeconds(deps.input.timeoutSeconds, deps.input.intervalSeconds, {
+        timeoutMs: deps.defaultTimeoutMs,
+        intervalMs: deps.defaultIntervalMs,
+    });
+    const result = await deps.submitAndPoll(deps.individualFamilyOrganizationSearchPath(deps.routeCtx), deps.individualFamilyOrganizationSearchPollPath(deps.routeCtx), payload, pollOptions);
+    if (result.poll.status !== 200) {
+        return null;
+    }
+    return readFamilyOrganizationSummaryFromResponseBody(result.poll.body);
+}
+function createRuntimeUuid() {
+    const fromCrypto = globalThis.crypto?.randomUUID?.();
+    if (fromCrypto) {
+        return fromCrypto;
+    }
+    return `fallback-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}

package/dist/index.d.ts

@@ -4,15 +4,20 @@ export * from './identity-bootstrap.js';
 export * from './async-polling.js';
 export * from './backend-profile-runtime.js';
 export * from './individual-controller-backend-runtime.js';
+export * from './organization-controller-backend-runtime.js';
+export * from './professional-backend-runtime.js';
 export * from './poll-options.js';
 export * from './host-onboarding.js';
 export * from './individual-start.js';
+export * from './family-organization-search.js';
+export * from './family-organization-registration.js';
 export * from './individual-onboarding.js';
 export * from './device-activation.js';
 export * from './smart-token.js';
 export * from './order-offer-summary.js';
 export * from './organization-license-order.js';
 export * from './resource-operations.js';
+export * from './profile-workspace.js';
 export * from './constants/lifecycle.js';
 export * from './consent-claim-helpers.js';
 export * from './session.js';

package/dist/index.js

@@ -5,15 +5,20 @@ export * from './identity-bootstrap.js';
 export * from './async-polling.js';
 export * from './backend-profile-runtime.js';
 export * from './individual-controller-backend-runtime.js';
+export * from './organization-controller-backend-runtime.js';
+export * from './professional-backend-runtime.js';
 export * from './poll-options.js';
 export * from './host-onboarding.js';
 export * from './individual-start.js';
+export * from './family-organization-search.js';
+export * from './family-organization-registration.js';
 export * from './individual-onboarding.js';
 export * from './device-activation.js';
 export * from './smart-token.js';
 export * from './order-offer-summary.js';
 export * from './organization-license-order.js';
 export * from './resource-operations.js';
+export * from './profile-workspace.js';
 export * from './constants/lifecycle.js';
 export * from './consent-claim-helpers.js';
 export * from './session.js';

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

@@ -1,6 +1,9 @@
 import type { SubmitAndPollResult } from 'gdc-sdk-core-ts';
+import type { FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
 import type { IndividualOrganizationConfirmOrderInput, RouteContext } from './individual-onboarding.js';
 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 BackendIndividualControllerProfile, type BackendProfileRuntimeClient } from './backend-profile-runtime.js';
 import type { ProfileLoadRequest } from 'gdc-sdk-core-ts';
@@ -29,6 +32,16 @@ export declare class IndividualControllerBackendRuntime {
      * Starts the current CORE individual/family bootstrap flow.
      */
     startIndividualOrganization(profile: BackendIndividualControllerProfile, input: IndividualOrganizationBootstrapInput): Promise<IndividualOrganizationStartResult>;
+    /**
+     * Searches one existing family/individual registration before deciding
+     * whether the backend should create or resume it.
+     */
+    searchFamilyOrganization(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: FamilyOrganizationSearchInput): Promise<FamilyOrganizationSummary | null>;
+    /**
+     * High-level onboarding gate for channel apps:
+     * search the registration first and only bootstrap when still missing.
+     */
+    ensureFamilyOrganizationRegistration(profile: BackendIndividualControllerProfile, ctx: RouteContext, input: EnsureFamilyOrganizationRegistrationInput): Promise<EnsureFamilyOrganizationRegistrationResult>;
     /**
      * Confirms the order returned by the individual bootstrap flow.
      */

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

@@ -30,6 +30,20 @@ export class IndividualControllerBackendRuntime {
     startIndividualOrganization(profile, input) {
         return profile.sdk.startIndividualOrganization(input);
     }
+    /**
+     * Searches one existing family/individual registration before deciding
+     * whether the backend should create or resume it.
+     */
+    searchFamilyOrganization(profile, ctx, input) {
+        return profile.sdk.searchFamilyOrganization(ctx, input);
+    }
+    /**
+     * High-level onboarding gate for channel apps:
+     * search the registration first and only bootstrap when still missing.
+     */
+    ensureFamilyOrganizationRegistration(profile, ctx, input) {
+        return profile.sdk.ensureFamilyOrganizationRegistration(ctx, input);
+    }
     /**
      * Confirms the order returned by the individual bootstrap flow.
      */