@iamkirbki/database-handler-core 3.1.3 → 4.0.0

package/dist/abstract/Model.d.ts

@@ -1,18 +1,41 @@
-import IDatabaseAdapter from "../interfaces/IDatabaseAdapter.js";
-import { QueryCondition } from "../types/query.js";
-import Table from "../Table.js";
-import Record from "../Record.js";
-export default abstract class Model<T extends object> {
-    private Table;
-    private QueryParams;
-    constructor(table: Table);
-    static connect<M extends Model<object>>(this: new (table: Table) => M, adapter: IDatabaseAdapter): Promise<M>;
-    private RecordGet;
-    get(): Promise<T | undefined>;
-    all(): Promise<T[]>;
-    where(QueryCondition: QueryCondition): this;
-    create(data: T): Promise<Record<T> | undefined>;
-    update(data: T): Promise<void>;
-    delete(): Promise<void>;
+import Repository from "../runtime/Repository.js";
+import { columnType, QueryCondition, QueryValues, ModelConfig, relation } from "../types/index.js";
+/** Abstract Model class for ORM-style database interactions */
+export default abstract class Model<ModelType extends columnType> {
+    private _repository?;
+    protected get repository(): Repository<ModelType, Model<ModelType>>;
+    protected configuration: ModelConfig;
+    get Configuration(): ModelConfig;
+    protected originalAttributes: Partial<ModelType>;
+    protected attributes: Partial<ModelType>;
+    protected exists: boolean;
+    protected dirty: boolean;
+    protected queryScopes?: QueryCondition;
+    get primaryKeyColumn(): string;
+    get primaryKey(): QueryValues | undefined;
+    get values(): Partial<ModelType> | ModelType;
+    static where<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, conditions: QueryCondition): ParamterModelType;
+    where(conditions: QueryCondition): this;
+    static whereId<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, id: QueryValues): ParamterModelType;
+    whereId(id: QueryValues): this;
+    static find<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, primaryKeyValue: QueryValues): ParamterModelType;
+    find(primaryKeyValue: QueryValues): this;
+    static findOrFail<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, primaryKeyValue: QueryValues): Partial<columnType>;
+    findOrFail(primaryKeyValue?: QueryValues): Partial<ModelType> | ModelType;
+    get(): Promise<Partial<ModelType> | ModelType>;
+    static set<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, attributes: Partial<columnType>): ParamterModelType;
+    set(attributes: Partial<ModelType>): this;
+    save(): this;
+    update(attributes: Partial<ModelType>): this;
+    all(): Promise<Partial<ModelType>[]>;
+    protected joinedEntities: string[];
+    protected relations: relation[];
+    get JoinedEntities(): string[];
+    get Relations(): relation[];
+    hasMany<modelType extends Model<columnType>>(model: modelType, foreignKey?: string, localKey?: string): this;
+    hasOne<modelType extends Model<columnType>>(model: modelType, foreignKey?: string, localKey?: string): this;
+    belongsTo<modelType extends Model<columnType>>(model: modelType, foreignKey?: string, localKey?: string): this;
+    static with<ParamterModelType extends Model<columnType>>(this: new () => ParamterModelType, tableName: string): ParamterModelType;
+    with(relationName: string): this;
 }
 //# sourceMappingURL=Model.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/abstract/Model.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,MAAM,aAAa,CAAC;AAChC,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,KAAK,CAAC,CAAC,SAAS,MAAM;IAChD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAsB;gBAEtB,KAAK,EAAE,KAAK;WAIX,OAAO,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,EAE/C,IAAI,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,CAAC,EAC7B,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,CAAC,CAAC;YAKC,SAAS;IAIV,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAK7B,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAKzB,KAAK,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAKrC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAI/C,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAMvC"}
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/abstract/Model.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEtG,+DAA+D;AAC/D,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,KAAK,CAAC,SAAS,SAAS,UAAU;IAC5D,OAAO,CAAC,WAAW,CAAC,CAA0C;IAE9D,SAAS,KAAK,UAAU,IAAI,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAQlE;IAED,SAAS,CAAC,aAAa,EAAE,WAAW,CASlC;IAEF,IAAW,aAAa,IAAI,WAAW,CAEtC;IAED,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAM;IACtD,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAM;IAC9C,SAAS,CAAC,MAAM,EAAE,OAAO,CAAS;IAClC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAS;IACjC,SAAS,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;IAEvC,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,IAAW,UAAU,IAAI,WAAW,GAAG,SAAS,CAE/C;IAED,IAAW,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAElD;WAEa,KAAK,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EAC3D,IAAI,EAAE,UAAU,iBAAiB,EACjC,UAAU,EAAE,cAAc,GAC3B,iBAAiB;IAKb,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;WAKhC,OAAO,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EAC7D,IAAI,EAAE,UAAU,iBAAiB,EACjC,EAAE,EAAE,WAAW,GAChB,iBAAiB;IAKb,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;WAKvB,IAAI,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EAC1D,IAAI,EAAE,UAAU,iBAAiB,EACjC,eAAe,EAAE,WAAW,GAC7B,iBAAiB;IAKb,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,IAAI;WAKjC,UAAU,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EAChE,IAAI,EAAE,UAAU,iBAAiB,EACjC,eAAe,EAAE,WAAW,GAC7B,OAAO,CAAC,UAAU,CAAC;IAKf,UAAU,CAAC,eAAe,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS;IAoBnE,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;WAK7C,GAAG,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EACzD,IAAI,EAAE,UAAU,iBAAiB,EACjC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAChC,iBAAiB;IAKb,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IASzC,IAAI,IAAI,IAAI;IAQZ,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAS5C,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAI3C,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAM;IACxC,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IAErC,IAAW,cAAc,IAAI,MAAM,EAAE,CAEpC;IAED,IAAW,SAAS,IAAI,QAAQ,EAAE,CAEjC;IAEM,OAAO,CAAC,SAAS,SAAS,KAAK,CAAC,UAAU,CAAC,EAC9C,KAAK,EAAE,SAAS,EAChB,UAAU,GAAE,MAAuE,EACnF,QAAQ,GAAE,MAAsC,GACjD,IAAI;IAUA,MAAM,CAAC,SAAS,SAAS,KAAK,CAAC,UAAU,CAAC,EAC7C,KAAK,EAAE,SAAS,EAChB,UAAU,GAAE,MAA4C,EACxD,QAAQ,GAAE,MAAyE,GACpF,IAAI;IAUA,SAAS,CAAC,SAAS,SAAS,KAAK,CAAC,UAAU,CAAC,EAChD,KAAK,EAAE,SAAS,EAChB,UAAU,GAAE,MAAyE,EACrF,QAAQ,GAAE,MAAuC,GAClD,IAAI;WAUO,IAAI,CAAC,iBAAiB,SAAS,KAAK,CAAC,UAAU,CAAC,EAC1D,IAAI,EAAE,UAAU,iBAAiB,EACjC,SAAS,EAAE,MAAM,GAClB,iBAAiB;IAKb,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAc1C"}

