pg-workflows 0.14.0 → 0.15.0

package/dist/shared/{chunk-w3qcrrwx.js → chunk-n0f7hd40.js}

@@ -50,6 +50,13 @@ class WorkflowRunNotFoundError extends WorkflowEngineError {
   }
 }
 
+class WorkflowRunInProgressError extends WorkflowEngineError {
+  constructor(workflowId, runId) {
+    super(`Workflow "${workflowId}" already has a running run; wait for it to pause, complete, fail, or be cancelled`, workflowId, runId);
+    this.name = "WorkflowRunInProgressError";
+  }
+}
+
 // src/types.ts
 var WorkflowStatus;
 ((WorkflowStatus2) => {
@@ -79,7 +86,7 @@ import { PgBoss } from "pg-boss";
 
 // src/db/migration.ts
 var MIGRATION_LOCK_ID = 738291645;
-var CURRENT_SCHEMA_VERSION = 6;
+var CURRENT_SCHEMA_VERSION = 7;
 async function runMigrations(db) {
   if (await isSchemaUpToDate(db)) {
     return;
@@ -158,6 +165,14 @@ async function runMigrations(db) {
   if (currentVersion < 6) {
     commands.push("ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS priority integer DEFAULT 0 NOT NULL");
   }
+  if (currentVersion < 7) {
+    commands.push("ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS singleton boolean DEFAULT false NOT NULL");
+    commands.push(`
+      CREATE UNIQUE INDEX IF NOT EXISTS workflow_runs_singleton_active_idx
+        ON workflow_runs (workflow_id)
+        WHERE singleton AND status IN ('pending', 'running')
+    `);
+  }
   if (currentVersion === 0) {
     commands.push(`INSERT INTO workflow_schema_version (version) VALUES (${CURRENT_SCHEMA_VERSION})`);
   } else {
@@ -200,6 +215,16 @@ import ksuid from "ksuid";
 function generateKSUID(prefix) {
   return `${prefix ? `${prefix}_` : ""}${ksuid.randomSync().string}`;
 }
+function isUniqueViolation(error) {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  if ("code" in error && error.code === "23505") {
+    return true;
+  }
+  const cause = "cause" in error ? error.cause : undefined;
+  return Boolean(cause && typeof cause === "object" && "code" in cause && cause.code === "23505");
+}
 function mapRowToWorkflowRun(row) {
   return {
     id: row.id,
@@ -225,7 +250,8 @@ function mapRowToWorkflowRun(row) {
     parentRunId: row.parent_run_id,
     parentStepId: row.parent_step_id,
     parentResourceId: row.parent_resource_id,
-    scheduledAt: row.scheduled_at ? new Date(row.scheduled_at) : null
+    scheduledAt: row.scheduled_at ? new Date(row.scheduled_at) : null,
+    singleton: Boolean(row.singleton)
   };
 }
 async function insertWorkflowRun({
@@ -241,11 +267,20 @@ async function insertWorkflowRun({
   parentRunId,
   parentStepId,
   parentResourceId,
-  scheduledAt
+  scheduledAt,
+  singleton = false
 }, db) {
   const runId = generateKSUID("run");
   const now = new Date;
-  const result = await db.executeSql(`INSERT INTO workflow_runs (
+  if (singleton) {
+    const active = await getActiveSingletonRun(workflowId, db);
+    if (active) {
+      throw new WorkflowRunInProgressError(workflowId, active.id);
+    }
+  }
+  let result;
+  try {
+    result = await db.executeSql(`INSERT INTO workflow_runs (
       id,
       resource_id,
       workflow_id,
@@ -263,30 +298,39 @@ async function insertWorkflowRun({
       parent_run_id,
       parent_step_id,
       parent_resource_id,
-      scheduled_at
+      scheduled_at,
+      singleton
     )
-    VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18)
+    VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19)
     ON CONFLICT (idempotency_key) WHERE idempotency_key IS NOT NULL DO NOTHING
     RETURNING *`, [
-    runId,
-    resourceId ?? null,
-    workflowId,
-    currentStepId,
-    status,
-    JSON.stringify(input),
-    maxRetries,
-    priority,
-    timeoutAt,
-    now,
-    now,
-    "{}",
-    0,
-    idempotencyKey ?? null,
-    parentRunId ?? null,
-    parentStepId ?? null,
-    parentResourceId ?? null,
-    scheduledAt ?? null
-  ]);
+      runId,
+      resourceId ?? null,
+      workflowId,
+      currentStepId,
+      status,
+      JSON.stringify(input),
+      maxRetries,
+      priority,
+      timeoutAt,
+      now,
+      now,
+      "{}",
+      0,
+      idempotencyKey ?? null,
+      parentRunId ?? null,
+      parentStepId ?? null,
+      parentResourceId ?? null,
+      scheduledAt ?? null,
+      singleton
+    ]);
+  } catch (error) {
+    if (singleton && isUniqueViolation(error)) {
+      const active = await getActiveSingletonRun(workflowId, db);
+      throw new WorkflowRunInProgressError(workflowId, active?.id);
+    }
+    throw error;
+  }
   if (result.rows[0]) {
     return { run: mapRowToWorkflowRun(result.rows[0]), created: true };
   }
@@ -298,6 +342,20 @@ async function insertWorkflowRun({
   }
   return { run: mapRowToWorkflowRun(existing.rows[0]), created: false };
 }
+async function getActiveSingletonRun(workflowId, db) {
+  const result = await db.executeSql(`SELECT * FROM workflow_runs
+     WHERE workflow_id = $1
+       AND singleton
+       AND status IN ('pending', 'running')
+     LIMIT 1`, [workflowId]);
+  return result.rows[0] ? mapRowToWorkflowRun(result.rows[0]) : null;
+}
+async function assertSingletonSlotAvailable({ workflowId, exceptRunId }, db) {
+  const active = await getActiveSingletonRun(workflowId, db);
+  if (active && active.id !== exceptRunId) {
+    throw new WorkflowRunInProgressError(workflowId, active.id);
+  }
+}
 async function getWorkflowRun({
   runId,
   resourceId
@@ -412,7 +470,15 @@ async function updateWorkflowRun({
     ${whereClause}
     RETURNING *
   `;
-  const result = await db.executeSql(query, values);
+  let result;
+  try {
+    result = await db.executeSql(query, values);
+  } catch (error) {
+    if (data.status === "running" && isUniqueViolation(error)) {
+      throw new WorkflowRunInProgressError("unknown", runId);
+    }
+    throw error;
+  }
   const run = result.rows[0];
   if (!run) {
     return null;
@@ -570,11 +636,10 @@ class WorkflowClient {
     const db = {
       executeSql: (text, values) => this.pool.query(text, values)
     };
-    if (boss) {
-      this.boss = boss;
-    } else {
-      this.boss = new PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
-    }
+    this.boss = boss ?? new PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
+    this.boss.on("error", (error) => {
+      this.logger.error("pg-boss error", error);
+    });
     this.db = db;
   }
   async start() {
@@ -603,6 +668,7 @@ class WorkflowClient {
     let resourceId;
     let idempotencyKey;
     let options;
+    let singleton = false;
     if (typeof refOrParams === "function" && "id" in refOrParams) {
       const ref = refOrParams;
       workflowId = ref.id;
@@ -610,6 +676,7 @@ class WorkflowClient {
       options = optionsArg;
       resourceId = optionsArg?.resourceId;
       idempotencyKey = optionsArg?.idempotencyKey;
+      singleton = optionsArg?.singleton ?? ref.singleton === true;
       if (ref.inputSchema) {
         const result = await ref.inputSchema["~standard"].validate(input);
         if (result.issues) {
@@ -623,6 +690,7 @@ class WorkflowClient {
       resourceId = params.resourceId;
       idempotencyKey = params.idempotencyKey;
       options = params.options;
+      singleton = params.options?.singleton === true;
     }
     validateWorkflowId(workflowId);
     validateResourceId(resourceId);
@@ -637,7 +705,8 @@ class WorkflowClient {
         maxRetries: options?.retries ?? 0,
         priority: resolvePriority(options?.priority),
         timeoutAt,
-        idempotencyKey
+        idempotencyKey,
+        singleton
       }, _db);
       if (created) {
         const job = {
@@ -667,6 +736,9 @@ class WorkflowClient {
   }) {
     await this.ensureStarted();
     const run = await this.getRun({ runId, resourceId });
+    if (run.singleton) {
+      await assertSingletonSlotAvailable({ workflowId: run.workflowId, exceptRunId: run.id }, this.db);
+    }
     const job = {
       runId: run.id,
       resourceId: resourceId ?? run.resourceId ?? undefined,
@@ -860,6 +932,7 @@ function createWorkflowRef(id, options) {
     timeout: defineOptions?.timeout,
     retries: defineOptions?.retries,
     priority: defineOptions?.priority,
+    singleton: defineOptions?.singleton ?? options?.singleton,
     schedule: defineOptions?.schedule,
     timezone: defineOptions?.timezone
   });
@@ -868,16 +941,29 @@ function createWorkflowRef(id, options) {
     value: options?.inputSchema,
     enumerable: true
   });
+  Object.defineProperty(ref, "singleton", {
+    value: options?.singleton,
+    enumerable: true
+  });
   return ref;
 }
 function createWorkflowFactory(plugins = []) {
-  const factory = (id, handler, { inputSchema, timeout, retries, priority, schedule, timezone } = {}) => ({
+  const factory = (id, handler, {
+    inputSchema,
+    timeout,
+    retries,
+    priority,
+    singleton,
+    schedule,
+    timezone
+  } = {}) => ({
     id,
     handler,
     inputSchema,
     timeout,
     retries,
     priority,
+    singleton,
     schedule,
     timezone,
     plugins: plugins.length > 0 ? plugins : undefined
@@ -891,7 +977,7 @@ function createWorkflowFactory(plugins = []) {
 }
 var workflow = createWorkflowFactory();
 
-export { PAUSE_EVENT_NAME, WORKFLOW_RUN_QUEUE_NAME, WORKFLOW_RUN_DLQ_QUEUE_NAME, scheduleQueueNameFor, DEFAULT_PGBOSS_SCHEMA, invokeChildWorkflowTimelineKey, waitForTimelineKey, isInvokeChildWorkflowTimelineEntry, runMigrations, insertWorkflowRun, getWorkflowRun, getWorkflowLastRun, updateWorkflowRun, getWorkflowRuns, withPostgresTransaction, validateWorkflowId, validateResourceId, WorkflowEngineError, WorkflowRunNotFoundError, resolvePriority, WorkflowStatus, STEP_BASE_METHOD_TYPES, WorkflowClient, createWorkflowRef, workflow };
+export { PAUSE_EVENT_NAME, WORKFLOW_RUN_QUEUE_NAME, WORKFLOW_RUN_DLQ_QUEUE_NAME, scheduleQueueNameFor, DEFAULT_PGBOSS_SCHEMA, invokeChildWorkflowTimelineKey, waitForTimelineKey, isInvokeChildWorkflowTimelineEntry, runMigrations, validateWorkflowId, validateResourceId, WorkflowEngineError, WorkflowRunNotFoundError, WorkflowRunInProgressError, insertWorkflowRun, assertSingletonSlotAvailable, getWorkflowRun, getWorkflowLastRun, updateWorkflowRun, getWorkflowRuns, withPostgresTransaction, resolvePriority, WorkflowStatus, STEP_BASE_METHOD_TYPES, WorkflowClient, createWorkflowRef, workflow };
 
-//# debugId=DC21344869C0BC9E64756E2164756E21
-//# sourceMappingURL=chunk-w3qcrrwx.js.map
+//# debugId=779362C94AF314E764756E2164756E21
+//# sourceMappingURL=chunk-n0f7hd40.js.map

package/dist/shared/chunk-n0f7hd40.js.map

@@ -0,0 +1,17 @@
+{
+  "version": 3,
+  "sources": ["src/constants.ts", "src/error.ts", "src/types.ts", "src/client.ts", "src/db/migration.ts", "src/db/queries.ts", "src/priority.ts", "src/definition.ts"],
+  "sourcesContent": [
+    "export const PAUSE_EVENT_NAME = '__internal_pause';\nexport const WORKFLOW_RUN_QUEUE_NAME = 'workflow-run';\nexport const WORKFLOW_RUN_DLQ_QUEUE_NAME = 'workflow_run_dlq';\n// pg-boss queue names allow only alphanumeric, _, -, ., or / — keep the\n// prefix in that character set so any valid workflow id stays addressable.\nconst SCHEDULE_QUEUE_PREFIX = '__pgw_schedule_';\nexport const scheduleQueueNameFor = (workflowId: string): string =>\n  `${SCHEDULE_QUEUE_PREFIX}${workflowId}`;\nexport const DEFAULT_PGBOSS_SCHEMA = 'pgboss_v12_pgworkflow';\nexport const MAX_WORKFLOW_ID_LENGTH = 256;\nexport const MAX_RESOURCE_ID_LENGTH = 256;\n\n// Per-step timeline key suffixes. The shared helpers below are the single\n// source of truth for engine + client so timeline-shape changes only need to\n// happen in one place.\nexport const INVOKE_CHILD_WORKFLOW_TIMELINE_SUFFIX = 'invoke-child-workflow';\nexport const WAIT_FOR_TIMELINE_SUFFIX = 'wait-for';\nexport const invokeChildWorkflowTimelineKey = (stepId: string) =>\n  `${stepId}-${INVOKE_CHILD_WORKFLOW_TIMELINE_SUFFIX}`;\nexport const waitForTimelineKey = (stepId: string) => `${stepId}-${WAIT_FOR_TIMELINE_SUFFIX}`;\n\n/**\n * Type guard for `${stepId}-invoke-child-workflow` timeline entries. Used by the\n * engine to dispatch invoke-aware behavior and by the client's resume /\n * fast-forward no-op guards. Centralizing this keeps the timeline shape\n * contract in one place.\n */\nexport const isInvokeChildWorkflowTimelineEntry = (\n  entry: unknown,\n): entry is { invokeChildWorkflow: { childRunId: string; childWorkflowId: string } } =>\n  !!entry && typeof entry === 'object' && 'invokeChildWorkflow' in entry;\n",
+    "import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { MAX_RESOURCE_ID_LENGTH, MAX_WORKFLOW_ID_LENGTH } from './constants';\n\nexport function validateWorkflowId(workflowId: string): void {\n  if (workflowId.length > MAX_WORKFLOW_ID_LENGTH) {\n    throw new WorkflowEngineError(\n      `workflowId exceeds maximum length of ${MAX_WORKFLOW_ID_LENGTH} characters (got ${workflowId.length})`,\n      workflowId,\n    );\n  }\n}\n\nexport function validateResourceId(resourceId: string | undefined | null): void {\n  if (resourceId != null && resourceId.length > MAX_RESOURCE_ID_LENGTH) {\n    throw new WorkflowEngineError(\n      `resourceId exceeds maximum length of ${MAX_RESOURCE_ID_LENGTH} characters (got ${resourceId.length})`,\n    );\n  }\n}\n\nexport class WorkflowEngineError extends Error {\n  constructor(\n    message: string,\n    public readonly workflowId?: string,\n    public readonly runId?: string,\n    public override readonly cause: Error | undefined = undefined,\n    public readonly issues?: StandardSchemaV1.FailureResult['issues'] | undefined,\n  ) {\n    super(message);\n    this.name = 'WorkflowEngineError';\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, WorkflowEngineError);\n    }\n  }\n}\n\nexport class WorkflowRunNotFoundError extends WorkflowEngineError {\n  constructor(runId?: string, workflowId?: string) {\n    super('Workflow run not found', workflowId, runId);\n    this.name = 'WorkflowRunNotFoundError';\n  }\n}\n\nexport class WorkflowRunInProgressError extends WorkflowEngineError {\n  constructor(workflowId: string, runId?: string) {\n    super(\n      `Workflow \"${workflowId}\" already has a running run; wait for it to pause, complete, fail, or be cancelled`,\n      workflowId,\n      runId,\n    );\n    this.name = 'WorkflowRunInProgressError';\n  }\n}\n",
+    "import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { WorkflowRun } from './db/types';\nimport type { Duration } from './duration';\nimport type { WorkflowPriority } from './priority';\nimport type { Schedule } from './schedule';\n\nexport enum WorkflowStatus {\n  PENDING = 'pending',\n  RUNNING = 'running',\n  PAUSED = 'paused',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  CANCELLED = 'cancelled',\n}\n\nexport enum StepType {\n  PAUSE = 'pause',\n  RUN = 'run',\n  WAIT_FOR = 'waitFor',\n  WAIT_UNTIL = 'waitUntil',\n  DELAY = 'delay',\n  POLL = 'poll',\n  INVOKE_CHILD_WORKFLOW = 'invokeChildWorkflow',\n}\n\nexport type InputParameters = StandardSchemaV1;\nexport type InferInputParameters<P extends InputParameters> = StandardSchemaV1.InferOutput<P>;\n\nexport type StartWorkflowOptions = {\n  resourceId?: string;\n  timeout?: number;\n  retries?: number;\n  expireInSeconds?: number;\n  idempotencyKey?: string;\n  priority?: WorkflowPriority;\n  /**\n   * Client-side counterpart of `workflow(..., { singleton: true })`.\n   * The engine reads this from the registered definition; pass it here when\n   * starting from `WorkflowClient` so the uniqueness constraint applies.\n   */\n  singleton?: boolean;\n};\n\nexport type WorkflowOptions<I extends InputParameters> = {\n  timeout?: number;\n  retries?: number;\n  inputSchema?: I;\n  priority?: WorkflowPriority;\n  /**\n   * When true, at most one pending or running run of this workflow ID may exist.\n   * A second `startWorkflow` throws `WorkflowRunInProgressError` until the\n   * current run pauses, completes, fails, or is cancelled.\n   */\n  singleton?: boolean;\n  /**\n   * Recurring schedule. Accepts a cron expression (`'0 9 * * 1-5'`),\n   * a duration string (`'5m'`, `'1 hour'`), or a `DurationObject`.\n   */\n  schedule?: Schedule;\n  /** IANA timezone for cron expressions. Defaults to UTC. Ignored for duration-based schedules. */\n  timezone?: string;\n};\n\n/** Metadata about a scheduled fire, exposed on `ctx.schedule` for runs triggered by a schedule. */\nexport type ScheduleContext = {\n  /** Time the schedule fired this run. */\n  timestamp: Date;\n};\n\nexport type StepBaseContext = {\n  run: <T>(stepId: string, handler: () => Promise<T>) => Promise<T>;\n  waitFor: {\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; schema?: T },\n    ): Promise<InferInputParameters<T>>;\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; timeout: number; schema?: T },\n    ): Promise<InferInputParameters<T> | undefined>;\n  };\n  waitUntil: {\n    (stepId: string, date: Date): Promise<void>;\n    (stepId: string, dateString: string): Promise<void>;\n    (stepId: string, options: { date: Date | string }): Promise<void>;\n  };\n  /** Delay execution for a duration (sugar over waitUntil). Alias: sleep. */\n  delay: (stepId: string, duration: Duration) => Promise<void>;\n  /** Alias for delay. */\n  sleep: (stepId: string, duration: Duration) => Promise<void>;\n  pause: (stepId: string) => Promise<void>;\n  poll: <T>(\n    stepId: string,\n    conditionFn: () => Promise<T | false>,\n    options?: { interval?: Duration; timeout?: Duration },\n  ) => Promise<{ timedOut: false; data: T } | { timedOut: true }>;\n  /**\n   * Invoke a child workflow from inside the current workflow and pause until\n   * the child run reaches a terminal state.\n   */\n  invokeChildWorkflow: {\n    <TInput extends InputParameters, TOutput = unknown>(\n      stepId: string,\n      ref: WorkflowRef<TInput, TOutput>,\n      input: InferInputParameters<TInput>,\n      options?: StartWorkflowOptions,\n    ): Promise<TOutput>;\n    <TOutput = unknown>(\n      stepId: string,\n      params: {\n        workflowId: string;\n        input: unknown;\n        resourceId?: string;\n        idempotencyKey?: string;\n        options?: StartWorkflowOptions;\n      },\n    ): Promise<TOutput>;\n  };\n};\n\n/**\n * Plugin that extends the workflow step API with extra methods.\n * @template TStepBase - The step type this plugin receives (base + previous plugins).\n * @template TStepExt - The extra methods this plugin adds to step.\n */\nexport interface WorkflowPlugin<TStepBase = StepBaseContext, TStepExt = object> {\n  name: string;\n  methods: (step: TStepBase, context: WorkflowContext) => TStepExt;\n  /**\n   * Optional middleware around the workflow handler call. Composes in\n   * registration order — the first plugin passed to `.use()` wraps everything\n   * inside. Implementations MUST call `next()` exactly once.\n   */\n  wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;\n}\n\nexport type WorkflowContext<\n  TInput extends InputParameters = InputParameters,\n  TStep extends StepBaseContext = StepBaseContext,\n> = {\n  input: InferInputParameters<TInput>;\n  step: TStep;\n  workflowId: string;\n  runId: string;\n  /** Tenant/scope identifier set when the run was started, if any. */\n  resourceId?: string;\n  /** Zero-based retry attempt number (= `run.retryCount`). */\n  attempt: number;\n  timeline: Record<string, unknown>;\n  logger: WorkflowLogger;\n  /** Set only for runs triggered by a recurring schedule. */\n  schedule?: ScheduleContext;\n};\n\nexport type WorkflowDefinition<TInput extends InputParameters = InputParameters> = {\n  id: string;\n  /** Widest context avoids contravariance when collecting definitions; `workflow()` still types the handler narrowly. */\n  handler: (context: WorkflowContext<InputParameters, StepBaseContext>) => Promise<unknown>;\n  inputSchema?: TInput;\n  timeout?: number; // milliseconds\n  retries?: number;\n  priority?: WorkflowPriority;\n  singleton?: boolean;\n  schedule?: Schedule;\n  timezone?: string;\n  plugins?: WorkflowPlugin[];\n};\n\nexport type StepInternalDefinition = {\n  id: string;\n  type: StepType;\n  conditional: boolean;\n  loop: boolean;\n  isDynamic: boolean;\n};\n\nexport type WorkflowInternalDefinition<TInput extends InputParameters = InputParameters> =\n  WorkflowDefinition<TInput> & {\n    steps: StepInternalDefinition[];\n  };\n\n/**\n * Chainable workflow factory: call as (id, handler, options) and/or use .use(plugin).\n * TStepExt is the accumulated step extension from all plugins (step = StepContext & TStepExt).\n */\nexport interface WorkflowFactory<TStepExt = object> {\n  <I extends InputParameters = InputParameters>(\n    id: string,\n    handler: (context: WorkflowContext<I, StepBaseContext & TStepExt>) => Promise<unknown>,\n    options?: WorkflowOptions<I>,\n  ): WorkflowDefinition<I>;\n  use<TNewExt>(\n    plugin: WorkflowPlugin<StepBaseContext & TStepExt, TNewExt>,\n  ): WorkflowFactory<TStepExt & TNewExt>;\n  ref<TInput extends InputParameters = InputParameters, TOutput = unknown>(\n    id: string,\n    options?: { inputSchema?: TInput; singleton?: boolean },\n  ): WorkflowRef<TInput, TOutput>;\n}\n\n/**\n * Lightweight workflow reference - carries the workflow ID and input type\n * but no handler code. Safe to import in API services without pulling in\n * heavy worker dependencies.\n *\n * Callable: pass a handler to create a full WorkflowDefinition.\n */\nexport interface WorkflowRef<\n  TInput extends InputParameters = InputParameters,\n  // biome-ignore lint/correctness/noUnusedVariables: phantom type carried for typed return inference\n  TOutput = unknown,\n> {\n  (\n    handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>,\n    options?: Omit<WorkflowOptions<TInput>, 'inputSchema'>,\n  ): WorkflowDefinition<TInput>;\n  readonly id: string;\n  readonly inputSchema?: TInput;\n  readonly singleton?: boolean;\n}\n\nexport type WorkflowRunProgress = WorkflowRun & {\n  completionPercentage: number;\n  totalSteps: number;\n  completedSteps: number;\n};\n\nexport interface WorkflowLogger {\n  log(message: string): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport type WorkflowInternalLoggerContext = {\n  runId?: string;\n  workflowId?: string;\n};\n\nexport interface WorkflowInternalLogger {\n  log(message: string, context?: WorkflowInternalLoggerContext): void;\n  error(message: string, error: Error, context?: WorkflowInternalLoggerContext): void;\n}\n\nconst _STEP_BASE_METHOD_TO_TYPE: Record<keyof StepBaseContext, StepType> = {\n  run: StepType.RUN,\n  waitFor: StepType.WAIT_FOR,\n  waitUntil: StepType.WAIT_UNTIL,\n  delay: StepType.DELAY,\n  sleep: StepType.DELAY,\n  pause: StepType.PAUSE,\n  poll: StepType.POLL,\n  invokeChildWorkflow: StepType.INVOKE_CHILD_WORKFLOW,\n};\n\nexport const STEP_BASE_METHOD_TYPES: ReadonlyMap<string, StepType> = new Map(\n  Object.entries(_STEP_BASE_METHOD_TO_TYPE),\n);\n",
+    "import { merge } from 'es-toolkit';\nimport pg from 'pg';\nimport { type Db, PgBoss } from 'pg-boss';\nimport {\n  DEFAULT_PGBOSS_SCHEMA,\n  invokeChildWorkflowTimelineKey,\n  isInvokeChildWorkflowTimelineEntry,\n  PAUSE_EVENT_NAME,\n  WORKFLOW_RUN_QUEUE_NAME,\n  waitForTimelineKey,\n} from './constants';\nimport { runMigrations } from './db/migration';\nimport {\n  assertSingletonSlotAvailable,\n  getWorkflowRun,\n  getWorkflowRuns,\n  insertWorkflowRun,\n  updateWorkflowRun,\n  withPostgresTransaction,\n} from './db/queries';\nimport type { WorkflowRun } from './db/types';\nimport {\n  validateResourceId,\n  validateWorkflowId,\n  WorkflowEngineError,\n  WorkflowRunNotFoundError,\n} from './error';\nimport { resolvePriority } from './priority';\nimport {\n  type InferInputParameters,\n  type InputParameters,\n  type StartWorkflowOptions,\n  type WorkflowLogger,\n  type WorkflowRef,\n  type WorkflowRunProgress,\n  WorkflowStatus,\n} from './types';\n\nconst LOG_PREFIX = '[WorkflowClient]';\n\ntype WorkflowRunJobParameters = {\n  runId: string;\n  resourceId?: string;\n  workflowId: string;\n  input: unknown;\n  event?: {\n    name: string;\n    data?: Record<string, unknown>;\n  };\n};\n\nexport type WorkflowClientOptions = {\n  logger?: WorkflowLogger;\n  /**\n   * Pre-configured pg-boss instance. Pass this when the engine side uses a\n   * non-default pg-boss config (schema, retention, logger, etc.) so the\n   * client enqueues jobs where the engine reads them. Mirrors the same\n   * option on `WorkflowEngineOptions`.\n   */\n  boss?: PgBoss;\n} & ({ pool: pg.Pool; connectionString?: never } | { connectionString: string; pool?: never });\n\nconst defaultLogger: WorkflowLogger = {\n  log: (_message: string) => console.warn(_message),\n  error: (message: string, error: Error) => console.error(message, error),\n};\n\nconst defaultExpireInSeconds = process.env.WORKFLOW_RUN_EXPIRE_IN_SECONDS\n  ? Number.parseInt(process.env.WORKFLOW_RUN_EXPIRE_IN_SECONDS, 10)\n  : 5 * 60;\n\nexport class WorkflowClient {\n  private boss: PgBoss;\n  private db: Db;\n  private pool: pg.Pool;\n  private _ownsPool = false;\n  private _started = false;\n  private logger: WorkflowLogger;\n\n  constructor({ logger, boss, ...connectionOptions }: WorkflowClientOptions) {\n    this.logger = logger ?? defaultLogger;\n\n    if ('pool' in connectionOptions && connectionOptions.pool) {\n      this.pool = connectionOptions.pool;\n    } else if ('connectionString' in connectionOptions && connectionOptions.connectionString) {\n      this.pool = new pg.Pool({ connectionString: connectionOptions.connectionString });\n      this._ownsPool = true;\n    } else {\n      throw new WorkflowEngineError('Either pool or connectionString must be provided');\n    }\n\n    const db: Db = {\n      executeSql: (text: string, values?: unknown[]) =>\n        this.pool.query(text, values) as Promise<{ rows: unknown[] }>,\n    };\n\n    this.boss = boss ?? new PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });\n    // 12.26+ surfaces fetch/work DB errors here; without a listener Node crashes.\n    this.boss.on('error', (error) => {\n      this.logger.error('pg-boss error', error);\n    });\n    this.db = db;\n  }\n\n  async start(): Promise<void> {\n    if (this._started) {\n      return;\n    }\n\n    await this.boss.start();\n    this.db = this.boss.getDb();\n    await runMigrations(this.db);\n    await this.boss.createQueue(WORKFLOW_RUN_QUEUE_NAME);\n\n    this._started = true;\n    this.logger.log(`${LOG_PREFIX} Client started`);\n  }\n\n  async stop(): Promise<void> {\n    await this.boss.stop();\n\n    if (this._ownsPool) {\n      await this.pool.end();\n    }\n\n    this._started = false;\n    this.logger.log(`${LOG_PREFIX} Client stopped`);\n  }\n\n  async startWorkflow<TInput extends InputParameters>(\n    ref: WorkflowRef<TInput>,\n    input: InferInputParameters<TInput>,\n    options?: StartWorkflowOptions,\n  ): Promise<WorkflowRun>;\n\n  async startWorkflow(params: {\n    workflowId: string;\n    input: unknown;\n    resourceId?: string;\n    idempotencyKey?: string;\n    options?: StartWorkflowOptions;\n  }): Promise<WorkflowRun>;\n\n  async startWorkflow<TInput extends InputParameters>(\n    refOrParams:\n      | WorkflowRef<TInput>\n      | {\n          workflowId: string;\n          input: unknown;\n          resourceId?: string;\n          idempotencyKey?: string;\n          options?: StartWorkflowOptions;\n        },\n    inputArg?: InferInputParameters<TInput>,\n    optionsArg?: StartWorkflowOptions,\n  ): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    let workflowId: string;\n    let input: unknown;\n    let resourceId: string | undefined;\n    let idempotencyKey: string | undefined;\n    let options: StartWorkflowOptions | undefined;\n    let singleton = false;\n\n    if (typeof refOrParams === 'function' && 'id' in refOrParams) {\n      const ref = refOrParams as WorkflowRef<TInput>;\n      workflowId = ref.id;\n      input = inputArg;\n      options = optionsArg;\n      resourceId = optionsArg?.resourceId;\n      idempotencyKey = optionsArg?.idempotencyKey;\n      singleton = optionsArg?.singleton ?? ref.singleton === true;\n\n      if (ref.inputSchema) {\n        const result = await ref.inputSchema['~standard'].validate(input);\n        if (result.issues) {\n          throw new WorkflowEngineError(\n            JSON.stringify(result.issues),\n            workflowId,\n            undefined,\n            undefined,\n            result.issues,\n          );\n        }\n      }\n    } else {\n      const params = refOrParams as {\n        workflowId: string;\n        input: unknown;\n        resourceId?: string;\n        idempotencyKey?: string;\n        options?: StartWorkflowOptions;\n      };\n      workflowId = params.workflowId;\n      input = params.input;\n      resourceId = params.resourceId;\n      idempotencyKey = params.idempotencyKey;\n      options = params.options;\n      singleton = params.options?.singleton === true;\n    }\n\n    validateWorkflowId(workflowId);\n    validateResourceId(resourceId);\n\n    const run = await withPostgresTransaction(\n      this.db,\n      async (_db) => {\n        const timeoutAt = options?.timeout ? new Date(Date.now() + options.timeout) : null;\n\n        const { run: insertedRun, created } = await insertWorkflowRun(\n          {\n            resourceId,\n            workflowId,\n            currentStepId: '__start__',\n            status: WorkflowStatus.RUNNING,\n            input,\n            maxRetries: options?.retries ?? 0,\n            priority: resolvePriority(options?.priority),\n            timeoutAt,\n            idempotencyKey,\n            singleton,\n          },\n          _db,\n        );\n\n        if (created) {\n          const job: WorkflowRunJobParameters = {\n            runId: insertedRun.id,\n            resourceId,\n            workflowId,\n            input,\n          };\n\n          // Same connection (`_db`) used for the workflow_runs INSERT is passed\n          // to `boss.send` so the pgboss.job INSERT joins the same transaction.\n          // The two writes commit or roll back together, so we never leak an\n          // orphan workflow_runs row when the queue insert fails.\n          await this.boss.send(WORKFLOW_RUN_QUEUE_NAME, job, {\n            startAfter: new Date(),\n            expireInSeconds: options?.expireInSeconds ?? defaultExpireInSeconds,\n            priority: insertedRun.priority,\n            db: _db,\n          });\n        }\n\n        return insertedRun;\n      },\n      this.pool,\n    );\n\n    this.logger.log(`${LOG_PREFIX} Started workflow run ${run.id} for ${workflowId}`);\n\n    return run;\n  }\n\n  async triggerEvent({\n    runId,\n    resourceId,\n    eventName,\n    data,\n    options,\n  }: {\n    runId: string;\n    resourceId?: string;\n    eventName: string;\n    data?: Record<string, unknown>;\n    options?: { expireInSeconds?: number };\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const run = await this.getRun({ runId, resourceId });\n\n    if (run.singleton) {\n      await assertSingletonSlotAvailable(\n        { workflowId: run.workflowId, exceptRunId: run.id },\n        this.db,\n      );\n    }\n\n    const job: WorkflowRunJobParameters = {\n      runId: run.id,\n      resourceId: resourceId ?? run.resourceId ?? undefined,\n      workflowId: run.workflowId,\n      input: run.input,\n      event: {\n        name: eventName,\n        data,\n      },\n    };\n\n    await this.boss.send(WORKFLOW_RUN_QUEUE_NAME, job, {\n      expireInSeconds: options?.expireInSeconds ?? defaultExpireInSeconds,\n      priority: run.priority,\n    });\n\n    this.logger.log(`${LOG_PREFIX} Event ${eventName} sent for workflow run ${runId}`);\n    return run;\n  }\n\n  async pauseWorkflow({\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const run = await updateWorkflowRun(\n      {\n        runId,\n        resourceId,\n        data: {\n          status: WorkflowStatus.PAUSED,\n          pausedAt: new Date(),\n        },\n        expectedStatuses: [WorkflowStatus.RUNNING, WorkflowStatus.PENDING],\n      },\n      this.db,\n    );\n\n    if (!run) {\n      throw new WorkflowRunNotFoundError(runId);\n    }\n\n    this.logger.log(`${LOG_PREFIX} Paused workflow run ${runId}`);\n    return run;\n  }\n\n  async resumeWorkflow({\n    runId,\n    resourceId,\n    options,\n  }: {\n    runId: string;\n    resourceId?: string;\n    options?: { expireInSeconds?: number };\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const current = await this.getRun({ runId, resourceId });\n    if (current.status !== WorkflowStatus.PAUSED) {\n      throw new WorkflowEngineError(\n        `Cannot resume workflow run in '${current.status}' status, must be 'paused'`,\n        current.workflowId,\n        runId,\n      );\n    }\n\n    const currentStepId = current.currentStepId;\n    const currentStepTimelineEntry =\n      current.timeline[invokeChildWorkflowTimelineKey(currentStepId)];\n    if (isInvokeChildWorkflowTimelineEntry(currentStepTimelineEntry)) {\n      return current;\n    }\n\n    return this.triggerEvent({\n      runId,\n      resourceId,\n      eventName: PAUSE_EVENT_NAME,\n      data: {},\n      options,\n    });\n  }\n\n  async fastForwardWorkflow({\n    runId,\n    resourceId,\n    data,\n  }: {\n    runId: string;\n    resourceId?: string;\n    data?: Record<string, unknown>;\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const run = await this.getRun({ runId, resourceId });\n\n    if (run.status !== WorkflowStatus.PAUSED) {\n      return run;\n    }\n\n    const currentStepId = run.currentStepId;\n    const currentStepTimelineEntry = run.timeline[invokeChildWorkflowTimelineKey(currentStepId)];\n    if (isInvokeChildWorkflowTimelineEntry(currentStepTimelineEntry)) {\n      return run;\n    }\n\n    const waitForEntry = run.timeline[waitForTimelineKey(currentStepId)];\n    if (!waitForEntry || typeof waitForEntry !== 'object' || !('waitFor' in waitForEntry)) {\n      return run;\n    }\n\n    const { eventName, timeoutEvent, skipOutput } = (\n      waitForEntry as { waitFor: { eventName?: string; timeoutEvent?: string; skipOutput?: true } }\n    ).waitFor;\n\n    // step.pause() - delegate to resumeWorkflow\n    if (eventName === PAUSE_EVENT_NAME) {\n      return this.resumeWorkflow({ runId, resourceId });\n    }\n\n    // step.poll() - write output to timeline first, then trigger resume\n    if (skipOutput && timeoutEvent) {\n      await withPostgresTransaction(\n        this.db,\n        async (db) => {\n          const freshRun = await getWorkflowRun({ runId, resourceId }, { exclusiveLock: true, db });\n          if (!freshRun) throw new WorkflowRunNotFoundError(runId);\n          return updateWorkflowRun(\n            {\n              runId,\n              resourceId,\n              data: {\n                timeline: merge(freshRun.timeline, {\n                  [currentStepId]: {\n                    output: data ?? {},\n                    timestamp: new Date(),\n                  },\n                }),\n              },\n            },\n            db,\n          );\n        },\n        this.pool,\n      );\n\n      return this.triggerEvent({ runId, resourceId, eventName: timeoutEvent });\n    }\n\n    // waitFor steps - trigger the event with data\n    if (eventName) {\n      return this.triggerEvent({ runId, resourceId, eventName, data: data ?? {} });\n    }\n\n    // delay/waitUntil steps - trigger the timeout event\n    if (timeoutEvent) {\n      return this.triggerEvent({ runId, resourceId, eventName: timeoutEvent, data: data ?? {} });\n    }\n\n    return run;\n  }\n\n  async cancelWorkflow({\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const run = await updateWorkflowRun(\n      {\n        runId,\n        resourceId,\n        data: {\n          status: WorkflowStatus.CANCELLED,\n        },\n        expectedStatuses: [WorkflowStatus.PENDING, WorkflowStatus.RUNNING, WorkflowStatus.PAUSED],\n      },\n      this.db,\n    );\n\n    if (!run) {\n      throw new WorkflowRunNotFoundError(runId);\n    }\n\n    this.logger.log(`${LOG_PREFIX} Cancelled workflow run ${runId}`);\n    return run;\n  }\n\n  async getRun({\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  }): Promise<WorkflowRun> {\n    await this.ensureStarted();\n\n    const run = await getWorkflowRun({ runId, resourceId }, { db: this.db });\n\n    if (!run) {\n      throw new WorkflowRunNotFoundError(runId);\n    }\n\n    return run;\n  }\n\n  async checkProgress({\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  }): Promise<WorkflowRunProgress> {\n    const run = await this.getRun({ runId, resourceId });\n\n    const completedSteps = Object.values(run.timeline).filter(\n      (entry): entry is { output: unknown; timestamp: Date } =>\n        typeof entry === 'object' &&\n        entry !== null &&\n        'output' in entry &&\n        entry.output !== undefined,\n    ).length;\n\n    // Without registered workflow definitions, total steps are unknown.\n    // Use completed steps as best-effort estimate for in-progress runs.\n    const totalSteps = run.status === WorkflowStatus.COMPLETED ? completedSteps : 0;\n    const completionPercentage =\n      run.status === WorkflowStatus.COMPLETED\n        ? 100\n        : run.status === WorkflowStatus.FAILED || run.status === WorkflowStatus.CANCELLED\n          ? 0\n          : 0;\n\n    return {\n      ...run,\n      completedSteps,\n      completionPercentage,\n      totalSteps,\n    };\n  }\n\n  async getRuns({\n    resourceId,\n    startingAfter,\n    endingBefore,\n    limit = 20,\n    statuses,\n    workflowId,\n  }: {\n    resourceId?: string;\n    startingAfter?: string | null;\n    endingBefore?: string | null;\n    limit?: number;\n    statuses?: WorkflowStatus[];\n    workflowId?: string;\n  }): Promise<{\n    items: WorkflowRun[];\n    nextCursor: string | null;\n    prevCursor: string | null;\n    hasMore: boolean;\n    hasPrev: boolean;\n  }> {\n    await this.ensureStarted();\n\n    if (workflowId) validateWorkflowId(workflowId);\n    validateResourceId(resourceId);\n\n    return getWorkflowRuns(\n      {\n        resourceId,\n        startingAfter,\n        endingBefore,\n        limit,\n        statuses,\n        workflowId,\n      },\n      this.db,\n    );\n  }\n\n  private async ensureStarted(): Promise<void> {\n    if (!this._started) {\n      await this.start();\n    }\n  }\n}\n",
+    "import type { Db } from 'pg-boss';\n\n// Arbitrary but stable lock ID for serializing migrations across processes\nexport const MIGRATION_LOCK_ID = 738291645;\n\n// Bump this when adding new migrations. The engine stores the current version\n// in a `workflow_schema_version` table so migrations only run once per version.\nconst CURRENT_SCHEMA_VERSION = 7;\n\nexport async function runMigrations(db: Db): Promise<void> {\n  // Fast path: skip the advisory lock if schema is already current.\n  // This is the common case - every engine.start() after initial setup.\n  if (await isSchemaUpToDate(db)) {\n    return;\n  }\n\n  // Slow path: build migration SQL based on current version, then execute\n  // everything in a single transaction with an advisory lock.\n  // This mirrors pg-boss's approach: one executeSql call ensures all DDL\n  // runs on a single connection inside BEGIN/COMMIT, and pg_advisory_xact_lock\n  // auto-releases on commit or rollback (no manual unlock needed).\n  const currentVersion = await getCurrentVersion(db);\n\n  const commands: string[] = [];\n\n  if (currentVersion < 1) {\n    // On first run, we run a check to see if there is an existing foreign\n    // `workflow_runs` table. To decide on that, we check if the `workflow_runs`\n    // exists but a `workflow_schema_version` table doesn't. If that is true\n    // then `workflow_runs` is foreign and we should fail lest we start\n    // adding rows there, corrupting it. We also do the reverse check.\n    // We are basing this off the fact that our transaction creates both or no tables\n    // This is not airtight, but serves as an extra safety check for now.\n    const existing = await db.executeSql(\n      `SELECT\n         to_regclass('workflow_runs') IS NOT NULL AS has_runs_table,\n         to_regclass('workflow_schema_version') IS NOT NULL AS has_version_table`,\n      [],\n    );\n\n    const row = existing.rows[0] as\n      | { has_runs_table: boolean; has_version_table: boolean }\n      | undefined;\n\n    if (row?.has_runs_table && !row.has_version_table) {\n      throw new Error(\n        `pg-workflows: a \"workflow_runs\" table already exists in this schema but was not ` +\n          `created by pg-workflows. Point the workflow engine at a dedicated schema/database.`,\n      );\n    }\n\n    if (!row?.has_runs_table && row?.has_version_table) {\n      throw new Error(\n        `pg-workflows: a \"workflow_schema_version\" table already exists in this schema but was not ` +\n          `created by pg-workflows. Point the workflow engine at a dedicated schema/database.`,\n      );\n    }\n\n    commands.push(`\n      CREATE TABLE IF NOT EXISTS workflow_runs (\n        id varchar(32) PRIMARY KEY NOT NULL,\n        created_at timestamp with time zone DEFAULT now() NOT NULL,\n        updated_at timestamp with time zone DEFAULT now() NOT NULL,\n        resource_id varchar(256),\n        workflow_id varchar(256) NOT NULL,\n        status text DEFAULT 'pending' NOT NULL,\n        input jsonb NOT NULL,\n        output jsonb,\n        error text,\n        current_step_id varchar(256) NOT NULL,\n        timeline jsonb DEFAULT '{}'::jsonb NOT NULL,\n        paused_at timestamp with time zone,\n        resumed_at timestamp with time zone,\n        completed_at timestamp with time zone,\n        timeout_at timestamp with time zone,\n        retry_count integer DEFAULT 0 NOT NULL,\n        max_retries integer DEFAULT 0 NOT NULL,\n        job_id varchar(256)\n      )\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_created_at_idx ON workflow_runs USING btree (created_at)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_resource_id_created_at_idx ON workflow_runs USING btree (resource_id, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_status_created_at_idx ON workflow_runs USING btree (status, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_workflow_id_created_at_idx ON workflow_runs USING btree (workflow_id, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_resource_id_workflow_id_created_at_idx ON workflow_runs USING btree (resource_id, workflow_id, created_at DESC)\n    `);\n  }\n\n  if (currentVersion < 2) {\n    commands.push('DROP INDEX IF EXISTS workflow_runs_workflow_id_idx');\n    commands.push('DROP INDEX IF EXISTS workflow_runs_resource_id_idx');\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS idempotency_key varchar(256)',\n    );\n    commands.push(`\n      CREATE UNIQUE INDEX IF NOT EXISTS workflow_runs_idempotency_key_idx ON workflow_runs (idempotency_key) WHERE idempotency_key IS NOT NULL\n    `);\n  }\n\n  if (currentVersion < 3) {\n    commands.push('ALTER TABLE workflow_runs ALTER COLUMN resource_id TYPE varchar(256)');\n    commands.push('ALTER TABLE workflow_runs ALTER COLUMN workflow_id TYPE varchar(256)');\n  }\n\n  if (currentVersion < 4) {\n    commands.push('ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_run_id varchar(32)');\n    commands.push('ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_step_id varchar(256)');\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_resource_id varchar(256)',\n    );\n  }\n\n  if (currentVersion < 5) {\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS scheduled_at timestamp with time zone',\n    );\n  }\n\n  if (currentVersion < 6) {\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS priority integer DEFAULT 0 NOT NULL',\n    );\n  }\n\n  if (currentVersion < 7) {\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS singleton boolean DEFAULT false NOT NULL',\n    );\n    commands.push(`\n      CREATE UNIQUE INDEX IF NOT EXISTS workflow_runs_singleton_active_idx\n        ON workflow_runs (workflow_id)\n        WHERE singleton AND status IN ('pending', 'running')\n    `);\n  }\n\n  // Upsert the schema version\n  if (currentVersion === 0) {\n    commands.push(\n      `INSERT INTO workflow_schema_version (version) VALUES (${CURRENT_SCHEMA_VERSION})`,\n    );\n  } else {\n    commands.push(`UPDATE workflow_schema_version SET version = ${CURRENT_SCHEMA_VERSION}`);\n  }\n\n  if (commands.length === 0) {\n    return;\n  }\n\n  const sql = [\n    'BEGIN',\n    \"SET LOCAL lock_timeout = '30s'\",\n    \"SET LOCAL idle_in_transaction_session_timeout = '30s'\",\n    `SELECT pg_advisory_xact_lock(${MIGRATION_LOCK_ID})`,\n    'CREATE TABLE IF NOT EXISTS workflow_schema_version (version integer NOT NULL)',\n    ...commands,\n    'COMMIT',\n  ].join(';\\n');\n\n  await db.executeSql(sql, []);\n}\n\nasync function isSchemaUpToDate(db: Db): Promise<boolean> {\n  try {\n    const result = await db.executeSql('SELECT version FROM workflow_schema_version LIMIT 1', []);\n    return (\n      ((result.rows[0] as { version: number } | undefined)?.version ?? 0) >= CURRENT_SCHEMA_VERSION\n    );\n  } catch {\n    // Table doesn't exist yet - needs migration\n    return false;\n  }\n}\n\nasync function getCurrentVersion(db: Db): Promise<number> {\n  try {\n    const result = await db.executeSql('SELECT version FROM workflow_schema_version LIMIT 1', []);\n    return (result.rows[0] as { version: number } | undefined)?.version ?? 0;\n  } catch {\n    return 0;\n  }\n}\n",
+    "import ksuid from 'ksuid';\nimport type { Db } from 'pg-boss';\nimport { WorkflowRunInProgressError } from '../error';\nimport type { WorkflowRun } from './types';\n\nexport function generateKSUID(prefix?: string): string {\n  return `${prefix ? `${prefix}_` : ''}${ksuid.randomSync().string}`;\n}\n\ntype WorkflowRunRow = {\n  id: string;\n  created_at: string | Date;\n  updated_at: string | Date;\n  resource_id: string | null;\n  workflow_id: string;\n  status: 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';\n  input: string | unknown;\n  output: string | unknown | null;\n  error: string | null;\n  current_step_id: string;\n  timeline: string | Record<string, unknown>;\n  paused_at: string | Date | null;\n  resumed_at: string | Date | null;\n  completed_at: string | Date | null;\n  timeout_at: string | Date | null;\n  retry_count: number;\n  max_retries: number;\n  priority: number;\n  job_id: string | null;\n  idempotency_key: string | null;\n  parent_run_id: string | null;\n  parent_step_id: string | null;\n  parent_resource_id: string | null;\n  scheduled_at: string | Date | null;\n  singleton: boolean;\n};\n\nfunction isUniqueViolation(error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  if ('code' in error && error.code === '23505') {\n    return true;\n  }\n  const cause = 'cause' in error ? error.cause : undefined;\n  return Boolean(cause && typeof cause === 'object' && 'code' in cause && cause.code === '23505');\n}\n\nfunction mapRowToWorkflowRun(row: WorkflowRunRow): WorkflowRun {\n  return {\n    id: row.id,\n    createdAt: new Date(row.created_at),\n    updatedAt: new Date(row.updated_at),\n    resourceId: row.resource_id,\n    workflowId: row.workflow_id,\n    status: row.status,\n    input: typeof row.input === 'string' ? JSON.parse(row.input) : row.input,\n    output:\n      typeof row.output === 'string'\n        ? row.output.trim().startsWith('{') || row.output.trim().startsWith('[')\n          ? JSON.parse(row.output)\n          : row.output\n        : (row.output ?? null),\n    error: row.error,\n    currentStepId: row.current_step_id,\n    timeline: typeof row.timeline === 'string' ? JSON.parse(row.timeline) : row.timeline,\n    pausedAt: row.paused_at ? new Date(row.paused_at) : null,\n    resumedAt: row.resumed_at ? new Date(row.resumed_at) : null,\n    completedAt: row.completed_at ? new Date(row.completed_at) : null,\n    timeoutAt: row.timeout_at ? new Date(row.timeout_at) : null,\n    retryCount: row.retry_count,\n    maxRetries: row.max_retries,\n    priority: row.priority,\n    jobId: row.job_id,\n    idempotencyKey: row.idempotency_key,\n    parentRunId: row.parent_run_id,\n    parentStepId: row.parent_step_id,\n    parentResourceId: row.parent_resource_id,\n    scheduledAt: row.scheduled_at ? new Date(row.scheduled_at) : null,\n    singleton: Boolean(row.singleton),\n  };\n}\n\nexport async function insertWorkflowRun(\n  {\n    resourceId,\n    workflowId,\n    currentStepId,\n    status,\n    input,\n    maxRetries,\n    priority,\n    timeoutAt,\n    idempotencyKey,\n    parentRunId,\n    parentStepId,\n    parentResourceId,\n    scheduledAt,\n    singleton = false,\n  }: {\n    resourceId?: string;\n    workflowId: string;\n    currentStepId: string;\n    status: string;\n    input: unknown;\n    maxRetries: number;\n    priority: number;\n    timeoutAt: Date | null;\n    idempotencyKey?: string;\n    parentRunId?: string;\n    parentStepId?: string;\n    parentResourceId?: string;\n    scheduledAt?: Date;\n    singleton?: boolean;\n  },\n  db: Db,\n): Promise<{ run: WorkflowRun; created: boolean }> {\n  const runId = generateKSUID('run');\n  const now = new Date();\n\n  if (singleton) {\n    const active = await getActiveSingletonRun(workflowId, db);\n    if (active) {\n      throw new WorkflowRunInProgressError(workflowId, active.id);\n    }\n  }\n\n  let result: { rows: WorkflowRunRow[] };\n  try {\n    result = (await db.executeSql(\n      `INSERT INTO workflow_runs (\n      id,\n      resource_id,\n      workflow_id,\n      current_step_id,\n      status,\n      input,\n      max_retries,\n      priority,\n      timeout_at,\n      created_at,\n      updated_at,\n      timeline,\n      retry_count,\n      idempotency_key,\n      parent_run_id,\n      parent_step_id,\n      parent_resource_id,\n      scheduled_at,\n      singleton\n    )\n    VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19)\n    ON CONFLICT (idempotency_key) WHERE idempotency_key IS NOT NULL DO NOTHING\n    RETURNING *`,\n      [\n        runId,\n        resourceId ?? null,\n        workflowId,\n        currentStepId,\n        status,\n        JSON.stringify(input),\n        maxRetries,\n        priority,\n        timeoutAt,\n        now,\n        now,\n        '{}',\n        0,\n        idempotencyKey ?? null,\n        parentRunId ?? null,\n        parentStepId ?? null,\n        parentResourceId ?? null,\n        scheduledAt ?? null,\n        singleton,\n      ],\n    )) as { rows: WorkflowRunRow[] };\n  } catch (error) {\n    if (singleton && isUniqueViolation(error)) {\n      const active = await getActiveSingletonRun(workflowId, db);\n      throw new WorkflowRunInProgressError(workflowId, active?.id);\n    }\n    throw error;\n  }\n\n  if (result.rows[0]) {\n    return { run: mapRowToWorkflowRun(result.rows[0]), created: true };\n  }\n\n  // Conflict - fetch the existing row\n  const existing = await db.executeSql('SELECT * FROM workflow_runs WHERE idempotency_key = $1', [\n    idempotencyKey,\n  ]);\n\n  if (!existing.rows[0]) {\n    throw new Error(`Idempotency conflict: existing run not found for key \"${idempotencyKey}\"`);\n  }\n\n  return { run: mapRowToWorkflowRun(existing.rows[0]), created: false };\n}\n\nexport async function getActiveSingletonRun(\n  workflowId: string,\n  db: Db,\n): Promise<WorkflowRun | null> {\n  const result = await db.executeSql(\n    `SELECT * FROM workflow_runs\n     WHERE workflow_id = $1\n       AND singleton\n       AND status IN ('pending', 'running')\n     LIMIT 1`,\n    [workflowId],\n  );\n\n  return result.rows[0] ? mapRowToWorkflowRun(result.rows[0] as WorkflowRunRow) : null;\n}\n\nexport async function assertSingletonSlotAvailable(\n  { workflowId, exceptRunId }: { workflowId: string; exceptRunId?: string },\n  db: Db,\n): Promise<void> {\n  const active = await getActiveSingletonRun(workflowId, db);\n  if (active && active.id !== exceptRunId) {\n    throw new WorkflowRunInProgressError(workflowId, active.id);\n  }\n}\n\nexport async function getWorkflowRun(\n  {\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  },\n  { exclusiveLock = false, db }: { exclusiveLock?: boolean; db: Db },\n): Promise<WorkflowRun | null> {\n  const lockSuffix = exclusiveLock ? 'FOR UPDATE' : '';\n\n  const result = resourceId\n    ? await db.executeSql(\n        `SELECT * FROM workflow_runs \n        WHERE id = $1 AND resource_id = $2\n        ${lockSuffix}`,\n        [runId, resourceId],\n      )\n    : await db.executeSql(\n        `SELECT * FROM workflow_runs \n        WHERE id = $1\n        ${lockSuffix}`,\n        [runId],\n      );\n\n  const run = result.rows[0];\n\n  if (!run) {\n    return null;\n  }\n\n  return mapRowToWorkflowRun(run);\n}\n\nexport async function getWorkflowLastRun(\n  {\n    workflowId,\n    resourceId,\n  }: {\n    workflowId: string;\n    resourceId?: string;\n  },\n  db: Db,\n): Promise<WorkflowRun | null> {\n  const result = resourceId\n    ? await db.executeSql(\n        `SELECT * FROM workflow_runs\n         WHERE workflow_id = $1 AND resource_id = $2\n         ORDER BY created_at DESC\n         LIMIT 1`,\n        [workflowId, resourceId],\n      )\n    : await db.executeSql(\n        `SELECT * FROM workflow_runs\n         WHERE workflow_id = $1\n         ORDER BY created_at DESC\n         LIMIT 1`,\n        [workflowId],\n      );\n\n  const run = result.rows[0];\n  if (!run) {\n    return null;\n  }\n  return mapRowToWorkflowRun(run);\n}\n\nexport async function updateWorkflowRun(\n  {\n    runId,\n    resourceId,\n    data,\n    expectedStatuses,\n  }: {\n    runId: string;\n    resourceId?: string;\n    data: Partial<WorkflowRun>;\n    expectedStatuses?: string[];\n  },\n  db: Db,\n): Promise<WorkflowRun | null> {\n  const now = new Date();\n\n  const updates: string[] = ['updated_at = $1'];\n  const values: (string | number | Date | null | string[])[] = [now];\n  let paramIndex = 2;\n\n  if (data.status !== undefined) {\n    updates.push(`status = $${paramIndex}`);\n    values.push(data.status);\n    paramIndex++;\n  }\n  if (data.currentStepId !== undefined) {\n    updates.push(`current_step_id = $${paramIndex}`);\n    values.push(data.currentStepId);\n    paramIndex++;\n  }\n  if (data.timeline !== undefined) {\n    updates.push(`timeline = $${paramIndex}`);\n    values.push(JSON.stringify(data.timeline));\n    paramIndex++;\n  }\n  if (data.pausedAt !== undefined) {\n    updates.push(`paused_at = $${paramIndex}`);\n    values.push(data.pausedAt);\n    paramIndex++;\n  }\n  if (data.resumedAt !== undefined) {\n    updates.push(`resumed_at = $${paramIndex}`);\n    values.push(data.resumedAt);\n    paramIndex++;\n  }\n  if (data.completedAt !== undefined) {\n    updates.push(`completed_at = $${paramIndex}`);\n    values.push(data.completedAt);\n    paramIndex++;\n  }\n  if (data.output !== undefined) {\n    updates.push(`output = $${paramIndex}`);\n    values.push(JSON.stringify(data.output));\n    paramIndex++;\n  }\n  if (data.error !== undefined) {\n    updates.push(`error = $${paramIndex}`);\n    values.push(data.error);\n    paramIndex++;\n  }\n  if (data.retryCount !== undefined) {\n    updates.push(`retry_count = $${paramIndex}`);\n    values.push(data.retryCount);\n    paramIndex++;\n  }\n  if (data.jobId !== undefined) {\n    updates.push(`job_id = $${paramIndex}`);\n    values.push(data.jobId);\n    paramIndex++;\n  }\n\n  values.push(runId);\n  const idParam = paramIndex;\n  paramIndex++;\n\n  if (resourceId) {\n    values.push(resourceId);\n    paramIndex++;\n  }\n\n  if (expectedStatuses && expectedStatuses.length > 0) {\n    values.push(expectedStatuses);\n    paramIndex++;\n  }\n\n  let whereClause = resourceId\n    ? `WHERE id = $${idParam} AND resource_id = $${idParam + 1}`\n    : `WHERE id = $${idParam}`;\n\n  if (expectedStatuses && expectedStatuses.length > 0) {\n    whereClause += ` AND status = ANY($${paramIndex - 1})`;\n  }\n\n  const query = `\n    UPDATE workflow_runs \n    SET ${updates.join(', ')}\n    ${whereClause}\n    RETURNING *\n  `;\n\n  let result: { rows: WorkflowRunRow[] };\n  try {\n    result = (await db.executeSql(query, values)) as { rows: WorkflowRunRow[] };\n  } catch (error) {\n    if (data.status === 'running' && isUniqueViolation(error)) {\n      throw new WorkflowRunInProgressError('unknown', runId);\n    }\n    throw error;\n  }\n  const run = result.rows[0];\n\n  if (!run) {\n    return null;\n  }\n\n  return mapRowToWorkflowRun(run);\n}\n\nexport async function getWorkflowRuns(\n  {\n    resourceId,\n    startingAfter,\n    endingBefore,\n    limit = 20,\n    statuses,\n    workflowId,\n  }: {\n    resourceId?: string;\n    startingAfter?: string | null;\n    endingBefore?: string | null;\n    limit?: number;\n    statuses?: string[];\n    workflowId?: string;\n  },\n  db: Db,\n): Promise<{\n  items: WorkflowRun[];\n  nextCursor: string | null;\n  prevCursor: string | null;\n  hasMore: boolean;\n  hasPrev: boolean;\n}> {\n  const conditions: string[] = [];\n  const values: (string | number | string[] | Date)[] = [];\n  let paramIndex = 1;\n\n  if (resourceId) {\n    conditions.push(`resource_id = $${paramIndex}`);\n    values.push(resourceId);\n    paramIndex++;\n  }\n\n  if (statuses && statuses.length > 0) {\n    conditions.push(`status = ANY($${paramIndex})`);\n    values.push(statuses);\n    paramIndex++;\n  }\n\n  if (workflowId) {\n    conditions.push(`workflow_id = $${paramIndex}`);\n    values.push(workflowId);\n    paramIndex++;\n  }\n\n  const cursorIds = [startingAfter, endingBefore].filter(Boolean) as string[];\n  if (cursorIds.length > 0) {\n    const cursorResult = await db.executeSql(\n      'SELECT id, created_at FROM workflow_runs WHERE id = ANY($1)',\n      [cursorIds],\n    );\n    const cursorMap = new Map<string, Date>();\n    for (const row of cursorResult.rows) {\n      cursorMap.set(\n        row.id,\n        typeof row.created_at === 'string' ? new Date(row.created_at) : row.created_at,\n      );\n    }\n\n    if (startingAfter) {\n      const cursor = cursorMap.get(startingAfter);\n      if (cursor) {\n        conditions.push(`created_at < $${paramIndex}`);\n        values.push(cursor);\n        paramIndex++;\n      }\n    }\n\n    if (endingBefore) {\n      const cursor = cursorMap.get(endingBefore);\n      if (cursor) {\n        conditions.push(`created_at > $${paramIndex}`);\n        values.push(cursor);\n        paramIndex++;\n      }\n    }\n  }\n\n  const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';\n  const actualLimit = Math.min(Math.max(limit, 1), 100) + 1;\n\n  const isBackward = !!endingBefore && !startingAfter;\n\n  const query = `\n    SELECT * FROM workflow_runs\n    ${whereClause}\n    ORDER BY created_at ${isBackward ? 'ASC' : 'DESC'}\n    LIMIT $${paramIndex}\n  `;\n  values.push(actualLimit);\n\n  const result = await db.executeSql(query, values);\n  const rows = result.rows;\n\n  const hasExtraRow = rows.length > (limit ?? 20);\n  const rawItems = hasExtraRow ? rows.slice(0, limit) : rows;\n\n  if (isBackward) {\n    rawItems.reverse();\n  }\n\n  const items = rawItems.map((row) => mapRowToWorkflowRun(row));\n\n  const hasMore = isBackward ? items.length > 0 : hasExtraRow;\n  const hasPrev = isBackward ? hasExtraRow : !!startingAfter && items.length > 0;\n\n  const nextCursor = hasMore && items.length > 0 ? (items[items.length - 1]?.id ?? null) : null;\n  const prevCursor = hasPrev && items.length > 0 ? (items[0]?.id ?? null) : null;\n\n  return { items, nextCursor, prevCursor, hasMore, hasPrev };\n}\n\n/**\n * Run a callback inside a PostgreSQL transaction using a dedicated client.\n *\n * When a `pool` is provided, a dedicated client is checked out so that\n * BEGIN / COMMIT / ROLLBACK all execute on the **same** connection.\n * This is critical for `SELECT … FOR UPDATE` locks and any work that\n * yields to the event-loop inside the transaction (e.g. async step handlers).\n *\n * Falls back to the pg-boss `Db` adapter when no pool is given (unit-test path).\n */\nexport async function withPostgresTransaction<T>(\n  db: Db,\n  callback: (db: Db) => Promise<T>,\n  pool?: {\n    connect: () => Promise<{\n      query: (text: string, values?: unknown[]) => Promise<unknown>;\n      release: () => void;\n    }>;\n  },\n): Promise<T> {\n  let txDb: Db;\n  let release: (() => void) | undefined;\n\n  if (pool) {\n    const client = await pool.connect();\n    txDb = {\n      executeSql: (text: string, values?: unknown[]) =>\n        client.query(text, values) as Promise<{ rows: unknown[] }>,\n    };\n    release = () => client.release();\n  } else {\n    txDb = db;\n  }\n\n  try {\n    await txDb.executeSql('BEGIN', []);\n    const result = await callback(txDb);\n    await txDb.executeSql('COMMIT', []);\n    return result;\n  } catch (error) {\n    await txDb.executeSql('ROLLBACK', []);\n    throw error;\n  } finally {\n    release?.();\n  }\n}\n",
+    "import { WorkflowEngineError } from './error';\n\n/**\n * Named priority levels mapped to pg-boss integer priorities. Higher numbers\n * are fetched first (pg-boss orders by `priority DESC`), and `normal = 0`\n * matches pg-boss's own default. The ±100 spacing leaves room for numeric\n * tuning between tiers via the escape hatch.\n */\nexport const PRIORITY_LEVELS = { high: 100, normal: 0, low: -100 } as const;\n\nexport type WorkflowPriority = keyof typeof PRIORITY_LEVELS | number;\n\nfunction priorityToInt(value: WorkflowPriority): number {\n  if (typeof value === 'number') {\n    if (!Number.isInteger(value)) {\n      throw new WorkflowEngineError(\n        `Invalid priority ${value}: numeric priority must be an integer.`,\n      );\n    }\n    return value;\n  }\n\n  const mapped = PRIORITY_LEVELS[value];\n  if (mapped === undefined) {\n    throw new WorkflowEngineError(\n      `Invalid priority \"${value}\": expected one of ${Object.keys(PRIORITY_LEVELS)\n        .map((k) => `\"${k}\"`)\n        .join(', ')} or an integer.`,\n    );\n  }\n  return mapped;\n}\n\n/**\n * Resolve the effective priority from a precedence chain. The first defined\n * candidate wins (e.g. per-run override, then definition default, then an\n * inherited parent priority); when nothing is defined it falls back to\n * normal (0).\n */\nexport function resolvePriority(...candidates: (WorkflowPriority | undefined)[]): number {\n  for (const candidate of candidates) {\n    if (candidate !== undefined) {\n      return priorityToInt(candidate);\n    }\n  }\n  return PRIORITY_LEVELS.normal;\n}\n",
+    "import type {\n  InputParameters,\n  StepBaseContext,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowFactory,\n  WorkflowOptions,\n  WorkflowPlugin,\n  WorkflowRef,\n} from './types';\n\n/**\n * Create a lightweight workflow reference.\n * Safe to import from `pg-workflows/client` - no engine or handler code.\n */\nexport function createWorkflowRef<\n  TOutput = unknown,\n  TInput extends InputParameters = InputParameters,\n>(\n  id: string,\n  options?: { inputSchema?: TInput; singleton?: boolean },\n): WorkflowRef<TInput, TOutput> {\n  const ref = ((\n    handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>,\n    defineOptions?: Omit<WorkflowOptions<TInput>, 'inputSchema'>,\n  ): WorkflowDefinition<TInput> => ({\n    id,\n    handler: handler as (\n      context: WorkflowContext<InputParameters, StepBaseContext>,\n    ) => Promise<unknown>,\n    inputSchema: options?.inputSchema,\n    timeout: defineOptions?.timeout,\n    retries: defineOptions?.retries,\n    priority: defineOptions?.priority,\n    singleton: defineOptions?.singleton ?? options?.singleton,\n    schedule: defineOptions?.schedule,\n    timezone: defineOptions?.timezone,\n  })) as WorkflowRef<TInput, TOutput>;\n\n  Object.defineProperty(ref, 'id', { value: id, enumerable: true });\n  Object.defineProperty(ref, 'inputSchema', {\n    value: options?.inputSchema,\n    enumerable: true,\n  });\n  Object.defineProperty(ref, 'singleton', {\n    value: options?.singleton,\n    enumerable: true,\n  });\n\n  return ref;\n}\n\nfunction createWorkflowFactory<TStepExt extends object = object>(\n  plugins: Array<WorkflowPlugin<unknown, object>> = [],\n): WorkflowFactory<TStepExt> {\n  const factory = (<I extends InputParameters>(\n    id: string,\n    handler: (context: WorkflowContext<I, StepBaseContext & TStepExt>) => Promise<unknown>,\n    {\n      inputSchema,\n      timeout,\n      retries,\n      priority,\n      singleton,\n      schedule,\n      timezone,\n    }: WorkflowOptions<I> = {},\n  ): WorkflowDefinition<I> => ({\n    id,\n    handler: handler as (\n      context: WorkflowContext<InputParameters, StepBaseContext>,\n    ) => Promise<unknown>,\n    inputSchema,\n    timeout,\n    retries,\n    priority,\n    singleton,\n    schedule,\n    timezone,\n    plugins: plugins.length > 0 ? (plugins as WorkflowPlugin[]) : undefined,\n  })) as WorkflowFactory<TStepExt>;\n\n  factory.use = <TNewExt>(\n    plugin: WorkflowPlugin<StepBaseContext & TStepExt, TNewExt>,\n  ): WorkflowFactory<TStepExt & TNewExt> =>\n    createWorkflowFactory<TStepExt & TNewExt>([\n      ...plugins,\n      plugin as WorkflowPlugin<unknown, object>,\n    ]);\n\n  factory.ref = createWorkflowRef;\n\n  return factory;\n}\n\nexport const workflow: WorkflowFactory = createWorkflowFactory();\n"
+  ],
+  "mappings": ";AAAO,IAAM,mBAAmB;AACzB,IAAM,0BAA0B;AAChC,IAAM,8BAA8B;AAG3C,IAAM,wBAAwB;AACvB,IAAM,uBAAuB,CAAC,eACnC,GAAG,wBAAwB;AACtB,IAAM,wBAAwB;AAC9B,IAAM,yBAAyB;AAC/B,IAAM,yBAAyB;AAK/B,IAAM,wCAAwC;AAC9C,IAAM,2BAA2B;AACjC,IAAM,iCAAiC,CAAC,WAC7C,GAAG,UAAU;AACR,IAAM,qBAAqB,CAAC,WAAmB,GAAG,UAAU;AAQ5D,IAAM,qCAAqC,CAChD,UAEA,CAAC,CAAC,SAAS,OAAO,UAAU,aAAY,yBAAyB;;;AC3B5D,SAAS,kBAAkB,CAAC,YAA0B;AAAA,EAC3D,IAAI,WAAW,SAAS,wBAAwB;AAAA,IAC9C,MAAM,IAAI,oBACR,wCAAwC,0CAA0C,WAAW,WAC7F,UACF;AAAA,EACF;AAAA;AAGK,SAAS,kBAAkB,CAAC,YAA6C;AAAA,EAC9E,IAAI,cAAc,QAAQ,WAAW,SAAS,wBAAwB;AAAA,IACpE,MAAM,IAAI,oBACR,wCAAwC,0CAA0C,WAAW,SAC/F;AAAA,EACF;AAAA;AAAA;AAGK,MAAM,4BAA4B,MAAM;AAAA,EAG3B;AAAA,EACA;AAAA,EACS;AAAA,EACT;AAAA,EALlB,WAAW,CACT,SACgB,YACA,OACS,QAA2B,WACpC,QAChB;AAAA,IACA,MAAM,OAAO;AAAA,IALG;AAAA,IACA;AAAA,IACS;AAAA,IACT;AAAA,IAGhB,KAAK,OAAO;AAAA,IAEZ,IAAI,MAAM,mBAAmB;AAAA,MAC3B,MAAM,kBAAkB,MAAM,mBAAmB;AAAA,IACnD;AAAA;AAEJ;AAAA;AAEO,MAAM,iCAAiC,oBAAoB;AAAA,EAChE,WAAW,CAAC,OAAgB,YAAqB;AAAA,IAC/C,MAAM,0BAA0B,YAAY,KAAK;AAAA,IACjD,KAAK,OAAO;AAAA;AAEhB;AAAA;AAEO,MAAM,mCAAmC,oBAAoB;AAAA,EAClE,WAAW,CAAC,YAAoB,OAAgB;AAAA,IAC9C,MACE,aAAa,gGACb,YACA,KACF;AAAA,IACA,KAAK,OAAO;AAAA;AAEhB;;;AC/CO,IAAK;AAAA,CAAL,CAAK,oBAAL;AAAA,EACL,6BAAU;AAAA,EACV,6BAAU;AAAA,EACV,4BAAS;AAAA,EACT,+BAAY;AAAA,EACZ,4BAAS;AAAA,EACT,+BAAY;AAAA,GANF;AA4OZ,IAAM,4BAAqE;AAAA,EACzE,KAAK;AAAA,EACL,SAAS;AAAA,EACT,WAAW;AAAA,EACX,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,qBAAqB;AACvB;AAEO,IAAM,yBAAwD,IAAI,IACvE,OAAO,QAAQ,yBAAyB,CAC1C;;;AC/PA;AACA;AACA;;;ACCO,IAAM,oBAAoB;AAIjC,IAAM,yBAAyB;AAE/B,eAAsB,aAAa,CAAC,IAAuB;AAAA,EAGzD,IAAI,MAAM,iBAAiB,EAAE,GAAG;AAAA,IAC9B;AAAA,EACF;AAAA,EAOA,MAAM,iBAAiB,MAAM,kBAAkB,EAAE;AAAA,EAEjD,MAAM,WAAqB,CAAC;AAAA,EAE5B,IAAI,iBAAiB,GAAG;AAAA,IAQtB,MAAM,WAAW,MAAM,GAAG,WACxB;AAAA;AAAA,mFAGA,CAAC,CACH;AAAA,IAEA,MAAM,MAAM,SAAS,KAAK;AAAA,IAI1B,IAAI,KAAK,kBAAkB,CAAC,IAAI,mBAAmB;AAAA,MACjD,MAAM,IAAI,MACR,qFACE,oFACJ;AAAA,IACF;AAAA,IAEA,IAAI,CAAC,KAAK,kBAAkB,KAAK,mBAAmB;AAAA,MAClD,MAAM,IAAI,MACR,+FACE,oFACJ;AAAA,IACF;AAAA,IAEA,SAAS,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAqBb;AAAA,IACD,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,IACD,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,IACD,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,IACD,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,IACD,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,EACH;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KAAK,oDAAoD;AAAA,IAClE,SAAS,KAAK,oDAAoD;AAAA,IAClE,SAAS,KACP,iFACF;AAAA,IACA,SAAS,KAAK;AAAA;AAAA,KAEb;AAAA,EACH;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KAAK,sEAAsE;AAAA,IACpF,SAAS,KAAK,sEAAsE;AAAA,EACtF;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KAAK,8EAA8E;AAAA,IAC5F,SAAS,KAAK,gFAAgF;AAAA,IAC9F,SAAS,KACP,oFACF;AAAA,EACF;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KACP,0FACF;AAAA,EACF;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KACP,wFACF;AAAA,EACF;AAAA,EAEA,IAAI,iBAAiB,GAAG;AAAA,IACtB,SAAS,KACP,6FACF;AAAA,IACA,SAAS,KAAK;AAAA;AAAA;AAAA;AAAA,KAIb;AAAA,EACH;AAAA,EAGA,IAAI,mBAAmB,GAAG;AAAA,IACxB,SAAS,KACP,yDAAyD,yBAC3D;AAAA,EACF,EAAO;AAAA,IACL,SAAS,KAAK,gDAAgD,wBAAwB;AAAA;AAAA,EAGxF,IAAI,SAAS,WAAW,GAAG;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAM,MAAM;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC;AAAA,IAChC;AAAA,IACA,GAAG;AAAA,IACH;AAAA,EACF,EAAE,KAAK;AAAA,CAAK;AAAA,EAEZ,MAAM,GAAG,WAAW,KAAK,CAAC,CAAC;AAAA;AAG7B,eAAe,gBAAgB,CAAC,IAA0B;AAAA,EACxD,IAAI;AAAA,IACF,MAAM,SAAS,MAAM,GAAG,WAAW,uDAAuD,CAAC,CAAC;AAAA,IAC5F,QACI,OAAO,KAAK,IAAwC,WAAW,MAAM;AAAA,IAEzE,MAAM;AAAA,IAEN,OAAO;AAAA;AAAA;AAIX,eAAe,iBAAiB,CAAC,IAAyB;AAAA,EACxD,IAAI;AAAA,IACF,MAAM,SAAS,MAAM,GAAG,WAAW,uDAAuD,CAAC,CAAC;AAAA,IAC5F,OAAQ,OAAO,KAAK,IAAwC,WAAW;AAAA,IACvE,MAAM;AAAA,IACN,OAAO;AAAA;AAAA;;;AC3LX;AAKO,SAAS,aAAa,CAAC,QAAyB;AAAA,EACrD,OAAO,GAAG,SAAS,GAAG,YAAY,KAAK,MAAM,WAAW,EAAE;AAAA;AA+B5D,SAAS,iBAAiB,CAAC,OAAyB;AAAA,EAClD,IAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AAAA,IACvC,OAAO;AAAA,EACT;AAAA,EACA,IAAI,UAAU,SAAS,MAAM,SAAS,SAAS;AAAA,IAC7C,OAAO;AAAA,EACT;AAAA,EACA,MAAM,QAAQ,WAAW,QAAQ,MAAM,QAAQ;AAAA,EAC/C,OAAO,QAAQ,SAAS,OAAO,UAAU,YAAY,UAAU,SAAS,MAAM,SAAS,OAAO;AAAA;AAGhG,SAAS,mBAAmB,CAAC,KAAkC;AAAA,EAC7D,OAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,WAAW,IAAI,KAAK,IAAI,UAAU;AAAA,IAClC,WAAW,IAAI,KAAK,IAAI,UAAU;AAAA,IAClC,YAAY,IAAI;AAAA,IAChB,YAAY,IAAI;AAAA,IAChB,QAAQ,IAAI;AAAA,IACZ,OAAO,OAAO,IAAI,UAAU,WAAW,KAAK,MAAM,IAAI,KAAK,IAAI,IAAI;AAAA,IACnE,QACE,OAAO,IAAI,WAAW,WAClB,IAAI,OAAO,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,OAAO,KAAK,EAAE,WAAW,GAAG,IACnE,KAAK,MAAM,IAAI,MAAM,IACrB,IAAI,SACL,IAAI,UAAU;AAAA,IACrB,OAAO,IAAI;AAAA,IACX,eAAe,IAAI;AAAA,IACnB,UAAU,OAAO,IAAI,aAAa,WAAW,KAAK,MAAM,IAAI,QAAQ,IAAI,IAAI;AAAA,IAC5E,UAAU,IAAI,YAAY,IAAI,KAAK,IAAI,SAAS,IAAI;AAAA,IACpD,WAAW,IAAI,aAAa,IAAI,KAAK,IAAI,UAAU,IAAI;AAAA,IACvD,aAAa,IAAI,eAAe,IAAI,KAAK,IAAI,YAAY,IAAI;AAAA,IAC7D,WAAW,IAAI,aAAa,IAAI,KAAK,IAAI,UAAU,IAAI;AAAA,IACvD,YAAY,IAAI;AAAA,IAChB,YAAY,IAAI;AAAA,IAChB,UAAU,IAAI;AAAA,IACd,OAAO,IAAI;AAAA,IACX,gBAAgB,IAAI;AAAA,IACpB,aAAa,IAAI;AAAA,IACjB,cAAc,IAAI;AAAA,IAClB,kBAAkB,IAAI;AAAA,IACtB,aAAa,IAAI,eAAe,IAAI,KAAK,IAAI,YAAY,IAAI;AAAA,IAC7D,WAAW,QAAQ,IAAI,SAAS;AAAA,EAClC;AAAA;AAGF,eAAsB,iBAAiB;AAAA,EAEnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,GAiBd,IACiD;AAAA,EACjD,MAAM,QAAQ,cAAc,KAAK;AAAA,EACjC,MAAM,MAAM,IAAI;AAAA,EAEhB,IAAI,WAAW;AAAA,IACb,MAAM,SAAS,MAAM,sBAAsB,YAAY,EAAE;AAAA,IACzD,IAAI,QAAQ;AAAA,MACV,MAAM,IAAI,2BAA2B,YAAY,OAAO,EAAE;AAAA,IAC5D;AAAA,EACF;AAAA,EAEA,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,SAAU,MAAM,GAAG,WACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAwBA;AAAA,MACE;AAAA,MACA,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA,KAAK,UAAU,KAAK;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,kBAAkB;AAAA,MAClB,eAAe;AAAA,MACf,gBAAgB;AAAA,MAChB,oBAAoB;AAAA,MACpB,eAAe;AAAA,MACf;AAAA,IACF,CACF;AAAA,IACA,OAAO,OAAO;AAAA,IACd,IAAI,aAAa,kBAAkB,KAAK,GAAG;AAAA,MACzC,MAAM,SAAS,MAAM,sBAAsB,YAAY,EAAE;AAAA,MACzD,MAAM,IAAI,2BAA2B,YAAY,QAAQ,EAAE;AAAA,IAC7D;AAAA,IACA,MAAM;AAAA;AAAA,EAGR,IAAI,OAAO,KAAK,IAAI;AAAA,IAClB,OAAO,EAAE,KAAK,oBAAoB,OAAO,KAAK,EAAE,GAAG,SAAS,KAAK;AAAA,EACnE;AAAA,EAGA,MAAM,WAAW,MAAM,GAAG,WAAW,0DAA0D;AAAA,IAC7F;AAAA,EACF,CAAC;AAAA,EAED,IAAI,CAAC,SAAS,KAAK,IAAI;AAAA,IACrB,MAAM,IAAI,MAAM,yDAAyD,iBAAiB;AAAA,EAC5F;AAAA,EAEA,OAAO,EAAE,KAAK,oBAAoB,SAAS,KAAK,EAAE,GAAG,SAAS,MAAM;AAAA;AAGtE,eAAsB,qBAAqB,CACzC,YACA,IAC6B;AAAA,EAC7B,MAAM,SAAS,MAAM,GAAG,WACtB;AAAA;AAAA;AAAA;AAAA,eAKA,CAAC,UAAU,CACb;AAAA,EAEA,OAAO,OAAO,KAAK,KAAK,oBAAoB,OAAO,KAAK,EAAoB,IAAI;AAAA;AAGlF,eAAsB,4BAA4B,GAC9C,YAAY,eACd,IACe;AAAA,EACf,MAAM,SAAS,MAAM,sBAAsB,YAAY,EAAE;AAAA,EACzD,IAAI,UAAU,OAAO,OAAO,aAAa;AAAA,IACvC,MAAM,IAAI,2BAA2B,YAAY,OAAO,EAAE;AAAA,EAC5D;AAAA;AAGF,eAAsB,cAAc;AAAA,EAEhC;AAAA,EACA;AAAA,KAKA,gBAAgB,OAAO,MACI;AAAA,EAC7B,MAAM,aAAa,gBAAgB,eAAe;AAAA,EAElD,MAAM,SAAS,aACX,MAAM,GAAG,WACP;AAAA;AAAA,UAEE,cACF,CAAC,OAAO,UAAU,CACpB,IACA,MAAM,GAAG,WACP;AAAA;AAAA,UAEE,cACF,CAAC,KAAK,CACR;AAAA,EAEJ,MAAM,MAAM,OAAO,KAAK;AAAA,EAExB,IAAI,CAAC,KAAK;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,oBAAoB,GAAG;AAAA;AAGhC,eAAsB,kBAAkB;AAAA,EAEpC;AAAA,EACA;AAAA,GAKF,IAC6B;AAAA,EAC7B,MAAM,SAAS,aACX,MAAM,GAAG,WACP;AAAA;AAAA;AAAA,mBAIA,CAAC,YAAY,UAAU,CACzB,IACA,MAAM,GAAG,WACP;AAAA;AAAA;AAAA,mBAIA,CAAC,UAAU,CACb;AAAA,EAEJ,MAAM,MAAM,OAAO,KAAK;AAAA,EACxB,IAAI,CAAC,KAAK;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,OAAO,oBAAoB,GAAG;AAAA;AAGhC,eAAsB,iBAAiB;AAAA,EAEnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,GAOF,IAC6B;AAAA,EAC7B,MAAM,MAAM,IAAI;AAAA,EAEhB,MAAM,UAAoB,CAAC,iBAAiB;AAAA,EAC5C,MAAM,SAAuD,CAAC,GAAG;AAAA,EACjE,IAAI,aAAa;AAAA,EAEjB,IAAI,KAAK,WAAW,WAAW;AAAA,IAC7B,QAAQ,KAAK,aAAa,YAAY;AAAA,IACtC,OAAO,KAAK,KAAK,MAAM;AAAA,IACvB;AAAA,EACF;AAAA,EACA,IAAI,KAAK,kBAAkB,WAAW;AAAA,IACpC,QAAQ,KAAK,sBAAsB,YAAY;AAAA,IAC/C,OAAO,KAAK,KAAK,aAAa;AAAA,IAC9B;AAAA,EACF;AAAA,EACA,IAAI,KAAK,aAAa,WAAW;AAAA,IAC/B,QAAQ,KAAK,eAAe,YAAY;AAAA,IACxC,OAAO,KAAK,KAAK,UAAU,KAAK,QAAQ,CAAC;AAAA,IACzC;AAAA,EACF;AAAA,EACA,IAAI,KAAK,aAAa,WAAW;AAAA,IAC/B,QAAQ,KAAK,gBAAgB,YAAY;AAAA,IACzC,OAAO,KAAK,KAAK,QAAQ;AAAA,IACzB;AAAA,EACF;AAAA,EACA,IAAI,KAAK,cAAc,WAAW;AAAA,IAChC,QAAQ,KAAK,iBAAiB,YAAY;AAAA,IAC1C,OAAO,KAAK,KAAK,SAAS;AAAA,IAC1B;AAAA,EACF;AAAA,EACA,IAAI,KAAK,gBAAgB,WAAW;AAAA,IAClC,QAAQ,KAAK,mBAAmB,YAAY;AAAA,IAC5C,OAAO,KAAK,KAAK,WAAW;AAAA,IAC5B;AAAA,EACF;AAAA,EACA,IAAI,KAAK,WAAW,WAAW;AAAA,IAC7B,QAAQ,KAAK,aAAa,YAAY;AAAA,IACtC,OAAO,KAAK,KAAK,UAAU,KAAK,MAAM,CAAC;AAAA,IACvC;AAAA,EACF;AAAA,EACA,IAAI,KAAK,UAAU,WAAW;AAAA,IAC5B,QAAQ,KAAK,YAAY,YAAY;AAAA,IACrC,OAAO,KAAK,KAAK,KAAK;AAAA,IACtB;AAAA,EACF;AAAA,EACA,IAAI,KAAK,eAAe,WAAW;AAAA,IACjC,QAAQ,KAAK,kBAAkB,YAAY;AAAA,IAC3C,OAAO,KAAK,KAAK,UAAU;AAAA,IAC3B;AAAA,EACF;AAAA,EACA,IAAI,KAAK,UAAU,WAAW;AAAA,IAC5B,QAAQ,KAAK,aAAa,YAAY;AAAA,IACtC,OAAO,KAAK,KAAK,KAAK;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,OAAO,KAAK,KAAK;AAAA,EACjB,MAAM,UAAU;AAAA,EAChB;AAAA,EAEA,IAAI,YAAY;AAAA,IACd,OAAO,KAAK,UAAU;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,IAAI,oBAAoB,iBAAiB,SAAS,GAAG;AAAA,IACnD,OAAO,KAAK,gBAAgB;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,IAAI,cAAc,aACd,eAAe,8BAA8B,UAAU,MACvD,eAAe;AAAA,EAEnB,IAAI,oBAAoB,iBAAiB,SAAS,GAAG;AAAA,IACnD,eAAe,sBAAsB,aAAa;AAAA,EACpD;AAAA,EAEA,MAAM,QAAQ;AAAA;AAAA,UAEN,QAAQ,KAAK,IAAI;AAAA,MACrB;AAAA;AAAA;AAAA,EAIJ,IAAI;AAAA,EACJ,IAAI;AAAA,IACF,SAAU,MAAM,GAAG,WAAW,OAAO,MAAM;AAAA,IAC3C,OAAO,OAAO;AAAA,IACd,IAAI,KAAK,WAAW,aAAa,kBAAkB,KAAK,GAAG;AAAA,MACzD,MAAM,IAAI,2BAA2B,WAAW,KAAK;AAAA,IACvD;AAAA,IACA,MAAM;AAAA;AAAA,EAER,MAAM,MAAM,OAAO,KAAK;AAAA,EAExB,IAAI,CAAC,KAAK;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,oBAAoB,GAAG;AAAA;AAGhC,eAAsB,eAAe;AAAA,EAEjC;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,GASF,IAOC;AAAA,EACD,MAAM,aAAuB,CAAC;AAAA,EAC9B,MAAM,SAAgD,CAAC;AAAA,EACvD,IAAI,aAAa;AAAA,EAEjB,IAAI,YAAY;AAAA,IACd,WAAW,KAAK,kBAAkB,YAAY;AAAA,IAC9C,OAAO,KAAK,UAAU;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,IAAI,YAAY,SAAS,SAAS,GAAG;AAAA,IACnC,WAAW,KAAK,iBAAiB,aAAa;AAAA,IAC9C,OAAO,KAAK,QAAQ;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,IAAI,YAAY;AAAA,IACd,WAAW,KAAK,kBAAkB,YAAY;AAAA,IAC9C,OAAO,KAAK,UAAU;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,CAAC,eAAe,YAAY,EAAE,OAAO,OAAO;AAAA,EAC9D,IAAI,UAAU,SAAS,GAAG;AAAA,IACxB,MAAM,eAAe,MAAM,GAAG,WAC5B,+DACA,CAAC,SAAS,CACZ;AAAA,IACA,MAAM,YAAY,IAAI;AAAA,IACtB,WAAW,OAAO,aAAa,MAAM;AAAA,MACnC,UAAU,IACR,IAAI,IACJ,OAAO,IAAI,eAAe,WAAW,IAAI,KAAK,IAAI,UAAU,IAAI,IAAI,UACtE;AAAA,IACF;AAAA,IAEA,IAAI,eAAe;AAAA,MACjB,MAAM,SAAS,UAAU,IAAI,aAAa;AAAA,MAC1C,IAAI,QAAQ;AAAA,QACV,WAAW,KAAK,iBAAiB,YAAY;AAAA,QAC7C,OAAO,KAAK,MAAM;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,IAAI,cAAc;AAAA,MAChB,MAAM,SAAS,UAAU,IAAI,YAAY;AAAA,MACzC,IAAI,QAAQ;AAAA,QACV,WAAW,KAAK,iBAAiB,YAAY;AAAA,QAC7C,OAAO,KAAK,MAAM;AAAA,QAClB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,WAAW,SAAS,IAAI,SAAS,WAAW,KAAK,OAAO,MAAM;AAAA,EAClF,MAAM,cAAc,KAAK,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI;AAAA,EAExD,MAAM,aAAa,CAAC,CAAC,gBAAgB,CAAC;AAAA,EAEtC,MAAM,QAAQ;AAAA;AAAA,MAEV;AAAA,0BACoB,aAAa,QAAQ;AAAA,aAClC;AAAA;AAAA,EAEX,OAAO,KAAK,WAAW;AAAA,EAEvB,MAAM,SAAS,MAAM,GAAG,WAAW,OAAO,MAAM;AAAA,EAChD,MAAM,OAAO,OAAO;AAAA,EAEpB,MAAM,cAAc,KAAK,UAAU,SAAS;AAAA,EAC5C,MAAM,WAAW,cAAc,KAAK,MAAM,GAAG,KAAK,IAAI;AAAA,EAEtD,IAAI,YAAY;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AAAA,EAEA,MAAM,QAAQ,SAAS,IAAI,CAAC,QAAQ,oBAAoB,GAAG,CAAC;AAAA,EAE5D,MAAM,UAAU,aAAa,MAAM,SAAS,IAAI;AAAA,EAChD,MAAM,UAAU,aAAa,cAAc,CAAC,CAAC,iBAAiB,MAAM,SAAS;AAAA,EAE7E,MAAM,aAAa,WAAW,MAAM,SAAS,IAAK,MAAM,MAAM,SAAS,IAAI,MAAM,OAAQ;AAAA,EACzF,MAAM,aAAa,WAAW,MAAM,SAAS,IAAK,MAAM,IAAI,MAAM,OAAQ;AAAA,EAE1E,OAAO,EAAE,OAAO,YAAY,YAAY,SAAS,QAAQ;AAAA;AAa3D,eAAsB,uBAA0B,CAC9C,IACA,UACA,MAMY;AAAA,EACZ,IAAI;AAAA,EACJ,IAAI;AAAA,EAEJ,IAAI,MAAM;AAAA,IACR,MAAM,SAAS,MAAM,KAAK,QAAQ;AAAA,IAClC,OAAO;AAAA,MACL,YAAY,CAAC,MAAc,WACzB,OAAO,MAAM,MAAM,MAAM;AAAA,IAC7B;AAAA,IACA,UAAU,MAAM,OAAO,QAAQ;AAAA,EACjC,EAAO;AAAA,IACL,OAAO;AAAA;AAAA,EAGT,IAAI;AAAA,IACF,MAAM,KAAK,WAAW,SAAS,CAAC,CAAC;AAAA,IACjC,MAAM,SAAS,MAAM,SAAS,IAAI;AAAA,IAClC,MAAM,KAAK,WAAW,UAAU,CAAC,CAAC;AAAA,IAClC,OAAO;AAAA,IACP,OAAO,OAAO;AAAA,IACd,MAAM,KAAK,WAAW,YAAY,CAAC,CAAC;AAAA,IACpC,MAAM;AAAA,YACN;AAAA,IACA,UAAU;AAAA;AAAA;;;AChjBP,IAAM,kBAAkB,EAAE,MAAM,KAAK,QAAQ,GAAG,KAAK,KAAK;AAIjE,SAAS,aAAa,CAAC,OAAiC;AAAA,EACtD,IAAI,OAAO,UAAU,UAAU;AAAA,IAC7B,IAAI,CAAC,OAAO,UAAU,KAAK,GAAG;AAAA,MAC5B,MAAM,IAAI,oBACR,oBAAoB,6CACtB;AAAA,IACF;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,gBAAgB;AAAA,EAC/B,IAAI,WAAW,WAAW;AAAA,IACxB,MAAM,IAAI,oBACR,qBAAqB,2BAA2B,OAAO,KAAK,eAAe,EACxE,IAAI,CAAC,MAAM,IAAI,IAAI,EACnB,KAAK,IAAI,kBACd;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AASF,SAAS,eAAe,IAAI,YAAsD;AAAA,EACvF,WAAW,aAAa,YAAY;AAAA,IAClC,IAAI,cAAc,WAAW;AAAA,MAC3B,OAAO,cAAc,SAAS;AAAA,IAChC;AAAA,EACF;AAAA,EACA,OAAO,gBAAgB;AAAA;;;AHPzB,IAAM,aAAa;AAwBnB,IAAM,gBAAgC;AAAA,EACpC,KAAK,CAAC,aAAqB,QAAQ,KAAK,QAAQ;AAAA,EAChD,OAAO,CAAC,SAAiB,UAAiB,QAAQ,MAAM,SAAS,KAAK;AACxE;AAEA,IAAM,yBAAyB,QAAQ,IAAI,iCACvC,OAAO,SAAS,QAAQ,IAAI,gCAAgC,EAAE,IAC9D,IAAI;AAAA;AAED,MAAM,eAAe;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ,WAAW;AAAA,EACX;AAAA,EAER,WAAW,GAAG,QAAQ,SAAS,qBAA4C;AAAA,IACzE,KAAK,SAAS,UAAU;AAAA,IAExB,IAAI,UAAU,qBAAqB,kBAAkB,MAAM;AAAA,MACzD,KAAK,OAAO,kBAAkB;AAAA,IAChC,EAAO,SAAI,sBAAsB,qBAAqB,kBAAkB,kBAAkB;AAAA,MACxF,KAAK,OAAO,IAAI,GAAG,KAAK,EAAE,kBAAkB,kBAAkB,iBAAiB,CAAC;AAAA,MAChF,KAAK,YAAY;AAAA,IACnB,EAAO;AAAA,MACL,MAAM,IAAI,oBAAoB,kDAAkD;AAAA;AAAA,IAGlF,MAAM,KAAS;AAAA,MACb,YAAY,CAAC,MAAc,WACzB,KAAK,KAAK,MAAM,MAAM,MAAM;AAAA,IAChC;AAAA,IAEA,KAAK,OAAO,QAAQ,IAAI,OAAO,EAAE,IAAI,QAAQ,sBAAsB,CAAC;AAAA,IAEpE,KAAK,KAAK,GAAG,SAAS,CAAC,UAAU;AAAA,MAC/B,KAAK,OAAO,MAAM,iBAAiB,KAAK;AAAA,KACzC;AAAA,IACD,KAAK,KAAK;AAAA;AAAA,OAGN,MAAK,GAAkB;AAAA,IAC3B,IAAI,KAAK,UAAU;AAAA,MACjB;AAAA,IACF;AAAA,IAEA,MAAM,KAAK,KAAK,MAAM;AAAA,IACtB,KAAK,KAAK,KAAK,KAAK,MAAM;AAAA,IAC1B,MAAM,cAAc,KAAK,EAAE;AAAA,IAC3B,MAAM,KAAK,KAAK,YAAY,uBAAuB;AAAA,IAEnD,KAAK,WAAW;AAAA,IAChB,KAAK,OAAO,IAAI,GAAG,2BAA2B;AAAA;AAAA,OAG1C,KAAI,GAAkB;AAAA,IAC1B,MAAM,KAAK,KAAK,KAAK;AAAA,IAErB,IAAI,KAAK,WAAW;AAAA,MAClB,MAAM,KAAK,KAAK,IAAI;AAAA,IACtB;AAAA,IAEA,KAAK,WAAW;AAAA,IAChB,KAAK,OAAO,IAAI,GAAG,2BAA2B;AAAA;AAAA,OAiB1C,cAA6C,CACjD,aASA,UACA,YACsB;AAAA,IACtB,MAAM,KAAK,cAAc;AAAA,IAEzB,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI,YAAY;AAAA,IAEhB,IAAI,OAAO,gBAAgB,cAAc,QAAQ,aAAa;AAAA,MAC5D,MAAM,MAAM;AAAA,MACZ,aAAa,IAAI;AAAA,MACjB,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,aAAa,YAAY;AAAA,MACzB,iBAAiB,YAAY;AAAA,MAC7B,YAAY,YAAY,aAAa,IAAI,cAAc;AAAA,MAEvD,IAAI,IAAI,aAAa;AAAA,QACnB,MAAM,SAAS,MAAM,IAAI,YAAY,aAAa,SAAS,KAAK;AAAA,QAChE,IAAI,OAAO,QAAQ;AAAA,UACjB,MAAM,IAAI,oBACR,KAAK,UAAU,OAAO,MAAM,GAC5B,YACA,WACA,WACA,OAAO,MACT;AAAA,QACF;AAAA,MACF;AAAA,IACF,EAAO;AAAA,MACL,MAAM,SAAS;AAAA,MAOf,aAAa,OAAO;AAAA,MACpB,QAAQ,OAAO;AAAA,MACf,aAAa,OAAO;AAAA,MACpB,iBAAiB,OAAO;AAAA,MACxB,UAAU,OAAO;AAAA,MACjB,YAAY,OAAO,SAAS,cAAc;AAAA;AAAA,IAG5C,mBAAmB,UAAU;AAAA,IAC7B,mBAAmB,UAAU;AAAA,IAE7B,MAAM,MAAM,MAAM,wBAChB,KAAK,IACL,OAAO,QAAQ;AAAA,MACb,MAAM,YAAY,SAAS,UAAU,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,OAAO,IAAI;AAAA,MAE9E,QAAQ,KAAK,aAAa,YAAY,MAAM,kBAC1C;AAAA,QACE;AAAA,QACA;AAAA,QACA,eAAe;AAAA,QACf;AAAA,QACA;AAAA,QACA,YAAY,SAAS,WAAW;AAAA,QAChC,UAAU,gBAAgB,SAAS,QAAQ;AAAA,QAC3C;AAAA,QACA;AAAA,QACA;AAAA,MACF,GACA,GACF;AAAA,MAEA,IAAI,SAAS;AAAA,QACX,MAAM,MAAgC;AAAA,UACpC,OAAO,YAAY;AAAA,UACnB;AAAA,UACA;AAAA,UACA;AAAA,QACF;AAAA,QAMA,MAAM,KAAK,KAAK,KAAK,yBAAyB,KAAK;AAAA,UACjD,YAAY,IAAI;AAAA,UAChB,iBAAiB,SAAS,mBAAmB;AAAA,UAC7C,UAAU,YAAY;AAAA,UACtB,IAAI;AAAA,QACN,CAAC;AAAA,MACH;AAAA,MAEA,OAAO;AAAA,OAET,KAAK,IACP;AAAA,IAEA,KAAK,OAAO,IAAI,GAAG,mCAAmC,IAAI,UAAU,YAAY;AAAA,IAEhF,OAAO;AAAA;AAAA,OAGH,aAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,KAOuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,MAAM,MAAM,KAAK,OAAO,EAAE,OAAO,WAAW,CAAC;AAAA,IAEnD,IAAI,IAAI,WAAW;AAAA,MACjB,MAAM,6BACJ,EAAE,YAAY,IAAI,YAAY,aAAa,IAAI,GAAG,GAClD,KAAK,EACP;AAAA,IACF;AAAA,IAEA,MAAM,MAAgC;AAAA,MACpC,OAAO,IAAI;AAAA,MACX,YAAY,cAAc,IAAI,cAAc;AAAA,MAC5C,YAAY,IAAI;AAAA,MAChB,OAAO,IAAI;AAAA,MACX,OAAO;AAAA,QACL,MAAM;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,KAAK,KAAK,KAAK,yBAAyB,KAAK;AAAA,MACjD,iBAAiB,SAAS,mBAAmB;AAAA,MAC7C,UAAU,IAAI;AAAA,IAChB,CAAC;AAAA,IAED,KAAK,OAAO,IAAI,GAAG,oBAAoB,mCAAmC,OAAO;AAAA,IACjF,OAAO;AAAA;AAAA,OAGH,cAAa;AAAA,IACjB;AAAA,IACA;AAAA,KAIuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,MAAM,MAAM,kBAChB;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ;AAAA,QACA,UAAU,IAAI;AAAA,MAChB;AAAA,MACA,kBAAkB,iDAA+C;AAAA,IACnE,GACA,KAAK,EACP;AAAA,IAEA,IAAI,CAAC,KAAK;AAAA,MACR,MAAM,IAAI,yBAAyB,KAAK;AAAA,IAC1C;AAAA,IAEA,KAAK,OAAO,IAAI,GAAG,kCAAkC,OAAO;AAAA,IAC5D,OAAO;AAAA;AAAA,OAGH,eAAc;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,KAKuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,UAAU,MAAM,KAAK,OAAO,EAAE,OAAO,WAAW,CAAC;AAAA,IACvD,IAAI,QAAQ,kCAAkC;AAAA,MAC5C,MAAM,IAAI,oBACR,kCAAkC,QAAQ,oCAC1C,QAAQ,YACR,KACF;AAAA,IACF;AAAA,IAEA,MAAM,gBAAgB,QAAQ;AAAA,IAC9B,MAAM,2BACJ,QAAQ,SAAS,+BAA+B,aAAa;AAAA,IAC/D,IAAI,mCAAmC,wBAAwB,GAAG;AAAA,MAChE,OAAO;AAAA,IACT;AAAA,IAEA,OAAO,KAAK,aAAa;AAAA,MACvB;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,MAAM,CAAC;AAAA,MACP;AAAA,IACF,CAAC;AAAA;AAAA,OAGG,oBAAmB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,KAKuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,MAAM,MAAM,KAAK,OAAO,EAAE,OAAO,WAAW,CAAC;AAAA,IAEnD,IAAI,IAAI,kCAAkC;AAAA,MACxC,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,gBAAgB,IAAI;AAAA,IAC1B,MAAM,2BAA2B,IAAI,SAAS,+BAA+B,aAAa;AAAA,IAC1F,IAAI,mCAAmC,wBAAwB,GAAG;AAAA,MAChE,OAAO;AAAA,IACT;AAAA,IAEA,MAAM,eAAe,IAAI,SAAS,mBAAmB,aAAa;AAAA,IAClE,IAAI,CAAC,gBAAgB,OAAO,iBAAiB,YAAY,EAAE,aAAa,eAAe;AAAA,MACrF,OAAO;AAAA,IACT;AAAA,IAEA,QAAQ,WAAW,cAAc,eAC/B,aACA;AAAA,IAGF,IAAI,cAAc,kBAAkB;AAAA,MAClC,OAAO,KAAK,eAAe,EAAE,OAAO,WAAW,CAAC;AAAA,IAClD;AAAA,IAGA,IAAI,cAAc,cAAc;AAAA,MAC9B,MAAM,wBACJ,KAAK,IACL,OAAO,OAAO;AAAA,QACZ,MAAM,WAAW,MAAM,eAAe,EAAE,OAAO,WAAW,GAAG,EAAE,eAAe,MAAM,GAAG,CAAC;AAAA,QACxF,IAAI,CAAC;AAAA,UAAU,MAAM,IAAI,yBAAyB,KAAK;AAAA,QACvD,OAAO,kBACL;AAAA,UACE;AAAA,UACA;AAAA,UACA,MAAM;AAAA,YACJ,UAAU,MAAM,SAAS,UAAU;AAAA,eAChC,gBAAgB;AAAA,gBACf,QAAQ,QAAQ,CAAC;AAAA,gBACjB,WAAW,IAAI;AAAA,cACjB;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF,GACA,EACF;AAAA,SAEF,KAAK,IACP;AAAA,MAEA,OAAO,KAAK,aAAa,EAAE,OAAO,YAAY,WAAW,aAAa,CAAC;AAAA,IACzE;AAAA,IAGA,IAAI,WAAW;AAAA,MACb,OAAO,KAAK,aAAa,EAAE,OAAO,YAAY,WAAW,MAAM,QAAQ,CAAC,EAAE,CAAC;AAAA,IAC7E;AAAA,IAGA,IAAI,cAAc;AAAA,MAChB,OAAO,KAAK,aAAa,EAAE,OAAO,YAAY,WAAW,cAAc,MAAM,QAAQ,CAAC,EAAE,CAAC;AAAA,IAC3F;AAAA,IAEA,OAAO;AAAA;AAAA,OAGH,eAAc;AAAA,IAClB;AAAA,IACA;AAAA,KAIuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,MAAM,MAAM,kBAChB;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ;AAAA,MACF;AAAA,MACA,kBAAkB,wEAAsE;AAAA,IAC1F,GACA,KAAK,EACP;AAAA,IAEA,IAAI,CAAC,KAAK;AAAA,MACR,MAAM,IAAI,yBAAyB,KAAK;AAAA,IAC1C;AAAA,IAEA,KAAK,OAAO,IAAI,GAAG,qCAAqC,OAAO;AAAA,IAC/D,OAAO;AAAA;AAAA,OAGH,OAAM;AAAA,IACV;AAAA,IACA;AAAA,KAIuB;AAAA,IACvB,MAAM,KAAK,cAAc;AAAA,IAEzB,MAAM,MAAM,MAAM,eAAe,EAAE,OAAO,WAAW,GAAG,EAAE,IAAI,KAAK,GAAG,CAAC;AAAA,IAEvE,IAAI,CAAC,KAAK;AAAA,MACR,MAAM,IAAI,yBAAyB,KAAK;AAAA,IAC1C;AAAA,IAEA,OAAO;AAAA;AAAA,OAGH,cAAa;AAAA,IACjB;AAAA,IACA;AAAA,KAI+B;AAAA,IAC/B,MAAM,MAAM,MAAM,KAAK,OAAO,EAAE,OAAO,WAAW,CAAC;AAAA,IAEnD,MAAM,iBAAiB,OAAO,OAAO,IAAI,QAAQ,EAAE,OACjD,CAAC,UACC,OAAO,UAAU,YACjB,UAAU,SACV,YAAY,UACZ,MAAM,WAAW,SACrB,EAAE;AAAA,IAIF,MAAM,aAAa,IAAI,yCAAsC,iBAAiB;AAAA,IAC9E,MAAM,uBACJ,IAAI,yCACA,MACA,IAAI,oCAAoC,IAAI,yCAC1C,IACA;AAAA,IAER,OAAO;AAAA,SACF;AAAA,MACH;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA;AAAA,OAGI,QAAO;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,KAcC;AAAA,IACD,MAAM,KAAK,cAAc;AAAA,IAEzB,IAAI;AAAA,MAAY,mBAAmB,UAAU;AAAA,IAC7C,mBAAmB,UAAU;AAAA,IAE7B,OAAO,gBACL;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,GACA,KAAK,EACP;AAAA;AAAA,OAGY,cAAa,GAAkB;AAAA,IAC3C,IAAI,CAAC,KAAK,UAAU;AAAA,MAClB,MAAM,KAAK,MAAM;AAAA,IACnB;AAAA;AAEJ;;;AI5iBO,SAAS,iBAGf,CACC,IACA,SAC8B;AAAA,EAC9B,MAAM,MAAO,CACX,SACA,mBACgC;AAAA,IAChC;AAAA,IACA;AAAA,IAGA,aAAa,SAAS;AAAA,IACtB,SAAS,eAAe;AAAA,IACxB,SAAS,eAAe;AAAA,IACxB,UAAU,eAAe;AAAA,IACzB,WAAW,eAAe,aAAa,SAAS;AAAA,IAChD,UAAU,eAAe;AAAA,IACzB,UAAU,eAAe;AAAA,EAC3B;AAAA,EAEA,OAAO,eAAe,KAAK,MAAM,EAAE,OAAO,IAAI,YAAY,KAAK,CAAC;AAAA,EAChE,OAAO,eAAe,KAAK,eAAe;AAAA,IACxC,OAAO,SAAS;AAAA,IAChB,YAAY;AAAA,EACd,CAAC;AAAA,EACD,OAAO,eAAe,KAAK,aAAa;AAAA,IACtC,OAAO,SAAS;AAAA,IAChB,YAAY;AAAA,EACd,CAAC;AAAA,EAED,OAAO;AAAA;AAGT,SAAS,qBAAuD,CAC9D,UAAkD,CAAC,GACxB;AAAA,EAC3B,MAAM,UAAW,CACf,IACA;AAAA,IAEE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACsB,CAAC,OACE;AAAA,IAC3B;AAAA,IACA;AAAA,IAGA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,QAAQ,SAAS,IAAK,UAA+B;AAAA,EAChE;AAAA,EAEA,QAAQ,MAAM,CACZ,WAEA,sBAA0C;AAAA,IACxC,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAAA,EAEH,QAAQ,MAAM;AAAA,EAEd,OAAO;AAAA;AAGF,IAAM,WAA4B,sBAAsB;",
+  "debugId": "779362C94AF314E764756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "pg-workflows",
   "description": "The simplest Postgres workflow engine for TypeScript - durable execution, event-driven orchestration, and automatic retries powered entirely by PostgreSQL",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
   "files": [
     "dist"
   ],
@@ -34,9 +37,12 @@
   },
   "scripts": {
     "build": "bunup",
+    "build:ui": "bun run --filter '@pg-workflows/ui' build",
     "dev": "bunup --watch",
-    "test": "bun run test:unit && bun run test:integration",
+    "test": "bun run test:unit && bun run test:ui && bun run test:integration",
     "test:unit": "vitest --typecheck run --config src/vitest.unit.config.ts ",
+    "test:ui": "bun run --filter '@pg-workflows/ui' test",
+    "check-types:ui": "bun run --filter '@pg-workflows/ui' check-types",
     "test:integration": "vitest run --config src/vitest.integration.config.ts",
     "test:watch": "vitest watch --config src/vitest.unit.config.ts",
     "lint": "biome check .",
@@ -82,7 +88,7 @@
     "es-toolkit": "^1.44.0",
     "ksuid": "^3.0.0",
     "parse-duration": "^2.1.5",
-    "pg-boss": "^12.16.0",
+    "pg-boss": "^12.29.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {