@coji/durably 0.13.0 → 0.14.0

package/README.md

@@ -1,6 +1,6 @@
 # @coji/durably
 
-Step-oriented resumable batch execution for Node.js and browsers using SQLite.
+Steps that survive crashes. SQLite to PostgreSQL.
 
 **[Documentation](https://coji.github.io/durably/)** | **[GitHub](https://github.com/coji/durably)** | **[Live Demo](https://durably-demo.vercel.app)**
 
@@ -9,10 +9,14 @@ Step-oriented resumable batch execution for Node.js and browsers using SQLite.
 ## Installation
 
 ```bash
-npm install @coji/durably kysely zod better-sqlite3
+# libSQL (recommended default)
+npm install @coji/durably kysely zod @libsql/client @libsql/kysely-libsql
+
+# PostgreSQL (multi-worker)
+npm install @coji/durably kysely zod pg
 ```
 
-See the [Quick Start](https://coji.github.io/durably/guide/quick-start) for other SQLite backends (libsql, SQLocal for browsers).
+See [Choosing a Database](https://coji.github.io/durably/guide/databases) for all backends.
 
 ## Quick Start
 

package/dist/{chunk-UCUP6NMJ.js → chunk-L42OCQEV.js}

@@ -3,8 +3,8 @@ function withLogPersistence() {
   return {
     name: "log-persistence",
     install(durably) {
-      durably.on("log:write", async (event) => {
-        await durably.storage.createLog({
+      durably.on("log:write", (event) => {
+        void durably.storage.createLog({
           runId: event.runId,
           stepName: event.stepName,
           level: event.level,
@@ -19,4 +19,4 @@ function withLogPersistence() {
 export {
   withLogPersistence
 };
-//# sourceMappingURL=chunk-UCUP6NMJ.js.map
+//# sourceMappingURL=chunk-L42OCQEV.js.map

package/dist/chunk-L42OCQEV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/log-persistence.ts"],"sourcesContent":["import type { DurablyPlugin } from '../durably'\n\n/**\n * Plugin that persists log events to the database.\n * Uses fire-and-forget writes — log persistence is best-effort.\n */\nexport function withLogPersistence(): DurablyPlugin {\n  return {\n    name: 'log-persistence',\n    install(durably) {\n      durably.on('log:write', (event) => {\n        void durably.storage.createLog({\n          runId: event.runId,\n          stepName: event.stepName,\n          level: event.level,\n          message: event.message,\n          data: event.data,\n        })\n      })\n    },\n  }\n}\n"],"mappings":";AAMO,SAAS,qBAAoC;AAClD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,SAAS;AACf,cAAQ,GAAG,aAAa,CAAC,UAAU;AACjC,aAAK,QAAQ,QAAQ,UAAU;AAAA,UAC7B,OAAO,MAAM;AAAA,UACb,UAAU,MAAM;AAAA,UAChB,OAAO,MAAM;AAAA,UACb,SAAS,MAAM;AAAA,UACf,MAAM,MAAM;AAAA,QACd,CAAC;AAAA,MACH,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/{index-DWsJlgyh.d.ts → index-CDCdrLgw.d.ts}

@@ -216,6 +216,7 @@ interface RunsTable {
     idempotency_key: string | null;
     concurrency_key: string | null;
     current_step_index: number;
+    completed_step_count: number;
     progress: string | null;
     output: string | null;
     error: string | null;
@@ -287,7 +288,7 @@ interface Run<TLabels extends Record<string, string> = Record<string, string>> {
     idempotencyKey: string | null;
     concurrencyKey: string | null;
     currentStepIndex: number;
-    stepCount: number;
+    completedStepCount: number;
     progress: {
         current: number;
         total?: number;
@@ -808,7 +809,8 @@ declare function createDurably<TLabels extends Record<string, string> = Record<s
 declare function createDurably<TLabels extends Record<string, string> = Record<string, string>>(options: DurablyOptions<TLabels>): Durably<Record<string, never>, TLabels>;
 
 /**
- * Plugin that persists log events to the database
+ * Plugin that persists log events to the database.
+ * Uses fire-and-forget writes — log persistence is best-effort.
  */
 declare function withLogPersistence(): DurablyPlugin;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as Run, a as RunFilter, D as Durably } from './index-DWsJlgyh.js';
-export { B as BatchTriggerInput, C as ClientRun, b as Database, c as DurablyEvent, d as DurablyOptions, e as DurablyPlugin, E as ErrorHandler, f as EventType, J as JobDefinition, g as JobHandle, h as JobInput, i as JobOutput, L as Log, j as LogData, k as LogWriteEvent, l as LogsTable, P as ProgressData, m as RunCancelEvent, n as RunCompleteEvent, o as RunDeleteEvent, p as RunFailEvent, q as RunLeaseRenewedEvent, r as RunLeasedEvent, s as RunProgressEvent, t as RunStatus, u as RunTriggerEvent, v as RunsTable, S as SchemaVersionsTable, w as Step, x as StepCancelEvent, y as StepCompleteEvent, z as StepContext, A as StepFailEvent, F as StepStartEvent, G as StepsTable, H as Store, T as TriggerAndWaitOptions, I as TriggerAndWaitResult, K as TriggerOptions, U as UpdateRunData, W as WorkerErrorEvent, M as createDurably, N as createKyselyStore, O as defineJob, Q as toClientRun, V as withLogPersistence } from './index-DWsJlgyh.js';
+import { R as Run, a as RunFilter, D as Durably } from './index-CDCdrLgw.js';
+export { B as BatchTriggerInput, C as ClientRun, b as Database, c as DurablyEvent, d as DurablyOptions, e as DurablyPlugin, E as ErrorHandler, f as EventType, J as JobDefinition, g as JobHandle, h as JobInput, i as JobOutput, L as Log, j as LogData, k as LogWriteEvent, l as LogsTable, P as ProgressData, m as RunCancelEvent, n as RunCompleteEvent, o as RunDeleteEvent, p as RunFailEvent, q as RunLeaseRenewedEvent, r as RunLeasedEvent, s as RunProgressEvent, t as RunStatus, u as RunTriggerEvent, v as RunsTable, S as SchemaVersionsTable, w as Step, x as StepCancelEvent, y as StepCompleteEvent, z as StepContext, A as StepFailEvent, F as StepStartEvent, G as StepsTable, H as Store, T as TriggerAndWaitOptions, I as TriggerAndWaitResult, K as TriggerOptions, U as UpdateRunData, W as WorkerErrorEvent, M as createDurably, N as createKyselyStore, O as defineJob, Q as toClientRun, V as withLogPersistence } from './index-CDCdrLgw.js';
 import 'kysely';
 import 'zod';
 
@@ -17,6 +17,26 @@ declare class CancelledError extends Error {
 declare class LeaseLostError extends Error {
     constructor(runId: string);
 }
+/**
+ * Base class for errors that map to specific HTTP status codes.
+ * Used by the HTTP handler to return appropriate responses.
+ */
+declare class DurablyError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+/** 404 — Resource not found */
+declare class NotFoundError extends DurablyError {
+    constructor(message: string);
+}
+/** 400 — Invalid input or request */
+declare class ValidationError extends DurablyError {
+    constructor(message: string);
+}
+/** 409 — Operation conflicts with current state */
+declare class ConflictError extends DurablyError {
+    constructor(message: string);
+}
 
 /**
  * Run operation types for onRunAccess
@@ -107,4 +127,4 @@ interface CreateDurablyHandlerOptions<TContext = undefined, TLabels extends Reco
  */
 declare function createDurablyHandler<TContext = undefined, TLabels extends Record<string, string> = Record<string, string>>(durably: Durably<any, TLabels>, options?: CreateDurablyHandlerOptions<TContext, TLabels>): DurablyHandler;
 
-export { type AuthConfig, CancelledError, type CreateDurablyHandlerOptions, Durably, type DurablyHandler, LeaseLostError, Run, RunFilter, type RunOperation, type RunsSubscribeFilter, type TriggerRequest, type TriggerResponse, createDurablyHandler };
+export { type AuthConfig, CancelledError, ConflictError, type CreateDurablyHandlerOptions, Durably, DurablyError, type DurablyHandler, LeaseLostError, NotFoundError, Run, RunFilter, type RunOperation, type RunsSubscribeFilter, type TriggerRequest, type TriggerResponse, ValidationError, createDurablyHandler };