package/dist/abstract/Model.js

@@ -7,58 +7,170 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import Table from "../Table.js";
+import Repository from "../runtime/Repository.js";
+/** Abstract Model class for ORM-style database interactions */
 export default class Model {
-    constructor(table) {
-        this.QueryParams = {};
-        this.Table = table;
+    constructor() {
+        this.configuration = {
+            table: '', // Must be set by subclass
+            primaryKey: 'id',
+            incrementing: true,
+            keyType: 'number',
+            timestamps: true,
+            createdAtColumn: 'created_at',
+            updatedAtColumn: 'updated_at',
+            guarded: ['*'],
+        };
+        this.originalAttributes = {};
+        this.attributes = {};
+        this.exists = false;
+        this.dirty = false;
+        this.joinedEntities = [];
+        this.relations = [];
     }
-    static connect(adapter) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const table = yield Table.create(this.name, adapter);
-            return new this(table);
-        });
+    get repository() {
+        if (!this._repository) {
+            this._repository = Repository.getInstance(this.constructor, this.Configuration.table);
+        }
+        return this._repository;
     }
-    RecordGet() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.Table.Record({ where: this.QueryParams });
+    get Configuration() {
+        return this.configuration;
+    }
+    get primaryKeyColumn() {
+        return this.configuration.primaryKey;
+    }
+    get primaryKey() {
+        return this.attributes[this.configuration.primaryKey];
+    }
+    get values() {
+        return this.attributes;
+    }
+    static where(conditions) {
+        const instance = new this();
+        return instance.where(conditions);
+    }
+    where(conditions) {
+        this.queryScopes = conditions;
+        return this;
+    }
+    static whereId(id) {
+        const instance = new this();
+        return instance.whereId(id);
+    }
+    whereId(id) {
+        this.queryScopes = { id: id };
+        return this;
+    }
+    static find(primaryKeyValue) {
+        const instance = new this();
+        return instance.find(primaryKeyValue);
+    }
+    find(primaryKeyValue) {
+        this.queryScopes = { [this.primaryKeyColumn]: primaryKeyValue };
+        return this;
+    }
+    static findOrFail(primaryKeyValue) {
+        const instance = new this();
+        return instance.findOrFail(primaryKeyValue);
+    }
+    findOrFail(primaryKeyValue) {
+        var _a;
+        if (primaryKeyValue) {
+            this.queryScopes = { [this.primaryKeyColumn]: primaryKeyValue };
+        }
+        const query = this.queryScopes || {};
+        (_a = this.repository) === null || _a === void 0 ? void 0 : _a.get(query, this).then((record) => {
+            if (!record) {
+                throw new Error(`Record with primary key ${primaryKeyValue} not found.`);
+            }
+            this.set(record);
         });
+        return this.attributes;
     }
     get() {
         return __awaiter(this, void 0, void 0, function* () {
-            const record = yield this.RecordGet();
-            return record === null || record === void 0 ? void 0 : record.values;
+            var _a;
+            this.attributes = (yield ((_a = this.repository) === null || _a === void 0 ? void 0 : _a.get(this.queryScopes || {}, this)));
+            return this.attributes;
         });
     }
