pg-workflows 0.14.0 → 0.15.0

package/dist/index.cjs

@@ -69,6 +69,7 @@ __export(exports_src, {
   createWorkflowRef: () => createWorkflowRef,
   WorkflowStatus: () => WorkflowStatus,
   WorkflowRunNotFoundError: () => WorkflowRunNotFoundError,
+  WorkflowRunInProgressError: () => WorkflowRunInProgressError,
   WorkflowEngineError: () => WorkflowEngineError,
   WorkflowEngine: () => WorkflowEngine,
   WorkflowClient: () => WorkflowClient
@@ -97,7 +98,7 @@ var isInvokeChildWorkflowTimelineEntry = (entry) => !!entry && typeof entry ===
 
 // 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;
@@ -176,6 +177,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 {
@@ -215,9 +224,65 @@ async function getCurrentVersion(db) {
 
 // src/db/queries.ts
 var import_ksuid = __toESM(require("ksuid"));
+
+// src/error.ts
+function validateWorkflowId(workflowId) {
+  if (workflowId.length > MAX_WORKFLOW_ID_LENGTH) {
+    throw new WorkflowEngineError(`workflowId exceeds maximum length of ${MAX_WORKFLOW_ID_LENGTH} characters (got ${workflowId.length})`, workflowId);
+  }
+}
+function validateResourceId(resourceId) {
+  if (resourceId != null && resourceId.length > MAX_RESOURCE_ID_LENGTH) {
+    throw new WorkflowEngineError(`resourceId exceeds maximum length of ${MAX_RESOURCE_ID_LENGTH} characters (got ${resourceId.length})`);
+  }
+}
+
+class WorkflowEngineError extends Error {
+  workflowId;
+  runId;
+  cause;
+  issues;
+  constructor(message, workflowId, runId, cause = undefined, issues) {
+    super(message);
+    this.workflowId = workflowId;
+    this.runId = runId;
+    this.cause = cause;
+    this.issues = issues;
+    this.name = "WorkflowEngineError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, WorkflowEngineError);
+    }
+  }
+}
+
+class WorkflowRunNotFoundError extends WorkflowEngineError {
+  constructor(runId, workflowId) {
+    super("Workflow run not found", workflowId, runId);
+    this.name = "WorkflowRunNotFoundError";
+  }
+}
+
+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/db/queries.ts
 function generateKSUID(prefix) {
   return `${prefix ? `${prefix}_` : ""}${import_ksuid.default.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,
@@ -243,7 +308,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({
@@ -259,11 +325,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,
@@ -281,30 +356,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 };
   }
@@ -316,6 +400,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
@@ -430,7 +528,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;
@@ -536,43 +642,6 @@ async function withPostgresTransaction(db, callback, pool) {
   }
 }
 
-// src/error.ts
-function validateWorkflowId(workflowId) {
-  if (workflowId.length > MAX_WORKFLOW_ID_LENGTH) {
-    throw new WorkflowEngineError(`workflowId exceeds maximum length of ${MAX_WORKFLOW_ID_LENGTH} characters (got ${workflowId.length})`, workflowId);
-  }
-}
-function validateResourceId(resourceId) {
-  if (resourceId != null && resourceId.length > MAX_RESOURCE_ID_LENGTH) {
-    throw new WorkflowEngineError(`resourceId exceeds maximum length of ${MAX_RESOURCE_ID_LENGTH} characters (got ${resourceId.length})`);
-  }
-}
-
-class WorkflowEngineError extends Error {
-  workflowId;
-  runId;
-  cause;
-  issues;
-  constructor(message, workflowId, runId, cause = undefined, issues) {
-    super(message);
-    this.workflowId = workflowId;
-    this.runId = runId;
-    this.cause = cause;
-    this.issues = issues;
-    this.name = "WorkflowEngineError";
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, WorkflowEngineError);
-    }
-  }
-}
-
-class WorkflowRunNotFoundError extends WorkflowEngineError {
-  constructor(runId, workflowId) {
-    super("Workflow run not found", workflowId, runId);
-    this.name = "WorkflowRunNotFoundError";
-  }
-}
-
 // src/priority.ts
 var PRIORITY_LEVELS = { high: 100, normal: 0, low: -100 };
 function priorityToInt(value) {
@@ -647,11 +716,10 @@ class WorkflowClient {
     const db = {
       executeSql: (text, values) => this.pool.query(text, values)
     };
-    if (boss) {
-      this.boss = boss;
-    } else {
-      this.boss = new import_pg_boss.PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
-    }
+    this.boss = boss ?? new import_pg_boss.PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
+    this.boss.on("error", (error) => {
+      this.logger.error("pg-boss error", error);
+    });
     this.db = db;
   }
   async start() {
@@ -680,6 +748,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;
@@ -687,6 +756,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) {
@@ -700,6 +770,7 @@ class WorkflowClient {
       resourceId = params.resourceId;
       idempotencyKey = params.idempotencyKey;
       options = params.options;
+      singleton = params.options?.singleton === true;
     }
     validateWorkflowId(workflowId);
     validateResourceId(resourceId);
@@ -714,7 +785,8 @@ class WorkflowClient {
         maxRetries: options?.retries ?? 0,
         priority: resolvePriority(options?.priority),
         timeoutAt,
-        idempotencyKey
+        idempotencyKey,
+        singleton
       }, _db);
       if (created) {
         const job = {
@@ -744,6 +816,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,
@@ -936,6 +1011,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
   });
@@ -944,16 +1020,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
@@ -1166,11 +1255,10 @@ class WorkflowEngine {
     const db = {
       executeSql: (text, values) => this.pool.query(text, values)
     };
-    if (boss) {
-      this.boss = boss;
-    } else {
-      this.boss = new import_pg_boss2.PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
-    }
+    this.boss = boss ?? new import_pg_boss2.PgBoss({ db, schema: DEFAULT_PGBOSS_SCHEMA });
+    this.boss.on("error", (error) => {
+      this.logger.error("pg-boss error", error);
+    });
     this.db = this.boss.getDb();
   }
   async start(asEngine = true, {
@@ -1224,6 +1312,10 @@ class WorkflowEngine {
       try {
         await this.createWorkflowRun({ workflowId, input: {}, scheduledAt });
       } catch (error) {
+        if (error instanceof WorkflowRunInProgressError) {
+          this.logger.log(`Skipping schedule fire for "${workflowId}": a run is already in progress`, { workflowId, runId: error.runId });
+          return;
+        }
         this.logger.error(`Schedule fire failed to start a run for workflow "${workflowId}"`, error instanceof Error ? error : new Error(String(error)), { workflowId });
         throw error;
       }
@@ -1373,7 +1465,8 @@ class WorkflowEngine {
       parentRunId,
       parentStepId,
       parentResourceId,
-      scheduledAt
+      scheduledAt,
+      singleton: workflow2.singleton === true || options?.singleton === true
     }, targetDb);
     const insertAndEnqueue = async (targetDb) => {
       const result = await insertRun(targetDb);
@@ -1532,6 +1625,9 @@ class WorkflowEngine {
   }) {
     await this.checkIfHasStarted();
     const run = await this.getRun({ runId, resourceId });
+    if (run.singleton) {
+      await assertSingletonSlotAvailable({ workflowId: run.workflowId, exceptRunId: run.id }, this.db);
+    }
     const jobResourceId = resourceId ?? run.resourceId ?? undefined;
     const job = {
       runId: run.id,
@@ -2501,5 +2597,5 @@ function otelPlugin(options = {}) {
   };
 }
 
-//# debugId=5FA47CDFF028114064756E2164756E21
+//# debugId=0BBC9686D69E329D64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.d.cts

@@ -20,6 +20,13 @@ type WorkflowRun = {
 	maxRetries: number;
 	/** Resolved scheduling priority (pg-boss integer; higher runs first). */
 	priority: number;
+	/**
+	* When true, this run participates in the per-workflow-ID uniqueness
+	* constraint: no other pending or running singleton run of the same
+	* workflow ID may exist at the same time. Paused, completed, failed, and
+	* cancelled runs release the slot.
+	*/
+	singleton: boolean;
 	jobId: string | null;
 	idempotencyKey: string | null;
 	parentRunId: string | null;
@@ -76,6 +83,12 @@ type StartWorkflowOptions = {
 	expireInSeconds?: number;
 	idempotencyKey?: string;
 	priority?: WorkflowPriority;
+	/**
+	* Client-side counterpart of `workflow(..., { singleton: true })`.
+	* The engine reads this from the registered definition; pass it here when
+	* starting from `WorkflowClient` so the uniqueness constraint applies.
+	*/
+	singleton?: boolean;
 };
 type WorkflowOptions<I extends InputParameters> = {
 	timeout?: number;
@@ -83,6 +96,12 @@ type WorkflowOptions<I extends InputParameters> = {
 	inputSchema?: I;
 	priority?: WorkflowPriority;
 	/**
+	* When true, at most one pending or running run of this workflow ID may exist.
+	* A second `startWorkflow` throws `WorkflowRunInProgressError` until the
+	* current run pauses, completes, fails, or is cancelled.
+	*/
+	singleton?: boolean;
+	/**
 	* Recurring schedule. Accepts a cron expression (`'0 9 * * 1-5'`),
 	* a duration string (`'5m'`, `'1 hour'`), or a `DurationObject`.
 	*/
@@ -190,6 +209,7 @@ type WorkflowDefinition<TInput extends InputParameters = InputParameters> = {
 	timeout?: number;
 	retries?: number;
 	priority?: WorkflowPriority;
+	singleton?: boolean;
 	schedule?: Schedule;
 	timezone?: string;
 	plugins?: WorkflowPlugin[];
@@ -216,6 +236,7 @@ interface WorkflowFactory<TStepExt = object> {
 		TOutput = unknown
 	>(id: string, options?: {
 		inputSchema?: TInput;
+		singleton?: boolean;
 	}): WorkflowRef<TInput, TOutput>;
 }
 /**
@@ -232,6 +253,7 @@ interface WorkflowRef<
 	(handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>, options?: Omit<WorkflowOptions<TInput>, "inputSchema">): WorkflowDefinition<TInput>;
 	readonly id: string;
 	readonly inputSchema?: TInput;
+	readonly singleton?: boolean;
 }
 type WorkflowRunProgress = WorkflowRun & {
 	completionPercentage: number;
@@ -338,6 +360,7 @@ declare function createWorkflowRef<
 	TInput extends InputParameters = InputParameters
 >(id: string, options?: {
 	inputSchema?: TInput;
+	singleton?: boolean;
 }): WorkflowRef<TInput, TOutput>;
 declare const workflow: WorkflowFactory;
 import pg2 from "pg";
@@ -511,6 +534,9 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
+declare class WorkflowRunInProgressError extends WorkflowEngineError {
+	constructor(workflowId: string, runId?: string);
+}
 import { AttributeValue, Tracer } from "@opentelemetry/api";
 type OtelPluginOptions = {
 	/** Tracer to use. Defaults to `trace.getTracer('pg-workflows')`. */
@@ -521,4 +547,4 @@ type OtelPluginOptions = {
 	attributes?: (context: WorkflowContext) => Record<string, AttributeValue>;
 };
 declare function otelPlugin(options?: OtelPluginOptions): WorkflowPlugin<StepBaseContext, object>;
-export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPriority, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, ScheduleContext, Schedule, OtelPluginOptions, InputParameters, InferInputParameters, Duration };
+export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRunInProgressError, WorkflowRun, WorkflowRef, WorkflowPriority, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, ScheduleContext, Schedule, OtelPluginOptions, InputParameters, InferInputParameters, Duration };

package/dist/index.d.ts

@@ -20,6 +20,13 @@ type WorkflowRun = {
 	maxRetries: number;
 	/** Resolved scheduling priority (pg-boss integer; higher runs first). */
 	priority: number;
+	/**
+	* When true, this run participates in the per-workflow-ID uniqueness
+	* constraint: no other pending or running singleton run of the same
+	* workflow ID may exist at the same time. Paused, completed, failed, and
+	* cancelled runs release the slot.
+	*/
+	singleton: boolean;
 	jobId: string | null;
 	idempotencyKey: string | null;
 	parentRunId: string | null;
@@ -76,6 +83,12 @@ type StartWorkflowOptions = {
 	expireInSeconds?: number;
 	idempotencyKey?: string;
 	priority?: WorkflowPriority;
+	/**
+	* Client-side counterpart of `workflow(..., { singleton: true })`.
+	* The engine reads this from the registered definition; pass it here when
+	* starting from `WorkflowClient` so the uniqueness constraint applies.
+	*/
+	singleton?: boolean;
 };
 type WorkflowOptions<I extends InputParameters> = {
 	timeout?: number;
@@ -83,6 +96,12 @@ type WorkflowOptions<I extends InputParameters> = {
 	inputSchema?: I;
 	priority?: WorkflowPriority;
 	/**
+	* When true, at most one pending or running run of this workflow ID may exist.
+	* A second `startWorkflow` throws `WorkflowRunInProgressError` until the
+	* current run pauses, completes, fails, or is cancelled.
+	*/
+	singleton?: boolean;
+	/**
 	* Recurring schedule. Accepts a cron expression (`'0 9 * * 1-5'`),
 	* a duration string (`'5m'`, `'1 hour'`), or a `DurationObject`.
 	*/
@@ -190,6 +209,7 @@ type WorkflowDefinition<TInput extends InputParameters = InputParameters> = {
 	timeout?: number;
 	retries?: number;
 	priority?: WorkflowPriority;
+	singleton?: boolean;
 	schedule?: Schedule;
 	timezone?: string;
 	plugins?: WorkflowPlugin[];
@@ -216,6 +236,7 @@ interface WorkflowFactory<TStepExt = object> {
 		TOutput = unknown
 	>(id: string, options?: {
 		inputSchema?: TInput;
+		singleton?: boolean;
 	}): WorkflowRef<TInput, TOutput>;
 }
 /**
@@ -232,6 +253,7 @@ interface WorkflowRef<
 	(handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>, options?: Omit<WorkflowOptions<TInput>, "inputSchema">): WorkflowDefinition<TInput>;
 	readonly id: string;
 	readonly inputSchema?: TInput;
+	readonly singleton?: boolean;
 }
 type WorkflowRunProgress = WorkflowRun & {
 	completionPercentage: number;
@@ -338,6 +360,7 @@ declare function createWorkflowRef<
 	TInput extends InputParameters = InputParameters
 >(id: string, options?: {
 	inputSchema?: TInput;
+	singleton?: boolean;
 }): WorkflowRef<TInput, TOutput>;
 declare const workflow: WorkflowFactory;
 import pg2 from "pg";
@@ -511,6 +534,9 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
+declare class WorkflowRunInProgressError extends WorkflowEngineError {
+	constructor(workflowId: string, runId?: string);
+}
 import { AttributeValue, Tracer } from "@opentelemetry/api";
 type OtelPluginOptions = {
 	/** Tracer to use. Defaults to `trace.getTracer('pg-workflows')`. */
@@ -521,4 +547,4 @@ type OtelPluginOptions = {
 	attributes?: (context: WorkflowContext) => Record<string, AttributeValue>;
 };
 declare function otelPlugin(options?: OtelPluginOptions): WorkflowPlugin<StepBaseContext, object>;
-export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPriority, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, ScheduleContext, Schedule, OtelPluginOptions, InputParameters, InferInputParameters, Duration };
+export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRunInProgressError, WorkflowRun, WorkflowRef, WorkflowPriority, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, ScheduleContext, Schedule, OtelPluginOptions, InputParameters, InferInputParameters, Duration };

package/dist/index.js

@@ -6,8 +6,10 @@ import {
   WORKFLOW_RUN_QUEUE_NAME,
   WorkflowClient,
   WorkflowEngineError,
+  WorkflowRunInProgressError,
   WorkflowRunNotFoundError,
   WorkflowStatus,
+  assertSingletonSlotAvailable,
   createWorkflowRef,
   getWorkflowLastRun,
   getWorkflowRun,
@@ -24,7 +26,7 @@ import {
   waitForTimelineKey,
   withPostgresTransaction,
   workflow
-} from "./shared/chunk-w3qcrrwx.js";
+} from "./shared/chunk-n0f7hd40.js";
 // src/engine.ts
 import { merge } from "es-toolkit";
 import pg from "pg";
@@ -225,11 +227,10 @@ class WorkflowEngine {
     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 = this.boss.getDb();
   }
   async start(asEngine = true, {
@@ -283,6 +284,10 @@ class WorkflowEngine {
       try {
         await this.createWorkflowRun({ workflowId, input: {}, scheduledAt });
       } catch (error) {
+        if (error instanceof WorkflowRunInProgressError) {
+          this.logger.log(`Skipping schedule fire for "${workflowId}": a run is already in progress`, { workflowId, runId: error.runId });
+          return;
+        }
         this.logger.error(`Schedule fire failed to start a run for workflow "${workflowId}"`, error instanceof Error ? error : new Error(String(error)), { workflowId });
         throw error;
       }
@@ -432,7 +437,8 @@ class WorkflowEngine {
       parentRunId,
       parentStepId,
       parentResourceId,
-      scheduledAt
+      scheduledAt,
+      singleton: workflow2.singleton === true || options?.singleton === true
     }, targetDb);
     const insertAndEnqueue = async (targetDb) => {
       const result = await insertRun(targetDb);
@@ -591,6 +597,9 @@ class WorkflowEngine {
   }) {
     await this.checkIfHasStarted();
     const run = await this.getRun({ runId, resourceId });
+    if (run.singleton) {
+      await assertSingletonSlotAvailable({ workflowId: run.workflowId, exceptRunId: run.id }, this.db);
+    }
     const jobResourceId = resourceId ?? run.resourceId ?? undefined;
     const job = {
       runId: run.id,
@@ -1569,10 +1578,11 @@ export {
   createWorkflowRef,
   WorkflowStatus,
   WorkflowRunNotFoundError,
+  WorkflowRunInProgressError,
   WorkflowEngineError,
   WorkflowEngine,
   WorkflowClient
 };
 
-//# debugId=A6C8F39FA22E601264756E2164756E21
+//# debugId=4EA8624FFA9819BE64756E2164756E21
 //# sourceMappingURL=index.js.map