@kaleido-io/workflow-engine-sdk 0.9.2 → 0.9.4

package/dist-esm/src/config/config.js

@@ -13,9 +13,75 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-import { newLogger } from '../log/logger.js';
-import { SDKErrors, newError } from '../i18n/errors.js';
-const log = newLogger('config');
+import * as fs from "fs";
+import * as yaml from "js-yaml";
+import { cfgStrField, cfgStrOrNumAsString, cfgNumField, cfgObjField, parseInboundServerAddressPort, } from "./config_helpers.js";
+import { newLogger } from "../log/logger.js";
+import { SDKErrors, newError } from "../i18n/errors.js";
+/**
+ * Environment variable name for the workflow engine config file path.
+ */
+export const WFE_CONFIG_FILE = "WFE_CONFIG_FILE";
+/**
+ * Config key names
+ */
+export const ConfigWorkflowEngineProviderName = "providerName";
+export const ConfigWorkflowEngineProviderMetadata = "providerMetadata";
+export const ConfigWorkflowEngineUrl = "url";
+export const ConfigWorkflowEngineAuth = "auth";
+export const ConfigWorkflowEngineMaxRetries = "maxRetries";
+export const ConfigWorkflowEngineRetryDelay = "retryDelay";
+export const ConfigWorkflowEngineServer = "server";
+/**
+ * Config key names for server subsection
+ */
+export const ConfigServerAddress = "address";
+export const ConfigServerPort = "port";
+export const ConfigServerReadBufferSize = "readBufferSize";
+export const ConfigServerWriteBufferSize = "writeBufferSize";
+export const ConfigServerHeartbeatInterval = "heartbeatInterval";
+export const ConfigServerThrottleRPS = "requestsPerSecond";
+export const ConfigServerThrottleBurst = "burst";
+export const ConfigServerTls = "tls";
+/**
+ * Config key names for server.tls subsection
+ */
+export const ConfigTlsEnabled = "enabled";
+export const ConfigTlsCaFile = "caFile";
+export const ConfigTlsCertFile = "certFile";
+export const ConfigTlsKeyFile = "keyFile";
+export const ConfigTlsClientAuth = "clientAuth";
+const log = newLogger("config");
+/**
+ * Parse a time string to milliseconds. Supports: ms, s, m, h (e.g. "30s", "100ms", "1m").
+ * Returns NaN if the string is invalid.
+ */
+export function parseTimeStringToMs(value) {
+    const s = value.trim();
+    const match = s.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h)$/i);
+    if (!match)
+        return NaN;
+    const n = parseFloat(match[1]);
+    // Group 2 is always ms|s|m|h when the full pattern matches.
+    const unit = match[2].toLowerCase();
+    return timeStringUnitToMs(n, unit);
+}
+/** @internal exposed for tests — defensive NaN when unit is not ms|s|m|h */
+export function timeStringUnitToMs(n, unitLower) {
+    if (unitLower === "ms") {
+        return n;
+    }
+    if (unitLower === "s") {
+        return n * 1000;
+    }
+    if (unitLower === "m") {
+        return n * 60 * 1000;
+    }
+    if (unitLower === "h") {
+        return n * 60 * 60 * 1000;
+    }
+    return NaN;
+}
 /**
  * Authentication type enum
  */
