@sonamu-kit/tasks 0.2.0 → 0.3.0

package/dist/worker.js

@@ -1,207 +1,202 @@
-import { randomUUID } from "node:crypto";
 import { executeWorkflow } from "./execution.js";
-const DEFAULT_LEASE_DURATION_MS = 30 * 1000; // 30s
-const DEFAULT_POLL_INTERVAL_MS = 100; // 100ms
+import { randomUUID } from "node:crypto";
+
+//#region src/worker.ts
+const DEFAULT_LEASE_DURATION_MS = 30 * 1e3;
+const DEFAULT_POLL_INTERVAL_MS = 100;
 const DEFAULT_CONCURRENCY = 1;
 /**
- * Runs workflows by polling the backend, dispatching runs across a concurrency
- * pool, and heartbeating/extending leases.
- */ export class Worker {
-    backend;
-    workerIds;
-    registry;
-    activeExecutions = new Set();
-    running = false;
-    loopPromise = null;
-    usePubSub;
-    listenDelay;
-    constructor(options){
-        this.backend = options.backend;
-        this.registry = options.registry;
-        this.usePubSub = options.usePubSub ?? true;
-        this.listenDelay = options.listenDelay ?? 500;
-        const concurrency = Math.max(DEFAULT_CONCURRENCY, options.concurrency ?? DEFAULT_CONCURRENCY);
-        // generate worker IDs for every concurrency slot
-        this.workerIds = Array.from({
-            length: concurrency
-        }, ()=>randomUUID());
-    }
-    /**
-   * Start the worker. It will begin polling for and executing workflows.
-   * @returns Promise resolved when started
-   */ async start() {
-        if (this.running) return;
-        this.running = true;
-        this.loopPromise = this.runLoop();
-        await Promise.resolve();
-    }
-    /**
-   * Stop the worker gracefully. Waits for all active workflow runs to complete
-   * before returning.
-   * @returns Promise resolved when stopped
-   */ async stop() {
-        this.running = false;
-        // wait for the poll loop to stop
-        if (this.loopPromise) await this.loopPromise;
-        // wait for all active executions to finish
-        while(this.activeExecutions.size > 0)await sleep(100);
-    }
-    /**
-   * Processes one round of work claims and execution. Exposed for testing.
-   * Returns the number of workflow runs claimed.
-   * @returns Number of workflow runs claimed
-   */ async tick() {
-        const availableSlots = this.concurrency - this.activeExecutions.size;
-        if (availableSlots <= 0) return 0;
-        // claim work for each available slot
-        const claims = Array.from({
-            length: availableSlots
-        }, (_, i)=>{
-            const availableWorkerId = this.workerIds[i % this.workerIds.length];
-            return availableWorkerId ? this.claimAndProcessWorkflowRunInBackground(availableWorkerId) : Promise.resolve(null);
-        });
-        const claimed = await Promise.all(claims);
-        return claimed.filter((run)=>run !== null).length;
-    }
-    /**
-   * Get the configured concurrency limit.
-   * @returns Concurrency limit
-   */ get concurrency() {
-        return this.workerIds.length;
-    }
-    /*
-   * Main run loop that continuously ticks while the worker is running.
-   * Only sleeps when no work was claimed to avoid busy-waiting.
-   */ async runLoop() {
-        if (this.usePubSub) {
-            this.backend.subscribe(async (result)=>{
-                if (!result.ok) {
-                    return;
-                }
-                await sleep(this.listenDelay);
-                await this.tick();
-            });
-        }
-        while(this.running){
-            try {
-                const claimedCount = await this.tick();
-                // only sleep if we didn't claim any work
-                if (claimedCount === 0) {
-                    await sleep(DEFAULT_POLL_INTERVAL_MS);
-                }
-            } catch (error) {
-                console.error("Worker tick failed:", error);
-                await sleep(DEFAULT_POLL_INTERVAL_MS);
-            }
-        }
-    }
-    /*
-   * Cclaim and process a workflow run for the given worker ID. Do not await the
-   * processing here to avoid blocking the caller.
-   * Returns the claimed workflow run, or null if none was available.
-   */ async claimAndProcessWorkflowRunInBackground(workerId) {
-        // claim workflow run
-        const workflowRun = await this.backend.claimWorkflowRun({
-            workerId,
-            leaseDurationMs: DEFAULT_LEASE_DURATION_MS
-        });
-        if (!workflowRun) return null;
-        const workflow = this.registry.get(workflowRun.workflowName, workflowRun.version);
-        if (!workflow) {
-            const versionStr = workflowRun.version ? ` (version: ${workflowRun.version})` : "";
-            await this.backend.failWorkflowRun({
-                workflowRunId: workflowRun.id,
-                workerId,
-                error: {
-                    message: `Workflow "${workflowRun.workflowName}"${versionStr} is not registered`
-                }
-            });
-            return null;
-        }
-        // create execution and start processing *async* w/o blocking
-        const execution = new WorkflowExecution({
-            backend: this.backend,
-            workflowRun,
-            workerId
-        });
-        this.activeExecutions.add(execution);
-        this.processExecutionInBackground(execution, workflow).catch(()=>{
-        // errors are already handled in processExecution
-        }).finally(()=>{
-            execution.stopHeartbeat();
-            this.activeExecutions.delete(execution);
-        });
-        return workflowRun;
-    }
-    /**
-   * Process a workflow execution, handling heartbeats, step execution, and
-   * marking success or failure.
-   * @param execution - Workflow execution
-   * @param workflow - Workflow to execute
-   * @returns Promise resolved when processing completes
-   */ async processExecutionInBackground(execution, workflow) {
-        // start heartbeating
-        execution.startHeartbeat();
-        try {
-            await executeWorkflow({
-                backend: this.backend,
-                workflowRun: execution.workflowRun,
-                workflowFn: workflow.fn,
-                workflowVersion: execution.workflowRun.version,
-                workerId: execution.workerId,
-                retryPolicy: workflow.spec.retryPolicy
-            });
-        } catch (error) {
-            // specifically for unexpected errors in the execution wrapper itself, not
-            // for business logic errors (those are handled inside executeWorkflow)
-            console.error(`Critical error during workflow execution for run ${execution.workflowRun.id}:`, error);
-        }
-    }
-}
+* Runs workflows by polling the backend, dispatching runs across a concurrency
+* pool, and heartbeating/extending leases.
+*/
+var Worker = class {
+	backend;
+	workerIds;
+	registry;
+	activeExecutions = /* @__PURE__ */ new Set();
+	running = false;
+	loopPromise = null;
+	subscribed = false;
+	usePubSub;
+	listenDelay;
+	constructor(options) {
+		this.backend = options.backend;
+		this.registry = options.registry;
+		this.usePubSub = options.usePubSub ?? true;
+		this.listenDelay = options.listenDelay ?? 500;
+		const concurrency = Math.max(DEFAULT_CONCURRENCY, options.concurrency ?? DEFAULT_CONCURRENCY);
+		this.workerIds = Array.from({ length: concurrency }, () => randomUUID());
+	}
+	/**
+	* Start the worker. It will begin polling for and executing workflows.
+	* @returns Promise resolved when started
+	*/
+	async start() {
+		if (this.running) return;
+		this.running = true;
+		this.loopPromise = this.runLoop();
+		await Promise.resolve();
+	}
+	/**
+	* Stop the worker gracefully. Waits for all active workflow runs to complete
+	* before returning.
+	* @returns Promise resolved when stopped
+	*/
+	async stop() {
+		this.running = false;
+		if (this.loopPromise) await this.loopPromise;
+		while (this.activeExecutions.size > 0) await sleep(100);
+		this.subscribed = false;
+	}
+	/**
+	* Processes one round of work claims and execution. Exposed for testing.
+	* Returns the number of workflow runs claimed.
+	* @returns Number of workflow runs claimed
+	*/
+	async tick() {
+		const availableSlots = this.concurrency - this.activeExecutions.size;
+		if (availableSlots <= 0) return 0;
+		const claims = Array.from({ length: availableSlots }, (_, i) => {
+			const availableWorkerId = this.workerIds[i % this.workerIds.length];
+			return availableWorkerId ? this.claimAndProcessWorkflowRunInBackground(availableWorkerId) : Promise.resolve(null);
+		});
+		return (await Promise.all(claims)).filter((run) => run !== null).length;
+	}
+	/**
+	* Get the configured concurrency limit.
+	* @returns Concurrency limit
+	*/
+	get concurrency() {
+		return this.workerIds.length;
+	}
+	async runLoop() {
+		if (this.usePubSub && !this.subscribed) {
+			this.subscribed = true;
+			this.backend.subscribe(async (result) => {
+				if (!result.ok || !this.running) return;
+				await sleep(this.listenDelay);
+				await this.tick();
+			});
+		}
+		while (this.running) try {
+			if (await this.tick() === 0) await sleep(DEFAULT_POLL_INTERVAL_MS);
+		} catch (error) {
+			console.error("Worker tick failed:", error);
+			await sleep(DEFAULT_POLL_INTERVAL_MS);
+		}
+	}
+	async claimAndProcessWorkflowRunInBackground(workerId) {
+		const workflowRun = await this.backend.claimWorkflowRun({
+			workerId,
+			leaseDurationMs: DEFAULT_LEASE_DURATION_MS
+		});
+		if (!workflowRun) return null;
+		const workflow = this.registry.get(workflowRun.workflowName, workflowRun.version);
+		if (!workflow) {
+			const versionStr = workflowRun.version ? ` (version: ${workflowRun.version})` : "";
+			await this.backend.failWorkflowRun({
+				workflowRunId: workflowRun.id,
+				workerId,
+				error: { message: `Workflow "${workflowRun.workflowName}"${versionStr} is not registered` }
+			});
+			return null;
+		}
+		const execution = new WorkflowExecution({
+			backend: this.backend,
+			workflowRun,
+			workerId
+		});
+		this.activeExecutions.add(execution);
+		this.processExecutionInBackground(execution, workflow).catch(() => {}).finally(() => {
+			execution.stopHeartbeat();
+			this.activeExecutions.delete(execution);
+		});
+		return workflowRun;
+	}
+	/**
+	* Process a workflow execution, handling heartbeats, step execution, and
+	* marking success or failure.
+	* @param execution - Workflow execution
+	* @param workflow - Workflow to execute
+	* @returns Promise resolved when processing completes
+	*/
+	async processExecutionInBackground(execution, workflow) {
+		execution.startHeartbeat();
+		try {
+			await executeWorkflow({
+				backend: this.backend,
+				workflowRun: execution.workflowRun,
+				workflowFn: workflow.fn,
+				workflowVersion: execution.workflowRun.version,
+				workerId: execution.workerId,
+				retryPolicy: workflow.spec.retryPolicy,
+				signal: execution.signal
+			});
+		} catch (error) {
+			if (execution.signal.aborted) return;
+			console.error(`Critical error during workflow execution for run ${execution.workflowRun.id}:`, error);
+		}
+	}
+};
 /**
- * Tracks a claimed workflow run and maintains its heartbeat lease for the
- * worker.
- */ class WorkflowExecution {
-    backend;
-    workflowRun;
-    workerId;
-    heartbeatTimer = null;
-    constructor(options){
-        this.backend = options.backend;
-        this.workflowRun = options.workflowRun;
-        this.workerId = options.workerId;
-    }
-    /**
-   * Start the heartbeat loop for this execution, heartbeating at half the lease
-   * duration.
-   */ startHeartbeat() {
-        const leaseDurationMs = DEFAULT_LEASE_DURATION_MS;
-        const heartbeatIntervalMs = leaseDurationMs / 2;
-        this.heartbeatTimer = setInterval(()=>{
-            this.backend.extendWorkflowRunLease({
-                workflowRunId: this.workflowRun.id,
-                workerId: this.workerId,
-                leaseDurationMs
-            }).catch((error)=>{
-                console.error("Heartbeat failed:", error);
-            });
-        }, heartbeatIntervalMs);
-    }
-    /**
-   * Stop the heartbeat loop.
-   */ stopHeartbeat() {
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-    }
-}
+* Tracks a claimed workflow run and maintains its heartbeat lease for the
+* worker.
+*/
+var WorkflowExecution = class {
+	backend;
+	workflowRun;
+	workerId;
+	heartbeatTimer = null;
+	abortController = new AbortController();
+	constructor(options) {
+		this.backend = options.backend;
+		this.workflowRun = options.workflowRun;
+		this.workerId = options.workerId;
+	}
+	/**
+	* 외부에서 abort 여부를 확인할 수 있는 signal입니다.
+	* heartbeat 실패 시 abort됩니다.
+	*/
+	get signal() {
+		return this.abortController.signal;
+	}
+	/**
+	* Start the heartbeat loop for this execution, heartbeating at half the lease
+	* duration.
+	*/
+	startHeartbeat() {
+		const leaseDurationMs = DEFAULT_LEASE_DURATION_MS;
+		const heartbeatIntervalMs = leaseDurationMs / 2;
+		this.heartbeatTimer = setInterval(() => {
+			this.backend.extendWorkflowRunLease({
+				workflowRunId: this.workflowRun.id,
+				workerId: this.workerId,
+				leaseDurationMs
+			}).catch((_error) => {
+				this.abortController.abort();
+				this.stopHeartbeat();
+			});
+		}, heartbeatIntervalMs);
+	}
+	/**
+	* Stop the heartbeat loop.
+	*/
+	stopHeartbeat() {
+		if (this.heartbeatTimer) {
+			clearInterval(this.heartbeatTimer);
+			this.heartbeatTimer = null;
+		}
+	}
+};
 /**
- * Sleep for a given duration.
- * @param ms - Milliseconds to sleep
- * @returns Promise resolved after sleeping
- */ function sleep(ms) {
-    return new Promise((resolve)=>setTimeout(resolve, ms));
+* Sleep for a given duration.
+* @param ms - Milliseconds to sleep
+* @returns Promise resolved after sleeping
+*/
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+//#endregion
+export { Worker };
 //# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/worker.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { Backend } from \"./backend\";\nimport type { WorkflowRun } from \"./core/workflow\";\nimport { executeWorkflow } from \"./execution\";\nimport type { WorkflowRegistry } from \"./registry\";\nimport type { Workflow } from \"./workflow\";\n\nconst DEFAULT_LEASE_DURATION_MS = 30 * 1000; // 30s\nconst DEFAULT_POLL_INTERVAL_MS = 100; // 100ms\nconst DEFAULT_CONCURRENCY = 1;\n\n/**\n * Configures how a Worker polls the backend, leases workflow runs, and\n * registers workflows.\n */\nexport interface WorkerOptions {\n  backend: Backend;\n  registry: WorkflowRegistry;\n  concurrency?: number | undefined;\n  usePubSub?: boolean;\n  listenDelay?: number;\n}\n\n/**\n * Runs workflows by polling the backend, dispatching runs across a concurrency\n * pool, and heartbeating/extending leases.\n */\nexport class Worker {\n  private readonly backend: Backend;\n  private readonly workerIds: string[];\n  private readonly registry: WorkflowRegistry;\n  private readonly activeExecutions = new Set<WorkflowExecution>();\n  private running = false;\n  private loopPromise: Promise<void> | null = null;\n\n  private usePubSub: boolean;\n  private listenDelay: number;\n\n  constructor(options: WorkerOptions) {\n    this.backend = options.backend;\n    this.registry = options.registry;\n    this.usePubSub = options.usePubSub ?? true;\n    this.listenDelay = options.listenDelay ?? 500;\n\n    const concurrency = Math.max(DEFAULT_CONCURRENCY, options.concurrency ?? DEFAULT_CONCURRENCY);\n\n    // generate worker IDs for every concurrency slot\n    this.workerIds = Array.from({ length: concurrency }, () => randomUUID());\n  }\n\n  /**\n   * Start the worker. It will begin polling for and executing workflows.\n   * @returns Promise resolved when started\n   */\n  async start(): Promise<void> {\n    if (this.running) return;\n    this.running = true;\n    this.loopPromise = this.runLoop();\n    await Promise.resolve();\n  }\n\n  /**\n   * Stop the worker gracefully. Waits for all active workflow runs to complete\n   * before returning.\n   * @returns Promise resolved when stopped\n   */\n  async stop(): Promise<void> {\n    this.running = false;\n\n    // wait for the poll loop to stop\n    if (this.loopPromise) await this.loopPromise;\n\n    // wait for all active executions to finish\n    while (this.activeExecutions.size > 0) await sleep(100);\n  }\n\n  /**\n   * Processes one round of work claims and execution. Exposed for testing.\n   * Returns the number of workflow runs claimed.\n   * @returns Number of workflow runs claimed\n   */\n  async tick(): Promise<number> {\n    const availableSlots = this.concurrency - this.activeExecutions.size;\n    if (availableSlots <= 0) return 0;\n\n    // claim work for each available slot\n    const claims = Array.from({ length: availableSlots }, (_, i) => {\n      const availableWorkerId = this.workerIds[i % this.workerIds.length];\n      return availableWorkerId\n        ? this.claimAndProcessWorkflowRunInBackground(availableWorkerId)\n        : Promise.resolve(null);\n    });\n\n    const claimed = await Promise.all(claims);\n    return claimed.filter((run) => run !== null).length;\n  }\n\n  /**\n   * Get the configured concurrency limit.\n   * @returns Concurrency limit\n   */\n  private get concurrency(): number {\n    return this.workerIds.length;\n  }\n\n  /*\n   * Main run loop that continuously ticks while the worker is running.\n   * Only sleeps when no work was claimed to avoid busy-waiting.\n   */\n  private async runLoop(): Promise<void> {\n    if (this.usePubSub) {\n      this.backend.subscribe(async (result) => {\n        if (!result.ok) {\n          return;\n        }\n\n        await sleep(this.listenDelay);\n        await this.tick();\n      });\n    }\n\n    while (this.running) {\n      try {\n        const claimedCount = await this.tick();\n        // only sleep if we didn't claim any work\n        if (claimedCount === 0) {\n          await sleep(DEFAULT_POLL_INTERVAL_MS);\n        }\n      } catch (error) {\n        console.error(\"Worker tick failed:\", error);\n        await sleep(DEFAULT_POLL_INTERVAL_MS);\n      }\n    }\n  }\n\n  /*\n   * Cclaim and process a workflow run for the given worker ID. Do not await the\n   * processing here to avoid blocking the caller.\n   * Returns the claimed workflow run, or null if none was available.\n   */\n  private async claimAndProcessWorkflowRunInBackground(\n    workerId: string,\n  ): Promise<WorkflowRun | null> {\n    // claim workflow run\n    const workflowRun = await this.backend.claimWorkflowRun({\n      workerId,\n      leaseDurationMs: DEFAULT_LEASE_DURATION_MS,\n    });\n    if (!workflowRun) return null;\n\n    const workflow = this.registry.get(workflowRun.workflowName, workflowRun.version);\n    if (!workflow) {\n      const versionStr = workflowRun.version ? ` (version: ${workflowRun.version})` : \"\";\n      await this.backend.failWorkflowRun({\n        workflowRunId: workflowRun.id,\n        workerId,\n        error: {\n          message: `Workflow \"${workflowRun.workflowName}\"${versionStr} is not registered`,\n        },\n      });\n      return null;\n    }\n\n    // create execution and start processing *async* w/o blocking\n    const execution = new WorkflowExecution({\n      backend: this.backend,\n      workflowRun,\n      workerId,\n    });\n    this.activeExecutions.add(execution);\n\n    this.processExecutionInBackground(execution, workflow)\n      .catch(() => {\n        // errors are already handled in processExecution\n      })\n      .finally(() => {\n        execution.stopHeartbeat();\n        this.activeExecutions.delete(execution);\n      });\n\n    return workflowRun;\n  }\n\n  /**\n   * Process a workflow execution, handling heartbeats, step execution, and\n   * marking success or failure.\n   * @param execution - Workflow execution\n   * @param workflow - Workflow to execute\n   * @returns Promise resolved when processing completes\n   */\n  private async processExecutionInBackground(\n    execution: WorkflowExecution,\n    workflow: Workflow<unknown, unknown, unknown>,\n  ): Promise<void> {\n    // start heartbeating\n    execution.startHeartbeat();\n\n    try {\n      await executeWorkflow({\n        backend: this.backend,\n        workflowRun: execution.workflowRun,\n        workflowFn: workflow.fn,\n        workflowVersion: execution.workflowRun.version,\n        workerId: execution.workerId,\n        retryPolicy: workflow.spec.retryPolicy,\n      });\n    } catch (error) {\n      // specifically for unexpected errors in the execution wrapper itself, not\n      // for business logic errors (those are handled inside executeWorkflow)\n      console.error(\n        `Critical error during workflow execution for run ${execution.workflowRun.id}:`,\n        error,\n      );\n    }\n  }\n}\n\n/**\n * Configures the options for a WorkflowExecution.\n */\ninterface WorkflowExecutionOptions {\n  backend: Backend;\n  workflowRun: WorkflowRun;\n  workerId: string;\n}\n\n/**\n * Tracks a claimed workflow run and maintains its heartbeat lease for the\n * worker.\n */\nclass WorkflowExecution {\n  private backend: Backend;\n  workflowRun: WorkflowRun;\n  workerId: string;\n  private heartbeatTimer: NodeJS.Timeout | null = null;\n\n  constructor(options: WorkflowExecutionOptions) {\n    this.backend = options.backend;\n    this.workflowRun = options.workflowRun;\n    this.workerId = options.workerId;\n  }\n\n  /**\n   * Start the heartbeat loop for this execution, heartbeating at half the lease\n   * duration.\n   */\n  startHeartbeat(): void {\n    const leaseDurationMs = DEFAULT_LEASE_DURATION_MS;\n    const heartbeatIntervalMs = leaseDurationMs / 2;\n\n    this.heartbeatTimer = setInterval(() => {\n      this.backend\n        .extendWorkflowRunLease({\n          workflowRunId: this.workflowRun.id,\n          workerId: this.workerId,\n          leaseDurationMs,\n        })\n        .catch((error: unknown) => {\n          console.error(\"Heartbeat failed:\", error);\n        });\n    }, heartbeatIntervalMs);\n  }\n\n  /**\n   * Stop the heartbeat loop.\n   */\n  stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n}\n\n/**\n * Sleep for a given duration.\n * @param ms - Milliseconds to sleep\n * @returns Promise resolved after sleeping\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"names":["randomUUID","executeWorkflow","DEFAULT_LEASE_DURATION_MS","DEFAULT_POLL_INTERVAL_MS","DEFAULT_CONCURRENCY","Worker","backend","workerIds","registry","activeExecutions","Set","running","loopPromise","usePubSub","listenDelay","options","concurrency","Math","max","Array","from","length","start","runLoop","Promise","resolve","stop","size","sleep","tick","availableSlots","claims","_","i","availableWorkerId","claimAndProcessWorkflowRunInBackground","claimed","all","filter","run","subscribe","result","ok","claimedCount","error","console","workerId","workflowRun","claimWorkflowRun","leaseDurationMs","workflow","get","workflowName","version","versionStr","failWorkflowRun","workflowRunId","id","message","execution","WorkflowExecution","add","processExecutionInBackground","catch","finally","stopHeartbeat","delete","startHeartbeat","workflowFn","fn","workflowVersion","retryPolicy","spec","heartbeatTimer","heartbeatIntervalMs","setInterval","extendWorkflowRunLease","clearInterval","ms","setTimeout"],"mappings":"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"}
+{"version":3,"file":"worker.js","names":[],"sources":["../src/worker.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nimport { type Backend } from \"./backend\";\nimport { type WorkflowRun } from \"./core/workflow\";\nimport { executeWorkflow } from \"./execution\";\nimport { type WorkflowRegistry } from \"./registry\";\nimport { type Workflow } from \"./workflow\";\n\nconst DEFAULT_LEASE_DURATION_MS = 30 * 1000; // 30s\nconst DEFAULT_POLL_INTERVAL_MS = 100; // 100ms\nconst DEFAULT_CONCURRENCY = 1;\n\n/**\n * Configures how a Worker polls the backend, leases workflow runs, and\n * registers workflows.\n */\nexport interface WorkerOptions {\n  backend: Backend;\n  registry: WorkflowRegistry;\n  concurrency?: number | undefined;\n  usePubSub?: boolean;\n  listenDelay?: number;\n}\n\n/**\n * Runs workflows by polling the backend, dispatching runs across a concurrency\n * pool, and heartbeating/extending leases.\n */\nexport class Worker {\n  private readonly backend: Backend;\n  private readonly workerIds: string[];\n  private readonly registry: WorkflowRegistry;\n  private readonly activeExecutions = new Set<WorkflowExecution>();\n  private running = false;\n  private loopPromise: Promise<void> | null = null;\n  private subscribed = false;\n\n  private usePubSub: boolean;\n  private listenDelay: number;\n\n  constructor(options: WorkerOptions) {\n    this.backend = options.backend;\n    this.registry = options.registry;\n    this.usePubSub = options.usePubSub ?? true;\n    this.listenDelay = options.listenDelay ?? 500;\n\n    const concurrency = Math.max(DEFAULT_CONCURRENCY, options.concurrency ?? DEFAULT_CONCURRENCY);\n\n    // generate worker IDs for every concurrency slot\n    this.workerIds = Array.from({ length: concurrency }, () => randomUUID());\n  }\n\n  /**\n   * Start the worker. It will begin polling for and executing workflows.\n   * @returns Promise resolved when started\n   */\n  async start(): Promise<void> {\n    if (this.running) return;\n    this.running = true;\n    this.loopPromise = this.runLoop();\n    await Promise.resolve();\n  }\n\n  /**\n   * Stop the worker gracefully. Waits for all active workflow runs to complete\n   * before returning.\n   * @returns Promise resolved when stopped\n   */\n  async stop(): Promise<void> {\n    this.running = false;\n\n    // wait for the poll loop to stop\n    if (this.loopPromise) await this.loopPromise;\n\n    // wait for all active executions to finish\n    while (this.activeExecutions.size > 0) await sleep(100);\n\n    this.subscribed = false;\n  }\n\n  /**\n   * Processes one round of work claims and execution. Exposed for testing.\n   * Returns the number of workflow runs claimed.\n   * @returns Number of workflow runs claimed\n   */\n  async tick(): Promise<number> {\n    const availableSlots = this.concurrency - this.activeExecutions.size;\n    if (availableSlots <= 0) return 0;\n\n    // claim work for each available slot\n    const claims = Array.from({ length: availableSlots }, (_, i) => {\n      const availableWorkerId = this.workerIds[i % this.workerIds.length];\n      return availableWorkerId\n        ? this.claimAndProcessWorkflowRunInBackground(availableWorkerId)\n        : Promise.resolve(null);\n    });\n\n    const claimed = await Promise.all(claims);\n    return claimed.filter((run) => run !== null).length;\n  }\n\n  /**\n   * Get the configured concurrency limit.\n   * @returns Concurrency limit\n   */\n  private get concurrency(): number {\n    return this.workerIds.length;\n  }\n\n  /*\n   * Main run loop that continuously ticks while the worker is running.\n   * Only sleeps when no work was claimed to avoid busy-waiting.\n   */\n  private async runLoop(): Promise<void> {\n    if (this.usePubSub && !this.subscribed) {\n      this.subscribed = true;\n      this.backend.subscribe(async (result) => {\n        if (!result.ok || !this.running) {\n          return;\n        }\n\n        await sleep(this.listenDelay);\n        await this.tick();\n      });\n    }\n\n    while (this.running) {\n      try {\n        const claimedCount = await this.tick();\n        // only sleep if we didn't claim any work\n        if (claimedCount === 0) {\n          await sleep(DEFAULT_POLL_INTERVAL_MS);\n        }\n      } catch (error) {\n        console.error(\"Worker tick failed:\", error);\n        await sleep(DEFAULT_POLL_INTERVAL_MS);\n      }\n    }\n  }\n\n  /*\n   * Claim and process a workflow run for the given worker ID. Do not await the\n   * processing here to avoid blocking the caller.\n   * Returns the claimed workflow run, or null if none was available.\n   */\n  private async claimAndProcessWorkflowRunInBackground(\n    workerId: string,\n  ): Promise<WorkflowRun | null> {\n    // claim workflow run\n    const workflowRun = await this.backend.claimWorkflowRun({\n      workerId,\n      leaseDurationMs: DEFAULT_LEASE_DURATION_MS,\n    });\n    if (!workflowRun) return null;\n\n    const workflow = this.registry.get(workflowRun.workflowName, workflowRun.version);\n    if (!workflow) {\n      const versionStr = workflowRun.version ? ` (version: ${workflowRun.version})` : \"\";\n      await this.backend.failWorkflowRun({\n        workflowRunId: workflowRun.id,\n        workerId,\n        error: {\n          message: `Workflow \"${workflowRun.workflowName}\"${versionStr} is not registered`,\n        },\n      });\n      return null;\n    }\n\n    // create execution and start processing *async* w/o blocking\n    const execution = new WorkflowExecution({\n      backend: this.backend,\n      workflowRun,\n      workerId,\n    });\n    this.activeExecutions.add(execution);\n\n    this.processExecutionInBackground(execution, workflow)\n      .catch(() => {\n        // errors are already handled in processExecution\n      })\n      .finally(() => {\n        execution.stopHeartbeat();\n        this.activeExecutions.delete(execution);\n      });\n\n    return workflowRun;\n  }\n\n  /**\n   * Process a workflow execution, handling heartbeats, step execution, and\n   * marking success or failure.\n   * @param execution - Workflow execution\n   * @param workflow - Workflow to execute\n   * @returns Promise resolved when processing completes\n   */\n  private async processExecutionInBackground(\n    execution: WorkflowExecution,\n    workflow: Workflow<unknown, unknown, unknown>,\n  ): Promise<void> {\n    // start heartbeating\n    execution.startHeartbeat();\n\n    try {\n      await executeWorkflow({\n        backend: this.backend,\n        workflowRun: execution.workflowRun,\n        workflowFn: workflow.fn,\n        workflowVersion: execution.workflowRun.version,\n        workerId: execution.workerId,\n        retryPolicy: workflow.spec.retryPolicy,\n        signal: execution.signal,\n      });\n    } catch (error) {\n      if (execution.signal.aborted) {\n        return;\n      }\n\n      // specifically for unexpected errors in the execution wrapper itself, not\n      // for business logic errors (those are handled inside executeWorkflow)\n      console.error(\n        `Critical error during workflow execution for run ${execution.workflowRun.id}:`,\n        error,\n      );\n    }\n  }\n}\n\n/**\n * Configures the options for a WorkflowExecution.\n */\ninterface WorkflowExecutionOptions {\n  backend: Backend;\n  workflowRun: WorkflowRun;\n  workerId: string;\n}\n\n/**\n * Tracks a claimed workflow run and maintains its heartbeat lease for the\n * worker.\n */\nclass WorkflowExecution {\n  private backend: Backend;\n  workflowRun: WorkflowRun;\n  workerId: string;\n  private heartbeatTimer: NodeJS.Timeout | null = null;\n  private abortController = new AbortController();\n\n  constructor(options: WorkflowExecutionOptions) {\n    this.backend = options.backend;\n    this.workflowRun = options.workflowRun;\n    this.workerId = options.workerId;\n  }\n\n  /**\n   * 외부에서 abort 여부를 확인할 수 있는 signal입니다.\n   * heartbeat 실패 시 abort됩니다.\n   */\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  /**\n   * Start the heartbeat loop for this execution, heartbeating at half the lease\n   * duration.\n   */\n  startHeartbeat(): void {\n    const leaseDurationMs = DEFAULT_LEASE_DURATION_MS;\n    const heartbeatIntervalMs = leaseDurationMs / 2;\n\n    this.heartbeatTimer = setInterval(() => {\n      this.backend\n        .extendWorkflowRunLease({\n          workflowRunId: this.workflowRun.id,\n          workerId: this.workerId,\n          leaseDurationMs,\n        })\n        .catch((_error: unknown) => {\n          // lease 연장 실패에는 heartbeat를 중단하고 abort 신호를 보냅니다.\n          this.abortController.abort();\n          this.stopHeartbeat();\n        });\n    }, heartbeatIntervalMs);\n  }\n\n  /**\n   * Stop the heartbeat loop.\n   */\n  stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n}\n\n/**\n * Sleep for a given duration.\n * @param ms - Milliseconds to sleep\n * @returns Promise resolved after sleeping\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":"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"}

package/dist/workflow.d.ts

@@ -1,34 +1,36 @@
-import type { RetryPolicy } from "./core/retry";
-import type { StandardSchemaV1 } from "./core/schema";
-import type { WorkflowFunction } from "./execution";
-export interface WorkflowSpec<Input, Output, RawInput> {
-    /** The name of the workflow. */
-    readonly name: string;
-    /** The version of the workflow. */
-    readonly version?: string;
-    /** The schema used to validate inputs. */
-    readonly schema?: StandardSchemaV1<RawInput, Input>;
-    /** The retry policy for the workflow. */
-    readonly retryPolicy?: RetryPolicy;
-    /** Phantom type carrier - won't exist at runtime. */
-    readonly __types?: {
-        output: Output;
-    };
+import { RetryPolicy } from "./core/retry.js";
+import { StandardSchemaV1 } from "./core/schema.js";
+import { WorkflowFunction } from "./execution.js";
+
+//#region src/workflow.d.ts
+interface WorkflowSpec<Input, Output, RawInput> {
+  /** The name of the workflow. */
+  readonly name: string;
+  /** The version of the workflow. */
+  readonly version?: string;
+  /** The schema used to validate inputs. */
+  readonly schema?: StandardSchemaV1<RawInput, Input>;
+  /** The retry policy for the workflow. */
+  readonly retryPolicy?: RetryPolicy;
+  /** Phantom type carrier - won't exist at runtime. */
+  readonly __types?: {
+    output: Output;
+  };
 }
 /**
  * Define a workflow spec.
  * @param spec - The workflow spec
  * @returns The workflow spec
  */
-export declare function defineWorkflowSpec<Input, Output = unknown, RawInput = Input>(spec: WorkflowSpec<Input, Output, RawInput>): WorkflowSpec<Input, Output, RawInput>;
+declare function defineWorkflowSpec<Input, Output = unknown, RawInput = Input>(spec: WorkflowSpec<Input, Output, RawInput>): WorkflowSpec<Input, Output, RawInput>;
 /**
  * A workflow spec and implementation.
  */
-export interface Workflow<Input, Output, RawInput> {
-    /** The workflow spec. */
-    readonly spec: WorkflowSpec<Input, Output, RawInput>;
-    /** The workflow implementation function. */
-    readonly fn: WorkflowFunction<Input, Output>;
+interface Workflow<Input, Output, RawInput> {
+  /** The workflow spec. */
+  readonly spec: WorkflowSpec<Input, Output, RawInput>;
+  /** The workflow implementation function. */
+  readonly fn: WorkflowFunction<Input, Output>;
 }
 /**
  * Define a workflow.
@@ -36,12 +38,6 @@ export interface Workflow<Input, Output, RawInput> {
  * @param fn - The workflow implementation function
  * @returns The workflow
  */
-export declare function defineWorkflow<Input, Output, RawInput = Input>(spec: WorkflowSpec<Input, Output, RawInput>, fn: WorkflowFunction<Input, Output>): Workflow<Input, Output, RawInput>;
-/**
- * Define a workflow.
- * @param spec - The workflow spec
- * @param fn - The workflow implementation function
- * @returns The workflow
- */
-export declare function defineWorkflow<Input, WorkflowFn extends WorkflowFunction<Input, unknown> = WorkflowFunction<Input, unknown>, RawInput = Input>(spec: WorkflowSpec<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>, fn: WorkflowFn): Workflow<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>;
+//#endregion
+export { Workflow, WorkflowSpec, defineWorkflowSpec };
 //# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ;IACnD,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpD,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,QAAQ,GAAG,KAAK,EAC1E,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,GAC1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAEvC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ;IAC/C,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AAIH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAG,KAAK,EAC5D,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC3C,EAAE,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAErC;;;;;GAKG;AAGH,wBAAgB,cAAc,CAC5B,KAAK,EACL,UAAU,SAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EACtF,QAAQ,GAAG,KAAK,EAEhB,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,EACpE,EAAE,EAAE,UAAU,GACb,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../src/workflow.ts"],"sourcesContent":[],"mappings":";;;;;UAIiB;;EAAA,SAAA,IAAA,EAAY,MAAA;EAAA;WAMQ,OAAA,CAAA,EAAA,MAAA;;WAAjB,MAAA,CAAA,EAAA,gBAAA,CAAiB,QAAjB,EAA2B,KAA3B,CAAA;;WAKR,WAAA,CAAA,EAHa,WAGb;EAAM;EASF,SAAA,OAAA,CAAA,EAAA;IAAkB,MAAA,EATtB,MASsB;;;;;;;;AAEH,iBAFf,kBAEe,CAAA,KAAA,EAAA,SAAA,OAAA,EAAA,WAFwC,KAExC,CAAA,CAAA,IAAA,EADvB,YACuB,CADV,KACU,EADH,MACG,EADK,QACL,CAAA,CAAA,EAA5B,YAA4B,CAAf,KAAe,EAAR,MAAQ,EAAA,QAAA,CAAA;;;AAO/B;AAAyB,UAAR,QAAQ,CAAA,KAAA,EAAA,MAAA,EAAA,QAAA,CAAA,CAAA;;WAEY,IAAA,EAApB,YAAoB,CAAP,KAAO,EAAA,MAAA,EAAQ,QAAR,CAAA;;WAApB,EAAA,EAEF,gBAFE,CAEe,KAFf,EAEsB,MAFtB,CAAA"}

package/dist/workflow.js

@@ -1,21 +1,26 @@
+//#region src/workflow.ts
 /**
- * Define a workflow spec.
- * @param spec - The workflow spec
- * @returns The workflow spec
- */ export function defineWorkflowSpec(spec) {
-    return spec;
+* Define a workflow spec.
+* @param spec - The workflow spec
+* @returns The workflow spec
+*/
+function defineWorkflowSpec(spec) {
+	return spec;
 }
 /**
- * Define a workflow.
- * @internal
- * @param spec - The workflow spec
- * @param fn - The workflow implementation function
- * @returns The workflow
- */ export function defineWorkflow(spec, fn) {
-    return {
-        spec,
-        fn
-    };
+* Define a workflow.
+* @internal
+* @param spec - The workflow spec
+* @param fn - The workflow implementation function
+* @returns The workflow
+*/
+function defineWorkflow(spec, fn) {
+	return {
+		spec,
+		fn
+	};
 }
 
+//#endregion
+export { defineWorkflow, defineWorkflowSpec };
 //# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/workflow.ts"],"sourcesContent":["import type { RetryPolicy } from \"./core/retry\";\nimport type { StandardSchemaV1 } from \"./core/schema\";\nimport type { WorkflowFunction } from \"./execution\";\n\nexport interface WorkflowSpec<Input, Output, RawInput> {\n  /** The name of the workflow. */\n  readonly name: string;\n  /** The version of the workflow. */\n  readonly version?: string;\n  /** The schema used to validate inputs. */\n  readonly schema?: StandardSchemaV1<RawInput, Input>;\n  /** The retry policy for the workflow. */\n  readonly retryPolicy?: RetryPolicy;\n  /** Phantom type carrier - won't exist at runtime. */\n  readonly __types?: {\n    output: Output;\n  };\n}\n\n/**\n * Define a workflow spec.\n * @param spec - The workflow spec\n * @returns The workflow spec\n */\nexport function defineWorkflowSpec<Input, Output = unknown, RawInput = Input>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n): WorkflowSpec<Input, Output, RawInput> {\n  return spec;\n}\n\n/**\n * A workflow spec and implementation.\n */\nexport interface Workflow<Input, Output, RawInput> {\n  /** The workflow spec. */\n  readonly spec: WorkflowSpec<Input, Output, RawInput>;\n  /** The workflow implementation function. */\n  readonly fn: WorkflowFunction<Input, Output>;\n}\n\n/**\n * Define a workflow.\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\n// Handles:\n// - `defineWorkflow(spec, fn)` (0 generics)\n// - `defineWorkflow<Input, Output>(spec, fn)` (2 generics)\nexport function defineWorkflow<Input, Output, RawInput = Input>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n  fn: WorkflowFunction<Input, Output>,\n): Workflow<Input, Output, RawInput>;\n\n/**\n * Define a workflow.\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\n// Handles:\n// - `defineWorkflow<Input>(spec, fn)` (1 generic)\nexport function defineWorkflow<\n  Input,\n  WorkflowFn extends WorkflowFunction<Input, unknown> = WorkflowFunction<Input, unknown>,\n  RawInput = Input,\n>(\n  spec: WorkflowSpec<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>,\n  fn: WorkflowFn,\n): Workflow<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>;\n\n/**\n * Define a workflow.\n * @internal\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\nexport function defineWorkflow<Input, Output, RawInput>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n  fn: WorkflowFunction<Input, Output>,\n): Workflow<Input, Output, RawInput> {\n  return {\n    spec,\n    fn,\n  };\n}\n"],"names":["defineWorkflowSpec","spec","defineWorkflow","fn"],"mappings":"AAmBA;;;;CAIC,GACD,OAAO,SAASA,mBACdC,IAA2C;IAE3C,OAAOA;AACT;AA2CA;;;;;;CAMC,GACD,OAAO,SAASC,eACdD,IAA2C,EAC3CE,EAAmC;IAEnC,OAAO;QACLF;QACAE;IACF;AACF"}
+{"version":3,"file":"workflow.js","names":[],"sources":["../src/workflow.ts"],"sourcesContent":["import { type RetryPolicy } from \"./core/retry\";\nimport { type StandardSchemaV1 } from \"./core/schema\";\nimport { type WorkflowFunction } from \"./execution\";\n\nexport interface WorkflowSpec<Input, Output, RawInput> {\n  /** The name of the workflow. */\n  readonly name: string;\n  /** The version of the workflow. */\n  readonly version?: string;\n  /** The schema used to validate inputs. */\n  readonly schema?: StandardSchemaV1<RawInput, Input>;\n  /** The retry policy for the workflow. */\n  readonly retryPolicy?: RetryPolicy;\n  /** Phantom type carrier - won't exist at runtime. */\n  readonly __types?: {\n    output: Output;\n  };\n}\n\n/**\n * Define a workflow spec.\n * @param spec - The workflow spec\n * @returns The workflow spec\n */\nexport function defineWorkflowSpec<Input, Output = unknown, RawInput = Input>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n): WorkflowSpec<Input, Output, RawInput> {\n  return spec;\n}\n\n/**\n * A workflow spec and implementation.\n */\nexport interface Workflow<Input, Output, RawInput> {\n  /** The workflow spec. */\n  readonly spec: WorkflowSpec<Input, Output, RawInput>;\n  /** The workflow implementation function. */\n  readonly fn: WorkflowFunction<Input, Output>;\n}\n\n/**\n * Define a workflow.\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\n// Handles:\n// - `defineWorkflow(spec, fn)` (0 generics)\n// - `defineWorkflow<Input, Output>(spec, fn)` (2 generics)\nexport function defineWorkflow<Input, Output, RawInput = Input>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n  fn: WorkflowFunction<Input, Output>,\n): Workflow<Input, Output, RawInput>;\n\n/**\n * Define a workflow.\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\n// Handles:\n// - `defineWorkflow<Input>(spec, fn)` (1 generic)\nexport function defineWorkflow<\n  Input,\n  WorkflowFn extends WorkflowFunction<Input, unknown> = WorkflowFunction<Input, unknown>,\n  RawInput = Input,\n>(\n  spec: WorkflowSpec<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>,\n  fn: WorkflowFn,\n): Workflow<Input, Awaited<ReturnType<WorkflowFn>>, RawInput>;\n\n/**\n * Define a workflow.\n * @internal\n * @param spec - The workflow spec\n * @param fn - The workflow implementation function\n * @returns The workflow\n */\nexport function defineWorkflow<Input, Output, RawInput>(\n  spec: WorkflowSpec<Input, Output, RawInput>,\n  fn: WorkflowFunction<Input, Output>,\n): Workflow<Input, Output, RawInput> {\n  return {\n    spec,\n    fn,\n  };\n}\n"],"mappings":";;;;;;AAwBA,SAAgB,mBACd,MACuC;AACvC,QAAO;;;;;;;;;AAmDT,SAAgB,eACd,MACA,IACmC;AACnC,QAAO;EACL;EACA;EACD"}

package/nodemon.json

@@ -1,6 +1,6 @@
 {
   "watch": ["src"],
   "ext": "ts,json",
-  "exec": "swc src --config-file .swcrc -d dist --strip-leading-paths && tsc --emitDeclarationOnly && node --enable-source-maps dist/index.js",
+  "exec": "rm -rf dist && tsdown && node --enable-source-maps dist/index.js",
   "signal": "SIGUSR2"
 }