@solidactions/sdk 0.1.0

package/dist/src/utils.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClientConfig = exports.interceptStreams = exports.exhaustiveCheckGuard = exports.cancellableSleep = exports.DEBOUNCER_WORKLOW_NAME = exports.INTERNAL_QUEUE_NAME = exports.sleepms = exports.globalParams = exports.defaultEnableOTLP = exports.readFile = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+/*
+ * A wrapper of readFile used for mocking in tests
+ **/
+async function readFile(path, encoding = 'utf8') {
+    return await node_fs_1.default.promises.readFile(path, { encoding });
+}
+exports.readFile = readFile;
+function loadSolidActionsVersion() {
+    try {
+        function findPackageRoot(start) {
+            if (typeof start === 'string') {
+                if (!start.endsWith(node_path_1.default.sep)) {
+                    start += node_path_1.default.sep;
+                }
+                start = start.split(node_path_1.default.sep);
+            }
+            if (start.length === 0) {
+                throw new Error('package.json not found in path');
+            }
+            start.pop();
+            const dir = start.join(node_path_1.default.sep);
+            if (node_fs_1.default.existsSync(node_path_1.default.join(dir, 'package.json'))) {
+                return dir;
+            }
+            return findPackageRoot(start);
+        }
+        const packageJsonPath = node_path_1.default.join(findPackageRoot(__dirname), 'package.json');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const packageJson = require(packageJsonPath);
+        return packageJson.version;
+    }
+    catch (error) {
+        // Return "unknown" if package.json cannot be found or loaded
+        // This can happen in bundled environments where the file system structure is different
+        return 'unknown';
+    }
+}
+// Enable OTLP by default only in SolidActions Cloud. Otherwise, enable through configuration.
+function defaultEnableOTLP() {
+    return process.env.SOLIDACTIONS__CLOUD === 'true';
+}
+exports.defaultEnableOTLP = defaultEnableOTLP;
+exports.globalParams = {
+    appVersion: process.env.SOLIDACTIONS__APPVERSION || '', // The one true source of appVersion
+    wasComputed: false, // Was app version set or computed? Stored procs don't support computed versions.
+    executorID: process.env.SOLIDACTIONS__VMID || 'local', // The one true source of executorID
+    appID: process.env.SOLIDACTIONS__APPID || '', // The one true source of appID
+    enableOTLP: defaultEnableOTLP(), // Whether OTLP is enabled
+    solidActionsVersion: loadSolidActionsVersion(), // The version of the SolidActions library
+};
+const sleepms = (ms) => new Promise((r) => setTimeout(r, ms));
+exports.sleepms = sleepms;
+// The name of the internal queue used by SolidActions
+exports.INTERNAL_QUEUE_NAME = '_solidactions_internal_queue';
+exports.DEBOUNCER_WORKLOW_NAME = '_solidactions_debouncer_workflow';
+/*
+A cancellable sleep function that returns a promise and a callback
+The promise can be awaited for and will automatically resolve after the given time
+When cancel is called, not only it clears the timeout, but also resolves the promise
+So any waiters on the cancelable sleep will be resolved
+*/
+function cancellableSleep(ms) {
+    let timeoutId = undefined;
+    let resolvePromise;
+    let resolved = false;
+    const promise = new Promise((resolve) => {
+        resolvePromise = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            resolve();
+            timeoutId = undefined;
+        };
+        timeoutId = setTimeout(resolvePromise, ms);
+    });
+    const cancel = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = undefined;
+            resolvePromise();
+        }
+    };
+    return { promise, cancel };
+}
+exports.cancellableSleep = cancellableSleep;
+function exhaustiveCheckGuard(_) {
+    throw new Error('Exaustive matching is not applied');
+}
+exports.exhaustiveCheckGuard = exhaustiveCheckGuard;
+// Capture original functions
+const originalStdoutWrite = process.stdout.write.bind(process.stdout);
+const originalStderrWrite = process.stderr.write.bind(process.stderr);
+function interceptStreams(onMessage) {
+    const intercept = (stream, originalWrite) => {
+        return (chunk, encodingOrCb, cb) => {
+            const message = chunk.toString();
+            onMessage(message, stream);
+            if (typeof encodingOrCb === 'function') {
+                return originalWrite(chunk, encodingOrCb); // Handle case where encodingOrCb is a callback
+            }
+            return originalWrite(chunk, encodingOrCb, cb); // Handle case where encodingOrCb is a BufferEncoding
+        };
+    };
+    process.stdout.write = intercept('stdout', originalStdoutWrite);
+    process.stderr.write = intercept('stderr', originalStderrWrite);
+}
+exports.interceptStreams = interceptStreams;
+// The `pg` package we use does not parse the connect_timeout parameter, so we need to handle it ourselves.
+function getClientConfig(databaseUrl) {
+    const connectionString = typeof databaseUrl === 'string' ? databaseUrl : databaseUrl.toString();
+    const timeout = getTimeout(typeof databaseUrl === 'string' ? new URL(databaseUrl) : databaseUrl);
+    return {
+        connectionString,
+        connectionTimeoutMillis: timeout ? timeout * 1000 : 10000,
+    };
+    function getTimeout(url) {
+        try {
+            const $timeout = url.searchParams.get('connect_timeout');
+            return $timeout ? Number.parseInt($timeout, 10) : undefined;
+        }
+        catch {
+            // Ignore errors in parsing the connect_timeout parameter
+            return undefined;
+        }
+    }
+}
+exports.getClientConfig = getClientConfig;
+//# sourceMappingURL=utils.js.map

