@strav/durable 0.4.31 → 1.0.0-alpha.9

package/src/providers/durable_provider.ts

@@ -1,31 +0,0 @@
-import { ServiceProvider } from '@strav/kernel'
-import type { Application } from '@strav/kernel'
-import { Durable } from '../durable.ts'
-
-export interface DurableProviderOptions {
-  /** Whether to auto-create the durable engine tables. Default: `true`. */
-  ensureTables?: boolean
-}
-
-/**
- * Registers the durable execution engine.
- *
- * On boot it creates the engine tables and registers the `durable:advance` /
- * `durable:compensate` queue handlers. Run a `@strav/queue` `Worker` on the
- * durable queue (default name `'durable'`) to actually process runs.
- */
-export default class DurableProvider extends ServiceProvider {
-  readonly name = 'durable'
-  override readonly dependencies = ['database', 'queue']
-
-  constructor(private readonly options?: DurableProviderOptions) {
-    super()
-  }
-
-  override async boot(_app: Application): Promise<void> {
-    if (this.options?.ensureTables !== false) {
-      await Durable.ensureTables()
-    }
-    Durable.registerHandlers()
-  }
-}

package/src/providers/index.ts

@@ -1,2 +0,0 @@
-export { default as DurableProvider } from './durable_provider.ts'
-export type { DurableProviderOptions } from './durable_provider.ts'

package/src/registry.ts

@@ -1,35 +0,0 @@
-import type { DurableWorkflow } from './builder.ts'
-import { WorkflowNotRegisteredError } from './errors.ts'
-
-/**
- * Process-wide registry of durable workflow definitions.
- *
- * A `durable:advance` queue job carries only a workflow *name* (not a
- * closure), so the worker process must be able to look the definition up
- * by name. Importing the module that calls `durable(...)` registers it.
- */
-const workflows = new Map<string, DurableWorkflow>()
-
-export const registry = {
-  /** Register (or replace) a workflow definition by name. */
-  register(workflow: DurableWorkflow): void {
-    workflows.set(workflow.name, workflow)
-  },
-
-  /** Look up a workflow definition, throwing if it is not registered. */
-  get(name: string): DurableWorkflow {
-    const wf = workflows.get(name)
-    if (!wf) throw new WorkflowNotRegisteredError(name)
-    return wf
-  },
-
-  /** Whether a workflow name is registered. */
-  has(name: string): boolean {
-    return workflows.has(name)
-  },
-
-  /** Clear all registrations. For testing only. */
-  reset(): void {
-    workflows.clear()
-  },
-}

package/src/schema.ts

@@ -1,70 +0,0 @@
-import { sql } from '@strav/database'
-
-/**
- * Create the durable engine's two tables if they do not exist.
- *
- * Follows the `@strav/queue` precedent — inline, idempotent DDL rather than
- * a migration file (apps own their migrations directory). Safe to call on
- * every boot. Post-1.0 schema changes must be additive
- * (`ALTER TABLE ... ADD COLUMN IF NOT EXISTS`).
- *
- * - `_strav_workflow_runs`    — the durable record of a run; the pollable row.
- * - `_strav_workflow_journal` — the per-step checkpoint log;
- *   `UNIQUE (run_id, step_id)` is what makes redelivery idempotent.
- */
-export async function ensureTables(): Promise<void> {
-  await sql`
-    CREATE TABLE IF NOT EXISTS "_strav_workflow_runs" (
-      "id"                  BIGSERIAL PRIMARY KEY,
-      "workflow_name"       VARCHAR(255) NOT NULL,
-      "input"               JSONB NOT NULL DEFAULT '{}',
-      "status"              VARCHAR(32)  NOT NULL DEFAULT 'pending',
-      "state"               JSONB NOT NULL DEFAULT '{}',
-      "current_step"        INT  NOT NULL DEFAULT 0,
-      "compensation_cursor" INT,
-      "parent_run_id"       BIGINT REFERENCES "_strav_workflow_runs"("id") ON DELETE CASCADE,
-      "parent_step_id"      VARCHAR(512),
-      "awaiting_signal"     VARCHAR(255),
-      "wake_at"             TIMESTAMPTZ,
-      "error"               TEXT,
-      "result"              JSONB,
-      "created_at"          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-      "updated_at"          TIMESTAMPTZ NOT NULL DEFAULT NOW()
-    )
-  `
-
-  await sql`
-    CREATE INDEX IF NOT EXISTS "idx_strav_wf_runs_status"
-      ON "_strav_workflow_runs" ("status")
-  `
-
-  await sql`
-    CREATE INDEX IF NOT EXISTS "idx_strav_wf_runs_parent"
-      ON "_strav_workflow_runs" ("parent_run_id")
-  `
-
-  await sql`
-    CREATE TABLE IF NOT EXISTS "_strav_workflow_journal" (
-      "id"           BIGSERIAL PRIMARY KEY,
-      "run_id"       BIGINT NOT NULL REFERENCES "_strav_workflow_runs"("id") ON DELETE CASCADE,
-      "step_id"      VARCHAR(512) NOT NULL,
-      "status"       VARCHAR(16)  NOT NULL DEFAULT 'completed',
-      "result"       JSONB,
-      "error"        TEXT,
-      "attempt"      INT NOT NULL DEFAULT 1,
-      "completed_at" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-      UNIQUE ("run_id", "step_id")
-    )
-  `
-
-  await sql`
-    CREATE INDEX IF NOT EXISTS "idx_strav_wf_journal_run"
-      ON "_strav_workflow_journal" ("run_id")
-  `
-}
-
-/** Drop the durable engine's tables. For testing only. */
-export async function dropTables(): Promise<void> {
-  await sql`DROP TABLE IF EXISTS "_strav_workflow_journal"`
-  await sql`DROP TABLE IF EXISTS "_strav_workflow_runs"`
-}

package/src/util.ts

@@ -1,25 +0,0 @@
-/**
- * Parse a JSONB column value. Bun's SQL driver may return a JSONB column as
- * either an already-parsed object or a raw string depending on context — this
- * normalizes both. `null`/`undefined` pass through unchanged.
- */
-export function parseJson<T = unknown>(value: unknown): T {
-  if (value == null) return value as T
-  if (typeof value === 'string') {
-    try {
-      return JSON.parse(value) as T
-    } catch {
-      return value as T
-    }
-  }
-  return value as T
-}
-
-/** Compute the retry backoff delay (ms) for a given attempt number. */
-export function backoffDelay(
-  attempt: number,
-  strategy: 'exponential' | 'linear'
-): number {
-  if (strategy === 'linear') return attempt * 5_000
-  return Math.pow(2, attempt) * 1_000 + Math.random() * 1_000
-}

package/tsconfig.json

@@ -1,5 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "tests"]
-}