@supabase/lite 0.9.0 → 0.9.1-next.2

package/dist/{Connection-ZWTDByQ5.d.ts → Connection-f_d5HhQ0.d.ts}

@@ -9,264 +9,6 @@ interface CacheDriver {
     delete(key: string): Promise<void>;
 }
 
-/**
- * Nested object for runtime variable substitution.
- * Paths are resolved via lodash-style dot-path access (e.g. "auth.jwt.role" → vars.auth.jwt.role).
- * e.g. { auth: { uid: "uuid-here", role: "authenticated", jwt: { role: "admin" } } }
- */
-type VarsContext = Record<string, unknown>;
-
-type ASTType = "query" | "insert" | "update" | "delete" | "upsert" | "put" | "rpc";
-type QbSelect = SelectQueryBuilder<any, any, any>;
-type QbInsert = InsertQueryBuilder<any, any, any>;
-type QbUpdate = UpdateQueryBuilder<any, any, any, any>;
-type QbDelete = DeleteQueryBuilder<any, any, any>;
-type Qb = QbSelect | QbInsert | QbUpdate | QbDelete;
-type ColumnDef = {
-    column?: string;
-    cast?: string;
-    preCast?: string;
-    aggregate?: AggregateFunction;
-    bareCount?: boolean;
-    path?: string;
-    /** True when the trailing JSON-path operator was `->>` (text extract). */
-    pathText?: boolean;
-    /** First key reached after an earlier `->>` text extraction. */
-    invalidJsonTextTraversalKey?: string;
-};
-type EmbedDef = {
-    select?: SelectEntry[];
-    where?: Where;
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    spread?: boolean;
-    join?: JoinMap;
-};
-type SelectEntry = string | Record<string, ColumnDef | EmbedDef>;
-type JoinDef = {
-    from?: string;
-    type?: "inner" | "left";
-    hint?: string;
-    on?: Where;
-};
-type JoinMap = Record<string, JoinDef>;
-type ColumnRef = {
-    $ref: string;
-};
-declare function isRef(val: unknown): val is ColumnRef;
-type WhereValue = {
-    [op: string]: unknown;
-};
-type Where = Record<string, unknown>;
-type OrderEntry = {
-    column: string;
-    direction?: "asc" | "desc";
-    nullsFirst?: boolean;
-    /** For ordering by embedded resource column: embed alias */
-    embed?: string;
-};
-type TextSearchValue = {
-    query: string;
-    type?: "plain" | "phrase" | "websearch";
-    config?: string;
-};
-type ExplainOptions = {
-    analyze?: boolean;
-    verbose?: boolean;
-    settings?: boolean;
-    buffers?: boolean;
-    wal?: boolean;
-};
-type Meta = {
-    cardinality?: "one" | "maybe" | "many";
-    count?: "exact" | "planned" | "estimated";
-    head?: boolean;
-    maxAffected?: number;
-    rollback?: boolean;
-    missing?: "null" | "default";
-    handling?: "strict" | "lenient";
-    timezone?: string;
-    columns?: string[];
-    stripNulls?: boolean;
-    explain?: ExplainOptions;
-    headers?: Record<string, string>;
-    return?: "minimal" | "headers-only" | "representation";
-    tx?: "commit" | "rollback";
-};
-interface BaseAST {
-    from: string;
-    schema?: string;
-    select?: SelectEntry[];
-    $meta?: Meta;
-}
-interface QueryAST extends BaseAST {
-    type: "query";
-    join?: JoinMap;
-    where?: Where;
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    group?: string[];
-}
-interface InsertAST extends BaseAST {
-    type: "insert";
-    values: object | object[];
-}
-interface UpdateAST extends BaseAST {
-    type: "update";
-    values: object;
-    where?: Where;
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-}
-interface DeleteAST extends BaseAST {
-    type: "delete";
-    where?: Where;
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-}
-interface UpsertAST extends BaseAST {
-    type: "upsert" | "put";
-    values: object;
-    onConflict?: string[];
-    ignoreDuplicates?: boolean;
-}
-interface RpcAST extends BaseAST {
-    type: "rpc";
-    function: string;
-    args?: object | unknown[];
-    /** Embed joins, when `select=` embeds related tables on a `SETOF <table>` result. */
-    join?: JoinMap;
-    where?: Where;
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    httpMethod?: "GET" | "POST";
-    paramsType?: "named" | "positional";
-    inputType?: "json" | "text" | "binary" | "xml";
-}
-type AST = QueryAST | InsertAST | UpdateAST | DeleteAST | UpsertAST | RpcAST;
-type AnyAST = {
-    type?: string;
-    from?: string;
-    function?: string;
-    schema?: string;
-    join?: JoinMap;
-    select?: SelectEntry[];
-    where?: Where;
-    values?: object | object[];
-    args?: object | unknown[];
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    group?: string[];
-    onConflict?: string[];
-    ignoreDuplicates?: boolean;
-    httpMethod?: "GET" | "POST";
-    paramsType?: "named" | "positional";
-    inputType?: "json" | "text" | "binary" | "xml";
-    $meta?: Meta;
-};
-type AggregateFunction = "count" | "sum" | "avg" | "min" | "max";
-type RouteResult = {
-    from?: string;
-    function?: string;
-    isRpc: boolean;
-};
-type PreferToken = {
-    key: "count";
-    value: "exact" | "planned" | "estimated";
-} | {
-    key: "resolution";
-    value: "merge-duplicates" | "ignore-duplicates";
-} | {
-    key: "return";
-    value: "minimal" | "headers-only" | "representation";
-} | {
-    key: "tx";
-    value: "commit" | "rollback";
-} | {
-    key: "missing";
-    value: "default" | "null";
-} | {
-    key: "handling";
-    value: "strict" | "lenient";
-} | {
-    key: "max-affected";
-    value: number;
-} | {
-    key: "timezone";
-    value: string;
-} | {
-    key: "params";
-    value: "single-object" | "multiple-objects";
-};
-type HeadersResult = {
-    schema?: string;
-    preferTokens: PreferToken[];
-    accept: string;
-};
-type SelectResult = {
-    select: SelectEntry[];
-    join: JoinMap;
-    embeddedAliases: Set<string>;
-};
-type BodyResult = {
-    values?: object | object[];
-    args?: object;
-    raw?: string;
-};
-type QueryParamsResult = Map<string, string[]>;
-type FiltersResult = {
-    where: Where;
-    embeddedWheres: Record<string, Where>;
-};
-type EmbedTransform = {
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    _nested?: Record<string, {
-        order?: OrderEntry[];
-        limit?: number;
-        offset?: number;
-    }>;
-};
-type TransformsResult = {
-    order?: OrderEntry[];
-    limit?: number;
-    offset?: number;
-    embeddedTransforms: Record<string, EmbedTransform>;
-};
-type RpcResult = {
-    args?: object | unknown[];
-    httpMethod?: "GET" | "POST";
-    paramsType?: "named" | "positional";
-    inputType?: "json" | "text" | "binary" | "xml";
-};
-type UpsertResult = {
-    onConflict?: string[];
-    ignoreDuplicates: boolean;
-};
-type TranslatorConfig = {
-    parseRoute?: (req: Request) => RouteResult;
-    parseHeaders?: (req: Request) => HeadersResult;
-    parseSelect?: (req: Request) => SelectResult;
-    parseBody?: (req: Request) => Promise<BodyResult>;
-    parseQueryParams?: (req: Request) => QueryParamsResult;
-    resolveType?: (route: RouteResult, method: string, headers: HeadersResult) => ASTType;
-    resolveFilters?: (queryParams: QueryParamsResult, embeddedAliases: Set<string>, fromTable?: string, parentColumns?: ReadonlySet<string>) => FiltersResult;
-    /** Physical columns on the request table (for embed/column homonym filters). */
-    parentColumns?: ReadonlySet<string>;
-    resolveTransforms?: (queryParams: QueryParamsResult, embeddedAliases: Set<string>) => TransformsResult;
-    resolveMeta?: (headers: HeadersResult, queryParams: QueryParamsResult, method: string) => Meta;
-    resolveRpcParams?: (route: RouteResult, method: string, queryParams: QueryParamsResult, body: BodyResult) => RpcResult;
-    resolveUpsertParams?: (queryParams: QueryParamsResult, headers: HeadersResult) => UpsertResult;
-    basePath?: string;
-};
-
 interface TableInfo {
     name: string;
     sql: string;
@@ -308,6 +50,7 @@ interface IndexInfo {
     unique: boolean;
     columns: string[];
     schema: string;
+    sql?: string;
 }
 interface ForeignKeyInfo {
     table: string;
@@ -545,46 +288,304 @@ interface DataLossWarning {
     table: string;
     reason: string;
 }
-interface PlanResult {
-    steps: PlanStep[];
-    warnings?: DataLossWarning[];
-    unsafe: boolean;
+interface PlanResult {
+    steps: PlanStep[];
+    warnings?: DataLossWarning[];
+    unsafe: boolean;
+}
+declare class DataLossError extends Error {
+    warnings: DataLossWarning[];
+    constructor(warnings: DataLossWarning[]);
+}
+declare class MigrationError extends Error {
+    stepIndex: number;
+    sql: string;
+    cause: Error;
+    constructor(stepIndex: number, sql: string, cause: Error);
+}
+interface SchemaDiffResult {
+    current?: IntrospectResult;
+    desired?: IntrospectResult;
+    diff: DiffResult | string;
+    plan: PlanResult;
+}
+/**
+ * Restricts a diff/migrate to a set of schemas (LITE-291). When set, both the
+ * current and desired catalogs are filtered to these schemas, so out-of-scope
+ * (e.g. user-land `public`) objects are invisible to the diff and are never
+ * dropped. Used by `App.ensureSystemSchema()` to reconcile only system schemas.
+ */
+interface MigrateScope {
+    schemas?: string[];
+}
+interface ConnectionMigrator {
+    diff(scope?: MigrateScope): Promise<SchemaDiffResult>;
+    migrate(opts?: {
+        force?: boolean;
+    } & MigrateScope): Promise<SchemaDiffResult>;
+    migratePlan(planResult: PlanResult, opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    safeSortPlanSteps(steps: PlanStep[]): PlanStep[];
+}
+
+/**
+ * Nested object for runtime variable substitution.
+ * Paths are resolved via lodash-style dot-path access (e.g. "auth.jwt.role" → vars.auth.jwt.role).
+ * e.g. { auth: { uid: "uuid-here", role: "authenticated", jwt: { role: "admin" } } }
+ */
+type VarsContext = Record<string, unknown>;
+
+type ASTType = "query" | "insert" | "update" | "delete" | "upsert" | "put" | "rpc";
+type QbSelect = SelectQueryBuilder<any, any, any>;
+type QbInsert = InsertQueryBuilder<any, any, any>;
+type QbUpdate = UpdateQueryBuilder<any, any, any, any>;
+type QbDelete = DeleteQueryBuilder<any, any, any>;
+type Qb = QbSelect | QbInsert | QbUpdate | QbDelete;
+type ColumnDef = {
+    column?: string;
+    cast?: string;
+    preCast?: string;
+    aggregate?: AggregateFunction;
+    bareCount?: boolean;
+    path?: string;
+    /** True when the trailing JSON-path operator was `->>` (text extract). */
+    pathText?: boolean;
+    /** First key reached after an earlier `->>` text extraction. */
+    invalidJsonTextTraversalKey?: string;
+};
+type EmbedDef = {
+    select?: SelectEntry[];
+    where?: Where;
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    spread?: boolean;
+    join?: JoinMap;
+};
+type SelectEntry = string | Record<string, ColumnDef | EmbedDef>;
+type JoinDef = {
+    from?: string;
+    type?: "inner" | "left";
+    hint?: string;
+    on?: Where;
+};
+type JoinMap = Record<string, JoinDef>;
+type ColumnRef = {
+    $ref: string;
+};
+declare function isRef(val: unknown): val is ColumnRef;
+type WhereValue = {
+    [op: string]: unknown;
+};
+type Where = Record<string, unknown>;
+type OrderEntry = {
+    column: string;
+    direction?: "asc" | "desc";
+    nullsFirst?: boolean;
+    /** For ordering by embedded resource column: embed alias */
+    embed?: string;
+};
+type TextSearchValue = {
+    query: string;
+    type?: "plain" | "phrase" | "websearch";
+    config?: string;
+};
+type ExplainOptions = {
+    analyze?: boolean;
+    verbose?: boolean;
+    settings?: boolean;
+    buffers?: boolean;
+    wal?: boolean;
+};
+type Meta = {
+    cardinality?: "one" | "maybe" | "many";
+    count?: "exact" | "planned" | "estimated";
+    head?: boolean;
+    maxAffected?: number;
+    rollback?: boolean;
+    missing?: "null" | "default";
+    handling?: "strict" | "lenient";
+    timezone?: string;
+    columns?: string[];
+    stripNulls?: boolean;
+    explain?: ExplainOptions;
+    headers?: Record<string, string>;
+    return?: "minimal" | "headers-only" | "representation";
+    tx?: "commit" | "rollback";
+};
+interface BaseAST {
+    from: string;
+    schema?: string;
+    select?: SelectEntry[];
+    $meta?: Meta;
+}
+interface QueryAST extends BaseAST {
+    type: "query";
+    join?: JoinMap;
+    where?: Where;
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    group?: string[];
 }
-declare class DataLossError extends Error {
-    warnings: DataLossWarning[];
-    constructor(warnings: DataLossWarning[]);
+interface InsertAST extends BaseAST {
+    type: "insert";
+    values: object | object[];
 }
-declare class MigrationError extends Error {
-    stepIndex: number;
-    sql: string;
-    cause: Error;
-    constructor(stepIndex: number, sql: string, cause: Error);
+interface UpdateAST extends BaseAST {
+    type: "update";
+    values: object;
+    where?: Where;
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
 }
-interface SchemaDiffResult {
-    current?: IntrospectResult;
-    desired?: IntrospectResult;
-    diff: DiffResult | string;
-    plan: PlanResult;
+interface DeleteAST extends BaseAST {
+    type: "delete";
+    where?: Where;
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
 }
-/**
- * Restricts a diff/migrate to a set of schemas (LITE-291). When set, both the
- * current and desired catalogs are filtered to these schemas, so out-of-scope
- * (e.g. user-land `public`) objects are invisible to the diff and are never
- * dropped. Used by `App.ensureSystemSchema()` to reconcile only system schemas.
- */
-interface MigrateScope {
-    schemas?: string[];
+interface UpsertAST extends BaseAST {
+    type: "upsert" | "put";
+    values: object;
+    onConflict?: string[];
+    ignoreDuplicates?: boolean;
 }
-interface ConnectionMigrator {
-    diff(scope?: MigrateScope): Promise<SchemaDiffResult>;
-    migrate(opts?: {
-        force?: boolean;
-    } & MigrateScope): Promise<SchemaDiffResult>;
-    migratePlan(planResult: PlanResult, opts?: {
-        force?: boolean;
-    }): Promise<void>;
-    safeSortPlanSteps(steps: PlanStep[]): PlanStep[];
+interface RpcAST extends BaseAST {
+    type: "rpc";
+    function: string;
+    args?: object | unknown[];
+    /** Embed joins, when `select=` embeds related tables on a `SETOF <table>` result. */
+    join?: JoinMap;
+    where?: Where;
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    httpMethod?: "GET" | "POST";
+    paramsType?: "named" | "positional";
+    inputType?: "json" | "text" | "binary" | "xml";
 }
+type AST = QueryAST | InsertAST | UpdateAST | DeleteAST | UpsertAST | RpcAST;
+type AnyAST = {
+    type?: string;
+    from?: string;
+    function?: string;
+    schema?: string;
+    join?: JoinMap;
+    select?: SelectEntry[];
+    where?: Where;
+    values?: object | object[];
+    args?: object | unknown[];
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    group?: string[];
+    onConflict?: string[];
+    ignoreDuplicates?: boolean;
+    httpMethod?: "GET" | "POST";
+    paramsType?: "named" | "positional";
+    inputType?: "json" | "text" | "binary" | "xml";
+    $meta?: Meta;
+};
+type AggregateFunction = "count" | "sum" | "avg" | "min" | "max";
+type RouteResult = {
+    from?: string;
+    function?: string;
+    isRpc: boolean;
+};
+type PreferToken = {
+    key: "count";
+    value: "exact" | "planned" | "estimated";
+} | {
+    key: "resolution";
+    value: "merge-duplicates" | "ignore-duplicates";
+} | {
+    key: "return";
+    value: "minimal" | "headers-only" | "representation";
+} | {
+    key: "tx";
+    value: "commit" | "rollback";
+} | {
+    key: "missing";
+    value: "default" | "null";
+} | {
+    key: "handling";
+    value: "strict" | "lenient";
+} | {
+    key: "max-affected";
+    value: number;
+} | {
+    key: "timezone";
+    value: string;
+} | {
+    key: "params";
+    value: "single-object" | "multiple-objects";
+};
+type HeadersResult = {
+    schema?: string;
+    preferTokens: PreferToken[];
+    accept: string;
+};
+type SelectResult = {
+    select: SelectEntry[];
+    join: JoinMap;
+    embeddedAliases: Set<string>;
+};
+type BodyResult = {
+    values?: object | object[];
+    args?: object;
+    raw?: string;
+};
+type QueryParamsResult = Map<string, string[]>;
+type FiltersResult = {
+    where: Where;
+    embeddedWheres: Record<string, Where>;
+};
+type EmbedTransform = {
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    _nested?: Record<string, {
+        order?: OrderEntry[];
+        limit?: number;
+        offset?: number;
+    }>;
+};
+type TransformsResult = {
+    order?: OrderEntry[];
+    limit?: number;
+    offset?: number;
+    embeddedTransforms: Record<string, EmbedTransform>;
+};
+type RpcResult = {
+    args?: object | unknown[];
+    httpMethod?: "GET" | "POST";
+    paramsType?: "named" | "positional";
+    inputType?: "json" | "text" | "binary" | "xml";
+};
+type UpsertResult = {
+    onConflict?: string[];
+    ignoreDuplicates: boolean;
+};
+type TranslatorConfig = {
+    parseRoute?: (req: Request) => RouteResult;
+    parseHeaders?: (req: Request) => HeadersResult;
+    parseSelect?: (req: Request) => SelectResult;
+    parseBody?: (req: Request) => Promise<BodyResult>;
+    parseQueryParams?: (req: Request) => QueryParamsResult;
+    resolveType?: (route: RouteResult, method: string, headers: HeadersResult) => ASTType;
+    resolveFilters?: (queryParams: QueryParamsResult, embeddedAliases: Set<string>, fromTable?: string, parentColumns?: ReadonlySet<string>) => FiltersResult;
+    /** Physical columns on the request table (for embed/column homonym filters). */
+    parentColumns?: ReadonlySet<string>;
+    resolveTransforms?: (queryParams: QueryParamsResult, embeddedAliases: Set<string>) => TransformsResult;
+    resolveMeta?: (headers: HeadersResult, queryParams: QueryParamsResult, method: string) => Meta;
+    resolveRpcParams?: (route: RouteResult, method: string, queryParams: QueryParamsResult, body: BodyResult) => RpcResult;
+    resolveUpsertParams?: (queryParams: QueryParamsResult, headers: HeadersResult) => UpsertResult;
+    basePath?: string;
+};
 
 interface IConnectionConfig extends Partial<KyselyConfig> {
     url?: string;
@@ -596,6 +597,11 @@ interface IConnectionConfig extends Partial<KyselyConfig> {
      * This is useful for when auth is enabled, and auth schema must be present.
      */
     baseSchema?: string;
+    /** System-owned tables whose own schema enables RLS. */
+    systemRls?: Array<{
+        schema: string;
+        tables: string[];
+    }>;
 }
 type Dialect = "sqlite" | "postgres";
 type TransactionOptions = {
@@ -603,6 +609,8 @@ type TransactionOptions = {
 };
 type ConnectionContextOptions = {
     forceRollback?: boolean;
+    /** Reuse an existing transaction so trusted preflights and scoped writes stay atomic. */
+    transaction?: Kysely<any>;
     /**
      * Present for RPC (`/rpc/*`) requests on the postgres backend only. Forces the
      * call into one explicit transaction so request.* GUC injection, GET read-only
@@ -686,7 +694,7 @@ declare abstract class Connection<Driver = unknown, DB = any, Config extends ICo
      * For Postgres: wraps in a transaction with SET LOCAL role/claims.
      * Default: pass-through.
      */
-    withContext<T>(_vars: VarsContext | undefined, fn: (db: Kysely<any>) => Promise<T>, _opts?: ConnectionContextOptions): Promise<T>;
+    withContext<T>(_vars: VarsContext | undefined, fn: (db: Kysely<any>) => Promise<T>, opts?: ConnectionContextOptions): Promise<T>;
     /**
      * Whether this connection serves RPC (stored functions). SQLite-backed
      * connections have none; the data route uses this to gate `/rpc/*`.