@proompteng/temporal-bun-sdk 0.1.0

package/dist/src/workflow/determinism.js

@@ -0,0 +1,147 @@
+import { WorkflowNondeterminismError } from './errors';
+export const snapshotToDeterminismState = (snapshot) => ({
+    commandHistory: snapshot.commandHistory.map((entry) => ({
+        intent: entry.intent,
+        metadata: entry.metadata ? { ...entry.metadata } : undefined,
+    })),
+    randomValues: [...snapshot.randomValues],
+    timeValues: [...snapshot.timeValues],
+    failureMetadata: snapshot.failureMetadata ? { ...snapshot.failureMetadata } : undefined,
+});
+export class DeterminismGuard {
+    #allowBypass;
+    #previous;
+    snapshot;
+    #commandIndex = 0;
+    #randomIndex = 0;
+    #timeIndex = 0;
+    constructor(options = {}) {
+        this.#allowBypass = options.allowBypass ?? false;
+        this.#previous = options.previousState;
+        this.snapshot = {
+            commandHistory: [],
+            randomValues: [],
+            timeValues: [],
+        };
+    }
+    recordCommand(intent) {
+        let kind = 'new';
+        if (!this.#allowBypass && this.#previous) {
+            const previousEntry = this.#previous.commandHistory[this.#commandIndex];
+            if (previousEntry) {
+                const expected = previousEntry.intent;
+                if (!expected) {
+                    throw new WorkflowNondeterminismError('Workflow emitted new command on replay', {
+                        hint: `commandIndex=${this.#commandIndex}`,
+                        received: intent,
+                    });
+                }
+                if (!intentsEqual(expected, intent)) {
+                    throw new WorkflowNondeterminismError('Workflow command intent mismatch during replay', {
+                        hint: `commandIndex=${this.#commandIndex}`,
+                        expected,
+                        received: intent,
+                    });
+                }
+                kind = 'replay';
+            }
+        }
+        this.snapshot.commandHistory.push({ intent });
+        this.#commandIndex += 1;
+        return kind;
+    }
+    nextRandom(generate) {
+        if (!this.#allowBypass && this.#previous) {
+            const expected = this.#previous.randomValues[this.#randomIndex];
+            if (expected === undefined) {
+                throw new WorkflowNondeterminismError('Workflow generated new random value during replay', {
+                    hint: `randomIndex=${this.#randomIndex}`,
+                });
+            }
+            this.snapshot.randomValues.push(expected);
+            this.#randomIndex += 1;
+            return expected;
+        }
+        const value = generate();
+        if (!Number.isFinite(value)) {
+            throw new WorkflowNondeterminismError('Random value must be a finite number', {
+                received: value,
+            });
+        }
+        this.snapshot.randomValues.push(value);
+        this.#randomIndex += 1;
+        return value;
+    }
+    nextTime(generate) {
+        if (!this.#allowBypass && this.#previous) {
+            const expected = this.#previous.timeValues[this.#timeIndex];
+            if (expected === undefined) {
+                throw new WorkflowNondeterminismError('Workflow generated new time value during replay', {
+                    hint: `timeIndex=${this.#timeIndex}`,
+                });
+            }
+            this.snapshot.timeValues.push(expected);
+            this.#timeIndex += 1;
+            return expected;
+        }
+        const value = generate();
+        if (!Number.isFinite(value)) {
+            throw new WorkflowNondeterminismError('Time value must be a finite number', {
+                received: value,
+            });
+        }
+        this.snapshot.timeValues.push(value);
+        this.#timeIndex += 1;
+        return value;
+    }
+}
+export const intentsEqual = (a, b) => {
+    if (!a || !b) {
+        return a === b;
+    }
+    if (a.kind !== b.kind) {
+        return false;
+    }
+    if (a.sequence !== b.sequence) {
+        return false;
+    }
+    const signatureA = stableIntentSignature(a);
+    const signatureB = stableIntentSignature(b);
+    return signatureA === signatureB;
+};
+const stableIntentSignature = (intent) => stableStringify(intent, (_key, value) => {
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (value instanceof Uint8Array) {
+        return Buffer.from(value).toString('base64');
+    }
+    if (value && typeof value === 'object' && 'kind' in value && 'sequence' in value) {
+        return value;
+    }
+    return value;
+});
+const stableStringify = (value, replacer) => {
+    const seen = new WeakSet();
+    const stable = (key, input) => {
+        if (replacer) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            input = replacer.call(this, key, input);
+        }
+        if (!input || typeof input !== 'object') {
+            return input;
+        }
+        if (seen.has(input)) {
+            return '[Circular]';
+        }
+        seen.add(input);
+        if (Array.isArray(input)) {
+            return input.map((item, index) => stable(String(index), item));
+        }
+        const entries = Object.entries(input).map(([k, v]) => [k, stable(k, v)]);
+        entries.sort(([lhs], [rhs]) => lhs.localeCompare(rhs));
+        return Object.fromEntries(entries);
+    };
+    return JSON.stringify(stable('', value));
+};
+//# sourceMappingURL=determinism.js.map

