@supabase/lite 0.0.1 → 0.2.0

package/package.json

@@ -1,11 +1,11 @@
 {
    "name": "@supabase/lite",
-   "version": "0.0.1",
+   "version": "0.2.0",
    "description": "Lightweight TypeScript-native Supabase implementation on SQLite (alpha). PostgREST + GoTrue compatible — use @supabase/supabase-js as-is.",
    "type": "module",
    "repository": {
       "type": "git",
-      "url": "https://github.com/supabase/lite.git",
+      "url": "https://github.com/supabase-community/lite.git",
       "directory": "app"
    },
    "bin": {
@@ -111,7 +111,7 @@
       "dev": "vite",
       "typecheck": "tsc --project tsconfig.check.json",
       "build": "bun run build.ts",
-      "build:all": "bun run build:static && bun run build.ts --types",
+      "build:all": "bun run build:static && bun run build.ts --types --minify",
       "build:static": "vite build",
       "watch:static": "vite build --watch",
       "dev:bun": "bun run --hot dev/bun/bun.dev.ts",
@@ -120,6 +120,8 @@
       "cli": "LOCAL=1 bun src/cli/index.ts",
       "docs:generate": "bun run internal/extract.ts",
       "smoke:pack": "bun run internal/smoke-pack.ts",
+      "prepack": "bun run internal/package-readme.ts prepare",
+      "postpack": "bun run internal/package-readme.ts cleanup",
       "prepublishOnly": "npm whoami && bun run typecheck && bun run test && bun run build:all && bun run smoke:pack -- --no-build",
       "release:patch": "echo \"Use GitHub Actions > Release with version_specifier=patch.\" && exit 1",
       "release:minor": "echo \"Use GitHub Actions > Release with version_specifier=minor.\" && exit 1",

package/dist/Connection-BJclIu8v.d.ts

@@ -1,529 +0,0 @@
-import { SelectQueryBuilder, InsertQueryBuilder, UpdateQueryBuilder, DeleteQueryBuilder, KyselyConfig, Kysely } from 'kysely';
-
-/**
- * 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;
-    path?: 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[];
-    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>) => FiltersResult;
-    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;
-};
-
-type PolicyCommand = "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "ALL";
-type PolicyRole = "anon" | "authenticated" | string;
-interface PolicyData {
-    name: string;
-    table: string;
-    schema?: string;
-    command: PolicyCommand;
-    permissive: boolean;
-    roles: PolicyRole[];
-    using?: Where;
-    withCheck?: Where;
-}
-declare class Policy {
-    readonly data: PolicyData;
-    constructor(data: PolicyData);
-    appliesTo(cmd: "SELECT" | "INSERT" | "UPDATE" | "DELETE"): boolean;
-    appliesToRole(role: string): boolean;
-    toJSON(): PolicyData;
-    static fromJSON(data: PolicyData): Policy;
-}
-
-interface TableInfo {
-    name: string;
-    sql: string;
-    schema: string;
-    type: "table" | "view";
-    rows: number;
-    engine: string;
-    collation: string;
-}
-interface ColumnInfo {
-    table: string;
-    name: string;
-    type: string;
-    nullable: boolean;
-    default_value: string | null;
-    is_primary_key: boolean;
-    schema: string;
-    ordinal_position: number;
-    collation: string;
-    character_maximum_length: string | null;
-    precision: {
-        precision: number | null;
-        scale: number | null;
-    } | null;
-    is_identity: boolean;
-}
-interface IndexInfo {
-    table: string;
-    name: string;
-    unique: boolean;
-    columns: string[];
-    schema: string;
-}
-interface ForeignKeyInfo {
-    table: string;
-    column: string;
-    ref_table: string;
-    ref_column: string;
-    on_update: string;
-    on_delete: string;
-    schema: string;
-    ref_schema?: string;
-    foreign_key_name: string;
-    fk_def: string;
-}
-interface PrimaryKeyInfo {
-    table: string;
-    columns: string[];
-    schema: string;
-    field_count: number;
-}
-interface ViewInfo {
-    name: string;
-    sql: string;
-    schema: string;
-}
-interface CheckConstraintInfo {
-    schema: string;
-    table: string;
-    expression: string;
-}
-interface TriggerInfo {
-    table: string;
-    name: string;
-    sql: string;
-    schema: string;
-}
-interface CustomTypesInfo {
-    schema: string;
-    type: string;
-    kind: "enum" | "composite";
-    values?: string[];
-    fields?: {
-        name: string;
-        type: string;
-    }[];
-}
-type IntrospectOptions = {
-    exclude_tables?: string[];
-    name?: string;
-    version?: string;
-};
-interface IntrospectResult {
-    tables: TableInfo[];
-    columns: ColumnInfo[];
-    indexes: IndexInfo[];
-    foreign_keys: ForeignKeyInfo[];
-    primary_keys: PrimaryKeyInfo[];
-    views: ViewInfo[];
-    check_constraints: CheckConstraintInfo[];
-    custom_types: CustomTypesInfo[];
-    triggers: TriggerInfo[];
-    database_name: string;
-    version: string;
-    ddl_dialect?: "postgres" | "sqlite";
-    schema_separator?: string;
-}
-interface TableDiff {
-    type: "added" | "removed" | "modified";
-    name: string;
-    sql?: string;
-}
-interface ColumnDiff {
-    type: "added" | "removed" | "modified";
-    table: string;
-    name: string;
-    changes?: {
-        type?: {
-            from: string;
-            to: string;
-        };
-        nullable?: {
-            from: boolean;
-            to: boolean;
-        };
-        default_value?: {
-            from: string | null;
-            to: string | null;
-        };
-    };
-    column?: ColumnInfo;
-}
-interface IndexDiff {
-    type: "added" | "removed";
-    table: string;
-    name: string;
-    unique: boolean;
-    columns: string[];
-}
-interface ForeignKeyDiff {
-    type: "added" | "removed";
-    table: string;
-    column: string;
-    ref_table: string;
-    ref_column: string;
-    on_update: string;
-    on_delete: string;
-}
-interface DiffResult {
-    tables: TableDiff[];
-    columns: ColumnDiff[];
-    indexes: IndexDiff[];
-    foreign_keys: ForeignKeyDiff[];
-    has_changes: boolean;
-}
-declare const enum PlanStepType {
-    DISABLE_FOREIGN_KEYS = "disable_foreign_keys",
-    ENABLE_FOREIGN_KEYS = "enable_foreign_keys",
-    BEGIN_TRANSACTION = "begin_transaction",
-    COMMIT_TRANSACTION = "commit_transaction",
-    CREATE_TABLE = "create_table",
-    ADD_COLUMN = "add_column",
-    DROP_COLUMN = "drop_column",
-    ADD_INDEX = "add_index",
-    DROP_INDEX = "drop_index",
-    DROP_TABLE = "drop_table",
-    RENAME_TABLE = "rename_table",
-    COPY_DATA = "copy_data",
-    CREATE_TRIGGER = "create_trigger"
-}
-interface PlanStep {
-    sql: string;
-    description?: string;
-    type?: PlanStepType;
-}
-interface DataLossWarning {
-    table: string;
-    reason: string;
-}
-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;
-}
-interface ConnectionMigrator {
-    diff(): Promise<SchemaDiffResult>;
-    migrate(opts?: {
-        force?: boolean;
-    }): Promise<SchemaDiffResult>;
-    migratePlan(planResult: PlanResult, opts?: {
-        force?: boolean;
-    }): Promise<void>;
-    safeSortPlanSteps(steps: PlanStep[]): PlanStep[];
-}
-
-interface IConnectionConfig extends Partial<KyselyConfig> {
-    url?: string;
-    introspection?: IntrospectOptions;
-    /**
-     * Base schema of the connection that is always prepended to any schema operations.
-     * E.g. when migrating to a desired schema, `baseSchema` is always prepended.
-     * This is useful for when auth is enabled, and auth schema must be present.
-     */
-    baseSchema?: string;
-}
-type Dialect = "sqlite" | "postgres";
-type TransactionOptions = {
-    intent?: "migration";
-};
-declare class RelationNotFoundError extends Error {
-    readonly schema: string | undefined;
-    readonly relation: string;
-    constructor(schema: string | undefined, relation: string);
-}
-declare abstract class Connection<Driver = unknown, DB = any, Config extends IConnectionConfig = IConnectionConfig> {
-    config: Config;
-    kysely: Kysely<DB>;
-    abstract driver: Driver;
-    abstract dialect: Dialect;
-    protected introspection: IntrospectResult | undefined;
-    protected constructor(config: Config);
-    /**
-     * Connection-level DDL translation, mainly for SQLite connections to override.
-     */
-    translateDdl(ddl: string): Promise<unknown>;
-    clearSchemaCache(): void;
-    exec<T = {
-        rows: unknown[];
-    } | void>(query: string, ...parameters: readonly unknown[]): Promise<T>;
-    ping(): Promise<boolean | void>;
-    abstract introspect(options?: {
-        useCache?: boolean;
-    }): Promise<IntrospectResult>;
-    transaction(_statements: string[], _opts?: TransactionOptions): Promise<void>;
-    abstract close(): Promise<void>;
-    createMigrator(_desiredSchema: string): ConnectionMigrator;
-    onPostgrestAST(ast: AnyAST, _vars?: VarsContext): Promise<AnyAST>;
-    /**
-     * Normalize a database error into a PG-style error object.
-     * Override in subclasses to map dialect-specific error codes.
-     */
-    normalizeDbError(e: unknown): unknown;
-    /**
-     * Wrap PostgREST query execution with connection-specific context.
-     * 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>): Promise<T>;
-}
-
-export { type QueryParamsResult as $, type AnyAST as A, type BaseAST as B, Connection as C, DataLossError as D, type EmbedDef as E, type FiltersResult as F, type JoinMap as G, type HeadersResult as H, type IntrospectResult as I, type JoinDef as J, MigrationError as K, type PlanResult as L, type Meta as M, type PlanStep as N, type OrderEntry as O, Policy as P, PlanStepType as Q, type PreferToken as R, type PrimaryKeyInfo as S, type TransactionOptions as T, type Qb as U, type VarsContext as V, type QbDelete as W, type QbInsert as X, type QbSelect as Y, type QbUpdate as Z, type QueryAST as _, type IConnectionConfig as a, RelationNotFoundError as a0, type RouteResult as a1, type RpcAST as a2, type RpcResult as a3, type SchemaDiffResult as a4, type SelectEntry as a5, type SelectResult as a6, type TableDiff as a7, type TableInfo as a8, type TextSearchValue as a9, type TransformsResult as aa, type TranslatorConfig as ab, type TriggerInfo as ac, type UpdateAST as ad, type UpsertAST as ae, type UpsertResult as af, type ViewInfo as ag, type Where as ah, type WhereValue as ai, isRef as aj, type PolicyCommand as b, type PolicyRole as c, type AST as d, type ASTType as e, type AggregateFunction as f, type BodyResult as g, type CheckConstraintInfo as h, type ColumnDef as i, type ColumnDiff as j, type ColumnInfo as k, type ColumnRef as l, type ConnectionMigrator as m, type CustomTypesInfo as n, type DataLossWarning as o, type DeleteAST as p, type Dialect as q, type DiffResult as r, type EmbedTransform as s, type ExplainOptions as t, type ForeignKeyDiff as u, type ForeignKeyInfo as v, type IndexDiff as w, type IndexInfo as x, type InsertAST as y, type IntrospectOptions as z };