@iamkirbki/database-handler-core 3.1.4 → 4.0.0

package/dist/types/model.d.ts.map

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

package/dist/types/model.js

@@ -0,0 +1,2 @@
+/** Model configuration and types */
+export {};

package/dist/types/table.d.ts

@@ -1,5 +1,5 @@
-import { QueryWhereParameters } from "index";
-import Table from "../Table.js";
+import { QueryValues, QueryWhereParameters } from "../index";
+import Table from "../base/Table.js";
 export type TableColumnInfo = {
     cid: number;
     name: string;
@@ -8,6 +8,9 @@ export type TableColumnInfo = {
     dflt_value: unknown;
     pk: number;
 };
+export type columnType = {
+    [key: string]: QueryValues;
+};
 export type ReadableTableColumnInfo = {
     name: string;
     type: string;
@@ -25,5 +28,6 @@ export type Join = {
     fromTable: Table;
     joinType: 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
     on: QueryWhereParameters | QueryWhereParameters[];
+    where?: QueryWhereParameters | QueryWhereParameters[];
 };
 //# sourceMappingURL=table.d.ts.map

package/dist/types/table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/types/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,MAAM,aAAa,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACf,SAAS,EAAE,KAAK,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,EAAE,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;CACrD,CAAA"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/types/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,MAAM,kBAAkB,CAAC;AAErC,MAAM,MAAM,eAAe,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACf,SAAS,EAAE,KAAK,CAAC;IACjB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,EAAE,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IAClD,KAAK,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;CACzD,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamkirbki/database-handler-core",
-  "version": "3.1.4",
+  "version": "4.0.0",
   "author": "iamkirbki",
   "description": "Core database abstractions and interfaces",
   "license": "ISC",
@@ -19,13 +19,14 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/IamKirbki/bettersqlite3-handler.git",
+    "url": "https://github.com/IamKirbki/npm-database-handler.git",
     "directory": "packages/core"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "tsc --build && tsc-alias"
   },
   "devDependencies": {
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "tsc-alias": "^1.8.16"
   }
 }

package/dist/Database.d.ts

@@ -1,98 +0,0 @@
-import Table from "./Table.js";
-import Query from "./Query.js";
-import IDatabaseAdapter from "./interfaces/IDatabaseAdapter.js";
-/**
- * Main Database class for interacting with SQLite databases
- *
- * @example
- * ```typescript
- * import { Database } from 'kirbkis-bettersqlite3-handler';
- *
- * // Create or open a database
- * const db = new Database('./myapp.db');
- *
- * // Access a table
- * const users = db.Table('users');
- *
- * // Create a new table
- * const posts = db.CreateTable('posts');
- * ```
- */
-export default class Database {
-    adapter: IDatabaseAdapter;
-    /**
-     * Creates a new Database instance
-     *
-     * @param dbPath - Path to the SQLite database file (absolute or relative to process.cwd())
-     *
-     * @example
-     * ```typescript
-     * // Relative path
-     * const db = new Database('./data/app.db');
-     *
-     * // Absolute path
-     * const db = new Database('/var/data/app.db');
-     *
-     * // In-memory database
-     * const db = new Database(':memory:');
-     * ```
-     */
-    constructor(adapter: IDatabaseAdapter);
-    /**
-     * Get a Table instance to interact with an existing table
-     *
-     * @param name - Name of the table
-     * @returns Table instance for querying and manipulating data
-     * @throws Error if the table does not exist
-     *
-     * @example
-     * ```typescript
-     * const users = await db.Table('users');
-     * const allUsers = await users.Records();
-     * ```
-     */
-    Table(name: string): Promise<Table>;
-    /**
-     * Create a new table with specified columns
-     * Validates table name, column names, and column types before creation
-     * Uses CREATE TABLE IF NOT EXISTS to avoid errors if table already exists
-     *
-     * @param name - Name of the table to create
-     * @param columns - Object mapping column names to their type definitions
-     * @returns Table instance for the newly created table
-     * @throws Error if table name, column names, or column types are invalid
-     *
-     * @example
-     * ```typescript
-     * // Create a users table
-     * const users = await db.CreateTable('users', {
-     *   id: 'INTEGER PRIMARY KEY AUTOINCREMENT',
-     *   name: 'TEXT NOT NULL',
-     *   email: 'TEXT UNIQUE',
-     *   age: 'INTEGER',
-     *   created_at: 'DATETIME DEFAULT CURRENT_TIMESTAMP'
-     * });
-     *
-     * // Table is now ready to use
-     * await users.Insert({ name: 'John', email: 'john@example.com', age: 30 });
-     * ```
-     */
-    CreateTable(name: string, columns: object): Promise<Table>;
-    /**
-     * Create a Query object for executing custom SQL queries
-     *
-     * @param table - Table object for validation and context
-     * @param query - The SQL query string with ? placeholders
-     * @returns Query instance for executing the query
-     *
-     * @example
-     * ```typescript
-     * const users = db.Table('users');
-     * const query = db.Query(users, 'SELECT * FROM users WHERE age > ? AND status = ?');
-     * query.Parameters = { age: 18, status: 'active' };
-     * const results = query.All();
-     * ```
-     */
-    Query(table: Table, query: string): Query;
-}
-//# sourceMappingURL=Database.d.ts.map