-    all() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const records = yield this.Table.Records({ where: this.QueryParams });
-            return records.map(record => record.values);
-        });
+    static set(attributes) {
+        const instance = new this();
+        return instance.set(attributes);
     }
-    where(QueryCondition) {
-        this.QueryParams = QueryCondition;
+    set(attributes) {
+        if (attributes[this.primaryKeyColumn] !== undefined && !this.exists) {
+            this.repository.syncModel(this);
+        }
+        this.attributes = Object.assign(Object.assign({}, this.attributes), attributes);
+        this.dirty = true;
         return this;
     }
-    create(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.Table.Insert(data);
+    save() {
+        this.repository.save(this.attributes, this.originalAttributes);
+        this.originalAttributes = Object.assign(Object.assign({}, this.originalAttributes), this.attributes);
+        this.exists = true;
+        this.dirty = false;
+        return this;
+    }
+    update(attributes) {
+        var _a;
+        if (!this.exists) {
+            throw new Error("Cannot update a model that does not exist in the database.");
+        }
+        (_a = this.repository) === null || _a === void 0 ? void 0 : _a.update(attributes);
+        return this;
+    }
+    all() {
+        return this.repository.all(this);
+    }
+    get JoinedEntities() {
+        return this.joinedEntities;
+    }
+    get Relations() {
+        return this.relations;
+    }
+    hasMany(model, foreignKey = `${this.Configuration.table}_${this.Configuration.primaryKey}`, localKey = this.Configuration.primaryKey) {
+        this.relations.push({
+            type: 'hasMany',
+            model: model,
+            foreignKey: foreignKey,
+            localKey: localKey,
         });
+        return this;
     }
-    update(data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const record = yield this.RecordGet();
-            if (record) {
-                yield record.Update(data);
-            }
+    hasOne(model, foreignKey = `${model.Configuration.primaryKey}`, localKey = `${model.Configuration.table}_${model.Configuration.primaryKey}`) {
+        this.relations.push({
+            type: 'hasOne',
+            model: model,
+            foreignKey: foreignKey,
+            localKey: localKey,
         });
+        return this;
     }
-    delete() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const record = yield this.RecordGet();
-            if (record) {
-                yield record.Delete();
-            }
+    belongsTo(model, foreignKey = `${model.Configuration.table}_${model.Configuration.primaryKey}`, localKey = model.Configuration.primaryKey) {
+        this.relations.push({
+            type: 'belongsTo',
+            model: model,
+            foreignKey: foreignKey,
+            localKey: localKey,
         });
+        return this;
+    }
+    static with(tableName) {
+        const instance = new this();
+        return instance.with(tableName);
+    }
+    with(relationName) {
+        this.joinedEntities.push(relationName);
+        const method = Reflect.get(this, relationName);
+        if (typeof method === 'function') {
+            method.call(this);
+        }
+        else {
+            throw new Error(`Relation method '${relationName}' does not exist on ${this.constructor.name}`);
+        }
+        return this;
     }
 }

package/dist/abstract/{Schema.d.ts → SchemaTableBuilder.d.ts}

@@ -1,10 +1,5 @@
-import { ColumnDefinition } from "@core/types/index";
-export declare abstract class AbstractSchemaBuilder {
-    abstract createTable(name: string, callback: (table: SchemaTableBuilder) => void): Promise<void>;
-    abstract dropTable(name: string): Promise<void>;
-    abstract alterTable(oldName: string, callback: (table: SchemaTableBuilder) => void): Promise<void>;
-}
-export declare abstract class SchemaTableBuilder {
+import { ColumnDefinition } from "../types/index";
+export default abstract class SchemaTableBuilder {
     protected columns: ColumnDefinition[];
     protected addColumn(data: ColumnDefinition): this;
     abstract build(): string;
@@ -17,4 +12,4 @@ export declare abstract class SchemaTableBuilder {
     abstract boolean(name: string): this;
     abstract timestamps(): this;
 }
-//# sourceMappingURL=Schema.d.ts.map
+//# sourceMappingURL=SchemaTableBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaTableBuilder.d.ts","sourceRoot":"","sources":["../../src/abstract/SchemaTableBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,kBAAkB;IAC5C,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/{Schema.js → SchemaTableBuilder.js}

@@ -1,6 +1,4 @@
-export class AbstractSchemaBuilder {
-}
-export class SchemaTableBuilder {
+export default class SchemaTableBuilder {
     constructor() {
         this.columns = [];
     }

package/dist/base/Database.d.ts

@@ -0,0 +1,13 @@
+import Table from "./Table.js";
+import Query from "./Query.js";
+import IDatabaseAdapter from "../interfaces/IDatabaseAdapter.js";
+/** Main Database class */
+export default class Database {
+    adapter: IDatabaseAdapter;
+    constructor(adapter: IDatabaseAdapter);
+    /** Get a Table instance for an existing table */
+    Table(name: string): Promise<Table>;
+    /** Create a Query object for executing custom SQL */
+    Query(table: Table, query: string): Query;
+}
+//# sourceMappingURL=Database.d.ts.map

package/dist/base/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/base/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AAEpE,0BAA0B;AAC1B,MAAM,CAAC,OAAO,OAAO,QAAQ;IACpB,OAAO,EAAE,gBAAgB,CAAC;gBAErB,OAAO,EAAE,gBAAgB;IAIrC,iDAAiD;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIhD,qDAAqD;IAC9C,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;CAGjD"}

package/dist/base/Database.js

@@ -0,0 +1,27 @@
+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 */
+export default class Database {
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    /** Get a Table instance for an existing table */
+    Table(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Table(name);
+        });
+    }
+    /** Create a Query object for executing custom SQL */
+    Query(table, query) {
+        return new Query(table, query, this.adapter);
+    }
+}

package/dist/base/Query.d.ts

@@ -0,0 +1,43 @@
+import Table from "./Table.js";
+import { QueryCondition, QueryWhereParameters } from "../types/index.js";
+import Record from "./Record.js";
+import IDatabaseAdapter from "../interfaces/IDatabaseAdapter.js";
+/** Query class for executing custom SQL queries */
+export default class Query {
+    readonly Table: Table;
+    private readonly _adapter;
+    private _query;
+    private _parameters;
+    get Parameters(): QueryCondition;
+    set Parameters(value: QueryCondition);
+    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 */
+    All<Type>(): Promise<Record<Type>[]>;
+    static ConvertParamsToObject(params: QueryCondition): QueryWhereParameters;
+    static ConvertIdToString(params: QueryWhereParameters): QueryWhereParameters;
+    /** Execute a SELECT query and return the first matching row */
+    Get<Type>(): Promise<Record<Type> | undefined>;
+}
+//# sourceMappingURL=Query.d.ts.map

package/dist/base/Query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.d.ts","sourceRoot":"","sources":["../../src/base/Query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AAEpE,mDAAmD;AACnD,MAAM,CAAC,OAAO,OAAO,KAAK;IACxB,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAsB;IAEzC,IAAW,UAAU,IAAI,cAAc,CAEtC;IAED,IAAW,UAAU,CAAC,KAAK,EAAE,cAAc,EAE1C;gBAEW,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;IAMlE;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC;IAKvC,0DAA0D;IAC7C,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;WAMnC,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,oBAAoB;WAanE,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB;IAQnF,+DAA+D;IAClD,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAK5D"}

package/dist/base/Query.js

@@ -0,0 +1,87 @@
+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 */
+export default class Query {
+    get Parameters() {
+        return this._parameters;
+    }
+    set Parameters(value) {
+        this._parameters = Query.ConvertParamsToObject(value);
+    }
+    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 */
+    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));
+        });
+    }
+    static 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);
+    }
+    static 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 */
+    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;
+        });
+    }
+}

