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

package/dist/src/utils/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../../src/utils/patch.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,+DAAiD;AACjD,wCAA4D;AAE5D,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC;AAE9B,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,KAAY,EAAE,EAAE;IACpD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,KAAkC,CAAC,CAAC;IACxF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAPW,QAAA,KAAK,SAOhB;AAEF,gCAAgC;AACzB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAc,EAAW,EAAE,CAAC,CAAC;IAC/D,EAAE,EAAE,kBAAW,CAAC,GAAG;IACnB,IAAI;IACJ,KAAK;CACN,CAAC,CAAC;AAJU,QAAA,KAAK,SAIf;AAEI,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC;IAClD,EAAE,EAAE,kBAAW,CAAC,MAAM;IACtB,IAAI;CACL,CAAC,CAAC;AAHU,QAAA,QAAQ,YAGlB;AAEI,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAc,EAAW,EAAE,CAAC,CAAC;IACnE,EAAE,EAAE,kBAAW,CAAC,OAAO;IACvB,IAAI;IACJ,KAAK;CACN,CAAC,CAAC;AAJU,QAAA,SAAS,aAInB;AAEI,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAY,EAAW,EAAE,CAAC,CAAC;IAC9D,EAAE,EAAE,kBAAW,CAAC,IAAI;IACpB,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAJU,QAAA,MAAM,UAIhB;AAEI,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAY,EAAW,EAAE,CAAC,CAAC;IAC9D,EAAE,EAAE,kBAAW,CAAC,IAAI;IACpB,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAJU,QAAA,MAAM,UAIhB;AAEI,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,KAAc,EAAW,EAAE,CAAC,CAAC;IAChE,EAAE,EAAE,kBAAW,CAAC,IAAI;IACpB,IAAI;IACJ,KAAK;CACN,CAAC,CAAC;AAJU,QAAA,MAAM,UAIhB"}

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