@@ -41,14 +107,14 @@ export class ConfigLoader {
         // Use discriminated union to handle different auth types
         switch (auth.type) {
             case AuthType.BASIC: {
-                headerName = 'Authorization';
-                const credentials = Buffer.from(`${auth.username}:${auth.password}`).toString('base64');
+                headerName = "Authorization";
+                const credentials = Buffer.from(`${auth.username}:${auth.password}`).toString("base64");
                 authValue = `Basic ${credentials}`;
                 break;
             }
             case AuthType.TOKEN: {
-                headerName = auth.header || 'Authorization';
-                const scheme = auth.scheme || '';
+                headerName = auth.header || "Authorization";
+                const scheme = auth.scheme || "";
                 authValue = scheme ? `${scheme} ${auth.token}` : auth.token;
                 break;
             }
@@ -58,35 +124,179 @@ export class ConfigLoader {
                 throw newError(SDKErrors.MsgSDKConfigUnknownAuthType, _exhaustive.type);
             }
         }
-        // Convert HTTP(S) URL to WebSocket URL with /ws path
-        let wsUrl = config.workflowEngine.url;
-        if (wsUrl.startsWith('http://')) {
-            wsUrl = 'ws://' + wsUrl.substring(7);
-        }
-        else if (wsUrl.startsWith('https://')) {
-            wsUrl = 'wss://' + wsUrl.substring(8);
-        }
-        // Add /ws path if not already present
-        if (!wsUrl.endsWith('/ws')) {
-            wsUrl = wsUrl.replace(/\/$/, '') + '/ws';
-        }
         return {
-            url: wsUrl,
+            url: ConfigLoader.httpUrlToWsUrl(config.workflowEngine.url),
             providerName,
             options: {
                 headers: {
-                    [headerName]: authValue
-                }
+                    [headerName]: authValue,
+                },
             },
             maxAttempts: config.workflowEngine.maxRetries, // undefined = infinite retries
-            reconnectDelay: config.workflowEngine.retryDelay ? parseInt(config.workflowEngine.retryDelay.replace('s', '')) * 1000 : 2000
+            reconnectDelay: ConfigLoader.retryDelayRawToMs(config.workflowEngine.retryDelay),
+        };
+    }
+    /**
+     * Parse retry delay: plain integer (or digits-only string) = seconds; otherwise time string (2s, 100ms, 1m, 1h).
+     * Matches file-loader behavior for inbound/outbound.
+     */
+    static retryDelayRawToMs(raw) {
+        const s = raw?.trim();
+        if (!s) {
+            return 2000;
+        }
+        const ms = parseTimeStringToMs(/^\d+$/.test(s) ? `${s}s` : s);
+        return Number.isNaN(ms) ? 2000 : ms;
+    }
+    /**
+     * Build WebSocket URL from HTTP(S) base URL (add /ws, convert scheme).
+     */
+    static httpUrlToWsUrl(baseUrl) {
+        let wsUrl = baseUrl;
+        if (wsUrl.startsWith("http://")) {
+            wsUrl = "ws://" + wsUrl.substring(7);
+        }
+        else if (wsUrl.startsWith("https://")) {
+            wsUrl = "wss://" + wsUrl.substring(8);
+        }
+        if (!wsUrl.endsWith("/ws")) {
+            wsUrl = wsUrl.replace(/\/$/, "") + "/ws";
+        }
+        return wsUrl;
+    }
+    static retryDelayMsFromSection(section) {
+        return ConfigLoader.retryDelayRawToMs(cfgStrOrNumAsString(section, ConfigWorkflowEngineRetryDelay));
+    }
+    /**
+     * Load WorkflowEngineClientConfig from a YAML file.
+     * Uses WFE_CONFIG_FILE env if configFilePath is not provided.
+     * Only the root key "workflow-engine" is supported in the config file.
+     *
+     * - Outbound: use "url" and "auth"; the app connects to the workflow engine.
+     * - Inbound: use "server" (address, port, etc.); the app creates a WebSocket server and the engine connects to it. Auth is not used.
+     */
+    static loadClientConfigFromFile(configFilePath) {
+        const configPath = (configFilePath ??
+            process.env[WFE_CONFIG_FILE] ??
+            "").trim();
+        if (!configPath) {
+            throw newError(SDKErrors.MsgSDKConfigFileNotSet, WFE_CONFIG_FILE);
+        }
+        const raw = fs.readFileSync(configPath, "utf8");
+        const parsed = yaml.load(raw);
+        if (!parsed || typeof parsed !== "object") {
+            throw newError(SDKErrors.MsgSDKConfigFileInvalid, configPath);
+        }
+        const section = parsed["workflow-engine"];
+        if (!section || typeof section !== "object") {
+            throw newError(SDKErrors.MsgSDKConfigSectionMissing, configPath);
+        }
+        const providerName = cfgStrField(section, ConfigWorkflowEngineProviderName);
+        if (!providerName) {
+            throw newError(SDKErrors.MsgSDKProviderNameNotSet);
+        }
+        const serverSection = cfgObjField(section, ConfigWorkflowEngineServer);
+        const url = cfgStrField(section, ConfigWorkflowEngineUrl) || undefined;
+        const auth = section[ConfigWorkflowEngineAuth];
+        // Inbound: server section only → app creates WebSocket server (no url, no auth)
+        const inbound = !url && serverSection;
+        if (inbound && serverSection) {
+            const addrPort = parseInboundServerAddressPort(serverSection, ConfigServerAddress, ConfigServerPort);
+            if (addrPort) {
+                const tlsSection = cfgObjField(serverSection, ConfigServerTls);
+                const serverConfig = {
+                    address: addrPort.address,
+                    port: addrPort.port,
+                };
+                if (tlsSection && tlsSection[ConfigTlsEnabled] === true) {
+                    serverConfig.tls = ConfigLoader.buildServerTlsFromSection(tlsSection);
+                }
+                const clientConfig = {
+                    server: serverConfig,
+                    providerName,
+                    maxAttempts: cfgNumField(section, ConfigWorkflowEngineMaxRetries),
+                    reconnectDelay: ConfigLoader.retryDelayMsFromSection(section),
+                };
+                ConfigLoader.applyProviderMetadata(clientConfig, section);
+                return clientConfig;
+            }
+        }
+        if (!url) {
+            throw newError(SDKErrors.MsgSDKConfigUrlAuthMissing, configPath);
+        }
+        // Outbound: url + auth → use createClientConfig
+        if (auth && typeof auth === "object") {
+            const engineConfig = {
+                workflowEngine: {
+                    url,
+                    auth,
+                    maxRetries: cfgNumField(section, ConfigWorkflowEngineMaxRetries),
+                    retryDelay: cfgStrOrNumAsString(section, ConfigWorkflowEngineRetryDelay),
+                },
+            };
+            const clientConfig = ConfigLoader.createClientConfig(engineConfig, providerName);
+            ConfigLoader.applyProviderMetadata(clientConfig, section);
+            return clientConfig;
+        }
+        throw newError(SDKErrors.MsgSDKConfigUrlAuthMissing, configPath);
+    }
+    /**
+     * Build server TLS config from server.tls section (for inbound WebSocket server).
+     * Reads caFile, certFile, keyFile and returns { enabled, ca?, cert?, key? }.
+     */
+    static buildServerTlsFromSection(tlsSection) {
+        const certFile = cfgStrField(tlsSection, ConfigTlsCertFile);
+        const keyFile = cfgStrField(tlsSection, ConfigTlsKeyFile);
+        const caFile = cfgStrField(tlsSection, ConfigTlsCaFile);
+        return {
+            enabled: true,
+            ...(caFile && { ca: fs.readFileSync(caFile) }),
+            ...(certFile && { cert: fs.readFileSync(certFile) }),
+            ...(keyFile && { key: fs.readFileSync(keyFile) }),
         };
     }
