@temelj/workflow 0.0.0-alpha.3 → 0.0.0-alpha.4

package/dist/types/telemetry.d.mts

@@ -1,60 +1,56 @@
-import { WorkflowResolvedStepRetryConfig } from "./retry.mjs";
-import { WorkflowStepMetadata } from "./step.mjs";
-import { WorkflowRunSummary, WorkflowRunSummaryOptions } from "./summary.mjs";
-import { ObservationEventMap } from "./observation.mjs";
+import { ResolvedRetryConfig } from "./retry.mjs";
+import { ListRunsOptions } from "./run-list.mjs";
+import { StepMetadata } from "./step.mjs";
+import { RunSummary } from "./summary.mjs";
+import { ObservationEventArgs } from "./observation.mjs";
 import { ExecutionResult } from "./result.mjs";
-import { WorkflowRunRecord } from "./run.mjs";
-import { z } from "zod";
+import { RunRecord } from "./run.mjs";
 //#region src/types/telemetry.d.ts
-declare const workflowTelemetryContextSchema: z.ZodObject<{
-  traceparent: z.ZodOptional<z.ZodString>;
-  tracestate: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 /** Persisted W3C trace context captured when a workflow run is created. */
-interface TelemetryContext {
+export interface TelemetryContext {
   readonly traceparent?: string;
   readonly tracestate?: string;
 }
 /** Context passed to telemetry adapters around workflow run execution. */
-interface RunTelemetryContext {
-  readonly run: WorkflowRunRecord;
+export interface RunTelemetryContext {
+  readonly run: RunRecord;
   readonly traceContext?: TelemetryContext;
 }
 /** Context passed to telemetry adapters after workflow run execution finishes. */
-interface RunTelemetryResultContext<TOutput = unknown> extends RunTelemetryContext {
+export interface RunTelemetryResultContext<TOutput = unknown> extends RunTelemetryContext {
   readonly result?: ExecutionResult<TOutput>;
   readonly error?: unknown;
 }
 /** Context passed to telemetry adapters around durable task callback execution. */
-interface StepTelemetryContext {
-  readonly run: WorkflowRunRecord;
-  readonly step: WorkflowStepMetadata;
+export interface StepTelemetryContext {
+  readonly run: RunRecord;
+  readonly step: StepMetadata;
   readonly attempt: number;
-  readonly retry: WorkflowResolvedStepRetryConfig;
+  readonly retry: ResolvedRetryConfig;
   readonly timeoutAt?: Temporal.Instant;
 }
 /** Context passed to telemetry adapters after durable task callback execution finishes. */
-interface StepTelemetryResultContext extends StepTelemetryContext {
+export interface StepTelemetryResultContext extends StepTelemetryContext {
   readonly error?: unknown;
 }
 /** Storage/backend operation names observed by the default workflow store. */
-type StorageTelemetryOperation = "get" | "tryGet" | "set" | "trySet" | "compareAndSet" | "tryCompareAndSet" | "compareAndSetMany" | "tryCompareAndSetMany" | "has" | "tryHas" | "delete" | "tryDelete" | "getMany" | "tryGetMany" | "setMany" | "trySetMany" | "deleteMany" | "tryDeleteMany" | "keys" | "tryKeys" | "entries" | "tryEntries" | "clear" | "tryClear" | "watch" | "unwatch" | "dispose" | "tryDispose";
+export type StorageTelemetryOperation = "get" | "tryGet" | "set" | "trySet" | "compareAndSet" | "tryCompareAndSet" | "compareAndSetMany" | "tryCompareAndSetMany" | "has" | "tryHas" | "delete" | "tryDelete" | "getMany" | "tryGetMany" | "setMany" | "trySetMany" | "deleteMany" | "tryDeleteMany" | "keys" | "tryKeys" | "entries" | "tryEntries" | "clear" | "tryClear" | "watch" | "unwatch" | "dispose" | "tryDispose";
 /** Context passed to telemetry adapters around workflow storage/backend operations. */
-interface StorageTelemetryContext {
+export interface StorageTelemetryContext {
   readonly operation: StorageTelemetryOperation;
   readonly backend: string;
 }
 /** Minimal engine read model exposed to telemetry adapters after engine creation. */
-interface TelemetryEngine {
+export interface TelemetryEngine {
   /** Returns aggregate run metrics for runs matching optional filters. */
-  getRunSummary(options?: WorkflowRunSummaryOptions): Promise<WorkflowRunSummary>;
+  getRunSummary(options?: ListRunsOptions): Promise<RunSummary>;
 }
 /** Optional telemetry hooks used to observe running workflow behavior. */
-interface Telemetry {
+export interface Telemetry {
   /** Captures ambient trace context for a newly-created workflow run. */
   captureContext?(): TelemetryContext | undefined;
   /** Runs a workflow execution callback with telemetry context. */
-  withRunExecution?<T>(context: RunTelemetryContext, callback: () => Promise<T>): Promise<T>;
+  withRunExecution?<T extends ExecutionResult>(context: RunTelemetryContext, callback: () => Promise<T>): Promise<T>;
   /** Runs a durable task callback with telemetry context. */
   withStepExecution?<T>(context: StepTelemetryContext, callback: () => Promise<T>): Promise<T>;
   /** Runs a workflow storage/backend operation callback with telemetry context. */
@@ -64,11 +60,10 @@ interface Telemetry {
   /** Observes the final outcome of a durable task callback. */
   recordStepExecution?(context: StepTelemetryResultContext): void;
   /** Observes committed workflow observation events. */
-  observe?<Key extends keyof ObservationEventMap>(name: Key, payload: ObservationEventMap[Key]): void;
+  observe?(...event: ObservationEventArgs): void;
   /** Binds the telemetry adapter to an engine after engine creation. */
   bindEngine?(engine: TelemetryEngine): void;
   /** Releases telemetry resources owned by the adapter. */
   shutdown?(): Promise<void> | void;
 }
-//#endregion
-export { RunTelemetryContext, RunTelemetryResultContext, StepTelemetryContext, StepTelemetryResultContext, StorageTelemetryContext, StorageTelemetryOperation, Telemetry, TelemetryContext, TelemetryEngine, workflowTelemetryContextSchema };
+//#endregion

package/dist/types/telemetry.mjs

@@ -1,9 +1 @@
-import { nonBlankStringSchema } from "./common.mjs";
-import { z } from "zod";
-//#region src/types/telemetry.ts
-const workflowTelemetryContextSchema = z.object({
-	traceparent: nonBlankStringSchema.optional(),
-	tracestate: nonBlankStringSchema.optional()
-});
-//#endregion
-export { workflowTelemetryContextSchema };
+export {};

package/dist/types/timeline.d.mts

@@ -1,237 +1,50 @@
-import { MessageId } from "./message-id.mjs";
-import { RunId } from "./run-id.mjs";
-import { StepId } from "./step-id.mjs";
-import { StreamId } from "./stream-id.mjs";
-import { WorkflowAttributePatch, WorkflowRunRecord } from "./run.mjs";
-import { WorkflowErrorRecord } from "./error.mjs";
-import { AttributesSetEvent, ChildWorkflowCompletedEvent, ChildWorkflowFailedEvent, ChildWorkflowStartedEvent, DeterministicValueRecordedEvent, EventRecord, MessageSendCompletedEvent, MessageSendFailedEvent, MessageSendStartedEvent, MessageSentEvent, MessageWaitCompletedEvent, MessageWaitFailedEvent, MessageWaitStartedEvent, MetadataSetEvent, SleepCompletedEvent, SleepStartedEvent, StreamChunkEvent, StreamClosedEvent, StreamFailedEvent, StreamStartedEvent, WorkflowStepCompletedEvent, WorkflowStepFailedEvent, WorkflowStepStartedEvent } from "./events.mjs";
-import { StorageValue } from "@temelj/storage";
+import { AttributePatch, RunRecord } from "./run.mjs";
+import { EventKind, EventRecord } from "./events.mjs";
 //#region src/types/timeline.d.ts
-type WorkflowStartedEvent = Extract<EventRecord, {
-  readonly kind: "workflow_started";
-}>;
-type WorkflowCompletedEvent = Extract<EventRecord, {
-  readonly kind: "workflow_completed";
-}>;
-type WorkflowFailedEvent = Extract<EventRecord, {
-  readonly kind: "workflow_failed";
-}>;
-/** Describes the workflow timeline contract. */
-interface Timeline {
-  readonly run: WorkflowRunRecord;
-  readonly entries: readonly TimelineEntryRecord[];
+export interface Timeline {
+  readonly run: RunRecord;
+  readonly entries: readonly TimelineEntry[];
 }
-/** Kind values for workflow timeline entries. */
-type TimelineEntryKind = "workflow" | "step" | "sleep" | "child_workflow" | "message" | "stream" | "deterministic" | "metadata" | "attributes";
-/** Status values for workflow-level timeline entries. */
-type TimelineWorkflowStatus = "started" | "completed" | "failed";
-/** Status values for durable task timeline entries. */
-type TimelineStepStatus = "started" | "completed" | "failed";
-/** Status values for sleep timeline entries. */
-type TimelineSleepStatus = "started" | "completed";
-/** Status values for child workflow timeline entries. */
-type TimelineChildWorkflowStatus = "started" | "completed" | "failed";
-/** Status values for messageId timeline entries. */
-type TimelineMessageStatus = "send_started" | "send_completed" | "send_failed" | "sent" | "waiting" | "received" | "failed";
-/** Status values for stream timeline entries. */
-type TimelineStreamStatus = "started" | "chunk" | "closed" | "failed";
-/** Status value for metadata and attribute timeline entries. */
-type TimelineSetStatus = "set";
-/** Status value for deterministic-value timeline entries. */
-type TimelineRecordedStatus = "recorded";
-/** Base contract for workflow timeline entries. */
-interface TimelineEntry {
-  readonly kind: TimelineEntryKind;
+/** What each durable event kind means on a timeline: the thing it belongs to and what happened. */
+export interface TimelineClassification {
+  readonly workflow_started: readonly ["workflow", "started"];
+  readonly workflow_completed: readonly ["workflow", "completed"];
+  readonly workflow_failed: readonly ["workflow", "failed"];
+  readonly step_started: readonly ["step", "started"];
+  readonly step_completed: readonly ["step", "completed"];
+  readonly step_failed: readonly ["step", "failed"];
+  readonly metadata_set: readonly ["metadata", "set"];
+  readonly attributes_set: readonly ["attributes", "set"];
+  readonly deterministic_value_recorded: readonly ["deterministic", "recorded"];
+  readonly sleep_started: readonly ["sleep", "started"];
+  readonly sleep_completed: readonly ["sleep", "completed"];
+  readonly child_workflow_started: readonly ["child_workflow", "started"];
+  readonly child_workflow_completed: readonly ["child_workflow", "completed"];
+  readonly child_workflow_failed: readonly ["child_workflow", "failed"];
+  readonly message_send_started: readonly ["message", "send_started"];
+  readonly message_send_completed: readonly ["message", "send_completed"];
+  readonly message_send_failed: readonly ["message", "send_failed"];
+  readonly message_sent: readonly ["message", "sent"];
+  readonly message_wait_started: readonly ["message", "waiting"];
+  readonly message_wait_completed: readonly ["message", "received"];
+  readonly message_wait_failed: readonly ["message", "failed"];
+  readonly stream_started: readonly ["stream", "started"];
+  readonly stream_chunk: readonly ["stream", "chunk"];
+  readonly stream_closed: readonly ["stream", "closed"];
+  readonly stream_failed: readonly ["stream", "failed"];
 }
-type WorkflowTimelineStepFields = {
+/**
+ * One durable event on a run's timeline, classified by `kind` and `status`. The event itself holds
+ * the details; attribute entries also carry the patch the event applied.
+ */
+export type TimelineEntry = { readonly [Kind in EventKind]: {
+  readonly kind: TimelineClassification[Kind][0];
+  readonly status: TimelineClassification[Kind][1];
   readonly timestamp: Temporal.Instant;
-  readonly stepId: StepId;
-  readonly stepName: string;
-};
-type WorkflowTimelineCountField = {
-  readonly count?: number;
-};
-type WorkflowTimelineOptionalMessageFields = {
-  readonly stepId?: StepId;
-  readonly stepName?: string;
-  readonly count?: number;
-  readonly targetRunId?: RunId;
-  readonly timeoutAt?: Temporal.Instant;
-  readonly payload?: StorageValue;
-  readonly error?: WorkflowErrorRecord;
-  readonly messageTimestamp?: Temporal.Instant;
-  readonly waiterStepIds?: readonly string[];
-};
-/** Describes the workflow timeline workflow entry contract. */
-type TimelineWorkflowEntry = {
-  readonly kind: "workflow";
-  readonly status: "started";
-  readonly timestamp: Temporal.Instant;
-  readonly event: WorkflowStartedEvent;
-} | {
-  readonly kind: "workflow";
-  readonly status: "completed";
-  readonly timestamp: Temporal.Instant;
-  readonly event: WorkflowCompletedEvent;
-} | {
-  readonly kind: "workflow";
-  readonly status: "failed";
-  readonly timestamp: Temporal.Instant;
-  readonly event: WorkflowFailedEvent;
-};
-/** Describes the workflow timeline step entry contract. */
-type TimelineStepEntry = (WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "step";
-  readonly status: "started";
-  readonly attempt: number;
-  readonly event: WorkflowStepStartedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "step";
-  readonly status: "completed";
-  readonly attempt: number;
-  readonly result?: StorageValue;
-  readonly event: WorkflowStepCompletedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "step";
-  readonly status: "failed";
-  readonly attempt: number;
-  readonly error?: WorkflowErrorRecord;
-  readonly event: WorkflowStepFailedEvent;
-});
-/** Describes the workflow timeline sleep entry contract. */
-type TimelineSleepEntry = (WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "sleep";
-  readonly status: "started";
-  readonly until?: Temporal.Instant;
-  readonly duration?: Temporal.Duration;
-  readonly event: SleepStartedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "sleep";
-  readonly status: "completed";
-  readonly event: SleepCompletedEvent;
-});
-/** Describes the workflow timeline child workflow entry contract. */
-type TimelineChildWorkflowEntry = (WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "child_workflow";
-  readonly status: "started";
-  readonly childRunId: RunId;
-  readonly workflowName?: string;
-  readonly workflowVersion?: string;
-  readonly input?: StorageValue;
-  readonly timeoutAt?: Temporal.Instant;
-  readonly event: ChildWorkflowStartedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "child_workflow";
-  readonly status: "completed";
-  readonly childRunId: RunId;
-  readonly result?: StorageValue;
-  readonly event: ChildWorkflowCompletedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "child_workflow";
-  readonly status: "failed";
-  readonly childRunId: RunId;
-  readonly error?: WorkflowErrorRecord;
-  readonly event: ChildWorkflowFailedEvent;
-});
-/** Describes the workflow timeline messageId entry contract. */
-type TimelineMessageEntry = (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "message";
-  readonly status: "send_started";
-  readonly targetRunId: RunId;
-  readonly messageId: MessageId;
-  readonly event: MessageSendStartedEvent;
-}) | (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & {
-  readonly kind: "message";
-  readonly status: "send_completed";
-  readonly targetRunId: RunId;
-  readonly messageId: MessageId;
-  readonly event: MessageSendCompletedEvent;
-}) | (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & {
-  readonly kind: "message";
-  readonly status: "send_failed";
-  readonly targetRunId: RunId;
-  readonly messageId: MessageId;
-  readonly error?: WorkflowErrorRecord;
-  readonly event: MessageSendFailedEvent;
-}) | (WorkflowTimelineOptionalMessageFields & {
-  readonly kind: "message";
-  readonly status: "sent";
-  readonly timestamp: Temporal.Instant;
-  readonly messageId: MessageId;
-  readonly payload?: StorageValue;
-  readonly event: MessageSentEvent;
-}) | (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "message";
-  readonly status: "waiting";
-  readonly messageId: MessageId;
-  readonly timeoutAt?: Temporal.Instant;
-  readonly event: MessageWaitStartedEvent;
-}) | (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & {
-  readonly kind: "message";
-  readonly status: "received";
-  readonly messageId: MessageId;
-  readonly payload?: StorageValue;
-  readonly messageTimestamp?: Temporal.Instant;
-  readonly event: MessageWaitCompletedEvent;
-}) | (WorkflowTimelineOptionalMessageFields & WorkflowTimelineStepFields & {
-  readonly kind: "message";
-  readonly status: "failed";
-  readonly messageId: MessageId;
-  readonly error?: WorkflowErrorRecord;
-  readonly event: MessageWaitFailedEvent;
-});
-/** Describes the workflow timeline metadata entry contract. */
-type TimelineMetadataEntry = WorkflowTimelineStepFields & {
-  readonly kind: "metadata";
-  readonly status: TimelineSetStatus;
-  readonly count: number;
-  readonly metadata: StorageValue;
-  readonly event: MetadataSetEvent;
-};
-/** Describes the workflow timeline attributes entry contract. */
-type TimelineAttributesEntry = WorkflowTimelineStepFields & {
-  readonly kind: "attributes";
-  readonly status: TimelineSetStatus;
-  readonly count: number;
-  readonly attributes: WorkflowAttributePatch;
-  readonly event: AttributesSetEvent;
-};
-/** Describes the workflow timeline stream entry contract. */
-type TimelineStreamEntry = (WorkflowTimelineStepFields & WorkflowTimelineCountField & {
-  readonly kind: "stream";
-  readonly status: "started";
-  readonly streamId: StreamId;
-  readonly contentType?: string;
-  readonly metadata?: StorageValue;
-  readonly event: StreamStartedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "stream";
-  readonly status: "chunk";
-  readonly streamId: StreamId;
-  readonly index: number;
-  readonly chunk?: StorageValue;
-  readonly event: StreamChunkEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "stream";
-  readonly status: "closed";
-  readonly streamId: StreamId;
-  readonly event: StreamClosedEvent;
-}) | (WorkflowTimelineStepFields & {
-  readonly kind: "stream";
-  readonly status: "failed";
-  readonly streamId: StreamId;
-  readonly error?: WorkflowErrorRecord;
-  readonly event: StreamFailedEvent;
-});
-/** Describes the workflow timeline deterministic entry contract. */
-type TimelineDeterministicEntry = WorkflowTimelineStepFields & {
-  readonly kind: "deterministic";
-  readonly status: TimelineRecordedStatus;
-  readonly count: number;
-  readonly value: StorageValue;
-  readonly event: DeterministicValueRecordedEvent;
-};
-/** Type used for workflow timeline entry values. */
-type TimelineEntryRecord = TimelineWorkflowEntry | TimelineStepEntry | TimelineSleepEntry | TimelineChildWorkflowEntry | TimelineMessageEntry | TimelineStreamEntry | TimelineDeterministicEntry | TimelineMetadataEntry | TimelineAttributesEntry;
-//#endregion
-export { Timeline, TimelineAttributesEntry, TimelineChildWorkflowEntry, TimelineChildWorkflowStatus, TimelineDeterministicEntry, TimelineEntry, TimelineEntryKind, TimelineEntryRecord, TimelineMessageEntry, TimelineMessageStatus, TimelineMetadataEntry, TimelineRecordedStatus, TimelineSetStatus, TimelineSleepEntry, TimelineSleepStatus, TimelineStepEntry, TimelineStepStatus, TimelineStreamEntry, TimelineStreamStatus, TimelineWorkflowEntry, TimelineWorkflowStatus };
+  readonly event: Extract<EventRecord, {
+    readonly kind: Kind;
+  }>;
+} & (Kind extends "attributes_set" ? {
+  readonly attributes: AttributePatch;
+} : unknown); }[EventKind];
+//#endregion

package/dist/types/worker.d.mts

@@ -1,45 +1,42 @@
-import { RunId } from "./run-id.mjs";
-import { WorkflowMissingImplementationRetryConfig } from "./retry.mjs";
+import { RunId, WorkerId } from "./ids.mjs";
+import { MissingImplementationRetryConfig } from "./retry.mjs";
 import { RegistryLike } from "./definition.mjs";
-import { WorkerId } from "./worker-id.mjs";
 import { ExecutionResult } from "./result.mjs";
-import { WorkflowAttributeValue, WorkflowRunRecord, WorkflowRunRetryReason, WorkflowRunStatus, WorkflowRunTransitionReason } from "./run.mjs";
-import { WorkflowWorkerEngine } from "./engine.mjs";
+import { RunRecord, RunRetryReason, RunStatus, RunTransitionReason, WorkflowAttributeValue } from "./run.mjs";
+import { WorkflowEngine } from "../engine/create.mjs";
 //#region src/types/worker.d.ts
 /** Options for creating a direct workflow worker host. */
-interface CreateWorkflowWorkerOptions {
-  readonly engine: WorkflowWorkerEngine;
+export interface CreateWorkflowWorkerOptions {
+  readonly engine: WorkflowEngine;
   readonly registry: RegistryLike;
   readonly workerId?: WorkerId;
   readonly leaseDuration?: Temporal.Duration;
   readonly pollInterval?: Temporal.Duration;
   readonly heartbeatInterval?: Temporal.Duration;
   readonly stopDrainTimeout?: Temporal.Duration;
-  readonly missingImplementationRetry?: WorkflowMissingImplementationRetryConfig;
+  readonly missingImplementationRetry?: MissingImplementationRetryConfig;
   readonly now?: () => Temporal.Instant;
 }
-/** Describes the workflow worker contract. */
-interface WorkflowWorker {
+export interface WorkflowWorker {
   /** Claims and processes a specific run by ID. */
   processRun(runId: RunId): Promise<ExecutionResult<unknown>>;
   /** Claims and processes the next available run matching the optional filters. */
-  processNextRun(options?: WorkflowWorkerRunFilterOptions): Promise<ExecutionResult<unknown> | undefined>;
+  processNextRun(options?: WorkerRunFilterOptions): Promise<ExecutionResult<unknown> | undefined>;
   /** Extends the worker lease for a claimed run. */
-  extendLease(runId: RunId, options?: WorkflowWorkerLeaseOptions): Promise<WorkflowRunRecord | undefined>;
+  extendLease(runId: RunId, options?: WorkerLeaseOptions): Promise<RunRecord | undefined>;
   /** Releases the worker lease for a claimed run. */
-  releaseLease(runId: RunId, options?: WorkflowWorkerLeaseOptions): Promise<WorkflowRunRecord | undefined>;
+  releaseLease(runId: RunId, options?: WorkerLeaseOptions): Promise<RunRecord | undefined>;
   /** Runs the worker polling loop until stopped, aborted, or maxRuns is reached. */
-  run(options?: WorkflowWorkerRunOptions): Promise<WorkflowWorkerRunResult>;
+  run(options?: WorkerRunOptions): Promise<WorkerRunResult>;
   /** Stops the worker polling loop and waits for active work to settle. */
   stop(): Promise<void>;
 }
-/** Options for workflow worker lease. */
-interface WorkflowWorkerLeaseOptions {
+export interface WorkerLeaseOptions {
   readonly attempts?: number;
 }
 /** Run filters accepted by workers; worker identity is supplied by the worker itself. */
-interface WorkflowWorkerRunFilterOptions {
-  readonly status?: WorkflowRunStatus | readonly WorkflowRunStatus[];
+export interface WorkerRunFilterOptions {
+  readonly status?: RunStatus | readonly RunStatus[];
   readonly workflowName?: string;
   readonly workflowVersion?: string;
   readonly idempotencyKey?: string;
@@ -47,7 +44,7 @@ interface WorkflowWorkerRunFilterOptions {
   readonly parentStepId?: string;
   readonly parentStepName?: string;
   readonly parentStepAttempt?: number;
-  readonly lastTransitionReason?: WorkflowRunTransitionReason | readonly WorkflowRunTransitionReason[];
+  readonly lastTransitionReason?: RunTransitionReason | readonly RunTransitionReason[];
   readonly createdAtFrom?: Temporal.Instant;
   readonly createdAtTo?: Temporal.Instant;
   readonly updatedAtFrom?: Temporal.Instant;
@@ -60,7 +57,7 @@ interface WorkflowWorkerRunFilterOptions {
   readonly availableAtTo?: Temporal.Instant;
   readonly leaseExpiresAtFrom?: Temporal.Instant;
   readonly leaseExpiresAtTo?: Temporal.Instant;
-  readonly retryReason?: WorkflowRunRetryReason | readonly WorkflowRunRetryReason[];
+  readonly retryReason?: RunRetryReason | readonly RunRetryReason[];
   readonly retryAtFrom?: Temporal.Instant;
   readonly retryAtTo?: Temporal.Instant;
   readonly cleanupFinishedAtBefore?: Temporal.Instant;
@@ -69,26 +66,22 @@ interface WorkflowWorkerRunFilterOptions {
   readonly attributeMissing?: string | readonly string[];
   readonly limit?: number;
 }
-/** Options for workflow worker run. */
-interface WorkflowWorkerRunOptions extends WorkflowWorkerRunFilterOptions {
+export interface WorkerRunOptions extends WorkerRunFilterOptions {
   readonly signal?: AbortSignal;
   readonly maxRuns?: number;
   readonly concurrency?: number;
   readonly pollInterval?: Temporal.Duration;
   readonly tickSchedules?: boolean;
 }
-/** Result returned by workflow worker run. */
-interface WorkflowWorkerRunResult {
+export interface WorkerRunResult {
   readonly processedRuns: number;
 }
-/** Options for workflow wake due runs. */
-interface WorkflowWakeDueRunsOptions extends WorkflowWorkerRunFilterOptions {
+export interface WakeDueRunsOptions extends WorkerRunFilterOptions {
   readonly workerId?: string;
   readonly leaseDuration?: Temporal.Duration;
   readonly heartbeatInterval?: Temporal.Duration;
-  readonly missingImplementationRetry?: WorkflowMissingImplementationRetryConfig;
+  readonly missingImplementationRetry?: MissingImplementationRetryConfig;
   readonly signal?: AbortSignal;
   readonly maxRuns?: number;
 }
-//#endregion
-export { CreateWorkflowWorkerOptions, WorkflowWakeDueRunsOptions, WorkflowWorker, WorkflowWorkerLeaseOptions, WorkflowWorkerRunFilterOptions, WorkflowWorkerRunOptions, WorkflowWorkerRunResult };
+//#endregion

package/dist/values.d.mts

@@ -0,0 +1,15 @@
+//#region src/values.d.ts
+/** Returns the greatest positive safe integer from two optional values. */
+export declare function greatestOptionalNumber(current: number | undefined, next: number | undefined): number | undefined;
+export declare function isPositiveSafeInteger(value: number): boolean;
+export declare function isNonNegativeSafeInteger(value: number): boolean;
+/** Returns the next positive safe integer, or undefined when the input cannot be advanced. */
+export declare function nextPositiveSafeInteger(value: number): number | undefined;
+export declare function isAbortError(cause: unknown): boolean;
+export declare function positiveSafeInteger(value: number, label: string): number;
+export declare function resolvePositiveSafeIntegerOption(value: number | undefined, label: string): number | undefined;
+export declare function safeDuration(value: number, label: string): number;
+export declare function durationAmount(value: Temporal.Duration, label: string): number;
+/** Returns a retry delay in milliseconds and reports invalid numbers as duration errors. */
+export declare function resolveSafeRetryDelay(value: number | undefined, label: string): number | undefined;
+//#endregion

package/dist/values.mjs

@@ -0,0 +1,57 @@
+import { WorkflowErrorCode } from "./errors/codes.mjs";
+import { WorkflowOptionsError } from "./errors/base.mjs";
+import { WorkflowDurationError } from "./errors/failures.mjs";
+//#region src/values.ts
+/** Returns the greatest positive safe integer from two optional values. */
+function greatestOptionalNumber(current, next) {
+	if (next === void 0 || !isPositiveSafeInteger(next)) return current;
+	if (current === void 0) return next;
+	return Math.max(current, next);
+}
+function isPositiveSafeInteger(value) {
+	return Number.isSafeInteger(value) && value > 0;
+}
+function isNonNegativeSafeInteger(value) {
+	return Number.isSafeInteger(value) && value >= 0;
+}
+/** Returns the next positive safe integer, or undefined when the input cannot be advanced. */
+function nextPositiveSafeInteger(value) {
+	return isPositiveSafeInteger(value) && value < Number.MAX_SAFE_INTEGER ? value + 1 : void 0;
+}
+function isAbortError(cause) {
+	return cause instanceof Error && cause.name === "AbortError" || cause instanceof DOMException && cause.name === "AbortError";
+}
+function positiveSafeInteger(value, label) {
+	if (!isPositiveSafeInteger(value)) throw new WorkflowDurationError(`${label} must be a positive safe integer`);
+	return value;
+}
+function resolvePositiveSafeIntegerOption(value, label) {
+	if (value === void 0) return;
+	if (!isPositiveSafeInteger(value)) WorkflowOptionsError.positiveSafeInteger(label);
+	return value;
+}
+function safeDuration(value, label) {
+	try {
+		resolveSafeRetryDelay(value, label);
+	} catch (error) {
+		if (!(error instanceof WorkflowOptionsError)) throw error;
+		throw new WorkflowDurationError(`${label} must be a timer-safe duration`);
+	}
+	return value;
+}
+function durationAmount(value, label) {
+	if (!(value instanceof Temporal.Duration)) throw new WorkflowDurationError(`${label} must be a Temporal.Duration`);
+	const amount = value.total({ unit: "millisecond" });
+	if (!Number.isFinite(amount)) throw new WorkflowDurationError(`${label} must be finite`);
+	return amount;
+}
+/** Returns a retry delay in milliseconds and reports invalid numbers as duration errors. */
+function resolveSafeRetryDelay(value, label) {
+	if (value !== void 0 && !Number.isSafeInteger(value)) throw new WorkflowOptionsError(`${label} must be a timer-safe duration`, {
+		code: WorkflowErrorCode.OPTIONS_EXPECTED_TIMER_SAFE_DURATION,
+		details: { label }
+	});
+	return value;
+}
+//#endregion
+export { durationAmount, greatestOptionalNumber, isAbortError, isNonNegativeSafeInteger, isPositiveSafeInteger, nextPositiveSafeInteger, positiveSafeInteger, resolvePositiveSafeIntegerOption, resolveSafeRetryDelay, safeDuration };

package/dist/vite.d.mts

@@ -1,6 +1,5 @@
-import { DirectiveKind, TransformManifest, TransformManifestFunction, TransformManifestImportEdge, TransformMetadata, TransformMetadataEntry, TransformOptions, TransformResult, VitePluginOptions, WorkflowPluginOptions } from "./types/vite.mjs";
-import { workflow, workflowPlugin } from "./vite/plugin.mjs";
-import { GENERATED_PREFIX, makeGeneratedName } from "./vite/generated-name.mjs";
-import { WorkflowTransformError } from "./vite/error.mjs";
-import { transformWorkflowSource } from "./vite/transform.mjs";
-export { type DirectiveKind, GENERATED_PREFIX, type TransformManifest, type TransformManifestFunction, type TransformManifestImportEdge, type TransformMetadata, type TransformMetadataEntry, type TransformOptions, type TransformResult, type VitePluginOptions, type WorkflowPluginOptions, WorkflowTransformError, makeGeneratedName, transformWorkflowSource, workflow, workflowPlugin };
+import { WorkflowTransformError } from "./compiler/error.mjs";
+import { DirectiveKind, PluginOptions, TransformManifest, TransformManifestFunction, TransformManifestImportEdge, TransformMetadata, TransformMetadataEntry, TransformOptions, TransformResult } from "./types/compiler.mjs";
+import { workflow, workflowPlugin } from "./compiler/plugin.mjs";
+import { GENERATED_PREFIX, makeGeneratedName, transformWorkflowSource } from "./compiler/transform.mjs";
+export { type DirectiveKind, GENERATED_PREFIX, type PluginOptions, type TransformManifest, type TransformManifestFunction, type TransformManifestImportEdge, type TransformMetadata, type TransformMetadataEntry, type TransformOptions, type TransformResult, WorkflowTransformError, makeGeneratedName, transformWorkflowSource, workflow, workflowPlugin };

package/dist/vite.mjs

@@ -1,5 +1,4 @@
-import { WorkflowTransformError } from "./vite/error.mjs";
-import { GENERATED_PREFIX, makeGeneratedName } from "./vite/generated-name.mjs";
-import { transformWorkflowSource } from "./vite/transform.mjs";
-import { workflow, workflowPlugin } from "./vite/plugin.mjs";
+import { WorkflowTransformError } from "./compiler/error.mjs";
+import { GENERATED_PREFIX, makeGeneratedName, transformWorkflowSource } from "./compiler/transform.mjs";
+import { workflow, workflowPlugin } from "./compiler/plugin.mjs";
 export { GENERATED_PREFIX, WorkflowTransformError, makeGeneratedName, transformWorkflowSource, workflow, workflowPlugin };

package/dist/webpack.d.mts

@@ -1,7 +1,9 @@
-import { WorkflowPluginOptions } from "./types/vite.mjs";
-import { workflowPlugin } from "./vite/plugin.mjs";
+import { PluginOptions } from "./types/compiler.mjs";
+import { workflowPlugin } from "./compiler/plugin.mjs";
+import "./esbuild.mjs";
+import "temporal-polyfill/global";
 //#region src/webpack.d.ts
 /** Creates the webpack plugin that compiles workflow and step directives. */
-declare const workflow: (options?: WorkflowPluginOptions | undefined) => import("webpack").WebpackPluginInstance;
+export declare const workflow: (options?: PluginOptions | undefined) => import("webpack").WebpackPluginInstance;
 //#endregion
-export { type WorkflowPluginOptions, workflow, workflowPlugin };
+export { type PluginOptions, workflowPlugin };

package/dist/webpack.mjs

@@ -1,4 +1,5 @@
-import { workflowPlugin } from "./vite/plugin.mjs";
+import { workflowPlugin } from "./compiler/plugin.mjs";
+import "temporal-polyfill/global";
 //#region src/webpack.ts
 /** Creates the webpack plugin that compiles workflow and step directives. */
 const workflow = workflowPlugin.webpack;