@solidactions/sdk 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidactions/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SolidActions SDK - Durable workflow execution framework",
   "license": "MIT",
   "repository": {
@@ -37,6 +37,11 @@
       "import": "./dist/src/index.js",
       "require": "./dist/src/index.js",
       "types": "./dist/src/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/src/testing/index.js",
+      "require": "./dist/src/testing/index.js",
+      "types": "./dist/src/testing/index.d.ts"
     }
   },
   "workspaces": [

package/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git fetch:*)"
-    ]
-  }
-}

package/dist/dbos-config.schema.json

@@ -1,132 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "title": "DBOS Config",
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {
-        "name": {
-            "type": "string",
-            "description": "The name of your application"
-        },
-        "language": {
-            "type": "string",
-            "description": "The language used in your application",
-            "enum": ["node", "python"]
-        },
-        "database_url": {
-            "type": "string",
-            "description": "The URL of the application database"
-        },
-        "system_database_url": {
-            "type": "string",
-            "description": "The URL of the system database"
-        },
-        "system_database_schema_name": {
-            "type": "string",
-            "description": "The schema name for DBOS system tables (default: 'dbos')"
-        },
-        "database": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-                "app_db_name": {
-                    "type": "string",
-                    "description": "The name of the application database. DEPRECATED: Use database_url instead",
-                    "deprecated": true
-                },
-                "migrate": {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    },
-                    "description": "Specify a list of user DB migration commands to run"
-                }
-            }
-        },
-        "telemetry": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-                "logs": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "properties": {
-                        "addContextMetadata": {
-                            "type": "boolean",
-                            "description": "Adds contextual information, such as workflow UUID, to each log entry"
-                        },
-                        "logLevel": {
-                            "type": "string",
-                            "description": "A filter on what logs should be printed to the standard output"
-                        },
-                        "silent": {
-                            "type": "boolean",
-                            "description": "Silences the logger such that nothing is printed to the standard output"
-                        }
-                    }
-                },
-                "OTLPExporter": {
-                    "type": "object",
-                    "additionalProperties": false,
-                    "properties": {
-                        "logsEndpoint": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "array",
-                                    "items": {
-                                        "type": "string"
-                                    }
-                                }
-                            ],
-                            "description": "The URL of an OTLP collector to which to export logs"
-                        },
-                        "tracesEndpoint": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "array",
-                                    "items": {
-                                        "type": "string"
-                                    }
-                                }
-                            ],
-                            "description": "The URL of an OTLP collector to which to export traces"
-                        }
-                    }
-                }
-            }
-        },
-        "runtimeConfig": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-                "admin_port": {
-                    "type": "number",
-                    "description": "The port number of the admin server (Default: 3001)"
-                },
-                "start": {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    },
-                    "description": "Commands to start the application"
-                },
-                "setup": {
-                    "type": "array",
-                    "items": {
-                        "type": "string"
-                    },
-                    "description": "Commands to setup the application execution environment"
-                }
-            }
-        },
-        "env": {
-            "deprecated": true
-        }
-    }
-}

package/dist/src/cli/commands.d.ts

@@ -1,3 +0,0 @@
-import { GlobalLogger } from '../telemetry/logs';
-export declare function runCommand(command: string, logger: GlobalLogger): Promise<number>;
-//# sourceMappingURL=commands.d.ts.map

package/dist/src/cli/commands.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA0CjF"}

package/dist/src/cli/commands.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCommand = void 0;
-const child_process_1 = require("child_process");
-// Run the "start" command provided by users in their dbos-config.yaml
-function runCommand(command, logger) {
-    return new Promise((resolve, reject) => {
-        // Split the command into the executable and its arguments
-        const [executable, ...args] = command.split(' ');
-        // Spawn a child process
-        const child = (0, child_process_1.spawn)(executable, args, {
-            stdio: 'inherit', // Forward stdin, stdout, stderr
-            shell: true, // Use the shell to interpret the command
-        });
-        // Handle parent signals and forward to child
-        const handleSignal = (signal) => {
-            logger.debug(`Received ${signal}, forwarding to  process...`);
-            if (child.pid) {
-                process.kill(child.pid, signal);
-            }
-        };
-        process.on('SIGTERM', () => handleSignal('SIGTERM'));
-        process.on('SIGINT', () => handleSignal('SIGINT'));
-        // Cleanup when child exits
-        child.on('exit', (code, signal) => {
-            if (code === 0 || signal === 'SIGTERM' || signal === 'SIGINT') {
-                logger.info(`Process exited successfully with code ${code ?? 'unknown'} or signal ${signal ?? 'unknown'}`);
-                resolve(0);
-            }
-            else {
-                const errorMsg = `Process exited with code ${code ?? 'unknown'} or signal ${signal ?? 'unknown'}`;
-                logger.error(errorMsg);
-                // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
-                reject(code);
-            }
-        });
-        // Must be caught by the caller
-        child.on('error', (error) => {
-            logger.error(`Failed to start process: ${error.message}`);
-            // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors
-            reject(1);
-        });
-    });
-}
-exports.runCommand = runCommand;
-//# sourceMappingURL=commands.js.map