package/dist/src/workflow/determinism.js.map

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

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

@@ -0,0 +1,37 @@
+export declare class WorkflowError extends Error {
+    constructor(message: string);
+}
+import type { DeterminismMismatch } from './replay';
+export interface WorkflowNondeterminismDetails {
+    readonly expected?: unknown;
+    readonly received?: unknown;
+    readonly hint?: string;
+    readonly mismatches?: DeterminismMismatch[];
+    readonly workflow?: {
+        readonly namespace: string;
+        readonly taskQueue: string;
+        readonly workflowId: string;
+        readonly runId: string;
+        readonly workflowType?: string;
+    };
+    readonly workflowTaskAttempt?: number;
+    readonly stickyCache?: {
+        readonly cachedEventId?: string | null;
+        readonly historyLastEventId?: string | null;
+    };
+}
+export declare class WorkflowNondeterminismError extends WorkflowError {
+    readonly details?: WorkflowNondeterminismDetails;
+    constructor(message: string, details?: WorkflowNondeterminismDetails);
+}
+export declare class WorkflowBlockedError extends WorkflowError {
+    readonly reason: string;
+    constructor(reason: string);
+}
+export declare class WorkflowDeterminismGuardError extends WorkflowError {
+    constructor(message: string);
+}
+export declare class ContinueAsNewWorkflowError extends WorkflowError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/workflow/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;QAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAC/B,CAAA;IACD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC5C,CAAA;CACF;AAED,qBAAa,2BAA4B,SAAQ,aAAa;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAA;gBAEpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,6BAA6B;CAKrE;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,MAAM,EAAE,MAAM;CAK3B;AAED,qBAAa,6BAA8B,SAAQ,aAAa;gBAClD,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,0BAA2B,SAAQ,aAAa;;CAK5D"}

package/dist/src/workflow/errors.js