package/dist/src/utils.js.map

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

package/dist/src/wfqueue.d.ts

@@ -0,0 +1,64 @@
+import { DBOSExecutor } from './dbos-executor';
+/**
+ * Limit the maximum number of functions started from a `WorkflowQueue`
+ *   per given time period.
+ * If the limit is 5 and the period is 10, no more than 5 functions can be
+ *   started per 10 seconds.
+ */
+interface QueueRateLimit {
+    /** Number of queue dispateches per `periodSec` */
+    limitPerPeriod: number;
+    /** Period of time during which `limitPerPeriod` queued workflows may be dispatched */
+    periodSec: number;
+}
+/**
+ * Limit the number of concurrent workflows running for a queue.
+ * This limit may be per worker or global
+ */
+export interface QueueParameters {
+    /** If defined, this limits the number of running workflows for a single DBOS process */
+    workerConcurrency?: number;
+    /** If defined, this limits the number of running workflows globally in the app */
+    concurrency?: number;
+    /** If set, this limits the rate at which queued workflows are started */
+    rateLimit?: QueueRateLimit;
+    /** If set, this queue supports priority */
+    priorityEnabled?: boolean;
+    /** If set, this queue supports partitioning */
+    partitionQueue?: boolean;
+}
+/**
+ * Settings structure for a named workflow queue.
+ * Workflow queues limit the rate and concurrency at which DBOS executes workflows.
+ * Queue policies apply to workflows started by `DBOS.startWorkflow`,
+ *   `DBOS.withWorkflowQueue`, etc.
+ */
+export declare class WorkflowQueue {
+    readonly name: string;
+    readonly concurrency?: number;
+    readonly rateLimit?: QueueRateLimit;
+    readonly workerConcurrency?: number;
+    readonly priorityEnabled: boolean;
+    readonly partitionQueue: boolean;
+    constructor(name: string);
+    /**
+     *
+     * @param name - Name to give the `WorkflowQueue`, accepted by `DBOS.startWorkflow`
+     * @param queueParameters - Policy for limiting workflow initiation rate and execution concurrency
+     */
+    constructor(name: string, queueParameters: QueueParameters);
+}
+declare class WFQueueRunner {
+    readonly wfQueuesByName: Map<string, WorkflowQueue>;
+    private isRunning;
+    private interruptResolve?;
+    private pollingIntervalMs;
+    private readonly minPollingIntervalMs;
+    private readonly maxPollingIntervalMs;
+    stop(): void;
+    dispatchLoop(exec: DBOSExecutor, listenQueuesArg: WorkflowQueue[] | null): Promise<void>;
+    logRegisteredEndpoints(exec: DBOSExecutor): void;
+}
+export declare const wfQueueRunner: WFQueueRunner;
+export {};
+//# sourceMappingURL=wfqueue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wfqueue.d.ts","sourceRoot":"","sources":["../../src/wfqueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C;;;;;GAKG;AACH,UAAU,cAAc;IACtB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAS;IAC1C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAS;gBAE7B,IAAI,EAAE,MAAM;IAExB;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe;CA6B3D;AAED,cAAM,aAAa;IACjB,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAa;IAEhE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkB;IAEvD,IAAI;IAQE,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA0F9F,sBAAsB,CAAC,IAAI,EAAE,YAAY;CAc1C;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/src/wfqueue.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wfQueueRunner = exports.WorkflowQueue = void 0;
+const dbos_1 = require("./dbos");
+const debugpoint_1 = require("./debugpoint");
+const utils_1 = require("./utils");
+/**
+ * Settings structure for a named workflow queue.
+ * Workflow queues limit the rate and concurrency at which DBOS executes workflows.
+ * Queue policies apply to workflows started by `DBOS.startWorkflow`,
+ *   `DBOS.withWorkflowQueue`, etc.
+ */
+class WorkflowQueue {
+    name;
+    concurrency;
+    rateLimit;
+    workerConcurrency;
+    priorityEnabled = false;
+    partitionQueue = false;
+    constructor(name, arg2, rateLimit) {
+        this.name = name;
+        if (dbos_1.DBOS.isInitialized()) {
+            dbos_1.DBOS.logger.warn(`Workflow queue '${name}' is being created after DBOS initialization and will not be considered for dequeue.`);
+        }
+        if (typeof arg2 === 'object' && arg2 !== null) {
+            // Handle the case where the second argument is QueueParameters
+            this.concurrency = arg2.concurrency;
+            this.rateLimit = arg2.rateLimit;
+            this.workerConcurrency = arg2.workerConcurrency;
+            this.priorityEnabled = arg2.priorityEnabled ?? false;
+            this.partitionQueue = arg2.partitionQueue ?? false;
+        }
+        else {
+            // Handle the case where the second argument is a number
+            this.concurrency = arg2;
+            this.rateLimit = rateLimit;
+        }
+        if (exports.wfQueueRunner.wfQueuesByName.has(name)) {
+            throw Error(`Workflow Queue '${name}' defined multiple times`);
+        }
+        exports.wfQueueRunner.wfQueuesByName.set(name, this);
+    }
+}
+exports.WorkflowQueue = WorkflowQueue;
+class WFQueueRunner {
+    wfQueuesByName = new Map();
+    isRunning = false;
+    interruptResolve;
+    pollingIntervalMs = 1000;
+    minPollingIntervalMs = 1000;
+    maxPollingIntervalMs = 120000;
+    stop() {
+        if (!this.isRunning)
+            return;
+        this.isRunning = false;
+        if (this.interruptResolve) {
+            this.interruptResolve();
+        }
+    }
+    async dispatchLoop(exec, listenQueuesArg) {
+        this.isRunning = true;
+        while (this.isRunning) {
+            // Wait for either the timeout or an interruption
+            let timer;
+            const timeoutPromise = new Promise((resolve) => {
+                timer = setTimeout(() => {
+                    resolve();
+                }, this.pollingIntervalMs);
+            });
+            await Promise.race([timeoutPromise, new Promise((_, reject) => (this.interruptResolve = reject))]).catch(() => {
+                exec.logger.debug('Workflow queue loop interrupted!');
+            }); // Interrupt sleep throws
+            clearTimeout(timer);
+            if (!this.isRunning) {
+                break;
+            }
+            let listenQueues;
+            if (listenQueuesArg !== null) {
+                // If explicitly listening for queues, use only those queues plus the internal queue
+                listenQueues = [...listenQueuesArg, this.wfQueuesByName.get(utils_1.INTERNAL_QUEUE_NAME)];
+            }
+            else {
+                // Else, listen to all declared queues
+                listenQueues = Array.from(this.wfQueuesByName.values());
+            }
+            // Check queues
+            for (const q of listenQueues) {
+                let wfids = [];
+                try {
+                    if (q.partitionQueue) {
+                        // For partitioned queues, get all partition keys and dequeue from each partition separately
+                        const partitionKeys = await exec.systemDatabase.getQueuePartitions(q.name);
+                        for (const partitionKey of partitionKeys) {
+                            const partitionWfids = await exec.systemDatabase.findAndMarkStartableWorkflows(q, exec.executorID, utils_1.globalParams.appVersion, partitionKey);
+                            wfids.push(...partitionWfids);
+                        }
+                    }
+                    else {
+                        // For non-partitioned queues, pass null to match workflows with queue_partition_key IS NULL
+                        wfids = await exec.systemDatabase.findAndMarkStartableWorkflows(q, exec.executorID, utils_1.globalParams.appVersion, undefined);
+                    }
+                }
+                catch (e) {
+                    const err = e;
+                    // Handle serialization errors and lock contention with backoff
+                    if ('code' in err && (err.code === '40001' || err.code === '55P03')) {
+                        // 40001: serialization_failure, 55P03: lock_not_available
+                        // Increase the polling interval on contention
+                        this.pollingIntervalMs = Math.min(this.maxPollingIntervalMs, this.pollingIntervalMs * 2.0);
+                        exec.logger.warn(`Contention detected in queue thread for ${q.name}. Increasing polling interval to ${(this.pollingIntervalMs / 1000).toFixed(2)}s.`);
+                    }
+                    else {
+                        exec.logger.warn(`Error getting startable workflows: ${err.message}`);
+                    }
+                    wfids = [];
+                }
+                if (wfids.length > 0) {
+                    await (0, debugpoint_1.debugTriggerPoint)(debugpoint_1.DEBUG_TRIGGER_WORKFLOW_QUEUE_START);
+                }
+                for (const wfid of wfids) {
+                    try {
+                        const _wfh = await exec.executeWorkflowId(wfid, { isQueueDispatch: true });
+                    }
+                    catch (e) {
+                        exec.logger.warn(`Could not execute workflow with id ${wfid}: ${e.message}`);
+                    }
+                }
+            }
+            // Gradually decrease the polling interval when there's no contention
+            this.pollingIntervalMs = Math.max(this.minPollingIntervalMs, this.pollingIntervalMs * 0.9);
+        }
+    }
+    logRegisteredEndpoints(exec) {
+        const logger = exec.logger;
+        logger.info('Workflow queues:');
+        for (const [qn, q] of this.wfQueuesByName) {
+            const conc = q.concurrency !== undefined ? `global concurrency limit: ${q.concurrency}` : 'No concurrency limit set';
+            logger.info(`    ${qn}: ${conc}`);
+            const workerconc = q.workerConcurrency !== undefined
+                ? `worker concurrency limit: ${q.workerConcurrency}`
+                : 'No worker concurrency limit set';
+            logger.info(`    ${qn}: ${workerconc}`);
+        }
+    }
+}
+exports.wfQueueRunner = new WFQueueRunner();
+//# sourceMappingURL=wfqueue.js.map

