bettersqlkeza 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 αѕтяσ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @keza/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.
+
+## Installation
+
+```bash
+npm install @keza/bettersql better-sqlite3
+```
+
+## Quick Start
+
+```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: 'alice@example.com',
+  username: 'alice',
+  created_at: Date.now()
+})
+
+// Query users
+const found = User.find({ email: 'alice@example.com' }).first()
+const all = User.find().all()
+const byId = User.findById(1)
+
+// Fluent query builder
+const active = User.query().where('status', '=', 'active').orderBy('created_at', 'DESC').limit(10).all()
+
+// Chainable methods on results
+const contact = User.query().where('id', '=', 1).first()
+contact?.delete()
+contact?.update({ username: 'new_name' })
+
+// Raw SQL queries
+const results = User.query("SELECT * FROM user WHERE status = 'active'")
+const paramResults = User.query('SELECT * FROM user WHERE id = ?', [1])
+```
+
+## Features
+
+- **Type-safe**: Full TypeScript support with inferred types
+- **Fluent API**: Chainable query builders for SELECT, INSERT, UPDATE, DELETE
+- **Cached statements**: Prepared statements are automatically cached
+- **Transactions**: Full transaction support with automatic rollback
+- **Result proxies**: Query results have chainable methods like `.delete()`, `.update()`
+- **WAL mode**: Enabled by default for better concurrent performance
+
+## API Reference
+
+### BetterSQL
+
+```typescript
+const ql = new BetterSQL({
+  filename: string,  // Database file path or ":memory:"
+  wal?: boolean,     // Enable WAL mode (default: true)
+});
+
+ql.define(tableName, schema)     // Define a model
+ql.getModel(tableName)           // Get existing model
+ql.exec(sql)                     // Execute raw SQL
+ql.query(sql, params?)           // Query with results
+ql.transaction(callback)         // Run in transaction
+ql.close()                       // Close connection
+```
+
+### Model
+
+```typescript
+Model.insert(data)               // Insert record
+Model.insertBuilder(data)        // Fluent insert builder
+Model.find(where?)               // Query builder
+Model.findById(id)               // Find by primary key
+Model.update(where, data)        // Update records
+Model.delete(where)              // Delete records
+Model.count(where?)              // Count records
+Model.all()                      // Get all records
+Model.upsert(data)               // Insert or replace
+```
+
+### Query Builder
+
+```typescript
+Model.find()
+  .where(conditions) // AND conditions
+  .where(col, op, val) // Comparison operator
+  .orWhere(conditions) // OR conditions
+  .orderBy(column, direction) // ORDER BY
+  .limit(count) // LIMIT
+  .offset(count) // OFFSET
+  .select(...columns) // Select columns
+  .distinct() // DISTINCT
+  .groupBy(...columns) // GROUP BY
+  .having(conditions) // HAVING
+  .all() // Execute and get all
+  .first() // Get first result
+  .count() // Get count
+  .exists() // Check existence
+```
+
+## License
+
+MIT

package/dist/bettersql.d.ts

@@ -0,0 +1,107 @@
+import Database from 'better-sqlite3';
+import type { BetterSQLConfig, SchemaDefinition, SQLQueryBindings, TransactionCallback } from './types';
+import { Model } from './model';
+/**
+ * BetterSQL - A minimal high performance ORM for Node.js using better-sqlite3
+ *
+ * @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" }
+ * });
+ *
+ * const user = User.insert({ email: "a@mail.com", username: "alice", created_at: Date.now() });
+ * const found = User.find({ email: "a@mail.com" }).first();
+ * ```
+ */
+export declare class BetterSQL {
+    private db;
+    private config;
+    private statementCache;
+    private models;
+    constructor(config: BetterSQLConfig);
+    /**
+     * Define a new model/table with the given schema
+     * Automatically creates the table if it doesn't exist
+     */
+    define<S extends SchemaDefinition>(tableName: string, schema: S): Model<S>;
+    /**
+     * Get a previously defined model by table name
+     */
+    getModel<S extends SchemaDefinition>(tableName: string): Model<S> | undefined;
+    /**
+     * Execute a raw SQL query
+     */
+    exec(sql: string): void;
+    /**
+     * Execute a raw SQL query with parameters and return results
+     */
+    query<T = unknown>(sql: string, params?: SQLQueryBindings[]): T[];
+    /**
+     * Execute a raw SQL query with parameters and return the first result
+     */
+    queryOne<T = unknown>(sql: string, params?: SQLQueryBindings[]): T | null;
+    /**
+     * Execute operations within a transaction
+     * Automatically commits on success, rolls back on error
+     */
+    transaction<R>(callback: TransactionCallback<R>): R;
+    /**
+     * Begin a manual transaction
+     */
+    beginTransaction(): void;
+    /**
+     * Commit the current transaction
+     */
+    commit(): void;
+    /**
+     * Rollback the current transaction
+     */
+    rollback(): void;
+    /**
+     * Get the underlying better-sqlite3 Database instance
+     */
+    getDatabase(): Database.Database;
+    /**
+     * Close the database connection and clear caches
+     */
+    close(): void;
+    /**
+     * Check if the database connection is open
+     */
+    isOpen(): boolean;
+    /**
+     * Check if currently in a transaction
+     */
+    inTransaction(): boolean;
+    /**
+     * Create a deferred transaction function
+     * Uses "BEGIN DEFERRED" - locks are acquired lazily
+     */
+    transactionDeferred<R>(callback: TransactionCallback<R>): R;
+    /**
+     * Create an immediate transaction function
+     * Uses "BEGIN IMMEDIATE" - write lock is acquired immediately
+     */
+    transactionImmediate<R>(callback: TransactionCallback<R>): R;
+    /**
+     * Create an exclusive transaction function
+     * Uses "BEGIN EXCLUSIVE" - exclusive lock, no other connections can read or write
+     */
+    transactionExclusive<R>(callback: TransactionCallback<R>): R;
+    /**
+     * Get database statistics
+     */
+    stats(): {
+        tables: number;
+        cachedStatements: number;
+    };
+}
+//# sourceMappingURL=bettersql.d.ts.map

