@sonamu-kit/tasks 0.1.3 → 0.3.0

package/.oxlintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["../../.oxlintrc.base.json"]
+}

package/AGENTS.md

@@ -0,0 +1,21 @@
+# Guide for Coding Agents - modules/tasks
+
+Inherits root rules from `../../AGENTS.md`.
+
+## Package role
+
+- Distributed task queue library.
+
+## Required checks
+
+- `pnpm --filter @sonamu-kit/tasks check`
+- `pnpm --filter @sonamu-kit/tasks test`
+- `pnpm --filter @sonamu-kit/tasks build`
+
+## Testing policy
+
+- For scheduling/retry/distribution logic changes, add regression tests before implementation completion.
+
+## Cross-workspace gate
+
+- For changes in this scope, root `pnpm check` (Biome) must pass before handoff.

package/dist/backend.d.ts

@@ -1,107 +1,130 @@
-import type { SerializedError } from "./core/error";
-import type { JsonValue } from "./core/json";
-import type { StepAttempt, StepAttemptContext, StepKind } from "./core/step";
-import type { WorkflowRun } from "./core/workflow";
-import type { OnSubscribed } from "./database/pubsub";
-export declare const DEFAULT_NAMESPACE_ID = "default";
+import { JsonValue } from "./core/json.js";
+import { SerializedError } from "./core/error.js";
+import { SerializableRetryPolicy } from "./core/retry.js";
+import { StepAttempt, StepAttemptContext, StepKind } from "./core/step.js";
+import { WorkflowRun } from "./core/workflow.js";
+import { OnSubscribed } from "./database/pubsub.js";
+
+//#region src/backend.d.ts
+declare const DEFAULT_NAMESPACE_ID = "default";
 /**
  * Backend is the interface for backend providers to implement.
  */
