@solidactions/sdk 0.1.0

package/dist/src/context.d.ts

@@ -0,0 +1,62 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { SolidActionsContextualLogger } from './telemetry/logs';
+import { IncomingHttpHeaders } from 'http';
+import { ParsedUrlQuery } from 'querystring';
+import Koa from 'koa';
+export interface StepStatus {
+    stepID: number;
+    currentAttempt?: number;
+    maxAttempts?: number;
+}
+export interface SolidActionsContextOptions {
+    idAssignedForNextWorkflow?: string;
+    queueAssignedForWorkflows?: string;
+    logger?: SolidActionsContextualLogger;
+    authenticatedUser?: string;
+    authenticatedRoles?: string[];
+    assumedRole?: string;
+    request?: object;
+    operationType?: string;
+    operationCaller?: string;
+    workflowTimeoutMS?: number | null;
+}
+export interface SolidActionsLocalCtx extends SolidActionsContextOptions {
+    parentCtx?: SolidActionsLocalCtx;
+    workflowId?: string;
+    curWFFunctionId?: number;
+    presetID?: boolean;
+    deadlineEpochMS?: number;
+    inRecovery?: boolean;
+    curStepFunctionId?: number;
+    stepStatus?: StepStatus;
+    curTxFunctionId?: number;
+    koaContext?: Koa.Context;
+}
+export declare function isInWorkflowCtx(ctx: SolidActionsLocalCtx): boolean;
+export declare function getCurrentContextStore(): SolidActionsLocalCtx | undefined;
+export declare function getNextWFID(assignedID?: string): string | undefined;
+export declare function functionIDGetIncrement(): number;
+export declare function functionIDGet(): number;
+export declare function runWithTopContext<R>(ctx: SolidActionsLocalCtx, callback: () => Promise<R>): Promise<R>;
+export declare function runWithParentContext<R>(pctx: SolidActionsLocalCtx | undefined, ctx: SolidActionsLocalCtx, callback: () => Promise<R>): Promise<R>;
+export declare function runInStepContext<R>(pctx: SolidActionsLocalCtx, stepID: number, maxAttempts: number | undefined, currentAttempt: number | undefined, callback: () => Promise<R>): Promise<R>;
+/**
+ * HTTPRequest includes useful information from http.IncomingMessage and parsed body,
+ *   URL parameters, and parsed query string.
+ * In essence, it is the serializable part of the request.
+ */
+export interface HTTPRequest {
+    readonly headers?: IncomingHttpHeaders;
+    readonly rawHeaders?: string[];
+    readonly params?: unknown;
+    readonly body?: unknown;
+    readonly rawBody?: string;
+    readonly query?: ParsedUrlQuery;
+    readonly querystring?: string;
+    readonly url?: string;
+    readonly method?: string;
+    readonly ip?: string;
+    readonly requestID?: string;
+}
+//# sourceMappingURL=context.d.ts.map

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

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