@@ -0,0 +1,35 @@
+export class WorkflowError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowError';
+    }
+}
+export class WorkflowNondeterminismError extends WorkflowError {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = 'WorkflowNondeterminismError';
+        this.details = details;
+    }
+}
+export class WorkflowBlockedError extends WorkflowError {
+    reason;
+    constructor(reason) {
+        super(`Workflow blocked: ${reason}`);
+        this.name = 'WorkflowBlockedError';
+        this.reason = reason;
+    }
+}
+export class WorkflowDeterminismGuardError extends WorkflowError {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkflowDeterminismGuardError';
+    }
+}
+export class ContinueAsNewWorkflowError extends WorkflowError {
+    constructor() {
+        super('Workflow requested continue-as-new');
+        this.name = 'ContinueAsNewWorkflowError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/workflow/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/workflow/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAuBD,MAAM,OAAO,2BAA4B,SAAQ,aAAa;IACnD,OAAO,CAAgC;IAEhD,YAAY,OAAe,EAAE,OAAuC;QAClE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAA;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAC5C,MAAM,CAAQ;IAEvB,YAAY,MAAc;QACxB,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,aAAa;IAC9D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAA;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D;QACE,KAAK,CAAC,oCAAoC,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAA;IAC1C,CAAC;CACF"}

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

@@ -0,0 +1,35 @@
+import type { DataConverter } from '../common/payloads';
+import { type Command } from '../proto/temporal/api/command/v1/message_pb';
+import { type WorkflowCommandIntent } from './commands';
+import { type ActivityResolution } from './context';
+import { type WorkflowDeterminismState } from './determinism';
+import type { WorkflowRegistry } from './registry';
+export interface ExecuteWorkflowInput {
+    readonly workflowType: string;
+    readonly workflowId: string;
+    readonly runId: string;
+    readonly namespace: string;
+    readonly taskQueue: string;
+    readonly arguments: unknown;
+    readonly determinismState?: WorkflowDeterminismState;
+    readonly activityResults?: Map<string, ActivityResolution>;
+}
+export type WorkflowCompletionStatus = 'completed' | 'failed' | 'continued-as-new' | 'pending';
+export interface WorkflowExecutionOutput {
+    readonly commands: Command[];
+    readonly intents: readonly WorkflowCommandIntent[];
+    readonly determinismState: WorkflowDeterminismState;
+    readonly completion: WorkflowCompletionStatus;
+    readonly result?: unknown;
+    readonly failure?: unknown;
+}
+export interface WorkflowExecutorOptions {
+    registry: WorkflowRegistry;
+    dataConverter: DataConverter;
+}
+export declare class WorkflowExecutor {
+    #private;
+    constructor(options: WorkflowExecutorOptions);
+    execute(input: ExecuteWorkflowInput): Promise<WorkflowExecutionOutput>;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/workflow/executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,6CAA6C,CAAA;AAGpD,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAgD,KAAK,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAE3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAA;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;CAC3D;AAED,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAAA;AAE9F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAA;IAClD,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAA;IACnD,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED,qBAAa,gBAAgB;;gBAIf,OAAO,EAAE,uBAAuB;IAKtC,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAsK7E"}

package/dist/src/workflow/executor.js

@@ -0,0 +1,178 @@
+import { create } from '@bufbuild/protobuf';
+import { Effect, Exit } from 'effect';
+import * as Cause from 'effect/Cause';
+import * as Chunk from 'effect/Chunk';
+import * as Option from 'effect/Option';
+import * as Schema from 'effect/Schema';
+import { encodeValuesToPayloads } from '../common/payloads/converter';
+import { encodeErrorToFailure, encodeFailurePayloads } from '../common/payloads/failure';
+import { CommandSchema, CompleteWorkflowExecutionCommandAttributesSchema, FailWorkflowExecutionCommandAttributesSchema, } from '../proto/temporal/api/command/v1/message_pb';
+import { PayloadsSchema } from '../proto/temporal/api/common/v1/message_pb';
+import { CommandType } from '../proto/temporal/api/enums/v1/command_type_pb';
+import { materializeCommands } from './commands';
+import { createWorkflowContext, } from './context';
+import { DeterminismGuard, snapshotToDeterminismState } from './determinism';
+import { ContinueAsNewWorkflowError, WorkflowBlockedError, WorkflowNondeterminismError } from './errors';
+export class WorkflowExecutor {
+    #registry;
+    #dataConverter;
+    constructor(options) {
+        this.#registry = options.registry;
+        this.#dataConverter = options.dataConverter;
+    }
+    async execute(input) {
+        const info = {
+            namespace: input.namespace,
+            taskQueue: input.taskQueue,
+            workflowId: input.workflowId,
+            runId: input.runId,
+            workflowType: input.workflowType,
+        };
+        const definition = this.#registry.get(input.workflowType);
+        const normalizedArguments = this.#normalizeArguments(input.arguments, definition.decodeArgumentsAsArray);
+        const decodedEffect = Schema.decodeUnknown(definition.schema)(normalizedArguments);
+        const guard = new DeterminismGuard({ previousState: input.determinismState });
+        let lastCommandContext;
+        const workflowEffect = Effect.flatMap(decodedEffect, (parsed) => {
+            const created = createWorkflowContext({
+                input: parsed,
+                info,
+                determinismGuard: guard,
+                activityResults: input.activityResults,
+            });
+            lastCommandContext = created.commandContext;
+            return Effect.flatMap(definition.handler(created.context), (result) => Effect.sync(() => ({ result, commandContext: created.commandContext })));
+        });
+        const exit = await Effect.runPromiseExit(workflowEffect);
+        const rawSnapshot = guard.snapshot;
+        const determinismState = snapshotToDeterminismState(rawSnapshot);
+        if (Exit.isSuccess(exit)) {
+            const commands = await this.#buildSuccessCommands(exit.value.commandContext, exit.value.result);
+            return {
+                commands,
+                intents: exit.value.commandContext.intents,
+                determinismState,
+                completion: 'completed',
+                result: exit.value.result,
+            };
+        }
+        const error = this.#resolveError(exit.cause);
+        const continueAsNewError = unwrapWorkflowError(error, ContinueAsNewWorkflowError);
+        if (continueAsNewError) {
+            const intents = rawSnapshot.commandHistory.map((entry) => entry.intent);
+            const commands = await materializeCommands(intents, { dataConverter: this.#dataConverter });
+            return {
+                commands,
+                intents,
+                determinismState,
+                completion: 'continued-as-new',
+            };
+        }
+        const nondeterminismError = unwrapWorkflowError(error, WorkflowNondeterminismError);
+        if (nondeterminismError) {
+            throw nondeterminismError;
+        }
+        const blockedError = unwrapWorkflowError(error, WorkflowBlockedError);
+        if (blockedError) {
+            const contextForPending = lastCommandContext ??
+                (() => {
+                    throw new Error('Workflow pending without command context');
+                })();
+            const pendingCommands = await materializeCommands(contextForPending.intents, {
+                dataConverter: this.#dataConverter,
+            });
+            return {
+                commands: pendingCommands,
+                intents: contextForPending.intents,
+                determinismState,
+                completion: 'pending',
+            };
+        }
+        const failureCommands = await this.#buildFailureCommands(error);
+        return {
+            commands: failureCommands,
+            intents: [],
+            determinismState,
+            completion: 'failed',
+            failure: error,
+        };
+    }
+    #resolveError(cause) {
+        if (cause === undefined) {
+            return new Error('Workflow failed');
+        }
+        const failure = Cause.failureOption(cause);
+        if (Option.isSome(failure)) {
+            return failure.value;
+        }
+        const defects = Cause.defects(cause);
+        if (Chunk.isNonEmpty(defects)) {
+            return Chunk.unsafeHead(defects);
+        }
+        return new Error(Cause.pretty(cause));
+    }
+    async #buildSuccessCommands(commandContext, result) {
+        const commandIntents = commandContext.intents;
+        const materialized = await materializeCommands(commandIntents, { dataConverter: this.#dataConverter });
+        const completionCommands = await this.#buildCompleteCommands(result);
+        return [...materialized, ...completionCommands];
+    }
+    async #buildCompleteCommands(result) {
+        const payloads = await encodeValuesToPayloads(this.#dataConverter, result === undefined ? [] : [result]);
+        const completionAttributes = create(CompleteWorkflowExecutionCommandAttributesSchema, {
+            result: payloads && payloads.length > 0 ? create(PayloadsSchema, { payloads }) : undefined,
+        });
+        return [
+            create(CommandSchema, {
+                commandType: CommandType.COMPLETE_WORKFLOW_EXECUTION,
+                attributes: {
+                    case: 'completeWorkflowExecutionCommandAttributes',
+                    value: completionAttributes,
+                },
+            }),
+        ];
+    }
+    async #buildFailureCommands(cause) {
+        const failure = await encodeErrorToFailure(this.#dataConverter, cause);
+        const encoded = await encodeFailurePayloads(this.#dataConverter, failure);
+        const failAttributes = create(FailWorkflowExecutionCommandAttributesSchema, {
+            failure: encoded,
+        });
+        return [
+            create(CommandSchema, {
+                commandType: CommandType.FAIL_WORKFLOW_EXECUTION,
+                attributes: {
+                    case: 'failWorkflowExecutionCommandAttributes',
+                    value: failAttributes,
+                },
+            }),
+        ];
+    }
+    #normalizeArguments(raw, expectArray) {
+        if (expectArray) {
+            return raw ?? [];
+        }
+        if (Array.isArray(raw)) {
+            if (raw.length === 0) {
+                return undefined;
+            }
+            if (raw.length === 1) {
+                return raw[0];
+            }
+        }
+        return raw;
+    }
+}
+const unwrapWorkflowError = (error, ctor) => {
+    if (error instanceof ctor) {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'cause' in error) {
+        const cause = error.cause;
+        if (cause instanceof ctor) {
+            return cause;
+        }
+    }
+    return undefined;
+};
+//# sourceMappingURL=executor.js.map

package/dist/src/workflow/executor.js.map

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

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

@@ -0,0 +1,8 @@
+export * from './commands';
+export * from './context';
+export * from './definition';
+export * from './determinism';
+export * from './errors';
+export { WorkflowExecutor } from './executor';
+export { WorkflowRegistry } from './registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/src/workflow/index.js

@@ -0,0 +1,8 @@
+export * from './commands';
+export * from './context';
+export * from './definition';
+export * from './determinism';
+export * from './errors';
+export { WorkflowExecutor } from './executor';
+export { WorkflowRegistry } from './registry';
+//# sourceMappingURL=index.js.map

package/dist/src/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,9 @@
+import { type WorkflowDefinition, type WorkflowDefinitions, type WorkflowHandler } from './definition';
+export declare class WorkflowRegistry {
+    #private;
+    register<I, O>(definition: WorkflowDefinition<I, O>): void;
+    registerMany(definitions: WorkflowDefinitions | Record<string, WorkflowDefinition<unknown, unknown> | WorkflowHandler<readonly unknown[], unknown>>): void;
+    get(name: string): WorkflowDefinition<unknown, unknown>;
+    list(): WorkflowDefinition<unknown, unknown>[];
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/workflow/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAItH,qBAAa,gBAAgB;;IAG3B,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAO1D,YAAY,CACV,WAAW,EACP,mBAAmB,GACnB,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,eAAe,CAAC,SAAS,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,GACtG,IAAI;IAqBP,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC;IAQvD,IAAI,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;CAG/C"}

package/dist/src/workflow/registry.js

@@ -0,0 +1,51 @@
+import * as Schema from 'effect/Schema';
+import { defineWorkflow } from './definition';
+const defaultSchema = Schema.Array(Schema.Unknown);
+export class WorkflowRegistry {
+    #definitions = new Map();
+    register(definition) {
+        if (!definition || typeof definition.name !== 'string' || definition.name.length === 0) {
+            throw new Error('Workflow definition must declare a non-empty name');
+        }
+        this.#definitions.set(definition.name, definition);
+    }
+    registerMany(definitions) {
+        if (Array.isArray(definitions)) {
+            for (const definition of definitions) {
+                this.register(definition);
+            }
+            return;
+        }
+        for (const [name, entry] of Object.entries(definitions)) {
+            if (isWorkflowDefinition(entry)) {
+                this.register(entry);
+                continue;
+            }
+            if (typeof entry === 'function') {
+                this.register(defineWorkflow(name, defaultSchema, entry));
+                continue;
+            }
+            throw new Error(`Invalid workflow definition for ${name}`);
+        }
+    }
+    get(name) {
+        const definition = this.#definitions.get(name);
+        if (!definition) {
+            throw new Error(`Workflow definition not found for type ${name}`);
+        }
+        return definition;
+    }
+    list() {
+        return Array.from(this.#definitions.values());
+    }
+}
+const isWorkflowDefinition = (value) => {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const record = value;
+    return (typeof record.name === 'string' &&
+        typeof record.handler === 'function' &&
+        typeof record.decodeArgumentsAsArray === 'boolean');
+};
+//# sourceMappingURL=registry.js.map

package/dist/src/workflow/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/workflow/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,cAAc,EAA2E,MAAM,cAAc,CAAA;AAEtH,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAsC,CAAA;AAEvF,MAAM,OAAO,gBAAgB;IAC3B,YAAY,GAAG,IAAI,GAAG,EAAgD,CAAA;IAEtE,QAAQ,CAAO,UAAoC;QACjD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAkD,CAAC,CAAA;IAC5F,CAAC;IAED,YAAY,CACV,WAEuG;QAEvG,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;YAC3B,CAAC;YACD,OAAM;QACR,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACxD,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;gBACpB,SAAQ;YACV,CAAC;YACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAA;gBACzD,SAAQ;YACV,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAA;QACnE,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/C,CAAC;CACF;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAiD,EAAE;IAC7F,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAA6C,CAAA;IAC5D,OAAO,CACL,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;QACpC,OAAO,MAAM,CAAC,sBAAsB,KAAK,SAAS,CACnD,CAAA;AACH,CAAC,CAAA"}