-export interface Backend {
-    subscribe(callback: OnSubscribed): Promise<void>;
-    publish(payload?: string): Promise<void>;
-    createWorkflowRun(params: Readonly<CreateWorkflowRunParams>): Promise<WorkflowRun>;
-    getWorkflowRun(params: Readonly<GetWorkflowRunParams>): Promise<WorkflowRun | null>;
-    listWorkflowRuns(params: Readonly<ListWorkflowRunsParams>): Promise<PaginatedResponse<WorkflowRun>>;
-    claimWorkflowRun(params: Readonly<ClaimWorkflowRunParams>): Promise<WorkflowRun | null>;
-    extendWorkflowRunLease(params: Readonly<ExtendWorkflowRunLeaseParams>): Promise<WorkflowRun>;
-    sleepWorkflowRun(params: Readonly<SleepWorkflowRunParams>): Promise<WorkflowRun>;
-    completeWorkflowRun(params: Readonly<CompleteWorkflowRunParams>): Promise<WorkflowRun>;
-    failWorkflowRun(params: Readonly<FailWorkflowRunParams>): Promise<WorkflowRun>;
-    cancelWorkflowRun(params: Readonly<CancelWorkflowRunParams>): Promise<WorkflowRun>;
-    createStepAttempt(params: Readonly<CreateStepAttemptParams>): Promise<StepAttempt>;
-    getStepAttempt(params: Readonly<GetStepAttemptParams>): Promise<StepAttempt | null>;
-    listStepAttempts(params: Readonly<ListStepAttemptsParams>): Promise<PaginatedResponse<StepAttempt>>;
-    completeStepAttempt(params: Readonly<CompleteStepAttemptParams>): Promise<StepAttempt>;
-    failStepAttempt(params: Readonly<FailStepAttemptParams>): Promise<StepAttempt>;
-}
-export interface CreateWorkflowRunParams {
-    workflowName: string;
-    version: string | null;
-    idempotencyKey: string | null;
-    config: JsonValue;
-    context: JsonValue | null;
-    input: JsonValue | null;
-    availableAt: Date | null;
-    deadlineAt: Date | null;
-}
-export interface GetWorkflowRunParams {
-    workflowRunId: string;
-}
-export type ListWorkflowRunsParams = PaginationOptions;
-export interface ClaimWorkflowRunParams {
-    workerId: string;
-    leaseDurationMs: number;
-}
-export interface ExtendWorkflowRunLeaseParams {
-    workflowRunId: string;
-    workerId: string;
-    leaseDurationMs: number;
-}
-export interface SleepWorkflowRunParams {
-    workflowRunId: string;
-    workerId: string;
-    availableAt: Date;
-}
-export interface CompleteWorkflowRunParams {
-    workflowRunId: string;
-    workerId: string;
-    output: JsonValue | null;
-}
-export interface FailWorkflowRunParams {
-    workflowRunId: string;
-    workerId: string;
-    error: SerializedError;
-}
-export interface CancelWorkflowRunParams {
-    workflowRunId: string;
-}
-export interface CreateStepAttemptParams {
-    workflowRunId: string;
-    workerId: string;
-    stepName: string;
-    kind: StepKind;
-    config: JsonValue;
-    context: StepAttemptContext | null;
-}
-export interface GetStepAttemptParams {
-    stepAttemptId: string;
-}
-export interface ListStepAttemptsParams extends PaginationOptions {
-    workflowRunId: string;
-}
-export interface CompleteStepAttemptParams {
-    workflowRunId: string;
-    stepAttemptId: string;
-    workerId: string;
-    output: JsonValue | null;
-}
-export interface FailStepAttemptParams {
-    workflowRunId: string;
-    stepAttemptId: string;
-    workerId: string;
-    error: SerializedError;
-}
-export interface PaginationOptions {
-    limit?: number;
-    after?: string;
-    before?: string;
-}
-export interface PaginatedResponse<T> {
-    data: T[];
-    pagination: {
-        next: string | null;
-        prev: string | null;
-    };
-}
+interface Backend {
+  subscribe(callback: OnSubscribed): Promise<void>;
+  publish(payload?: string): Promise<void>;
+  createWorkflowRun(params: Readonly<CreateWorkflowRunParams>): Promise<WorkflowRun>;
+  getWorkflowRun(params: Readonly<GetWorkflowRunParams>): Promise<WorkflowRun | null>;
+  listWorkflowRuns(params: Readonly<ListWorkflowRunsParams>): Promise<PaginatedResponse<WorkflowRun>>;
+  claimWorkflowRun(params: Readonly<ClaimWorkflowRunParams>): Promise<WorkflowRun | null>;
+  extendWorkflowRunLease(params: Readonly<ExtendWorkflowRunLeaseParams>): Promise<WorkflowRun>;
+  sleepWorkflowRun(params: Readonly<SleepWorkflowRunParams>): Promise<WorkflowRun>;
+  completeWorkflowRun(params: Readonly<CompleteWorkflowRunParams>): Promise<WorkflowRun>;
+  failWorkflowRun(params: Readonly<FailWorkflowRunParams>): Promise<WorkflowRun>;
+  cancelWorkflowRun(params: Readonly<CancelWorkflowRunParams>): Promise<WorkflowRun>;
+  pauseWorkflowRun(params: Readonly<PauseWorkflowRunParams>): Promise<WorkflowRun>;
+  resumeWorkflowRun(params: Readonly<ResumeWorkflowRunParams>): Promise<WorkflowRun>;
+  createStepAttempt(params: Readonly<CreateStepAttemptParams>): Promise<StepAttempt>;
+  getStepAttempt(params: Readonly<GetStepAttemptParams>): Promise<StepAttempt | null>;
+  listStepAttempts(params: Readonly<ListStepAttemptsParams>): Promise<PaginatedResponse<StepAttempt>>;
+  completeStepAttempt(params: Readonly<CompleteStepAttemptParams>): Promise<StepAttempt | null>;
+  failStepAttempt(params: Readonly<FailStepAttemptParams>): Promise<StepAttempt | null>;
+}
+interface CreateWorkflowRunParams {
+  workflowName: string;
+  version: string | null;
+  idempotencyKey: string | null;
+  config: JsonValue;
+  context: JsonValue | null;
+  input: JsonValue | null;
+  availableAt: Date | null;
+  deadlineAt: Date | null;
+  retryPolicy?: SerializableRetryPolicy;
+}
+interface GetWorkflowRunParams {
+  workflowRunId: string;
+}
+interface ListWorkflowRunsParams extends PaginationOptions {
+  status?: string[];
+  workflowName?: string;
+  createdAfter?: Date;
+  createdBefore?: Date;
+}
+interface ClaimWorkflowRunParams {
+  workerId: string;
+  leaseDurationMs: number;
+}
+interface ExtendWorkflowRunLeaseParams {
+  workflowRunId: string;
+  workerId: string;
+  leaseDurationMs: number;
+}
+interface SleepWorkflowRunParams {
+  workflowRunId: string;
+  workerId: string;
+  availableAt: Date;
+}
+interface CompleteWorkflowRunParams {
+  workflowRunId: string;
+  workerId: string;
+  output: JsonValue | null;
+}
+interface FailWorkflowRunParams {
+  workflowRunId: string;
+  workerId: string;
+  error: SerializedError;
+  forceComplete?: boolean;
+  customDelayMs?: number;
+}
+interface CancelWorkflowRunParams {
+  workflowRunId: string;
+}
+interface PauseWorkflowRunParams {
+  workflowRunId: string;
+}
+interface ResumeWorkflowRunParams {
+  workflowRunId: string;
+}
+interface CreateStepAttemptParams {
+  workflowRunId: string;
+  workerId: string;
+  stepName: string;
+  kind: StepKind;
+  config: JsonValue;
+  context: StepAttemptContext | null;
+}
+interface GetStepAttemptParams {
+  stepAttemptId: string;
+}
+interface ListStepAttemptsParams extends PaginationOptions {
+  workflowRunId: string;
+}
+interface CompleteStepAttemptParams {
+  workflowRunId: string;
+  stepAttemptId: string;
+  workerId: string;
+  output: JsonValue | null;
+}
+interface FailStepAttemptParams {
+  workflowRunId: string;
+  stepAttemptId: string;
+  workerId: string;
+  error: SerializedError;
+}
+interface PaginationOptions {
+  limit?: number;
+  after?: string;
+  before?: string;
+  order?: "asc" | "desc";
+}
+interface PaginatedResponse<T> {
+  data: T[];
+  pagination: {
+    next: string | null;
+    prev: string | null;
+  };
+}
+//# sourceMappingURL=backend.d.ts.map
+//#endregion
+export { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CompleteStepAttemptParams, CompleteWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, DEFAULT_NAMESPACE_ID, ExtendWorkflowRunLeaseParams, FailStepAttemptParams, FailWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, PaginationOptions, PauseWorkflowRunParams, ResumeWorkflowRunParams, SleepWorkflowRunParams };
 //# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,OAAO;IAEtB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnF,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpF,gBAAgB,CACd,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxF,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,4BAA4B,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7F,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvF,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/E,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAGnF,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnF,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpF,gBAAgB,CACd,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3C,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvF,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,CAAC;CACH"}