package/dist/src/cli/commands.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":";;;AAAA,iDAAsC;AAGtC,sEAAsE;AACtE,SAAgB,UAAU,CAAC,OAAe,EAAE,MAAoB;IAC9D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,0DAA0D;QAC1D,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEjD,wBAAwB;QACxB,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,UAAU,EAAE,IAAI,EAAE;YACpC,KAAK,EAAE,SAAS,EAAE,gCAAgC;YAClD,KAAK,EAAE,IAAI,EAAE,yCAAyC;SACvD,CAAC,CAAC;QAEH,6CAA6C;QAC7C,MAAM,YAAY,GAAG,CAAC,MAAsB,EAAE,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,6BAA6B,CAAC,CAAC;YAC9D,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEnD,2BAA2B;QAC3B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,IAAI,IAAI,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,yCAAyC,IAAI,IAAI,SAAS,cAAc,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;gBAC3G,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,4BAA4B,IAAI,IAAI,SAAS,cAAc,MAAM,IAAI,SAAS,EAAE,CAAC;gBAClG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACvB,2EAA2E;gBAC3E,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,2EAA2E;YAC3E,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AA1CD,gCA0CC"}

package/dist/src/datasource.d.ts

@@ -1,109 +0,0 @@
-import { FunctionName } from './decorators';
-/**
- * This interface is to be used for implementers of transactional data sources
- *   This is what gets registered for the transaction control framework
- */
-export interface DataSourceTransactionHandler {
-    readonly name: string;
-    readonly dsType: string;
-    /**
-     * Will be called by DBOS during launch.
-     * This may be a no-op if the DS is initialized before telling DBOS about the DS at all.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Will be called by DBOS during attempt at clean shutdown (generally in testing scenarios).
-     */
-    destroy(): Promise<void>;
-    /**
-     * Invoke a transaction function
-     */
-    invokeTransactionFunction<This, Args extends unknown[], Return>(config: unknown, target: This, func: (this: This, ...args: Args) => Promise<Return>, ...args: Args): Promise<Return>;
-}
-/**
- * This is the suggested interface guideline for presenting to the end user, but not
- *   strictly required.
- */
-export interface DBOSDataSource<Config extends {
-    name?: string;
-}> {
-    readonly name: string;
-    /**
-     * Run the code transactionally within this data source
-     *   Implementers should strongly type the config
-     * @param callback - Function to run within a transactional context
-     * @param name - Step name to show in the system database, traces, etc.
-     * @param config - Transaction configuration options
-     */
-    runTransaction<T>(callback: () => Promise<T>, config?: Config): Promise<T>;
-    /**
-     * Register function as DBOS transaction, to be called within the context
-     *  of a transaction on this data source.
-     *
-     * Providing a static version of this functionality is optional.
-     *
-     * @param func - Function to wrap
-     * @param config - Transaction settings, including function `name`
-     * @param target - Class name, or class ctor/prototype
-     * @returns Wrapped function, to be called instead of `func`
-     */
-    registerTransaction<This, Args extends unknown[], Return>(func: (this: This, ...args: Args) => Promise<Return>, config?: Config & FunctionName): (this: This, ...args: Args) => Promise<Return>;
-    /**
-     * Produce a Stage 2 method decorator
-     * @param config - Configuration to apply to the decorated method
-     */
-    transaction(config?: Config): <This, Args extends unknown[], Return>(target: object, propertyKey: string, descriptor: TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>) => TypedPropertyDescriptor<(this: This, ...args: Args) => Promise<Return>>;
-}
-/**
- * This function is to be called by `DataSourceTransactionHandler` instances,
- *   with bits of user code to be run as transactions.
- * 1. The DS validates the type of config and provides the name
- * 2. The transaction will be started inside here, with a durable sysdb checkpoint.
- * 3. The DS will in turn be called upon to run the callback in a transaction context
- * @param callback - User callback function
- * @param funcName - Function name, for recording in system DB
- * @param options - Data source name and configuration
- * @returns the return from `callback`
- */
-export declare function runTransaction<T>(callback: () => Promise<T>, funcName: string, options?: {
-    dsName?: string;
-    config?: unknown;
-}): Promise<T>;
-export declare function registerTransaction<This, Args extends unknown[], Return, Config extends FunctionName>(dsName: string, func: (this: This, ...args: Args) => Promise<Return>, config?: Config): (this: This, ...args: Args) => Promise<Return>;
-/**
- * Register a transactional data source, that helps DBOS provide
- *  transactional access to user databases
- * @param name - Registered name for the data source
- * @param ds - Transactional data source provider
- */
-export declare function registerDataSource(ds: DataSourceTransactionHandler): void;
-/** Isolation typically supported by application databases */
-export declare const PGIsolationLevel: Readonly<{
-    readonly ReadUncommitted: "READ UNCOMMITTED";
-    readonly ReadCommitted: "READ COMMITTED";
-    readonly RepeatableRead: "REPEATABLE READ";
-    readonly Serializable: "SERIALIZABLE";
-}>;
-type ValuesOf<T> = T[keyof T];
-export type PGIsolationLevel = ValuesOf<typeof PGIsolationLevel>;
-/**
- * Configuration for Postgres-like transactions
- */
-export interface PGTransactionConfig {
-    /** Isolation level to request from underlying app database */
-    isolationLevel?: PGIsolationLevel;
-    /** If set, request read-only transaction from underlying app database */
-    readOnly?: boolean;
-}
-export interface CheckSchemaInstallationReturn {
-    schema_exists: number;
-    table_exists: number;
-}
-export declare function checkSchemaInstallationPG(schemaName?: string): string;
-export declare function createTransactionCompletionSchemaPG(schemaName?: string): string;
-export declare function createTransactionCompletionTablePG(schemaName?: string): string;
-export declare function isPGRetriableTransactionError(error: unknown): boolean;
-export declare function isPGKeyConflictError(error: unknown): boolean;
-export declare function isPGFailedSqlTransactionError(error: unknown): boolean;
-export { maskDatabaseUrl, getDatabaseNameFromUrl, deriveDatabaseUrl } from './database_utils';
-//# sourceMappingURL=datasource.d.ts.map