package/dist/Database.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../src/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,gBAAgB,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,OAAO,QAAQ;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAEjC;;;;;;;;;;;;;;;;OAgBG;gBACS,OAAO,EAAE,gBAAgB;IAIrC;;;;;;;;;;;;OAYG;IACU,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKhD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAmBvE;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;CAGjD"}

package/dist/Database.js

@@ -1,126 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import Table from "./Table.js";
-import Query from "./Query.js";
-/**
- * Main Database class for interacting with SQLite databases
- *
- * @example
- * ```typescript
- * import { Database } from 'kirbkis-bettersqlite3-handler';
- *
- * // Create or open a database
- * const db = new Database('./myapp.db');
- *
- * // Access a table
- * const users = db.Table('users');
- *
- * // Create a new table
- * const posts = db.CreateTable('posts');
- * ```
- */
-export default class Database {
-    /**
-     * Creates a new Database instance
-     *
-     * @param dbPath - Path to the SQLite database file (absolute or relative to process.cwd())
-     *
-     * @example
-     * ```typescript
-     * // Relative path
-     * const db = new Database('./data/app.db');
-     *
-     * // Absolute path
-     * const db = new Database('/var/data/app.db');
-     *
-     * // In-memory database
-     * const db = new Database(':memory:');
-     * ```
-     */
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    /**
-     * Get a Table instance to interact with an existing table
-     *
-     * @param name - Name of the table
-     * @returns Table instance for querying and manipulating data
-     * @throws Error if the table does not exist
-     *
-     * @example
-     * ```typescript
-     * const users = await db.Table('users');
-     * const allUsers = await users.Records();
-     * ```
-     */
-    Table(name) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield Table.create(name, this.adapter);
-        });
-    }
-    // TODO Make primary key required
-    /**
-     * Create a new table with specified columns
-     * Validates table name, column names, and column types before creation
-     * Uses CREATE TABLE IF NOT EXISTS to avoid errors if table already exists
-     *
-     * @param name - Name of the table to create
-     * @param columns - Object mapping column names to their type definitions
-     * @returns Table instance for the newly created table
-     * @throws Error if table name, column names, or column types are invalid
-     *
-     * @example
-     * ```typescript
-     * // Create a users table
-     * const users = await db.CreateTable('users', {
-     *   id: 'INTEGER PRIMARY KEY AUTOINCREMENT',
-     *   name: 'TEXT NOT NULL',
-     *   email: 'TEXT UNIQUE',
-     *   age: 'INTEGER',
-     *   created_at: 'DATETIME DEFAULT CURRENT_TIMESTAMP'
-     * });
-     *
-     * // Table is now ready to use
-     * await users.Insert({ name: 'John', email: 'john@example.com', age: 30 });
-     * ```
-     */
-    CreateTable(name, columns) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const names = Object.keys(columns || {}).map((colName) => {
-                return colName;
-            });
-            const colsDef = names.map(colName => {
-                const colType = columns[colName];
-                return `"${colName}" ${colType}`;
-            }).join(", ");
-            const stmt = yield this.adapter.prepare(`CREATE TABLE IF NOT EXISTS "${name}" (${colsDef});`);
-            yield stmt.run();
-            return yield Table.create(name, this.adapter, true);
-        });
-    }
-    /**
-     * Create a Query object for executing custom SQL queries
-     *
-     * @param table - Table object for validation and context
-     * @param query - The SQL query string with ? placeholders
-     * @returns Query instance for executing the query
-     *
-     * @example
-     * ```typescript
-     * const users = db.Table('users');
-     * const query = db.Query(users, 'SELECT * FROM users WHERE age > ? AND status = ?');
-     * query.Parameters = { age: 18, status: 'active' };
-     * const results = query.All();
-     * ```
-     */
-    Query(table, query) {
-        return new Query(table, query, this.adapter);
-    }
-}

