better-supabase 0.12.0 → 0.13.0

package/dist/index-1Vsg-7YV.d.ts

@@ -1,58 +0,0 @@
-import { c as InboxListSnapshot, i as ConversationSnapshot, l as InboxSource, p as InboxWidgetSnapshot, s as InboxListActions, t as ConversationActions, u as InboxWidgetActions } from "./client-BONsuFYf.js";
-//#region src/blocks/inbox/react/index.d.ts
-interface UseInboxOptions<T> {
-  /** The organization; the hook joins `inbox:org:<id>`. `null` waits. */
-  readonly organizationId: string | null;
-  readonly load: InboxSource<T>;
-  /** `blockConfig.inbox.options.topic` from `blocks.generated.ts`. Defaults to `inbox`. */
-  readonly topic?: string;
-  /** Runs for each broadcast, e.g. to show a toast for `message`. */
-  readonly onMessage?: (event: string, payload: unknown) => void;
-}
-interface InboxListState<T> extends InboxListSnapshot<T>, InboxListActions {}
-/**
- * The staff view of an organization's conversations, kept current: loads,
- * then loads again after each ping on `inbox:org:<id>` and on rejoin.
- */
-declare function useInbox<T>(options: UseInboxOptions<T>): InboxListState<T>;
-interface UseConversationOptions<T> {
-  /** `null` waits, e.g. before the widget opens a conversation. */
-  readonly conversationId: string | null;
-  /** The messages, oldest first. */
-  readonly load: InboxSource<T>;
-  readonly topic?: string;
-  /** How long a typing ping counts. Defaults to 5000 ms. */
-  readonly typingMs?: number;
-}
-interface ConversationState<T> extends ConversationSnapshot<T>, ConversationActions {}
-/**
- * One conversation's messages, kept current over `inbox:<id>`, with typing
- * pings between staff and the contact. Notes never reach this topic.
- */
-declare function useConversation<T>(options: UseConversationOptions<T>): ConversationState<T>;
-interface UseInboxWidgetOptions<T> {
-  /**
-   * Opens the visitor's conversation, e.g. a server action that calls
-   * `inbox.conversations.open(inboxId, { message })` with the visitor's
-   * transport. Returns its id.
-   */
-  readonly open: (message: string) => Promise<string>;
-  /** Sends into the open conversation. */
-  readonly send: (conversationId: string, message: string) => Promise<void>;
-  readonly load: (conversationId: string) => Promise<readonly T[]>;
-  /**
-   * Remembers the conversation across reloads in the client's storage port
-   * (`localStorage` on the web). Defaults to `better-supabase:inbox-widget`.
-   */
-  readonly storageKey?: string | null;
-  readonly topic?: string;
-}
-interface InboxWidgetState<T> extends InboxWidgetSnapshot<T>, InboxWidgetActions {}
-/**
- * The visitor side of an in-app inbox: the first message opens the
- * conversation, later ones go into it, and the messages and typing pings
- * stay current. Visitors without an account sign in anonymously first.
- */
-declare function useInboxWidget<T>(options: UseInboxWidgetOptions<T>): InboxWidgetState<T>;
-//#endregion
-export { UseInboxOptions as a, useInbox as c, UseConversationOptions as i, useInboxWidget as l, InboxListState as n, UseInboxWidgetOptions as o, InboxWidgetState as r, useConversation as s, ConversationState as t };

package/dist/index-BJLPQr2s.d.ts