@@ -0,0 +1,54 @@
+// 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.
+import { HandlerRuntime } from '../runtime/handler_runtime.js';
+export class WorkflowEngineClient {
+    constructor(config) {
+        const runtimeConfig = {
+            url: config.url,
+            providerName: config.providerName,
+            providerMetadata: config.providerMetadata,
+            authToken: config.authToken,
+            authHeaderName: config.authHeaderName,
+            headers: config.headers,
+            options: config.options,
+            reconnectDelay: config.reconnectDelay,
+            maxAttempts: config.maxAttempts,
+        };
+        this.runtime = new HandlerRuntime(runtimeConfig);
+    }
+    registerTransactionHandler(name, handler) {
+        this.runtime.registerTransactionHandler(name, handler);
+    }
+    registerEventSource(name, handler) {
+        this.runtime.registerEventSource(name, handler);
+    }
+    registerEventProcessor(name, handler) {
+        this.runtime.registerEventProcessor(name, handler);
+    }
+    async connect() {
+        await this.runtime.start();
+    }
+    disconnect() {
+        this.runtime.stop();
+    }
+    close() {
+        this.disconnect();
+    }
+    isConnected() {
+        return this.runtime.isWebSocketConnected();
+    }
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/client.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,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAelF,MAAM,OAAO,oBAAoB;IAG/B,YAAY,MAAkC;QAC5C,MAAM,aAAa,GAAyB;YAC1C,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B,CAAC,IAAY,EAAE,OAA2B;QAClE,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,mBAAmB,CAAC,IAAY,EAAE,OAAoB;QACpD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,sBAAsB,CAAC,IAAY,EAAE,OAAuB;QAC1D,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,UAAU;QACR,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist-esm/src/client/rest-client.js

@@ -0,0 +1,238 @@
+// 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.
+/**
+ * REST Client for Workflow Engine API
+ *
+ * Provides methods to interact with the workflow engine REST API including:
+ * - Workflow management (create, delete)
+ * - Transaction management (create, delete)
+ * - Stream management (create, delete, start, stop)
+ */
+import { newError, SDKErrors } from '../i18n/errors.js';
+/**
+ * REST Client for Workflow Engine API
+ */
+export class WorkflowEngineRestClient {
+    constructor(config) {
+        // Build base URL from environment variables if not provided
+        if (!config?.url) {
+            if (!process.env.ACCOUNT) {
+                throw newError(SDKErrors.MsgSDKAccountNotSet);
+            }
+            if (!process.env.ENVIRONMENT) {
+                throw newError(SDKErrors.MsgSDKEnvironmentNotSet);
+            }
+            if (!process.env.WORKFLOW_ENGINE) {
+                throw newError(SDKErrors.MsgSDKWorkflowEngineNotSet);
+            }
+            this.baseUrl = `https://${process.env.ACCOUNT}/endpoint/${process.env.ENVIRONMENT}/${process.env.WORKFLOW_ENGINE}/rest`;
+        }
+        else {
+            let restUrl = config.url.replace(/\/ws$/, '');
+            if (!restUrl.endsWith('/rest')) {
+                restUrl += '/rest';
+            }
+            if (restUrl.startsWith('ws://')) {
+                restUrl = restUrl.replace('ws://', 'http://');
+            }
+            else if (config.url.startsWith('wss://')) {
+                restUrl = restUrl.replace('wss://', 'https://');
+            }
+            this.baseUrl = restUrl;
+        }
+        if (!config?.authToken) {
+            if (process.env.KEY_NAME && process.env.KEY_VALUE) {
+                this.authToken = `basic ${Buffer.from(`${process.env.KEY_NAME}:${process.env.KEY_VALUE}`).toString('base64')}`;
+            }
+        }
+        else {
+            this.authToken = config?.authToken;
+        }
+        this.authHeaderName = config?.authHeaderName || 'Authorization';
+        this.headers = config?.headers;
+    }
+    /**
+     * Gets the full REST API endpoint URL for workflows
+     */
+    getWorkflowsEndpoint() {
+        return `${this.baseUrl}/api/v1/workflows`;
+    }
+    /**
+     * Gets the full REST API endpoint URL for a specific workflow
+     */
+    getWorkflowEndpoint(workflowNameOrId) {
+        return `${this.baseUrl}/api/v1/workflows/${encodeURIComponent(workflowNameOrId)}`;
+    }
+    /**
+     * Gets the full REST API endpoint URL for transactions
+     */
+    getTransactionsEndpoint() {
+        return `${this.baseUrl}/api/v1/transactions`;
+    }
+    /**
+     * Gets the full REST API endpoint URL for a specific transaction
+     */
+    getTransactionEndpoint(idempotencyKeyOrId) {
+        return `${this.baseUrl}/api/v1/transactions/${encodeURIComponent(idempotencyKeyOrId)}`;
+    }
+    /**
+     * Gets the full REST API endpoint URL for streams
+     */
+    getStreamsEndpoint() {
+        return `${this.baseUrl}/api/v1/streams`;
+    }
+    /**
+     * Gets the full REST API endpoint URL for a specific stream
+     */
+    getStreamEndpoint(streamNameOrId) {
+        return `${this.baseUrl}/api/v1/streams/${encodeURIComponent(streamNameOrId)}`;
+    }
+    /**
+     * Makes an HTTP request with proper error handling
+     */
+    async makeRequest(url, method, body, timeout) {
+        const headers = {
+            'accept': 'application/json',
+            'Content-Type': 'application/json',
+            ...this.headers,
+        };
+        if (timeout) {
+            headers['Request-Timeout'] = `${timeout}m0s`;
+        }
+        // Add authorization if credentials are available
+        if (this.authToken) {
+            headers[this.authHeaderName] = this.authToken;
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Failed to ${method} ${url}: ${response.status} ${response.statusText}\n${errorText}`);
+        }
+        // Handle 204 No Content responses
+        if (response.status === 204) {
+            return undefined;
+        }
+        return (await response.json());
+    }
+    // ============================================================================
+    // Workflow Methods
+    // ============================================================================
+    /**
+     * Creates a new workflow
+     *
+     * @param workflow - The workflow definition
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise resolving to the created workflow
+     */
+    async createWorkflow(workflow, timeout) {
+        const endpoint = this.getWorkflowsEndpoint();
+        return this.makeRequest(endpoint, 'POST', workflow, timeout);
+    }
+    /**
+     * Deletes a workflow by name or ID
+     *
+     * @param workflowNameOrId - The name or ID of the workflow to delete
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise that resolves when the workflow is deleted
+     */
+    async deleteWorkflow(workflowNameOrId, timeout) {
+        const endpoint = this.getWorkflowEndpoint(workflowNameOrId);
+        return this.makeRequest(endpoint, 'DELETE', undefined, timeout);
+    }
+    // ============================================================================
+    // Transaction Methods
+    // ============================================================================
+    /**
+     * Creates a new transaction
+     *
+     * @param transaction - The transaction request
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise resolving to the transaction response
+     */
+    async createTransaction(transaction, timeout) {
+        const endpoint = this.getTransactionsEndpoint();
+        return this.makeRequest(endpoint, 'POST', transaction, timeout);
+    }
+    /**
+     * Deletes a transaction by idempotency key or ID
+     *
+     * @param idempotencyKeyOrId - The idempotency key or ID of the transaction to delete
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise that resolves when the transaction is deleted
+     */
+    async deleteTransaction(idempotencyKeyOrId, timeout) {
+        const endpoint = this.getTransactionEndpoint(idempotencyKeyOrId);
+        return this.makeRequest(endpoint, 'DELETE', undefined, timeout);
+    }
+    // ============================================================================
+    // Stream Methods
+    // ============================================================================
+    /**
+     * Creates a new stream
+     *
+     * @param stream - The stream definition
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise resolving to the created stream
+     */
+    async createStream(stream, timeout) {
+        const endpoint = this.getStreamsEndpoint();
+        return this.makeRequest(endpoint, 'POST', stream, timeout);
+    }
+    /**
+     * Deletes a stream by name or ID
+     *
+     * @param streamNameOrId - The name or ID of the stream to delete
+     * @param force - Optional flag to force delete without waiting for handler cleanup
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise that resolves when the stream is deleted
+     */
+    async deleteStream(streamNameOrId, force, timeout) {
+        let endpoint = this.getStreamEndpoint(streamNameOrId);
+        if (force) {
+            endpoint += '?force=true';
+        }
+        return this.makeRequest(endpoint, 'DELETE', undefined, timeout);
+    }
+    /**
+     * Starts a stream by updating its started status to true
+     *
+     * @param streamNameOrId - The name or ID of the stream to start
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise resolving to the updated stream
+     */
+    async startStream(streamNameOrId, timeout) {
+        const endpoint = this.getStreamEndpoint(streamNameOrId);
+        const update = { started: true };
+        return this.makeRequest(endpoint, 'PATCH', update, timeout);
+    }
+    /**
+     * Stops a stream by updating its started status to false
+     *
+     * @param streamNameOrId - The name or ID of the stream to stop
+     * @param timeout - Optional timeout in seconds (default: 120)
+     * @returns Promise resolving to the updated stream
+     */
+    async stopStream(streamNameOrId, timeout) {
+        const endpoint = this.getStreamEndpoint(streamNameOrId);
+        const update = { started: false };
+        return this.makeRequest(endpoint, 'PATCH', update, timeout);
+    }
+}
+//# sourceMappingURL=rest-client.js.map

package/dist-esm/src/client/rest-client.js.map

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

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

@@ -0,0 +1,113 @@
+// 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.
+import { newLogger } from '../log/logger.js';
+import { SDKErrors, newError } from '../i18n/errors.js';
+const log = newLogger('config');
+/**
+ * Authentication type enum
+ */
+export var AuthType;
+(function (AuthType) {
+    AuthType["BASIC"] = "basic";
+    AuthType["TOKEN"] = "token";
+})(AuthType || (AuthType = {}));
+/**
+ * Configuration utility for transforming WorkflowEngineConfig into client config
+ *
+ * The SDK receives configuration objects - it does not load from files.
+ * Applications using this SDK should load configuration themselves and pass it in.
+ */
+export class ConfigLoader {
+    /**
+     * Create WorkflowEngineClientConfig from WorkflowEngineConfig
+     */
+    static createClientConfig(config, providerName) {
+        const auth = config.workflowEngine.auth;
+        let headerName;
+        let authValue;
+        // 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');
+                authValue = `Basic ${credentials}`;
+                break;
+            }
+            case AuthType.TOKEN: {
+                headerName = auth.header || 'Authorization';
+                const scheme = auth.scheme || '';
+                authValue = scheme ? `${scheme} ${auth.token}` : auth.token;
+                break;
+            }
+            default: {
+                // TypeScript ensures this is unreachable if all cases are handled
+                const _exhaustive = auth;
+                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,
+            providerName,
+            options: {
+                headers: {
+                    [headerName]: authValue
+                }
+            },
+            maxAttempts: config.workflowEngine.maxRetries, // undefined = infinite retries
+            reconnectDelay: config.workflowEngine.retryDelay ? parseInt(config.workflowEngine.retryDelay.replace('s', '')) * 1000 : 2000
+        };
+    }
+    /**
+     * Log configuration summary (without sensitive data)
+     */
+    static logConfigSummary(config) {
+        log.info('Configuration loaded:');
+        log.info(`  Workflow Engine: ${config.workflowEngine.url}`);
+        const auth = config.workflowEngine.auth;
+        switch (auth.type) {
+            case AuthType.BASIC:
+                log.info(`  Auth Type: ${AuthType.BASIC}`);
+                log.info(`  Username: ${auth.username}`);
+                break;
+            case AuthType.TOKEN:
+                log.info(`  Auth Type: ${AuthType.TOKEN}`);
+                log.info(`  Auth Header: ${auth.header || 'Authorization'}`);
+                if (auth.scheme) {
+                    log.info(`  Auth Scheme: ${auth.scheme}`);
+                }
+                break;
+        }
+        if (config.workflowEngine.maxRetries) {
+            log.info(`  Max Retries: ${config.workflowEngine.maxRetries}`);
+        }
+        if (config.workflowEngine.retryDelay) {
+            log.info(`  Retry Delay: ${config.workflowEngine.retryDelay}`);
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist-esm/src/factories/event_source.js

@@ -0,0 +1,167 @@
+// 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.
+import { newLogger } from '../log/logger.js';
+import { getErrorMessage } from '../utils/errors.js';
+const log = newLogger('event_source_factory');
+/**
+ * Internal event source implementation.
+ */
+class EventSourceBase {
+    constructor(name, pollFn) {
+        this.confs = new Map();
+        this._name = name;
+        this.pollFn = pollFn;
+    }
+    name() {
+        return this._name;
+    }
+    withDeleteFn(deleteFn) {
+        this.deleteFn = deleteFn;
+        return this;
+    }
+    withConfigParser(parserFn) {
+        this.configParserFn = parserFn;
+        return this;
+    }
+    withInitialCheckpoint(buildFn) {
+        this.buildInitialCheckpointFn = buildFn;
+        return this;
+    }
+    withInitFn(initFn) {
+        this.initFn = initFn;
+        return this;
+    }
+    withCloseFn(closeFn) {
+        this.closeFn = closeFn;
+        return this;
+    }
+    async init(engAPI) {
+        if (this.initFn) {
+            await this.initFn(engAPI);
+        }
+    }
+    close() {
+        if (this.closeFn) {
+            this.closeFn();
+        }
+        this.confs.clear();
+    }
+    /**
+     * Build and parse config for a stream.
+     */
+    async buildConf(info, configData) {
+        if (this.configParserFn) {
+            return await this.configParserFn(info, configData);
+        }
+        else {
+            // Simple JSON parsing (default)
+            return configData;
+        }
+    }
+    /**
+     * Build and cache config for a stream.
+     */
+    async buildAndCacheConf(config, request) {
+        const info = {
+            streamId: request.streamId,
+            streamName: request.streamName,
+        };
+        const parsedConfig = await this.buildConf(info, config.config);
+        const esConf = {
+            ...info,
+            config: parsedConfig,
+        };
+        this.confs.set(request.streamId, esConf);
+        return esConf;
+    }
+    /**
+     * Validate config and optionally set initial checkpoint.
+     */
+    async eventSourceValidateConfig(result, request) {
+        try {
+            const parsedConfig = await this.buildConf({
+                streamId: request.streamId,
+                streamName: request.streamName,
+            }, request.config);
+            if (this.buildInitialCheckpointFn) {
+                const initialCheckpoint = await this.buildInitialCheckpointFn(parsedConfig);
+                result.initialCheckpoint = initialCheckpoint;
+            }
+        }
+        catch (error) {
+            log.error('Failed to validate config', { error });
+            result.error = getErrorMessage(error);
+        }
+    }
+    /**
+     * Poll for events.
+     * Mutates the `result` parameter to match the engine's output-by-reference API.
+     */
+    async eventSourcePoll(config, result, request) {
+        try {
+            // Get or build cached config
+            let esConf = this.confs.get(request.streamId);
+            if (!esConf) {
+                esConf = await this.buildAndCacheConf(config, request);
+            }
+            // Get checkpoint from request, normalize undefined to null for poll function
+            const checkpointIn = request.checkpoint ?? null;
+            // Call user's poll function
+            const pollResult = await this.pollFn(esConf, checkpointIn);
+            // Map events to ListenerEvent format
+            result.events = pollResult.events.map((evt) => ({
+                idempotencyKey: evt.idempotencyKey,
+                topic: evt.topic,
+                data: evt.data,
+            }));
+            // Set checkpoint
+            result.checkpoint = pollResult.checkpointOut;
+        }
+        catch (error) {
+            log.error('Poll failed', { error });
+            result.error = getErrorMessage(error);
+        }
+    }
+    /**
+     * Delete event source and clear cached config.
+     */
+    async eventSourceDelete(result, request) {
+        try {
+            if (this.deleteFn) {
+                await this.deleteFn({
+                    streamId: request.streamId,
+                    streamName: request.streamName,
+                });
+            }
+            this.confs.delete(request.streamId);
+        }
+        catch (error) {
+            log.error('Delete failed', { error });
+            result.error = getErrorMessage(error);
+        }
+    }
+}
+/**
+ * Create a new event source with a poll function.
+ *
+ * @param name - Handler name to register with the workflow engine
+ * @param pollFn - Function that polls for new events
+ * @returns EventSourceFactory for chaining configuration
+ */
+export function newEventSource(name, pollFn) {
+    return new EventSourceBase(name, pollFn);
+}
+//# sourceMappingURL=event_source.js.map

package/dist-esm/src/factories/event_source.js.map

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

package/dist-esm/src/factories/transaction_handler.js

@@ -0,0 +1,63 @@
+// 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.
+import { evalDirected } from '../helpers/stage_director.js';
+/**
+ * Internal base implementation for directed transaction handlers.
+ */
+class TransactionHandlerBase {
+    constructor(name, actionMap) {
+        this._name = name;
+        this.actionMap = actionMap;
+    }
+    name() {
+        return this._name;
+    }
+    withInitFn(initFn) {
+        this.initFn = initFn;
+        return this;
+    }
+    withCloseFn(closeFn) {
+        this.closeFn = closeFn;
+        return this;
+    }
+    async init(engAPI) {
+        if (this.initFn) {
+            await this.initFn(engAPI);
+        }
+    }
+    close() {
+        if (this.closeFn) {
+            this.closeFn();
+        }
+    }
+    async transactionHandlerBatch(reply, batch) {
+        await evalDirected(reply, batch, this.actionMap);
+    }
+}
+/**
+ * Create a new simple directed handler, with no initialization.
+ *
+ * A directed handler uses the StageDirector pattern to route transactions
+ * to different actions based on the input's `action` field.
+ *
+ * @param name Handler name
+ * @param actionMap Map of action names to their configurations
+ * @returns A TransactionHandlerFactory for chaining
+ */
+export function newDirectedTransactionHandler(name, actionMap) {
+    return new TransactionHandlerBase(name, actionMap);
+}
+//# sourceMappingURL=transaction_handler.js.map