package/dist/bettersql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bettersql.d.ts","sourceRoot":"","sources":["../src/bettersql.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,EAAE,eAAe,EAAmB,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AACxH,OAAO,EAAE,KAAK,EAA0B,MAAM,SAAS,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,MAAM,CAAsC;gBAExC,MAAM,EAAE,eAAe;IAmBnC;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAa1E;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS;IAI7E;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE;IAQjE;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,GAAG,IAAI;IAQzE;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;IAKnD;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAIxB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;IAK3D;;;OAGG;IACH,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;IAK5D;;;OAGG;IACH,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC;IAK5D;;OAEG;IACH,KAAK,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;CAMtD"}

package/dist/bettersql.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BetterSQL = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const model_1 = require("./model");
+/**
+ * BetterSQL - A minimal high performance ORM for Node.js using better-sqlite3
+ *
+ * @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" }
+ * });
+ *
+ * const user = User.insert({ email: "a@mail.com", username: "alice", created_at: Date.now() });
+ * const found = User.find({ email: "a@mail.com" }).first();
+ * ```
+ */
+class BetterSQL {
+    db;
+    config;
+    statementCache;
+    models;
+    constructor(config) {
+        this.config = {
+            wal: true,
+            ...config
+        };
+        // Create database connection
+        this.db = new better_sqlite3_1.default(this.config.filename);
+        // Enable WAL mode for better concurrent performance
+        if (this.config.wal) {
+            this.db.pragma('journal_mode = WAL');
+        }
+        // Initialize caches
+        this.statementCache = new Map();
+        this.models = new Map();
+    }
+    /**
+     * Define a new model/table with the given schema
+     * Automatically creates the table if it doesn't exist
+     */
+    define(tableName, schema) {
+        // Generate and execute CREATE TABLE SQL
+        const createSQL = (0, model_1.generateCreateTableSQL)(tableName, schema);
+        this.db.exec(createSQL);
+        // Create and cache the model
+        const model = new model_1.Model(this.db, tableName, schema, this.statementCache);
+        this.models.set(tableName, model);
+        return model;
+    }
+    /**
+     * Get a previously defined model by table name
+     */
+    getModel(tableName) {
+        return this.models.get(tableName);
+    }
+    /**
+     * Execute a raw SQL query
+     */
+    exec(sql) {
+        this.db.exec(sql);
+    }
+    /**
+     * Execute a raw SQL query with parameters and return results
+     */
+    query(sql, params) {
+        const stmt = this.db.prepare(sql);
+        if (params && params.length > 0) {
+            return stmt.all(...params);
+        }
+        return stmt.all();
+    }
+    /**
+     * Execute a raw SQL query with parameters and return the first result
+     */
+    queryOne(sql, params) {
+        const stmt = this.db.prepare(sql);
+        if (params && params.length > 0) {
+            return stmt.get(...params) || null;
+        }
+        return stmt.get() || null;
+    }
+    /**
+     * Execute operations within a transaction
+     * Automatically commits on success, rolls back on error
+     */
+    transaction(callback) {
+        const transaction = this.db.transaction(callback);
+        return transaction();
+    }
+    /**
+     * Begin a manual transaction
+     */
+    beginTransaction() {
+        this.db.exec('BEGIN TRANSACTION');
+    }
+    /**
+     * Commit the current transaction
+     */
+    commit() {
+        this.db.exec('COMMIT');
+    }
+    /**
+     * Rollback the current transaction
+     */
+    rollback() {
+        this.db.exec('ROLLBACK');
+    }
+    /**
+     * Get the underlying better-sqlite3 Database instance
+     */
+    getDatabase() {
+        return this.db;
+    }
+    /**
+     * Close the database connection and clear caches
+     */
+    close() {
+        this.statementCache.clear();
+        this.models.clear();
+        this.db.close();
+    }
+    /**
+     * Check if the database connection is open
+     */
+    isOpen() {
+        return this.db.open;
+    }
+    /**
+     * Check if currently in a transaction
+     */
+    inTransaction() {
+        return this.db.inTransaction;
+    }
+    /**
+     * Create a deferred transaction function
+     * Uses "BEGIN DEFERRED" - locks are acquired lazily
+     */
+    transactionDeferred(callback) {
+        const transaction = this.db.transaction(callback);
+        return transaction.deferred();
+    }
+    /**
+     * Create an immediate transaction function
+     * Uses "BEGIN IMMEDIATE" - write lock is acquired immediately
+     */
+    transactionImmediate(callback) {
+        const transaction = this.db.transaction(callback);
+        return transaction.immediate();
+    }
+    /**
+     * Create an exclusive transaction function
+     * Uses "BEGIN EXCLUSIVE" - exclusive lock, no other connections can read or write
+     */
+    transactionExclusive(callback) {
+        const transaction = this.db.transaction(callback);
+        return transaction.exclusive();
+    }
+    /**
+     * Get database statistics
+     */
+    stats() {
+        return {
+            tables: this.models.size,
+            cachedStatements: this.statementCache.size
+        };
+    }
+}
+exports.BetterSQL = BetterSQL;
+//# sourceMappingURL=bettersql.js.map