package/dist/Query.d.ts

@@ -1,143 +0,0 @@
-import Table from "./Table.js";
-import { QueryCondition } from "./types/index.js";
-import Record from "./Record.js";
-import IDatabaseAdapter from "./interfaces/IDatabaseAdapter.js";
-/**
- * Query class for executing custom SQL queries
- *
- * Features:
- * - Supports named parameters using @fieldName syntax
- * - Provides type-safe query execution (Run, All, Get)
- * - Transaction support for atomic multi-insert/update operations
- *
- * @example
- * ```typescript
- * const users = db.Table('users');
- *
- * // SELECT query with parameters
- * const query = db.Query(users, 'SELECT * FROM users WHERE age > @age AND status = @status');
- * query.Parameters = { age: 18, status: 'active' };
- * const results = query.All();
- *
- * // INSERT query
- * const insert = db.Query(users, 'INSERT INTO users (name, email) VALUES (@name, @email)');
- * insert.Parameters = { name: 'John', email: 'john@example.com' };
- * insert.Run();
- *
- * // Transaction for multiple inserts
- * insert.Transaction([
- *   { name: 'John', email: 'john@example.com' },
- *   { name: 'Jane', email: 'jane@example.com' }
- * ]);
- * ```
- */
-export default class Query {
-    readonly Table: Table;
-    private readonly adapter;
-    private query;
-    private _parameters;
-    get Parameters(): QueryCondition;
-    set Parameters(value: QueryCondition);
-    /**
-     * Creates a Query instance (usually called via db.Query() method)
-     *
-     * @param Table - Table instance for validation context
-     * @param Query - SQL query string with @fieldName placeholders for parameters
-     * @param DB - Database connection instance
-     *
-     * @example
-     * ```typescript
-     * // Direct instantiation (not recommended - use db.Query() instead)
-     * const query = new Query(
-     *   usersTable,
-     *   'SELECT * FROM users WHERE id = @id',
-     *   db
-     * );
-     * query.Parameters = { id: 1 };
-     *
-     * // Recommended approach
-     * const query = db.Query(usersTable, 'SELECT * FROM users WHERE id = @id');
-     * query.Parameters = { id: 1 };
-     * ```
-     */
-    constructor(Table: Table, Query: string, adapter: IDatabaseAdapter);
-    /**
-     * Execute a query that modifies data (INSERT, UPDATE, DELETE)
-     *
-     * @template Type - Expected return type (typically { lastInsertRowid: number, changes: number })
-     * @returns Result object with lastInsertRowid and changes count
-     *
-     * @example
-     * ```typescript
-     * // INSERT query
-     * const query = db.Query(users, 'INSERT INTO users (name, age) VALUES (@name, @age)');
-     * query.Parameters = { name: 'John', age: 30 };
-     * const result = query.Run<{ lastInsertRowid: number, changes: number }>();
-     * console.log(`Inserted ID: ${result.lastInsertRowid}`);
-     *
-     * // UPDATE query
-     * const update = db.Query(users, 'UPDATE users SET age = @age WHERE id = @id');
-     * update.Parameters = { age: 31, id: 1 };
-     * const updateResult = update.Run<{ changes: number }>();
-     * console.log(`Updated ${updateResult.changes} rows`);
-     * ```
-     */
-    Run<Type>(): Promise<Type>;
-    /**
-     * Execute a SELECT query and return all matching rows as Record objects
-     * Each row is wrapped in a Record instance for convenient updates/deletes
-     *
-     * @template Type - Expected row type
-     * @returns Array of Record objects containing the query results
-     *
-     * @example
-     * ```typescript
-     * interface User {
-     *   id: number;
-     *   name: string;
-     *   age: number;
-     * }
-     *
-     * const query = db.Query(users, 'SELECT * FROM users WHERE age > @age');
-     * query.Parameters = { age: 18 };
-     * const results = query.All<User>();
-     *
-     * // Each result is a Record object
-     * results.forEach(user => {
-     *   console.log(user.values); // { id: 1, name: 'John', age: 30 }
-     *   user.Update({ age: 31 }); // Can update directly
-     * });
-     * ```
-     */
-    All<Type>(): Promise<Record<Type>[]>;
-    private convertParamsToObject;
-    private convertIdToString;
-    /**
-     * Execute a SELECT query and return the first matching row as a Record object
-     * Returns undefined if no rows match the query
-     *
-     * @template Type - Expected row type
-     * @returns Single Record object or undefined if no match found
-     *
-     * @example
-     * ```typescript
-     * interface User {
-     *   id: number;
-     *   name: string;
-     *   email: string;
-     * }
-     *
-     * const query = db.Query(users, 'SELECT * FROM users WHERE id = @id');
-     * query.Parameters = { id: 1 };
-     * const user = query.Get<User>();
-     *
-     * if (user) {
-     *   console.log(user.values); // { id: 1, name: 'John', email: 'john@example.com' }
-     *   user.Update({ email: 'newemail@example.com' });
-     * }
-     * ```
-     */
-    Get<Type>(): Promise<Record<Type> | undefined>;
-    Transaction(paramList: QueryCondition[]): Promise<void>;
-}
-//# sourceMappingURL=Query.d.ts.map

