@type32/tauri-sqlite-orm 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -1,18 +1,5 @@
 import Database from '@tauri-apps/plugin-sql';
 
-/**
- * Initializes the database connection. This must be called once at the start of your application.
- * @param dbPath The path to the database file, e.g., 'sqlite:mydatabase.db'
- * @returns The database instance.
- */
-declare function initDb(dbPath: string): Promise<Database>;
-/**
- * Gets the singleton database instance.
- * @throws If `initDb` has not been called.
- * @returns The database instance.
- */
-declare function getDb(): Database;
-
 type UpdateDeleteAction = "cascade" | "restrict" | "no action" | "set null" | "set default";
 interface SQLExpression {
     raw: string;
@@ -26,6 +13,7 @@ interface Column<T = any> {
     isNotNull?: boolean;
     defaultValue?: T | SQLExpression;
     defaultFn?: () => any;
+    onUpdateFn?: () => any;
     references?: {
         table: string;
         column: string;
@@ -48,34 +36,105 @@ type ColumnBuilder<T> = Column<T> & {
     default: (value: T | SQLExpression) => ColumnBuilder<T>;
     $type: <U>() => ColumnBuilder<U>;
     $defaultFn: (fn: () => any) => ColumnBuilder<T>;
+    $default: (fn: () => any) => ColumnBuilder<T>;
+    $onUpdate: (fn: () => any) => ColumnBuilder<T>;
+    $onUpdateFn: (fn: () => any) => ColumnBuilder<T>;
     references: (target: () => Column<any>, actions?: {
         onDelete?: UpdateDeleteAction;
         onUpdate?: UpdateDeleteAction;
     }) => ColumnBuilder<T>;
 };
-declare function text<TEnum extends string>(name: string, config?: {
-    isPrimaryKey?: boolean;
+type TextConfig<TEnum extends string> = {
     enum?: readonly TEnum[];
-}): ColumnBuilder<TEnum extends string ? TEnum : string>;
+    mode?: "json";
+};
+declare function text<TEnum extends string>(name: string, config?: TextConfig<TEnum>): ColumnBuilder<TEnum extends string ? TEnum : string>;
+declare function text<TEnum extends string>(config?: TextConfig<TEnum>): ColumnBuilder<TEnum extends string ? TEnum : string>;
+type IntegerMode = "number" | "boolean" | "timestamp" | "timestamp_ms";
 declare function integer(name: string, config?: {
-    isPrimaryKey?: boolean;
-    mode?: "number" | "boolean" | "timestamp";
-    autoIncrement?: boolean;
+    mode?: IntegerMode;
+}): ColumnBuilder<number | boolean | Date>;
+declare function integer(config?: {
+    mode?: IntegerMode;
 }): ColumnBuilder<number | boolean | Date>;
 declare function real(name: string): ColumnBuilder<number>;
+declare function real(): ColumnBuilder<number>;
+type BlobMode = "json" | "bigint" | "buffer";
 declare function blob(name: string, config?: {
-    mode?: "json" | "bigint";
+    mode?: BlobMode;
+}): ColumnBuilder<unknown | bigint | Uint8Array>;
+declare function blob(config?: {
+    mode?: BlobMode;
 }): ColumnBuilder<unknown | bigint | Uint8Array>;
+type NumericMode = "string" | "number" | "bigint";
 declare function numeric(name: string, config?: {
-    mode?: "string" | "number" | "bigint";
+    mode?: NumericMode;
+}): ColumnBuilder<string | number | bigint>;
+declare function numeric(config?: {
+    mode?: NumericMode;
 }): ColumnBuilder<string | number | bigint>;
-declare const boolean: (name: string) => ColumnBuilder<boolean>;
-declare const timestamp: (name: string) => ColumnBuilder<Date>;
+declare function boolean(name: string): ColumnBuilder<boolean>;
+declare function boolean(): ColumnBuilder<boolean>;
+declare function timestamp(name: string): ColumnBuilder<Date>;
+declare function timestamp(): ColumnBuilder<Date>;
+declare function increments(name: string): ColumnBuilder<number>;
+declare function increments(): ColumnBuilder<number>;
+type UniqueSpec = {
+    name?: string;
+    columns: string[];
+};
+type PrimaryKeySpec = {
+    name?: string;
+    columns: string[];
+};
+type CheckSpec = {
+    name: string;
+    expr: SQLExpression | {
+        raw: string;
+    };
+};
+type ForeignKeySpec = {
+    name?: string;
+    columns: string[];
+    foreignTable: string;
+    foreignColumns: string[];
+    onDelete?: UpdateDeleteAction;
+    onUpdate?: UpdateDeleteAction;
+};
+type IndexSpec = {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    where?: SQLExpression;
+};
+declare function unique(name?: string): {
+    on: (...cols: Column<any>[]) => UniqueSpec;
+};
+declare function primaryKey(opts: {
+    name?: string;
+    columns: Column<any>[];
+}): PrimaryKeySpec;
+declare function check(name: string, expr: SQLExpression): CheckSpec;
+declare function foreignKey(opts: {
+    name?: string;
+    columns: Column<any>[];
+    foreignColumns: Column<any>[];
+    onDelete?: UpdateDeleteAction;
+    onUpdate?: UpdateDeleteAction;
+}): ForeignKeySpec;
+declare function index(name: string): {
+    on: (...cols: Column<any>[]) => IndexSpec;
+    where: (expr: SQLExpression) => IndexSpec;
+};
+declare function uniqueIndex(name: string): {
+    on: (...cols: Column<any>[]) => IndexSpec;
+    where: (expr: SQLExpression) => IndexSpec;
+};
 type SchemaDefinition = Record<string, Column<any>>;
 type InferModel<T extends SchemaDefinition> = {
     [K in keyof T]: T[K]["_dataType"];
 };
-declare function defineTable<T extends SchemaDefinition>(tableName: string, schema: T): any & InferModel<T>;
+declare function defineTable<T extends SchemaDefinition>(tableName: string, schema: T, extras?: (t: any) => Array<UniqueSpec | PrimaryKeySpec | CheckSpec | ForeignKeySpec | IndexSpec>): any & InferModel<T>;
 type Table<T extends SchemaDefinition> = ReturnType<typeof defineTable<T>>;
 
 interface SQL {
@@ -84,6 +143,11 @@ interface SQL {
         bindings: any[];
     };
 }
+declare function raw(strings: TemplateStringsArray, ...values: any[]): SQL;
+declare function getQualifiedName(column: Column): string;
+declare const and: (...conditions: SQL[]) => SQL;
+declare const or: (...conditions: SQL[]) => SQL;
+declare const not: (condition: SQL) => SQL;
 declare const eq: (column: Column, value: any) => SQL;
 declare const ne: (column: Column, value: any) => SQL;
 declare const gt: (column: Column, value: number | Date) => SQL;
@@ -91,6 +155,36 @@ declare const gte: (column: Column, value: number | Date) => SQL;
 declare const lt: (column: Column, value: number | Date) => SQL;
 declare const lte: (column: Column, value: number | Date) => SQL;
 declare const like: (column: Column<string>, value: string) => SQL;
+declare const ilike: (column: Column<string>, value: string | Column) => SQL;
+declare const notIlike: (column: Column<string>, value: string | Column) => SQL;
+declare const isNull: (column: Column) => SQL;
+declare const isNotNull: (column: Column) => SQL;
+declare const between: (column: Column, from: number | string | Date | Column, to: number | string | Date | Column) => SQL;
+declare const notBetween: (column: Column, from: number | string | Date | Column, to: number | string | Date | Column) => SQL;
+declare const inArray: (column: Column, valuesOrQuery: any[] | SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const notInArray: (column: Column, valuesOrQuery: any[] | SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const exists: (subquery: SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const notExists: (subquery: SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
 declare const asc: (column: Column) => string;
 declare const desc: (column: Column) => string;
 
@@ -102,41 +196,103 @@ declare class SelectQueryBuilder<T> {
     private _orderBy;
     private _limit;
     private _offset;
-    private _eager;
-    constructor(fields?: Record<string, Column<any>>);
+    private _groupBy;
+    private _having;
+    private _distinct;
+    private _dbProvider;
+    constructor(dbProvider: () => Promise<Database>, fields?: Record<string, Column<any>>);
+    distinct(): this;
+    select(fields: Record<string, Column<any> | SQL>): this;
     from(table: Table<any>): this;
-    where(...conditions: SQL[]): this;
+    where(...conditions: (SQL | undefined)[]): this;
     leftJoin(otherTable: Table<any>, on: SQL): this;
-    orderBy(...clauses: string[]): this;
+    groupBy(...exprs: (Column | string)[]): this;
+    having(...conditions: SQL[]): this;
+    orderBy(...clauses: (string | Column<any> | SQL)[]): this;
     limit(value: number): this;
     offset(value: number): this;
     execute(): Promise<T[]>;
+    iterator(): Promise<AsyncIterableIterator<T>>;
 }
 declare class TauriORM {
     query: Record<string, any>;
     private _tables;
     private _relations;
+    private _dbPromise;
+    constructor(dbUri: string);
+    private getDb;
     configureQuery(tables: Record<string, Table<any>>, relations: Record<string, Record<string, RelationConfig>>): void;
     select<T>(fields?: Record<string, Column<any>>): SelectQueryBuilder<T>;
+    selectDistinct<T>(fields?: Record<string, Column<any>>): SelectQueryBuilder<T>;
     insert(table: Table<any>): {
         _table: any;
         _rows: Record<string, any>[];
+        _selectSql: {
+            clause: string;
+            bindings: any[];
+        } | null;
+        _conflict: null | {
+            kind: "doNothing";
+            target?: string | string[];
+            where?: SQL;
+        } | {
+            kind: "doUpdate";
+            target: string | string[];
+            targetWhere?: SQL;
+            set: Record<string, any>;
+            setWhere?: SQL;
+        };
+        _returning: null | "__RETURNING_ID__" | Record<string, Column<any>>;
         values(rowOrRows: Record<string, any> | Record<string, any>[]): /*elided*/ any;
-        execute(): Promise<void>;
+        select(qb: {
+            toSQL?: () => {
+                clause: string;
+                bindings: any[];
+            };
+        } | SQL): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        $returningId(): any;
+        onConflictDoNothing(opts?: {
+            target?: Column<any> | Column<any>[];
+            where?: SQL;
+        }): /*elided*/ any;
+        onConflictDoUpdate(opts: {
+            target: Column<any> | Column<any>[];
+            targetWhere?: SQL;
+            set: Record<string, any>;
+            setWhere?: SQL;
+        }): /*elided*/ any;
+        execute(): Promise<any>;
+        _buildConflictClause(): string;
+        _executeWithReturning(db: any, query: string, bindings: any[]): Promise<any>;
     };
     update(table: Table<any>): {
         _table: any;
         _data: Record<string, any> | null;
         _where: Record<string, any> | SQL | null;
+        _orderBy: Array<string | SQL>;
+        _limit: number | null;
+        _from: Table<any> | null;
+        _returning: null | Record<string, Column<any>>;
         set(data: Record<string, any>): /*elided*/ any;
         where(cond: Record<string, any> | SQL): /*elided*/ any;
-        execute(): Promise<void>;
+        orderBy(...clauses: (string | Column<any> | SQL)[]): /*elided*/ any;
+        limit(n: number): /*elided*/ any;
+        from(tbl: Table<any>): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        execute(): Promise<unknown>;
     };
     delete(table: Table<any>): {
         _table: any;
         _where: Record<string, any> | SQL | null;
+        _orderBy: Array<string | SQL>;
+        _limit: number | null;
+        _returning: null | Record<string, Column<any>>;
         where(cond: Record<string, any> | SQL): /*elided*/ any;
-        execute(): Promise<void>;
+        orderBy(...clauses: (string | Column<any> | SQL)[]): /*elided*/ any;
+        limit(n: number): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        execute(): Promise<unknown>;
     };
     run(query: string, bindings?: any[]): Promise<void>;
     private generateCreateTableSql;
@@ -209,7 +365,6 @@ declare class TauriORM {
         preserveData?: boolean;
     }): Promise<void>;
 }
-declare const db: TauriORM;
 type OneConfig = {
     fields?: Column[];
     references?: Column[];
@@ -238,12 +393,17 @@ type WithSpec = Record<string, boolean | {
     with?: WithSpec;
     columns?: string[];
 }>;
-declare function makeQueryAPI(tables: Record<string, Table<any>>, relDefs: Record<string, Record<string, RelationConfig>>): { [K in keyof typeof tables]: {
+declare function makeQueryAPI(tables: Record<string, Table<any>>, relDefs: Record<string, Record<string, RelationConfig>>, dbProvider: () => Promise<Database>): { [K in keyof typeof tables]: {
     findMany: (opts?: {
         with?: WithSpec;
         join?: boolean;
         columns?: string[];
     }) => Promise<any[]>;
+    findFirst: (opts?: {
+        with?: WithSpec;
+        join?: boolean;
+        columns?: string[];
+    }) => Promise<any | null>;
 }; };
 
-export { type Column, type ManyRelation, type OneRelation, type SQL, type SQLExpression, type Table, TauriORM, type UpdateDeleteAction, asc, blob, boolean, db, defineTable, desc, eq, getDb, gt, gte, initDb, integer, like, lt, lte, makeQueryAPI, ne, numeric, real, relations, sql, text, timestamp };
+export { type BlobMode, type CheckSpec, type Column, type ColumnBuilder, type ForeignKeySpec, type IndexSpec, type IntegerMode, type ManyRelation, type NumericMode, type OneRelation, type PrimaryKeySpec, type SQL, type SQLExpression, type Table, TauriORM, type UniqueSpec, type UpdateDeleteAction, and, asc, between, blob, boolean, check, defineTable, desc, eq, exists, foreignKey, getQualifiedName, gt, gte, ilike, inArray, increments, index, integer, isNotNull, isNull, like, lt, lte, makeQueryAPI, ne, not, notBetween, notExists, notIlike, notInArray, numeric, or, primaryKey, raw, real, relations, sql, text, timestamp, unique, uniqueIndex };

package/dist/index.d.ts

@@ -1,18 +1,5 @@
 import Database from '@tauri-apps/plugin-sql';
 
-/**
- * Initializes the database connection. This must be called once at the start of your application.
- * @param dbPath The path to the database file, e.g., 'sqlite:mydatabase.db'
- * @returns The database instance.
- */
-declare function initDb(dbPath: string): Promise<Database>;
-/**
- * Gets the singleton database instance.
- * @throws If `initDb` has not been called.
- * @returns The database instance.
- */
-declare function getDb(): Database;
-
 type UpdateDeleteAction = "cascade" | "restrict" | "no action" | "set null" | "set default";
 interface SQLExpression {
     raw: string;
@@ -26,6 +13,7 @@ interface Column<T = any> {
     isNotNull?: boolean;
     defaultValue?: T | SQLExpression;
     defaultFn?: () => any;
+    onUpdateFn?: () => any;
     references?: {
         table: string;
         column: string;
@@ -48,34 +36,105 @@ type ColumnBuilder<T> = Column<T> & {
     default: (value: T | SQLExpression) => ColumnBuilder<T>;
     $type: <U>() => ColumnBuilder<U>;
     $defaultFn: (fn: () => any) => ColumnBuilder<T>;
+    $default: (fn: () => any) => ColumnBuilder<T>;
+    $onUpdate: (fn: () => any) => ColumnBuilder<T>;
+    $onUpdateFn: (fn: () => any) => ColumnBuilder<T>;
     references: (target: () => Column<any>, actions?: {
         onDelete?: UpdateDeleteAction;
         onUpdate?: UpdateDeleteAction;
     }) => ColumnBuilder<T>;
 };
-declare function text<TEnum extends string>(name: string, config?: {
-    isPrimaryKey?: boolean;
+type TextConfig<TEnum extends string> = {
     enum?: readonly TEnum[];
-}): ColumnBuilder<TEnum extends string ? TEnum : string>;
+    mode?: "json";
+};
+declare function text<TEnum extends string>(name: string, config?: TextConfig<TEnum>): ColumnBuilder<TEnum extends string ? TEnum : string>;
+declare function text<TEnum extends string>(config?: TextConfig<TEnum>): ColumnBuilder<TEnum extends string ? TEnum : string>;
+type IntegerMode = "number" | "boolean" | "timestamp" | "timestamp_ms";
 declare function integer(name: string, config?: {
-    isPrimaryKey?: boolean;
-    mode?: "number" | "boolean" | "timestamp";
-    autoIncrement?: boolean;
+    mode?: IntegerMode;
+}): ColumnBuilder<number | boolean | Date>;
+declare function integer(config?: {
+    mode?: IntegerMode;
 }): ColumnBuilder<number | boolean | Date>;
 declare function real(name: string): ColumnBuilder<number>;
+declare function real(): ColumnBuilder<number>;
+type BlobMode = "json" | "bigint" | "buffer";
 declare function blob(name: string, config?: {
-    mode?: "json" | "bigint";
+    mode?: BlobMode;
+}): ColumnBuilder<unknown | bigint | Uint8Array>;
+declare function blob(config?: {
+    mode?: BlobMode;
 }): ColumnBuilder<unknown | bigint | Uint8Array>;
+type NumericMode = "string" | "number" | "bigint";
 declare function numeric(name: string, config?: {
-    mode?: "string" | "number" | "bigint";
+    mode?: NumericMode;
+}): ColumnBuilder<string | number | bigint>;
+declare function numeric(config?: {
+    mode?: NumericMode;
 }): ColumnBuilder<string | number | bigint>;
-declare const boolean: (name: string) => ColumnBuilder<boolean>;
-declare const timestamp: (name: string) => ColumnBuilder<Date>;
+declare function boolean(name: string): ColumnBuilder<boolean>;
+declare function boolean(): ColumnBuilder<boolean>;
+declare function timestamp(name: string): ColumnBuilder<Date>;
+declare function timestamp(): ColumnBuilder<Date>;
+declare function increments(name: string): ColumnBuilder<number>;
+declare function increments(): ColumnBuilder<number>;
+type UniqueSpec = {
+    name?: string;
+    columns: string[];
+};
+type PrimaryKeySpec = {
+    name?: string;
+    columns: string[];
+};
+type CheckSpec = {
+    name: string;
+    expr: SQLExpression | {
+        raw: string;
+    };
+};
+type ForeignKeySpec = {
+    name?: string;
+    columns: string[];
+    foreignTable: string;
+    foreignColumns: string[];
+    onDelete?: UpdateDeleteAction;
+    onUpdate?: UpdateDeleteAction;
+};
+type IndexSpec = {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    where?: SQLExpression;
+};
+declare function unique(name?: string): {
+    on: (...cols: Column<any>[]) => UniqueSpec;
+};
+declare function primaryKey(opts: {
+    name?: string;
+    columns: Column<any>[];
+}): PrimaryKeySpec;
+declare function check(name: string, expr: SQLExpression): CheckSpec;
+declare function foreignKey(opts: {
+    name?: string;
+    columns: Column<any>[];
+    foreignColumns: Column<any>[];
+    onDelete?: UpdateDeleteAction;
+    onUpdate?: UpdateDeleteAction;
+}): ForeignKeySpec;
+declare function index(name: string): {
+    on: (...cols: Column<any>[]) => IndexSpec;
+    where: (expr: SQLExpression) => IndexSpec;
+};
+declare function uniqueIndex(name: string): {
+    on: (...cols: Column<any>[]) => IndexSpec;
+    where: (expr: SQLExpression) => IndexSpec;
+};
 type SchemaDefinition = Record<string, Column<any>>;
 type InferModel<T extends SchemaDefinition> = {
     [K in keyof T]: T[K]["_dataType"];
 };
-declare function defineTable<T extends SchemaDefinition>(tableName: string, schema: T): any & InferModel<T>;
+declare function defineTable<T extends SchemaDefinition>(tableName: string, schema: T, extras?: (t: any) => Array<UniqueSpec | PrimaryKeySpec | CheckSpec | ForeignKeySpec | IndexSpec>): any & InferModel<T>;
 type Table<T extends SchemaDefinition> = ReturnType<typeof defineTable<T>>;
 
 interface SQL {
@@ -84,6 +143,11 @@ interface SQL {
         bindings: any[];
     };
 }
+declare function raw(strings: TemplateStringsArray, ...values: any[]): SQL;
+declare function getQualifiedName(column: Column): string;
+declare const and: (...conditions: SQL[]) => SQL;
+declare const or: (...conditions: SQL[]) => SQL;
+declare const not: (condition: SQL) => SQL;
 declare const eq: (column: Column, value: any) => SQL;
 declare const ne: (column: Column, value: any) => SQL;
 declare const gt: (column: Column, value: number | Date) => SQL;
@@ -91,6 +155,36 @@ declare const gte: (column: Column, value: number | Date) => SQL;
 declare const lt: (column: Column, value: number | Date) => SQL;
 declare const lte: (column: Column, value: number | Date) => SQL;
 declare const like: (column: Column<string>, value: string) => SQL;
+declare const ilike: (column: Column<string>, value: string | Column) => SQL;
+declare const notIlike: (column: Column<string>, value: string | Column) => SQL;
+declare const isNull: (column: Column) => SQL;
+declare const isNotNull: (column: Column) => SQL;
+declare const between: (column: Column, from: number | string | Date | Column, to: number | string | Date | Column) => SQL;
+declare const notBetween: (column: Column, from: number | string | Date | Column, to: number | string | Date | Column) => SQL;
+declare const inArray: (column: Column, valuesOrQuery: any[] | SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const notInArray: (column: Column, valuesOrQuery: any[] | SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const exists: (subquery: SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
+declare const notExists: (subquery: SQL | {
+    toSQL: () => {
+        clause: string;
+        bindings: any[];
+    };
+}) => SQL;
 declare const asc: (column: Column) => string;
 declare const desc: (column: Column) => string;
 
@@ -102,41 +196,103 @@ declare class SelectQueryBuilder<T> {
     private _orderBy;
     private _limit;
     private _offset;
-    private _eager;
-    constructor(fields?: Record<string, Column<any>>);
+    private _groupBy;
+    private _having;
+    private _distinct;
+    private _dbProvider;
+    constructor(dbProvider: () => Promise<Database>, fields?: Record<string, Column<any>>);
+    distinct(): this;
+    select(fields: Record<string, Column<any> | SQL>): this;
     from(table: Table<any>): this;
-    where(...conditions: SQL[]): this;
+    where(...conditions: (SQL | undefined)[]): this;
     leftJoin(otherTable: Table<any>, on: SQL): this;
-    orderBy(...clauses: string[]): this;
+    groupBy(...exprs: (Column | string)[]): this;
+    having(...conditions: SQL[]): this;
+    orderBy(...clauses: (string | Column<any> | SQL)[]): this;
     limit(value: number): this;
     offset(value: number): this;
     execute(): Promise<T[]>;
+    iterator(): Promise<AsyncIterableIterator<T>>;
 }
 declare class TauriORM {
     query: Record<string, any>;
     private _tables;
     private _relations;
+    private _dbPromise;
+    constructor(dbUri: string);
+    private getDb;
     configureQuery(tables: Record<string, Table<any>>, relations: Record<string, Record<string, RelationConfig>>): void;
     select<T>(fields?: Record<string, Column<any>>): SelectQueryBuilder<T>;
+    selectDistinct<T>(fields?: Record<string, Column<any>>): SelectQueryBuilder<T>;
     insert(table: Table<any>): {
         _table: any;
         _rows: Record<string, any>[];
+        _selectSql: {
+            clause: string;
+            bindings: any[];
+        } | null;
+        _conflict: null | {
+            kind: "doNothing";
+            target?: string | string[];
+            where?: SQL;
+        } | {
+            kind: "doUpdate";
+            target: string | string[];
+            targetWhere?: SQL;
+            set: Record<string, any>;
+            setWhere?: SQL;
+        };
+        _returning: null | "__RETURNING_ID__" | Record<string, Column<any>>;
         values(rowOrRows: Record<string, any> | Record<string, any>[]): /*elided*/ any;
-        execute(): Promise<void>;
+        select(qb: {
+            toSQL?: () => {
+                clause: string;
+                bindings: any[];
+            };
+        } | SQL): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        $returningId(): any;
+        onConflictDoNothing(opts?: {
+            target?: Column<any> | Column<any>[];
+            where?: SQL;
+        }): /*elided*/ any;
+        onConflictDoUpdate(opts: {
+            target: Column<any> | Column<any>[];
+            targetWhere?: SQL;
+            set: Record<string, any>;
+            setWhere?: SQL;
+        }): /*elided*/ any;
+        execute(): Promise<any>;
+        _buildConflictClause(): string;
+        _executeWithReturning(db: any, query: string, bindings: any[]): Promise<any>;
     };
     update(table: Table<any>): {
         _table: any;
         _data: Record<string, any> | null;
         _where: Record<string, any> | SQL | null;
+        _orderBy: Array<string | SQL>;
+        _limit: number | null;
+        _from: Table<any> | null;
+        _returning: null | Record<string, Column<any>>;
         set(data: Record<string, any>): /*elided*/ any;
         where(cond: Record<string, any> | SQL): /*elided*/ any;
-        execute(): Promise<void>;
+        orderBy(...clauses: (string | Column<any> | SQL)[]): /*elided*/ any;
+        limit(n: number): /*elided*/ any;
+        from(tbl: Table<any>): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        execute(): Promise<unknown>;
     };
     delete(table: Table<any>): {
         _table: any;
         _where: Record<string, any> | SQL | null;
+        _orderBy: Array<string | SQL>;
+        _limit: number | null;
+        _returning: null | Record<string, Column<any>>;
         where(cond: Record<string, any> | SQL): /*elided*/ any;
-        execute(): Promise<void>;
+        orderBy(...clauses: (string | Column<any> | SQL)[]): /*elided*/ any;
+        limit(n: number): /*elided*/ any;
+        returning(fields?: Record<string, Column<any>>): any;
+        execute(): Promise<unknown>;
     };
     run(query: string, bindings?: any[]): Promise<void>;
     private generateCreateTableSql;
@@ -209,7 +365,6 @@ declare class TauriORM {
         preserveData?: boolean;
     }): Promise<void>;
 }
-declare const db: TauriORM;
 type OneConfig = {
     fields?: Column[];
     references?: Column[];
@@ -238,12 +393,17 @@ type WithSpec = Record<string, boolean | {
     with?: WithSpec;
     columns?: string[];
 }>;
-declare function makeQueryAPI(tables: Record<string, Table<any>>, relDefs: Record<string, Record<string, RelationConfig>>): { [K in keyof typeof tables]: {
+declare function makeQueryAPI(tables: Record<string, Table<any>>, relDefs: Record<string, Record<string, RelationConfig>>, dbProvider: () => Promise<Database>): { [K in keyof typeof tables]: {
     findMany: (opts?: {
         with?: WithSpec;
         join?: boolean;
         columns?: string[];
     }) => Promise<any[]>;
+    findFirst: (opts?: {
+        with?: WithSpec;
+        join?: boolean;
+        columns?: string[];
+    }) => Promise<any | null>;
 }; };
 
-export { type Column, type ManyRelation, type OneRelation, type SQL, type SQLExpression, type Table, TauriORM, type UpdateDeleteAction, asc, blob, boolean, db, defineTable, desc, eq, getDb, gt, gte, initDb, integer, like, lt, lte, makeQueryAPI, ne, numeric, real, relations, sql, text, timestamp };
+export { type BlobMode, type CheckSpec, type Column, type ColumnBuilder, type ForeignKeySpec, type IndexSpec, type IntegerMode, type ManyRelation, type NumericMode, type OneRelation, type PrimaryKeySpec, type SQL, type SQLExpression, type Table, TauriORM, type UniqueSpec, type UpdateDeleteAction, and, asc, between, blob, boolean, check, defineTable, desc, eq, exists, foreignKey, getQualifiedName, gt, gte, ilike, inArray, increments, index, integer, isNotNull, isNull, like, lt, lte, makeQueryAPI, ne, not, notBetween, notExists, notIlike, notInArray, numeric, or, primaryKey, raw, real, relations, sql, text, timestamp, unique, uniqueIndex };