package/dist/bettersql.js.map

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

package/dist/delete-builder.d.ts

@@ -0,0 +1,58 @@
+import type Database from 'better-sqlite3';
+import type { ComparisonOperator, OrderDirection, SQLQueryBindings, WhereCondition } from './types';
+/**
+ * DeleteBuilder<T> - A fluent query builder for constructing DELETE queries
+ * Queries are only executed when .run() is called
+ */
+export declare class DeleteBuilder<T> {
+    private db;
+    private tableName;
+    private _where;
+    private _orConditions;
+    private _orderBy;
+    private _limit?;
+    private statementCache;
+    constructor(db: Database.Database, tableName: string, statementCache: Map<string, Database.Statement>, initialWhere?: WhereCondition<T>);
+    /**
+     * Add WHERE conditions to the query (AND)
+     * @overload where(conditions) - Add conditions object
+     * @overload where(column, operator, value) - Add single condition with operator
+     */
+    where(conditions: WhereCondition<T>): DeleteBuilder<T>;
+    where<K extends keyof T>(column: K, operator: ComparisonOperator, value: T[K]): DeleteBuilder<T>;
+    /**
+     * Add OR conditions to the query
+     * @overload orWhere(conditions) - Add conditions object
+     * @overload orWhere(column, operator, value) - Add single condition with operator
+     */
+    orWhere(conditions: WhereCondition<T>): DeleteBuilder<T>;
+    orWhere<K extends keyof T>(column: K, operator: ComparisonOperator, value: T[K]): DeleteBuilder<T>;
+    /**
+     * Add ORDER BY clause to the query (SQLite supports ORDER BY in DELETE with LIMIT)
+     */
+    orderBy(column: keyof T, direction?: OrderDirection): DeleteBuilder<T>;
+    /**
+     * Set LIMIT for the query (SQLite supports LIMIT in DELETE)
+     */
+    limit(count: number): DeleteBuilder<T>;
+    /**
+     * Build the SQL query and parameters
+     */
+    private buildQuery;
+    /**
+     * Get or create a cached prepared statement
+     */
+    private getStatement;
+    /**
+     * Execute the DELETE query and return the number of deleted records
+     */
+    run(): number;
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL(): {
+        sql: string;
+        params: SQLQueryBindings[];
+    };
+}
+//# sourceMappingURL=delete-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete-builder.d.ts","sourceRoot":"","sources":["../src/delete-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EACV,kBAAkB,EAElB,cAAc,EACd,gBAAgB,EAChB,cAAc,EAEf,MAAM,SAAS,CAAA;AAGhB;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,cAAc,CAAiC;gBAGrD,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC/C,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAUlC;;;;OAIG;IACH,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAiBhG;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC;IAiBlG;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAE,cAAsB,GAAG,aAAa,CAAC,CAAC,CAAC;IAK7E;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAKtC;;OAEG;IACH,OAAO,CAAC,UAAU;IAsClB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,GAAG,IAAI,MAAM;IASb;;OAEG;IACH,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;KAAE;CAGrD"}