package/dist/base/Record.d.ts

@@ -0,0 +1,23 @@
+import { inspect } from "util";
+import Table from "./Table.js";
+import IDatabaseAdapter from "../interfaces/IDatabaseAdapter.js";
+/** Record class represents a single database row */
+export default class Record<ColumnValuesType> {
+    private readonly _adapter;
+    private _values;
+    private readonly _table;
+    constructor(values: ColumnValuesType, adapter: IDatabaseAdapter, table: Table);
+    /** Get the raw values object for this record */
+    get values(): ColumnValuesType;
+    /** Update this record in the database */
+    Update(newValues: object): Promise<void>;
+    /** Delete this record from the database */
+    Delete(): Promise<void>;
+    /** Returns the values object for JSON.stringify() */
+    toJSON(): ColumnValuesType;
+    /** Convert record to pretty-printed JSON string */
+    toString(): string;
+    /** Custom inspect for console.log() */
+    [inspect.custom](): ColumnValuesType;
+}
+//# sourceMappingURL=Record.d.ts.map

package/dist/base/Record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Record.d.ts","sourceRoot":"","sources":["../../src/base/Record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AAGpE,oDAAoD;AACpD,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,gBAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK;IAM7E,gDAAgD;IAChD,IAAW,MAAM,IAAI,gBAAgB,CAEpC;IAED,yCAAyC;IAC5B,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrD,2CAA2C;IAC9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAUpC,qDAAqD;IAC9C,MAAM,IAAI,gBAAgB;IAIjC,mDAAmD;IAC5C,QAAQ,IAAI,MAAM;IAIzB,uCAAuC;IACvC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,gBAAgB;CAGvC"}

