better-supabase 0.7.1 → 0.9.0

package/dist/index-CETRk4YO.d.ts

@@ -0,0 +1,82 @@
+import { SupabaseEnv } from "@supabase/server";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/env/index.d.ts
+/** Validated Supabase settings. Only `publicEnv()` of it is safe to ship to a browser. */
+interface BetterSupabaseEnv {
+  readonly url: string;
+  readonly publishableKey: string;
+  readonly secretKey?: string;
+  /** Named secret keys from `SUPABASE_SECRET_KEYS`, including `default` when `secretKey` is set. */
+  readonly secretKeys?: Readonly<Record<string, string>>;
+  /** `SUPABASE_JWKS_URL`, or `<url>/auth/v1/.well-known/jwks.json`. */
+  readonly jwksUrl: URL;
+  /** `SUPABASE_JWKS`: inline keys, used instead of fetching `jwksUrl`. */
+  readonly jwks?: InlineJwks;
+  /** Direct Postgres connection string (`SUPABASE_DB_URL` / `DATABASE_URL`). */
+  readonly dbUrl?: string;
+  /** Project ref for hosted projects (`<ref>.supabase.co`). */
+  readonly projectRef?: string;
+  /** `SUPABASE_READ_URL`: a read replica or the `<ref>-all` load balancer, for reads. */
+  readonly readUrl?: string;
+  /**
+   * `SUPABASE_JWT_SECRET`: the shared HS256 secret Supabase Lite signs user
+   * tokens with (`auth.jwt_secret`). Server-only; read with `backend: "lite"`.
+   */
+  readonly jwtSecret?: string;
+}
+/** A JSON Web Key Set, as `@supabase/server` verifies with it. */
+type InlineJwks = Exclude<SupabaseEnv["jwks"], URL | null>;
+interface PublicEnv {
+  readonly url: string;
+  readonly publishableKey: string;
+}
+type EnvSource = Readonly<Record<string, string | undefined>>;
+interface EnvIssue {
+  /** The variable names that were checked, first one preferred. */
+  readonly variables: readonly string[];
+  readonly message: string;
+}
+interface EnvOptions {
+  /** Settings that must be present. `url` and `publishableKey` always are. */
+  readonly require?: readonly ("secretKey" | "dbUrl")[];
+}
+type EnvResult = {
+  readonly ok: true;
+  readonly env: BetterSupabaseEnv;
+  readonly issues?: undefined;
+} | {
+  readonly ok: false;
+  readonly env?: undefined;
+  readonly issues: readonly EnvIssue[];
+};
+declare const ENV_VARIABLES: {
+  readonly url: readonly string[];
+  readonly publishableKey: readonly string[];
+  readonly secretKey: readonly string[];
+  readonly dbUrl: readonly string[];
+  readonly jwksUrl: readonly string[];
+  readonly jwks: readonly string[];
+  readonly readUrl: readonly string[];
+  readonly jwtSecret: readonly string[];
+};
+declare class EnvValidationError extends Error {
+  override readonly name = "EnvValidationError";
+  readonly issues: readonly EnvIssue[];
+  constructor(issues: readonly EnvIssue[]);
+}
+/**
+ * Reads and validates Supabase settings. Accepts the `SUPABASE_`,
+ * `NEXT_PUBLIC_`, `VITE_`, `PUBLIC_`, `EXPO_PUBLIC_` and `NUXT_PUBLIC_`
+ * spellings. Issues name variables, never values.
+ */
+declare function parseEnv(source: EnvSource, options?: EnvOptions): EnvResult;
+/** Like `parseEnv`, but throws `EnvValidationError`. Reads `process.env` by default. */
+declare function loadEnv(source?: EnvSource, options?: EnvOptions): BetterSupabaseEnv;
+/** The env validator as a Standard Schema, for t3-env, framework config or any validator slot. */
+declare function envSchema(options?: EnvOptions): StandardSchemaV1<EnvSource, BetterSupabaseEnv>;
+/** The parts that are safe in client bundles. */
+declare function publicEnv(env: BetterSupabaseEnv): PublicEnv;
+/** Converts to `@supabase/server`'s `SupabaseEnv` (the `env` option of `withSupabase`). */
+declare function toServerEnv(env: BetterSupabaseEnv): SupabaseEnv;
+//#endregion
+export { EnvResult as a, InlineJwks as c, loadEnv as d, parseEnv as f, EnvOptions as i, PublicEnv as l, toServerEnv as m, ENV_VARIABLES as n, EnvSource as o, publicEnv as p, EnvIssue as r, EnvValidationError as s, BetterSupabaseEnv as t, envSchema as u };

