better-supabase 0.11.0 → 0.13.0

package/dist/blocks/jobs/index.d.ts

@@ -1,30 +1,30 @@
 /// <reference lib="esnext.temporal" />
-import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-BREt7qOh.js";
+import { T as ErrorMapper, f as Result, t as AsyncResult } from "../../result-mijqfoJN.js";
+import { t as StandardSchemaV1 } from "../../standard-16AIDny5.js";
+import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnXkMney.js";
 import { n as Logger } from "../../logger-DWVYUmwi.js";
-import { t as StandardSchemaV1 } from "../../standard-BcUQuUgu.js";
-import { n as SqlClient } from "../../executor-D1hECPGG.js";
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { n as BlockOptions, r as BlockTemporalOptions } from "../../block-helpers-CjcQM1yA.js";
-import { n as BlockHooks } from "../../block-hooks-DcPJHztl.js";
-import { n as ExtraFields, r as FieldsOf } from "../../block-fields-DnaDbgZS.js";
-import { A as DeadJobRow, B as sqlQueueBackend, C as RunSchedulesOptions, D as ScheduleInfo, E as ScheduleFilter, F as QueuePurgeArgs, I as QueueRpcClient, L as QueueStats, M as QueueBackend, N as QueueMessageBody, O as ScheduleOptions, P as QueueMessageRow, R as TransportQueueBackendOptions, S as RetryDeadOptions, T as ScheduleDefinitions, V as transportQueueBackend, _ as Jobs, a as DrainResult, b as PurgeJobsOptions, c as EnqueueOnceOptions, d as EnsureSchedulesOptions, f as EnsureSchedulesResult, g as JobHandler, h as JobContext, i as DrainOptions, j as DueSchedule, k as WorkOptions, l as EnqueueOnceResult, m as Job, n as DeadJob, o as DrainRouteOptions, p as FailOptions, r as DrainMonitor, s as DrainRouteResult, t as ClaimOptions, u as EnqueueOptions, v as JobsOptions, w as ScheduleDefinition, x as QueueSchemas, y as ListDeadOptions, z as pgmqPublicBackend } from "../../types-BEEFkNFY.js";
-import { a as ProblemFormat, t as BlockProblemOptions } from "../../problem-DCDIQiTA.js";
-import { s as BlockOf } from "../../define-block-CPyJ95rq.js";
+import { n as SqlClient } from "../../executor-DXfgDsKd.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
+import { n as BlockOptions, r as BlockTemporalOptions } from "../../block-helpers-DyA5BAW4.js";
+import { n as BlockHooks } from "../../block-hooks-BadAniNI.js";
+import { A as DeadJobRow, B as sqlQueueBackend, C as RunSchedulesOptions, D as ScheduleInfo, E as ScheduleFilter, F as QueuePurgeArgs, I as QueueRpcClient, L as QueueStats, M as QueueBackend, N as QueueMessageBody, O as ScheduleOptions, P as QueueMessageRow, R as TransportQueueBackendOptions, S as RetryDeadOptions, T as ScheduleDefinitions, V as transportQueueBackend, _ as Jobs, a as DrainResult, b as PurgeJobsOptions, c as EnqueueOnceOptions, d as EnsureSchedulesOptions, f as EnsureSchedulesResult, g as JobHandler, h as JobContext, i as DrainOptions, j as DueSchedule, k as WorkOptions, l as EnqueueOnceResult, m as Job, n as DeadJob, o as DrainRouteOptions, p as FailOptions, r as DrainMonitor, s as DrainRouteResult, t as ClaimOptions, u as EnqueueOptions, v as JobsOptions, w as ScheduleDefinition, x as QueueSchemas, y as ListDeadOptions, z as pgmqPublicBackend } from "../../types-CB5MvzuE.js";
+import { a as ProblemFormat, t as BlockProblemOptions } from "../../problem-D_DEBfMn.js";
+import { s as BlockOf } from "../../define-block-MyM4lH42.js";
 //#region src/blocks/jobs/cron.d.ts
 /**
  * Throws a `TypeError` unless `expression` is a schedule `nextCronRun`
- * understands: five cron fields, a macro such as `@daily`, or an interval
- * such as `30 seconds`.
+ * understands: five cron fields, a macro such as `@daily`, or an interval such
+ * as `30 seconds`.
  */
 export declare function assertCron(expression: string): void;
 /**
  * The first run of `expression` after `after`, in `timeZone`.
  *
- * Accepts five cron fields (lists, ranges and steps; a restricted day of
- * month and day of week match either, as in cron), the macros `@hourly`,
- * `@daily`, `@weekly`, `@monthly` and `@yearly`, and intervals such as
- * `30 seconds`, `5 minutes` or `2 hours`, counted from `after`. A local time
- * that a DST change skips runs at the same offset after the gap.
+ * Accepts five cron fields (lists, ranges and steps; a restricted day of month
+ * and day of week match either, as in cron), the macros `@hourly`, `@daily`,
+ * `@weekly`, `@monthly` and `@yearly`, and intervals such as `30 seconds`, `5
+ * minutes` or `2 hours`, counted from `after`. A local time that a DST change
+ * skips runs at the same offset after the gap.
  */
 export declare function nextCronRun(expression: string, timeZone: string, after: Temporal.Instant): Temporal.Instant;
 //#endregion