@@ -1,377 +0,0 @@
-import { d as AccessBlockConfig, p as AnyBlocksConfig } from "./authorization-ClWBcXJi.js";
-import { i as BlockCategory } from "./define-block-BHxLHLys.js";
-import { i as PortName } from "./ports-P0A5wo_-.js";
-import { Nn as AppTablesConfig, On as AppTableConfig, dt as PresetScope, ft as PresetTenantName, it as PresetCodeField, nt as Preset, rt as PresetAccess, st as PresetFieldKey, y as BetterSupabaseConfig } from "./codegen-C64C0NZG.js";
-//#region src/preset/blocks.d.ts
-/**
- * Every block a preset code can select, by bit position. Append-only: a new
- * block goes at the end, and a removed block becomes `null` (a tombstone) so
- * the blocks after it keep their bits. A test checks that it lists every SQL
- * module.
- */
-declare const PRESET_BLOCKS: readonly (string | null)[];
-//#endregion
-//#region src/preset/catalog-types.d.ts
-/** One SQL module in the preset catalog: a key of `blocks` in the config. */
-interface PresetCatalogBlock {
-  readonly name: string;
-  readonly title: string;
-  readonly category: BlockCategory;
-  /** The modules it needs with the default options. */
-  readonly requires: readonly string[];
-  /** What it needs instead under an access model, where that differs. */
-  readonly requiresByAccess?: Partial<Readonly<Record<PresetAccess, readonly string[]>>>;
-  /** The scopes it runs in; unset, every scope. */
-  readonly scopes?: readonly PresetScope[];
-  /** Tenant names that would rename a table or column to a name it already uses. */
-  readonly tenantNameClashes?: readonly PresetTenantName[];
-  /** The logical table `options.extraColumns` adds columns to, when it takes them. */
-  readonly extraColumns?: string;
-  /** Modules it works with when installed; `*` is every module. */
-  readonly integrates: readonly string[];
-  /** The manifest that installs it, a key of `manifests`. */
-  readonly manifest: string;
-}
-/** One block manifest (ADR 0029): what `lib/blocks.ts` wires. */
-interface PresetCatalogManifest {
-  readonly name: string;
-  /** The SQL modules it installs. */
-  readonly sql: readonly string[];
-  readonly category: BlockCategory;
-  /** Its export and subpath, when it has a TypeScript client. */
-  readonly client: {
-    readonly export: string;
-    readonly subpath: string;
-  } | null;
-  readonly consumes: Partial<Readonly<Record<PortName, "optional" | "required">>>;
-  readonly provides: readonly PortName[];
-}
-/**
- * One item of the `@better-supabase` shadcn registry: glue the app copies
- * (`npx shadcn add @better-supabase/<name>`), for some blocks, frameworks
- * and platforms.
- */
-interface PresetGlueItem {
-  readonly name: string;
-  readonly title: string;
-  /** The SQL modules the item needs. */
-  readonly blocks: readonly string[];
-  readonly frameworks: readonly string[];
-  readonly platforms: readonly ("web" | "native")[];
-  /** Where its files go, as shadcn targets (`@lib/blocks.ts`, `~/app/...`). */
-  readonly targets: readonly string[];
-  /** The named preset a bundle item (`registry:item`) installs the glue of. */
-  readonly preset?: string;
-}
-/** What `scripts/build-catalog.ts` writes to `catalog.generated.ts`. */
-interface PresetCatalog {
-  readonly blocks: readonly PresetCatalogBlock[];
-  readonly manifests: readonly PresetCatalogManifest[];
-  readonly glue: readonly PresetGlueItem[];
-}
-//#endregion
-//#region src/preset/catalog.generated.d.ts
-declare const PRESET_CATALOG: PresetCatalog;
-//#endregion
-//#region src/preset/code.d.ts
-/** What `decodePreset` returns. */
-interface DecodedPreset {
-  readonly preset: Preset;
-  /** The code version the code was written with. */
-  readonly version: number;
-  /** Fields the code's version predates, set to their defaults. */
-  readonly derived: readonly PresetFieldKey[];
-}
-/** The fields and blocks a code is read against; tests pass their own. */
-interface PresetLayout {
-  readonly fields: readonly PresetCodeField[];
-  readonly blocks: readonly (string | null)[];
-  readonly version: number;
-}
-/**
- * The preset as a code: a version character, then base62 of one BigInt that
- * holds each field's value index and a bit per selected block.
- */
-declare function encodePreset(preset: Partial<Preset>, layout?: PresetLayout): string;
-/**
- * The preset with one convention set to `value`, checked against the field:
- * a value the field doesn't list throws. For a field that takes several
- * values (`integrations`), `value` switches that one on or off.
- */
-declare function withPresetField(preset: Preset, key: PresetFieldKey, value: string): Preset;
-/**
- * Reads a code from `encodePreset`. A code from an older version decodes
- * with the fields it predates at their defaults, listed in `derived`. A
- * code from a newer release throws, naming the upgrade.
- */
-declare function decodePreset(code: string, layout?: PresetLayout): DecodedPreset;
-/**
- * Whether `value` reads as a preset code rather than a preset name: a
- * version character (`1` to `9`, then `A` to `Z`) and base62 digits.
- */
-declare function isPresetCode(value: string): boolean;
-//#endregion
-//#region src/preset/resolve.d.ts
-/** One block in a resolved preset, with why it is there. */
-interface ResolvedPresetBlock {
-  readonly name: string;
-  readonly title: string;
-  readonly category: BlockCategory;
-  /** Whether the preset names it, rather than another block requiring it. */
-  readonly selected: boolean;
-  /** The blocks in the set that require it. */
-  readonly requiredBy: readonly string[];
-  /** "selected", or "required by comments and tags". */
-  readonly reason: string;
-}
-/** A soft integration between two blocks that are both in the set. */
-interface PresetIntegration {
-  /** The block that works with `to`. */
-  readonly from: string;
-  readonly to: string;
-}
-/** Something in the preset that can't install, and why. */
-interface PresetConflict {
-  readonly block?: string;
-  readonly field?: PresetFieldKey;
-  readonly reason: string;
-}
-/** What `resolvePreset` returns. */
-interface ResolvedPreset {
-  readonly preset: Preset;
-  /** Every block to install, in install order; conflicting blocks are left out. */
-  readonly blocks: readonly ResolvedPresetBlock[];
-  /** The soft integrations active between blocks in the set. */
-  readonly integrations: readonly PresetIntegration[];
-  readonly conflicts: readonly PresetConflict[];
-  /** The manifests that cover `blocks`, for `lib/blocks.ts`. */
-  readonly manifests: readonly PresetCatalogManifest[];
-}
-/** "a", "a and b", "a, b and c". */
-declare function listNames(names: readonly string[]): string;
-/**
- * Why `name` can't install with the preset's conventions, or undefined.
- * `/create` disables a block with this reason before it is selected.
- */
-declare function presetBlockConflict(preset: Pick<Preset, "access" | "scope">, name: string, catalog?: PresetCatalog): string | undefined;
-/**
- * The full block set for a preset: the selected blocks and what they
- * require, a reason per block, the soft integrations active between them,
- * and what can't install. It reads the generated catalog, never the SQL
- * renderers, so it runs in the browser.
- */
-declare function resolvePreset(preset: Preset, catalog?: PresetCatalog): ResolvedPreset;
-//#endregion
-//#region src/preset/config.d.ts
-/** A named preset, a code, a `/create?preset=` URL, or a preset object. */
-type PresetInput = string | (Partial<Preset> & {
-  readonly blocks?: readonly string[];
-});
-/** Reads a named preset, a code or a `/create?preset=` URL into a `Preset`. */
-declare function presetOf(input: PresetInput): Preset;
-/** The conventions that map onto config keys; `tenantName` takes any name `sql.naming.tenant` allows. */
-type ConfigConventions = Pick<Preset, "casing" | "idType" | "scope" | "access" | "api"> & {
-  readonly tenantName: string;
-};
-/**
- * The config keys conventions set without a preset: `casing`, `sql`, and
- * `blocks.access` when the access model or id type differ from the defaults.
- */
-declare function conventionConfig(conventions: ConfigConventions): Pick<BetterSupabaseConfig, "casing" | "sql"> & {
-  readonly blocks?: {
-    readonly access: AccessBlockConfig;
-  };
-};
-/** The config keys a resolved preset sets: its blocks and the conventions that differ from the defaults. */
-declare function presetConfig(resolved: ResolvedPreset): Pick<BetterSupabaseConfig, "casing" | "sql" | "integrations"> & {
-  readonly blocks: AnyBlocksConfig;
-};
-/**
- * `config` with its `preset` expanded: the preset's blocks (and what they
- * require) and conventions first, then the config's own keys over them, so
- * explicit config wins. A block in both keeps the preset's settings that the
- * config's entry leaves unset. Expanding twice gives the same config.
- */
-declare function expandPreset(config: BetterSupabaseConfig): BetterSupabaseConfig;
-//#endregion
-//#region src/preset/design.d.ts
-/**
- * What the `/create` canvas adds to a preset (ADR 0040): tables the app
- * owns, extra columns on block tables, and where each table sits on the
- * canvas. It travels in the `&design=` parameter of a `/create` URL.
- */
-interface CreateDesign {
-  /** `config.appTables`. */
-  readonly appTables?: Readonly<Record<string, AppTableConfig>>;
-  /** `blocks.<module>.options.extraColumns`: column name to SQL type, per module. */
-  readonly extraColumns?: Readonly<Record<string, Readonly<Record<string, string>>>>;
-  /** Canvas positions by `schema.table`, as `[x, y]`; the config ignores them. */
-  readonly positions?: Readonly<Record<string, readonly [number, number]>>;
-}
-/**
- * The newest format of the design JSON, in its `version` key (ADR 0042).
- * A code carries the lowest format that reads it, and none for format 0,
- * so a design without format 1 keys still opens in an older release.
- * Format 1 adds column `format`, `options`, `min`, `max`, `comment` and
- * `identity`, and table `id`, `unique`, `indexes` and `comment`. Format 2
- * adds table `subject` (ADR 0043). Format 3 adds table `rollups` and
- * `lookups` (ADR 0044). Format 4 adds table `events` (ADR 0048) and
- * subject `versions`. Format 5 adds column `access` (ADR 0051).
- */
-declare const DESIGN_FORMAT = 5;
-/** The lowest design format that reads `design`. */
-declare function designFormat(design: CreateDesign): number;
-/** The longest design code, so a `/create` URL stays under common limits. */
-declare const MAX_DESIGN_CODE_LENGTH = 6e3;
-/** The name Create gives the design file it downloads. */
-declare const DESIGN_FILE = "better-supabase.design.json";
-/**
- * What `encodeDesign` throws when a valid design is too long for a URL, so
- * a caller can offer the config download instead of a fix.
- */
-declare class DesignTooLongError extends TypeError {
-  /** The length the code would have. */
-  readonly length: number;
-  constructor(length: number);
-}
-/** Whether `value` has the shape of a design code. It may still fail to decode. */
-declare function isDesignCode(value: string): boolean;
-/**
- * Checks a design object, such as one from storage or a request body, and
- * drops its empty parts. It runs the same checks as `decodeDesign`, without
- * the code. Throws a TypeError naming the first problem.
- */
-declare function parseDesign(value: unknown): CreateDesign;
-/**
- * The design as a code for the `&design=` parameter: `0`, then its JSON
- * (with `version` set to `designFormat` when it is above 0) compressed with
- * deflate-raw, in base64url. An empty design is `""`.
- * Throws a TypeError when the design is invalid, and a `DesignTooLongError`
- * when the code would be longer than `MAX_DESIGN_CODE_LENGTH`.
- */
-declare function encodeDesign(design: CreateDesign): Promise<string>;
-/** Reads a design code. Throws a TypeError when it isn't a valid one. */
-declare function decodeDesign(code: string): Promise<CreateDesign>;
-/**
- * The design in a `/create` URL's `&design=` parameter, or in a bare design
- * code; `undefined` when `input` has neither.
- */
-declare function designOf(input: string): Promise<CreateDesign | undefined>;
-/**
- * The config keys a preset with a design sets: `presetConfig`, with each
- * block's `options.extraColumns` and `appTables`. Throws a TypeError when the
- * design adds columns to a block the preset doesn't install.
- */
-declare function designConfig(resolved: ResolvedPreset, design: CreateDesign): ReturnType<typeof presetConfig> & {
-  readonly appTables?: AppTablesConfig;
-};
-/**
- * `better-supabase.config.ts` for a preset with a design. `designCode`, the
- * design's `encodeDesign`, goes into the `/create` URL in the comment, so the
- * canvas reopens with its positions.
- */
-declare function designConfigSource(resolved: ResolvedPreset, design: CreateDesign, designCode?: string): string;
-/**
- * The command that starts a project from the preset and design: `init` with
- * the quoted `/create` URL, or `presetInstallCommand` when `designCode` is
- * empty.
- */
-declare function designInstallCommand(resolved: ResolvedPreset, designCode: string): string;
-/**
- * A preset and its design as one JSON file, for a design too long for a URL
- * (ADR 0058). `init --preset` and `apply --preset` read it from a path.
- */
-interface DesignFile {
-  /** The preset code. */
-  readonly preset: string;
-  /** The design, with `version` set to `designFormat` when it is above 0. */
-  readonly design: CreateDesign & {
-    readonly version?: number;
-  };
-}
-/**
- * The design file for a preset and design, as JSON text. Throws a TypeError
- * when the design is invalid; it has no length limit.
- */
-declare function designFileSource(resolved: ResolvedPreset, design: CreateDesign): string;
-/**
- * Reads a design file's text. Throws a TypeError naming the first problem:
- * text that isn't JSON, a missing or invalid preset, or an invalid design.
- */
-declare function readDesignFile(text: string): {
-  readonly preset: Preset;
-  readonly design: CreateDesign;
-};
-/** The command that applies the preset and design to an existing project. */
-declare function designApplyCommand(resolved: ResolvedPreset, designCode: string): string;
-//#endregion
-//#region src/preset/design-diff.d.ts
-/** What changed between two sets of app tables. */
-type DesignChangeKind = "table.added" | "table.dropped" | "table.renamed" | "table.id" | "table.scope" | "table.unique" | "table.columns" | "table.changed" | "table.computed" | "table.events" | "table.versions" | "column.added" | "column.dropped" | "column.renamed" | "column.type" | "column.required" | "column.unique" | "column.options" | "column.bounds" | "column.format" | "column.reference" | "column.access" | "column.changed";
-interface DesignChange {
-  readonly kind: DesignChangeKind;
-  readonly table: string;
-  readonly column?: string;
-  /** The old name of a renamed table or column, or the old type. */
-  readonly from?: string;
-  /** The new type of a type change. */
-  readonly to?: string;
-  /**
-   * True when existing rows or app code can break: a dropped or renamed
-   * table or column, a type change, a column made required without a
-   * default, a new or tighter constraint (unique, options, bounds, format,
-   * a reference target), tighter column access, a new scope, or removed
-   * generated columns.
-   */
-  readonly breaking: boolean;
-  readonly summary: string;
-  /** The expand-and-contract steps that make a breaking change safe. */
-  readonly steps: readonly string[];
-}
-interface DiffOptions {
-  /**
-   * Leave out tables that `after` doesn't have, as `apply` does: it writes
-   * the tables of a design and keeps the others.
-   */
-  readonly keepMissing?: boolean;
-}
-/**
- * What changes from `before` to `after`: each added, dropped, renamed or
- * changed table and column, with the breaking ones marked and their
- * expand-and-contract steps. A rename is a dropped name and an added one
- * with the same definition.
- */
-declare function diffAppTables(before: AppTablesConfig, after: AppTablesConfig, options?: DiffOptions): readonly DesignChange[];
-/** `diffAppTables` over the app tables of two `/create` designs. */
-declare function diffDesigns(before: CreateDesign, after: CreateDesign): readonly DesignChange[];
-//#endregion
-//#region src/preset/render.d.ts
-/** The comment a config with the provider access model gets above `blocks`. */
-declare const PROVIDER_COMMENT: readonly string[];
-/**
- * `better-supabase.config.ts` for a resolved preset: every block with its
- * reason, and the conventions that differ from the defaults.
- */
-declare function presetConfigSource(resolved: ResolvedPreset): string;
-/**
- * `lib/blocks.ts`: the blocks with a TypeScript client, wired with
- * `defineBlocks` over the Data API as the caller. Each block's schema (the
- * API schema when `sql.api` is set) and shared options come from
- * `blockConfig`, which `better-supabase gen` writes to
- * `blocks.generated.ts`; `blockConfigImport` is its import path.
- */
-declare function presetBlocksSource(resolved: ResolvedPreset, blockConfigImport?: string): string;
-/**
- * The registry glue for the preset's framework and platforms: each item
- * whose blocks are all installed, except bundles and items that write
- * `lib/blocks.ts`, which the preset writes itself.
- */
-declare function presetGlue(resolved: ResolvedPreset, catalog?: PresetCatalog): readonly PresetGlueItem[];
-/** The shadcn command that copies glue items into the app. */
-declare function glueCommand(items: readonly PresetGlueItem[]): string;
-/** The command that starts a project from the preset. */
-declare function presetInstallCommand(resolved: ResolvedPreset): string;
-/** The command that applies the preset to an existing project. */
-declare function presetApplyCommand(resolved: ResolvedPreset): string;
-//#endregion
-export { PresetGlueItem as $, readDesignFile as A, ResolvedPresetBlock as B, designFileSource as C, encodeDesign as D, designOf as E, presetConfig as F, decodePreset as G, presetBlockConflict as H, presetOf as I, withPresetField as J, encodePreset as K, PresetConflict as L, PresetInput as M, conventionConfig as N, isDesignCode as O, expandPreset as P, PresetCatalogManifest as Q, PresetIntegration as R, designConfigSource as S, designInstallCommand as T, resolvePreset as U, listNames as V, DecodedPreset as W, PresetCatalog as X, PRESET_CATALOG as Y, PresetCatalogBlock as Z, DesignTooLongError as _, presetConfigSource as a, designApplyCommand as b, DesignChange as c, diffAppTables as d, PRESET_BLOCKS as et, diffDesigns as f, DesignFile as g, DESIGN_FORMAT as h, presetBlocksSource as i, ConfigConventions as j, parseDesign as k, DesignChangeKind as l, DESIGN_FILE as m, glueCommand as n, presetGlue as o, CreateDesign as p, isPresetCode as q, presetApplyCommand as r, presetInstallCommand as s, PROVIDER_COMMENT as t, DiffOptions as u, MAX_DESIGN_CODE_LENGTH as v, designFormat as w, designConfig as x, decodeDesign as y, ResolvedPreset as z };