package/dist/Query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Query.d.ts","sourceRoot":"","sources":["../src/Query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAwB,MAAM,kBAAkB,CAAC;AACxE,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,gBAAgB,MAAM,kCAAkC,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,SAAgB,KAAK,EAAE,KAAK,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAsB;IAEzC,IAAW,UAAU,IAAI,cAAc,CAEtC;IAED,IAAW,UAAU,CAAC,KAAK,EAAE,cAAc,EAE1C;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;IAMlE;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC;IAKvC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAMjD,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACU,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAM9C,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBrE"}

package/dist/Query.js

@@ -1,205 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import Record from "./Record.js";
-/**
- * Query class for executing custom SQL queries
- *
- * Features:
- * - Supports named parameters using @fieldName syntax
- * - Provides type-safe query execution (Run, All, Get)
- * - Transaction support for atomic multi-insert/update operations
- *
- * @example
- * ```typescript
- * const users = db.Table('users');
- *
- * // SELECT query with parameters
- * const query = db.Query(users, 'SELECT * FROM users WHERE age > @age AND status = @status');
- * query.Parameters = { age: 18, status: 'active' };
- * const results = query.All();
- *
- * // INSERT query
- * const insert = db.Query(users, 'INSERT INTO users (name, email) VALUES (@name, @email)');
- * insert.Parameters = { name: 'John', email: 'john@example.com' };
- * insert.Run();
- *
- * // Transaction for multiple inserts
- * insert.Transaction([
- *   { name: 'John', email: 'john@example.com' },
- *   { name: 'Jane', email: 'jane@example.com' }
- * ]);
- * ```
- */
-export default class Query {
-    get Parameters() {
-        return this._parameters;
-    }
-    set Parameters(value) {
-        this._parameters = this.convertParamsToObject(value);
-    }
-    /**
-     * Creates a Query instance (usually called via db.Query() method)
-     *
-     * @param Table - Table instance for validation context
-     * @param Query - SQL query string with @fieldName placeholders for parameters
-     * @param DB - Database connection instance
-     *
-     * @example
-     * ```typescript
-     * // Direct instantiation (not recommended - use db.Query() instead)
-     * const query = new Query(
-     *   usersTable,
-     *   'SELECT * FROM users WHERE id = @id',
-     *   db
-     * );
-     * query.Parameters = { id: 1 };
-     *
-     * // Recommended approach
-     * const query = db.Query(usersTable, 'SELECT * FROM users WHERE id = @id');
-     * query.Parameters = { id: 1 };
-     * ```
-     */
-    constructor(Table, Query, adapter) {
-        this.query = "";
-        this._parameters = {};
-        this.Table = Table;
-        this.query = Query;
-        this.adapter = adapter;
-    }
-    /**
-     * Execute a query that modifies data (INSERT, UPDATE, DELETE)
-     *
-     * @template Type - Expected return type (typically { lastInsertRowid: number, changes: number })
-     * @returns Result object with lastInsertRowid and changes count
-     *
-     * @example
-     * ```typescript
-     * // INSERT query
-     * const query = db.Query(users, 'INSERT INTO users (name, age) VALUES (@name, @age)');
-     * query.Parameters = { name: 'John', age: 30 };
-     * const result = query.Run<{ lastInsertRowid: number, changes: number }>();
-     * console.log(`Inserted ID: ${result.lastInsertRowid}`);
-     *
-     * // UPDATE query
-     * const update = db.Query(users, 'UPDATE users SET age = @age WHERE id = @id');
-     * update.Parameters = { age: 31, id: 1 };
-     * const updateResult = update.Run<{ changes: number }>();
-     * console.log(`Updated ${updateResult.changes} rows`);
-     * ```
-     */
-    Run() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stmt = yield this.adapter.prepare(this.query);
-            return yield stmt.run(this.Parameters);
-        });
-    }
-    /**
-     * Execute a SELECT query and return all matching rows as Record objects
-     * Each row is wrapped in a Record instance for convenient updates/deletes
-     *
-     * @template Type - Expected row type
-     * @returns Array of Record objects containing the query results
-     *
-     * @example
-     * ```typescript
-     * interface User {
-     *   id: number;
-     *   name: string;
-     *   age: number;
-     * }
-     *
-     * const query = db.Query(users, 'SELECT * FROM users WHERE age > @age');
-     * query.Parameters = { age: 18 };
-     * const results = query.All<User>();
-     *
-     * // Each result is a Record object
-     * results.forEach(user => {
-     *   console.log(user.values); // { id: 1, name: 'John', age: 30 }
-     *   user.Update({ age: 31 }); // Can update directly
-     * });
-     * ```
-     */
-    All() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stmt = yield this.adapter.prepare(this.query);
-            const results = yield stmt.all(this.Parameters);
-            return results.map(res => new Record(res, this.adapter, this.Table));
-        });
-    }
-    convertParamsToObject(params) {
-        const paramObject = {};
-        if (Array.isArray(params)) {
-            params.forEach(param => {
-                paramObject[param.column] = param.value;
-            });
-        }
-        else {
-            Object.assign(paramObject, params);
-        }
-        return this.convertIdToString(paramObject);
-    }
-    convertIdToString(params) {
-        if (params.id && typeof params.id === 'number') {
-            return Object.assign(Object.assign({}, params), { id: params.id.toString() });
-        }
-        return params;
-    }
-    /**
-     * Execute a SELECT query and return the first matching row as a Record object
-     * Returns undefined if no rows match the query
-     *
-     * @template Type - Expected row type
-     * @returns Single Record object or undefined if no match found
-     *
-     * @example
-     * ```typescript
-     * interface User {
-     *   id: number;
-     *   name: string;
-     *   email: string;
-     * }
-     *
-     * const query = db.Query(users, 'SELECT * FROM users WHERE id = @id');
-     * query.Parameters = { id: 1 };
-     * const user = query.Get<User>();
-     *
-     * if (user) {
-     *   console.log(user.values); // { id: 1, name: 'John', email: 'john@example.com' }
-     *   user.Update({ email: 'newemail@example.com' });
-     * }
-     * ```
-     */
-    Get() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stmt = yield this.adapter.prepare(this.query);
-            const results = yield stmt.get(this.Parameters);
-            return results ? new Record(results, this.adapter, this.Table) : undefined;
-        });
-    }
-    Transaction(paramList) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stmt = yield this.adapter.prepare(this.query);
-            const transactionFn = yield this.adapter.transaction((paramsArray) => {
-                for (const params of paramsArray) {
-                    // Use runSync for better-sqlite3 transactions (must be synchronous)
-                    // For other adapters, this method should be implemented appropriately
-                    if (stmt.runSync) {
-                        stmt.runSync(params);
-                    }
-                    else {
-                        // Fallback: call run without await (may not work for all adapters)
-                        stmt.run(params);
-                    }
-                }
-            });
-            transactionFn(paramList);
-        });
-    }
-}