better-supabase 0.2.0 → 0.4.0

package/dist/{index-DbxFr7XG.d.ts → index-BhHEC04r.d.ts}

@@ -1,5 +1,5 @@
-import { A as SchemaMeta } from "./types-C83v5SQz.js";
-import { f as OpenApiParameter } from "./index-Bw1bwtC0.js";
+import { A as SchemaMeta } from "./types-DONv9SHN.js";
+import { p as OpenApiParameter } from "./index-BAy4tsAP.js";
 //#region src/openapi/index.d.ts
 type Json = Record<string, unknown>;
 type ResourceOperation = "list" | "get" | "create" | "update" | "delete";
@@ -9,7 +9,12 @@ interface ResourceOptions {
   /** Parameters for `list`, from `defineListQuery`. */
   readonly list?: {
     readonly openapi: readonly OpenApiParameter[];
+    readonly pagination?: "offset" | "cursor";
   };
+  /** Paging of the default list, as in `defineResource`. Defaults to `offset`. */
+  readonly pagination?: "offset" | "cursor";
+  /** Largest page of the default list. Defaults to 200. */
+  readonly maxPageSize?: number;
   /** Path of the collection. Defaults to `/<table>`. */
   readonly path?: string;
   readonly tag?: string;
@@ -63,13 +68,13 @@ declare const PROBLEM_SCHEMA: Json;
  * schemes and Problem Details errors.
  *
  * ```ts
- * const doc = createOpenApi(sb, {
+ * const doc = createOpenApi(betterSupabase, {
  *   info: { title: 'CRM API', version: '1.0.0' },
  *   resources: { customers: { list: customerList }, notes: { operations: ['list', 'get'] } },
  * });
  * ```
  */
-declare function createOpenApi(sb: {
+declare function createOpenApi(betterSupabase: {
   readonly meta: SchemaMeta;
 }, options: OpenApiOptions): OpenApiDocument;
 //#endregion

package/dist/index-Cf-D2jk1.d.ts

@@ -0,0 +1,50 @@
+import { A as SchemaMeta, s as ClaimsMeta } from "./types-DONv9SHN.js";
+import { d as Generator } from "./config-C1CYcm6o.js";
+//#region src/core/claims.d.ts
+declare const DEFAULT_CLAIMS: ClaimsMeta;
+/** Where the active tenant is read from: the top-level claim, then `app_metadata`. */
+declare function tenantClaimPaths(tenant?: string): readonly [string, string];
+//#endregion
+//#region src/generators/shared.d.ts
+/** What field planning reads: the metadata and the typed-jsonb config. */
+interface SchemaSource {
+  readonly meta: SchemaMeta;
+  readonly config: {
+    readonly json: Readonly<Record<string, unknown>>;
+  };
+}
+//#endregion
+//#region src/generators/json-schema.d.ts
+interface JsonSchemaGeneratorOptions {
+  /** Output path relative to the project root. Defaults to `<output>.schema.json`. */
+  readonly output?: string;
+  /** `$id` of the document. */
+  readonly id?: string;
+}
+type JsonSchema = Record<string, unknown>;
+/** JSON Schema (2020-12) `$defs` for every table: `customersRow`, `customersInsert`, ... */
+declare function buildJsonSchema(input: SchemaSource, id?: string): JsonSchema;
+/** Writes the JSON Schema document; `createOpenApi` reuses the same `$defs`. */
+declare function jsonSchema(options?: JsonSchemaGeneratorOptions): Generator;
+//#endregion
+//#region src/generators/valibot.d.ts
+interface ValibotGeneratorOptions {
+  /** Output path relative to the project root. Defaults to `<output>.valibot.ts`. */
+  readonly output?: string;
+  /** Schemas for typed jsonb columns: `{ 'customers.metadata': './schemas.ts#metadata' }`. */
+  readonly json?: Readonly<Record<string, string>>;
+}
+/** Valibot schemas for every table's Row, Insert and Update shape. */
+declare function valibot(options?: ValibotGeneratorOptions): Generator;
+//#endregion
+//#region src/generators/zod.d.ts
+interface ZodGeneratorOptions {
+  /** Output path relative to the project root. Defaults to `<output>.zod.ts`. */
+  readonly output?: string;
+  /** Schemas for typed jsonb columns: `{ 'customers.metadata': './schemas.ts#metadata' }`. */
+  readonly json?: Readonly<Record<string, string>>;
+}
+/** Zod 4 schemas for every table's Row, Insert and Update shape. */
+declare function zod(options?: ZodGeneratorOptions): Generator;
+//#endregion
+export { JsonSchemaGeneratorOptions as a, DEFAULT_CLAIMS as c, valibot as i, tenantClaimPaths as l, zod as n, buildJsonSchema as o, ValibotGeneratorOptions as r, jsonSchema as s, ZodGeneratorOptions as t };

package/dist/{index-Ciu5Xlml.d.ts → index-D5IfUIDh.d.ts}

@@ -1,6 +1,7 @@
-import { A as SchemaMeta } from "./types-C83v5SQz.js";
-import { a as EventHub, s as MutationNotice } from "./events-DOt3nSO-.js";
-import { l as MutationKind } from "./plugin-C4TR9J0Z.js";
+/// <reference lib="esnext.temporal" />
+import { A as SchemaMeta } from "./types-DONv9SHN.js";
+import { a as EventHub, s as MutationNotice } from "./events-B21UOhvP.js";
+import { l as MutationKind } from "./plugin-bNhvJwRh.js";
 //#region src/events/index.d.ts
 /** A CloudEvents 1.0 event. Extension attributes are lowercase alphanumerics. */
 interface CloudEvent<T = unknown> {
@@ -26,7 +27,7 @@ interface CloudEventOptions {
   /** Replaces the `dev.better-supabase` type prefix. */
   readonly typePrefix?: string;
   readonly id?: () => string;
-  readonly now?: () => Date;
+  readonly now?: () => Temporal.Instant;
 }
 /** Sends events somewhere: a queue, a bus, an outbox table, an HTTP endpoint. */
 interface EventSink {
@@ -50,7 +51,7 @@ interface ForwardOptions extends CloudEventOptions {
  * Sends a CloudEvent for every mutation to `sink`. Returns a function that
  * stops forwarding. Use an outbox (SQL kit) when events must not be lost.
  */
-declare function forwardMutations(sb: {
+declare function forwardMutations(betterSupabase: {
   readonly events: EventHub;
   readonly meta: SchemaMeta;
 }, sink: EventSink, options: ForwardOptions): () => void;

package/dist/{index-K-3WM2Hp.d.ts → index-DFmOpBGC.d.ts}

@@ -1,6 +1,6 @@
-import { C as PrimaryKeyValue, L as UniqueWhere, N as TableKey, R as Update, _ as Insert, n as AnyModels, t as AnyFunctions } from "./types-C83v5SQz.js";
-import { _ as DbException } from "./result-CTkCZ6JA.js";
-import { C as FindExt, Ct as WhereInput, M as UpsertArgs, N as WriteArgs, S as DeleteExt, T as OffsetPageArgs, X as InferResult, Z as QuerySpec, _ as CursorPage, it as AggregateResult, j as UpdateArgs, k as Returned, l as CacheAdapter, lt as FindFirstArgs, rt as AggregateArgs, st as CountArgs, t as BetterSupabase, ut as FindManyArgs, v as CursorPageArgs, vt as Payload, w as OffsetPage, x as DeleteArgs, y as Db, yt as ReadArgs } from "./define-e3zI4_4g.js";
+import { C as PrimaryKeyValue, L as UniqueWhere, N as TableKey, R as Update, g as Insert, n as AnyModels, t as AnyFunctions } from "./types-DONv9SHN.js";
+import { _ as DbException } from "./result-CqEsbgYs.js";
+import { C as FindExt, Ct as WhereInput, M as UpsertArgs, N as WriteArgs, S as DeleteExt, T as OffsetPageArgs, X as InferResult, Z as QuerySpec, _ as CursorPage, it as AggregateResult, j as UpdateArgs, k as Returned, l as CacheAdapter, lt as FindFirstArgs, rt as AggregateArgs, st as CountArgs, t as BetterSupabase, ut as FindManyArgs, v as CursorPageArgs, vt as Payload, w as OffsetPage, x as DeleteArgs, y as Db, yt as ReadArgs } from "./define-CRS2MRV3.js";
 import { DataTag, InfiniteData, QueryClient, SkipToken } from "@tanstack/query-core";
 //#region src/query/invalidate.d.ts
 /** Carried by every better-supabase query: the tables whose changes make it stale. */
@@ -14,7 +14,7 @@ interface BetterQueryMeta {
  */
 declare function invalidateTables(client: QueryClient, tables: readonly string[]): Promise<void>;
 //#endregion
-//#region src/query/index.d.ts
+//#region src/query/queries.d.ts
 type QueryKeyOf<T> = DataTag<readonly unknown[], T, DbException>;
 type QueryFnOf<T> = ((context: {
   readonly signal: AbortSignal;
@@ -76,7 +76,7 @@ interface TableQueries<M extends AnyModels, T extends TableKey<M>, E> {
 type RpcArgsOf<F extends AnyFunctions, N extends keyof F> = F[N]["Args"];
 interface QueryHelpers<M extends AnyModels, F extends AnyFunctions> {
   /** Prefix of every better-supabase key. */
-  readonly key: readonly ["bs"];
+  readonly $key: readonly ["bs"];
   /** Query options for a `QuerySpec`, for example one sent from a Server Component. */
   $spec<S extends QuerySpec<TableKey<M>>>(spec: S | SkipToken): QueryOptionsOf<InferResult<S>>;
   /** Fetches a spec into `queryClient` for server rendering and hydration. */
@@ -85,11 +85,11 @@ interface QueryHelpers<M extends AnyModels, F extends AnyFunctions> {
   $rpc<N extends Extract<keyof F, string>>(name: N, args?: RpcArgsOf<F, N> | SkipToken, options?: {
     readonly tables?: readonly TableKey<M>[];
   }): QueryOptionsOf<F[N]["Returns"]>;
-  /** Mutation options for a database function; invalidates what `sb.defineRpc` declared. */
+  /** Mutation options for a database function; invalidates what `betterSupabase.defineRpc` declared. */
   $rpcMutation<N extends Extract<keyof F, string>>(name: N): MutationOptionsOf<RpcArgsOf<F, N>, F[N]["Returns"]>;
 }
-type Queries<M extends AnyModels, E, F extends AnyFunctions = AnyFunctions> = { readonly [T in TableKey<M>]: TableQueries<M, T, E>; } & QueryHelpers<M, F>;
-interface CreateQueriesOptions {
+type BetterQueries<M extends AnyModels, E, F extends AnyFunctions = AnyFunctions> = { readonly [T in TableKey<M>]: TableQueries<M, T, E>; } & QueryHelpers<M, F>;
+interface QueriesOptions {
   /**
    * `staleTime` for every query option. Set it above zero when rendering on
    * the server so hydrated data isn't refetched on mount.
@@ -104,14 +104,14 @@ interface CreateQueriesOptions {
  * changed table.
  *
  * ```ts
- * const q = createQueries(sb, () => browser.db);
+ * const q = createQueries(betterSupabase, () => bs.db);
  * const { data } = useQuery(q.customers.findMany({ select: ['id', 'name'] }));
  * ```
  */
-declare function createQueries<M extends AnyModels, D, F extends AnyFunctions, E>(sb: BetterSupabase<M, D, F, E>, db: Db<M, F, E, unknown> | (() => Db<M, F, E, unknown>), options?: CreateQueriesOptions): Queries<M, E, F>;
+declare function createQueries<M extends AnyModels, D, F extends AnyFunctions, E>(betterSupabase: BetterSupabase<M, D, F, E>, db: Db<M, F, E, unknown> | (() => Db<M, F, E, unknown>), options?: QueriesOptions): BetterQueries<M, E, F>;
 /** Invalidates every query that read a table in the target. */
 declare function queryCache(client: QueryClient): CacheAdapter;
-/** Invalidates affected queries for every mutation and declared RPC `sb` performs in this runtime. */
-declare function invalidateOnMutation<M extends AnyModels, D, F extends AnyFunctions, E>(sb: BetterSupabase<M, D, F, E>, client: QueryClient): () => void;
+/** Invalidates affected queries for every mutation and declared RPC `betterSupabase` performs in this runtime. */
+declare function invalidateOnMutation<M extends AnyModels, D, F extends AnyFunctions, E>(betterSupabase: BetterSupabase<M, D, F, E>, client: QueryClient): () => void;
 //#endregion
-export { QueryHelpers as a, TableQueries as c, queryCache as d, BetterQueryMeta as f, Queries as i, createQueries as l, InfiniteOptionsOf as n, QueryKeyOf as o, invalidateTables as p, MutationOptionsOf as r, QueryOptionsOf as s, CreateQueriesOptions as t, invalidateOnMutation as u };
+export { QueryHelpers as a, TableQueries as c, queryCache as d, BetterQueryMeta as f, QueriesOptions as i, createQueries as l, InfiniteOptionsOf as n, QueryKeyOf as o, invalidateTables as p, MutationOptionsOf as r, QueryOptionsOf as s, BetterQueries as t, invalidateOnMutation as u };

package/dist/{index-D4v7sncu.d.ts → index-RlLXd8dL.d.ts}

@@ -1,10 +1,10 @@
-import { n as AnyModels, t as AnyFunctions } from "./types-C83v5SQz.js";
-import { t as BetterSupabase, y as Db } from "./define-e3zI4_4g.js";
+import { n as AnyModels, t as AnyFunctions } from "./types-DONv9SHN.js";
+import { t as BetterSupabase, y as Db } from "./define-CRS2MRV3.js";
 import { c as PublicEnv } from "./index-Dy6kuF0P.js";
-import { i as Queries } from "./index-K-3WM2Hp.js";
+import { t as BetterQueries } from "./index-DFmOpBGC.js";
 import { SupabaseClient } from "@supabase/supabase-js";
 //#region src/client/index.d.ts
-interface BrowserOptions {
+interface ClientOptions {
   /** URL and publishable key. Not needed when `client` is given. */
   readonly env?: PublicEnv;
   /** Bring your own supabase-js client (React Native, custom storage). */
@@ -34,29 +34,29 @@ type AuthSnapshot = {
   readonly user: AuthUser;
   readonly claims: Readonly<Record<string, unknown>>;
 };
-interface BrowserAuth {
+interface ClientAuth {
   readonly current: () => AuthSnapshot;
   /** `useSyncExternalStore`-compatible. */
   readonly subscribe: (listener: () => void) => () => void;
 }
-interface BetterBrowser<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown> {
-  /** The definition the browser was created from (schema metadata, specs, live queries). */
-  readonly sb: BetterSupabase<M, unknown, F, E, C, P>;
+interface BetterClient<M extends AnyModels, F extends AnyFunctions, E, C = unknown, P = unknown> {
+  /** The definition the client was created from (schema metadata, specs, live queries). */
+  readonly betterSupabase: BetterSupabase<M, unknown, F, E, C, P>;
   readonly supabase: SupabaseClient;
   /** Repositories with the current session's actor and claims. */
   readonly db: Db<M, F, E, SupabaseClient>;
   /** TanStack Query option factories over `db`. */
-  readonly queries: Queries<M, E, F>;
-  readonly auth: BrowserAuth;
+  readonly queries: BetterQueries<M, E, F>;
+  readonly auth: ClientAuth;
 }
 /**
  * The browser side: a supabase-js client, repositories that follow the
  * session, TanStack Query options and an auth store for UI state.
  *
  * ```ts
- * export const browser = createBrowser(sb, { env: { url, publishableKey } });
+ * export const bs = createClient(betterSupabase, { env: { url, publishableKey } });
  * ```
  */
-declare function createBrowser<M extends AnyModels, D, F extends AnyFunctions, E, C = unknown, P = unknown>(sb: BetterSupabase<M, D, F, E, C, P>, options?: BrowserOptions): BetterBrowser<M, F, E, C, P>;
+declare function createClient$1<M extends AnyModels, D, F extends AnyFunctions, E, C = unknown, P = unknown>(betterSupabase: BetterSupabase<M, D, F, E, C, P>, options?: ClientOptions): BetterClient<M, F, E, C, P>;
 //#endregion
-export { BrowserOptions as a, BrowserAuth as i, AuthUser as n, createBrowser as o, BetterBrowser as r, AuthSnapshot as t };
+export { ClientOptions as a, ClientAuth as i, AuthUser as n, createClient$1 as o, BetterClient as r, AuthSnapshot as t };

package/dist/index.d.ts

@@ -1,14 +1,14 @@
-import { A as SchemaMeta, C as PrimaryKeyValue, D as Relations, E as RelationShape, F as UniqueConstraint, I as UniqueKeyName, L as UniqueWhere, M as TableFlags, N as TableKey, O as Row, P as TableMeta, R as Update, S as PrimaryKeyColumn, T as RelationMeta, _ as Insert, a as Casing, b as PermdockBucketPolicy, c as Codec, d as Flags, f as FlagsShape, g as FunctionsOf, h as FunctionShape, i as BucketPolicyName, j as Simplify, k as Schema, l as ColumnMeta, m as FunctionMeta, n as AnyModels, o as CheckConstraint, p as ForeignKeyConstraint, r as BucketMeta, s as ClaimsMeta, t as AnyFunctions, u as DatabaseOf, v as ModelShape, w as RealtimeTableMeta, x as PermdockTopicPolicy, y as ModelsOf } from "./types-C83v5SQz.js";
-import { C as and, E as or, S as UpdateOp, T as not, _ as OrderTerm, a as AggregateFn, b as SelectOp, c as Condition, d as FunctionSource, f as Include, g as Operation, h as MutationOp, i as RpcContext, l as CountMode, m as Measure, n as ExecuteResult, o as Aggregation, p as InsertOp, r as Executor, s as ColumnOp, t as ExecuteContext, u as DeleteOp, v as Quantifier, w as column, x as Selection, y as SelectColumn } from "./executor-CGdNQ27g.js";
-import { C as isConflict, D as statusOf, E as mapDbError, S as isCheck, T as isForeignKey, _ as DbException, a as Ok, b as ValidationIssue, c as err, d as toBetterResult, f as toDbError, g as DbErrorOf, h as DbErrorKinds, i as Err, l as fromBetterResult, m as DbErrorKind, n as BetterResultApi, o as Result, p as DbError, r as BetterResultShape, t as AsyncResult, u as ok, v as ErrorMapper, w as isDbError, x as dbError, y as RawDbError } from "./result-CTkCZ6JA.js";
-import { a as EventHub, c as QueryEvent, d as LogFields, f as Logger, i as EventHandler, l as RefreshEvent, m as silentLogger, n as BetterSupabaseEvents, o as EventName, p as consoleLogger, r as ErrorEvent, s as MutationNotice, t as AuthEvent, u as RpcNotice } from "./events-DOt3nSO-.js";
-import { $ as Specs, A as RpcOptions, B as ReadSet, C as FindExt, Ct as WhereInput, D as Repository, E as PageOf, F as EMPTY_STATS, G as ReadSetParams, H as ReadSetParamType, I as StatsRecorder, J as isReadSet, K as ReadSetResult, L as recordStats, M as UpsertArgs, N as WriteArgs, O as RepositoryOf, P as DbStats, Q as ReadMethod, R as SearchArgs, S as DeleteExt, St as SortDirection, T as OffsetPageArgs, U as ReadSetParamTypes, V as ReadSetOptions, W as ReadSetParamValue, X as InferResult, Y as readSetTables, Z as QuerySpec, _ as CursorPage, _t as OrderByInput, a as defineSupabase, at as AggregateRow, b as DbHelpers, bt as RelationMeasureArg, c as postgrestExecutor, ct as FieldFilter, d as MemoryCache, dt as IncludeArg, et as TableSpecs, f as cacheTargetOf, ft as IncludeArgs, g as ConflictTarget, gt as OrderByArg, h as rpcCacheTargets, ht as NumericMeasureArg, i as RpcDefinition, it as AggregateResult, j as UpdateArgs, k as Returned, l as CacheAdapter, lt as FindFirstArgs, m as rowKey, mt as MeasureKey, n as ConnectOptions, nt as specTables, o as PostgrestClientLike, ot as CountArg, p as memoryCache, pt as MeasureArg, q as defineReadSet, r as DefineSupabaseOptions, rt as AggregateArgs, s as explainPostgrest, st as CountArgs, t as BetterSupabase, tt as isQuerySpec, u as CacheTarget, ut as FindManyArgs, v as CursorPageArgs, vt as Payload, w as OffsetPage, x as DeleteArgs, xt as SelectArg, y as Db, yt as ReadArgs, z as InferReadSetParams } from "./define-e3zI4_4g.js";
-import { _ as definePlugin, a as ExtensionOf, c as MutationEvent, d as PLUGIN_API_VERSION, f as Plugin, g as WithExtension, h as RequestContext, i as CallOptions, l as MutationKind, m as RepositoryExtension, n as AnyPlugin, o as HasFlag, p as RepositoryApi, r as ApplyExtension, s as HookArgs, t as Actor, u as NoExtension } from "./plugin-C4TR9J0Z.js";
-import { n as validate, t as StandardSchemaV1 } from "./standard-CyhRzctb.js";
-import { a as compilePostgrest, i as PostgrestPlan, n as PlanLimit, r as PlanOrder, t as PlanFilter } from "./postgrest-cAEQ_IQN.js";
+import { A as SchemaMeta, C as PrimaryKeyValue, D as Relations, E as RelationTypes, F as UniqueConstraint, I as UniqueKeyName, L as UniqueWhere, M as TableFlags, N as TableKey, O as Row, P as TableMeta, R as Update, S as PrimaryKeyColumn, T as RelationMeta, _ as ModelFlags, a as Casing, b as PermdockBucketPolicy, c as Codec, d as Flags, f as ForeignKeyConstraint, g as Insert, h as FunctionsOf, i as BucketPolicyName, j as Simplify, k as Schema, l as ColumnMeta, m as FunctionTypes, n as AnyModels, o as CheckConstraint, p as FunctionMeta, r as BucketMeta, s as ClaimsMeta, t as AnyFunctions, u as DatabaseOf, v as ModelTypes, w as RealtimeTableMeta, x as PermdockTopicPolicy, y as ModelsOf } from "./types-DONv9SHN.js";
+import { C as and, E as or, S as UpdateOp, T as not, _ as OrderTerm, a as AggregateFn, b as SelectOp, c as Condition, d as FunctionSource, f as Include, g as Operation, h as MutationOp, i as RpcContext, l as CountMode, m as Measure, n as ExecuteResult, o as Aggregation, p as InsertOp, r as Executor, s as ColumnOp, t as ExecuteContext, u as DeleteOp, v as Quantifier, w as column, x as Selection, y as SelectColumn } from "./executor-B5IoUxLE.js";
+import { C as isConflict, D as statusOf, E as mapDbError, S as isCheck, T as isForeignKey, _ as DbException, a as Ok, b as ValidationIssue, c as err, d as toBetterResult, f as toDbError, g as DbErrorOf, h as DbErrorKinds, i as Err, l as fromBetterResult, m as DbErrorKind, n as BetterResultApi, o as Result, p as DbError, r as BetterResultValue, t as AsyncResult, u as ok, v as ErrorMapper, w as isDbError, x as dbError, y as RawDbError } from "./result-CqEsbgYs.js";
+import { a as EventHub, c as QueryEvent, d as LogFields, f as Logger, i as EventHandler, l as RefreshEvent, m as silentLogger, n as BetterSupabaseEvents, o as EventName, p as consoleLogger, r as ErrorEvent, s as MutationNotice, t as AuthEvent, u as RpcNotice } from "./events-B21UOhvP.js";
+import { $ as Specs, A as RpcOptions, B as ReadSet, C as FindExt, Ct as WhereInput, D as Repository, E as PageOf, F as EMPTY_STATS, G as ReadSetParams, H as ReadSetParamType, I as StatsRecorder, J as isReadSet, K as ReadSetResult, L as recordStats, M as UpsertArgs, N as WriteArgs, O as RepositoryOf, P as DbStats, Q as ReadMethod, R as SearchArgs, S as DeleteExt, St as SortDirection, T as OffsetPageArgs, U as ReadSetParamTypes, V as ReadSetOptions, W as ReadSetParamValue, X as InferResult, Y as readSetTables, Z as QuerySpec, _ as CursorPage, _t as OrderByInput, a as defineSupabase, at as AggregateRow, b as DbHelpers, bt as RelationMeasureArg, c as postgrestExecutor, ct as FieldFilter, d as MemoryCache, dt as IncludeArg, et as TableSpecs, f as cacheTargetOf, ft as IncludeArgs, g as ConflictTarget, gt as OrderByArg, h as rpcCacheTargets, ht as NumericMeasureArg, i as SupabaseOptions, it as AggregateResult, j as UpdateArgs, k as Returned, l as CacheAdapter, lt as FindFirstArgs, m as rowKey, mt as MeasureKey, n as ConnectOptions, nt as specTables, o as PostgrestClientLike, ot as CountArg, p as memoryCache, pt as MeasureArg, q as defineReadSet, r as RpcDefinition, rt as AggregateArgs, s as explainPostgrest, st as CountArgs, t as BetterSupabase, tt as isQuerySpec, u as CacheTarget, ut as FindManyArgs, v as CursorPageArgs, vt as Payload, w as OffsetPage, x as DeleteArgs, xt as SelectArg, y as Db, yt as ReadArgs, z as InferReadSetParams } from "./define-CRS2MRV3.js";
+import { _ as definePlugin, a as ExtensionOf, c as MutationEvent, d as PLUGIN_API_VERSION, f as Plugin, g as WithExtension, h as RequestContext, i as CallOptions, l as MutationKind, m as RepositoryExtension, n as AnyPlugin, o as HasFlag, p as RepositoryApi, r as ApplyExtension, s as HookArgs, t as Actor, u as NoExtension } from "./plugin-bNhvJwRh.js";
+import { n as validate, t as StandardSchemaV1 } from "./standard-BsaCYQJc.js";
+import { a as compilePostgrest, i as PostgrestPlan, n as PlanLimit, r as PlanOrder, t as PlanFilter } from "./postgrest-Bc-0Xw62.js";
 import { n as StoragePath } from "./path-Cv__-OTj.js";
-import { n as postgrestCompiler, t as Compiler } from "./compiler-CZ9nIuqy.js";
-import { a as ProblemResponseOptions, c as problemResponse, i as ProblemOptions, l as toProblem, n as PROBLEM_TYPE_BASE, o as fromProblem, r as ProblemDetails, s as isProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-DlgB0lYl.js";
+import { n as postgrestCompiler, t as Compiler } from "./compiler-DB3aSFOA.js";
+import { a as ProblemResponseOptions, c as problemResponse, i as ProblemOptions, l as toProblem, n as PROBLEM_TYPE_BASE, o as fromProblem, r as ProblemDetails, s as isProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-U8UEKccv.js";
 import { t as SPEC_PINS } from "./spec-pins-CqorWDnO.js";
 //#region src/core/define-repository.d.ts
 /** Adds `Methods` to the repository of `Table` only. */
@@ -20,14 +20,14 @@ interface TableRepositoryExtension<Table extends string, Methods> extends Reposi
  * repository at call time, with every other plugin's methods.
  *
  * ```ts
- * const customers = defineRepository(sb, 'customers', (base) => ({
+ * const customers = defineRepository(betterSupabase, 'customers', (base) => ({
  *   active: () => base.findMany({ where: { status: 'active' } }),
  * }));
- * export const app = sb.use(customers);
+ * export const app = betterSupabase.use(customers);
  * await app.connect(client).customers.active();
  * ```
  */
-export declare function defineRepository<M extends AnyModels, D, F extends AnyFunctions, E, const Table extends TableKey<M>, Methods extends object>(sb: BetterSupabase<M, D, F, E>, table: Table, build: (base: RepositoryOf<M, Table, E>) => Methods): Plugin<`repository:${Table}`, TableRepositoryExtension<Table, Methods>>;
+export declare function defineRepository<M extends AnyModels, D, F extends AnyFunctions, E, const Table extends TableKey<M>, Methods extends object>(betterSupabase: BetterSupabase<M, D, F, E>, table: Table, build: (base: RepositoryOf<M, Table, E>) => Methods): Plugin<`repository:${Table}`, TableRepositoryExtension<Table, Methods>>;
 //#endregion
 //#region src/ir/tables.d.ts
 /**
@@ -41,7 +41,7 @@ export declare function touchedTables(op: Operation): string[];
  * plus every table whose foreign key cascades or sets a value on delete,
  * followed through chains of cascades.
  */
-export declare function invalidationTargets(meta: SchemaMeta, table: string): string[];
+export declare function invalidationTargets(meta: SchemaMeta, table: string): readonly string[];
 //#endregion
 //#region src/core/cursor.d.ts
 /** Opaque, URL-safe keyset cursor. */
@@ -71,10 +71,10 @@ type EnrichDatabase<D, O> = { [S in keyof D]: S extends keyof O ? EnrichSchema<D
 export declare function escapeLike(value: string): string;
 //#endregion
 //#region src/ir/codec.d.ts
-/** Wire form of an app value: `Date` to ISO text, `bigint` to decimal text. */
+/** Wire form of an app value: Temporal values to ISO text, `bigint` to decimal text. */
 export declare function encodeValue(value: unknown): unknown;
 /** Applies column codecs to returned rows, including embedded relations. */
-export declare function decodeRows(selection: Selection | undefined, rows: readonly Record<string, unknown>[]): Record<string, unknown>[];
+export declare function decodeRows(selection: Selection | undefined, rows: readonly Record<string, unknown>[], checked?: boolean): Record<string, unknown>[];
 //#endregion
 //#region src/ir/scope.d.ts
 /** Returns the filter that always applies to rows of `table`, if any. */
@@ -107,4 +107,4 @@ export declare function toCamel(name: string): string;
 /** `firstName` to `first_name`. */
 export declare function toSnake(name: string): string;
 //#endregion
-export { type Actor, type AggregateArgs, type AggregateFn, type AggregateResult, type AggregateRow, type Aggregation, type AnyFunctions, type AnyModels, type AnyPlugin, type ApplyExtension, AsyncResult, type AuthEvent, type BetterResultApi, type BetterResultShape, BetterSupabase, type BetterSupabaseEvents, type BucketMeta, type BucketPolicyName, type CacheAdapter, type CacheTarget, type CallOptions, type Casing, type CheckConstraint, type ClaimsMeta, type Codec, type ColumnMeta, type ColumnOp, type Compiler, type Condition, type ConflictTarget, type ConnectOptions, type CountArg, type CountArgs, type CountMode, type CursorPage, type CursorPageArgs, type DatabaseOf, type Db, type DbError, type DbErrorKind, type DbErrorKinds, type DbErrorOf, DbException, type DbHelpers, type DbStats, type DefineSupabaseOptions, type DeleteArgs, type DeleteExt, type DeleteOp, EMPTY_STATS, type EnrichDatabase, type Err, type ErrorEvent, type ErrorMapper, type EventHandler, EventHub, type EventName, type ExecuteContext, type ExecuteResult, type Executor, type ExtensionOf, type FieldFilter, type FindExt, type FindFirstArgs, type FindManyArgs, type Flags, type FlagsShape, type ForeignKeyConstraint, type FunctionMeta, type FunctionShape, type FunctionSource, type FunctionsOf, type HasFlag, type HookArgs, type Include, type IncludeArg, type IncludeArgs, type InferReadSetParams, type InferResult, type Insert, type InsertOp, type LogFields, type Logger, type Measure, type MeasureArg, type MeasureKey, type MemoryCache, type ModelShape, type ModelsOf, type MutationEvent, type MutationKind, type MutationNotice, type MutationOp, type NoExtension, type NumericMeasureArg, type OffsetPage, type OffsetPageArgs, type Ok, type Operation, type OrderByArg, type OrderByInput, type OrderTerm, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, type PageOf, type Payload, type PermdockBucketPolicy, type PermdockTopicPolicy, type PlanFilter, type PlanLimit, type PlanOrder, type Plugin, type PostgrestClientLike, type PostgrestPlan, type PrimaryKeyColumn, type PrimaryKeyValue, type ProblemDetails, type ProblemOptions, type ProblemResponseOptions, type Quantifier, type QueryEvent, type QuerySpec, type RawDbError, type ReadArgs, type ReadMethod, type ReadSet, type ReadSetOptions, type ReadSetParamType, type ReadSetParamTypes, type ReadSetParamValue, type ReadSetParams, type ReadSetResult, type RealtimeTableMeta, type RefreshEvent, type RelationMeasureArg, type RelationMeta, type RelationShape, type Relations, type Repository, type RepositoryApi, type RepositoryExtension, type RepositoryOf, type RequestContext, type Result, type Returned, type Row, type RpcContext, type RpcDefinition, type RpcNotice, type RpcOptions, SPEC_PINS, type Schema, type SchemaMeta, type ScopeFor, type SearchArgs, type SelectArg, type SelectColumn, type SelectOp, type Selection, type Simplify, type SortDirection, type Specs, type StandardSchemaV1, StatsRecorder, type StoragePath, type TableFlags, type TableKey, type TableMeta, type TableRepositoryExtension, type TableSpecs, type UniqueConstraint, type UniqueKeyName, type UniqueWhere, type Update, type UpdateArgs, type UpdateOp, type UpsertArgs, type ValidationIssue, type WhereInput, type WithExtension, type WriteArgs, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, definePlugin, defineReadSet, defineSupabase, err, explainPostgrest, fromBetterResult, fromProblem, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, silentLogger, specTables, statusOf, toBetterResult, toDbError, toProblem, validate };
+export { type Actor, type AggregateArgs, type AggregateFn, type AggregateResult, type AggregateRow, type Aggregation, type AnyFunctions, type AnyModels, type AnyPlugin, type ApplyExtension, AsyncResult, type AuthEvent, type BetterResultApi, type BetterResultValue, BetterSupabase, type BetterSupabaseEvents, type BucketMeta, type BucketPolicyName, type CacheAdapter, type CacheTarget, type CallOptions, type Casing, type CheckConstraint, type ClaimsMeta, type Codec, type ColumnMeta, type ColumnOp, type Compiler, type Condition, type ConflictTarget, type ConnectOptions, type CountArg, type CountArgs, type CountMode, type CursorPage, type CursorPageArgs, type DatabaseOf, type Db, type DbError, type DbErrorKind, type DbErrorKinds, type DbErrorOf, DbException, type DbHelpers, type DbStats, type DeleteArgs, type DeleteExt, type DeleteOp, EMPTY_STATS, type EnrichDatabase, type Err, type ErrorEvent, type ErrorMapper, type EventHandler, EventHub, type EventName, type ExecuteContext, type ExecuteResult, type Executor, type ExtensionOf, type FieldFilter, type FindExt, type FindFirstArgs, type FindManyArgs, type Flags, type ForeignKeyConstraint, type FunctionMeta, type FunctionSource, type FunctionTypes, type FunctionsOf, type HasFlag, type HookArgs, type Include, type IncludeArg, type IncludeArgs, type InferReadSetParams, type InferResult, type Insert, type InsertOp, type LogFields, type Logger, type Measure, type MeasureArg, type MeasureKey, type MemoryCache, type ModelFlags, type ModelTypes, type ModelsOf, type MutationEvent, type MutationKind, type MutationNotice, type MutationOp, type NoExtension, type NumericMeasureArg, type OffsetPage, type OffsetPageArgs, type Ok, type Operation, type OrderByArg, type OrderByInput, type OrderTerm, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, type PageOf, type Payload, type PermdockBucketPolicy, type PermdockTopicPolicy, type PlanFilter, type PlanLimit, type PlanOrder, type Plugin, type PostgrestClientLike, type PostgrestPlan, type PrimaryKeyColumn, type PrimaryKeyValue, type ProblemDetails, type ProblemOptions, type ProblemResponseOptions, type Quantifier, type QueryEvent, type QuerySpec, type RawDbError, type ReadArgs, type ReadMethod, type ReadSet, type ReadSetOptions, type ReadSetParamType, type ReadSetParamTypes, type ReadSetParamValue, type ReadSetParams, type ReadSetResult, type RealtimeTableMeta, type RefreshEvent, type RelationMeasureArg, type RelationMeta, type RelationTypes, type Relations, type Repository, type RepositoryApi, type RepositoryExtension, type RepositoryOf, type RequestContext, type Result, type Returned, type Row, type RpcContext, type RpcDefinition, type RpcNotice, type RpcOptions, SPEC_PINS, type Schema, type SchemaMeta, type ScopeFor, type SearchArgs, type SelectArg, type SelectColumn, type SelectOp, type Selection, type Simplify, type SortDirection, type Specs, type StandardSchemaV1, StatsRecorder, type StoragePath, type SupabaseOptions, type TableFlags, type TableKey, type TableMeta, type TableRepositoryExtension, type TableSpecs, type UniqueConstraint, type UniqueKeyName, type UniqueWhere, type Update, type UpdateArgs, type UpdateOp, type UpsertArgs, type ValidationIssue, type WhereInput, type WithExtension, type WriteArgs, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, definePlugin, defineReadSet, defineSupabase, err, explainPostgrest, fromBetterResult, fromProblem, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, silentLogger, specTables, statusOf, toBetterResult, toDbError, toProblem, validate };

package/dist/index.js

@@ -1,33 +1,32 @@
-import { a as isConflict, c as mapDbError, i as isCheck, l as statusOf, n as dbError, o as isDbError, s as isForeignKey, t as DbException } from "./errors-Bl3rkOzo.js";
-import { i as escapeLike, l as defineSchema, o as decodeRows, s as encodeValue, t as simplify, u as tableMeta } from "./simplify-bwJpLnaS.js";
+import { a as isConflict, c as mapDbError, i as isCheck, l as statusOf, n as dbError, o as isDbError, s as isForeignKey, t as DbException } from "./errors-L0xK41y_.js";
+import { i as escapeLike, l as defineSchema, o as decodeRows, s as encodeValue, t as simplify, u as tableMeta } from "./simplify-Cqvfr9dj.js";
 import { i as or, n as column, r as not, t as and } from "./types-6cYK9pbJ.js";
-import { a as toBetterResult, i as ok, n as err, o as toDbError, r as fromBetterResult, t as AsyncResult } from "./result-DWXatkd6.js";
-import { a as EventHub, c as rowKey, i as encodeCursor, l as rpcCacheTargets, n as defineSupabase, o as cacheTargetOf, r as decodeCursor, s as memoryCache, t as BetterSupabase } from "./define-BXMYD9AY.js";
-import { n as touchedTables, t as invalidationTargets } from "./tables-rZxRxNPW.js";
+import { a as toBetterResult, i as ok, n as err, o as toDbError, r as fromBetterResult, t as AsyncResult } from "./result-Bj6yt33D.js";
+import { a as EventHub, c as rowKey, i as encodeCursor, l as rpcCacheTargets, n as defineSupabase, o as cacheTargetOf, r as decodeCursor, s as memoryCache, t as BetterSupabase } from "./define-Bh0AqTik.js";
+import { n as touchedTables, t as invalidationTargets } from "./tables-Cb-3_VWc.js";
 import { n as silentLogger, t as consoleLogger } from "./logger-glM28NVN.js";
 import { n as definePlugin, t as PLUGIN_API_VERSION } from "./plugin-BqR6wKMB.js";
-import { a as postgrestExecutor, i as explainPostgrest, n as StatsRecorder, o as compilePostgrest, r as recordStats, t as EMPTY_STATS } from "./stats-C5W-rBfR.js";
-import { c as readSetTables, d as isQuerySpec, f as specTables, i as defineReadSet, o as isReadSet } from "./read-set-4lI3W_gZ.js";
-import { t as validate } from "./standard-FUi3Z3-7.js";
-import { a as problemResponse, i as isProblem, n as PROBLEM_TYPE_BASE, o as toProblem, r as fromProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-BTkTtRV9.js";
+import { a as postgrestExecutor, i as explainPostgrest, n as StatsRecorder, o as compilePostgrest, r as recordStats, t as EMPTY_STATS } from "./stats-C_YxA2r1.js";
+import { c as readSetTables, d as isQuerySpec, f as specTables, i as defineReadSet, o as isReadSet } from "./read-set-FWK8qQ58.js";
+import { t as validate } from "./standard-BRyBGTtp.js";
+import { a as problemResponse, i as isProblem, n as PROBLEM_TYPE_BASE, o as toProblem, r as fromProblem, t as PROBLEM_CONTENT_TYPE } from "./problem-BihjPR0t.js";
 import { t as SPEC_PINS } from "./spec-pins-C3oc-Tdp.js";
 import { n as scopeOperation, r as scopeSelection, t as scopeCondition } from "./scope-CDHcS7dE.js";
-import { n as toCamel, r as toSnake } from "./casing-da0uRTqt.js";
 //#region src/core/define-repository.ts
 /**
 * Domain methods for one table, installed with `use()`. `base` is the
 * repository at call time, with every other plugin's methods.
 *
 * ```ts
-* const customers = defineRepository(sb, 'customers', (base) => ({
+* const customers = defineRepository(betterSupabase, 'customers', (base) => ({
 *   active: () => base.findMany({ where: { status: 'active' } }),
 * }));
-* export const app = sb.use(customers);
+* export const app = betterSupabase.use(customers);
 * await app.connect(client).customers.active();
 * ```
 */
-function defineRepository(sb, table, build) {
-	if (!(table in sb.meta.tables)) throw new TypeError(`better-supabase: defineRepository: unknown table "${table}"`);
+function defineRepository(betterSupabase, table, build) {
+	if (!(table in betterSupabase.meta.tables)) throw new TypeError(`better-supabase: defineRepository: unknown table "${table}"`);
 	return definePlugin({
 		name: `repository:${table}`,
 		repository: ({ table: meta, base }) => meta.key === table ? build(base) : void 0
@@ -40,4 +39,14 @@ const postgrestCompiler = {
 	compile: compilePostgrest
 };
 //#endregion
+//#region src/casing/index.ts
+/** `first_name` to `firstName`. Leaves already camel-cased names untouched. */
+function toCamel(name) {
+	return name.replaceAll(/_+([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+/** `firstName` to `first_name`. */
+function toSnake(name) {
+	return name.replaceAll(/([a-z0-9])([A-Z])/g, "$1_$2").replaceAll(/([A-Z])([A-Z][a-z])/g, "$1_$2").toLowerCase();
+}
+//#endregion
 export { AsyncResult, BetterSupabase, DbException, EMPTY_STATS, EventHub, PLUGIN_API_VERSION, PROBLEM_CONTENT_TYPE, PROBLEM_TYPE_BASE, SPEC_PINS, StatsRecorder, and, cacheTargetOf, column, compilePostgrest, consoleLogger, dbError, decodeCursor, decodeRows, definePlugin, defineReadSet, defineRepository, defineSchema, defineSupabase, encodeCursor, encodeValue, err, escapeLike, explainPostgrest, fromBetterResult, fromProblem, invalidationTargets, isCheck, isConflict, isDbError, isForeignKey, isProblem, isQuerySpec, isReadSet, mapDbError, memoryCache, not, ok, or, postgrestCompiler, postgrestExecutor, problemResponse, readSetTables, recordStats, rowKey, rpcCacheTargets, scopeCondition, scopeOperation, scopeSelection, silentLogger, simplify, specTables, statusOf, tableMeta, toBetterResult, toCamel, toDbError, toProblem, toSnake, touchedTables, validate };

package/dist/{invalidate-DbxuL2jL.js → invalidate-CgxmRamI.js}

@@ -1,7 +1,13 @@
 //#region src/query/invalidate.ts
+function isString(value) {
+	return typeof value === "string";
+}
 function queryTables(query) {
 	const tables = query.meta?.["bsTables"];
-	if (Array.isArray(tables)) return tables.filter((t) => typeof t === "string");
+	if (Array.isArray(tables)) {
+		const list = tables;
+		return list.every(isString) ? list : list.filter(isString);
+	}
 	const [prefix, table] = query.queryKey;
 	return prefix === "bs" && typeof table === "string" ? [table] : void 0;
 }

package/dist/jobs/index.d.ts

@@ -1,11 +1,12 @@
-import { o as Result, p as DbError, t as AsyncResult } from "../result-CTkCZ6JA.js";
-import { t as SqlClient } from "../executor-BYXQ9AGn.js";
+/// <reference lib="esnext.temporal" />
+import { o as Result, p as DbError, t as AsyncResult } from "../result-CqEsbgYs.js";
+import { t as SqlClient } from "../executor-CZ7ImRiD.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
-//#region src/jobs/index.d.ts
-export type QueueSchemas = Readonly<Record<string, StandardSchemaV1>>;
+//#region src/jobs/jobs.d.ts
+type QueueSchemas = Readonly<Record<string, StandardSchemaV1>>;
 type PayloadIn<Q extends QueueSchemas, N extends keyof Q> = StandardSchemaV1.InferInput<Q[N]>;
 type PayloadOut<Q extends QueueSchemas, N extends keyof Q> = StandardSchemaV1.InferOutput<Q[N]>;
-export interface Job<P = unknown> {
+interface Job<P = unknown> {
   /** The pgmq message id. */
   readonly id: number;
   readonly queue: string;
@@ -13,14 +14,14 @@ export interface Job<P = unknown> {
   /** 1 on the first run (pgmq's `read_ct`). */
   readonly attempts: number;
   readonly maxAttempts: number;
-  readonly enqueuedAt: Date;
+  readonly enqueuedAt: Temporal.Instant;
   /** End of the lease: the job becomes claimable again after this. */
-  readonly visibleUntil: Date;
+  readonly visibleUntil: Temporal.Instant;
   readonly lastError: string | null;
 }
-export interface EnqueueOptions {
+interface EnqueueOptions {
   /** Run no earlier than this. */
-  readonly runAt?: Date;
+  readonly runAt?: Temporal.Instant;
   /** Seconds to wait before running. */
   readonly delay?: number;
   /** Defaults to 5. After this many failed attempts the job is archived as dead. */
@@ -31,31 +32,37 @@ export interface EnqueueOptions {
    */
   readonly dedupeKey?: string;
 }
-export interface ClaimOptions {
+interface ClaimOptions {
   /** Defaults to 1. */
   readonly batch?: number;
   /** Seconds a claimed job stays invisible to other workers. Defaults to 300. */
   readonly lease?: number;
 }
-export interface FailOptions {
+interface FailOptions {
   /** Retry after this many seconds instead of the exponential backoff. SQL connections only. */
   readonly retryIn?: number;
 }
-export type JobHandler<P> = (payload: P, job: Job<P>, signal: AbortSignal) => unknown;
-export interface WorkOptions extends ClaimOptions {
+type JobHandler<P> = (payload: P, job: Job<P>, signal: AbortSignal) => unknown;
+interface WorkOptions extends ClaimOptions {
   /** Jobs handled at once. Defaults to 1. */
   readonly concurrency?: number;
-  /** Wait between polls when the queue is empty, in ms. Defaults to 1000. */
+  /**
+   * First wait between polls when the queue is empty, in ms. Defaults to
+   * 1000. Each empty poll doubles the wait up to `maxPollInterval`; a claimed
+   * job resets it.
+   */
   readonly pollInterval?: number;
+  /** Longest wait between empty polls, in ms. Defaults to 30000. */
+  readonly maxPollInterval?: number;
   /** Stops the loop; running jobs finish first. */
   readonly signal?: AbortSignal;
   readonly onError?: (error: DbError, job: Job) => void;
 }
-export interface DrainResult {
+interface DrainResult {
   readonly succeeded: number;
   readonly failed: number;
 }
-export interface Jobs<Q extends QueueSchemas> {
+interface Jobs<Q extends QueueSchemas> {
   /** Validates the payload with the queue's schema, then enqueues it. Returns the job id. */
   enqueue<N extends Extract<keyof Q, string>>(queue: N, payload: PayloadIn<Q, N>, options?: EnqueueOptions): AsyncResult<number>;
   claim<N extends Extract<keyof Q, string>>(queue: N, options?: ClaimOptions): AsyncResult<Job<PayloadOut<Q, N>>[]>;
@@ -72,12 +79,12 @@ export interface Jobs<Q extends QueueSchemas> {
   schedule<N extends Extract<keyof Q, string>>(name: string, cron: string, queue: N, payload: PayloadIn<Q, N>): AsyncResult<void>;
   unschedule(name: string): AsyncResult<boolean>;
   /** Processes ready jobs until the queue is empty. For cron and edge invocations. */
-  drain<N extends Extract<keyof Q, string>>(queue: N, handler: JobHandler<PayloadOut<Q, N>>, options?: Omit<WorkOptions, "pollInterval" | "signal">): Promise<DrainResult>;
+  drain<N extends Extract<keyof Q, string>>(queue: N, handler: JobHandler<PayloadOut<Q, N>>, options?: Omit<WorkOptions, "pollInterval" | "maxPollInterval" | "signal">): Promise<DrainResult>;
   /** Polls and processes jobs until `signal` aborts. */
   work<N extends Extract<keyof Q, string>>(queue: N, handler: JobHandler<PayloadOut<Q, N>>, options?: WorkOptions): Promise<DrainResult>;
 }
 /** A Supabase client, or anything with `.schema(name).rpc(fn, args)`. */
-export interface QueueRpcClient {
+interface QueueRpcClient {
   schema(name: string): {
     rpc(fn: string, args: Readonly<Record<string, unknown>>): PromiseLike<{
       data: unknown;
@@ -94,7 +101,7 @@ export interface QueueRpcClient {
  * Queue names are lowercase letters, digits and underscores.
  */
 export declare function createJobs<const Q extends QueueSchemas>(source: SqlClient | QueueRpcClient, queues: Q): Jobs<Q>;
-export interface IdempotencyOptions {
+interface IdempotencyOptions {
   /** Separates keys of different endpoints or tenants. Defaults to `''`. */
   readonly scope?: string | ((request: Request) => string);
   /** How long a completed response is replayed. Defaults to `24 hours`. */
@@ -106,8 +113,8 @@ export interface IdempotencyOptions {
   /** Defaults to `Idempotency-Key`. */
   readonly header?: string;
 }
-export type IdempotencyState = "started" | "replay" | "running" | "mismatch";
-export interface Idempotency {
+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`).
@@ -124,7 +131,7 @@ export interface Idempotency {
 }
 /** HTTP idempotency keys (IETF `Idempotency-Key` header) over the `idempotency` SQL kit module. */
 export declare function createIdempotency(sql: SqlClient, options?: IdempotencyOptions): Idempotency;
-export interface InboxMessage<T = unknown> {
+interface InboxMessage<T = unknown> {
   readonly id: number;
   readonly source: string;
   readonly messageId: string;
@@ -132,9 +139,9 @@ export interface InboxMessage<T = unknown> {
   readonly payload: T;
   readonly headers: Readonly<Record<string, string>>;
   readonly attempts: number;
-  readonly receivedAt: Date;
+  readonly receivedAt: Temporal.Instant;
 }
-export interface InboxOptions {
+interface InboxOptions {
   /** Name of the sender, e.g. `stripe` or `supabase-auth`. */
   readonly source: string;
   /** Standard Webhooks secrets; the signature is verified before storing. */
@@ -150,7 +157,7 @@ export interface InboxOptions {
   readonly keepHeaders?: readonly string[];
   readonly worker?: string;
 }
-export interface Inbox {
+interface Inbox {
   /** Verifies and stores a webhook; answers 202, or 200 for a duplicate delivery. */
   receive(request: Request): Promise<Response>;
   /** Processes stored messages until none are ready. */
@@ -170,4 +177,4 @@ export declare const ENTITLEMENTS_UPDATED = "entitlements.active_entitlement_sum
  */
 export declare function entitlementMembers(sql: SqlClient, payload: unknown): AsyncResult<readonly string[]>;
 //#endregion
-export type { SqlClient };
+export type { ClaimOptions, DrainResult, EnqueueOptions, FailOptions, Idempotency, IdempotencyOptions, IdempotencyState, Inbox, InboxMessage, InboxOptions, Job, JobHandler, Jobs, QueueRpcClient, QueueSchemas, SqlClient, WorkOptions };