+    /**
+     * Build WebSocket client TLS options from server.tls config section (outbound client).
+     * Reads caFile, certFile, keyFile and returns options suitable for ws client (ca, cert, key, rejectUnauthorized).
+     */
+    static buildTlsOptionsFromSection(tlsSection) {
+        const opts = {};
+        const caFile = cfgStrField(tlsSection, ConfigTlsCaFile);
+        const certFile = cfgStrField(tlsSection, ConfigTlsCertFile);
+        const keyFile = cfgStrField(tlsSection, ConfigTlsKeyFile);
+        if (caFile) {
+            opts.ca = fs.readFileSync(caFile);
+            opts.rejectUnauthorized = true;
+        }
+        else {
+            opts.rejectUnauthorized = false;
+        }
+        if (certFile)
+            opts.cert = fs.readFileSync(certFile);
+        if (keyFile)
+            opts.key = fs.readFileSync(keyFile);
+        return opts;
+    }
+    static applyProviderMetadata(clientConfig, section) {
+        const metaObj = cfgObjField(section, ConfigWorkflowEngineProviderMetadata);
+        if (!metaObj) {
+            return;
+        }
+        const meta = {};
+        for (const [k, v] of Object.entries(metaObj)) {
+            if (typeof v === "string") {
+                meta[k] = v;
+            }
+        }
+        if (Object.keys(meta).length > 0) {
+            clientConfig.providerMetadata = meta;
+        }
+    }
     /**
      * Log configuration summary (without sensitive data)
      */
     static logConfigSummary(config) {
-        log.info('Configuration loaded:');
+        log.info("Configuration loaded:");
         log.info(`  Workflow Engine: ${config.workflowEngine.url}`);
         const auth = config.workflowEngine.auth;
         switch (auth.type) {
@@ -96,7 +306,7 @@ export class ConfigLoader {
                 break;
             case AuthType.TOKEN:
                 log.info(`  Auth Type: ${AuthType.TOKEN}`);
-                log.info(`  Auth Header: ${auth.header || 'Authorization'}`);
+                log.info(`  Auth Header: ${auth.header || "Authorization"}`);
                 if (auth.scheme) {
                     log.info(`  Auth Scheme: ${auth.scheme}`);
                 }

package/dist-esm/src/config/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/config/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/config/config.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,cAAc,CAAC;AAC/D,MAAM,CAAC,MAAM,oCAAoC,GAAG,kBAAkB,CAAC;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAC7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAAC;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,4DAA4D;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,CAAS,EAAE,SAAiB;IAC7D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACvB,CAAC;IACD,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAyCD;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,MAA4B,EAC5B,YAAoB;QAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QACxC,IAAI,UAAkB,CAAC;QACvB,IAAI,SAAiB,CAAC;QAEtB,yDAAyD;QACzD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpB,UAAU,GAAG,eAAe,CAAC;gBAC7B,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAC7B,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CACpC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACrB,SAAS,GAAG,SAAS,WAAW,EAAE,CAAC;gBACnC,MAAM;YACR,CAAC;YAED,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpB,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;gBAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;gBACjC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC5D,MAAM;YACR,CAAC;YAED,OAAO,CAAC,CAAC,CAAC;gBACR,kEAAkE;gBAClE,MAAM,WAAW,GAAU,IAAI,CAAC;gBAChC,MAAM,QAAQ,CACZ,SAAS,CAAC,2BAA2B,EACpC,WAAmB,CAAC,IAAI,CAC1B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,GAAG,EAAE,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC;YAC3D,YAAY;YACZ,OAAO,EAAE;gBACP,OAAO,EAAE;oBACP,CAAC,UAAU,CAAC,EAAE,SAAS;iBACxB;aACF;YACD,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,+BAA+B;YAC9E,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAC5C,MAAM,CAAC,cAAc,CAAC,UAAU,CACjC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAuB;QAC9C,MAAM,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,IAAI,KAAK,GAAG,OAAO,CAAC;QACpB,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,KAAK,GAAG,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,uBAAuB,CAAC,OAAgC;QAC7D,OAAO,YAAY,CAAC,iBAAiB,CACnC,mBAAmB,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAC7D,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,wBAAwB,CAC7B,cAAuB;QAEvB,MAAM,UAAU,GAAG,CACjB,cAAc;YACd,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YAC5B,EAAE,CACH,CAAC,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,QAAQ,CAAC,SAAS,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAwC,CAAC;QACrE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,QAAQ,CAAC,SAAS,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAE3B,CAAC;QACd,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,QAAQ,CAAC,SAAS,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAC9B,OAAO,EACP,gCAAgC,CACjC,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,QAAQ,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAEvE,MAAM,GAAG,GACP,WAAW,CAAC,OAAO,EAAE,uBAAuB,CAAC,IAAI,SAAS,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,wBAAwB,CAEhC,CAAC;QAEd,gFAAgF;QAChF,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,aAAa,CAAC;QACtC,IAAI,OAAO,IAAI,aAAa,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,6BAA6B,CAC5C,aAAa,EACb,mBAAmB,EACnB,gBAAgB,CACjB,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;gBAC/D,MAAM,YAAY,GAAiB;oBACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;iBACpB,CAAC;gBACF,IAAI,UAAU,IAAI,UAAU,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC;oBACxD,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;gBACxE,CAAC;gBACD,MAAM,YAAY,GAA+B;oBAC/C,MAAM,EAAE,YAAY;oBACpB,YAAY;oBACZ,WAAW,EAAE,WAAW,CACtB,OAAO,EACP,8BAA8B,CAC/B;oBACD,cAAc,EAAE,YAAY,CAAC,uBAAuB,CAAC,OAAO,CAAC;iBAC9D,CAAC;gBACF,YAAY,CAAC,qBAAqB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBAC1D,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,QAAQ,CAAC,SAAS,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC;QAED,gDAAgD;QAChD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,YAAY,GAAyB;gBACzC,cAAc,EAAE;oBACd,GAAG;oBACH,IAAI;oBACJ,UAAU,EAAE,WAAW,CACrB,OAAO,EACP,8BAA8B,CAC/B;oBACD,UAAU,EAAE,mBAAmB,CAC7B,OAAO,EACP,8BAA8B,CAC/B;iBACF;aACF,CAAC;YACF,MAAM,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAClD,YAAY,EACZ,YAAY,CACb,CAAC;YACF,YAAY,CAAC,qBAAqB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,MAAM,QAAQ,CAAC,SAAS,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,yBAAyB,CAAC,UAAmC;QAMlE,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,GAAG,CAAC,OAAO,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;SAClD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,0BAA0B,CAAC,UAAmC;QAMnE,MAAM,IAAI,GAKN,EAAE,CAAC;QACP,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAClC,CAAC;QACD,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAClC,YAAwC,EACxC,OAAgC;QAEhC,MAAM,OAAO,GAAG,WAAW,CACzB,OAAO,EACP,oCAAoC,CACrC,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAA4B;QAClD,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAClC,GAAG,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC;QAE5D,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QACxC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ,CAAC,KAAK;gBACjB,GAAG,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC3C,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ,CAAC,KAAK;gBACjB,GAAG,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC3C,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC;gBAC7D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM;QACV,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}

package/dist-esm/src/config/config_helpers.js

@@ -0,0 +1,61 @@
+// Copyright © 2026 Kaleido, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/** Non-empty trimmed string from record[key], or empty string. */
+export function cfgStrField(rec, key) {
+    const v = rec[key];
+    return typeof v === "string" ? v.trim() : "";
+}
+/** String field; if value is number, coerces to string (e.g. retry delay seconds). */
+export function cfgStrOrNumAsString(rec, key) {
+    const v = rec[key];
+    if (typeof v === "string" && v.trim()) {
+        return v.trim();
+    }
+    if (typeof v === "number" && Number.isFinite(v)) {
+        return String(v);
+    }
+    return undefined;
+}
+/** Finite number from record[key] (number or numeric string), or undefined. */
+export function cfgNumField(rec, key) {
+    const v = rec[key];
+    if (typeof v === "number" && Number.isFinite(v)) {
+        return v;
+    }
+    if (typeof v === "string") {
+        const n = parseInt(v, 10);
+        return Number.isNaN(n) ? undefined : n;
+    }
+    return undefined;
+}
+/** Plain object (not array) at record[key], or undefined. */
+export function cfgObjField(rec, key) {
+    const v = rec[key];
+    if (v != null && typeof v === "object" && !Array.isArray(v)) {
+        return v;
+    }
+    return undefined;
+}
+/** Parsed server address + port for inbound mode; undefined if invalid. */
+export function parseInboundServerAddressPort(server, addressKey, portKey) {
+    const address = cfgStrField(server, addressKey);
+    const port = cfgNumField(server, portKey);
+    if (!address || port === undefined) {
+        return undefined;
+    }
+    return { address, port };
+}
+//# sourceMappingURL=config_helpers.js.map

package/dist-esm/src/config/config_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_helpers.js","sourceRoot":"","sources":["../../../src/config/config_helpers.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAmCjC,kEAAkE;AAClE,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,CAA4B,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,6BAA6B,CAC3C,MAA+B,EAC/B,UAAkB,EAClB,OAAe;IAEf,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist-esm/src/helpers/stage_director.js

@@ -265,7 +265,7 @@ async function execMapped(config, transaction, input) {
         return StageDirectorHelper.mapOutput(input.getStageDirector(), transaction, result, output, error, triggers, extraUpdates, customStage, events);
     }
     catch (error) {
-        log.error(`Handler execution failed:`, error);
+        log.error('Handler execution failed:', error);
         return {
             error: getErrorMessage(error)
         };
@@ -289,7 +289,7 @@ async function execBatchMapped(config, transactions) {
         });
     }
     catch (error) {
-        log.error(`Batch handler execution failed:`, error);
+        log.error('Batch handler execution failed:', error);
         return transactions.map(() => ({
             error: getErrorMessage(error)
         }));

package/dist-esm/src/i18n/errors.js

@@ -27,7 +27,7 @@ export const SDKErrors = {
     MsgSDKObservedPanic: fe('KA140600', 'Observed panic: %s'),
     MsgSDKUnknownHandler: fe('KA140601', "Unknown handler '%s'"),
     MsgSDKUnknownNoListenerConfig: fe('KA140602', "Listener config for stream '%s' not supplied by workflow engine"),
-    MsgSDKOutputSerializationError: fe('KA140603', "Unable to serialize output to %s"),
+    MsgSDKOutputSerializationError: fe('KA140603', 'Unable to serialize output to %s'),
     MsgSDKDirectorNextStageMissing: fe('KA140604', "Handler called with 'nextStage' missing from input"),
     MsgSDKDirectorOutputPathMissing: fe('KA140605', "Handler called with 'outputPath' missing from input"),
     MsgSDKDirectorFailureStageMissing: fe('KA140606', "Handler resulted in a failure, but 'failureStage' missing from input"),
@@ -40,8 +40,8 @@ export const SDKErrors = {
     MsgSDKCheckpointInvalid: fe('KA140612', "Checkpoint generated by handler '%s' cannot be serialized"),
     MsgSDKEventSourceDataInvalid: fe('KA140613', "Event source data could not be serialized for handler '%s'"),
     // Engine API errors
-    MsgSDKEngineReplyInvalidData: fe('KA140614', "Engine API reply for transaction %s invalid: %s"),
-    MsgSDKEngineReplyInvalidType: fe('KA140615', "Engine API reply type for transaction %s invalid: %s"),
+    MsgSDKEngineReplyInvalidData: fe('KA140614', 'Engine API reply for transaction %s invalid: %s'),
+    MsgSDKEngineReplyInvalidType: fe('KA140615', 'Engine API reply type for transaction %s invalid: %s'),
     MsgSDKEngineReqNoActiveRequest: fe('KA140616', 'No engine handler is active on the supplied context'),
     MsgSDKEngineFailMarshalEngineRequest: fe('KA140617', 'Failed to marshal engine transaction data'),
     MsgSDKEngineFailSendEngineRequest: fe('KA140618', 'Failed to send engine transaction'),
@@ -61,6 +61,11 @@ export const SDKErrors = {
     MsgSDKMissingActionField: fe('KA140629', 'Input is missing required "action" field in stage %s. Available fields: %s'),
     // Configuration validation errors
     MsgSDKConfigUnknownAuthType: fe('KA140626', 'Unknown auth type: %s'),
+    MsgSDKConfigFileNotSet: fe('KA140635', 'Workflow engine config file not set: pass a config file or set %s'),
+    MsgSDKConfigFileInvalid: fe('KA140636', 'Invalid workflow engine config file: %s'),
+    MsgSDKConfigSectionMissing: fe('KA140637', 'Missing "workflow-engine" section in %s'),
+    MsgSDKConfigUrlAuthMissing: fe('KA140638', 'Missing url or auth in workflow-engine section in %s'),
+    MsgSDKHandlerInvalidType: fe('KA140639', 'Handler "%s" does not implement TransactionHandler, EventSource, or EventProcessor'),
     // Engine connection errors
     MsgSDKEngineNotConnected: fe('KA140627', 'WebSocket is not connected. Cannot submit async transactions'),
 };

package/dist-esm/src/i18n/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/i18n/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/i18n/errors.ts"],"names":[],"mappings":"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"}

package/dist-esm/src/index.js

@@ -21,7 +21,8 @@
 // ============================================================================
 export { WorkflowEngineClient, } from './client/client.js';
 export { WorkflowEngineRestClient, } from './client/rest-client.js';
-export { ConfigLoader, } from './config/config.js';
+export { ConfigLoader, WFE_CONFIG_FILE, } from './config/config.js';
+export { HandlerSetFor, NewWorkflowEngineClient, } from './client/client_factory.js';
 export { newLogger } from './log/logger.js';
 // ============================================================================
 // Core Types & Interfaces

package/dist-esm/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAGjC;;GAEG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,GAErB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,GASzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAEtC,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,8BAA8B;AAC9B,OAAO,EACL,6BAA6B,GAE9B,MAAM,iCAAiC,CAAC;AAEzC,uBAAuB;AACvB,OAAO,EACL,cAAc,GAQf,MAAM,0BAA0B,CAAC;AAElC,yBAAyB;AACzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,gBAAgB;AAChB,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,+EAA+E;AAE/E,uBAAuB;AACvB,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,GACP,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,cAAc,cAAc,CAAC;AAE7B,cAAc,eAAe,CAAC;AAI9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,sCAAsC;AACtC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC;;GAEG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EACL,oBAAoB,GAIrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,GASzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,YAAY,EACZ,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,aAAa,EACb,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAEtC,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,8BAA8B;AAC9B,OAAO,EACL,6BAA6B,GAE9B,MAAM,iCAAiC,CAAC;AAEzC,uBAAuB;AACvB,OAAO,EACL,cAAc,GAQf,MAAM,0BAA0B,CAAC;AAElC,yBAAyB;AACzB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,gBAAgB;AAChB,cAAc,iBAAiB,CAAC;AAEhC,YAAY;AACZ,+EAA+E;AAE/E,uBAAuB;AACvB,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,MAAM,EACN,MAAM,EACN,MAAM,GACP,MAAM,eAAe,CAAC;AAEvB,SAAS;AACT,cAAc,cAAc,CAAC;AAE7B,cAAc,eAAe,CAAC;AAI9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist-esm/src/runtime/handler_runtime.js

@@ -13,6 +13,7 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+import https from 'https';
 import WebSocket, { WebSocketServer } from 'ws';
 import { backOff } from 'exponential-backoff';
 import { WSMessageType, WSHandlerType, } from '../types/core.js';
@@ -30,6 +31,11 @@ export var HandlerRuntimeMode;
     HandlerRuntimeMode["OUTBOUND"] = "outbound";
     HandlerRuntimeMode["INBOUND"] = "inbound";
 })(HandlerRuntimeMode || (HandlerRuntimeMode = {}));
+/** Default listen port for inbound WebSocket server when `server.port` is omitted. */
+export const DEFAULT_INBOUND_WS_PORT = 6000;
+export function resolveInboundListenPort(port) {
+    return port ?? DEFAULT_INBOUND_WS_PORT;
+}
 /**
  * Internal runtime that manages WebSocket connection and handler lifecycle.
  */
@@ -42,7 +48,12 @@ export class HandlerRuntime {
         this.eventProcessors = new Map();
         this.isConnected = false;
         this.shouldReconnect = true;
-        if (process.env.WORKFLOW_ENGINE_MODE === 'inbound') {
+        if (config.server) {
+            this.mode = HandlerRuntimeMode.INBOUND;
+            this.port = config.server.port;
+            this.serverConfig = config.server;
+        }
+        else if (process.env.WORKFLOW_ENGINE_MODE === 'inbound') {
             this.mode = HandlerRuntimeMode.INBOUND;
             if (!process.env.WEBSOCKET_PORT) {
                 throw newError(SDKErrors.MsgSDKWebSocketPortRequiredInbound);
@@ -135,6 +146,10 @@ export class HandlerRuntime {
         if (this.wsServer) {
             this.wsServer.close();
         }
+        if (this.inboundHttpsServer) {
+            this.inboundHttpsServer.close();
+            this.inboundHttpsServer = undefined;
+        }
         for (const [name, handler] of this.transactionHandlers.entries()) {
             handler.close();
             log.debug('Closed transaction handler', { name });
@@ -187,7 +202,28 @@ export class HandlerRuntime {
     // WebSocket Connection Management
     // ============================================================================
     createWebSocketServer() {
-        this.wsServer = new WebSocketServer({ port: this.port });
+        const port = resolveInboundListenPort(this.port);
+        const address = this.serverConfig?.address ?? '0.0.0.0';
+        const tls = this.serverConfig?.tls;
+        if (tls?.enabled && tls.cert && tls.key) {
+            const httpsOptions = {
+                cert: tls.cert,
+                key: tls.key,
+            };
+            if (tls.ca) {
+                httpsOptions.ca = tls.ca;
+            }
+            const httpsServer = https.createServer(httpsOptions);
+            this.inboundHttpsServer = httpsServer;
+            httpsServer.listen(port, address, () => {
+                log.info('WebSocket server (TLS) listening', { address, port, provider: this.config.providerName });
+            });
+            this.wsServer = new WebSocketServer({ server: httpsServer });
+        }
+        else {
+            this.wsServer = new WebSocketServer({ port, host: address });
+            log.info('WebSocket server listening', { address, port, provider: this.config.providerName });
+        }
         this.wsServer.on('connection', (ws, req) => {
             log.info('WebSocket server connection', { remoteAddress: req.socket.remoteAddress, remotePort: req.socket.remotePort });
             this.ws = ws;