@iamkirbki/database-handler-core 3.1.4 → 4.0.1

package/dist/Table.js

@@ -1,258 +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 Query from "./Query.js";
-import QueryStatementBuilder from "./helpers/QueryStatementBuilder.js";
-/**
- * Table class for interacting with a specific database table
- * Provides methods for querying, inserting, and retrieving table metadata
- *
- * @example
- * ```typescript
- * const users = db.Table('users');
- *
- * // Get all records
- * const allUsers = users.Records();
- *
- * // Get filtered records
- * const activeUsers = users.Records({
- *   where: { status: 'active' }
- * });
- *
- * // Insert a record
- * users.Insert({ name: 'John', email: 'john@example.com' });
- * ```
- */
-export default class Table {
-    /**
-     * Private constructor - use Table.create() instead
-     *
-     * @param name - Name of the table
-     * @param adapter - Database adapter instance
-     */
-    constructor(name, adapter) {
-        this.name = name;
-        this.adapter = adapter;
-    }
-    /**
-     * Create a Table instance (async factory method)
-     *
-     * @param name - Name of the table
-     * @param adapter - Database adapter instance
-     * @param skipValidation - Skip table existence validation (used when creating new tables)
-     * @returns Table instance
-     * @throws Error if the table does not exist in the database
-     */
-    static create(name_1, adapter_1) {
-        return __awaiter(this, arguments, void 0, function* (name, adapter, skipValidation = false) {
-            const table = new Table(name, adapter);
-            if (!skipValidation) {
-                const columns = yield table.TableColumnInformation();
-                if (!columns.length) {
-                    throw new Error(`Table "${name}" does not exist in the database.\nYou might want to use the CreateTable function.`);
-                }
-            }
-            return table;
-        });
-    }
-    /**
-     * Get the name of the table
-     *
-     * @returns The table name
-     */
-    get Name() {
-        return this.name;
-    }
-    /**
-     * Get raw column information from SQLite PRAGMA
-     *
-     * @returns Array of column metadata from SQLite
-     *
-     * @example
-     * ```typescript
-     * const columns = await table.TableColumnInformation();
-     * // [{ cid: 0, name: 'id', type: 'INTEGER', notnull: 0, dflt_value: null, pk: 1 }, ...]
-     * ```
-     */
-    TableColumnInformation() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.adapter.tableColumnInformation(this.name);
-        });
-    }
-    /**
-     * Get readable, formatted column information
-     *
-     * @returns Array of formatted column metadata with readable properties
-     *
-     * @example
-     * ```typescript
-     * const columns = await table.ReadableTableColumnInformation();
-     * // [{ name: 'id', type: 'INTEGER', nullable: false, isPrimaryKey: true, defaultValue: null }, ...]
-     * ```
-     */
-    ReadableTableColumnInformation() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const columns = yield this.TableColumnInformation();
-            return columns.map((col) => ({
-                name: col.name,
-                type: col.type,
-                nullable: col.notnull === 0,
-                isPrimaryKey: col.pk === 1,
-                defaultValue: col.dflt_value,
-            }));
-        });
-    }
-    Drop() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const queryStr = `DROP TABLE IF EXISTS "${this.name}";`;
-            const query = new Query(this, queryStr, this.adapter);
-            yield query.Run();
-        });
-    }
-    /**
-     * Fetch records from the table with optional filtering, ordering, and pagination
-     * @param options Query options for selecting records
-     * @returns Array of records matching the criteria
-     *
-     * @example
-     * // Get all records
-     * table.Records();
-     *
-     * @example
-     * // Get specific columns with filters
-     * table.Records({
-     *   select: 'id, name',
-     *   where: { status: 'active', age: 25 }
-     * });
-     *
-     * @example
-     * // With ordering and pagination
-     * table.Records({
-     *   orderBy: 'created_at DESC',
-     *   limit: 10,
-     *   offset: 20
-     * });
-     */
-    Records(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const queryStr = QueryStatementBuilder.BuildSelect(this, {
-                select: options === null || options === void 0 ? void 0 : options.select,
-                where: options === null || options === void 0 ? void 0 : options.where,
-                orderBy: options === null || options === void 0 ? void 0 : options.orderBy,
-                limit: options === null || options === void 0 ? void 0 : options.limit,
-                offset: options === null || options === void 0 ? void 0 : options.offset,
-            });
-            const query = new Query(this, queryStr, this.adapter);
-            if ((options === null || options === void 0 ? void 0 : options.where) && Object.keys(options.where).length > 0)
-                query.Parameters = options.where;
-            const results = yield query.All();
-            // Wrap each result in a Record object
-            return results;
-        });
-    }
-    /**
-     * Fetch a single record from the table
-     *
-     * @param options - Query options for selecting a record
-     * @param options.select - Columns to select (default: "*")
-     * @param options.where - Filter conditions as key-value pairs
-     * @param options.orderBy - SQL ORDER BY clause (e.g., "created_at DESC")
-     * @returns Single Record instance or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * // Get record by ID
-     * const user = table.Record({ where: { id: 1 } });
-     *
-     * // Get most recent record
-     * const latest = table.Record({ orderBy: 'created_at DESC' });
-     *
-     * // Update the record
-     * user?.update({ status: 'inactive' });
-     * ```
-     */
-    Record(options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const results = yield this.Records({
-                select: options === null || options === void 0 ? void 0 : options.select,
-                where: options === null || options === void 0 ? void 0 : options.where,
-                orderBy: options === null || options === void 0 ? void 0 : options.orderBy,
-                limit: 1
-            });
-            return results[0];
-        });
-    }
-    /**
-     * Get the total count of records in the table
-     *
-     * @returns Number of records in the table
-     *
-     * @example
-     * ```typescript
-     * const totalUsers = table.RecordsCount;
-     * console.log(`Total users: ${totalUsers}`);
-     * ```
-     */
-    RecordsCount() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const stmt = yield this.adapter.prepare(`SELECT COUNT(*) as count FROM "${this.name}";`);
-            const count = yield stmt.get({});
-            return parseInt(count.count) || 0;
-        });
-    }
-    /**
-     * Insert one or multiple records into the table
-     * Validates data types against table schema before insertion
-     *
-     * @param values - Single object or array of objects to insert
-     * @returns Insert result with lastInsertRowid and changes count
-     * @throws Error if values is empty or contains no columns
-     * @throws Error if validation fails (wrong types, missing required fields)
-     *
-     * @example
-     * ```typescript
-     * // Insert single record
-     * const result = table.Insert({ name: 'John', age: 30 });
-     * console.log(`Inserted row ID: ${result.lastInsertRowid}`);
-     *
-     * // Insert multiple records (uses transaction for atomicity)
-     * table.Insert([
-     *   { name: 'John', age: 30 },
-     *   { name: 'Jane', age: 25 }
-     * ]);
-     * ```
-     */
-    Insert(values) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const columns = Object.keys(values);
-            if (columns.length === 0) {
-                throw new Error("Cannot insert record with no columns");
-            }
-            const queryStr = QueryStatementBuilder.BuildInsert(this, values);
-            const query = new Query(this, queryStr, this.adapter);
-            query.Parameters = values;
-            const result = yield query.Run();
-            let recordId;
-            // For PostgreSQL compatibility: use 'id' from values if lastInsertRowid is undefined
-            if (Array.isArray(values)) {
-                recordId = (_a = result === null || result === void 0 ? void 0 : result.lastInsertRowid) !== null && _a !== void 0 ? _a : values.map(v => v.column === 'id' ? v.value : undefined);
-            }
-            else {
-                recordId = (_b = result === null || result === void 0 ? void 0 : result.lastInsertRowid) !== null && _b !== void 0 ? _b : values.id;
-            }
-            if (recordId === undefined) {
-                return undefined;
-            }
-            return this.Record({
-                where: { id: recordId }
-            });
-        });
-    }
-}

