better-supabase 0.12.0 → 0.14.0

package/dist/workflow-sdk/builder/index.d.ts

@@ -1,6 +1,6 @@
-import { B as WorkflowGraph, i as BuilderStarter, l as NodeRunRecord } from "../../types-Bels39_u.js";
-import { a as GraphSubject, i as GraphStepCall, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-BWgJNbGh.js";
-import { s as WorkflowFn } from "../../workflow-sdk-CWdCWj7M.js";
+import { B as WorkflowGraph, i as BuilderStarter, l as NodeRunRecord } from "../../types-uHD9yANu.js";
+import { a as GraphSubject, i as GraphStepCall, o as approvalToken, r as GraphRuntime, s as executeGraph, t as GraphApprovalCall } from "../../executor-DQoczQZJ.js";
+import { s as WorkflowFn } from "../../workflow-sdk-BTYWQQg9.js";
 import { World } from "@workflow/world";
 //#region src/workflow-sdk/builder/builder.d.ts
 /** The env flag the Workflow SDK reads before it starts or runs dynamic source. */
@@ -13,9 +13,15 @@ interface CompiledGraph {
   readonly format: 1;
   /** The workflow function's name in `source`. */
   readonly exportName: string;
-  /** `async function workflow(input, meta)`, bound to `steps`, `sleep` and `createHook`. */
+  /**
+   * `async function workflow(input, meta)`, bound to `steps`, `sleep` and
+   * `createHook`.
+   */
   readonly source: string;
-  /** The step each `steps.<alias>` call runs, by alias (one alias per step node). */
+  /**
+   * The step each `steps.<alias>` call runs, by alias (one alias per step
+   * node).
+   */
   readonly aliases: Readonly<Record<string, string>>;
 }
 /** The second argument of a compiled or static run. */
@@ -26,7 +32,10 @@ interface GraphRunMeta {
   readonly version: number;
   /** The version's id, for `builder.versions.runAs` inside each step. */
   readonly versionId: string;
-  /** The run's tenant, for `builder.versions.runAs` (a system definition's runs need it). */
+  /**
+   * The run's tenant, for `builder.versions.runAs` (a system definition's runs
+   * need it).
+   */
   readonly tenant?: string;
   /** The record the run belongs to; conditions read it as `subject`. */
   readonly subject?: GraphSubject;
@@ -38,13 +47,13 @@ interface GraphRunMeta {
   readonly stubs?: Readonly<Record<string, unknown>>;
 }
 /**
- * Compiles a graph to Workflow SDK dynamic source: plain JavaScript that
- * starts at `meta.triggerNode` (or the only trigger), calls each step node
- * through its own alias, sleeps with `sleep` and waits on approvals with
- * `createHook`: the token is the id `steps.bs_approval` returns
- * (graphStarter's `approval`), else `<runKey>:<node>`. A `meta.mode` of
- * `test` returns `meta.stubs` instead. It runs the same way `executeGraph` does. Throws when the graph is invalid or the
- * source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
+ * Compiles a graph to Workflow SDK dynamic source: plain JavaScript that starts
+ * at `meta.triggerNode` (or the only trigger), calls each step node through its
+ * own alias, sleeps with `sleep` and waits on approvals with `createHook`: the
+ * token is the id `steps.bs_approval` returns (graphStarter's `approval`), else
+ * `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead. It
+ * runs the same way `executeGraph` does. Throws when the graph is invalid or
+ * the source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
  */
 export declare function compileGraph(graph: WorkflowGraph): CompiledGraph;
 /** `value` as a compiled graph, or `undefined` when it isn't one. */
@@ -58,50 +67,55 @@ interface GraphStarterOptions {
   readonly steps: Readonly<Record<string, GraphStep>>;
   /**
    * The static executor: a `"use workflow"` function that calls
-   * `executeGraph(graph, input, { ...graphRunFields(meta), step, sleep, approval })`.
-   * Runs start with it when dynamic workflows are off.
+   * `executeGraph(graph, input, { ...graphRunFields(meta), step, sleep,
+   * approval })`. Runs start with it when dynamic workflows are off.
    */
   readonly executor?: WorkflowFn<[WorkflowGraph, unknown, GraphRunMeta]>;
   /**
-   * Set once `executor` spreads `graphRunFields(meta)` into its runtime: a
-   * test run through an executor that doesn't would run real steps, so
-   * test runs on the static executor are refused without it.
+   * Set once `executor` spreads `graphRunFields(meta)` into its runtime: a test
+   * run through an executor that doesn't would run real steps, so test runs on
+   * the static executor are refused without it.
    */
   readonly executorRunsTests?: boolean;
-  /** Whether to start dynamic source; defaults to `WORKFLOW_EXPERIMENTAL_DYNAMIC_WORKFLOWS`. */
+  /**
+   * Whether to start dynamic source; defaults to
+   * `WORKFLOW_EXPERIMENTAL_DYNAMIC_WORKFLOWS`.
+   */
   readonly dynamic?: boolean;
   /** The World to look idempotency keys up in. Defaults to the configured one. */
   readonly world?: World;
   /**
-   * A `"use step"` function that files the approval request for an
-   * approval node (a `GraphApprovalCall`) and returns its id, the hook
-   * token. Resume runs with `wakeOnApproval` from your outbox consumer.
-   * Without it the token is `<runKey>:<node>`, which anyone who knows the
-   * run key can guess. The static executor passes it as
-   * `runtime.requestApproval` itself.
+   * A `"use step"` function that files the approval request for an approval
+   * node (a `GraphApprovalCall`) and returns its id, the hook token. Resume
+   * runs with `wakeOnApproval` from your outbox consumer. Without it the token
+   * is `<runKey>:<node>`, which anyone who knows the run key can guess. The
+   * static executor passes it as `runtime.requestApproval` itself.
    */
   readonly approval?: GraphStep;
 }
 /**
- * The `start` for `createWorkflowBuilder`: starts the published version as dynamic
- * source when dynamic workflows are on, and through `executor` otherwise.
- * The source is always compiled from the version's graph; a stored
+ * The `start` for `createWorkflowBuilder`: starts the published version as
+ * dynamic source when dynamic workflows are on, and through `executor`
+ * otherwise. The source is always compiled from the version's graph; a stored
  * compiled form is never run. Runs carry `bs.tenant`, `bs.actor`,
- * `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`,
- * `bs.mode` and `bs.trigger_node` when set. A live run also records its
- * principal: the publisher (`user`), or the app's service principal for an
- * organization-owned version. A repeated key returns the first run.
+ * `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`, `bs.mode` and
+ * `bs.trigger_node` when set. A live run also records its principal: the
+ * publisher (`user`), or the app's service principal for an organization-owned
+ * version. A repeated key returns the first run.
  */
 export declare function graphStarter(options: GraphStarterOptions): BuilderStarter;
-/** Where `nodeRunReporter` writes: `builder.nodeRuns` from `createWorkflowBuilder`. */
+/**
+ * Where `nodeRunReporter` writes: `builder.nodeRuns` from
+ * `createWorkflowBuilder`.
+ */
 interface NodeRunSink {
   record(input: NodeRunRecord): PromiseLike<unknown>;
 }
 /**
- * Wraps a step so it records its node in `workflow_node_runs`: `running`
- * with the attempt when it starts, then `completed` with its output or
- * `failed` with the error. Call the result inside a `"use step"` function;
- * a failed record never fails the step.
+ * Wraps a step so it records its node in `workflow_node_runs`: `running` with
+ * the attempt when it starts, then `completed` with its output or `failed` with
+ * the error. Call the result inside a `"use step"` function; a failed record
+ * never fails the step.
  *
  * ```ts
  * const report = nodeRunReporter(serviceBuilder.nodeRuns);

package/dist/workflow-sdk/builder/index.js

@@ -1,7 +1,7 @@
-import { n as subjectAttribute, t as WORKFLOW_ATTRIBUTES } from "../../attributes-D4mA7WhI.js";
-import { c as isGraphRecord, i as durationMs, p as validateGraph, u as topologicalOrder } from "../../graph-Cs28bOlK.js";
-import { i as startNodeOf, n as executeGraph, t as approvalToken } from "../../executor-D3K3tycZ.js";
-import { o as runForKey, r as contextAttributes } from "../../workflow-sdk-QnnzIQRc.js";
+import { n as subjectAttribute, t as WORKFLOW_ATTRIBUTES } from "../../attributes-BOFl922R.js";
+import { c as isGraphRecord, i as durationMs, p as validateGraph, u as topologicalOrder } from "../../graph-B4eubUQG.js";
+import { i as startNodeOf, n as executeGraph, t as approvalToken } from "../../executor-QtVn0axs.js";
+import { o as runForKey, r as contextAttributes } from "../../workflow-sdk-_pqDUwNK.js";
 import { start } from "workflow/api";
 import { getStepMetadata, getWorkflowMetadata } from "workflow";
 //#region src/workflow-sdk/builder/builder.ts
@@ -10,7 +10,10 @@ const DYNAMIC_WORKFLOWS_ENV = "WORKFLOW_EXPERIMENTAL_DYNAMIC_WORKFLOWS";
 /** The Workflow SDK's limit on dynamic source. */
 const DYNAMIC_SOURCE_MAX_BYTES = 131072;
 const EXPORT_NAME = "workflow";
-/** The `steps` key the compiled source calls to file an approval request; never a step alias. */
+/**
+* The `steps` key the compiled source calls to file an approval request; never
+* a step alias.
+*/
 const APPROVAL_ALIAS = "bs_approval";
 const literal = (value) => JSON.stringify(value ?? null);
 const aliasOf = (node, index) => `n${index}_${node.id.replaceAll(/[^A-Za-z0-9_]/g, "_").slice(0, 40)}`;
@@ -81,13 +84,13 @@ function nodeBody(node, alias) {
 }
 const guard = (edges) => edges.map((edge) => `took(${literal(edge.source)}, ${edge.branch === void 0 ? "null" : literal(edge.branch)})`).join(" || ");
 /**
-* Compiles a graph to Workflow SDK dynamic source: plain JavaScript that
-* starts at `meta.triggerNode` (or the only trigger), calls each step node
-* through its own alias, sleeps with `sleep` and waits on approvals with
-* `createHook`: the token is the id `steps.bs_approval` returns
-* (graphStarter's `approval`), else `<runKey>:<node>`. A `meta.mode` of
-* `test` returns `meta.stubs` instead. It runs the same way `executeGraph` does. Throws when the graph is invalid or the
-* source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
+* Compiles a graph to Workflow SDK dynamic source: plain JavaScript that starts
+* at `meta.triggerNode` (or the only trigger), calls each step node through its
+* own alias, sleeps with `sleep` and waits on approvals with `createHook`: the
+* token is the id `steps.bs_approval` returns (graphStarter's `approval`), else
+* `<runKey>:<node>`. A `meta.mode` of `test` returns `meta.stubs` instead. It
+* runs the same way `executeGraph` does. Throws when the graph is invalid or
+* the source is over 128 KiB. Pass it as `compile` to `createWorkflowBuilder`.
 */
 function compileGraph(graph) {
 	const errors = validateGraph(graph);
@@ -146,7 +149,10 @@ const dynamicEnabled = () => {
 	const raw = globalThis.process?.env?.[DYNAMIC_WORKFLOWS_ENV];
 	return raw === "1" || raw?.toLowerCase() === "true";
 };
-/** Who a live run's steps run as: the version's publisher, or the app's service principal. */
+/**
+* Who a live run's steps run as: the version's publisher, or the app's service
+* principal.
+*/
 function principalAttributes(call) {
 	switch (call.version.owner) {
 		case "user": return call.version.publishedBy === void 0 ? {} : {
@@ -172,14 +178,14 @@ function contextOf(call) {
 	};
 }
 /**
-* The `start` for `createWorkflowBuilder`: starts the published version as dynamic
-* source when dynamic workflows are on, and through `executor` otherwise.
-* The source is always compiled from the version's graph; a stored
+* The `start` for `createWorkflowBuilder`: starts the published version as
+* dynamic source when dynamic workflows are on, and through `executor`
+* otherwise. The source is always compiled from the version's graph; a stored
 * compiled form is never run. Runs carry `bs.tenant`, `bs.actor`,
-* `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`,
-* `bs.mode` and `bs.trigger_node` when set. A live run also records its
-* principal: the publisher (`user`), or the app's service principal for an
-* organization-owned version. A repeated key returns the first run.
+* `bs.definition`, `bs.version` and `bs.key`, plus `bs.subject`, `bs.mode` and
+* `bs.trigger_node` when set. A live run also records its principal: the
+* publisher (`user`), or the app's service principal for an organization-owned
+* version. A repeated key returns the first run.
 */
 function graphStarter(options) {
 	return async (call) => {
@@ -244,10 +250,10 @@ function graphStarter(options) {
 	};
 }
 /**
-* Wraps a step so it records its node in `workflow_node_runs`: `running`
-* with the attempt when it starts, then `completed` with its output or
-* `failed` with the error. Call the result inside a `"use step"` function;
-* a failed record never fails the step.
+* Wraps a step so it records its node in `workflow_node_runs`: `running` with
+* the attempt when it starts, then `completed` with its output or `failed` with
+* the error. Call the result inside a `"use step"` function; a failed record
+* never fails the step.
 *
 * ```ts
 * const report = nodeRunReporter(serviceBuilder.nodeRuns);

package/dist/workflow-sdk/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { _ as workflowContext, a as StartOnEventOptions, c as WorkflowRunAs, d as authorizeHook, f as contextAttributes, g as startOnEvent, h as startFor, i as StartForOptions, l as WorkflowRunAsFor, m as protectWebHandler, n as HookForbiddenError, o as WorkflowContextOptions, p as hookMetadata, r as ProtectWebHandlerOptions, s as WorkflowFn, t as AuthorizeHookOptions, u as WorkflowStarterOptions, v as workflowStarter } from "../workflow-sdk-CWdCWj7M.js";
+import { _ as workflowContext, a as StartOnEventOptions, c as WorkflowRunAs, d as authorizeHook, f as contextAttributes, g as startOnEvent, h as startFor, i as StartForOptions, l as WorkflowRunAsFor, m as protectWebHandler, n as HookForbiddenError, o as WorkflowContextOptions, p as hookMetadata, r as ProtectWebHandlerOptions, s as WorkflowFn, t as AuthorizeHookOptions, u as WorkflowStarterOptions, v as workflowStarter } from "../workflow-sdk-BTYWQQg9.js";
 //#region src/workflow-sdk/approval-waiter.d.ts
 /** How `approvalWaiter.wait` ended. */
 type ApprovalWaitResult<P> = {
@@ -13,17 +13,17 @@ interface ApprovalWaitOptions {
   readonly expiresAt: Temporal.Instant | string;
 }
 /**
- * Pauses a workflow on an approval and resumes it by token. `wait` runs
- * inside a `"use workflow"` function; `wake` runs in server code, after
- * the approver was checked (`authorizeHook`, or the provider's
- * `approverOf`). The token is the approval request's id, so the code that
- * records the decision can wake the run without storing the hook.
+ * Pauses a workflow on an approval and resumes it by token. `wait` runs inside
+ * a `"use workflow"` function; `wake` runs in server code, after the approver
+ * was checked (`authorizeHook`, or the provider's `approverOf`). The token is
+ * the approval request's id, so the code that records the decision can wake the
+ * run without storing the hook.
  */
 interface ApprovalWaiter {
   /**
-   * Waits for `wake(token, payload)` until `expiresAt`: `{ status:
-   * "resumed", payload }`, or `{ status: "expired" }` when the time passes
-   * first (at once for a past `expiresAt`).
+   * Waits for `wake(token, payload)` until `expiresAt`: `{ status: "resumed",
+   * payload }`, or `{ status: "expired" }` when the time passes first (at once
+   * for a past `expiresAt`).
    */
   wait<P = unknown>(token: string, options: ApprovalWaitOptions): Promise<ApprovalWaitResult<P>>;
   /** Resumes the run waiting on `token`; `payload` defaults to `null`. */
@@ -35,7 +35,10 @@ export declare const approvalWaiter: ApprovalWaiter;
 export declare const APPROVAL_OUTCOME_EVENTS: readonly string[];
 /** The payload `wakeOnApproval` resumes a run with. */
 interface ApprovalOutcome {
-  /** `true` only for `approval.approved`; a builder approval node takes the branch from it. */
+  /**
+   * `true` only for `approval.approved`; a builder approval node takes the
+   * branch from it.
+   */
   readonly approved: boolean;
   readonly status: "approved" | "rejected" | "expired" | "cancelled";
   readonly requestId: string;
@@ -50,14 +53,17 @@ interface ApprovalOutcomeEvent {
  * decides it: pass every outbox event from your consumer. For
  * `approval.approved`, `approval.rejected`, `approval.expired` and
  * `approval.cancelled` it calls `waiter.wake(<request id>, outcome)` and
- * returns `true`; other events return `false`. The request id is a random
- * uuid, so only `decide_approval` (and with it the approver check) can end
- * the wait. A wake for a request no run waits on is ignored.
+ * returns `true`; other events return `false`. The request id is a random uuid,
+ * so only `decide_approval` (and with it the approver check) can end the wait.
+ * A wake for a request no run waits on is ignored.
  */
 export declare function wakeOnApproval(event: ApprovalOutcomeEvent, waiter?: Pick<ApprovalWaiter, "wake">): Promise<boolean>;
 //#endregion
 //#region src/workflow-sdk/attributes.d.ts
-/** The attributes the Supabase World's status trigger copies into `workflow_runs`. */
+/**
+ * The attributes the Supabase World's status trigger copies into
+ * `workflow_runs`.
+ */
 export declare const WORKFLOW_ATTRIBUTES: {
   readonly tenant: "bs.tenant";
   readonly actor: "bs.actor";
@@ -74,7 +80,10 @@ export declare const WORKFLOW_ATTRIBUTES: {
   readonly trigger: "bs.trigger";
   /** The record a run belongs to, as `<type>/<id>`. */
   readonly subject: "bs.subject";
-  /** What a `runAs` run's steps run as: `user`, `service_principal`, `system` or `external`. */
+  /**
+   * What a `runAs` run's steps run as: `user`, `service_principal`, `system` or
+   * `external`.
+   */
   readonly principalKind: "bs.principal_kind";
   /** The id of that principal, when it has one. */
   readonly principal: "bs.principal";

package/dist/workflow-sdk/index.js

@@ -1,5 +1,5 @@
-import { t as WORKFLOW_ATTRIBUTES } from "../attributes-D4mA7WhI.js";
-import { a as protectWebHandler, c as startOnEvent, i as hookMetadata, l as workflowContext, n as authorizeHook, r as contextAttributes, s as startFor, t as HookForbiddenError, u as workflowStarter } from "../workflow-sdk-QnnzIQRc.js";
+import { t as WORKFLOW_ATTRIBUTES } from "../attributes-BOFl922R.js";
+import { a as protectWebHandler, c as startOnEvent, i as hookMetadata, l as workflowContext, n as authorizeHook, r as contextAttributes, s as startFor, t as HookForbiddenError, u as workflowStarter } from "../workflow-sdk-_pqDUwNK.js";
 import { resumeHook } from "workflow/api";
 import { createHook, sleep } from "workflow";
 //#region src/workflow-sdk/approval-waiter.ts
@@ -47,9 +47,9 @@ const APPROVAL_OUTCOME_EVENTS = Object.freeze([
 * decides it: pass every outbox event from your consumer. For
 * `approval.approved`, `approval.rejected`, `approval.expired` and
 * `approval.cancelled` it calls `waiter.wake(<request id>, outcome)` and
-* returns `true`; other events return `false`. The request id is a random
-* uuid, so only `decide_approval` (and with it the approver check) can end
-* the wait. A wake for a request no run waits on is ignored.
+* returns `true`; other events return `false`. The request id is a random uuid,
+* so only `decide_approval` (and with it the approver check) can end the wait.
+* A wake for a request no run waits on is ignored.
 */
 async function wakeOnApproval(event, waiter = approvalWaiter) {
 	if (!APPROVAL_OUTCOME_EVENTS.includes(event.type)) return false;
@@ -77,7 +77,10 @@ function statusOf(type) {
 		default: return "cancelled";
 	}
 }
-/** The Workflow SDK's `HookNotFoundError`, matched by name as `HookNotFoundError.is` does. */
+/**
+* The Workflow SDK's `HookNotFoundError`, matched by name as
+* `HookNotFoundError.is` does.
+*/
 const isMissingHook = (cause) => cause instanceof Error && cause.name === "HookNotFoundError";
 //#endregion
 export { APPROVAL_OUTCOME_EVENTS, HookForbiddenError, WORKFLOW_ATTRIBUTES, approvalWaiter, authorizeHook, contextAttributes, hookMetadata, protectWebHandler, startFor, startOnEvent, wakeOnApproval, workflowContext, workflowStarter };

package/dist/workflow-sdk/world/index.d.ts

@@ -1,4 +1,4 @@
-import { o as EventHub } from "../../events-P3raDX2E.js";
+import { o as EventHub } from "../../events-DbLjvxDX.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
 import { Pool } from "pg";
 import { World } from "@workflow/world";
@@ -14,7 +14,10 @@ type WorkflowDeliveryMode = (typeof WORKFLOW_DELIVERY_MODES)[number];
  */
 export declare const WORKFLOW_WORLD_PROTOCOL = "5.0.2";
 interface SupabaseWorldOptions {
-  /** A Postgres connection string with access to the `workflow` schema and the jobs functions. */
+  /**
+   * A Postgres connection string with access to the `workflow` schema and the
+   * jobs functions.
+   */
   readonly connectionString?: string;
   /** An existing pool instead of `connectionString`; `close()` leaves it open. */
   readonly pool?: Pool;
@@ -25,7 +28,11 @@ interface SupabaseWorldOptions {
    * hosts with no long-running process.
    */
   readonly delivery?: WorkflowDeliveryMode;
-  /** The flow route the poller posts to. Defaults to `WORKFLOW_FLOW_URL`, then `WORKFLOW_LOCAL_BASE_URL` or `http://localhost:$PORT` plus `/.well-known/workflow/v1/flow`. */
+  /**
+   * The flow route the poller posts to. Defaults to `WORKFLOW_FLOW_URL`, then
+   * `WORKFLOW_LOCAL_BASE_URL` or `http://localhost:$PORT` plus
+   * `/.well-known/workflow/v1/flow`.
+   */
   readonly flowUrl?: string;
   /**
    * The secret deliveries are signed with. Required to accept `pg_net`
@@ -35,13 +42,15 @@ interface SupabaseWorldOptions {
    */
   readonly deliverySecret?: string;
   /**
-   * A 32-byte master key (base64 or hex) that each run's AES-256 key is
-   * derived from (HKDF-SHA256). Read from the Vault secret
-   * `workflow_encryption_key` when unset; without one, run data is stored
-   * unencrypted.
+   * A 32-byte master key (base64 or hex) that each run's AES-256 key is derived
+   * from (HKDF-SHA256). Read from the Vault secret `workflow_encryption_key`
+   * when unset; without one, run data is stored unencrypted.
    */
   readonly encryptionKey?: string;
-  /** The jobs queue the messages wait in (`blocks.workflow-sdk-world.options.queue`). */
+  /**
+   * The jobs queue the messages wait in
+   * (`blocks.workflow-sdk-world.options.queue`).
+   */
   readonly queue?: string;
   /** The schema of the jobs functions, default `better_supabase`. */
   readonly schema?: string;
@@ -49,12 +58,15 @@ interface SupabaseWorldOptions {
   readonly concurrency?: number;
   /** Milliseconds between polls of an empty queue (default 250). */
   readonly pollInterval?: number;
-  /** Seconds a claimed message stays leased; the delivery extends it while it runs (default 60). */
+  /**
+   * Seconds a claimed message stays leased; the delivery extends it while it
+   * runs (default 60).
+   */
   readonly lease?: number;
   /**
-   * Seconds a poll delivery may wait for the flow route before it is
-   * aborted, failed and retried; the lease stops being extended then
-   * (default 300, at least `lease`).
+   * Seconds a poll delivery may wait for the flow route before it is aborted,
+   * failed and retried; the lease stops being extended then (default 300, at
+   * least `lease`).
    */
   readonly deliveryTimeout?: number;
   /** The queue namespace, as `WORKFLOW_QUEUE_NAMESPACE`. */
@@ -65,17 +77,32 @@ interface SupabaseWorldOptions {
    * deliveries than connections wait for one instead of failing.
    */
   readonly maxConnections?: number;
-  /** Milliseconds a statement waits for a free connection before it fails (default 30000). */
+  /**
+   * Milliseconds a statement waits for a free connection before it fails
+   * (default 30000).
+   */
   readonly connectionTimeout?: number;
   /** Milliseconds an unused connection stays open (default 10000). */
   readonly idleTimeout?: number;
-  /** `statement_timeout` of the World's connections, in milliseconds (default 30000). */
+  /**
+   * `statement_timeout` of the World's connections, in milliseconds (default
+   * 30000).
+   */
   readonly statementTimeout?: number;
-  /** `idle_in_transaction_session_timeout` of the World's connections, in milliseconds (default 15000). */
+  /**
+   * `idle_in_transaction_session_timeout` of the World's connections, in
+   * milliseconds (default 15000).
+   */
   readonly idleInTransactionTimeout?: number;
-  /** `betterSupabase.events`: errors on idle pooled connections arrive as `error` events. */
+  /**
+   * `betterSupabase.events`: errors on idle pooled connections arrive as
+   * `error` events.
+   */
   readonly events?: EventHub;
-  /** Where idle-connection errors go without `error` handlers. Defaults to the console. */
+  /**
+   * Where idle-connection errors go without `error` handlers. Defaults to the
+   * console.
+   */
   readonly logger?: Logger;
 }
 //#endregion
@@ -84,14 +111,17 @@ interface SupabaseWorldOptions {
 type SupabaseWorld = World & {
   start(): Promise<void>;
   close(): Promise<void>;
-  /** Claims and delivers the due messages once (poll mode); resolves with how many it delivered. */
+  /**
+   * Claims and delivers the due messages once (poll mode); resolves with how
+   * many it delivered.
+   */
   deliverOnce(): Promise<number>;
 };
 /**
  * A Workflow SDK World on Supabase Postgres: the run, step, event, hook and
  * stream tables of `@workflow/world-postgres` (installed by the
- * `workflow-sdk-world` SQL module), with messages in the jobs module's
- * queue instead of graphile-worker.
+ * `workflow-sdk-world` SQL module), with messages in the jobs module's queue
+ * instead of graphile-worker.
  *
  * ```ts
  * // workflow.config or WORKFLOW_TARGET_WORLD=better-supabase/workflow-sdk/world
@@ -109,9 +139,8 @@ export declare function createSupabaseWorld(options?: SupabaseWorldOptions): Sup
  * `WORKFLOW_POSTGRES_POLL_INTERVAL_MS`, and the pool settings
  * `WORKFLOW_POSTGRES_MAX_CONNECTIONS`,
  * `WORKFLOW_POSTGRES_CONNECTION_TIMEOUT_MS`,
- * `WORKFLOW_POSTGRES_IDLE_TIMEOUT_MS`,
- * `WORKFLOW_POSTGRES_STATEMENT_TIMEOUT_MS` and
- * `WORKFLOW_POSTGRES_IDLE_IN_TRANSACTION_TIMEOUT_MS`.
+ * `WORKFLOW_POSTGRES_IDLE_TIMEOUT_MS`, `WORKFLOW_POSTGRES_STATEMENT_TIMEOUT_MS`
+ * and `WORKFLOW_POSTGRES_IDLE_IN_TRANSACTION_TIMEOUT_MS`.
  */
 export declare function createWorld(): SupabaseWorld;
 //#endregion
@@ -126,7 +155,10 @@ export declare function parseMasterKey(value: string): Uint8Array;
 export declare function deriveRunKey(master: Uint8Array, runId: string): Promise<Uint8Array>;
 /** `t=<unix>,v1=<hex>` over `<t>.<job>.<body>`. */
 export declare function signDelivery(secret: string, job: string, body: string, now?: number): Promise<string>;
-/** Whether `header` signs `job` and `body` with `secret` within five minutes of `now`. */
+/**
+ * Whether `header` signs `job` and `body` with `secret` within five minutes of
+ * `now`.
+ */
 export declare function verifyDelivery(secret: string, header: string | null, job: string, body: string, now?: number): Promise<boolean>;
 //#endregion
 //#region src/workflow-sdk/world/env.d.ts