package/dist/index-BpFYMsi0.d.ts

@@ -1,53 +0,0 @@
-import { ChatOnFinishCallback, ChatTransport, UIMessage } from "ai";
-import { UseChatHelpers } from "@ai-sdk/react";
-//#region src/ai-sdk/react/body.d.ts
-/** What a transport factory gets from `useAssistant`. */
-interface AssistantTransportConfig {
-  readonly api: string;
-  readonly model: string | undefined;
-  readonly body: Readonly<Record<string, unknown>> | undefined;
-  readonly headers: Readonly<Record<string, string>> | undefined;
-}
-//#endregion
-//#region src/ai-sdk/react/index.d.ts
-interface UseAssistantOptions {
-  /** The chat id; make one on the client for a new chat. */
-  readonly id: string;
-  /** The route of `createAssistant`. Defaults to `/api/chat`. */
-  readonly api?: string;
-  /** The model the next answer uses; the server checks it against the catalog. */
-  readonly model?: string;
-  /** The stored history, such as `toUIMessages(path)` from the server. */
-  readonly messages?: UIMessage[];
-  /** Picks up an answer that is still being written. Defaults to true. */
-  readonly resume?: boolean;
-  /** Extra fields for the request body. */
-  readonly body?: Readonly<Record<string, unknown>>;
-  readonly headers?: Readonly<Record<string, string>>;
-  readonly onError?: (error: Error) => void;
-  readonly onFinish?: ChatOnFinishCallback<UIMessage>;
-  /** Custom throttle wait in ms for message updates. */
-  readonly throttle?: number;
-  /**
-   * Makes the transport instead of the default one, such as
-   * `durableTransport` from `better-supabase/ai-sdk/workflow/react`. Pass a
-   * function defined outside the component, so the transport is kept.
-   */
-  readonly transport?: (config: AssistantTransportConfig) => ChatTransport<UIMessage>;
-  /** Sends again without user input, such as once every approval is answered. */
-  readonly sendAutomaticallyWhen?: (options: {
-    messages: UIMessage[];
-  }) => boolean | PromiseLike<boolean>;
-}
-type AssistantState = UseChatHelpers<UIMessage> & {
-  /** Stops the answer on the server too, so it is stored as stopped. */
-  stop: () => Promise<void>;
-};
-/**
- * `useChat` wired to `createAssistant`: it sends only the new message (the
- * server keeps the history), resumes a running answer after a reload and
- * stops it on the server.
- */
-declare function useAssistant(options: UseAssistantOptions): AssistantState;
-//#endregion
-export { AssistantTransportConfig as i, UseAssistantOptions as n, useAssistant as r, AssistantState as t };