package/dist/abstract/Controller.d.ts

@@ -1,13 +0,0 @@
-import IDatabaseAdapter from "@core/interfaces/IDatabaseAdapter";
-import Model from "./Model";
-export default abstract class Controller<M extends Model<object>> {
-    protected adapter: IDatabaseAdapter;
-    protected Model: new (adapter: IDatabaseAdapter, data?: object) => M;
-    constructor(adapter: IDatabaseAdapter, Model: new (adapter: IDatabaseAdapter, data?: object) => M);
-    abstract index(): Promise<M[]>;
-    abstract show(id: string): Promise<M | undefined>;
-    abstract create(data: object): Promise<M>;
-    abstract update(id: string, data: object): Promise<void>;
-    abstract delete(id: string): Promise<void>;
-}
-//# sourceMappingURL=Controller.d.ts.map

package/dist/abstract/Controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/abstract/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,UAAU,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC;IAExD,SAAS,CAAC,OAAO,EAAE,gBAAgB;IACnC,SAAS,CAAC,KAAK,EAAE,KAAK,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,CAAC;gBAD1D,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,KAAK,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,CAAC;IAGxE,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC7C"}

package/dist/abstract/Controller.js

@@ -1,6 +0,0 @@
-export default class Controller {
-    constructor(adapter, Model) {
-        this.adapter = adapter;
-        this.Model = Model;
-    }
-}

package/dist/abstract/Migration.d.ts

@@ -1,6 +0,0 @@
-import IDatabaseAdapter from "@core/interfaces/IDatabaseAdapter";
-export declare abstract class Migration {
-    abstract up(db: IDatabaseAdapter): Promise<void>;
-    abstract down(db: IDatabaseAdapter): Promise<void>;
-}
-//# sourceMappingURL=Migration.d.ts.map

package/dist/abstract/Migration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Migration.d.ts","sourceRoot":"","sources":["../../src/abstract/Migration.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,mCAAmC,CAAC;AAEjE,8BAAsB,SAAS;IAC3B,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CACrD"}

package/dist/abstract/Migration.js

@@ -1,2 +0,0 @@
-export class Migration {
-}

package/dist/abstract/Schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/abstract/Schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,8BAAsB,qBAAqB;IACvC,QAAQ,CAAC,WAAW,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC9C,OAAO,CAAC,IAAI,CAAC;IAEhB,QAAQ,CAAC,SAAS,CACd,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAEhB,QAAQ,CAAC,UAAU,CACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAC9C,OAAO,CAAC,IAAI,CAAC;CACnB;AAED,8BAAsB,kBAAkB;IACpC,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAM;IAE3C,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAoBjD,QAAQ,CAAC,KAAK,IAAI,MAAM;IAExB,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACvC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACvC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAExF,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACjC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IACpD,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACpC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACpC,QAAQ,CAAC,UAAU,IAAI,IAAI;CAC9B"}

package/dist/abstract/User.d.ts

@@ -1,8 +0,0 @@
-import Model from "./Model.js";
-export default class User extends Model<{
-    id: string;
-    name: string;
-}> {
-    someMethod(): void;
-}
-//# sourceMappingURL=User.d.ts.map

package/dist/abstract/User.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"User.d.ts","sourceRoot":"","sources":["../../src/abstract/User.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE,CAAC;IAC3D,UAAU,IAAI,IAAI;CAG5B"}

package/dist/abstract/User.js

@@ -1,6 +0,0 @@
-import Model from "./Model.js";
-export default class User extends Model {
-    someMethod() {
-        // console.log("This is a method in the User model.");
-    }
-}