package/dist/src/wfqueue.js.map

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

package/dist/src/workflow.d.ts

@@ -0,0 +1,154 @@
+import { SystemDatabase } from './system_database';
+import { ConfiguredInstance } from './decorators';
+import { EnqueueOptions } from './system_database';
+export interface WorkflowParams {
+    workflowUUID?: string;
+    configuredInstance?: ConfiguredInstance | null;
+    queueName?: string;
+    executeWorkflow?: boolean;
+    timeoutMS?: number | null;
+    deadlineEpochMS?: number;
+    enqueueOptions?: EnqueueOptions;
+}
+export declare const DEFAULT_MAX_RECOVERY_ATTEMPTS = 100;
+/**
+ * Configuration for `SolidActions.workflow` functions
+ */
+export interface WorkflowConfig {
+    /** Maximum number of recovery attempts to make on workflow function, before sending to dead-letter queue */
+    maxRecoveryAttempts?: number;
+    /** Name to use */
+    name?: string;
+}
+export interface WorkflowStatus {
+    readonly workflowID: string;
+    readonly status: string;
+    readonly workflowName: string;
+    readonly workflowClassName: string;
+    readonly workflowConfigName?: string;
+    readonly queueName?: string;
+    readonly authenticatedUser?: string;
+    readonly assumedRole?: string;
+    readonly authenticatedRoles?: string[];
+    readonly input?: unknown[];
+    readonly output?: unknown;
+    readonly error?: unknown;
+    readonly executorId?: string;
+    readonly applicationVersion?: string;
+    readonly createdAt: number;
+    readonly updatedAt?: number;
+    readonly timeoutMS?: number;
+    readonly deadlineEpochMS?: number;
+    readonly deduplicationID?: string;
+    readonly priority: number;
+    readonly queuePartitionKey?: string;
+    readonly forkedFrom?: string;
+    readonly applicationID: string;
+    readonly request?: object;
+    readonly recoveryAttempts?: number;
+}
+export interface GetWorkflowsInput {
+    workflowIDs?: string[];
+    workflowName?: string;
+    status?: 'PENDING' | 'SUCCESS' | 'ERROR' | 'MAX_RECOVERY_ATTEMPTS_EXCEEDED' | 'CANCELLED' | 'ENQUEUED';
+    startTime?: string;
+    endTime?: string;
+    authenticatedUser?: string;
+    applicationVersion?: string;
+    workflow_id_prefix?: string;
+    queueName?: string;
+    queuesOnly?: boolean;
+    forkedFrom?: string;
+    limit?: number;
+    offset?: number;
+    sortDesc?: boolean;
+    loadInput?: boolean;
+    loadOutput?: boolean;
+}
+export interface GetPendingWorkflowsOutput {
+    workflowUUID: string;
+    queueName?: string;
+}
+export interface StepInfo {
+    readonly functionID: number;
+    readonly name: string;
+    readonly output: unknown;
+    readonly error: Error | null;
+    readonly childWorkflowID: string | null;
+    readonly startedAtEpochMs?: number;
+    readonly completedAtEpochMs?: number;
+}
+export interface PgTransactionId {
+    txid: string;
+}
+/** Enumeration of values for workflow status */
+export declare const StatusString: {
+    /** Workflow has may be running */
+    readonly PENDING: "PENDING";
+    /** Workflow complete with return value */
+    readonly SUCCESS: "SUCCESS";
+    /** Workflow complete with error thrown */
+    readonly ERROR: "ERROR";
+    /** Workflow has exceeded its maximum number of execution or recovery attempts */
+    readonly MAX_RECOVERY_ATTEMPTS_EXCEEDED: "MAX_RECOVERY_ATTEMPTS_EXCEEDED";
+    /** Workflow is being, or has been, cancelled */
+    readonly CANCELLED: "CANCELLED";
+    /** Workflow is on a `WorkflowQueue` and has not yet started */
+    readonly ENQUEUED: "ENQUEUED";
+};
+export declare function isWorkflowActive(status: string): boolean;
+/**
+ * Object representing an active or completed workflow execution, identified by the workflow UUID.
+ * Allows retrieval of information about the workflow.
+ */
+export interface WorkflowHandle<R> {
+    /**
+     * Retrieve the workflow's status.
+     * Statuses are updated asynchronously.
+     */
+    getStatus(): Promise<WorkflowStatus | null>;
+    /**
+     * Await workflow completion and return its result.
+     */
+    getResult(): Promise<R>;
+    /**
+     * Return the workflow's ID
+     */
+    get workflowID(): string;
+    /**
+     * Return the workflow's inputs
+     */
+    getWorkflowInputs<T extends any[]>(): Promise<T>;
+}
+export interface InternalWFHandle<R> extends WorkflowHandle<R> {
+    getResult(funcIdForGet?: number): Promise<R>;
+}
+/**
+ * The handle returned when invoking a workflow with SolidActionsExecutor.workflow
+ */
+export declare class InvokedHandle<R> implements InternalWFHandle<R> {
+    readonly systemDatabase: SystemDatabase;
+    readonly workflowPromise: Promise<R>;
+    readonly workflowUUID: string;
+    readonly workflowName: string;
+    constructor(systemDatabase: SystemDatabase, workflowPromise: Promise<R>, workflowUUID: string, workflowName: string);
+    getWorkflowUUID(): string;
+    get workflowID(): string;
+    getStatus(): Promise<WorkflowStatus | null>;
+    getResult(funcIdForGet?: number): Promise<R>;
+    getWorkflowInputs<T extends any[]>(): Promise<T>;
+}
+/**
+ * The handle returned when retrieving a workflow with SolidActionsExecutor.retrieve
+ */
+export declare class RetrievedHandle<R> implements InternalWFHandle<R> {
+    readonly systemDatabase: SystemDatabase;
+    readonly workflowUUID: string;
+    constructor(systemDatabase: SystemDatabase, workflowUUID: string);
+    getWorkflowUUID(): string;
+    get workflowID(): string;
+    getStatus(): Promise<WorkflowStatus | null>;
+    getResult(funcIdForGet?: number): Promise<R>;
+    getWorkflowInputs<T extends any[]>(): Promise<T>;
+}
+//# sourceMappingURL=workflow.d.ts.map

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

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

