better-supabase 0.11.0 → 0.13.0

package/dist/index-D8yhOz_4.d.ts

@@ -1,344 +0,0 @@
-import { d as AccessBlockConfig, p as AnyBlocksConfig } from "./authorization-ClWBcXJi.js";
-import { i as BlockCategory } from "./define-block-CPyJ95rq.js";
-import { i as PortName } from "./ports-DGe1vzF2.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;
-/**
- * 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;
-/**
- * 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;
-/** 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 { presetConfig as A, decodePreset as B, designOf as C, PresetInput as D, ConfigConventions as E, ResolvedPresetBlock as F, PresetCatalog as G, isPresetCode as H, listNames as I, PresetGlueItem as J, PresetCatalogBlock as K, presetBlockConflict as L, PresetConflict as M, PresetIntegration as N, conventionConfig as O, ResolvedPreset as P, resolvePreset as R, designInstallCommand as S, isDesignCode as T, withPresetField as U, encodePreset as V, PRESET_CATALOG as W, PRESET_BLOCKS as Y, decodeDesign as _, presetConfigSource as a, designConfigSource as b, DesignChange as c, diffAppTables as d, diffDesigns as f, MAX_DESIGN_CODE_LENGTH as g, DesignTooLongError as h, presetBlocksSource as i, presetOf as j, expandPreset as k, DesignChangeKind as l, DESIGN_FORMAT as m, glueCommand as n, presetGlue as o, CreateDesign as p, PresetCatalogManifest as q, presetApplyCommand as r, presetInstallCommand as s, PROVIDER_COMMENT as t, DiffOptions as u, designApplyCommand as v, encodeDesign as w, designFormat as x, designConfig as y, DecodedPreset as z };

package/dist/index-DHReeV74.d.ts

@@ -1,245 +0,0 @@
-import { b as DbError, f as Result, t as AsyncResult } from "./result-BREt7qOh.js";
-import { N as StorageClient, Q as StoragePath, a as BucketConnectOptions, h as StorageAdminClient, i as BucketConfig, n as Bucket, r as BucketClient, s as BucketPolicy } from "./bucket-BBSNDFNH.js";
-import { SupabaseClient } from "@supabase/supabase-js";
-//#region src/storage/errors.d.ts
-/** Maps a Storage error (`StorageApiError`, fetch failures) to a `DbError`. */
-declare function fromStorageError(raw: unknown, table?: string): DbError;
-//#endregion
-//#region src/storage/image-url.d.ts
-interface StorageImageOptions {
-  /** Project URL, e.g. `import.meta.env.PUBLIC_SUPABASE_URL`. */
-  readonly url: string;
-  /** Resize mode for the transform. Defaults to Storage's own (`cover`). */
-  readonly resize?: "cover" | "contain" | "fill";
-}
-/** The size and quality to render an image at. */
-interface StorageImageSize {
-  readonly width: number;
-  readonly height?: number | undefined;
-  readonly quality?: number | undefined;
-}
-/**
- * Turns public Storage object URLs into Supabase image transformation URLs
- * (`/render/image/public`) at a given size. Any other URL (local files,
- * other hosts, signed URLs) comes back as `undefined`: a signed URL's token
- * covers the transform it was signed with, so sign it with `renderUrl()`.
- *
- * ```ts
- * const imageUrl = storageImageUrl({ url: SUPABASE_URL })
- * imageUrl(avatar, { width: 96 }) ?? avatar
- * ```
- */
-declare function storageImageUrl(options: StorageImageOptions): (src: string, size: StorageImageSize) => string | undefined;
-//#endregion
-//#region src/storage/registry.d.ts
-/** Any bucket definition from `defineBucket` or a preset. */
-type AnyBucket = Bucket<string>;
-type BucketMap = Readonly<Record<string, AnyBucket>>;
-/** The bucket ids of a registry's buckets. */
-type BucketIdOf<B extends BucketMap> = B[keyof B]["id"];
-/** The bucket of a registry whose id is `I`. */
-type BucketWithId<B extends BucketMap, I extends string> = Extract<B[keyof B], {
-  readonly id: I;
-}>;
-/** A stored object as rows keep it: the bucket id and the object path. */
-interface StoredRef {
-  /** The bucket id, e.g. a `bucket_id` column. */
-  readonly bucket: string;
-  readonly path: string;
-}
-/** A stored reference whose bucket is registered and whose path matches one of its templates. */
-interface ResolvedRef<B extends BucketMap> {
-  readonly bucket: B[keyof B];
-  readonly path: StoragePath<BucketIdOf<B>>;
-}
-/** A resolved reference with a client of its bucket. */
-interface ConnectedRef<B extends BucketMap> extends ResolvedRef<B> {
-  readonly storage: BucketClient<string, BucketIdOf<B>>;
-}
-interface Buckets<B extends BucketMap> {
-  /** The bucket definitions, by the names given. */
-  readonly buckets: B;
-  /** Every registered bucket id, in the order given. */
-  readonly ids: readonly BucketIdOf<B>[];
-  /** Whether `id` names a registered bucket. */
-  has(id: string): id is BucketIdOf<B>;
-  /** The bucket with this id, or `invalid_input` for an id no bucket has. */
-  byId<I extends BucketIdOf<B>>(id: I): Result<BucketWithId<B, I>>;
-  byId(id: string): Result<B[keyof B]>;
-  /**
-   * Checks a stored `{ bucket, path }`: the bucket must be registered and the
-   * path must match one of its templates. Either failure is `invalid_input`.
-   */
-  resolve(ref: StoredRef): Result<ResolvedRef<B>>;
-  /**
-   * `resolve`, then `connect` the bucket and check the path with the
-   * connected client, so a bucket with `tenant` also refuses another
-   * tenant's path (`forbidden`). No request is made.
-   */
-  connectStored(client: StorageClient, ref: StoredRef, options?: BucketConnectOptions): Result<ConnectedRef<B>>;
-}
-/**
- * A registry of bucket definitions by id, for rows that store a bucket id
- * next to an object path (files, attachments, sources). An id no bucket
- * has, and a path outside the bucket's templates, are errors, never a
- * fallback bucket.
- *
- * ```ts
- * export const buckets = defineBuckets({ files, attachments, logos });
- *
- * const ref = buckets.connectStored(supabase, {
- *   bucket: row.bucketId,
- *   path: row.path,
- * }, { context: db.$context });
- * if (ref.ok) await ref.data.storage.signedUrl(ref.data.path);
- * ```
- */
-declare function defineBuckets<const B extends BucketMap>(buckets: B): Buckets<B>;
-//#endregion
-//#region src/storage/presets.d.ts
-/** The image types browsers display everywhere. */
-declare const IMAGE_TYPES: readonly string[];
-interface ImageBucketOptions<P extends string, Id extends string> {
-  readonly id?: Id;
-  /** The path template; keep the preset's placeholders the policy relies on. */
-  readonly path?: P | readonly [P, ...P[]];
-  /** Defaults to `true`: images load from their public URL without signing. */
-  readonly public?: boolean;
-  readonly fileSizeLimit?: string | number;
-  readonly allowedMimeTypes?: readonly string[];
-  /** Replaces the preset's policy. */
-  readonly policy?: BucketPolicy;
-}
-type AvatarBucketOptions<P extends string, Id extends string> = ImageBucketOptions<P, Id>;
-interface OrganizationLogoBucketOptions<P extends string, Id extends string> extends ImageBucketOptions<P, Id> {
-  /**
-   * The permission that may upload, replace and delete a logo, checked
-   * through the access contract. Defaults to `organization.update`, the
-   * `organizations` module's update permission.
-   */
-  readonly permission?: string;
-  /**
-   * The tenant segment connected clients are held to. `false` lets one
-   * client upload for any organization the policy allows. Defaults to
-   * `{ param: 'organizationId' }`.
-   */
-  readonly tenant?: BucketConfig["tenant"] | false;
-}
-declare const AVATAR_PATH = "{userId}/avatar-{version}.{ext}";
-declare const LOGO_PATH = "{organizationId}/logo-{version}.{ext}";
-/**
- * A bucket for profile pictures: `{userId}/avatar-{version}.{ext}`, public,
- * 2 MiB of images, written only by their owner (the `owner` policy).
- */
-declare function avatarBucket<const P extends string = typeof AVATAR_PATH, const Id extends string = "avatars">(options?: AvatarBucketOptions<P, Id>): Bucket<P, Id>;
-/**
- * A bucket for organization logos: `{organizationId}/logo-{version}.{ext}`, public,
- * 2 MiB of images, written by members with the update permission through
- * the access contract (`tenant_ids_with`), so it follows the app's roles.
- */
-declare function organizationLogoBucket<const P extends string = typeof LOGO_PATH, const Id extends string = "organization-logos">(options?: OrganizationLogoBucketOptions<P, Id>): Bucket<P, Id>;
-//#endregion
-//#region src/storage/analytics-bucket.d.ts
-/** The Iceberg REST catalog of an analytics bucket, from `storage.analytics.from(id)`. */
-type AnalyticsCatalog = ReturnType<SupabaseClient["storage"]["analytics"]["from"]>;
-interface AnalyticsBucketClient {
-  /** Creates the bucket when it is missing. Needs the secret key. */
-  apply(): AsyncResult<{
-    readonly created: boolean;
-  }>;
-  /** The bucket's Iceberg catalog: namespaces and tables, each call returning `{ data, error }`. */
-  catalog(): AnalyticsCatalog;
-}
-interface AnalyticsBucket<Id extends string> {
-  readonly id: Id;
-  connect(client: StorageAdminClient): AnalyticsBucketClient;
-}
-/**
- * A Storage analytics bucket: Apache Iceberg tables that query engines read
- * through the Iceberg REST catalog.
- *
- * ```ts
- * export const events = defineAnalyticsBucket({ id: "events" });
- * await events.connect(admin).apply().orThrow();
- * ```
- */
-declare function defineAnalyticsBucket<const Id extends string>(config: {
-  readonly id: Id;
-}): AnalyticsBucket<Id>;
-//#endregion
-//#region src/storage/vector-bucket.d.ts
-type VectorDistance = "cosine" | "euclidean" | "dotproduct";
-interface VectorIndexConfig {
-  /** Number of values in every vector, e.g. 1536 for `text-embedding-3-small`. */
-  readonly dimension: number;
-  /** Defaults to `cosine`. */
-  readonly distanceMetric?: VectorDistance;
-  /** Metadata keys stored with each vector but not usable in `filter`. */
-  readonly nonFilterableMetadataKeys?: readonly string[];
-}
-interface VectorBucketConfig<Id extends string, I extends Readonly<Record<string, VectorIndexConfig>>> {
-  readonly id: Id;
-  readonly indexes: I;
-}
-type VectorMetadata = Readonly<Record<string, unknown>>;
-interface VectorRecord<M extends VectorMetadata = VectorMetadata> {
-  readonly key: string;
-  readonly vector: readonly number[];
-  readonly metadata?: M;
-}
-interface VectorHit<M extends VectorMetadata = VectorMetadata> {
-  readonly key: string;
-  /** Set by `query()`: smaller is closer for every metric. */
-  readonly distance?: number;
-  readonly metadata?: M;
-  readonly vector?: readonly number[];
-}
-interface VectorQueryOptions {
-  /** Number of matches, defaults to 10. */
-  readonly topK?: number;
-  /** A metadata filter, e.g. `{ organizationId: "o1" }` or `{ year: { $gte: 2024 } }`. */
-  readonly filter?: VectorMetadata;
-  /** Return each match's metadata. Defaults to `true`. */
-  readonly metadata?: boolean;
-}
-interface VectorIndexClient<M extends VectorMetadata = VectorMetadata> {
-  readonly name: string;
-  readonly dimension: number;
-  /** Inserts or replaces vectors by key, in batches of 500. */
-  put(records: readonly VectorRecord<M>[]): AsyncResult<number>;
-  /** The nearest vectors, closest first. */
-  query(vector: readonly number[], options?: VectorQueryOptions): AsyncResult<readonly VectorHit<M>[]>;
-  /** Vectors by key; missing keys are left out. */
-  get(keys: readonly string[], options?: {
-    readonly vector?: boolean;
-  }): AsyncResult<readonly VectorHit<M>[]>;
-  remove(keys: readonly string[]): AsyncResult<readonly string[]>;
-}
-interface VectorBucketClient<I extends string> {
-  /** Creates the bucket and any missing index. An index with another dimension or metric is a `conflict`. */
-  apply(): AsyncResult<{
-    readonly created: readonly string[];
-  }>;
-  index<M extends VectorMetadata = VectorMetadata>(name: I): VectorIndexClient<M>;
-}
-interface VectorBucket<Id extends string, I extends Readonly<Record<string, VectorIndexConfig>>> {
-  readonly id: Id;
-  readonly indexes: I;
-  connect(client: StorageAdminClient): VectorBucketClient<keyof I & string>;
-}
-/**
- * A Storage vector bucket with typed indexes. Storage keeps the vectors
- * outside Postgres; use the `vector-search` module for pgvector in a table.
- *
- * ```ts
- * export const embeddings = defineVectorBucket({
- *   id: "embeddings",
- *   indexes: { documents: { dimension: 1536 } },
- * });
- * const docs = embeddings.connect(admin).index("documents");
- * await docs.put([{ key: doc.id, vector, metadata: { organizationId } }]);
- * ```
- */
-declare function defineVectorBucket<const Id extends string, const I extends Readonly<Record<string, VectorIndexConfig>>>(config: VectorBucketConfig<Id, I>): VectorBucket<Id, I>;
-//#endregion
-export { defineBuckets as A, BucketIdOf as C, ConnectedRef as D, Buckets as E, StorageImageSize as M, storageImageUrl as N, ResolvedRef as O, fromStorageError as P, AnyBucket as S, BucketWithId as T, IMAGE_TYPES as _, VectorHit as a, avatarBucket as b, VectorMetadata as c, defineVectorBucket as d, AnalyticsBucket as f, AvatarBucketOptions as g, defineAnalyticsBucket as h, VectorDistance as i, StorageImageOptions as j, StoredRef as k, VectorQueryOptions as l, AnalyticsCatalog as m, VectorBucketClient as n, VectorIndexClient as o, AnalyticsBucketClient as p, VectorBucketConfig as r, VectorIndexConfig as s, VectorBucket as t, VectorRecord as u, ImageBucketOptions as v, BucketMap as w, organizationLogoBucket as x, OrganizationLogoBucketOptions as y };

package/dist/index-DgobXyil.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-CCGSn7m5.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 };