+{"version":3,"file":"backend.d.ts","names":[],"sources":["../src/backend.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/backend.js

@@ -1,3 +1,6 @@
-export const DEFAULT_NAMESPACE_ID = "default";
+//#region src/backend.ts
+const DEFAULT_NAMESPACE_ID = "default";
 
+//#endregion
+export { DEFAULT_NAMESPACE_ID };
 //# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/backend.ts"],"sourcesContent":["import type { SerializedError } from \"./core/error\";\nimport type { JsonValue } from \"./core/json\";\nimport type { StepAttempt, StepAttemptContext, StepKind } from \"./core/step\";\nimport type { WorkflowRun } from \"./core/workflow\";\nimport type { OnSubscribed } from \"./database/pubsub\";\n\nexport const DEFAULT_NAMESPACE_ID = \"default\";\n\n/**\n * Backend is the interface for backend providers to implement.\n */\nexport interface Backend {\n  // Listen for events on a channel\n  subscribe(callback: OnSubscribed): Promise<void>;\n  publish(payload?: string): Promise<void>;\n\n  // Workflow Runs\n  createWorkflowRun(params: Readonly<CreateWorkflowRunParams>): Promise<WorkflowRun>;\n  getWorkflowRun(params: Readonly<GetWorkflowRunParams>): Promise<WorkflowRun | null>;\n  listWorkflowRuns(\n    params: Readonly<ListWorkflowRunsParams>,\n  ): Promise<PaginatedResponse<WorkflowRun>>;\n  claimWorkflowRun(params: Readonly<ClaimWorkflowRunParams>): Promise<WorkflowRun | null>;\n  extendWorkflowRunLease(params: Readonly<ExtendWorkflowRunLeaseParams>): Promise<WorkflowRun>;\n  sleepWorkflowRun(params: Readonly<SleepWorkflowRunParams>): Promise<WorkflowRun>;\n  completeWorkflowRun(params: Readonly<CompleteWorkflowRunParams>): Promise<WorkflowRun>;\n  failWorkflowRun(params: Readonly<FailWorkflowRunParams>): Promise<WorkflowRun>;\n  cancelWorkflowRun(params: Readonly<CancelWorkflowRunParams>): Promise<WorkflowRun>;\n\n  // Step Attempts\n  createStepAttempt(params: Readonly<CreateStepAttemptParams>): Promise<StepAttempt>;\n  getStepAttempt(params: Readonly<GetStepAttemptParams>): Promise<StepAttempt | null>;\n  listStepAttempts(\n    params: Readonly<ListStepAttemptsParams>,\n  ): Promise<PaginatedResponse<StepAttempt>>;\n  completeStepAttempt(params: Readonly<CompleteStepAttemptParams>): Promise<StepAttempt>;\n  failStepAttempt(params: Readonly<FailStepAttemptParams>): Promise<StepAttempt>;\n}\n\nexport interface CreateWorkflowRunParams {\n  workflowName: string;\n  version: string | null;\n  idempotencyKey: string | null;\n  config: JsonValue;\n  context: JsonValue | null;\n  input: JsonValue | null;\n  availableAt: Date | null; // null = immediately\n  deadlineAt: Date | null; // null = no deadline\n}\n\nexport interface GetWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport type ListWorkflowRunsParams = PaginationOptions;\n\nexport interface ClaimWorkflowRunParams {\n  workerId: string;\n  leaseDurationMs: number;\n}\n\nexport interface ExtendWorkflowRunLeaseParams {\n  workflowRunId: string;\n  workerId: string;\n  leaseDurationMs: number;\n}\n\nexport interface SleepWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  availableAt: Date;\n}\n\nexport interface CompleteWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  output: JsonValue | null;\n}\n\nexport interface FailWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  error: SerializedError;\n}\n\nexport interface CancelWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport interface CreateStepAttemptParams {\n  workflowRunId: string;\n  workerId: string;\n  stepName: string;\n  kind: StepKind;\n  config: JsonValue;\n  context: StepAttemptContext | null;\n}\n\nexport interface GetStepAttemptParams {\n  stepAttemptId: string;\n}\n\nexport interface ListStepAttemptsParams extends PaginationOptions {\n  workflowRunId: string;\n}\n\nexport interface CompleteStepAttemptParams {\n  workflowRunId: string;\n  stepAttemptId: string;\n  workerId: string;\n  output: JsonValue | null;\n}\n\nexport interface FailStepAttemptParams {\n  workflowRunId: string;\n  stepAttemptId: string;\n  workerId: string;\n  error: SerializedError;\n}\n\nexport interface PaginationOptions {\n  limit?: number;\n  after?: string;\n  before?: string;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  pagination: {\n    next: string | null;\n    prev: string | null;\n  };\n}\n"],"names":["DEFAULT_NAMESPACE_ID"],"mappings":"AAMA,OAAO,MAAMA,uBAAuB,UAAU"}
+{"version":3,"file":"backend.js","names":[],"sources":["../src/backend.ts"],"sourcesContent":["import { type SerializedError } from \"./core/error\";\nimport { type JsonValue } from \"./core/json\";\nimport { type SerializableRetryPolicy } from \"./core/retry\";\nimport { type StepAttempt, type StepAttemptContext, type StepKind } from \"./core/step\";\nimport { type WorkflowRun } from \"./core/workflow\";\nimport { type OnSubscribed } from \"./database/pubsub\";\n\nexport const DEFAULT_NAMESPACE_ID = \"default\";\n\n/**\n * Backend is the interface for backend providers to implement.\n */\nexport interface Backend {\n  // Listen for events on a channel\n  subscribe(callback: OnSubscribed): Promise<void>;\n  publish(payload?: string): Promise<void>;\n\n  // Workflow Runs\n  createWorkflowRun(params: Readonly<CreateWorkflowRunParams>): Promise<WorkflowRun>;\n  getWorkflowRun(params: Readonly<GetWorkflowRunParams>): Promise<WorkflowRun | null>;\n  listWorkflowRuns(\n    params: Readonly<ListWorkflowRunsParams>,\n  ): Promise<PaginatedResponse<WorkflowRun>>;\n  claimWorkflowRun(params: Readonly<ClaimWorkflowRunParams>): Promise<WorkflowRun | null>;\n  extendWorkflowRunLease(params: Readonly<ExtendWorkflowRunLeaseParams>): Promise<WorkflowRun>;\n  sleepWorkflowRun(params: Readonly<SleepWorkflowRunParams>): Promise<WorkflowRun>;\n  completeWorkflowRun(params: Readonly<CompleteWorkflowRunParams>): Promise<WorkflowRun>;\n  failWorkflowRun(params: Readonly<FailWorkflowRunParams>): Promise<WorkflowRun>;\n  cancelWorkflowRun(params: Readonly<CancelWorkflowRunParams>): Promise<WorkflowRun>;\n  pauseWorkflowRun(params: Readonly<PauseWorkflowRunParams>): Promise<WorkflowRun>;\n  resumeWorkflowRun(params: Readonly<ResumeWorkflowRunParams>): Promise<WorkflowRun>;\n\n  // Step Attempts\n  createStepAttempt(params: Readonly<CreateStepAttemptParams>): Promise<StepAttempt>;\n  getStepAttempt(params: Readonly<GetStepAttemptParams>): Promise<StepAttempt | null>;\n  listStepAttempts(\n    params: Readonly<ListStepAttemptsParams>,\n  ): Promise<PaginatedResponse<StepAttempt>>;\n  completeStepAttempt(params: Readonly<CompleteStepAttemptParams>): Promise<StepAttempt | null>;\n  failStepAttempt(params: Readonly<FailStepAttemptParams>): Promise<StepAttempt | null>;\n}\n\nexport interface CreateWorkflowRunParams {\n  workflowName: string;\n  version: string | null;\n  idempotencyKey: string | null;\n  config: JsonValue;\n  context: JsonValue | null;\n  input: JsonValue | null;\n  availableAt: Date | null; // null = immediately\n  deadlineAt: Date | null; // null = no deadline\n  retryPolicy?: SerializableRetryPolicy;\n}\n\nexport interface GetWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport interface ListWorkflowRunsParams extends PaginationOptions {\n  status?: string[];\n  workflowName?: string;\n  createdAfter?: Date;\n  createdBefore?: Date;\n}\n\nexport interface ClaimWorkflowRunParams {\n  workerId: string;\n  leaseDurationMs: number;\n}\n\nexport interface ExtendWorkflowRunLeaseParams {\n  workflowRunId: string;\n  workerId: string;\n  leaseDurationMs: number;\n}\n\nexport interface SleepWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  availableAt: Date;\n}\n\nexport interface CompleteWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  output: JsonValue | null;\n}\n\nexport interface FailWorkflowRunParams {\n  workflowRunId: string;\n  workerId: string;\n  error: SerializedError;\n  forceComplete?: boolean;\n  customDelayMs?: number;\n}\n\nexport interface CancelWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport interface PauseWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport interface ResumeWorkflowRunParams {\n  workflowRunId: string;\n}\n\nexport interface CreateStepAttemptParams {\n  workflowRunId: string;\n  workerId: string;\n  stepName: string;\n  kind: StepKind;\n  config: JsonValue;\n  context: StepAttemptContext | null;\n}\n\nexport interface GetStepAttemptParams {\n  stepAttemptId: string;\n}\n\nexport interface ListStepAttemptsParams extends PaginationOptions {\n  workflowRunId: string;\n}\n\nexport interface CompleteStepAttemptParams {\n  workflowRunId: string;\n  stepAttemptId: string;\n  workerId: string;\n  output: JsonValue | null;\n}\n\nexport interface FailStepAttemptParams {\n  workflowRunId: string;\n  stepAttemptId: string;\n  workerId: string;\n  error: SerializedError;\n}\n\nexport interface PaginationOptions {\n  limit?: number;\n  after?: string;\n  before?: string;\n  order?: \"asc\" | \"desc\";\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  pagination: {\n    next: string | null;\n    prev: string | null;\n  };\n}\n"],"mappings":";AAOA,MAAa,uBAAuB"}