package/dist/src/workflow.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetrievedHandle = exports.InvokedHandle = exports.isWorkflowActive = exports.StatusString = exports.DEFAULT_MAX_RECOVERY_ATTEMPTS = void 0;
+const serialization_1 = require("./serialization");
+const solidactions_1 = require("./solidactions");
+const solidactions_executor_1 = require("./solidactions-executor");
+exports.DEFAULT_MAX_RECOVERY_ATTEMPTS = 100;
+/** Enumeration of values for workflow status */
+exports.StatusString = {
+    /** Workflow has may be running */
+    PENDING: 'PENDING',
+    /** Workflow complete with return value */
+    SUCCESS: 'SUCCESS',
+    /** Workflow complete with error thrown */
+    ERROR: 'ERROR',
+    /** Workflow has exceeded its maximum number of execution or recovery attempts */
+    MAX_RECOVERY_ATTEMPTS_EXCEEDED: 'MAX_RECOVERY_ATTEMPTS_EXCEEDED',
+    /** Workflow is being, or has been, cancelled */
+    CANCELLED: 'CANCELLED',
+    /** Workflow is on a `WorkflowQueue` and has not yet started */
+    ENQUEUED: 'ENQUEUED',
+};
+function isWorkflowActive(status) {
+    return status === exports.StatusString.PENDING || status === exports.StatusString.ENQUEUED;
+}
+exports.isWorkflowActive = isWorkflowActive;
+/**
+ * The handle returned when invoking a workflow with SolidActionsExecutor.workflow
+ */
+class InvokedHandle {
+    systemDatabase;
+    workflowPromise;
+    workflowUUID;
+    workflowName;
+    constructor(systemDatabase, workflowPromise, workflowUUID, workflowName) {
+        this.systemDatabase = systemDatabase;
+        this.workflowPromise = workflowPromise;
+        this.workflowUUID = workflowUUID;
+        this.workflowName = workflowName;
+    }
+    getWorkflowUUID() {
+        return this.workflowUUID;
+    }
+    get workflowID() {
+        return this.workflowUUID;
+    }
+    async getStatus() {
+        return await solidactions_1.SolidActions.getWorkflowStatus(this.workflowUUID);
+    }
+    async getResult(funcIdForGet) {
+        return await (0, solidactions_1.runInternalStep)(async () => {
+            return await this.workflowPromise;
+        }, 'SolidActions.getResult', this.workflowUUID, funcIdForGet);
+    }
+    async getWorkflowInputs() {
+        const status = (await this.systemDatabase.getWorkflowStatus(this.workflowUUID));
+        return this.systemDatabase.getSerializer().parse(status.input);
+    }
+}
+exports.InvokedHandle = InvokedHandle;
+/**
+ * The handle returned when retrieving a workflow with SolidActionsExecutor.retrieve
+ */
+class RetrievedHandle {
+    systemDatabase;
+    workflowUUID;
+    constructor(systemDatabase, workflowUUID) {
+        this.systemDatabase = systemDatabase;
+        this.workflowUUID = workflowUUID;
+    }
+    getWorkflowUUID() {
+        return this.workflowUUID;
+    }
+    get workflowID() {
+        return this.workflowUUID;
+    }
+    async getStatus() {
+        return await solidactions_1.SolidActions.getWorkflowStatus(this.workflowUUID);
+    }
+    async getResult(funcIdForGet) {
+        return (await solidactions_1.SolidActions.getResultInternal(this.workflowUUID, undefined, undefined, funcIdForGet));
+    }
+    async getWorkflowInputs() {
+        const status = (await this.systemDatabase.getWorkflowStatus(this.workflowUUID));
+        return this.systemDatabase.getSerializer().parse(status.input);
+    }
+}
+exports.RetrievedHandle = RetrievedHandle;
+(0, serialization_1.registerSerializationRecipe)({
+    name: 'SolidActions.WorkflowHandle',
+    isApplicable: (v) => {
+        return v instanceof RetrievedHandle || v instanceof InvokedHandle;
+    },
+    serialize: (v) => {
+        return { wfid: v.workflowID };
+    },
+    deserialize: (s) => new RetrievedHandle(solidactions_executor_1.SolidActionsExecutor.globalInstance.systemDatabase, s.wfid),
+});
+//# sourceMappingURL=workflow.js.map

