@usehelical/workflows 0.0.1-alpha.3 → 0.0.1-alpha.4

package/dist/workflows.d.ts

@@ -1,4 +1,5 @@
-export { M as MessageDefinition, b as QueueDefinition, Q as QueueEntry, c as QueueOptions, d as QueueRateLimit, S as StateDefinition, e as WorkflowDefinition, a as WorkflowEntry, f as WorkflowFunction, W as WorkflowStatus, g as defineMessage, h as defineQueue, i as defineState, j as defineWorkflow } from './state-CmpqDrnz.js';
+import { S as StateDefinition, M as MessageDefinition } from './state-CmpqDrnz.js';
+export { b as QueueDefinition, Q as QueueEntry, c as QueueOptions, d as QueueRateLimit, e as WorkflowDefinition, a as WorkflowEntry, f as WorkflowFunction, W as WorkflowStatus, g as defineMessage, h as defineQueue, i as defineState, j as defineWorkflow } from './state-CmpqDrnz.js';
 
 type RetryConfig = {
     maxRetries?: number;
@@ -16,4 +17,27 @@ type StepDefinition<TArgs extends unknown[], TReturn> = {
 };
 declare function defineStep<TArgs extends unknown[], TReturn>(fn: StepFunction<TArgs, TReturn>, options?: StepOptions): (...args: TArgs) => StepDefinition<TArgs, TReturn>;
 
-export { type RetryConfig, type StepDefinition, type StepFunction, defineStep };
+declare function runStep<TArgs extends unknown[], TReturn>(step: StepDefinition<TArgs, TReturn>): Promise<TReturn | (TReturn extends void ? void : TReturn)>;
+declare function executeStepWithRetries<TArgs extends unknown[], TReturn>(stepName: string, fn: StepFunction<TArgs, TReturn>, args: TArgs, retryConfig: RetryConfig): Promise<TReturn>;
+
+declare function setState<T = unknown>(state: StateDefinition<T> | string, value: T): Promise<void | (T extends void ? void : T)>;
+
+declare function receiveMessage<T>(message: MessageDefinition<T> | string): Promise<T>;
+
+/**
+ * Generates a stable, unique step ID based on the current run ID and sequence ID.
+ * This ID is deterministic and will remain the same across retries, making it
+ * suitable for use as an idempotency key with third-party systems.
+ *
+ * The step ID is a SHA-256 hash of the run ID and sequence ID, formatted as a
+ * hex string for easy use with external APIs.
+ *
+ * @returns A unique, stable identifier for the current step execution
+ */
+declare function getStepId(): string;
+
+declare function getAbortSignal(): AbortSignal;
+
+declare function getRunId(): string;
+
+export { MessageDefinition, type RetryConfig, StateDefinition, type StepDefinition, type StepFunction, defineStep, executeStepWithRetries, getAbortSignal, getRunId, getStepId, receiveMessage, runStep, setState };

package/dist/workflows.js

@@ -3,5 +3,6 @@ export * from './queue';
 export * from './state';
 export * from './step';
 export * from './workflow';
+export * from './steps';
 //# sourceMappingURL=workflows.js.map
 //# sourceMappingURL=workflows.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usehelical/workflows",
-  "version": "0.0.1-alpha.3",
+  "version": "0.0.1-alpha.4",
   "description": "simple typesage durable workflows without magic",
   "main": "./dist/index.js",
   "type": "module",
@@ -40,6 +40,7 @@
   "devDependencies": {
     "@electric-sql/pglite": "^0.3.15",
     "@eslint/js": "^9.39.2",
+    "@types/node": "^25.2.0",
     "@types/pg": "^8.16.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",