package/dist/index-CrZitvSC.d.ts

@@ -0,0 +1,258 @@
+import { b as DbError, f as Result, t as AsyncResult } from "./result-Cj3yWhjH.js";
+import { H as UploadOptions, J as TemplateValues, U as UrlOptions, V as UploadBody } from "./storage-api-Cx-1iWBd.js";
+import { at as QuerySpec } from "./define-DxHHbNEb.js";
+import { c as RealtimeClient, d as SubscribeOptions, g as TopicHandlers, i as PresenceOptions, m as Topic, p as SubscriptionStatus, r as PresenceMember, s as PresenceSubscription, t as EventSchemas } from "./topic-cMS7UtM1.js";
+import { t as AuthSnapshot } from "./bind-a7sUgvf4.js";
+import { t as AuthSession } from "./view-Dv0A949a.js";
+import { r as LiveCountSeed } from "./index-BIi8i6BO.js";
+import { a as BroadcastOptions, c as LiveCountHookOptions, m as UseActionOptions, n as ActionInputOf, o as ClaimsOf, p as ProfileOf, r as ActionResultOf, s as ClientLike, u as LiveQueryHookOptions } from "./field-errors-CWXN_h_E.js";
+import { SupabaseClient } from "@supabase/supabase-js";
+import { ReactNode, SubmitEvent } from "react";
+import { QueryClient } from "@tanstack/query-core";
+//#region src/react/hooks.d.ts
+interface BetterSupabaseProviderProps {
+  readonly client: ClientLike;
+  /** better-supabase queries are removed when the user signs out or changes. */
+  readonly queryClient?: QueryClient;
+  readonly children?: ReactNode;
+}
+/** Provides the better-supabase client to the hooks. */
+declare function BetterSupabaseProvider(props: BetterSupabaseProviderProps): ReactNode;
+/** The session state for UI: `loading`, `signed-out` or `signed-in` with the user and claims. */
+declare function useAuth(): AuthSnapshot;
+declare function useSupabase(): SupabaseClient;
+interface BetterHooks<B extends ClientLike> {
+  /** Repositories bound to the current session. Re-renders when the user changes. */
+  readonly useDb: () => B["db"];
+  /** TanStack Query option factories: `useQuery(useQueries().customers.findMany())`. */
+  readonly useQueries: () => B["queries"];
+  readonly useSupabase: () => SupabaseClient;
+  readonly useAuth: () => AuthSnapshot;
+  /** `useSession()` typed by the client's `betterSupabase.claims(schema)` and `betterSupabase.userMetadata(schema)`. */
+  readonly useSession: () => AuthSession<ClaimsOf<B>, ProfileOf<B>>;
+}
+/**
+ * Hooks typed for your schema.
+ *
+ * ```ts
+ * export const { useDb, useQueries, useAuth } = createHooks<typeof bs>();
+ * ```
+ */
+declare function createHooks<B extends ClientLike>(): BetterHooks<B>;
+/**
+ * Subscribes to a topic while mounted. Pass `null` values to pause. It
+ * resubscribes when the topic or the signed-in user changes.
+ *
+ * ```ts
+ * useBroadcast(customersTopic, organizationId ? { organizationId } : null, {}, { invalidate: ['customers'] });
+ * ```
+ */
+declare function useBroadcast<P extends string, E extends EventSchemas>(topic: Topic<P, E>, values: TemplateValues<P> | null | undefined, handlers?: TopicHandlers<E>, options?: BroadcastOptions): SubscriptionStatus;
+/**
+ * Keeps a query fresh: invalidates every cached query that read a table the
+ * spec touches whenever one of them changes. Pass `null` to pause. It
+ * resubscribes when the spec, tenant or user changes.
+ *
+ * ```ts
+ * const spec = betterSupabase.spec.customers.findMany({ include: { notes: true } });
+ * const { data } = useQuery(q.$spec(spec));
+ * useLiveQuery(spec);
+ * ```
+ */
+declare function useLiveQuery(spec: QuerySpec | null | undefined, options?: LiveQueryHookOptions): SubscriptionStatus;
+interface LiveCount {
+  /** `undefined` until the first count arrives. */
+  readonly count: number | undefined;
+  readonly status: SubscriptionStatus;
+  /** The last failed refetch; the previous count stays. */
+  readonly error: DbError | undefined;
+}
+/**
+ * A count that stays current: refetches only the `count` spec (a HEAD
+ * request) after each debounced change to a table it reads, and after the
+ * channel rejoins. Takes a spec or a `bs.liveCount()` seed; pass `null` to
+ * pause. Doesn't need a `QueryClient`.
+ *
+ * ```tsx
+ * const { count } = useLiveCount(seed); // seed = await bs.liveCount(spec)
+ * ```
+ */
+declare function useLiveCount(source: QuerySpec<string, "count", number> | LiveCountSeed | null | undefined, options?: LiveCountHookOptions): LiveCount;
+//#endregion
+//#region src/react/actions.d.ts
+interface ActionHandle<I, T> {
+  /** Runs the action in a transition; resolves with its result. */
+  run(input: I): Promise<ActionResultOf<T>>;
+  /** True while a run is in flight, including the router update it causes. */
+  readonly pending: boolean;
+  /** The inputs of the runs in flight, e.g. to dim one table row. */
+  readonly pendingInputs: readonly I[];
+  /** The input of the latest run in flight. */
+  readonly pendingInput: I | undefined;
+  /** The data of the last successful run. */
+  readonly data: T | undefined;
+  /** The error of the last run, until the next one starts. */
+  readonly error: DbError | undefined;
+  reset(): void;
+}
+/**
+ * Calls a Server Action from an event handler: tracks pending inputs and the
+ * last result, and calls `onSuccess` or `onError`.
+ *
+ * ```tsx
+ * const remove = useAction(removeMember, { onError: (e) => toast.error(message(e)) });
+ * <Button disabled={remove.pendingInputs.some((p) => p.userId === id)} onClick={() => remove.run({ userId: id })} />
+ * ```
+ */
+declare function useAction<I, T>(action: (input: I) => Promise<ActionResultOf<T>>, options?: UseActionOptions<ActionInputOf<I>, T>): ActionHandle<ActionInputOf<I>, T>;
+interface UseActionFormOptions<T> {
+  readonly onSuccess?: (data: T, form: HTMLFormElement) => void;
+  readonly onError?: (error: DbError, form: HTMLFormElement) => void;
+  /** Clear the fields after a successful run. Defaults to true. */
+  readonly resetOnSuccess?: boolean;
+}
+interface ActionForm<T> {
+  /** Spread on the `<form>`. */
+  readonly formProps: {
+    readonly onSubmit: (event: SubmitEvent<HTMLFormElement>) => void;
+  };
+  readonly pending: boolean;
+  readonly data: T | undefined;
+  readonly error: DbError | undefined;
+  /** The first message per top-level field of a `validation` error. */
+  readonly fieldErrors: Readonly<Partial<Record<string, string>>>;
+  reset(): void;
+}
+/**
+ * A `<form>` that submits `FormData` to a Server Action. Fields keep what
+ * the user typed when the action fails (a `<form action>` resets them) and
+ * clear only on success.
+ *
+ * ```tsx
+ * const form = useActionForm(createCustomer, { onSuccess: () => toast.success('Saved') });
+ * <form {...form.formProps}>
+ *   <Input name="name" aria-invalid={form.fieldErrors.name !== undefined} />
+ * </form>
+ * ```
+ */
+declare function useActionForm<T>(action: (input: FormData) => Promise<ActionResultOf<T>>, options?: UseActionFormOptions<T>): ActionForm<T>;
+//#endregion
+//#region src/react/presence.d.ts
+interface PresenceHookOptions<I> {
+  /**
+   * The state this client shares while mounted. It is tracked after the
+   * join and tracked again when its JSON changes; `null` stays untracked.
+   */
+  readonly state?: I | null;
+  /** A supabase-js client for apps without `<BetterSupabaseProvider>`. */
+  readonly client?: SupabaseClient;
+}
+interface Presence<I, O> {
+  /** Everyone on the topic, this client included, from the last sync. */
+  readonly members: readonly PresenceMember<O>[];
+  readonly status: SubscriptionStatus;
+  /** Shares a state now; the `state` option tracks one for you. */
+  readonly track: (state: I) => Promise<DbError | undefined>;
+  readonly untrack: () => Promise<DbError | undefined>;
+}
+/** The parts of a `defineTopic(..., { presence })` topic the hook uses. */
+interface PresenceTopic<P extends string, I, O> {
+  topic(values: TemplateValues<P>): string;
+  match(topic: string): TemplateValues<P> | null;
+  subscribe(client: RealtimeClient, values: TemplateValues<P>, handlers: Readonly<Record<string, never>>, options?: SubscribeOptions & PresenceOptions<O>): PresenceSubscription<I, O>;
+}
+/**
+ * Joins a presence topic while mounted and returns who is on it. Pass
+ * `null` values to pause. It rejoins when the topic or the user changes.
+ *
+ * ```tsx
+ * const { members } = usePresence(roomTopic, { roomId }, { state: { name } });
+ * ```
+ */
+declare function usePresence<P extends string, I, O>(topic: PresenceTopic<P, I, O>, values: TemplateValues<P> | null | undefined, options?: PresenceHookOptions<I>): Presence<I, O>;
+//#endregion
+//#region src/react/search.d.ts
+interface DebouncedSearchOptions {
+  /** Defaults to 250 ms. */
+  readonly delayMs?: number;
+  /** Shorter terms count as no search. Defaults to 1. */
+  readonly minLength?: number;
+}
+interface DebouncedSearch {
+  /** What the input shows; updates on every keystroke. */
+  readonly value: string;
+  readonly setValue: (value: string) => void;
+  /** The trimmed value once typing pauses, or `undefined` below `minLength`. */
+  readonly term: string | undefined;
+  /** `term` with `%` and `_` escaped and wrapped in `%`, for `like` and `ilike`. */
+  readonly pattern: string | undefined;
+  /** `value` changed and `term` hasn't caught up yet. */
+  readonly pending: boolean;
+}
+/**
+ * A search box's value, debounced. Pass `term` to `contains` (which
+ * escapes it) or `pattern` to `ilike`; both are `undefined` while empty.
+ *
+ * ```tsx
+ * const search = useDebouncedSearch();
+ * useQuery(q.customers.findMany({ where: search.term ? { name: { contains: search.term } } : {} }));
+ * ```
+ */
+declare function useDebouncedSearch(initial?: string, options?: DebouncedSearchOptions): DebouncedSearch;
+//#endregion
+//#region src/react/storage.d.ts
+/** The part of a connected bucket `useSignedUrl` calls. */
+interface SignedUrlSource<T> {
+  signedUrl(target: T, options?: UrlOptions): AsyncResult<string>;
+}
+interface SignedUrl {
+  /** `undefined` until the first URL arrives, and while paused. */
+  readonly url: string | undefined;
+  readonly error: DbError | undefined;
+  readonly loading: boolean;
+}
+/**
+ * A signed URL for an object, signed again before it expires. Pass `null`
+ * as the target to pause. Connect the bucket with `cacheSignedUrls: true`
+ * so components showing the same object share one URL.
+ *
+ * ```tsx
+ * const { url } = useSignedUrl(avatars, user ? { userId: user.id } : null, { ttl: 'hour' });
+ * ```
+ */
+declare function useSignedUrl<T>(bucket: SignedUrlSource<T>, target: T | null | undefined, options?: UrlOptions): SignedUrl;
+/** The part of a connected bucket `useUpload` calls. */
+interface UploadTarget<T, R> {
+  upload(target: T, body: UploadBody, options?: UploadOptions): AsyncResult<R>;
+}
+type UploadStatus = "idle" | "uploading" | "done" | "error";
+interface Upload<T, R> {
+  readonly status: UploadStatus;
+  /** 0 to 1 while uploading; see `UploadOptions.onProgress` for when it is exact. */
+  readonly progress: number;
+  readonly data: R | undefined;
+  readonly error: DbError | undefined;
+  /** Starts an upload; a new one aborts the one in flight. */
+  readonly upload: (target: T, body: UploadBody, options?: Omit<UploadOptions, "signal" | "onProgress">) => Promise<Result<R>>;
+  /** Cancels the upload in flight. */
+  readonly abort: () => void;
+  /** Back to `idle`. */
+  readonly reset: () => void;
+}
+interface UseUploadOptions<R> {
+  readonly onSuccess?: (data: R) => void;
+  readonly onError?: (error: DbError) => void;
+}
+/**
+ * Uploads to a connected bucket with progress, abort and status state.
+ * Unmounting aborts the upload in flight.
+ *
+ * ```tsx
+ * const avatar = useUpload(avatars, { onSuccess: ({ path }) => save(path) });
+ * <input type="file" onChange={(e) => avatar.upload({ userId }, e.target.files[0], { upsert: true })} />
+ * <progress value={avatar.progress} />
+ * ```
+ */
+declare function useUpload<T, R>(bucket: UploadTarget<T, R>, options?: UseUploadOptions<R>): Upload<T, R>;
+//#endregion
+export { useSupabase as A, BetterSupabaseProviderProps as C, useBroadcast as D, useAuth as E, useLiveCount as O, BetterSupabaseProvider as S, createHooks as T, ActionHandle as _, UploadTarget as a, useActionForm as b, useUpload as c, useDebouncedSearch as d, Presence as f, ActionForm as g, usePresence as h, UploadStatus as i, useLiveQuery as k, DebouncedSearch as l, PresenceTopic as m, SignedUrlSource as n, UseUploadOptions as o, PresenceHookOptions as p, Upload as r, useSignedUrl as s, SignedUrl as t, DebouncedSearchOptions as u, UseActionFormOptions as v, LiveCount as w, BetterHooks as x, useAction as y };

