gdc-sdk-node-ts 2.1.0 → 2.1.1

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

@@ -70,6 +70,7 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     private readonly requestTimeoutMs;
     private readonly httpTraceFile?;
     private readonly tokenCache;
+    private warnedDefaultHostNetwork;
     /**
      * @param options.baseUrl Gateway base URL without trailing slash.
      * @param options.interopMode Optional runtime interoperability mode from the SDK config layer (`demo`, `compat`, `strict`).
@@ -432,18 +433,19 @@ export declare class HttpRuntimeClient implements NodeRuntimeClient {
     private wrapBundleAsGatewayTransactionMessage;
     private hostRegistryPath;
     /**
-     * Resolves the host route segment without forcing callers to remember whether
-     * the same raw string is named `hostNetwork` or `sector` in a given layer.
+     * Resolves the host route segment without allowing tenant-route `sector`
+     * semantics to leak into host onboarding.
      *
      * Step by step:
      * - host routes use `/host/cds-{jurisdiction}/v1/{host-network}`
      * - tenant routes use `/{tenantId}/cds-{jurisdiction}/v1/{tenant-sector}`
-     * - older live tests and adapters sometimes passed the host segment under
-     *   `sector`, which is semantically wrong for host routes
-     * - new code should prefer `hostNetwork`
-     * - compatibility code may pass `hostNetworkOrTenantSector`
+     * - passing the host segment under `sector` is rejected because that name is
+     *   reserved for tenant business sectors such as `health-care`
+     * - compatibility code may still pass `hostNetworkOrTenantSector`, but the
+     *   value must still be one of the allowed host runtime/network selectors
      */
     private requireHostRouteContext;
+    private isSupportedHostNetwork;
     hostRegistryOrganizationTransactionPath(ctx?: HostRouteContext): string;
     hostRegistryOrganizationTransactionPollPath(ctx?: HostRouteContext): string;
     hostRegistryOrganizationIssuePath(ctx?: HostRouteContext): string;

package/dist/node-runtime-client.js

@@ -41,6 +41,7 @@ export class HttpRuntimeClient {
      */
     constructor(options) {
         this.tokenCache = new Map();
+        this.warnedDefaultHostNetwork = false;
         this.baseUrl = String(options.baseUrl || '').replace(/\/+$/, '');
         this.runtimeVpToken = String(options.runtimeVpToken || '').trim() || undefined;
         this.bearerToken = String(options.bearerToken || '').trim()
@@ -913,32 +914,52 @@ export class HttpRuntimeClient {
         return `/host/cds-${encodeURIComponent(hostCtx.jurisdiction)}/v1/${encodeURIComponent(hostCtx.hostNetwork || '')}/registry/org.schema/${encodeURIComponent(resourceType)}/${encodeURIComponent(action)}`;
     }
     /**
-     * Resolves the host route segment without forcing callers to remember whether
-     * the same raw string is named `hostNetwork` or `sector` in a given layer.
+     * Resolves the host route segment without allowing tenant-route `sector`
+     * semantics to leak into host onboarding.
      *
      * Step by step:
      * - host routes use `/host/cds-{jurisdiction}/v1/{host-network}`
      * - tenant routes use `/{tenantId}/cds-{jurisdiction}/v1/{tenant-sector}`
-     * - older live tests and adapters sometimes passed the host segment under
-     *   `sector`, which is semantically wrong for host routes
-     * - new code should prefer `hostNetwork`
-     * - compatibility code may pass `hostNetworkOrTenantSector`
+     * - passing the host segment under `sector` is rejected because that name is
+     *   reserved for tenant business sectors such as `health-care`
+     * - compatibility code may still pass `hostNetworkOrTenantSector`, but the
+     *   value must still be one of the allowed host runtime/network selectors
      */
     requireHostRouteContext(ctx) {
         const hostCtx = (ctx || {});
         const runtimeCtx = (this.ctx || {});
         const jurisdiction = String(hostCtx.jurisdiction || this.ctx?.jurisdiction || '').trim();
-        const hostNetwork = String(hostCtx.hostNetwork
-            || hostCtx.hostNetworkOrTenantSector
-            || hostCtx.sector
-            || runtimeCtx.hostNetwork
+        const explicitHostNetwork = String(hostCtx.hostNetwork || runtimeCtx.hostNetwork || '').trim();
+        const compatibilityHostNetwork = String(hostCtx.hostNetworkOrTenantSector
             || runtimeCtx.hostNetworkOrTenantSector
-            || runtimeCtx.sector
             || '').trim();
-        if (!jurisdiction || !hostNetwork)
+        const deprecatedSector = String(hostCtx.sector || '').trim();
+        if (!explicitHostNetwork && !compatibilityHostNetwork && deprecatedSector) {
+            throw new Error(`Host route context must use 'hostNetwork', not 'sector'. Received deprecated sector='${deprecatedSector}'.`);
+        }
+        const hostNetwork = String(explicitHostNetwork
+            || compatibilityHostNetwork
+            || '').trim();
+        if (!jurisdiction)
             throw new Error('Host route context is required.');
+        if (!hostNetwork) {
+            if (!this.warnedDefaultHostNetwork) {
+                this.warnedDefaultHostNetwork = true;
+                console.warn("[gdc-sdk-node-ts] Missing hostNetwork in host route context. Defaulting to 'test'. Pass hostNetwork explicitly to avoid environment drift.");
+            }
+            return { jurisdiction, hostNetwork: 'test' };
+        }
+        if (!this.isSupportedHostNetwork(hostNetwork)) {
+            throw new Error(`Invalid hostNetwork '${hostNetwork}'. Allowed values: test, local-network, test-network, network.`);
+        }
         return { jurisdiction, hostNetwork };
     }
+    isSupportedHostNetwork(value) {
+        return (value === 'test'
+            || value === 'local-network'
+            || value === 'test-network'
+            || value === 'network');
+    }
     hostRegistryOrganizationTransactionPath(ctx) { return this.hostRegistryPath(ctx, 'Organization', GwCoreLifecycleAction.Transaction); }
     hostRegistryOrganizationTransactionPollPath(ctx) { return this.hostRegistryPath(ctx, 'Organization', GwCoreLifecycleAction.TransactionResponse); }
     hostRegistryOrganizationIssuePath(ctx) { return this.hostRegistryPath(ctx, 'Organization', GwCoreLifecycleAction.Issue); }

package/package.json

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