package/dist/base/Record.js

@@ -0,0 +1,72 @@
+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 { inspect } from "util";
+import Query from "./Query.js";
+/** Record class represents a single database row */
+export default class Record {
+    constructor(values, adapter, table) {
+        this._values = {};
+        this._values = values;
+        this._adapter = adapter;
+        this._table = table;
+    }
+    /** Get the raw values object for this record */
+    get values() {
+        return this._values;
+    }
+    ;
+    /** Update this record in the database */
+    Update(newValues) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const setClauses = Object.keys(newValues)
+                .map(key => `${key} = @${key}`)
+                .join(", ");
+            const originalValues = this._values;
+            if (originalValues.updated_at !== undefined) {
+                newValues.updated_at = new Date().toISOString();
+            }
+            const whereClauses = Object.keys(originalValues)
+                .map(key => `${key} = @where_${key}`)
+                .join(" AND ");
+            const query = `UPDATE "${this._table.Name}" SET ${setClauses} WHERE ${whereClauses};`;
+            const _query = new Query(this._table, query, this._adapter);
+            const params = Object.assign({}, newValues);
+            Object.entries(originalValues).forEach(([key, value]) => {
+                params[`where_${key}`] = value;
+            });
+            _query.Parameters = params;
+            yield _query.Run();
+            this._values = Object.assign(Object.assign({}, this._values), newValues);
+        });
+    }
+    /** Delete this record from the database */
+    Delete() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const whereClauses = Object.keys(this._values)
+                .map(key => `${key} = @${key}`)
+                .join(" AND ");
+            const _query = new Query(this._table, `DELETE FROM "${this._table.Name}" WHERE ${whereClauses};`, this._adapter);
+            _query.Parameters = Object.assign({}, this._values);
+            yield _query.Run();
+        });
+    }
+    /** Returns the values object for JSON.stringify() */
+    toJSON() {
+        return this._values;
+    }
+    /** Convert record to pretty-printed JSON string */
+    toString() {
+        return JSON.stringify(this._values, null, 2);
+    }
+    /** Custom inspect for console.log() */
+    [inspect.custom]() {
+        return this._values;
+    }
+}

