bettersqlkeza 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * BetterSQL - A minimal high performance ORM for Node.js using better-sqlite3
+ *
+ * Thin and SQL first with no decorators, no reflection, no runtime magic.
+ * Built directly on better-sqlite3 with cached prepared statements,
+ * transaction support, and strong TypeScript inference.
+ *
+ * @example
+ * ```typescript
+ * import { BetterSQL } from "@keza/bettersql";
+ *
+ * const ql = new BetterSQL({ filename: ":memory:" });
+ *
+ * const User = ql.define("user", {
+ *   id: { type: "INTEGER", primary: true, autoIncrement: true },
+ *   email: { type: "TEXT", unique: true },
+ *   username: { type: "TEXT" },
+ *   created_at: { type: "INTEGER" }
+ * });
+ *
+ * // Insert a new user
+ * const user = User.insert({ email: "a@mail.com", username: "alice", created_at: Date.now() });
+ *
+ * // Insert with existence check (avoids UNIQUE constraint errors)
+ * const user2 = User.insertBuilder({ email: "a@mail.com", username: "alice" })
+ *   .ifNotExists({ email: "a@mail.com" })
+ *   .run();
+ *
+ * // Query users
+ * const found = User.find({ email: "a@mail.com" }).first();
+ * const all = User.find().all();
+ * const byId = User.findById(1);
+ *
+ * // Chainable methods on results (methods that never end)
+ * const contact = User.query().where("id", "=", 1).first();
+ * contact?.delete(); // Delete the record
+ * contact?.update({ username: "new_name" }); // Update the record
+ * contact?.username; // Access property
+ *
+ * // Raw SQL queries
+ * const results = User.query("SELECT * FROM user WHERE status = 'active'");
+ * const paramResults = User.query("SELECT * FROM user WHERE id = ?", [1]);
+ *
+ * // Update (immediate execution)
+ * User.update({ email: "a@mail.com" }, { username: "alice_updated" });
+ *
+ * // Update (builder pattern)
+ * User.update({ username: "alice_updated" }).where("email", "=", "a@mail.com").run();
+ *
+ * // Delete (immediate execution)
+ * User.delete({ email: "a@mail.com" });
+ *
+ * // Delete (builder pattern)
+ * User.delete().where({ status: "inactive" }).orWhere({ expired: true }).run();
+ * ```
+ */
+export { BetterSQL } from './bettersql';
+export { Model } from './model';
+export { QueryBuilder } from './query-builder';
+export { RawQueryBuilder } from './raw-query-builder';
+export { DeleteBuilder } from './delete-builder';
+export { UpdateBuilder } from './update-builder';
+export { InsertBuilder } from './insert-builder';
+export { ResultProxy, createResultProxy } from './result-proxy';
+export type { ConflictResolution } from './insert-builder';
+export type { AdvancedWhereCondition, AggregateFunction, AndCondition, BetterSQLConfig, ColumnDefinition, ColumnType, ComparisonOperator, InferSchemaType, OrderBy, OrderDirection, OrCondition, QueryOptions, SchemaDefinition, SQLQueryBindings, TransactionCallback, UpdateData, WhereCondition, WhereOperator, WhereValue } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,OAAO,EACP,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACX,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * BetterSQL - A minimal high performance ORM for Node.js using better-sqlite3
+ *
+ * Thin and SQL first with no decorators, no reflection, no runtime magic.
+ * Built directly on better-sqlite3 with cached prepared statements,
+ * transaction support, and strong TypeScript inference.
+ *
+ * @example
+ * ```typescript
+ * import { BetterSQL } from "@keza/bettersql";
+ *
+ * const ql = new BetterSQL({ filename: ":memory:" });
+ *
+ * const User = ql.define("user", {
+ *   id: { type: "INTEGER", primary: true, autoIncrement: true },
+ *   email: { type: "TEXT", unique: true },
+ *   username: { type: "TEXT" },
+ *   created_at: { type: "INTEGER" }
+ * });
+ *
+ * // Insert a new user
+ * const user = User.insert({ email: "a@mail.com", username: "alice", created_at: Date.now() });
+ *
+ * // Insert with existence check (avoids UNIQUE constraint errors)
+ * const user2 = User.insertBuilder({ email: "a@mail.com", username: "alice" })
+ *   .ifNotExists({ email: "a@mail.com" })
+ *   .run();
+ *
+ * // Query users
+ * const found = User.find({ email: "a@mail.com" }).first();
+ * const all = User.find().all();
+ * const byId = User.findById(1);
+ *
+ * // Chainable methods on results (methods that never end)
+ * const contact = User.query().where("id", "=", 1).first();
+ * contact?.delete(); // Delete the record
+ * contact?.update({ username: "new_name" }); // Update the record
+ * contact?.username; // Access property
+ *
+ * // Raw SQL queries
+ * const results = User.query("SELECT * FROM user WHERE status = 'active'");
+ * const paramResults = User.query("SELECT * FROM user WHERE id = ?", [1]);
+ *
+ * // Update (immediate execution)
+ * User.update({ email: "a@mail.com" }, { username: "alice_updated" });
+ *
+ * // Update (builder pattern)
+ * User.update({ username: "alice_updated" }).where("email", "=", "a@mail.com").run();
+ *
+ * // Delete (immediate execution)
+ * User.delete({ email: "a@mail.com" });
+ *
+ * // Delete (builder pattern)
+ * User.delete().where({ status: "inactive" }).orWhere({ expired: true }).run();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createResultProxy = exports.ResultProxy = exports.InsertBuilder = exports.UpdateBuilder = exports.DeleteBuilder = exports.RawQueryBuilder = exports.QueryBuilder = exports.Model = exports.BetterSQL = void 0;
+var bettersql_1 = require("./bettersql");
+Object.defineProperty(exports, "BetterSQL", { enumerable: true, get: function () { return bettersql_1.BetterSQL; } });
+var model_1 = require("./model");
+Object.defineProperty(exports, "Model", { enumerable: true, get: function () { return model_1.Model; } });
+var query_builder_1 = require("./query-builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
+var raw_query_builder_1 = require("./raw-query-builder");
+Object.defineProperty(exports, "RawQueryBuilder", { enumerable: true, get: function () { return raw_query_builder_1.RawQueryBuilder; } });
+var delete_builder_1 = require("./delete-builder");
+Object.defineProperty(exports, "DeleteBuilder", { enumerable: true, get: function () { return delete_builder_1.DeleteBuilder; } });
+var update_builder_1 = require("./update-builder");
+Object.defineProperty(exports, "UpdateBuilder", { enumerable: true, get: function () { return update_builder_1.UpdateBuilder; } });
+var insert_builder_1 = require("./insert-builder");
+Object.defineProperty(exports, "InsertBuilder", { enumerable: true, get: function () { return insert_builder_1.InsertBuilder; } });
+var result_proxy_1 = require("./result-proxy");
+Object.defineProperty(exports, "ResultProxy", { enumerable: true, get: function () { return result_proxy_1.ResultProxy; } });
+Object.defineProperty(exports, "createResultProxy", { enumerable: true, get: function () { return result_proxy_1.createResultProxy; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;;;AAEH,yCAAuC;AAA9B,sGAAA,SAAS,OAAA;AAClB,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AACd,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AACrB,yDAAqD;AAA5C,oHAAA,eAAe,OAAA;AACxB,mDAAgD;AAAvC,+GAAA,aAAa,OAAA;AACtB,mDAAgD;AAAvC,+GAAA,aAAa,OAAA;AACtB,mDAAgD;AAAvC,+GAAA,aAAa,OAAA;AACtB,+CAA+D;AAAtD,2GAAA,WAAW,OAAA;AAAE,iHAAA,iBAAiB,OAAA"}

package/dist/insert-builder.d.ts

@@ -0,0 +1,62 @@
+import type Database from 'better-sqlite3';
+import type { SchemaDefinition, SQLQueryBindings, WhereCondition } from './types';
+/** Conflict resolution strategy for INSERT operations */
+export type ConflictResolution = 'abort' | 'ignore' | 'replace';
+/**
+ * InsertBuilder<T> - A fluent query builder for constructing INSERT queries
+ * Queries are only executed when .run() is called
+ */
+export declare class InsertBuilder<T, S extends SchemaDefinition = SchemaDefinition> {
+    private db;
+    private tableName;
+    private _data;
+    private _conflictResolution;
+    private _checkCondition;
+    private statementCache;
+    private schema;
+    private primaryKey;
+    constructor(db: Database.Database, tableName: string, statementCache: Map<string, Database.Statement>, data: Partial<T>, schema: S, primaryKey?: string | null);
+    /**
+     * Check if a record already exists before inserting
+     * If a record matching the condition exists, the insert will be skipped
+     * @param condition - The WHERE condition to check for existing records
+     */
+    ifNotExists(condition: WhereCondition<T>): InsertBuilder<T, S>;
+    /**
+     * Use INSERT OR IGNORE - silently skip if unique constraint fails
+     */
+    orIgnore(): InsertBuilder<T, S>;
+    /**
+     * Use INSERT OR REPLACE - replace existing record if unique constraint fails
+     */
+    orReplace(): InsertBuilder<T, S>;
+    /**
+     * Build the SQL query and parameters
+     */
+    private buildQuery;
+    /**
+     * Get or create a cached prepared statement
+     */
+    private getStatement;
+    /**
+     * Check if a record exists matching the condition
+     */
+    private recordExists;
+    /**
+     * Find a record by its primary key
+     */
+    private findById;
+    /**
+     * Execute the INSERT query and return the inserted record
+     * Returns null if the insert was skipped (due to ifNotExists check or orIgnore)
+     */
+    run(): T | null;
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL(): {
+        sql: string;
+        params: SQLQueryBindings[];
+    };
+}
+//# sourceMappingURL=insert-builder.d.ts.map

package/dist/insert-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-builder.d.ts","sourceRoot":"","sources":["../src/insert-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAmB,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAGlG,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE/D;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IACzE,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,MAAM,CAAG;IACjB,OAAO,CAAC,UAAU,CAAsB;gBAGtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC/C,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,MAAM,EAAE,CAAC,EACT,UAAU,GAAE,MAAM,GAAG,IAAW;IAUlC;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAK9D;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAK/B;;OAEG;IACH,SAAS,IAAI,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAKhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;;OAGG;IACH,GAAG,IAAI,CAAC,GAAG,IAAI;IA0Bf;;OAEG;IACH,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;KAAE;CAGrD"}

package/dist/insert-builder.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsertBuilder = void 0;
+const where_builder_1 = require("./where-builder");
+/**
+ * InsertBuilder<T> - A fluent query builder for constructing INSERT queries
+ * Queries are only executed when .run() is called
+ */
+class InsertBuilder {
+    db;
+    tableName;
+    _data;
+    _conflictResolution = 'abort';
+    _checkCondition = null;
+    statementCache;
+    schema;
+    primaryKey = null;
+    constructor(db, tableName, statementCache, data, schema, primaryKey = null) {
+        this.db = db;
+        this.tableName = tableName;
+        this.statementCache = statementCache;
+        this._data = data;
+        this.schema = schema;
+        this.primaryKey = primaryKey;
+    }
+    /**
+     * Check if a record already exists before inserting
+     * If a record matching the condition exists, the insert will be skipped
+     * @param condition - The WHERE condition to check for existing records
+     */
+    ifNotExists(condition) {
+        this._checkCondition = condition;
+        return this;
+    }
+    /**
+     * Use INSERT OR IGNORE - silently skip if unique constraint fails
+     */
+    orIgnore() {
+        this._conflictResolution = 'ignore';
+        return this;
+    }
+    /**
+     * Use INSERT OR REPLACE - replace existing record if unique constraint fails
+     */
+    orReplace() {
+        this._conflictResolution = 'replace';
+        return this;
+    }
+    /**
+     * Build the SQL query and parameters
+     */
+    buildQuery() {
+        const keys = Object.keys(this._data);
+        const values = Object.values(this._data);
+        const placeholders = keys.map(() => '?').join(', ');
+        const columns = keys.map((k) => `"${k}"`).join(', ');
+        let insertKeyword = 'INSERT';
+        if (this._conflictResolution === 'ignore') {
+            insertKeyword = 'INSERT OR IGNORE';
+        }
+        else if (this._conflictResolution === 'replace') {
+            insertKeyword = 'INSERT OR REPLACE';
+        }
+        const sql = `${insertKeyword} INTO "${this.tableName}" (${columns}) VALUES (${placeholders})`;
+        return { sql, params: values };
+    }
+    /**
+     * Get or create a cached prepared statement
+     */
+    getStatement(sql) {
+        let stmt = this.statementCache.get(sql);
+        if (!stmt) {
+            stmt = this.db.prepare(sql);
+            this.statementCache.set(sql, stmt);
+        }
+        return stmt;
+    }
+    /**
+     * Check if a record exists matching the condition
+     */
+    recordExists(condition) {
+        const params = [];
+        const whereClause = (0, where_builder_1.buildWhereClause)(condition, params);
+        if (!whereClause) {
+            return false;
+        }
+        const sql = `SELECT EXISTS(SELECT 1 FROM "${this.tableName}" WHERE ${whereClause}) as exists_result`;
+        const stmt = this.db.prepare(sql);
+        const result = stmt.get(...params);
+        return result.exists_result === 1;
+    }
+    /**
+     * Find a record by its primary key
+     */
+    findById(id) {
+        if (!this.primaryKey) {
+            return null;
+        }
+        const sql = `SELECT * FROM "${this.tableName}" WHERE "${this.primaryKey}" = ?`;
+        const stmt = this.getStatement(sql);
+        return stmt.get(id) || null;
+    }
+    /**
+     * Execute the INSERT query and return the inserted record
+     * Returns null if the insert was skipped (due to ifNotExists check or orIgnore)
+     */
+    run() {
+        // Check if record already exists if ifNotExists was called
+        if (this._checkCondition !== null) {
+            if (this.recordExists(this._checkCondition)) {
+                return null;
+            }
+        }
+        const { sql, params } = this.buildQuery();
+        const stmt = this.getStatement(sql);
+        const info = stmt.run(...params);
+        // Use the changes and lastInsertRowid from stmt.run() return value (more efficient)
+        if (info.changes === 0) {
+            // No row was inserted (could be due to OR IGNORE)
+            return null;
+        }
+        if (this.primaryKey) {
+            return this.findById(Number(info.lastInsertRowid));
+        }
+        // If no primary key, return the inserted data
+        return { ...this._data };
+    }
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL() {
+        return this.buildQuery();
+    }
+}
+exports.InsertBuilder = InsertBuilder;
+//# sourceMappingURL=insert-builder.js.map

package/dist/insert-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-builder.js","sourceRoot":"","sources":["../src/insert-builder.ts"],"names":[],"mappings":"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"}

package/dist/model.d.ts

@@ -0,0 +1,185 @@
+import type Database from 'better-sqlite3';
+import type { InferSchemaType, SchemaDefinition, SQLQueryBindings, UpdateData, WhereCondition } from './types';
+import { QueryBuilder } from './query-builder';
+import { RawQueryBuilder } from './raw-query-builder';
+import { DeleteBuilder } from './delete-builder';
+import { UpdateBuilder } from './update-builder';
+import { InsertBuilder } from './insert-builder';
+import { ResultProxy } from './result-proxy';
+/**
+ * Model<T> - Represents a database table with typed CRUD operations
+ */
+export declare class Model<S extends SchemaDefinition> {
+    private db;
+    private tableName;
+    private schema;
+    private statementCache;
+    private primaryKey;
+    constructor(db: Database.Database, tableName: string, schema: S, statementCache: Map<string, Database.Statement>);
+    /**
+     * Get or create a cached prepared statement
+     */
+    private getStatement;
+    /**
+     * Create a QueryBuilder with optional initial WHERE conditions
+     */
+    find(where?: WhereCondition<InferSchemaType<S>>): QueryBuilder<InferSchemaType<S>>;
+    /**
+     * Create a QueryBuilder for SELECT queries with fluent chaining
+     * @example
+     * const users = User.select().where("lid", "=", id).get();
+     * const activeUsers = User.select().where({ status: "active" }).orderBy("name").all();
+     */
+    select(where?: WhereCondition<InferSchemaType<S>>): QueryBuilder<InferSchemaType<S>>;
+    /**
+     * Create a QueryBuilder for SELECT queries with fluent chaining, or execute raw SQL
+     * Alias for select() method, providing a more intuitive API for querying
+     * @overload query(where) - Create a QueryBuilder with optional initial WHERE conditions
+     * @overload query(rawSql) - Execute raw SQL query and return results
+     * @overload query(rawSql, params) - Execute raw SQL query with parameters
+     * @example
+     * // QueryBuilder pattern
+     * const contact = Contact.query().where("lid", "=", lid).first();
+     * const users = User.query().where("status", "=", "active").all();
+     *
+     * // Raw SQL pattern
+     * const results = User.query("SELECT * FROM user WHERE status = 'active'");
+     * const paramResults = User.query("SELECT * FROM user WHERE id = ?", [1]);
+     */
+    query(rawSql: string, params?: SQLQueryBindings[]): RawQueryBuilder<InferSchemaType<S>>;
+    query(where?: WhereCondition<InferSchemaType<S>>): QueryBuilder<InferSchemaType<S>>;
+    /**
+     * Find a record by its primary key
+     * Returns a result with chainable methods like delete(), update(), save()
+     */
+    findById(id: number | string): (InferSchemaType<S> & ResultProxy<InferSchemaType<S>>) | null;
+    /**
+     * Insert a new record (immediate execution)
+     */
+    insert(data: Partial<InferSchemaType<S>>): InferSchemaType<S>;
+    /**
+     * Create an InsertBuilder for fluent chaining with options like ifNotExists, orIgnore, orReplace
+     * @example
+     * // Insert with existence check (avoids UNIQUE constraint errors)
+     * const user = User.insertBuilder({ email: "test@example.com", name: "Test" })
+     *   .ifNotExists({ email: "test@example.com" })
+     *   .run();
+     *
+     * // Insert with OR IGNORE (silently skip on conflict)
+     * const user = User.insertBuilder({ email: "test@example.com", name: "Test" })
+     *   .orIgnore()
+     *   .run();
+     *
+     * // Insert with OR REPLACE (replace on conflict)
+     * const user = User.insertBuilder({ email: "test@example.com", name: "Test" })
+     *   .orReplace()
+     *   .run();
+     */
+    insertBuilder(data: Partial<InferSchemaType<S>>): InsertBuilder<InferSchemaType<S>, S>;
+    /**
+     * Insert multiple records at once
+     */
+    insertMany(dataArray: Partial<InferSchemaType<S>>[]): InferSchemaType<S>[];
+    /**
+     * Update records matching the WHERE conditions or return an UpdateBuilder for chaining
+     * @overload When called with just data, returns an UpdateBuilder for fluent chaining
+     * @overload When called with a WhereCondition and data, executes immediately and returns the count
+     */
+    update(data: UpdateData<InferSchemaType<S>>): UpdateBuilder<InferSchemaType<S>>;
+    update(where: WhereCondition<InferSchemaType<S>>, data: UpdateData<InferSchemaType<S>>): number;
+    /**
+     * Update a record by its primary key
+     */
+    updateById(id: number | string, data: UpdateData<InferSchemaType<S>>): boolean;
+    /**
+     * Delete records matching the WHERE conditions or return a DeleteBuilder for chaining
+     * @overload When called with no arguments, returns a DeleteBuilder for fluent chaining
+     * @overload When called with a WhereCondition, executes immediately and returns the count
+     */
+    delete(): DeleteBuilder<InferSchemaType<S>>;
+    delete(where: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Delete a record by its primary key
+     */
+    deleteById(id: number | string): boolean;
+    /**
+     * Count records matching the WHERE conditions
+     */
+    count(where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Get all records from the table
+     */
+    all(): InferSchemaType<S>[];
+    /**
+     * Insert or replace a record (upsert)
+     * Uses SQLite's INSERT OR REPLACE
+     */
+    upsert(data: Partial<InferSchemaType<S>>): InferSchemaType<S>;
+    /**
+     * Insert or update on conflict (more granular upsert)
+     * Uses SQLite's INSERT ... ON CONFLICT DO UPDATE
+     */
+    upsertOn(data: Partial<InferSchemaType<S>>, conflictColumns: (keyof InferSchemaType<S>)[], updateData?: UpdateData<InferSchemaType<S>>): InferSchemaType<S>;
+    /**
+     * Check if any records exist matching the conditions
+     */
+    exists(where?: WhereCondition<InferSchemaType<S>>): boolean;
+    /**
+     * Find a record by primary key or throw an error
+     * Returns a result with chainable methods like delete(), update(), save()
+     */
+    findByIdOrFail(id: number | string): InferSchemaType<S> & ResultProxy<InferSchemaType<S>>;
+    /**
+     * Get array of values for a single column
+     */
+    pluck<K extends keyof InferSchemaType<S>>(column: K, where?: WhereCondition<InferSchemaType<S>>): InferSchemaType<S>[K][];
+    /**
+     * Get distinct values for a column
+     */
+    distinct<K extends keyof InferSchemaType<S>>(column: K, where?: WhereCondition<InferSchemaType<S>>): InferSchemaType<S>[K][];
+    /**
+     * Get the sum of a column
+     */
+    sum(column: keyof InferSchemaType<S>, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Get the average of a column
+     */
+    avg(column: keyof InferSchemaType<S>, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Get the minimum value of a column
+     */
+    min(column: keyof InferSchemaType<S>, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Get the maximum value of a column
+     */
+    max(column: keyof InferSchemaType<S>, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Increment a column value
+     */
+    increment(column: keyof InferSchemaType<S>, amount?: number, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Decrement a column value
+     */
+    decrement(column: keyof InferSchemaType<S>, amount?: number, where?: WhereCondition<InferSchemaType<S>>): number;
+    /**
+     * Truncate the table (delete all records)
+     */
+    truncate(): void;
+    /**
+     * Get the table name
+     */
+    getTableName(): string;
+    /**
+     * Get the schema definition
+     */
+    getSchema(): S;
+    /**
+     * Generate CREATE TABLE SQL for this model
+     */
+    toCreateTableSQL(): string;
+}
+/**
+ * Generate CREATE TABLE SQL from schema definition
+ */
+export declare function generateCreateTableSQL(tableName: string, schema: SchemaDefinition): string;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}