gdc-sdk-node-ts 2.9.16 → 2.9.17

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

@@ -1,4 +1,4 @@
-import { type FamilyOrganizationSummary } from 'gdc-common-utils-ts/utils/family-organization-summary';
+import { type FamilyOrganizationSummary, 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';
 export type FamilyOrganizationSearchInput = Readonly<{
@@ -19,7 +19,11 @@ export type OwnedFamilyOrganizationDirectoryInput = Readonly<{
 }>;
 export type OwnedFamilyOrganizationDirectoryEntry = Readonly<{
     resourceId: string;
-    alternateName: string;
+    /** Missing only for an owner-private registration draft. */
+    alternateName?: string;
+    status?: FamilyRegistrationStatus;
+    birthDate?: string;
+    missingFields?: string[];
     claims: Readonly<Record<string, unknown>>;
 }>;
 type SearchFamilyOrganizationWithDeps = {

package/dist/family-organization-search.js

@@ -1,6 +1,6 @@
 // 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 { ClaimsOrganizationSchemaorg, ClaimsPersonSchemaorg, ClaimsServiceSchemaorg } from 'gdc-common-utils-ts/constants';
 import { resolvePollOptionsFromSeconds } from './poll-options.js';
 /**
  * Searches one existing family/individual organization registration by the
@@ -100,11 +100,35 @@ export async function listOwnedFamilyOrganizationsWithDeps(routeCtx, input, deps
         if (!((email && ownerEmail === email) || (telephone && ownerTelephone === telephone)))
             return [];
         const alternateName = String(resourceClaims[ClaimsOrganizationSchemaorg.alternateName] || '').trim();
-        if (!alternateName)
+        const rawStatus = String(resourceClaims['org.schema.FamilyRegistration.status'] || '').trim();
+        const status = isFamilyRegistrationStatus(rawStatus) ? rawStatus : undefined;
+        if (!alternateName && status !== 'draft_saved' && status !== 'resume_required')
             return [];
-        return [{ resourceId: String(resource.id), alternateName, claims: resourceClaims }];
+        const birthDate = String(resourceClaims[ClaimsPersonSchemaorg.birthDate]
+            || resourceClaims['org.schema.Organization.foundingDate']
+            || '').trim();
+        const missingFields = Array.isArray(resourceClaims['org.schema.FamilyRegistration.missingFields'])
+            ? resourceClaims['org.schema.FamilyRegistration.missingFields']
+                .map((value) => String(value || '').trim())
+                .filter(Boolean)
+            : [];
+        return [{
+                resourceId: String(resource.id),
+                ...(alternateName ? { alternateName } : {}),
+                ...(status ? { status } : {}),
+                ...(birthDate ? { birthDate } : {}),
+                ...(missingFields.length ? { missingFields } : {}),
+                claims: resourceClaims,
+            }];
     });
 }
+function isFamilyRegistrationStatus(value) {
+    return value === 'new_created'
+        || value === 'draft_saved'
+        || value === 'resume_required'
+        || value === 'already_exists'
+        || value === 'not_found';
+}
 function createRuntimeUuid() {
     const fromCrypto = globalThis.crypto?.randomUUID?.();
     if (fromCrypto) {

package/dist/individual-start.d.ts

@@ -6,6 +6,14 @@ import type { PollOptions, SubmitAndPollResult } from './orchestration/client-po
 import type { RouteContext } from './individual-onboarding.js';
 import type { OfferPreview } from './order-offer-summary.js';
 export type IndividualOrganizationRegistrationInput = {
+    /**
+     * Explicitly saves an owner-private, cardless registration draft.
+     *
+     * This is intended for accessible channels that captured a birth year/date
+     * but could not reliably capture the subject's name. It never authorizes an
+     * Order or public card by itself.
+     */
+    registrationIntent?: 'activate' | 'save-private-draft';
     /**
      * Preferred high-level input produced by `createIndividualOnboardingEditor()`.
      *
@@ -77,8 +85,17 @@ export type IndividualOrganizationRegistrationInput = {
 export type IndividualOrganizationBootstrapInput = IndividualOrganizationRegistrationInput;
 export type IndividualOrganizationRegistrationResult = {
     registration: SubmitAndPollResult;
-    offerId: string;
-    offerPreview: OfferPreview;
+    /**
+     * Owner-private Organization UUID returned by GW for a saved draft.
+     *
+     * It is not a public card identifier or DID and is present only when
+     * `registrationIntent` was `save-private-draft`.
+     */
+    draftId?: string;
+    /** Absent only for an explicitly requested owner-private draft. */
+    offerId?: string;
+    /** Absent only for an explicitly requested owner-private draft. */
+    offerPreview?: OfferPreview;
     /** Lifecycle state returned by GW for this registration receipt. */
     registrationStatus?: FamilyRegistrationStatus;
     /** False when the same family registration is already active. */

package/dist/individual-start.js

@@ -26,7 +26,8 @@ export async function registerIndividualOrganizationWithDeps(deps) {
      * routing/indexing contract for this flow.
      */
     const onboardingDraft = deps.input.onboardingDraft;
-    if (onboardingDraft && !hasSignedPdfEvidence(onboardingDraft)) {
+    const savesPrivateDraft = deps.input.registrationIntent === 'save-private-draft';
+    if (onboardingDraft && !hasSignedPdfEvidence(onboardingDraft) && !savesPrivateDraft) {
         const subjectAlternateName = String(onboardingDraft.formFields.subjectAlternateName
             || onboardingDraft.claims?.[ClaimsOrganizationSchemaorg.alternateName]
             || '').trim();
@@ -35,9 +36,16 @@ export async function registerIndividualOrganizationWithDeps(deps) {
         }
     }
     const alternateName = String(deps.input.alternateName || '').trim();
-    if (!onboardingDraft && !alternateName) {
+    if (!onboardingDraft && !alternateName && !savesPrivateDraft) {
         throw new Error('registerIndividualOrganization requires alternateName.');
     }
+    const draftClaims = {
+        ...(onboardingDraft?.claims || {}),
+        ...(deps.input.additionalClaims || {}),
+    };
+    if (!alternateName && savesPrivateDraft && !hasValidHumanBirthDate(draftClaims)) {
+        throw new Error('registerIndividualOrganization private draft requires a valid birth year or date.');
+    }
     const controllerEmail = String(deps.input.controllerEmail
         || onboardingDraft?.formFields.controllerEmail
         || onboardingDraft?.claims?.[ClaimsOrganizationSchemaorg.ownerEmail]
@@ -99,6 +107,23 @@ export async function registerIndividualOrganizationWithDeps(deps) {
     });
     const registration = await deps.submitAndPoll(deps.individualFamilyOrganizationBatchPath(deps.routeCtx), deps.individualFamilyOrganizationPollPath(deps.routeCtx), registrationPayload, pollOptions);
     deps.assertFirstDidcommEntrySuccess?.(registration, 'registerIndividualOrganization.registration');
+    const registrationSummary = readFamilyOrganizationSummaryFromResponseBody(registration.poll.body);
+    const registrationStatus = registrationSummary?.status;
+    if (savesPrivateDraft) {
+        if (registrationStatus !== 'draft_saved') {
+            throw new Error('registerIndividualOrganization failed: GW did not preserve the requested private draft.');
+        }
+        const draftId = String(registrationSummary?.organizationId || '').trim();
+        if (!draftId) {
+            throw new Error('registerIndividualOrganization failed: GW did not return the private draft id.');
+        }
+        return {
+            registration,
+            registrationStatus,
+            draftId,
+            orderConfirmationRequired: false,
+        };
+    }
     /**
      * Commercial contract for this SDK path:
      * - this helper targets the family/individual commercial bootstrap flow
@@ -112,12 +137,11 @@ export async function registerIndividualOrganizationWithDeps(deps) {
     if (!offerId) {
         throw new Error('registerIndividualOrganization failed: missing offerId in registration response.');
     }
-    const registrationSummary = readFamilyOrganizationSummaryFromResponseBody(registration.poll.body);
     return {
         registration,
         offerId,
         offerPreview: deps.getOfferPreviewFromResponse(registration),
-        registrationStatus: registrationSummary?.status,
+        registrationStatus,
         orderConfirmationRequired: registrationSummary?.status !== 'already_exists',
         identity: readIndividualOrganizationBootstrapIdentity(registration.poll.body, {
             controllerEmail,
@@ -125,6 +149,10 @@ export async function registerIndividualOrganizationWithDeps(deps) {
         }),
     };
 }
+function hasValidHumanBirthDate(claims) {
+    const birthDate = String(claims?.[ClaimsPersonSchemaorg.birthDate] || '').trim();
+    return /^(?:19|20)\d{2}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01]))?)?$/.test(birthDate);
+}
 function canonicalControllerUuid(value) {
     const hexadecimal = normalizeUuid(String(value || '').trim());
     if (!hexadecimal) {

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

@@ -389,7 +389,10 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     /** Lists all individual Organizations owned by one verified account contact. */
     listOwnedFamilyOrganizations(ctx: RouteContext, input: OwnedFamilyOrganizationDirectoryInput): Promise<Readonly<{
         resourceId: string;
-        alternateName: string;
+        alternateName?: string;
+        status?: import("gdc-common-utils-ts").FamilyRegistrationStatus;
+        birthDate?: string;
+        missingFields?: string[];
         claims: Readonly<Record<string, unknown>>;
     }>[]>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "2.9.16",
+  "version": "2.9.17",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",
@@ -38,7 +38,7 @@
     "test:e2e:live-gw:clean": "bash ./scripts/run-live-gw-clean.sh"
   },
   "dependencies": {
-    "gdc-common-utils-ts": "2.9.15",
+    "gdc-common-utils-ts": "2.9.16",
     "gdc-sdk-core-ts": "2.9.10"
   },
   "devDependencies": {