package/dist/index-DfVXx4Ia.d.ts

@@ -0,0 +1,202 @@
+import { P as SchemaMeta, u as ClaimsMeta } from "./types-YfwpIE-d.js";
+import { a as Generator, u as JsonSchemaSource, x as ResolvedConfig, y as BetterSupabaseConfig } from "./codegen-DeoSt1mi.js";
+//#region src/config/defaults.d.ts
+/**
+ * Every default `resolveConfig` fills in. Other modules (the SQL module
+ * registry, the CLI) read their fallbacks from here instead of repeating the
+ * literals.
+ */
+declare const CONFIG_DEFAULTS: {
+  readonly output: string;
+  readonly schemas: readonly string[];
+  readonly casing: "snake";
+  readonly postgrestVersion: string;
+  readonly codecs: {
+    readonly timestamptz: "string";
+    readonly int8: "number";
+    readonly numeric: "number";
+  };
+  readonly sql: {
+    readonly dir: string;
+    readonly prefix: string;
+    readonly testsDir: string;
+  };
+  readonly seed: {
+    readonly entry: string;
+    readonly output: string;
+  };
+  readonly openapi: {
+    readonly entry: string;
+    readonly output: string;
+  };
+  readonly specs: {
+    readonly failOn: "error";
+  };
+  readonly doctor: {
+    readonly format: "text";
+    readonly sources: readonly string[];
+    readonly policyHelperLimit: number;
+  };
+  readonly gen: {
+    readonly watchInterval: number;
+  };
+  readonly env: {
+    readonly output: string;
+  };
+};
+//#endregion
+//#region src/config/json.d.ts
+/**
+ * The JSON Schema document for a `json[...].schema` entry. A Standard
+ * Schema converts for `target` (2020-12 by default); a JSON Schema object is
+ * returned as it is.
+ */
+declare function resolveJsonSchema(source: JsonSchemaSource, target?: "draft-2020-12" | "draft-07" | "openapi-3.0"): Readonly<Record<string, unknown>>;
+//#endregion
+//#region src/config/resolve.d.ts
+declare const CONFIG_SCHEMA_URL = "https://unpkg.com/better-supabase/schemas/config-v1.json";
+/**
+ * Types `better-supabase.config.ts`. With `preset`, it expands the preset
+ * into `blocks` and its conventions first, and the keys you set win.
+ */
+declare function defineConfig(config: BetterSupabaseConfig): BetterSupabaseConfig;
+/** Applies defaults. Paths stay relative to `root`. */
+declare function resolveConfig(input: BetterSupabaseConfig, root: string): ResolvedConfig;
+//#endregion
+//#region src/core/claims.d.ts
+declare const DEFAULT_CLAIMS: ClaimsMeta;
+/** Where an adapter reads each claim the SQL modules and the provider's hook write. */
+interface ClaimPaths {
+  /** The active tenant: the top-level claim, then the same key in `app_metadata`. */
+  readonly tenant: readonly [string, string];
+  /** `{ [tenantId]: string[] }` of plan features. */
+  readonly features: string;
+  /** The caller's memberships, a list of `{ scope, id, roles }` or a map of tenant id to role. */
+  readonly memberships: string;
+  /** The `scope` of tenant entries in the memberships list. */
+  readonly scope: string;
+}
+/**
+ * The claim paths for `config.claims`, with defaults. For a generated
+ * schema, pass `claimsOf(meta)`.
+ */
+declare function claimPaths(claims?: Partial<ClaimsMeta>): ClaimPaths;
+/** 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/json-schema-target.d.ts
+/** The JSON Schema dialects the generators and MCP emit. */
+type JsonSchemaTarget = "draft-2020-12" | "draft-07" | "openapi-3.0";
+//#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>>;
+  };
+  readonly runtimeImport?: string;
+}
+interface CommentEntry {
+  readonly id: number;
+  readonly schema: string;
+  readonly name: string;
+  readonly comment: string | null;
+}
+/**
+ * The catalog parts docs read: `GeneratorInput` satisfies it. Runtime callers
+ * that only have `meta` (OpenAPI, MCP) pass none and get no docs.
+ */
+interface DocsSource extends SchemaSource {
+  readonly introspection?: {
+    readonly tables: readonly CommentEntry[];
+    readonly views: readonly CommentEntry[];
+    readonly materializedViews?: readonly CommentEntry[];
+    readonly columns: readonly {
+      readonly table_id: number;
+      readonly name: string;
+      readonly comment: string | null;
+      readonly check: string | null;
+    }[];
+  };
+  readonly extras?: {
+    readonly tables: readonly {
+      readonly schema: string;
+      readonly name: string;
+      readonly checks: readonly {
+        readonly definition: string;
+      }[];
+    }[];
+  };
+}
+//#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;
+  /**
+   * The dialect. `draft-2020-12` (the default) writes `$defs`; `draft-07`
+   * and `openapi-3.0` (`nullable`, `example`) write `definitions`.
+   */
+  readonly target?: JsonSchemaTarget;
+}
+type JsonSchema = Record<string, unknown>;
+/**
+ * JSON Schema `$defs` for every table: `customersRow`, `customersInsert`,
+ * ... `target` lowers the document to draft-07 or the OpenAPI 3.0 dialect,
+ * which keep the schemas under `definitions`.
+ */
+declare function buildJsonSchema(input: DocsSource, id?: string, target?: JsonSchemaTarget): JsonSchema;
+/** Writes the JSON Schema document; `createOpenApi` reuses the same `$defs`. */
+declare function jsonSchema(options?: JsonSchemaGeneratorOptions): Generator;
+//#endregion
+//#region src/generators/standard-schema.d.ts
+interface StandardSchemaGeneratorOptions {
+  /** Output path relative to the project root. Defaults to `<output>.standard.ts`. */
+  readonly output?: string;
+  /**
+   * Standard Schemas for typed jsonb columns:
+   * `{ 'customers.metadata': './schemas.ts#metadata' }`.
+   */
+  readonly json?: Readonly<Record<string, string>>;
+}
+/**
+ * Standard Schemas for every table's Row, Insert and Update shape, with no
+ * validation library. Each one also converts to JSON Schema (Standard JSON
+ * Schema), and `validators` plugs into the validation plugin.
+ */
+declare function standardSchema(options?: StandardSchemaGeneratorOptions): 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>>;
+  /**
+   * `classic` (the default) imports `zod` and chains methods; `mini` imports
+   * `zod/mini` and uses its functional API (`z.nullable(...)`, `.check(...)`),
+   * which tree-shakes to a smaller bundle. Both need zod 4.
+   */
+  readonly flavor?: ZodFlavor;
+}
+type ZodFlavor = "classic" | "mini";
+/**
+ * Zod 4 schemas for every table's Row, Insert and Update shape, for `zod`
+ * or, with `flavor: 'mini'`, `zod/mini`.
+ */
+declare function zod(options?: ZodGeneratorOptions): Generator;
+//#endregion
+export { defineConfig as _, valibot as a, CONFIG_DEFAULTS as b, JsonSchemaGeneratorOptions as c, JsonSchemaTarget as d, ClaimPaths as f, CONFIG_SCHEMA_URL as g, tenantClaimPaths as h, ValibotGeneratorOptions as i, buildJsonSchema as l, claimPaths as m, ZodGeneratorOptions as n, StandardSchemaGeneratorOptions as o, DEFAULT_CLAIMS as p, zod as r, standardSchema as s, ZodFlavor as t, jsonSchema as u, resolveConfig as v, resolveJsonSchema as y };