package/dist/src/context.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInStepContext = exports.runWithParentContext = exports.runWithTopContext = exports.functionIDGet = exports.functionIDGetIncrement = exports.getNextWFID = exports.getCurrentContextStore = exports.isInWorkflowCtx = void 0;
+const async_hooks_1 = require("async_hooks");
+const error_1 = require("./error");
+const solidactions_executor_1 = require("./solidactions-executor");
+function isWithinWorkflowCtx(ctx) {
+    if (ctx.workflowId === undefined)
+        return false;
+    return true;
+}
+function isInStepCtx(ctx) {
+    if (ctx.workflowId === undefined)
+        return false;
+    if (ctx.curStepFunctionId)
+        return true;
+    return false;
+}
+function isInTxnCtx(ctx) {
+    if (ctx.workflowId === undefined)
+        return false;
+    if (ctx.curTxFunctionId)
+        return true;
+    return false;
+}
+function isInWorkflowCtx(ctx) {
+    if (!isWithinWorkflowCtx(ctx))
+        return false;
+    if (isInStepCtx(ctx))
+        return false;
+    if (isInTxnCtx(ctx))
+        return false;
+    return true;
+}
+exports.isInWorkflowCtx = isInWorkflowCtx;
+const asyncLocalCtx = new async_hooks_1.AsyncLocalStorage();
+function getCurrentContextStore() {
+    return asyncLocalCtx.getStore();
+}
+exports.getCurrentContextStore = getCurrentContextStore;
+// Track if we've used the SolidActions_RUN_ID env var
+let envRunIdUsed = false;
+function getNextWFID(assignedID) {
+    let wfId = assignedID;
+    if (!wfId) {
+        const pctx = getCurrentContextStore();
+        const nextID = pctx?.idAssignedForNextWorkflow;
+        if (nextID) {
+            wfId = nextID;
+            pctx.idAssignedForNextWorkflow = undefined;
+        }
+    }
+    // If still no ID and this is the first top-level workflow, use SOLIDACTIONS_RUN_ID env var
+    // This allows the runner to assign a specific UUID that links to run_triggers table
+    if (!wfId && !envRunIdUsed) {
+        const envRunId = process.env.SOLIDACTIONS_RUN_ID;
+        if (envRunId) {
+            wfId = envRunId;
+            envRunIdUsed = true;
+        }
+    }
+    return wfId;
+}
+exports.getNextWFID = getNextWFID;
+function functionIDGetIncrement() {
+    const pctx = getCurrentContextStore();
+    if (!pctx)
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError(`Attempt to get a call ID number outside of a workflow`);
+    if (!isInWorkflowCtx(pctx))
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError(`Attempt to get a call ID number in a workflow that is already in a call`);
+    if (pctx.curWFFunctionId === undefined)
+        pctx.curWFFunctionId = 0;
+    return pctx.curWFFunctionId++;
+}
+exports.functionIDGetIncrement = functionIDGetIncrement;
+function functionIDGet() {
+    const pctx = getCurrentContextStore();
+    if (!pctx)
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError(`Attempt to get a call ID number outside of a workflow`);
+    if (!isInWorkflowCtx(pctx))
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError(`Attempt to get a call ID number in a workflow that is already in a call`);
+    if (pctx.curWFFunctionId === undefined)
+        pctx.curWFFunctionId = 0;
+    return pctx.curWFFunctionId;
+}
+exports.functionIDGet = functionIDGet;
+async function runWithTopContext(ctx, callback) {
+    return await asyncLocalCtx.run(ctx, callback);
+}
+exports.runWithTopContext = runWithTopContext;
+async function runWithParentContext(pctx, ctx, callback) {
+    return await asyncLocalCtx.run({
+        ...pctx,
+        ...ctx,
+        parentCtx: pctx,
+    }, callback);
+}
+exports.runWithParentContext = runWithParentContext;
+async function runInStepContext(pctx, stepID, maxAttempts, currentAttempt, callback) {
+    // Check we are in a workflow context and not in a step / transaction already
+    if (!pctx)
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError();
+    if (!isInWorkflowCtx(pctx))
+        throw new error_1.SolidActionsInvalidWorkflowTransitionError();
+    const stepStatus = {
+        stepID: stepID,
+        currentAttempt: currentAttempt,
+        maxAttempts: currentAttempt ? maxAttempts : undefined,
+    };
+    return await runWithParentContext(pctx, {
+        stepStatus: stepStatus,
+        curStepFunctionId: stepID,
+        parentCtx: pctx,
+        logger: solidactions_executor_1.SolidActionsExecutor.globalInstance.ctxLogger,
+    }, callback);
+}
+exports.runInStepContext = runInStepContext;
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

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

package/dist/src/database_utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * URL utilities for database connection strings.
+ * These are kept for backwards compatibility with configuration parsing.
+ */
+/**
+ * Derive a new database URL with a different database name.
+ */
+export declare function deriveDatabaseUrl(urlStr: string, otherDbName: string): string;
+/**
+ * Extract the database name from a PostgreSQL URL.
+ */
+export declare function getDatabaseNameFromUrl(urlStr: string): string;
+/**
+ * Mask the password in a database URL for safe logging.
+ */
+export declare function maskDatabaseUrl(urlStr: string): string;
+//# sourceMappingURL=database_utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database_utils.d.ts","sourceRoot":"","sources":["../../src/database_utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAYtD"}

package/dist/src/database_utils.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * URL utilities for database connection strings.
+ * These are kept for backwards compatibility with configuration parsing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskDatabaseUrl = exports.getDatabaseNameFromUrl = exports.deriveDatabaseUrl = void 0;
+/**
+ * Derive a new database URL with a different database name.
+ */
+function deriveDatabaseUrl(urlStr, otherDbName) {
+    try {
+        const u = new URL(urlStr);
+        u.pathname = `/${otherDbName}`;
+        return u.toString();
+    }
+    catch {
+        return urlStr;
+    }
+}
+exports.deriveDatabaseUrl = deriveDatabaseUrl;
+/**
+ * Extract the database name from a PostgreSQL URL.
+ */
+function getDatabaseNameFromUrl(urlStr) {
+    try {
+        const u = new URL(urlStr);
+        return u.pathname?.replace(/^\//, '') || '';
+    }
+    catch {
+        return '';
+    }
+}
+exports.getDatabaseNameFromUrl = getDatabaseNameFromUrl;
+/**
+ * Mask the password in a database URL for safe logging.
+ */
+function maskDatabaseUrl(urlStr) {
+    try {
+        const u = new URL(urlStr);
+        if (u.password) {
+            const p = decodeURIComponent(u.password);
+            const masked = p.length <= 2 ? p : `${p[0]}${'*'.repeat(p.length - 2)}${p[p.length - 1]}`;
+            u.password = encodeURIComponent(masked);
+        }
+        return u.toString();
+    }
+    catch {
+        return urlStr;
+    }
+}
+exports.maskDatabaseUrl = maskDatabaseUrl;
+//# sourceMappingURL=database_utils.js.map

package/dist/src/database_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database_utils.js","sourceRoot":"","sources":["../../src/database_utils.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAc,EAAE,WAAmB;IACnE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AARD,8CAQC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAc;IACnD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAPD,wDAOC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1F,CAAC,CAAC,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAZD,0CAYC"}

package/dist/src/datasource.d.ts

@@ -0,0 +1,109 @@
+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

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

package/dist/src/datasource.js

@@ -0,0 +1,204 @@
+"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

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