gdc-sdk-node-ts 2.9.9 → 2.9.11

package/README.md

@@ -686,8 +686,8 @@ modules below.
   - types: `IndividualOrganizationBootstrapInput`, `OfferPreview`, `IndividualOrganizationStartResult`
   - function: `registerIndividualOrganizationWithDeps(...)`
 - [`src/individual-onboarding.ts`](src/individual-onboarding.ts)
-  - types: `RouteContext`, `IndividualOrganizationConfirmOrderInput`
-  - function: `confirmIndividualOrganizationOrderWithDeps(...)`
+  - types: `RouteContext`, `IndividualOrganizationConfirmOrderInput`, `IndividualOrganizationOrderResult`
+  - functions: `confirmIndividualOrganizationOrderWithDeps(...)`, `readIndividualOrganizationControllerAssignmentIdentifier(...)`
 - [`src/device-activation.ts`](src/device-activation.ts)
   - types: `EmployeeDeviceActivationInput`, `EmployeeDeviceActivationRequestInput`, `EmployeeDeviceActivationResult`
   - functions: `activateEmployeeDeviceWithActivationCodeWithDeps(...)`, `activateEmployeeDeviceWithActivationRequestWithDeps(...)`

package/dist/individual-onboarding.d.ts

@@ -27,6 +27,17 @@ export type IndividualOrganizationConfirmOrderInput = {
  */
 export type IndividualOrganizationOrderResult = SubmitAndPollResult & Readonly<{
     activationCode: string;
+    /**
+     * Governed `RelatedPerson.identifier` automatically materialized by GW for
+     * the principal Organization owner/controller. Current GW values use the
+     * `urn:uuid:<UUID>` form.
+     */
+    controllerRelatedPersonIdentifier: string;
+    /**
+     * @deprecated Use `controllerRelatedPersonIdentifier`, which states the
+     * resource represented by this identifier.
+     */
+    controllerAssignmentIdentifier: string;
 }>;
 type ConfirmIndividualOrganizationOrderDeps = {
     input: IndividualOrganizationConfirmOrderInput;
@@ -46,4 +57,11 @@ export declare function confirmIndividualOrganizationOrderWithDeps(deps: Confirm
  * this reader directly; it remains public for response-adapter compatibility.
  */
 export declare function readIndividualOrganizationActivationCode(responseBody: unknown): string | undefined;
+/**
+ * Reads the principal owner/controller assignment that GW creates during the
+ * same Order transition as the individual controller licence. This is a
+ * projection from the returned RelatedPerson `resource.meta.claims`; it is not
+ * an Order claim and callers must not pre-create or search for it.
+ */
+export declare function readIndividualOrganizationControllerAssignmentIdentifier(responseBody: unknown): string | undefined;
 export {};

package/dist/individual-onboarding.js

@@ -1,5 +1,5 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
-import { extractPrimaryClaims } from 'gdc-common-utils-ts';
+import { HealthcareActorRoleCodes, HL7_CODING_SYSTEM_V3_ROLE_CODE, extractPrimaryClaims, readRelatedPersonListRecords, } from 'gdc-common-utils-ts';
 import { resolvePollOptionsFromSeconds } from './poll-options.js';
 export async function confirmIndividualOrganizationOrderWithDeps(deps) {
     /**
@@ -40,7 +40,16 @@ export async function confirmIndividualOrganizationOrderWithDeps(deps) {
     if (!activationCode) {
         throw new Error('confirmIndividualOrganizationOrder failed: missing controller activation code in GW Order response.');
     }
-    return { ...order, activationCode };
+    const controllerAssignmentIdentifier = readIndividualOrganizationControllerAssignmentIdentifier(order.poll.body);
+    if (!controllerAssignmentIdentifier) {
+        throw new Error('confirmIndividualOrganizationOrder failed: missing automatic controller RESPRSN assignment in GW Order response.');
+    }
+    return {
+        ...order,
+        activationCode,
+        controllerRelatedPersonIdentifier: controllerAssignmentIdentifier,
+        controllerAssignmentIdentifier,
+    };
 }
 /**
  * Reads the opaque controller activation code from a completed individual
@@ -51,6 +60,20 @@ export function readIndividualOrganizationActivationCode(responseBody) {
     const claims = extractPrimaryClaims(responseBody);
     return String(claims['org.schema.IndividualProduct.serialNumber'] || '').trim() || undefined;
 }
+/**
+ * Reads the principal owner/controller assignment that GW creates during the
+ * same Order transition as the individual controller licence. This is a
+ * projection from the returned RelatedPerson `resource.meta.claims`; it is not
+ * an Order claim and callers must not pre-create or search for it.
+ */
+export function readIndividualOrganizationControllerAssignmentIdentifier(responseBody) {
+    const expectedRelationship = `${HL7_CODING_SYSTEM_V3_ROLE_CODE}|${HealthcareActorRoleCodes.Controller}`;
+    return readRelatedPersonListRecords(responseBody)
+        .find((record) => record.identifier
+        && record.relationship === expectedRelationship
+        && record.active !== 'false')
+        ?.identifier;
+}
 function createRuntimeUuid() {
     const fromCrypto = globalThis.crypto?.randomUUID?.();
     if (fromCrypto) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-sdk-node-ts",
-  "version": "2.9.9",
+  "version": "2.9.11",
   "description": "Next-generation Node runtime package for the GDC SDK family",
   "license": "Apache-2.0",
   "author": "Antifraud Services Inc.",