gdc-sdk-node-ts 2.4.30 → 2.4.32

package/README.md

@@ -649,7 +649,7 @@ modules below.
   - functions: `createOrganizationEmployeeWithDeps(...)`, `importIpsOrFhirAndUpdateIndexWithDeps(...)`, `upsertRelatedPersonAndPollWithDeps(...)`, `ingestCommunicationAndUpdateIndexWithDeps(...)`, `searchClinicalBundleWithDeps(...)`, `searchLatestIpsWithDeps(...)`, `grantProfessionalAccessWithDeps(...)`, `setDigitalTwinSecondaryUseConsentWithDeps(...)`, `purgeDigitalTwinSubjectLinkWithDeps(...)`
 - [`src/digital-twin.ts`](src/digital-twin.ts)
   - types: `DigitalTwinSearchInput`, `DigitalTwinSelectionInput`, `DigitalTwinResearchTag`, `DigitalTwinMaterializationInput`
-  - functions: `searchDigitalTwinsWithDeps(...)`, `saveDigitalTwinSelectionWithDeps(...)`, `materializeDigitalTwinWithDeps(...)`
+  - functions: `createDigitalTwinSecondaryUseConsentIdentifier()`, `searchDigitalTwinsWithDeps(...)`, `saveDigitalTwinSelectionWithDeps(...)`, `materializeDigitalTwinWithDeps(...)`
 - [`src/orchestration/digital-twin-sdk.ts`](src/orchestration/digital-twin-sdk.ts)
   - class: `DigitalTwinSdk` (`requestSmartToken`, `search`, `saveSelection`, `materialize`)
 - [`src/session.ts`](src/session.ts)

package/dist/digital-twin.d.ts

@@ -3,6 +3,14 @@ import type { MetaTagCoding } from 'gdc-common-utils-ts/models/confidential-stor
 import type { RouteContext } from './individual-onboarding.js';
 import type { PollOptions, SubmitAndPollResult } from './orchestration/client-port.js';
 export type DigitalTwinFhirFormat = 'org.hl7.fhir.r4' | 'org.hl7.fhir.api';
+/**
+ * Creates the opaque FHIR identifier for the provider-level secondary-use
+ * Consent. Call this exactly once when the server creates the subject's index
+ * enrollment, persist the result there, and reuse it for every permit/deny.
+ * It is intentionally random and must not be derived from a subject or tenant
+ * identifier.
+ */
+export declare function createDigitalTwinSecondaryUseConsentIdentifier(): string;
 /** Returns whether a value can be used as a pseudonymous digital-twin subject. */
 export declare function isDigitalTwinSubjectId(value: unknown): value is string;
 /** Rejects operational DIDs and malformed or caller-invented subject shapes. */

package/dist/digital-twin.js

@@ -3,6 +3,16 @@ import { randomUUID } from 'node:crypto';
 import { HealthcareDocumentTypes } from 'gdc-common-utils-ts/constants';
 import { CompositionClaim } from 'gdc-common-utils-ts/models';
 const DIGITAL_TWIN_SUBJECT_URN_UUID = /^urn:uuid:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Creates the opaque FHIR identifier for the provider-level secondary-use
+ * Consent. Call this exactly once when the server creates the subject's index
+ * enrollment, persist the result there, and reuse it for every permit/deny.
+ * It is intentionally random and must not be derived from a subject or tenant
+ * identifier.
+ */
+export function createDigitalTwinSecondaryUseConsentIdentifier() {
+    return `urn:uuid:${randomUUID()}`;
+}
 /** Returns whether a value can be used as a pseudonymous digital-twin subject. */
 export function isDigitalTwinSubjectId(value) {
     return DIGITAL_TWIN_SUBJECT_URN_UUID.test(String(value || '').trim());

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

@@ -128,7 +128,9 @@ export declare class IndividualControllerSdk {
     /**
      * Enables or disables the subject's secondary-use digital-twin projection.
      * This is the canonical patient-side operation; application code must not
-     * publish a canonical Composition directly into the research index.
+     * publish a canonical Composition directly into the research index. The
+     * caller reuses the server-owned identifier created once with
+     * `createDigitalTwinSecondaryUseConsentIdentifier()` during index enrollment.
      */
     setDigitalTwinSecondaryUseConsent(ctx: RouteContext, input: DigitalTwinSecondaryUseConsentInput): Promise<DigitalTwinSecondaryUseConsentResult>;
     /**

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

@@ -191,7 +191,9 @@ export class IndividualControllerSdk {
     /**
      * Enables or disables the subject's secondary-use digital-twin projection.
      * This is the canonical patient-side operation; application code must not
-     * publish a canonical Composition directly into the research index.
+     * publish a canonical Composition directly into the research index. The
+     * caller reuses the server-owned identifier created once with
+     * `createDigitalTwinSecondaryUseConsentIdentifier()` during index enrollment.
      */
     setDigitalTwinSecondaryUseConsent(ctx, input) {
         assertFacadeCapability(this.capabilities, ActorCapabilities.IndividualGenerateDigitalTwin, ActorKinds.IndividualController, 'setDigitalTwinSecondaryUseConsent');

package/dist/resource-operations.d.ts

@@ -507,7 +507,11 @@ export type DigitalTwinSecondaryUseConsentInput = {
     /** Organization/tenant that provides and stores the subject's index. */
     indexProviderOrganizationDid: string;
     decision: 'permit' | 'deny';
-    /** Server-owned FHIR Consent identifier. Never accept it from the browser. */
+    /**
+     * Server-owned FHIR Consent identifier. Create it once with
+     * `createDigitalTwinSecondaryUseConsentIdentifier()` in the index-enrollment
+     * transaction, persist it there and never accept it from the browser.
+     */
     consentIdentifier: string;
     consentDate?: string;
     dataType?: string;

package/package.json

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