package/dist/src/datasource.d.ts.map

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

package/dist/src/datasource.js

@@ -1,204 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.deriveDatabaseUrl = exports.getDatabaseNameFromUrl = exports.maskDatabaseUrl = exports.isPGFailedSqlTransactionError = exports.isPGKeyConflictError = exports.isPGRetriableTransactionError = exports.createTransactionCompletionTablePG = exports.createTransactionCompletionSchemaPG = exports.checkSchemaInstallationPG = exports.PGIsolationLevel = exports.registerDataSource = exports.registerTransaction = exports.runTransaction = void 0;
-const context_1 = require("./context");
-const dbos_1 = require("./dbos");
-const dbos_executor_1 = require("./dbos-executor");
-const decorators_1 = require("./decorators");
-const error_1 = require("./error");
-const traces_1 = require("./telemetry/traces");
-/// Calling into DBOS
-/**
- * This function is to be called by `DataSourceTransactionHandler` instances,
- *   with bits of user code to be run as transactions.
- * 1. The DS validates the type of config and provides the name
- * 2. The transaction will be started inside here, with a durable sysdb checkpoint.
- * 3. The DS will in turn be called upon to run the callback in a transaction context
- * @param callback - User callback function
- * @param funcName - Function name, for recording in system DB
- * @param options - Data source name and configuration
- * @returns the return from `callback`
- */
-async function runTransaction(callback, funcName, options = {}) {
-    (0, decorators_1.ensureDBOSIsLaunched)('transactions');
-    const dsn = options.dsName ?? '<default>';
-    const ds = (0, decorators_1.getTransactionalDataSource)(dsn);
-    if (!dbos_1.DBOS.isWithinWorkflow()) {
-        if ((0, context_1.getNextWFID)(undefined)) {
-            throw new error_1.DBOSInvalidWorkflowTransitionError(`Invalid call to transaction '${funcName}' outside of a workflow; with directive to start a workflow.`);
-        }
-        return await (0, context_1.runWithDataSourceContext)(0, async () => {
-            return await ds.invokeTransactionFunction(options.config ?? {}, undefined, callback);
-        });
-    }
-    if (!dbos_1.DBOS.isInWorkflow()) {
-        throw new error_1.DBOSInvalidWorkflowTransitionError(`Invalid call to \`${funcName}\` inside a \`step\`, \`transaction\`, or \`procedure\``);
-    }
-    const callnum = (0, context_1.functionIDGetIncrement)();
-    const span = dbos_executor_1.DBOSExecutor.globalInstance.tracer.startSpan(funcName, {
-        operationUUID: dbos_1.DBOS.workflowID,
-        operationType: dbos_executor_1.OperationType.TRANSACTION,
-        operationName: funcName,
-        authenticatedUser: dbos_1.DBOS.authenticatedUser ?? '',
-        assumedRole: dbos_1.DBOS.assumedRole ?? '',
-        authenticatedRoles: dbos_1.DBOS.authenticatedRoles ?? [],
-        // isolationLevel: txnInfo.config.isolationLevel, // TODO: Pluggable
-    }, dbos_1.DBOS.span);
-    try {
-        const res = await (0, traces_1.runWithTrace)(span, async () => {
-            return await dbos_executor_1.DBOSExecutor.globalInstance.runInternalStep(async () => {
-                return await (0, context_1.runWithDataSourceContext)(callnum, async () => {
-                    return await ds.invokeTransactionFunction(options.config ?? {}, undefined, callback);
-                });
-            }, funcName, 
-            // we can be sure workflowID is set because of previous call to assertCurrentWorkflowContext
-            dbos_1.DBOS.workflowID, callnum);
-        });
-        span.setStatus({ code: traces_1.SpanStatusCode.OK });
-        dbos_executor_1.DBOSExecutor.globalInstance.tracer.endSpan(span);
-        return res;
-    }
-    catch (err) {
-        const e = err;
-        span.setStatus({ code: traces_1.SpanStatusCode.ERROR, message: e.message });
-        dbos_executor_1.DBOSExecutor.globalInstance.tracer.endSpan(span);
-        throw err;
-    }
-}
-exports.runTransaction = runTransaction;
-// Transaction wrapper
-function registerTransaction(dsName, func, config) {
-    const dsn = dsName ?? '<default>';
-    const funcName = config?.name ?? func.name;
-    const reg = (0, decorators_1.wrapDBOSFunctionAndRegister)(config?.ctorOrProto, config?.className, funcName, funcName, func);
-    const invokeWrapper = async function (...rawArgs) {
-        (0, decorators_1.ensureDBOSIsLaunched)('transactions');
-        const ds = (0, decorators_1.getTransactionalDataSource)(dsn);
-        const callFunc = reg.registeredFunction ?? reg.origFunction;
-        if (!dbos_1.DBOS.isWithinWorkflow()) {
-            if ((0, context_1.getNextWFID)(undefined)) {
-                throw new error_1.DBOSInvalidWorkflowTransitionError(`Call to transaction '${funcName}' made without starting workflow`);
-            }
-            return await (0, context_1.runWithDataSourceContext)(0, async () => {
-                return await ds.invokeTransactionFunction(config, this, callFunc, ...rawArgs);
-            });
-        }
-        if (dbos_1.DBOS.isInTransaction() || dbos_1.DBOS.isInStep()) {
-            throw new error_1.DBOSInvalidWorkflowTransitionError('Invalid call to a `transaction` function from within a `step` or `transaction`');
-        }
-        const span = dbos_executor_1.DBOSExecutor.globalInstance.tracer.startSpan(funcName, {
-            operationUUID: dbos_1.DBOS.workflowID,
-            operationType: dbos_executor_1.OperationType.TRANSACTION,
-            operationName: funcName,
-            authenticatedUser: dbos_1.DBOS.authenticatedUser ?? '',
-            assumedRole: dbos_1.DBOS.assumedRole ?? '',
-            authenticatedRoles: dbos_1.DBOS.authenticatedRoles ?? [],
-            // isolationLevel: txnInfo.config.isolationLevel, // TODO: Pluggable
-        }, dbos_1.DBOS.span);
-        const callnum = (0, context_1.functionIDGetIncrement)();
-        try {
-            const res = await (0, traces_1.runWithTrace)(span, async () => {
-                return await dbos_executor_1.DBOSExecutor.globalInstance.runInternalStep(async () => {
-                    return await (0, context_1.runWithDataSourceContext)(callnum, async () => {
-                        return await ds.invokeTransactionFunction(config, this, callFunc, ...rawArgs);
-                    });
-                }, funcName, dbos_1.DBOS.workflowID, callnum);
-            });
-            span.setStatus({ code: traces_1.SpanStatusCode.OK });
-            dbos_executor_1.DBOSExecutor.globalInstance.tracer.endSpan(span);
-            return res;
-        }
-        catch (err) {
-            const e = err;
-            span.setStatus({ code: traces_1.SpanStatusCode.ERROR, message: e.message });
-            dbos_executor_1.DBOSExecutor.globalInstance.tracer.endSpan(span);
-            throw err;
-        }
-    };
-    (0, decorators_1.registerFunctionWrapper)(invokeWrapper, reg);
-    Object.defineProperty(invokeWrapper, 'name', {
-        value: funcName,
-    });
-    return invokeWrapper;
-}
-exports.registerTransaction = registerTransaction;
-/**
- * Register a transactional data source, that helps DBOS provide
- *  transactional access to user databases
- * @param name - Registered name for the data source
- * @param ds - Transactional data source provider
- */
-function registerDataSource(ds) {
-    (0, decorators_1.registerTransactionalDataSource)(ds.name, ds);
-}
-exports.registerDataSource = registerDataSource;
-/// Postgres helper routines
-/** Isolation typically supported by application databases */
-exports.PGIsolationLevel = Object.freeze({
-    ReadUncommitted: 'READ UNCOMMITTED',
-    ReadCommitted: 'READ COMMITTED',
-    RepeatableRead: 'REPEATABLE READ',
-    Serializable: 'SERIALIZABLE',
-});
-function checkSchemaInstallationPG(schemaName = 'dbos') {
-    return `
-SELECT
-  EXISTS (
-    SELECT 1
-    FROM information_schema.schemata
-    WHERE schema_name = '${schemaName}'
-  ) AS schema_exists,
-  EXISTS (
-    SELECT 1
-    FROM information_schema.tables
-    WHERE table_schema = '${schemaName}'
-      AND table_name = 'transaction_completion'
-  ) AS table_exists;
-`;
-}
-exports.checkSchemaInstallationPG = checkSchemaInstallationPG;
-function createTransactionCompletionSchemaPG(schemaName = 'dbos') {
-    return `CREATE SCHEMA IF NOT EXISTS "${schemaName}";`;
-}
-exports.createTransactionCompletionSchemaPG = createTransactionCompletionSchemaPG;
-function createTransactionCompletionTablePG(schemaName = 'dbos') {
-    return `
-  CREATE TABLE IF NOT EXISTS "${schemaName}".transaction_completion (
-    workflow_id TEXT NOT NULL,
-    function_num INT NOT NULL,
-    output TEXT,
-    error TEXT,
-    created_at BIGINT NOT NULL DEFAULT (EXTRACT(EPOCH FROM now())*1000)::bigint,
-    PRIMARY KEY (workflow_id, function_num)
-  );
-`;
-}
-exports.createTransactionCompletionTablePG = createTransactionCompletionTablePG;
-function getPGErrorCode(error) {
-    return error && typeof error === 'object' && 'code' in error ? error.code : undefined;
-}
-function isPGRetriableTransactionError(error) {
-    return getPGErrorCode(error) === '40001';
-}
-exports.isPGRetriableTransactionError = isPGRetriableTransactionError;
-function isPGKeyConflictError(error) {
-    return getPGErrorCode(error) === '23505';
-}
-exports.isPGKeyConflictError = isPGKeyConflictError;
-function isPGFailedSqlTransactionError(error) {
-    return getPGErrorCode(error) === '25P02';
-}
-exports.isPGFailedSqlTransactionError = isPGFailedSqlTransactionError;
-// URL utilities retained for configuration parsing
-var database_utils_1 = require("./database_utils");
-Object.defineProperty(exports, "maskDatabaseUrl", { enumerable: true, get: function () { return database_utils_1.maskDatabaseUrl; } });
-Object.defineProperty(exports, "getDatabaseNameFromUrl", { enumerable: true, get: function () { return database_utils_1.getDatabaseNameFromUrl; } });
-Object.defineProperty(exports, "deriveDatabaseUrl", { enumerable: true, get: function () { return database_utils_1.deriveDatabaseUrl; } });
-// Note: PostgreSQL-specific functions were removed in the HTTP SDK migration.
-// The following functions are no longer available:
-// - getPGClientConfig
-// - connectToPGDatabase
-// - connectToPGAndReportOutcome
-// - dropPGDatabase
-// - ensurePGDatabase
-//# sourceMappingURL=datasource.js.map

package/dist/src/datasource.js.map

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