package/dist/delete-builder.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteBuilder = void 0;
+const where_builder_1 = require("./where-builder");
+/**
+ * DeleteBuilder<T> - A fluent query builder for constructing DELETE queries
+ * Queries are only executed when .run() is called
+ */
+class DeleteBuilder {
+    db;
+    tableName;
+    _where = {};
+    _orConditions = [];
+    _orderBy = [];
+    _limit;
+    statementCache;
+    constructor(db, tableName, statementCache, initialWhere) {
+        this.db = db;
+        this.tableName = tableName;
+        this.statementCache = statementCache;
+        if (initialWhere) {
+            this._where = { ...initialWhere };
+        }
+    }
+    where(conditionsOrColumn, operator, value) {
+        if (typeof conditionsOrColumn === 'string' && operator !== undefined && value !== undefined) {
+            // Called as where(column, operator, value)
+            const condition = (0, where_builder_1.operatorToCondition)(operator, value);
+            this._where = { ...this._where, [conditionsOrColumn]: condition };
+        }
+        else {
+            // Called as where(conditions)
+            this._where = { ...this._where, ...conditionsOrColumn };
+        }
+        return this;
+    }
+    orWhere(conditionsOrColumn, operator, value) {
+        if (typeof conditionsOrColumn === 'string' && operator !== undefined && value !== undefined) {
+            // Called as orWhere(column, operator, value)
+            const condition = (0, where_builder_1.operatorToCondition)(operator, value);
+            this._orConditions.push({ [conditionsOrColumn]: condition });
+        }
+        else {
+            // Called as orWhere(conditions)
+            this._orConditions.push(conditionsOrColumn);
+        }
+        return this;
+    }
+    /**
+     * Add ORDER BY clause to the query (SQLite supports ORDER BY in DELETE with LIMIT)
+     */
+    orderBy(column, direction = 'ASC') {
+        this._orderBy.push({ column, direction });
+        return this;
+    }
+    /**
+     * Set LIMIT for the query (SQLite supports LIMIT in DELETE)
+     */
+    limit(count) {
+        this._limit = count;
+        return this;
+    }
+    /**
+     * Build the SQL query and parameters
+     */
+    buildQuery() {
+        const params = [];
+        let sql = `DELETE FROM "${this.tableName}"`;
+        // WHERE clause
+        const whereClause = (0, where_builder_1.buildWhereClause)(this._where, params);
+        const orClauses = this._orConditions.map((orCond) => {
+            const orParams = [];
+            const clause = (0, where_builder_1.buildWhereClause)(orCond, orParams);
+            params.push(...orParams);
+            return `(${clause})`;
+        });
+        if (whereClause || orClauses.length > 0) {
+            if (whereClause && orClauses.length > 0) {
+                // Combine AND conditions with OR conditions: (AND conditions) OR (OR condition 1) OR (OR condition 2)
+                sql += ` WHERE (${whereClause}) OR ${orClauses.join(' OR ')}`;
+            }
+            else if (orClauses.length > 0) {
+                sql += ` WHERE ${orClauses.join(' OR ')}`;
+            }
+            else {
+                sql += ` WHERE ${whereClause}`;
+            }
+        }
+        // ORDER BY clause (SQLite supports this with LIMIT)
+        if (this._orderBy.length > 0) {
+            const orderClauses = this._orderBy.map((o) => `"${String(o.column)}" ${o.direction || 'ASC'}`);
+            sql += ` ORDER BY ${orderClauses.join(', ')}`;
+        }
+        // LIMIT clause
+        if (this._limit !== undefined) {
+            sql += ` LIMIT ${this._limit}`;
+        }
+        return { sql, params };
+    }
+    /**
+     * 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;
+    }
+    /**
+     * Execute the DELETE query and return the number of deleted records
+     */
+    run() {
+        const { sql, params } = this.buildQuery();
+        const stmt = this.getStatement(sql);
+        const info = stmt.run(...params);
+        // Use the changes from stmt.run() return value (more efficient)
+        return info.changes;
+    }
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL() {
+        return this.buildQuery();
+    }
+}
+exports.DeleteBuilder = DeleteBuilder;
+//# sourceMappingURL=delete-builder.js.map

package/dist/delete-builder.js.map

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