@@ -45,11 +45,14 @@ export declare function devDrainSecret(env: Record<string, string | undefined>,
 export declare function devDrain(options: DevDrainOptions): DevDrain;
 //#endregion
 //#region src/blocks/jobs/idempotency.d.ts
-/** Where `createIdempotency` stores keys: a transport, or a service SQL connection. */
+/**
+ * Where `createIdempotency` stores keys: a transport, or a service SQL
+ * connection.
+ */
 type IdempotencySource = {
   /**
-   * A service-role transport, such as `rpcTransport(adminClient, { schema: "api" })`
-   * over the wrappers `blocks.idempotency.api` writes.
+   * A service-role transport, such as `rpcTransport(adminClient, { schema:
+   * "api" })` over the wrappers `blocks.idempotency.api` writes.
    */
   readonly transport: BlockTransport;
   readonly sql?: never;
@@ -71,15 +74,24 @@ interface IdempotencySettings extends BlockProblemOptions, BlockTemporalOptions
   readonly ttl?: number | string;
   /** How long a running request holds the key. Defaults to `1 minute`. */
   readonly lock?: number | string;
-  /** Answer 400 when the header is missing. Defaults to false (run without a key). */
+  /**
+   * Answer 400 when the header is missing. Defaults to false (run without a
+   * key).
+   */
   readonly required?: boolean;
   /** Defaults to `Idempotency-Key`. */
   readonly header?: string;
-  /** The schema the functions live in, over a transport. Defaults to `better_supabase`. */
+  /**
+   * The schema the functions live in, over a transport. Defaults to
+   * `better_supabase`.
+   */
   readonly schema?: string;
   /** Error mappers that run before the built-in ones, over a transport. */
   readonly mappers?: readonly ErrorMapper[];
-  /** `withBlockHooks` hooks around `begin`, `extend`, `complete`, `release` and `purge`. */
+  /**
+   * `withBlockHooks` hooks around `begin`, `extend`, `complete`, `release` and
+   * `purge`.
+   */
   readonly hooks?: BlockHooks<Idempotency>;
   /** Receives the errors `after` hooks throw. */
   readonly logger?: Logger;
@@ -87,8 +99,8 @@ interface IdempotencySettings extends BlockProblemOptions, BlockTemporalOptions
 type IdempotencyState = "started" | "replay" | "running" | "mismatch";
 interface Idempotency {
   /**
-   * Runs `handler` at most once per key: retries with the same key and body
-   * get the stored response (with `Idempotency-Replayed: true`).
+   * Runs `handler` at most once per key: retries with the same key and body get
+   * the stored response (with `Idempotency-Replayed: true`).
    */
   handle(request: Request, handler: (request: Request) => Promise<Response> | Response): Promise<Response>;
   /** The lower-level protocol, for non-HTTP callers. */
@@ -101,13 +113,13 @@ interface Idempotency {
   }>;
   /**
    * Moves the lock of a running key `lock` further for `holder`. `false` once
-   * the lock ran out or another caller took the key over. `handle` calls it
-   * at half the lock while the handler runs.
+   * the lock ran out or another caller took the key over. `handle` calls it at
+   * half the lock while the handler runs.
    */
   extend(key: string, holder: string, scope?: string): AsyncResult<boolean>;
   /**
-   * Stores the response for `holder`. `false` when the lock ran out and
-   * another caller took the key over, so the response was not stored.
+   * Stores the response for `holder`. `false` when the lock ran out and another
+   * caller took the key over, so the response was not stored.
    */
   complete(key: string, holder: string, status: number, body: unknown, scope?: string): AsyncResult<boolean>;
   /** Forgets the key so it can be retried; `false` when `holder` lost it. */
@@ -118,9 +130,9 @@ interface Idempotency {
   purgeJob(): JobHandler<unknown>;
 }
 /**
- * HTTP idempotency keys (IETF `Idempotency-Key` header) over the
- * `idempotency` SQL module: a service SQL connection, or a service-role
- * `rpcTransport` over the wrappers `blocks.idempotency.api` writes.
+ * HTTP idempotency keys (IETF `Idempotency-Key` header) over the `idempotency`
+ * SQL module: a service SQL connection, or a service-role `rpcTransport` over
+ * the wrappers `blocks.idempotency.api` writes.
  */
 export declare function createIdempotency(options: IdempotencyOptions): Idempotency;
 //#endregion
@@ -148,13 +160,16 @@ interface WebhookInboxMessage<T = unknown, F extends object = Record<never, neve
   /** The extra columns, keyed by database name. */
   readonly fields: ExtraFields<F>;
   /**
-   * Saves progress mid-processing (merged into `progress`), so a retry
-   * resumes there, such as a provider's page cursor. `false` when the lease
-   * was lost. Only while the handler runs.
+   * Saves progress mid-processing (merged into `progress`), so a retry resumes
+   * there, such as a provider's page cursor. `false` when the lease was lost.
+   * Only while the handler runs.
    */
   checkpoint(fields: Readonly<Record<string, unknown>>): Promise<boolean>;
 }
-/** A verified event to store, from `verify` or from `store` for a provider SDK that verifies itself. */
+/**
+ * A verified event to store, from `verify` or from `store` for a provider SDK
+ * that verifies itself.
+ */
 interface WebhookInboxEvent<F extends object = Record<never, never>> {
   /** The sender's message id; the inbox stores each one once. */
   readonly id: string;
@@ -171,15 +186,14 @@ interface WebhookInboxOptions<S extends StandardSchemaV1 | undefined = undefined
   /** Name of the sender, e.g. `stripe` or `supabase-auth`. */
   readonly source: string;
   /**
-   * Standard Webhooks secrets; the signature is verified before storing.
-   * Leave out `secrets` and `verify` for a source that only `store` fills
-   * (a chat or provider SDK that verifies its own requests); `receive` then
-   * throws.
+   * Standard Webhooks secrets; the signature is verified before storing. Leave
+   * out `secrets` and `verify` for a source that only `store` fills (a chat or
+   * provider SDK that verifies its own requests); `receive` then throws.
    */
   readonly secrets?: string | readonly string[];
   /**
-   * Custom verification for senders that don't use Standard Webhooks. It
-   * may also return the event's tenant.
+   * Custom verification for senders that don't use Standard Webhooks. It may
+   * also return the event's tenant.
    */
   readonly verify?: (request: Request, body: string) => Promise<Result<{
     id: string;
@@ -188,26 +202,29 @@ interface WebhookInboxOptions<S extends StandardSchemaV1 | undefined = undefined
   }>>;
   /** Event type from the payload. Defaults to `payload.type`. */
   readonly typeOf?: (payload: unknown) => string | null;
-  /** The tenant a payload belongs to, for per-tenant integrations. Defaults to none. */
+  /**
+   * The tenant a payload belongs to, for per-tenant integrations. Defaults to
+   * none.
+   */
   readonly tenantOf?: (payload: unknown) => string | null | undefined;
   /** Headers kept with the message. Defaults to none. */
   readonly keepHeaders?: readonly string[];
   readonly worker?: string;
   /**
-   * Attempts before a message of this source is marked dead, stored with
-   * each message as it arrives. Defaults to 8.
+   * Attempts before a message of this source is marked dead, stored with each
+   * message as it arrives. Defaults to 8.
    */
   readonly maxAttempts?: number;
   /**
-   * The largest body `receive` reads; a larger one gets 413 without being
-   * read to the end. Defaults to 1 MiB.
+   * The largest body `receive` reads; a larger one gets 413 without being read
+   * to the end. Defaults to 1 MiB.
    */
   readonly maxBodyBytes?: number;
   /**
    * A Standard Schema for the message's extra columns
-   * (`blocks.webhook-inbox.options.extraColumns`), keyed by database name.
-   * It validates them on `store`, and types and parses them on `list` and
-   * on the messages `process` hands the handler.
+   * (`blocks.webhook-inbox.options.extraColumns`), keyed by database name. It
+   * validates them on `store`, and types and parses them on `list` and on the
+   * messages `process` hands the handler.
    */
   readonly fields?: S;
   /** `withBlockHooks` hooks around `store`, `list` and `purge`. */
@@ -219,15 +236,15 @@ interface WebhookInboxProcessOptions {
   /** Messages claimed at once. Defaults to 10. */
   readonly batch?: number;
   /**
-   * How long a claimed message stays with this worker. It is renewed when
-   * the message's turn in the batch comes and every half lease while the
-   * handler runs. Defaults to 300 seconds.
+   * How long a claimed message stays with this worker. It is renewed when the
+   * message's turn in the batch comes and every half lease while the handler
+   * runs. Defaults to 300 seconds.
    */
   readonly lease?: number | string;
   /**
-   * Stop claiming after this many ms, so a backlog can't outrun a
-   * serverless function's maximum duration; claimed messages still finish.
-   * Defaults to no limit.
+   * Stop claiming after this many ms, so a backlog can't outrun a serverless
+   * function's maximum duration; claimed messages still finish. Defaults to no
+   * limit.
    */
   readonly budgetMs?: number;
 }
@@ -254,17 +271,23 @@ interface WebhookInboxEntry<F extends object = Record<never, never>> {
   readonly fields: ExtraFields<F>;
 }
 interface WebhookInboxPurgeOptions {
-  /** Defaults to `30 days`; `0` with `tenant` removes all of that tenant's processed messages. */
+  /**
+   * Defaults to `30 days`; `0` with `tenant` removes all of that tenant's
+   * processed messages.
+   */
   readonly olderThan?: number | string;
   readonly includeDead?: boolean;
   readonly tenant?: string;
   readonly batch?: number;
-  /** The schema the functions live in, over a transport. Defaults to `better_supabase`. */
+  /**
+   * The schema the functions live in, over a transport. Defaults to
+   * `better_supabase`.
+   */
   readonly schema?: string;
 }
 /**
- * Deletes processed messages from the inbox (`purge_webhooks`) over a
- * service SQL connection or a service-role transport; returns how many.
+ * Deletes processed messages from the inbox (`purge_webhooks`) over a service
+ * SQL connection or a service-role transport; returns how many.
  */
 export declare function purgeWebhookInbox(source: SqlClient | BlockTransport, options?: WebhookInboxPurgeOptions): AsyncResult<number>;
 interface WebhookInbox<F extends object = Record<never, never>> {
@@ -275,26 +298,28 @@ interface WebhookInbox<F extends object = Record<never, never>> {
    */
   receive(request: Request): Promise<Response>;
   /**
-   * Stores an event your code already verified (a provider SDK that
-   * verifies and parses in one call). `duplicate` when the id was stored
-   * before.
+   * Stores an event your code already verified (a provider SDK that verifies
+   * and parses in one call). `duplicate` when the id was stored before.
    */
   store(event: WebhookInboxEvent<F>): AsyncResult<{
     id: number;
     duplicate: boolean;
   }>;
   /**
-   * Processes stored messages until none are ready, or until `budgetMs`
-   * is spent. A message whose lease another claim took over is skipped,
-   * and its outcome is not counted. A message whose extra columns the
-   * `fields` schema rejects fails without reaching the handler. The signal
-   * aborts when the lease can't be renewed; the message is then neither
-   * completed nor failed by this worker.
+   * Processes stored messages until none are ready, or until `budgetMs` is
+   * spent. A message whose lease another claim took over is skipped, and its
+   * outcome is not counted. A message whose extra columns the `fields` schema
+   * rejects fails without reaching the handler. The signal aborts when the
+   * lease can't be renewed; the message is then neither completed nor failed by
+   * this worker.
    */
   process<T = unknown>(handler: (message: WebhookInboxMessage<T, F>, signal: AbortSignal) => unknown, options?: WebhookInboxProcessOptions): Promise<DrainResult>;
   /** A tenant's messages of this source, newest first. */
   list(options: WebhookInboxListOptions): AsyncResult<WebhookInboxEntry<F>[]>;
-  /** Deletes old processed (and, with `includeDead`, dead) messages of this source's table; returns how many. */
+  /**
+   * Deletes old processed (and, with `includeDead`, dead) messages of this
+   * source's table; returns how many.
+   */
   purge(options?: WebhookInboxPurgeOptions): AsyncResult<number>;
   /** A job handler that runs `purge`; schedule it nightly. */
   purgeJob(options?: WebhookInboxPurgeOptions): JobHandler<unknown>;
@@ -311,7 +336,10 @@ interface LeaseOptions {
   /** How long the lease holds without an `extend`. Defaults to 60 seconds. */
   readonly seconds?: number;
   readonly scope?: string;
-  /** The schema the functions live in, over a transport. Defaults to `better_supabase`. */
+  /**
+   * The schema the functions live in, over a transport. Defaults to
+   * `better_supabase`.
+   */
   readonly schema?: string;
 }
 /** The held lease, passed to the `withLease` callback. */
@@ -330,9 +358,9 @@ type LeaseOutcome<T> = {
  * Runs `fn` while holding the lease on `key`, one holder at a time, and
  * releases it afterwards, also when `fn` throws. `{ acquired: false }` while
  * another holder has it. A lease that expires mid-run is taken by the next
- * caller; call `lease.extend()` for long work. Takes a service SQL
- * connection, or a service-role `rpcTransport` over the wrappers
- * `blocks.idempotency.api` writes.
+ * caller; call `lease.extend()` for long work. Takes a service SQL connection,
+ * or a service-role `rpcTransport` over the wrappers `blocks.idempotency.api`
+ * writes.
  */
 export declare function withLease<T>(source: SqlClient | BlockTransport, key: string, fn: (lease: Lease) => Promise<T> | T, options?: LeaseOptions): AsyncResult<LeaseOutcome<T>>;
 //#endregion
@@ -370,19 +398,25 @@ interface VercelQueueClient {
 interface VercelQueueBackendOptions {
   /** The consumer group that reads the topics. Default `better-supabase`. */
   readonly consumerGroup?: string;
-  /** Seconds a failed message waits before redelivery when `fail` gives no delay. Default 30. */
+  /**
+   * Seconds a failed message waits before redelivery when `fail` gives no
+   * delay. Default 30.
+   */
   readonly retryAfter?: number;
-  /** Milliseconds `read` waits for the rest of a batch after the first message. Default 25. */
+  /**
+   * Milliseconds `read` waits for the rest of a batch after the first message.
+   * Default 25.
+   */
   readonly settle?: number;
 }
 /**
  * Stores jobs on Vercel Queues through a `PollingQueueClient`. Queue names are
  * topic names. `read` holds each message open inside the client's `receive`
  * handler (the client keeps the visibility timeout alive), `complete`
- * acknowledges it and `fail` throws so the topic redelivers it after the
- * retry delay. Vercel Queues has no dead letters, schedules or ids that fit a
- * number, so ids are local handles, a message past `maxAttempts` is
- * acknowledged and dropped, and schedules need the SQL backend.
+ * acknowledges it and `fail` throws so the topic redelivers it after the retry
+ * delay. Vercel Queues has no dead letters, schedules or ids that fit a number,
+ * so ids are local handles, a message past `maxAttempts` is acknowledged and
+ * dropped, and schedules need the SQL backend.
  */
 export declare function vercelQueueBackend(client: VercelQueueClient, options?: VercelQueueBackendOptions): QueueBackend;
 //#endregion
@@ -438,8 +472,8 @@ interface RateLimit {
 /** Where `createRateLimit` keeps its counters: a transport or a SQL connection. */
 type RateLimitSource = {
   /**
-   * A service-role transport, such as `rpcTransport(adminClient)`, over
-   * the `rate-limit` module's functions.
+   * A service-role transport, such as `rpcTransport(adminClient)`, over the
+   * `rate-limit` module's functions.
    */
   readonly transport: BlockTransport;
   readonly sql?: never;
@@ -449,7 +483,10 @@ type RateLimitSource = {
   readonly transport?: never;
 };
 interface RateLimitSettings extends BlockTemporalOptions {
-  /** The schema the functions live in, over a transport. Defaults to `better_supabase`. */
+  /**
+   * The schema the functions live in, over a transport. Defaults to
+   * `better_supabase`.
+   */
   readonly schema?: string;
   /** Error mappers that run before the built-in ones. */
   readonly mappers?: readonly ErrorMapper[];
@@ -461,9 +498,9 @@ interface RateLimitSettings extends BlockTemporalOptions {
 type RateLimitOptions = RateLimitSource & RateLimitSettings;
 /**
  * Fixed-window limits for keys that aren't claims, over the `rate-limit`
- * module's counters. Pass `sql`, a service SQL connection
- * (`ctx.postgresAdmin`, `postgres.admin`), or `transport`, a service-role
- * `BlockTransport` such as `rpcTransport(adminClient)`.
+ * module's counters. Pass `sql`, a service SQL connection (`ctx.postgresAdmin`,
+ * `postgres.admin`), or `transport`, a service-role `BlockTransport` such as
+ * `rpcTransport(adminClient)`.
  */
 export declare function createRateLimit(options: RateLimitOptions): RateLimit;
 /** A `problem+json` 429 with `Retry-After`, for a refused `check`. */

package/dist/blocks/jobs/index.js

@@ -1,22 +1,22 @@
 import { t as DbException } from "../../db-exception-CnWcYPxL.js";
-import { n as dbError } from "../../errors-BV1SKTVs.js";
-import { s as nowInstant } from "../../temporal-CB5Fpo5d.js";
-import { t as temporal } from "../../temporal-required-nfZ87U-0.js";
-import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DIeYscA3.js";
+import { n as dbError } from "../../errors-D7u24ZJH.js";
+import { s as nowInstant } from "../../temporal-DLZlWbOi.js";
+import { t as temporal } from "../../temporal-required-Dt4mcPsi.js";
+import { a as ok, r as err, s as toDbError, t as AsyncResult } from "../../result-DIT_qp4G.js";
 import { n as isRecord } from "../../guards-6F2bCtQR.js";
-import { n as allTenantsContext } from "../../plugin-tfXW1-qO.js";
-import { n as validate } from "../../standard-B1BigegP.js";
-import { o as problemResponse } from "../../problem-JRCohp1j.js";
-import { o as tenantFrom, s as tenantPathsFor } from "../../claims-PqzCxaTD.js";
+import { n as allTenantsContext } from "../../plugin-D9bYbYli.js";
+import { n as validate } from "../../standard-l10kE0yS.js";
+import { o as problemResponse } from "../../problem-D0KDiYPk.js";
+import { o as tenantFrom, s as tenantPathsFor } from "../../claims-Bp9My7XP.js";
 import { n as rateLimitSqlOptions, r as webhookInboxSqlOptions, t as jobsSqlOptions } from "../../options-OJ5zmgr8.js";
-import { t as cronRoute } from "../../cron-route-mTvWhork.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
-import { M as seconds, P as sleep, R as toInstant, f as errorText, g as leaseHeartbeat, j as run, n as applyTemporal, o as blockCall, s as budget, w as pageOf } from "../../block-helpers-DkVZNDrj.js";
-import { n as periodSeconds } from "../../ratelimit-headers-Bsxx0Tj2.js";
-import { n as nextCronRun, t as assertCron } from "../../cron-BHdXZFsJ.js";
-import { r as withBlockHooks } from "../../block-hooks-C22vuIUd.js";
-import { a as purgeWebhookInbox, i as createWebhookInbox, r as rateLimited, t as createRateLimit } from "../../rate-limit-I3AncmM8.js";
-import { r as wrapPayload, t as unwrap } from "../../envelope-C4Z55LKW.js";
+import { t as cronRoute } from "../../cron-route-BbVtwXZz.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
+import { M as seconds, P as sleep, R as toInstant, f as errorText, g as leaseHeartbeat, j as run, n as applyTemporal, o as blockCall, s as budget, w as pageOf } from "../../block-helpers-DwE32_gT.js";
+import { n as periodSeconds } from "../../ratelimit-headers-kEcXyO3H.js";
+import { n as nextCronRun, t as assertCron } from "../../cron-CI1kP-t5.js";
+import { r as withBlockHooks } from "../../block-hooks-C1r-R2r0.js";
+import { a as purgeWebhookInbox, i as createWebhookInbox, r as rateLimited, t as createRateLimit } from "../../rate-limit-CpTD_WHm.js";
+import { r as wrapPayload, t as unwrap } from "../../envelope-BDShQQ7-.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
 //#region src/blocks/jobs/dev.ts
 function devDrainSecret(env, name = "CRON_SECRET") {
@@ -64,12 +64,18 @@ function devDrain(options) {
 //#endregion
 //#region src/blocks/jobs/backends.ts
 const instantOrNull = (value) => value === null ? null : toInstant(value);
-/** Schedule times are stored to the millisecond, the precision `Date` reads back. */
+/**
+* Schedule times are stored to the millisecond, the precision `Date` reads
+* back.
+*/
 const millis = (instant) => instant.round({
 	smallestUnit: "millisecond",
 	roundingMode: "floor"
 });
-/** The first run of a schedule written without one, or undefined for a cron the drain can't read. */
+/**
+* The first run of a schedule written without one, or undefined for a cron the
+* drain can't read.
+*/
 function firstRun(row, now) {
 	try {
 		return millis(nextCronRun(row.schedule, row.timezone, row.first_after ? toInstant(row.first_after) : now()));
@@ -78,8 +84,8 @@ function firstRun(row, now) {
 	}
 }
 /**
-* The due schedules among claimed rows. A row written in SQL without a next
-* run gets its first run here; one not due yet is moved to it with `advance`.
+* The due schedules among claimed rows. A row written in SQL without a next run
+* gets its first run here; one not due yet is moved to it with `advance`.
 */
 async function dueOf(rows, now, advance) {
 	const due = [];
@@ -134,9 +140,9 @@ const onceOf = (row) => {
 	};
 };
 /**
-* The `jobs` SQL module over a service SQL connection. The same
-* functions back both `blocks.jobs.options.backend` values (pgmq and table)
-* and both schedulers. `now` dates a schedule's first run.
+* The `jobs` SQL module over a service SQL connection. The same functions back
+* both `blocks.jobs.options.backend` values (pgmq and table) and both
+* schedulers. `now` dates a schedule's first run.
 */
 function sqlQueueBackend(sql, now = nowInstant) {
 	return {
@@ -352,10 +358,10 @@ function transportRows(fn, value) {
 }
 /**
 * The `jobs` SQL module over a `BlockTransport`, with named arguments: a
-* service-role `rpcTransport(supabase, { schema: "api" })` reaches the
-* wrappers `blocks.jobs.api` writes, so stats, dead letters, replays
-* and schedules work without a direct Postgres connection. Over Postgres,
-* pass the `SqlClient` to `createJobs` instead.
+* service-role `rpcTransport(supabase, { schema: "api" })` reaches the wrappers
+* `blocks.jobs.api` writes, so stats, dead letters, replays and schedules work
+* without a direct Postgres connection. Over Postgres, pass the `SqlClient` to
+* `createJobs` instead.
 */
 function transportQueueBackend(transport, options = {}) {
 	const schema = options.schema ?? "better_supabase";
@@ -405,8 +411,8 @@ function sqlOnly(feature) {
 }
 /**
 * Supabase's `pgmq_public` RPCs (Integrations, Queues, "Expose Queues via
-* PostgREST"). No lease check on complete, no retry delay, no deduplication
-* and no schedules: a failed job reappears when its lease ends.
+* PostgREST"). No lease check on complete, no retry delay, no deduplication and
+* no schedules: a failed job reappears when its lease ends.
 */
 function pgmqPublicBackend(client) {
 	const untyped = client;
@@ -479,7 +485,7 @@ const AUTH_COOKIE = /^sb-.+-auth-token(?:\.\d+)?$/;
 /** A hash of the credentials the request carries, or `''` without any. */
 async function callerScope(request) {
 	const authorization = request.headers.get("authorization");
-	const cookies = (request.headers.get("cookie") ?? "").split(";").map((pair) => pair.trim()).filter((pair) => AUTH_COOKIE.test(pair.split("=", 1)[0] ?? "")).sort();
+	const cookies = (request.headers.get("cookie") ?? "").split(";").map((pair) => pair.trim()).filter((pair) => AUTH_COOKIE.test(pair.split("=", 1)[0] ?? "")).toSorted();
 	const credential = authorization ?? cookies.join(";");
 	return credential === "" ? "" : `caller:${await sha256(credential)}`;
 }
@@ -560,9 +566,9 @@ function transportCalls$1(transport, schema, mappers) {
 	};
 }
 /**
-* HTTP idempotency keys (IETF `Idempotency-Key` header) over the
-* `idempotency` SQL module: a service SQL connection, or a service-role
-* `rpcTransport` over the wrappers `blocks.idempotency.api` writes.
+* HTTP idempotency keys (IETF `Idempotency-Key` header) over the `idempotency`
+* SQL module: a service SQL connection, or a service-role `rpcTransport` over
+* the wrappers `blocks.idempotency.api` writes.
 */
 function createIdempotency(options) {
 	applyTemporal(options);
@@ -733,9 +739,9 @@ function transportCalls(transport, schema) {
 * Runs `fn` while holding the lease on `key`, one holder at a time, and
 * releases it afterwards, also when `fn` throws. `{ acquired: false }` while
 * another holder has it. A lease that expires mid-run is taken by the next
-* caller; call `lease.extend()` for long work. Takes a service SQL
-* connection, or a service-role `rpcTransport` over the wrappers
-* `blocks.idempotency.api` writes.
+* caller; call `lease.extend()` for long work. Takes a service SQL connection,
+* or a service-role `rpcTransport` over the wrappers `blocks.idempotency.api`
+* writes.
 */
 function withLease(source, key, fn, options = {}) {
 	const scope = options.scope ?? "";
@@ -765,10 +771,10 @@ const TOPIC = /^[A-Za-z0-9_-]+$/;
 * Stores jobs on Vercel Queues through a `PollingQueueClient`. Queue names are
 * topic names. `read` holds each message open inside the client's `receive`
 * handler (the client keeps the visibility timeout alive), `complete`
-* acknowledges it and `fail` throws so the topic redelivers it after the
-* retry delay. Vercel Queues has no dead letters, schedules or ids that fit a
-* number, so ids are local handles, a message past `maxAttempts` is
-* acknowledged and dropped, and schedules need the SQL backend.
+* acknowledges it and `fail` throws so the topic redelivers it after the retry
+* delay. Vercel Queues has no dead letters, schedules or ids that fit a number,
+* so ids are local handles, a message past `maxAttempts` is acknowledged and
+* dropped, and schedules need the SQL backend.
 */
 function vercelQueueBackend(client, options = {}) {
 	const group = options.consumerGroup ?? "better-supabase";
@@ -873,7 +879,10 @@ function vercelQueueBackend(client, options = {}) {
 }
 //#endregion
 //#region src/blocks/jobs/queue.ts
-/** Transient claim errors in a row a lane retries, with backoff, before the loop throws. */
+/**
+* Transient claim errors in a row a lane retries, with backoff, before the loop
+* throws.
+*/
 const CLAIM_RETRIES = 3;
 /** The abort reason of a job whose lease couldn't be extended. */
 const LEASE_LOST = Symbol("lease lost");
@@ -953,10 +962,9 @@ function createJobs(options) {
 		return (await transport.read(queue, claimOptions.lease ?? 300, claimOptions.batch ?? 1)).map((row) => toJob(queue, row));
 	});
 	/**
-	* Extends the lease of every job in `held` at half the lease, so jobs
-	* waiting their turn in a claimed batch don't expire before they run.
-	* A job whose lease can't be extended is aborted: another worker may
-	* already hold it.
+	* Extends the lease of every job in `held` at half the lease, so jobs waiting
+	* their turn in a claimed batch don't expire before they run. A job whose
+	* lease can't be extended is aborted: another worker may already hold it.
 	*/
 	const heartbeat = (held, lease) => transport.leases ? leaseHeartbeat(lease, () => {
 		for (const [job, controller] of held) run(() => transport.extend(job, lease)).then((extended) => {
@@ -1109,13 +1117,16 @@ function createJobs(options) {
 		}] }));
 		return ok(delay ?? (enqueueOptions.runAt ? Math.max(0, Math.ceil((enqueueOptions.runAt.epochMilliseconds - now().epochMilliseconds) / 1e3)) : 0));
 	};
-	/** The validated payload in its envelope, and the delay, for `enqueue` and `enqueueOnce`. */
+	/**
+	* The validated payload in its envelope, and the delay, for `enqueue` and
+	* `enqueueOnce`.
+	*/
 	const prepareSend = async (queue, payload, enqueueOptions) => {
 		const valid = await validate(schemaOf(queue), payload, "payload");
 		if (!valid.ok) return valid;
 		const delay = delayOf(enqueueOptions);
 		if (!delay.ok) return delay;
-		const message = wrapPayload(valid.data, enqueueOptions.context, { ...enqueueOptions.ticket === void 0 ? {} : { ticket: enqueueOptions.ticket } });
+		const message = wrapPayload(valid.data, enqueueOptions.context, enqueueOptions.ticket === void 0 ? {} : { ticket: enqueueOptions.ticket });
 		if (!message.ok) return message;
 		return ok({
 			message: message.data,

package/dist/blocks/knowledge/index.d.ts

@@ -1,6 +1,6 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DezJPPA0.js";
-import { a as KnowledgeDocument, c as KnowledgeOptions, d as KnowledgeSearchOptions, f as KnowledgeStatus, h as createKnowledge, i as KnowledgeChunk, l as KnowledgeQuery, m as chunk, n as Embedder, o as KnowledgeHit, p as NewKnowledgeDocument, r as Knowledge, s as KnowledgeHooks, t as ChunkOptions, u as KnowledgeScope } from "../../knowledge-CRk1jOAJ.js";
-import { s as BlockOf } from "../../define-block-CPyJ95rq.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DBPhgF3W.js";
+import { a as KnowledgeDocument, c as KnowledgeOptions, d as KnowledgeSearchOptions, f as KnowledgeStatus, h as createKnowledge, i as KnowledgeChunk, l as KnowledgeQuery, m as chunk, n as Embedder, o as KnowledgeHit, p as NewKnowledgeDocument, r as Knowledge, s as KnowledgeHooks, t as ChunkOptions, u as KnowledgeScope } from "../../knowledge-CYdNJasZ.js";
+import { s as BlockOf } from "../../define-block-MyM4lH42.js";
 //#region src/blocks/knowledge/manifest.d.ts
 /** The `knowledge` block's manifest (ADR 0029). */
 export declare const knowledgeBlock: BlockOf<"knowledge", typeof createKnowledge, Record<never, never>, {

package/dist/blocks/knowledge/index.js

@@ -1,7 +1,7 @@
 import { t as knowledgeSqlOptions } from "../../options-kLKILdIu.js";
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-J7ZepTq2.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-Ds0C2mUf.js";
 import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
-import { n as chunk, r as createKnowledge } from "../../knowledge-BbdXOJvY.js";
+import { n as chunk, r as createKnowledge } from "../../knowledge-Bx_qehoZ.js";
 //#region src/blocks/knowledge/manifest.ts
 /** The `knowledge` block's manifest (ADR 0029). */
 const knowledgeBlock = defineBlock({