package/dist/base/Table.d.ts

@@ -0,0 +1,27 @@
+import { DefaultQueryOptions, Join, QueryOptions, ReadableTableColumnInfo, TableColumnInfo, columnType } from "../types/index.js";
+import Record from "../base/Record.js";
+/** Table class for interacting with a database table */
+export default class Table {
+    private readonly _name;
+    private readonly _adapter;
+    /** Private constructor - use Table.create() */
+    constructor(name: string);
+    /** Get the table name */
+    get Name(): string;
+    /** Get raw column information */
+    TableColumnInformation(): Promise<TableColumnInfo[]>;
+    /** Get readable, formatted column information */
+    ReadableTableColumnInformation(): Promise<ReadableTableColumnInfo[]>;
+    Drop(): Promise<void>;
+    /** Fetch records with optional filtering, ordering, and pagination */
+    Records<Type>(options?: DefaultQueryOptions & QueryOptions): Promise<Record<Type>[]>;
+    /** Fetch a single record from the table */
+    Record<Type>(options?: DefaultQueryOptions & QueryOptions): Promise<Record<Type> | undefined>;
+    /** Get the total count of records */
+    RecordsCount(): Promise<number>;
+    /** Insert a record into the table */
+    Insert<Type>(values: columnType): Promise<Record<Type> | undefined>;
+    /** Perform JOIN operations with other tables */
+    Join<Type>(Joins: Join | Join[], options?: DefaultQueryOptions & QueryOptions): Promise<Record<Type>[]>;
+}
+//# sourceMappingURL=Table.d.ts.map

package/dist/base/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../src/base/Table.ts"],"names":[],"mappings":"AACA,OAAO,EACH,mBAAmB,EACnB,IAAI,EACJ,YAAY,EACZ,uBAAuB,EAEvB,eAAe,EAEf,UAAU,EACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAI1C,wDAAwD;AACxD,MAAM,CAAC,OAAO,OAAO,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0D;IAEnF,+CAA+C;gBACnC,IAAI,EAAE,MAAM;IAIxB,yBAAyB;IACzB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,iCAAiC;IACpB,sBAAsB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjE,iDAAiD;IACpC,8BAA8B,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAWpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC,sEAAsE;IACzD,OAAO,CAAC,IAAI,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAC7C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAoB1B,2CAA2C;IAC9B,MAAM,CAAC,IAAI,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAC7C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAWpC,qCAAqC;IACxB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAM5C,qCAAqC;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IA+BhF,gDAAgD;IACnC,IAAI,CAAC,IAAI,EAClB,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAAG,YAAY,GAC7C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;CAW7B"}