bettersqlkeza 1.0.0

package/dist/query-builder.js

@@ -0,0 +1,298 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryBuilder = void 0;
+const where_builder_1 = require("./where-builder");
+const result_proxy_1 = require("./result-proxy");
+/**
+ * QueryBuilder<T> - A fluent query builder for constructing SQL queries
+ * Queries are only executed when .all(), .first(), or .run() are called
+ */
+class QueryBuilder {
+    db;
+    tableName;
+    _where = {};
+    _orConditions = [];
+    _orderBy = [];
+    _limit;
+    _offset;
+    _select = ['*'];
+    _distinct = false;
+    _groupBy = [];
+    _having = {};
+    statementCache;
+    primaryKey;
+    constructor(db, tableName, statementCache, initialWhere, primaryKey) {
+        this.db = db;
+        this.tableName = tableName;
+        this.statementCache = statementCache;
+        this.primaryKey = primaryKey ?? null;
+        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
+     */
+    orderBy(column, direction = 'ASC') {
+        this._orderBy.push({ column, direction });
+        return this;
+    }
+    /**
+     * Set LIMIT for the query
+     */
+    limit(count) {
+        this._limit = count;
+        return this;
+    }
+    /**
+     * Set OFFSET for the query
+     */
+    offset(count) {
+        this._offset = count;
+        return this;
+    }
+    /**
+     * Select specific columns
+     */
+    select(...columns) {
+        this._select = columns;
+        return this;
+    }
+    /**
+     * Select DISTINCT rows
+     */
+    distinct() {
+        this._distinct = true;
+        return this;
+    }
+    /**
+     * Add GROUP BY clause
+     */
+    groupBy(...columns) {
+        this._groupBy = columns;
+        return this;
+    }
+    /**
+     * Add HAVING clause (for use with GROUP BY)
+     */
+    having(conditions) {
+        this._having = { ...this._having, ...conditions };
+        return this;
+    }
+    /**
+     * Build the SQL query and parameters
+     */
+    buildQuery() {
+        const params = [];
+        const selectClause = this._distinct ? 'SELECT DISTINCT' : 'SELECT';
+        let sql = `${selectClause} ${this._select.join(', ')} 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}`;
+            }
+        }
+        // GROUP BY clause
+        if (this._groupBy.length > 0) {
+            const groupCols = this._groupBy.map((c) => `"${String(c)}"`);
+            sql += ` GROUP BY ${groupCols.join(', ')}`;
+        }
+        // HAVING clause
+        const havingClause = (0, where_builder_1.buildWhereClause)(this._having, params);
+        if (havingClause) {
+            sql += ` HAVING ${havingClause}`;
+        }
+        // ORDER BY clause
+        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}`;
+        }
+        // OFFSET clause
+        if (this._offset !== undefined) {
+            sql += ` OFFSET ${this._offset}`;
+        }
+        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 query and return all matching rows
+     */
+    all() {
+        const { sql, params } = this.buildQuery();
+        const stmt = this.getStatement(sql);
+        return stmt.all(...params);
+    }
+    /**
+     * Execute query and return the first matching row with chainable methods
+     * The result has both the data properties AND methods like delete(), update(), save()
+     * @example
+     * const user = User.query().where("id", "=", 1).first();
+     * user?.name; // Access property
+     * user?.delete(); // Delete the record
+     * user?.update({ name: "New Name" }); // Update the record
+     */
+    first() {
+        this._limit = 1;
+        const { sql, params } = this.buildQuery();
+        const stmt = this.getStatement(sql);
+        const data = stmt.get(...params) || null;
+        return (0, result_proxy_1.createResultProxy)(this.db, this.tableName, this.statementCache, this.primaryKey, data);
+    }
+    /**
+     * Execute query and return the first matching row or throw an error
+     * The result has both the data properties AND methods like delete(), update(), save()
+     */
+    firstOrFail() {
+        const result = this.first();
+        if (result === null) {
+            throw new Error(`No record found in table "${this.tableName}"`);
+        }
+        return result;
+    }
+    /**
+     * Check if any records exist matching the query
+     */
+    exists() {
+        const { sql, params } = this.buildQuery();
+        const existsSql = `SELECT EXISTS(${sql}) as exists_result`;
+        const stmt = this.db.prepare(existsSql);
+        const result = stmt.get(...params);
+        return result.exists_result === 1;
+    }
+    /**
+     * Get array of values for a single column
+     */
+    pluck(column) {
+        this._select = [String(column)];
+        const results = this.all();
+        return results.map((row) => row[column]);
+    }
+    /**
+     * Execute query and return raw results (alias for all())
+     */
+    run() {
+        return this.all();
+    }
+    /**
+     * Execute query and return all matching rows (alias for all())
+     */
+    get() {
+        return this.all();
+    }
+    /**
+     * Get the count of matching records
+     */
+    count() {
+        const params = [];
+        let sql = `SELECT COUNT(*) as count FROM "${this.tableName}"`;
+        const whereClause = (0, where_builder_1.buildWhereClause)(this._where, params);
+        if (whereClause) {
+            sql += ` WHERE ${whereClause}`;
+        }
+        const stmt = this.db.prepare(sql);
+        const result = stmt.get(...params);
+        return result.count;
+    }
+    /**
+     * Get the sum of a column
+     */
+    sum(column) {
+        return this.aggregate('SUM', column);
+    }
+    /**
+     * Get the average of a column
+     */
+    avg(column) {
+        return this.aggregate('AVG', column);
+    }
+    /**
+     * Get the minimum value of a column
+     */
+    min(column) {
+        return this.aggregate('MIN', column);
+    }
+    /**
+     * Get the maximum value of a column
+     */
+    max(column) {
+        return this.aggregate('MAX', column);
+    }
+    /**
+     * Execute an aggregate function
+     */
+    aggregate(fn, column) {
+        const params = [];
+        let sql = `SELECT ${fn}("${String(column)}") as result FROM "${this.tableName}"`;
+        const whereClause = (0, where_builder_1.buildWhereClause)(this._where, params);
+        if (whereClause) {
+            sql += ` WHERE ${whereClause}`;
+        }
+        if (this._groupBy.length > 0) {
+            const groupCols = this._groupBy.map((c) => `"${String(c)}"`);
+            sql += ` GROUP BY ${groupCols.join(', ')}`;
+        }
+        const stmt = this.db.prepare(sql);
+        const result = stmt.get(...params);
+        return result.result ?? 0;
+    }
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL() {
+        return this.buildQuery();
+    }
+}
+exports.QueryBuilder = QueryBuilder;
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

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

package/dist/raw-query-builder.d.ts

@@ -0,0 +1,70 @@
+import type Database from 'better-sqlite3';
+import type { SQLQueryBindings } from './types';
+import { ResultProxy } from './result-proxy';
+/**
+ * RawQueryBuilder<T> - Executes raw SQL queries and returns results with chainable methods
+ * Used when passing a raw SQL string to Model.query()
+ *
+ * @warning This class executes raw SQL queries. Always use parameterized queries
+ * with the second argument to prevent SQL injection:
+ * ```typescript
+ * // Safe - using parameters
+ * User.query("SELECT * FROM user WHERE id = ?", [userId])
+ *
+ * // UNSAFE - string interpolation is vulnerable to SQL injection
+ * User.query(`SELECT * FROM user WHERE id = ${userId}`) // DON'T DO THIS
+ * ```
+ */
+export declare class RawQueryBuilder<T extends Record<string, unknown>> {
+    private db;
+    private tableName;
+    private statementCache;
+    private primaryKey;
+    private rawSql;
+    private params;
+    constructor(db: Database.Database, tableName: string, statementCache: Map<string, Database.Statement>, primaryKey: string | null, rawSql: string, params?: SQLQueryBindings[]);
+    /**
+     * Get or create a cached prepared statement
+     */
+    private getStatement;
+    /**
+     * Execute query and return all matching rows
+     */
+    all(): T[];
+    /**
+     * Execute query and return all matching rows (alias for all())
+     */
+    get(): T[];
+    /**
+     * Execute query and return all matching rows (alias for all())
+     */
+    run(): T[];
+    /**
+     * Execute query and return the first matching row with chainable methods
+     */
+    first(): (T & ResultProxy<T>) | null;
+    /**
+     * Execute query and return the first matching row or throw an error
+     */
+    firstOrFail(): T & ResultProxy<T>;
+    /**
+     * Check if any records exist matching the query
+     */
+    exists(): boolean;
+    /**
+     * Get the count of matching records
+     */
+    count(): number;
+    /**
+     * Get array of values for a single column
+     */
+    pluck<K extends keyof T>(column: K): T[K][];
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL(): {
+        sql: string;
+        params: SQLQueryBindings[];
+    };
+}
+//# sourceMappingURL=raw-query-builder.d.ts.map

package/dist/raw-query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-query-builder.d.ts","sourceRoot":"","sources":["../src/raw-query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAqB,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAGhC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,EAAE;IAU7B;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,GAAG,IAAI,CAAC,EAAE;IAKV;;OAEG;IACH,GAAG,IAAI,CAAC,EAAE;IAIV;;OAEG;IACH,GAAG,IAAI,CAAC,EAAE;IAIV;;OAEG;IACH,KAAK,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAMpC;;OAEG;IACH,WAAW,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAUjC;;OAEG;IACH,MAAM,IAAI,OAAO;IAOjB;;OAEG;IACH,KAAK,IAAI,MAAM;IAQf;;OAEG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;IAK3C;;OAEG;IACH,KAAK,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;KAAE;CAGrD"}

package/dist/raw-query-builder.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RawQueryBuilder = void 0;
+const result_proxy_1 = require("./result-proxy");
+/**
+ * RawQueryBuilder<T> - Executes raw SQL queries and returns results with chainable methods
+ * Used when passing a raw SQL string to Model.query()
+ *
+ * @warning This class executes raw SQL queries. Always use parameterized queries
+ * with the second argument to prevent SQL injection:
+ * ```typescript
+ * // Safe - using parameters
+ * User.query("SELECT * FROM user WHERE id = ?", [userId])
+ *
+ * // UNSAFE - string interpolation is vulnerable to SQL injection
+ * User.query(`SELECT * FROM user WHERE id = ${userId}`) // DON'T DO THIS
+ * ```
+ */
+class RawQueryBuilder {
+    db;
+    tableName;
+    statementCache;
+    primaryKey;
+    rawSql;
+    params;
+    constructor(db, tableName, statementCache, primaryKey, rawSql, params) {
+        this.db = db;
+        this.tableName = tableName;
+        this.statementCache = statementCache;
+        this.primaryKey = primaryKey;
+        this.rawSql = rawSql;
+        this.params = 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 query and return all matching rows
+     */
+    all() {
+        const stmt = this.getStatement(this.rawSql);
+        return stmt.all(...this.params);
+    }
+    /**
+     * Execute query and return all matching rows (alias for all())
+     */
+    get() {
+        return this.all();
+    }
+    /**
+     * Execute query and return all matching rows (alias for all())
+     */
+    run() {
+        return this.all();
+    }
+    /**
+     * Execute query and return the first matching row with chainable methods
+     */
+    first() {
+        const stmt = this.getStatement(this.rawSql);
+        const data = stmt.get(...this.params) || null;
+        return (0, result_proxy_1.createResultProxy)(this.db, this.tableName, this.statementCache, this.primaryKey, data);
+    }
+    /**
+     * Execute query and return the first matching row or throw an error
+     */
+    firstOrFail() {
+        const result = this.first();
+        if (result === null) {
+            // Truncate SQL for error message if it's too long
+            const sqlPreview = this.rawSql.length > 100 ? this.rawSql.substring(0, 100) + '...' : this.rawSql;
+            throw new Error(`No record found for query: ${sqlPreview}`);
+        }
+        return result;
+    }
+    /**
+     * Check if any records exist matching the query
+     */
+    exists() {
+        const existsSql = `SELECT EXISTS(${this.rawSql}) as exists_result`;
+        const stmt = this.db.prepare(existsSql);
+        const result = stmt.get(...this.params);
+        return result.exists_result === 1;
+    }
+    /**
+     * Get the count of matching records
+     */
+    count() {
+        // Wrap the raw SQL to get a count
+        const countSql = `SELECT COUNT(*) as count FROM (${this.rawSql})`;
+        const stmt = this.db.prepare(countSql);
+        const result = stmt.get(...this.params);
+        return result.count;
+    }
+    /**
+     * Get array of values for a single column
+     */
+    pluck(column) {
+        const results = this.all();
+        return results.map((row) => row[column]);
+    }
+    /**
+     * Get the SQL string for debugging
+     */
+    toSQL() {
+        return { sql: this.rawSql, params: this.params };
+    }
+}
+exports.RawQueryBuilder = RawQueryBuilder;
+//# sourceMappingURL=raw-query-builder.js.map

package/dist/raw-query-builder.js.map

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

package/dist/result-proxy.d.ts

@@ -0,0 +1,63 @@
+import type Database from 'better-sqlite3';
+import type { UpdateData } from './types';
+/**
+ * ResultProxy<T> - Wraps a query result with chainable methods
+ * Allows patterns like: Model.query().where(...).first().delete()
+ * While still allowing property access: Model.query().where(...).first().propertyName
+ */
+export declare class ResultProxy<T extends Record<string, unknown>> {
+    private db;
+    private tableName;
+    private statementCache;
+    private primaryKey;
+    private _data;
+    constructor(db: Database.Database, tableName: string, statementCache: Map<string, Database.Statement>, primaryKey: string | null, data: T | null);
+    /**
+     * Get or create a cached prepared statement
+     */
+    private getStatement;
+    /**
+     * Delete the current record from the database
+     * Returns the number of deleted records (0 or 1)
+     */
+    delete(): number;
+    /**
+     * Update the current record in the database
+     * Returns the number of updated records (0 or 1)
+     */
+    update(data: UpdateData<T>): number;
+    /**
+     * Save changes made to the record back to the database
+     * (Re-inserts/updates the full record)
+     * Returns the number of affected records
+     */
+    save(): number;
+    /**
+     * Refresh the record from the database
+     * Returns a new result with the refreshed data and chainable methods
+     */
+    refresh(): (T & ResultProxy<T>) | null;
+    /**
+     * Check if the record exists (is not null)
+     */
+    exists(): boolean;
+    /**
+     * Get the underlying data
+     */
+    toJSON(): T | null;
+    /**
+     * Get the underlying data (alias for toJSON)
+     */
+    getData(): T | null;
+    /**
+     * Check if the result is null
+     */
+    isNull(): boolean;
+}
+/**
+ * Create a ResultProxy that also acts as a Proxy for direct property access
+ * This allows: result.propertyName AND result.delete()
+ * Returns null when data is null to maintain backward compatibility
+ */
+export declare function createResultProxy<T extends Record<string, unknown>>(db: Database.Database, tableName: string, statementCache: Map<string, Database.Statement>, primaryKey: string | null, data: T | null): (T & ResultProxy<T>) | null;
+//# sourceMappingURL=result-proxy.d.ts.map

package/dist/result-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-proxy.d.ts","sourceRoot":"","sources":["../src/result-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAoB,UAAU,EAAE,MAAM,SAAS,CAAA;AAE3D;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,KAAK,CAAU;gBAGrB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,IAAI,EAAE,CAAC,GAAG,IAAI;IAShB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,MAAM,IAAI,MAAM;IAiBhB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM;IAqBnC;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAqBd;;;OAGG;IACH,OAAO,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAatC;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,MAAM,IAAI,CAAC,GAAG,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,CAAC,GAAG,IAAI;IAInB;;OAEG;IACH,MAAM,IAAI,OAAO;CAGlB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,IAAI,EAAE,CAAC,GAAG,IAAI,GACb,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CA8B7B"}