gdc-sdk-node-ts 2.3.0 → 2.3.1

package/dist/individual-start.d.ts

@@ -1,3 +1,4 @@
+import type { FamilyRegistrationStatus } 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';
 import type { OfferPreview } from './order-offer-summary.js';
@@ -59,6 +60,29 @@ export type IndividualOrganizationStartResult = {
     registration: SubmitAndPollResult;
     offerId: string;
     offerPreview: OfferPreview;
+    /** Lifecycle state returned by GW for this registration receipt. */
+    registrationStatus?: FamilyRegistrationStatus;
+    /** False when the same family registration is already active. */
+    orderConfirmationRequired: boolean;
+    /**
+     * Canonical subject identity projected from the GW registration receipt.
+     *
+     * It is optional only for compatibility with older/non-conforming GW
+     * responses. Current GW responses expose both `resource.id` and
+     * `Offer.offeredBy`, allowing every BFF/channel to consume the same derived
+     * identity without rebuilding a provider DID from route fragments or VAT.
+     */
+    identity?: IndividualOrganizationBootstrapIdentity;
+};
+export type IndividualOrganizationBootstrapIdentity = {
+    /** Technical UUID returned as `Bundle.data[0].resource.id`. */
+    resourceId: string;
+    /** Stable UUID-byte identifier serialized as multibase base58btc. */
+    individualId: string;
+    /** Authoritative provider DID returned by GW in `Offer.offeredBy`. */
+    providerDidWeb: string;
+    /** Canonical child DID built beneath the exact provider DID returned by GW. */
+    subjectDid: string;
 };
 type StartIndividualOrganizationDeps = {
     input: IndividualOrganizationBootstrapInput;
@@ -75,4 +99,13 @@ type StartIndividualOrganizationDeps = {
     getOfferPreviewFromResponse: (result: SubmitAndPollResult) => OfferPreview;
 };
 export declare function startIndividualOrganizationWithDeps(deps: StartIndividualOrganizationDeps): Promise<IndividualOrganizationStartResult>;
+/**
+ * Projects the reusable subject identity from an individual bootstrap receipt.
+ *
+ * `providerDidWeb` is deliberately read from `Offer.offeredBy` and preserved
+ * byte-for-byte. The provider root uses the colon-delimited
+ * `:organization:taxid:` DID path. `buildIndividualDidWeb(...)` only adds the
+ * individual suffix and never rewrites that provider lineage.
+ */
+export declare function readIndividualOrganizationBootstrapIdentity(responseBody: unknown): IndividualOrganizationBootstrapIdentity | undefined;
 export {};

package/dist/individual-start.js

@@ -1,5 +1,6 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-import { ClaimsOrganizationSchemaorg, ClaimsPersonSchemaorg, ClaimsServiceSchemaorg, } from 'gdc-common-utils-ts/constants';
+import { ClaimsOfferSchemaorg, ClaimsOrganizationSchemaorg, ClaimsPersonSchemaorg, ClaimsServiceSchemaorg, } from 'gdc-common-utils-ts/constants';
+import { buildIndividualDidWeb, encodeHexToMultibase58btc, extractPrimaryClaims, readFamilyOrganizationSummaryFromResponseBody, } from 'gdc-common-utils-ts';
 import { GwCoreLifecycleRequestType } from './constants/lifecycle.js';
 import { resolvePollOptionsFromSeconds } from './poll-options.js';
 export async function startIndividualOrganizationWithDeps(deps) {
@@ -27,6 +28,7 @@ export async function startIndividualOrganizationWithDeps(deps) {
     const controllerRole = String(deps.input.controllerRole || 'RESPRSN').trim();
     const claims = {
         '@context': 'org.schema',
+        ...(deps.input.additionalClaims || {}),
         [ClaimsOrganizationSchemaorg.alternateName]: alternateName,
         [ClaimsServiceSchemaorg.category]: deps.routeCtx.sector,
         [ClaimsPersonSchemaorg.hasOccupationalRoleValue]: controllerRole,
@@ -42,7 +44,6 @@ export async function startIndividualOrganizationWithDeps(deps) {
                 [ClaimsPersonSchemaorg.telephone]: controllerTelephone,
             }
             : {}),
-        ...(deps.input.additionalClaims || {}),
     };
     const registrationPayload = {
         jti: `jti-${createRuntimeUuid()}`,
@@ -77,12 +78,54 @@ export async function startIndividualOrganizationWithDeps(deps) {
     if (!offerId) {
         throw new Error('startIndividualOrganization failed: missing offerId in registration response.');
     }
+    const registrationSummary = readFamilyOrganizationSummaryFromResponseBody(registration.poll.body);
     return {
         registration,
         offerId,
         offerPreview: deps.getOfferPreviewFromResponse(registration),
+        registrationStatus: registrationSummary?.status,
+        orderConfirmationRequired: registrationSummary?.status !== 'already_exists',
+        identity: readIndividualOrganizationBootstrapIdentity(registration.poll.body),
+    };
+}
+/**
+ * Projects the reusable subject identity from an individual bootstrap receipt.
+ *
+ * `providerDidWeb` is deliberately read from `Offer.offeredBy` and preserved
+ * byte-for-byte. The provider root uses the colon-delimited
+ * `:organization:taxid:` DID path. `buildIndividualDidWeb(...)` only adds the
+ * individual suffix and never rewrites that provider lineage.
+ */
+export function readIndividualOrganizationBootstrapIdentity(responseBody) {
+    const root = asRecord(responseBody);
+    const body = asRecord(root?.body) || root;
+    const entries = Array.isArray(body?.data) ? body.data : [];
+    const first = asRecord(entries[0]);
+    const resource = asRecord(first?.resource);
+    const resourceId = String(resource?.id || '').trim();
+    const claims = extractPrimaryClaims(responseBody);
+    const providerDidWeb = String(claims[ClaimsOfferSchemaorg.offeredBy] || '').trim();
+    if (!resourceId || !providerDidWeb)
+        return undefined;
+    let individualId;
+    try {
+        individualId = encodeHexToMultibase58btc(resourceId);
+    }
+    catch {
+        return undefined;
+    }
+    return {
+        resourceId,
+        individualId,
+        providerDidWeb,
+        subjectDid: buildIndividualDidWeb({ providerDidWeb, individualId }),
     };
 }
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
 function createRuntimeUuid() {
     const fromCrypto = globalThis.crypto?.randomUUID?.();
     if (fromCrypto) {

package/package.json

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