better-supabase 0.12.0 → 0.14.0

package/dist/cli/index.d.ts

@@ -1,7 +1,139 @@
 import { styleText } from "node:util";
+import "better-supabase/blocks";
 import { Catalog, CatalogCheck, CatalogColumn, CatalogColumnGrant, CatalogEnum, CatalogForeignKey, CatalogFunction, CatalogFunctionArg, CatalogGrant, CatalogIndex, CatalogPolicy, CatalogTable, CatalogTrigger, CatalogUnique, ExtrasFunction, ExtrasHook, ExtrasHookFunction, ExtrasTable, ForeignKeyAction, GeneratedFile, GeneratorMetadata, GeneratorMetadata as GeneratorMetadata$1, ResolvedConfig, Snapshot, SnapshotBucket, SnapshotExtras } from "better-supabase/config";
 import { Casing, Codec, FunctionMeta, RelationMeta, SchemaMeta, TableMeta } from "better-supabase";
-import "better-supabase/blocks";
+//#region ../../node_modules/.pnpm/citty@0.2.2/node_modules/citty/dist/index.d.mts
+//#region src/types.d.ts
+type ArgType = "boolean" | "string" | "enum" | "positional" | undefined;
+type _ArgDef<T extends ArgType, VT extends boolean | number | string> = {
+  type?: T;
+  description?: string;
+  valueHint?: string;
+  alias?: string | string[];
+  default?: VT;
+  required?: boolean;
+  options?: string[];
+};
+type BooleanArgDef = Omit<_ArgDef<"boolean", boolean>, "options"> & {
+  negativeDescription?: string;
+};
+type StringArgDef = Omit<_ArgDef<"string", string>, "options">;
+type EnumArgDef = _ArgDef<"enum", string>;
+type PositionalArgDef = Omit<_ArgDef<"positional", string>, "alias" | "options">;
+type ArgDef = BooleanArgDef | StringArgDef | PositionalArgDef | EnumArgDef;
+type ArgsDef = Record<string, ArgDef>;
+type ResolveParsedArgType<T extends ArgDef, VT> = T extends {
+  default?: any;
+  required?: boolean;
+} ? T["default"] extends NonNullable<VT> ? VT : T["required"] extends true ? VT : VT | undefined : VT | undefined;
+type ParsedPositionalArg<T extends ArgDef> = T extends {
+  type: "positional";
+} ? ResolveParsedArgType<T, string> : never;
+type ParsedStringArg<T extends ArgDef> = T extends {
+  type: "string";
+} ? ResolveParsedArgType<T, string> : never;
+type ParsedBooleanArg<T extends ArgDef> = T extends {
+  type: "boolean";
+} ? ResolveParsedArgType<T, boolean> : never;
+type ParsedEnumArg<T extends ArgDef> = T extends {
+  type: "enum";
+  options: infer U;
+} ? U extends Array<any> ? ResolveParsedArgType<T, U[number]> : never : never;
+type RawArgs = {
+  _: string[];
+};
+type ParsedArg<T extends ArgDef> = T["type"] extends "positional" ? ParsedPositionalArg<T> : T["type"] extends "boolean" ? ParsedBooleanArg<T> : T["type"] extends "string" ? ParsedStringArg<T> : T["type"] extends "enum" ? ParsedEnumArg<T> : never;
+type ParsedArgs<T extends ArgsDef = ArgsDef> = RawArgs & { [K in keyof T]: ParsedArg<T[K]>; } & { [K in keyof T as T[K] extends {
+  alias: string;
+} ? T[K]["alias"] : never]: ParsedArg<T[K]>; } & { [K in keyof T as T[K] extends {
+  alias: string[];
+} ? T[K]["alias"][number] : never]: ParsedArg<T[K]>; } & Record<string, string | number | boolean | string[]>;
+interface CommandMeta {
+  name?: string;
+  version?: string;
+  description?: string;
+  hidden?: boolean;
+  alias?: string | string[];
+}
+type SubCommandsDef = Record<string, Resolvable<CommandDef<any>>>;
+type CommandDef<T extends ArgsDef = ArgsDef> = {
+  meta?: Resolvable<CommandMeta>;
+  args?: Resolvable<T>;
+  default?: Resolvable<string>;
+  subCommands?: Resolvable<SubCommandsDef>;
+  plugins?: Resolvable<CittyPlugin>[];
+  setup?: (context: CommandContext<T>) => any | Promise<any>;
+  cleanup?: (context: CommandContext<T>) => any | Promise<any>;
+  run?: (context: CommandContext<T>) => any | Promise<any>;
+};
+type CommandContext<T extends ArgsDef = ArgsDef> = {
+  rawArgs: string[];
+  args: ParsedArgs<T>;
+  cmd: CommandDef<T>;
+  subCommand?: CommandDef<T>;
+  data?: any;
+};
+type CittyPlugin = {
+  name: string;
+  setup?(context: CommandContext<any>): void | Promise<void>;
+  cleanup?(context: CommandContext<any>): void | Promise<void>;
+};
+type Resolvable<T> = T | Promise<T> | (() => T) | (() => Promise<T>);
+//#endregion
+//#region src/cli/env.d.ts
+/** The environment variables the CLI reads, validated once per run. */
+interface CliEnv {
+  /** Postgres connection string for gen, introspect, doctor and seed. */
+  readonly DATABASE_URL?: string | undefined;
+  /**
+   * The Supabase name for the same connection string, read when `DATABASE_URL`
+   * is unset.
+   */
+  readonly SUPABASE_DB_URL?: string | undefined;
+  /** Personal access token for reading a hosted project. */
+  readonly SUPABASE_ACCESS_TOKEN?: string | undefined;
+  /** Management API base URL; defaults to https://api.supabase.com. */
+  readonly SUPABASE_API_URL?: string | undefined;
+  /** The Supabase CLI to run instead of `supabase` on the PATH. */
+  readonly SUPABASE_BIN?: string | undefined;
+  /** Home directory for `skills install --global`. */
+  readonly HOME?: string | undefined;
+  /**
+   * Set in CI; prompts never run there, and the config's `ci` environment
+   * applies.
+   */
+  readonly CI?: string | undefined;
+  /** The config environment to apply when `--env` is not passed. */
+  readonly BETTER_SUPABASE_ENV?: string | undefined;
+  /**
+   * Agent mode when `--agent` is not passed: auto, yes or no. `run()` reads it
+   * before parsing.
+   */
+  readonly BETTER_SUPABASE_AGENT?: string | undefined;
+  /**
+   * The named local stack `db query` and `seed` use when `--stack` is not
+   * passed.
+   */
+  readonly BSB_STACK?: string | undefined;
+  /**
+   * The directory with `pg_dump` and `psql` for `db diff --in-stack`; found
+   * from the stack's postmaster otherwise.
+   */
+  readonly BSB_PG_BIN?: string | undefined;
+  /** Every variable of the run, for the processes the CLI starts. */
+  readonly [PROCESS_ENV]?: Readonly<Record<string, string | undefined>>;
+}
+/**
+ * The key of the full environment on a `CliEnv`; a symbol, so JSON output never
+ * shows it.
+ */
+declare const PROCESS_ENV: unique symbol;
+//#endregion
+//#region src/cli/style.d.ts
+type Format = Parameters<typeof styleText>[0];
+/** Styles text, or returns it unchanged when colors are off. */
+type Paint = (format: Format, text: string) => string;
+//#endregion
 //#region src/cli/prompts.d.ts
 interface Choice<T extends string> {
   readonly value: T;
@@ -9,9 +141,9 @@ interface Choice<T extends string> {
   readonly hint?: string;
 }
 /**
- * Questions for a person at a terminal. `run()` only gets one
- * from the bin on a TTY outside CI. A method that resolves `undefined` gave
- * no answer, and the command takes its default.
+ * Questions for a person at a terminal. `run()` only gets one from the bin on a
+ * TTY outside CI. A method that resolves `undefined` gave no answer, and the
+ * command takes its default.
  */
 interface Prompter {
   readonly select: <T extends string>(message: string, choices: readonly Choice<T>[], initial: T) => Promise<T | undefined>;
@@ -21,8 +153,8 @@ interface Prompter {
 //#endregion
 //#region src/cli/core/errors.d.ts
 /**
- * `1` for a failure or a failed check, `2` for a usage error the caller can
- * fix by changing the command, `3` when the user has to act (give an input,
+ * `1` for a failure or a failed check, `2` for a usage error the caller can fix
+ * by changing the command, `3` when the user has to act (give an input,
  * consent, log in), `130` when the run was interrupted or a prompt cancelled,
  * `143` when it was terminated (SIGTERM), and `65` when `gen --metadata`
  * rejects its input.
@@ -76,23 +208,28 @@ interface CliIo {
   readonly stdin?: () => Promise<string>;
   /** Stdin is a terminal, so reading it would wait for typing instead of a pipe. */
   readonly stdinIsTty?: boolean;
-  /** Stdout is a terminal. Agent detection counts `CURSOR_TRACE_ID` only when it is not. */
+  /**
+   * Stdout is a terminal. Agent detection counts `CURSOR_TRACE_ID` only when it
+   * is not.
+   */
   readonly stdoutIsTty?: boolean;
-  /** Whether a path exists on the host, for agent detection. Without it, no file counts. */
+  /**
+   * Whether a path exists on the host, for agent detection. Without it, no file
+   * counts.
+   */
   readonly exists?: (path: string) => boolean;
   /** Color stdout with ANSI escapes. Off unless set; `--no-color` turns it off. */
   readonly color?: boolean;
   /** Color stderr with ANSI escapes. Defaults to `color`. */
   readonly stderrColor?: boolean;
   /**
-   * Shows `message` on stderr until the returned function is called: a
-   * spinner on a terminal, a plain line elsewhere. Without it, progress
-   * shows nothing.
+   * Shows `message` on stderr until the returned function is called: a spinner
+   * on a terminal, a plain line elsewhere. Without it, progress shows nothing.
    */
   readonly spinner?: (message: string) => () => void;
   /**
-   * Prompts for a person at a terminal. `run()` drops them in CI, in agent
-   * mode and under `--json` or `--yes`, and without them commands never ask.
+   * Prompts for a person at a terminal. `run()` drops them in CI, in agent mode
+   * and under `--json` or `--yes`, and without them commands never ask.
    */
   readonly prompts?: Prompter;
 }
@@ -111,135 +248,26 @@ interface CommandResult {
   readonly output?: string;
   readonly error?: string;
   /**
-   * The error code `--json` reports when `code` is not 0. Without it, exit
-   * code 2 reports `usage`, 3 `input_required`, 130 `cancelled`, and any
-   * other `failed`.
+   * The error code `--json` reports when `code` is not 0. Without it, exit code
+   * 2 reports `usage`, 3 `input_required`, 130 `cancelled`, and any other
+   * `failed`.
    */
   readonly errorCode?: CliErrorCode;
   /** The `data` of the `--json` envelope. */
   readonly data?: unknown;
   readonly next?: readonly NextStep[];
   /**
-   * Printed on stdout exactly as is, in place of `output` and the envelope:
-   * a document another tool reads, like `gen --metadata` without `--out`.
+   * Printed on stdout exactly as is, in place of `output` and the envelope: a
+   * document another tool reads, like `gen --metadata` without `--out`.
    */
   readonly raw?: string;
-  /** The command already printed its results through `emit`, so `run()` prints nothing more. */
+  /**
+   * The command already printed its results through `emit`, so `run()` prints
+   * nothing more.
+   */
   readonly streamed?: boolean;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/citty@0.2.2/node_modules/citty/dist/index.d.mts
-//#region src/types.d.ts
-type ArgType = "boolean" | "string" | "enum" | "positional" | undefined;
-type _ArgDef<T extends ArgType, VT extends boolean | number | string> = {
-  type?: T;
-  description?: string;
-  valueHint?: string;
-  alias?: string | string[];
-  default?: VT;
-  required?: boolean;
-  options?: string[];
-};
-type BooleanArgDef = Omit<_ArgDef<"boolean", boolean>, "options"> & {
-  negativeDescription?: string;
-};
-type StringArgDef = Omit<_ArgDef<"string", string>, "options">;
-type EnumArgDef = _ArgDef<"enum", string>;
-type PositionalArgDef = Omit<_ArgDef<"positional", string>, "alias" | "options">;
-type ArgDef = BooleanArgDef | StringArgDef | PositionalArgDef | EnumArgDef;
-type ArgsDef = Record<string, ArgDef>;
-type ResolveParsedArgType<T extends ArgDef, VT> = T extends {
-  default?: any;
-  required?: boolean;
-} ? T["default"] extends NonNullable<VT> ? VT : T["required"] extends true ? VT : VT | undefined : VT | undefined;
-type ParsedPositionalArg<T extends ArgDef> = T extends {
-  type: "positional";
-} ? ResolveParsedArgType<T, string> : never;
-type ParsedStringArg<T extends ArgDef> = T extends {
-  type: "string";
-} ? ResolveParsedArgType<T, string> : never;
-type ParsedBooleanArg<T extends ArgDef> = T extends {
-  type: "boolean";
-} ? ResolveParsedArgType<T, boolean> : never;
-type ParsedEnumArg<T extends ArgDef> = T extends {
-  type: "enum";
-  options: infer U;
-} ? U extends Array<any> ? ResolveParsedArgType<T, U[number]> : never : never;
-type RawArgs = {
-  _: string[];
-};
-type ParsedArg<T extends ArgDef> = T["type"] extends "positional" ? ParsedPositionalArg<T> : T["type"] extends "boolean" ? ParsedBooleanArg<T> : T["type"] extends "string" ? ParsedStringArg<T> : T["type"] extends "enum" ? ParsedEnumArg<T> : never;
-type ParsedArgs<T extends ArgsDef = ArgsDef> = RawArgs & { [K in keyof T]: ParsedArg<T[K]>; } & { [K in keyof T as T[K] extends {
-  alias: string;
-} ? T[K]["alias"] : never]: ParsedArg<T[K]>; } & { [K in keyof T as T[K] extends {
-  alias: string[];
-} ? T[K]["alias"][number] : never]: ParsedArg<T[K]>; } & Record<string, string | number | boolean | string[]>;
-interface CommandMeta {
-  name?: string;
-  version?: string;
-  description?: string;
-  hidden?: boolean;
-  alias?: string | string[];
-}
-type SubCommandsDef = Record<string, Resolvable<CommandDef<any>>>;
-type CommandDef<T extends ArgsDef = ArgsDef> = {
-  meta?: Resolvable<CommandMeta>;
-  args?: Resolvable<T>;
-  default?: Resolvable<string>;
-  subCommands?: Resolvable<SubCommandsDef>;
-  plugins?: Resolvable<CittyPlugin>[];
-  setup?: (context: CommandContext<T>) => any | Promise<any>;
-  cleanup?: (context: CommandContext<T>) => any | Promise<any>;
-  run?: (context: CommandContext<T>) => any | Promise<any>;
-};
-type CommandContext<T extends ArgsDef = ArgsDef> = {
-  rawArgs: string[];
-  args: ParsedArgs<T>;
-  cmd: CommandDef<T>;
-  subCommand?: CommandDef<T>;
-  data?: any;
-};
-type CittyPlugin = {
-  name: string;
-  setup?(context: CommandContext<any>): void | Promise<void>;
-  cleanup?(context: CommandContext<any>): void | Promise<void>;
-};
-type Resolvable<T> = T | Promise<T> | (() => T) | (() => Promise<T>);
-//#endregion
-//#region src/cli/env.d.ts
-/** The environment variables the CLI reads, validated once per run. */
-interface CliEnv {
-  /** Postgres connection string for gen, introspect, doctor and seed. */
-  readonly DATABASE_URL?: string | undefined;
-  /** The Supabase name for the same connection string, read when `DATABASE_URL` is unset. */
-  readonly SUPABASE_DB_URL?: string | undefined;
-  /** Personal access token for reading a hosted project. */
-  readonly SUPABASE_ACCESS_TOKEN?: string | undefined;
-  /** Management API base URL; defaults to https://api.supabase.com. */
-  readonly SUPABASE_API_URL?: string | undefined;
-  /** The Supabase CLI to run instead of `supabase` on the PATH. */
-  readonly SUPABASE_BIN?: string | undefined;
-  /** Home directory for `skills install --global`. */
-  readonly HOME?: string | undefined;
-  /** Set in CI; prompts never run there, and the config's `ci` environment applies. */
-  readonly CI?: string | undefined;
-  /** The config environment to apply when `--env` is not passed. */
-  readonly BETTER_SUPABASE_ENV?: string | undefined;
-  /** Agent mode when `--agent` is not passed: auto, yes or no. `run()` reads it before parsing. */
-  readonly BETTER_SUPABASE_AGENT?: string | undefined;
-  /** The named local stack `db query` and `seed` use when `--stack` is not passed. */
-  readonly BSB_STACK?: string | undefined;
-  /** Every variable of the run, for the processes the CLI starts. */
-  readonly [PROCESS_ENV]?: Readonly<Record<string, string | undefined>>;
-}
-/** The key of the full environment on a `CliEnv`; a symbol, so JSON output never shows it. */
-declare const PROCESS_ENV: unique symbol;
-//#endregion
-//#region src/cli/style.d.ts
-type Format = Parameters<typeof styleText>[0];
-/** Styles text, or returns it unchanged when colors are off. */
-type Paint = (format: Format, text: string) => string;
-//#endregion
 //#region src/cli/core/agent.d.ts
 /** Destructive work that waits for a person's consent in agent mode. */
 interface ConsentRequest {
@@ -251,8 +279,8 @@ interface ConsentRequest {
 //#endregion
 //#region src/cli/core/log.d.ts
 /**
- * Messages for the person running the command. Every method writes to
- * stderr, so stdout carries only the command's output or its JSON document.
+ * Messages for the person running the command. Every method writes to stderr,
+ * so stdout carries only the command's output or its JSON document.
  */
 interface CliLog {
   readonly info: (text: string) => void;
@@ -261,8 +289,8 @@ interface CliLog {
   /** Written only under `--debug`. */
   readonly debug: (text: string) => void;
   /**
-   * Runs `task` while `message` shows: a spinner on a terminal, one plain
-   * line elsewhere. Under `--debug` it also logs how long the task took.
+   * Runs `task` while `message` shows: a spinner on a terminal, one plain line
+   * elsewhere. Under `--debug` it also logs how long the task took.
    */
   readonly progress: <T>(message: string, task: () => Promise<T>) => Promise<T>;
 }
@@ -284,7 +312,10 @@ interface CliContext {
   readonly signal: AbortSignal | undefined;
   /** Messages and progress on stderr. */
   readonly log: CliLog;
-  /** Colors text for stdout, or leaves it plain under `--no-color` and in a pipe. */
+  /**
+   * Colors text for stdout, or leaves it plain under `--no-color` and in a
+   * pipe.
+   */
   readonly paint: Paint;
   /**
    * Prints one result now, for a command that runs until stopped: the text
@@ -294,8 +325,8 @@ interface CliContext {
   /** The coding agent running the CLI, in agent mode; `undefined` for a person. */
   readonly agent: string | undefined;
   /**
-   * In agent mode, throws `consent_required` until the run passes
-   * `--confirm` with this request's token; does nothing for a person.
+   * In agent mode, throws `consent_required` until the run passes `--confirm`
+   * with this request's token; does nothing for a person.
    */
   readonly requireConsent: (request: ConsentRequest) => void;
 }
@@ -348,10 +379,16 @@ declare const GLOBAL_ARGS: {
   };
 };
 type CliArgs<T extends ArgsDef> = ParsedArgs<T & typeof GLOBAL_ARGS>;
-/** The values a shell offers for one argument, for names it can't know from the arg definition. */
+/**
+ * The values a shell offers for one argument, for names it can't know from the
+ * arg definition.
+ */
 type CompletionValues = () => readonly string[];
 interface CliCommandDef<T extends ArgsDef> {
-  /** The command contract; a breaking change to `CliContext` or `CommandResult` ships a new one. */
+  /**
+   * The command contract; a breaking change to `CliContext` or `CommandResult`
+   * ships a new one.
+   */
   readonly apiVersion?: 1;
   readonly meta: CommandMeta & {
     readonly name: string;
@@ -383,19 +420,28 @@ interface RunOptions {
   readonly env?: Readonly<Record<string, string | undefined>>;
   readonly io?: CliIo;
   readonly signal?: AbortSignal;
-  /** The name the CLI was called with, for help and hints. Defaults to `better-supabase`. */
+  /**
+   * The name the CLI was called with, for help and hints. Defaults to
+   * `better-supabase`.
+   */
   readonly bin?: string;
 }
 interface Cli {
   /** Runs the CLI. Never exits the process; returns the exit code and output. */
   run(argv: readonly string[], options?: RunOptions): Promise<RunResult>;
-  /** The usage text for the CLI, or for one command path (`"sql add"`); plain unless `color` is set. */
+  /**
+   * The usage text for the CLI, or for one command path (`"sql add"`); plain
+   * unless `color` is set.
+   */
   help(command?: string, color?: boolean): Promise<string>;
   /** The top-level names `run()` dispatches, your own commands included. */
   commandNames(): string[];
 }
 interface CreateCliOptions {
-  /** Commands from `defineCliCommand` to add next to the built-in ones, keyed by name. */
+  /**
+   * Commands from `defineCliCommand` to add next to the built-in ones, keyed by
+   * name.
+   */
   readonly commands?: Readonly<Record<string, CliCommand>>;
 }
 /**
@@ -408,31 +454,53 @@ export declare const help: Cli["help"];
 /** The names `run()` dispatches. */
 export declare const commandNames: Cli["commandNames"];
 //#endregion
+//#region src/cli/project/detect.d.ts
+type Framework = "next" | "hono" | "orpc" | "vite" | "expo" | "tanstack-query";
+//#endregion
 //#region src/cli/gen/render.d.ts
 interface RenderOptions {
-  /** Where the generated module imports the runtime from. Defaults to `better-supabase`. */
+  /**
+   * Where the generated module imports the runtime from. Defaults to
+   * `better-supabase`.
+   */
   readonly runtimeImport?: string;
   /** Writes the metadata into the main module, so it stands alone on stdout. */
   readonly inlineMeta?: boolean;
+  /**
+   * The frameworks the record features get bindings for. Defaults to the ones
+   * the project's dependencies show.
+   */
+  readonly frameworks?: readonly Framework[];
 }
 /**
  * Renders every generated file for a snapshot, without touching disk:
  * `database.types.ts` (what `supabase gen types` prints), the main module,
- * `blocks.generated.ts` when the config installs blocks,
- * then each configured generator's files.
+ * `blocks.generated.ts` when the config installs blocks, the record features in
+ * `features/`, then each configured generator's files.
  */
 export declare function renderFiles(config: ResolvedConfig, snapshot: Snapshot, options?: RenderOptions): Promise<GeneratedFile[]>;
 //#endregion
 //#region src/cli/gen/blocks.d.ts
 /**
  * `blocks.generated.ts`: each installed block's schema, API schema and the
- * options its TypeScript side reads, for `defineBlocks(blockConfig, ...)`,
- * and the app table events. `undefined` when the config installs no blocks.
+ * options its TypeScript side reads, for `defineBlocks(blockConfig, ...)`, and
+ * the app table events. `undefined` when the config installs no blocks.
  */
-export declare function emitBlockConfig(config: Pick<ResolvedConfig, "appTables" | "blocks" | "blockNames" | "output" | "sql">, options?: {
+export declare function emitBlockConfig(config: Pick<ResolvedConfig, "appTables" | "blocks" | "blockNames" | "buckets" | "casing" | "output" | "sql" | "subjects">, options?: {
   readonly runtimeImport?: string;
 }): GeneratedFile | undefined;
 //#endregion
+//#region src/cli/introspect/typegen.d.ts
+/**
+ * A connection `introspect()` reads the catalog through, as postgrest-typegen
+ * types it.
+ */
+interface Queryable {
+  query(sql: string): Promise<{
+    rows: any[];
+  }>;
+}
+//#endregion
 //#region src/cli/db.d.ts
 /** The subset of `pg.Client` the CLI uses. */
 interface PgQueryable {
@@ -458,22 +526,14 @@ interface PgConnection {
 /** Opens a `pg` connection. `pg` is an optional peer, loaded on demand. */
 declare function connect(url: string, load?: () => Promise<unknown>, options?: ConnectOptions): Promise<PgConnection>;
 //#endregion
-//#region src/cli/introspect/typegen.d.ts
-/** A connection `introspect()` reads the catalog through, as postgrest-typegen types it. */
-interface Queryable {
-  query(sql: string): Promise<{
-    rows: any[];
-  }>;
-}
-//#endregion
 //#region src/cli/introspect/source.d.ts
 /** A connection introspection can query, plus how to release it. */
 interface IntrospectionSource {
   readonly queryable: Queryable;
   readonly describe: string;
   /**
-   * Set when the schema was replayed into a throwaway database rather than
-   * read from the one the app runs on, saying why live checks are skipped.
+   * Set when the schema was replayed into a throwaway database rather than read
+   * from the one the app runs on, saying why live checks are skipped.
    */
   readonly replay?: string;
   close(): Promise<void>;
@@ -494,8 +554,8 @@ interface ManagementSourceOptions {
   readonly signal?: AbortSignal;
 }
 /**
- * Runs introspection SQL through the Supabase Management API as the
- * read-only database user, so hosted projects need no database password.
+ * Runs introspection SQL through the Supabase Management API as the read-only
+ * database user, so hosted projects need no database password.
  */
 export declare function managementSource(options: ManagementSourceOptions): IntrospectionSource;
 //#endregion
@@ -536,8 +596,8 @@ interface GenOptions extends SnapshotSource {
   /** Pre-loaded snapshot (tests, watch mode). */
   readonly snapshot?: Snapshot;
   /**
-   * Writes only the generated files (`gen --metadata --out-dir`): no read-set SQL
-   * module, and the manifest that removes files an earlier run wrote is
+   * Writes only the generated files (`gen --metadata --out-dir`): no read-set
+   * SQL module, and the manifest that removes files an earlier run wrote is
    * neither read nor written.
    */
   readonly isolated?: boolean;
@@ -545,7 +605,10 @@ interface GenOptions extends SnapshotSource {
 export declare function runGen(options: GenOptions): Promise<CommandResult>;
 //#endregion
 //#region src/cli/introspect/extras.d.ts
-/** A hook function to introspect: `[auth.hook.<hook>]` pointing at `schema.name`. */
+/**
+ * A hook function to introspect: `[auth.hook.<hook>]` pointing at
+ * `schema.name`.
+ */
 interface HookTarget {
   readonly hook: string;
   readonly schema: string;
@@ -566,8 +629,8 @@ export declare function introspect(db: Queryable, schemas: readonly string[], op
 //#endregion
 //#region src/cli/introspect/from-catalog.d.ts
 /**
- * Builds a snapshot from catalog records: the inverse of `toCatalog`. Tests
- * and benchmarks describe schemas as tables and functions; this produces the
+ * Builds a snapshot from catalog records: the inverse of `toCatalog`. Tests and
+ * benchmarks describe schemas as tables and functions; this produces the
  * typegen metadata and extras those records imply.
  */
 export declare function fromCatalog(catalog: Catalog): Snapshot;
@@ -582,7 +645,10 @@ interface ColumnModel {
   readonly nullable: boolean;
   /** Optional on insert. */
   readonly optional: boolean;
-  /** An insert may leave it out: a default, `insertOptional`, or a CHECK-narrowed column a `before insert` trigger can fill. */
+  /**
+   * An insert may leave it out: a default, `insertOptional`, or a
+   * CHECK-narrowed column a `before insert` trigger can fill.
+   */
   readonly filled: boolean;
   /** Not writable (generated always / identity always). */
   readonly readonly: boolean;
@@ -616,7 +682,10 @@ interface TableModel {
 interface EnumModel {
   readonly schema: string;
   readonly name: string;
-  /** Key in `meta.enums`: the name, or `schema_name` when another schema has the same enum name. */
+  /**
+   * Key in `meta.enums`: the name, or `schema_name` when another schema has the
+   * same enum name.
+   */
   readonly key: string;
   /** Constant name for the value array, e.g. `noteKindValues`. */
   readonly constant: string;
@@ -631,6 +700,7 @@ interface FunctionModel {
     name: string;
     tsType: string;
     optional: boolean;
+    values: readonly string[] | undefined;
   }[];
   readonly returns: string;
 }
@@ -653,6 +723,8 @@ interface Model {
   readonly introspection: GeneratorMetadata$1;
   /** Config entries that matched nothing in the schema. */
   readonly warnings: readonly string[];
+  /** Hints about the schema, such as nullable `returns table` columns. */
+  readonly notices: readonly string[];
 }
 /** Builds the codegen model from a snapshot and config. */
 export declare function buildModel(snapshot: Snapshot, config: ResolvedConfig): Model;
@@ -668,7 +740,10 @@ interface EmitOptions {
   readonly importPathFor: (from: string) => string;
   /** Import path from the generated module to the metadata module (`emitMeta`). */
   readonly metaImport?: string;
-  /** Writes the metadata into the module instead of importing it, so it is one file. */
+  /**
+   * Writes the metadata into the module instead of importing it, so it is one
+   * file.
+   */
   readonly inlineMeta?: boolean;
 }
 /** Renders the generated module. */
@@ -677,17 +752,17 @@ export declare function emitModule(model: Model, options: EmitOptions): string;
 //#region src/cli/config.d.ts
 /**
  * Loads `better-supabase.config.*` with c12 and checks it against the config
- * schema. c12 imports `.ts` natively (Node 24 strips the types), so no
- * loader is needed; rc files, `package.json`, env overrides and `extends`
- * are off so the one file is the whole config. `environment` merges its
- * blocks in (`applyEnvironment`); c12's own `envName` is off because it
- * concatenates arrays. A discovered file sets the project root to its own
- * directory; `--config` keeps `cwd` as the root. `path` is the file
- * `discoverConfig` found, for callers that already looked it up.
+ * schema. c12 imports `.ts` natively (Node 24 strips the types), so no loader
+ * is needed; rc files, `package.json`, env overrides and `extends` are off so
+ * the one file is the whole config. `environment` merges its blocks in
+ * (`applyEnvironment`); c12's own `envName` is off because it concatenates
+ * arrays. A discovered file sets the project root to its own directory;
+ * `--config` keeps `cwd` as the root. `path` is the file `discoverConfig`
+ * found, for callers that already looked it up.
  */
 export declare function loadConfig(cwd: string, explicit?: string, environment?: string, path?: string | undefined): Promise<ResolvedConfig>;
 //#endregion
 //#region src/cli/version.d.ts
-export declare const VERSION = "0.12.0";
+export declare const VERSION = "0.14.0";
 //#endregion
 export type { Catalog, CatalogCheck, CatalogColumn, CatalogColumnGrant, CatalogEnum, CatalogForeignKey, CatalogFunction, CatalogFunctionArg, CatalogGrant, CatalogIndex, CatalogPolicy, CatalogTable, CatalogTrigger, CatalogUnique, Choice, Cli, CliArgs, CliCommand, CliCommandDef, CliContext, CliEnv, CliErrorCode, CliErrorOptions, CliIo, CliLog, CliProblem, CliProblemExtensions, CommandResult, CreateCliOptions, ExitCode, ExtrasFunction, ExtrasHook, ExtrasHookFunction, ExtrasTable, ForeignKeyAction, Format, GeneratorMetadata, IntrospectionSource, ManagementSourceOptions, NextStep, Paint, Prompter, Queryable, RunOptions, RunResult, Snapshot, SnapshotBucket, SnapshotExtras };