package/dist/src/workflow.js.map

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

package/dist/src/workflow_management.d.ts

@@ -0,0 +1,15 @@
+import type { SystemDatabase, WorkflowStatusInternal } from './system_database';
+import type { StepInfo, WorkflowStatus, GetWorkflowsInput } from './workflow';
+import { SolidActionsSerializer } from './serialization';
+export declare function listWorkflows(sysdb: SystemDatabase, input: GetWorkflowsInput): Promise<WorkflowStatus[]>;
+export declare function listQueuedWorkflows(sysdb: SystemDatabase, input: GetWorkflowsInput): Promise<WorkflowStatus[]>;
+export declare function getWorkflow(sysdb: SystemDatabase, workflowID: string): Promise<WorkflowStatus | undefined>;
+export declare function listWorkflowSteps(sysdb: SystemDatabase, workflowID: string): Promise<StepInfo[] | undefined>;
+export declare function forkWorkflow(sysdb: SystemDatabase, workflowID: string, startStep: number, options?: {
+    newWorkflowID?: string;
+    applicationVersion?: string;
+    timeoutMS?: number;
+}): Promise<string>;
+export declare function toWorkflowStatus(internal: WorkflowStatusInternal, serializer: SolidActionsSerializer): WorkflowStatus;
+export declare function globalTimeout(sysdb: SystemDatabase, cutoffEpochTimestampMs: number): Promise<void>;
+//# sourceMappingURL=workflow_management.d.ts.map