flowli 0.2.2 → 0.3.0

package/README.md

@@ -427,6 +427,12 @@ Flowli supports:
 
 The job definitions stay the same. Only the driver changes.
 
+Retry defaults can be attached globally or per job, including:
+
+- `fixed` and `exponential` backoff
+- capped retries with `maxDelayMs`
+- jitter to spread retry bursts
+
 ## Runner
 
 The runner is explicit and secondary by design.

package/dist/core/types.d.ts

@@ -31,9 +31,15 @@ export interface JobDefaults {
     readonly maxAttempts?: number;
     readonly backoff?: BackoffOptions;
 }
+export interface BackoffJitterOptions {
+    readonly minRatio: number;
+    readonly maxRatio: number;
+}
 export interface BackoffOptions {
     readonly type: "fixed" | "exponential";
     readonly delayMs: number;
+    readonly maxDelayMs?: number;
+    readonly jitter?: boolean | BackoffJitterOptions;
 }
 export interface FlowliInvocationOptions<TMeta> {
     readonly meta?: TMeta;
@@ -99,7 +105,7 @@ export interface FlowliDriver {
     acquireNextReady(now: number, leaseMs: number): Promise<AcquiredJobRecord | null>;
     renewLease(jobId: string, token: string, leaseMs: number): Promise<boolean>;
     markCompleted(acquired: AcquiredJobRecord, finishedAt: number): Promise<void>;
-    markFailed(acquired: AcquiredJobRecord, finishedAt: number, error: PersistedJobError): Promise<"failed" | "retrying">;
+    markFailed(acquired: AcquiredJobRecord, finishedAt: number, error: PersistedJobError): Promise<MarkFailedResult>;
     materializeDueSchedules(now: number, leaseMs: number): Promise<number>;
 }
 export interface DefineJobsOptions<TJobs extends JobsRecord, TContext extends FlowliContextRecord> {
@@ -153,9 +159,16 @@ export interface PersistedJobRecord {
     readonly updatedAt: number;
     readonly scheduledFor: number;
     readonly attemptsMade: number;
+    readonly failureCount: number;
     readonly maxAttempts: number;
     readonly backoff?: BackoffOptions;
     readonly lastError?: PersistedJobError;
+    readonly lastFailedAt?: number;
+    readonly nextRetryAt?: number;
+}
+export interface MarkFailedResult {
+    readonly state: "failed" | "retrying";
+    readonly retryAt?: number;
 }
 export interface AcquiredJobRecord {
     readonly token: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { defineJobs } from "./core/define-jobs.js";
 export { FlowliDefinitionError, FlowliDriverError, FlowliError, FlowliSchedulingError, FlowliStrategyError, FlowliValidationError, } from "./core/errors.js";
 export { createContextualJobFactory, job } from "./core/job.js";
-export type { BackoffOptions, DefineJobsBuilder, DelayValue, FlowliContextRecord, FlowliContextResolver, FlowliDriver, FlowliInvocationOptions, FlowliJobSurface, FlowliRuntime, JobDefaults, JobDefinition, JobHandlerArgs, JobReceipt, ScheduleInvocation, ScheduleReceipt, StandardSchemaIssue, StandardSchemaV1, } from "./core/types.js";
+export type { BackoffJitterOptions, BackoffOptions, DefineJobsBuilder, DelayValue, FlowliContextRecord, FlowliContextResolver, FlowliDriver, FlowliInvocationOptions, FlowliJobSurface, FlowliRuntime, JobDefaults, JobDefinition, JobHandlerArgs, JobReceipt, ScheduleInvocation, ScheduleReceipt, StandardSchemaIssue, StandardSchemaV1, } from "./core/types.js";

package/dist/runner/types.d.ts

@@ -3,6 +3,7 @@ export interface RunnerHooks {
     readonly onJobStarted?: (jobId: string, jobName: string) => void | Promise<void>;
     readonly onJobCompleted?: (jobId: string, jobName: string) => void | Promise<void>;
     readonly onJobFailed?: (jobId: string, jobName: string, error: PersistedJobError) => void | Promise<void>;
+    readonly onJobRetryScheduled?: (jobId: string, jobName: string, retryAt: number, error: PersistedJobError) => void | Promise<void>;
 }
 export interface RunnerOptions<TJobs extends JobsRecord, TContext extends FlowliContextRecord> {
     readonly flowli: FlowliRuntime<TJobs, TContext>;

package/jsr.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://jsr.io/schema/config-file.v1.json",
   "name": "@alialnaghmoush/flowli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "exports": {
     ".": "./src/index.ts",
     "./ioredis": "./src/ioredis.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Flowli is a jobs runtime with a code-first API, first-class execution strategies, runtime-scoped context injection, and pluggable Redis drivers.",
   "keywords": [
     "jobs",