@shohaghinfo/aerojs 0.1.0

package/dist/database/drizzle.js

@@ -0,0 +1,13 @@
+/**
+ * @file drizzle.ts
+ * @description First-Class Drizzle ORM Integration for AeroJS.
+ * Provides IoC binding and HttpContext.drizzle injection.
+ */
+/**
+ * Registers Drizzle database instance into Aero's global context and IoC container.
+ */
+export function useDrizzle(drizzleDb) {
+    globalThis.__AERO_DRIZZLE__ = drizzleDb;
+    return drizzleDb;
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/database/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.js","sourceRoot":"","sources":["../../src/database/drizzle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAc;IACtC,UAAkB,CAAC,gBAAgB,GAAG,SAAS,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/database/factory.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file factory.ts
+ * @description Model Factories for automated database seeding and testing.
+ */
+import { Model } from './model.js';
+export type FactoryDefinition<T extends Model> = () => Partial<T>;
+export declare class ModelFactory<T extends Model> {
+    private ModelClass;
+    private definitionFn;
+    private states;
+    private activeStates;
+    /**
+     * Define the factory base blueprint for a given Model.
+     */
+    static define<T extends Model>(modelClass: new (...args: any[]) => T, definition: FactoryDefinition<T>): ModelFactory<T>;
+    private constructor();
+    /**
+     * Register a named state variation for the factory.
+     */
+    state(name: string, stateFn: FactoryDefinition<T>): this;
+    /**
+     * Apply a registered state variation to the current factory execution.
+     */
+    applyState(name: string): this;
+    private buildAttributes;
+    /**
+     * Create an in-memory Model instance without persisting it to the database.
+     */
+    make(overrides?: Partial<T>): T;
+    /**
+     * Create and persist a Model instance to the database.
+     */
+    create(overrides?: Partial<T>, connectionOrAdapter?: any): Promise<T>;
+    /**
+     * Create and persist multiple Model instances to the database.
+     */
+    createMany(count: number, overrides?: Partial<T>, connectionOrAdapter?: any): Promise<T[]>;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/database/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/database/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,KAAK,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE,qBAAa,YAAY,CAAC,CAAC,SAAS,KAAK;IACvC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,YAAY,CAAgB;IAEpC;;OAEG;WACW,MAAM,CAAC,CAAC,SAAS,KAAK,EAClC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EACrC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B,YAAY,CAAC,CAAC,CAAC;IAIlB,OAAO;IAKP;;OAEG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;IAK/D;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQrC,OAAO,CAAC,eAAe;IAavB;;OAEG;IACI,IAAI,CAAC,SAAS,GAAE,OAAO,CAAC,CAAC,CAAM,GAAG,CAAC;IAK1C;;OAEG;IACU,MAAM,CAAC,SAAS,GAAE,OAAO,CAAC,CAAC,CAAM,EAAE,mBAAmB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAMtF;;OAEG;IACU,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,CAAC,CAAM,EAAE,mBAAmB,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAO5G"}

package/dist/database/factory.js

@@ -0,0 +1,74 @@
+/**
+ * @file factory.ts
+ * @description Model Factories for automated database seeding and testing.
+ */
+import { Model } from './model.js';
+export class ModelFactory {
+    ModelClass;
+    definitionFn;
+    states = new Map();
+    activeStates = [];
+    /**
+     * Define the factory base blueprint for a given Model.
+     */
+    static define(modelClass, definition) {
+        return new ModelFactory(modelClass, definition);
+    }
+    constructor(modelClass, definition) {
+        this.ModelClass = modelClass;
+        this.definitionFn = definition;
+    }
+    /**
+     * Register a named state variation for the factory.
+     */
+    state(name, stateFn) {
+        this.states.set(name, stateFn);
+        return this;
+    }
+    /**
+     * Apply a registered state variation to the current factory execution.
+     */
+    applyState(name) {
+        if (!this.states.has(name)) {
+            throw new Error(`State '${name}' is not defined for this factory.`);
+        }
+        this.activeStates.push(name);
+        return this;
+    }
+    buildAttributes(overrides = {}) {
+        let attributes = this.definitionFn();
+        for (const stateName of this.activeStates) {
+            const stateFn = this.states.get(stateName);
+            if (stateFn) {
+                attributes = { ...attributes, ...stateFn() };
+            }
+        }
+        return { ...attributes, ...overrides };
+    }
+    /**
+     * Create an in-memory Model instance without persisting it to the database.
+     */
+    make(overrides = {}) {
+        const attributes = this.buildAttributes(overrides);
+        return new this.ModelClass(attributes);
+    }
+    /**
+     * Create and persist a Model instance to the database.
+     */
+    async create(overrides = {}, connectionOrAdapter) {
+        const instance = this.make(overrides);
+        await instance.save(connectionOrAdapter);
+        return instance;
+    }
+    /**
+     * Create and persist multiple Model instances to the database.
+     */
+    async createMany(count, overrides = {}, connectionOrAdapter) {
+        const instances = [];
+        for (let i = 0; i < count; i++) {
+            instances.push(await this.create(overrides, connectionOrAdapter));
+        }
+        return instances;
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/database/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/database/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC,MAAM,OAAO,YAAY;IACf,UAAU,CAA4B;IACtC,YAAY,CAAuB;IACnC,MAAM,GAAsC,IAAI,GAAG,EAAE,CAAC;IACtD,YAAY,GAAa,EAAE,CAAC;IAEpC;;OAEG;IACI,MAAM,CAAC,MAAM,CAClB,UAAqC,EACrC,UAAgC;QAEhC,OAAO,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,YAAoB,UAAqC,EAAE,UAAgC;QACzF,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAY,EAAE,OAA6B;QACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,IAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,oCAAoC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe,CAAC,YAAwB,EAAE;QAChD,IAAI,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAErC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,GAAG,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,YAAwB,EAAE;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,YAAwB,EAAE,EAAE,mBAAyB;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,YAAwB,EAAE,EAAE,mBAAyB;QAC1F,MAAM,SAAS,GAAQ,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/database/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file index.ts
+ * @description AeroJS Database & Active Record ORM Layer.
+ */
+export { Database, DB, MemoryDatabaseAdapter, type DatabaseAdapter, type DatabaseRow, } from './connection.js';
+export { QueryBuilder, type WhereClause, type JoinClause, type PaginationResult, } from './query-builder.js';
+export { Model, Relation, computed, type RelationDefinition, type ManyToManyOptions, type HasManyThroughOptions, } from './model.js';
+export { getHookRegistry, registerHook, ModelHookRegistry, beforeCreate, afterCreate, beforeSave, afterSave, beforeUpdate, afterUpdate, beforeDelete, afterDelete, beforeFind, afterFind, beforeFetch, afterFetch, type ModelHookEvent, type ModelHookHandler, } from './model-hooks.js';
+export { Schema, TableBlueprint, type ColumnDefinition, } from './schema.js';
+export { Migrator, type Migration, } from './migrator.js';
+export { Seeder, DatabaseSeeder, } from './seeder.js';
+export { ModelFactory, type FactoryDefinition, } from './factory.js';
+export { KnexDatabaseAdapter, useKnex, } from './knex.js';
+export { usePrisma, type PrismaIntegrationOptions, } from './prisma.js';
+export { useDrizzle, } from './drizzle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,EAAE,EACF,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,MAAM,EACN,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,MAAM,EACN,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,SAAS,EACT,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,16 @@
+/**
+ * @file index.ts
+ * @description AeroJS Database & Active Record ORM Layer.
+ */
+export { Database, DB, MemoryDatabaseAdapter, } from './connection.js';
+export { QueryBuilder, } from './query-builder.js';
+export { Model, Relation, computed, } from './model.js';
+export { getHookRegistry, registerHook, ModelHookRegistry, beforeCreate, afterCreate, beforeSave, afterSave, beforeUpdate, afterUpdate, beforeDelete, afterDelete, beforeFind, afterFind, beforeFetch, afterFetch, } from './model-hooks.js';
+export { Schema, TableBlueprint, } from './schema.js';
+export { Migrator, } from './migrator.js';
+export { Seeder, DatabaseSeeder, } from './seeder.js';
+export { ModelFactory, } from './factory.js';
+export { KnexDatabaseAdapter, useKnex, } from './knex.js';
+export { usePrisma, } from './prisma.js';
+export { useDrizzle, } from './drizzle.js';
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,EAAE,EACF,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,GAIT,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,GAGX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,MAAM,EACN,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,GAET,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,MAAM,EACN,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,SAAS,GAEV,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,GACX,MAAM,cAAc,CAAC"}

package/dist/database/knex.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file knex.ts
+ * @description First-Class Knex.js Integration for AeroJS.
+ * Bridges Knex query builder and connection pools to Aero's DatabaseAdapter,
+ * Active Record Models, Migrator, and HttpContext.
+ */
+import type { DatabaseAdapter, DatabaseRow } from './connection.js';
+import { QueryBuilder } from './query-builder.js';
+export declare class KnexDatabaseAdapter implements DatabaseAdapter {
+    readonly knex: any;
+    readonly dialect: string;
+    constructor(knexInstance: any);
+    table<T extends DatabaseRow = DatabaseRow>(name: string): QueryBuilder<T>;
+    query<T = DatabaseRow>(sql: string, bindings?: unknown[]): Promise<T[]>;
+    execute(sql: string, bindings?: unknown[]): Promise<{
+        insertId?: number | string;
+        affectedRows: number;
+    }>;
+    transaction<T>(callback: (trx: DatabaseAdapter) => Promise<T>): Promise<T>;
+    beginTransaction(): Promise<KnexDatabaseAdapter>;
+    savepoint(name: string): Promise<void>;
+    rollbackTo(name: string): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    close(): Promise<void>;
+    private normalizeRows;
+    private normalizeExecuteResult;
+}
+/**
+ * Connects Knex as the underlying database engine for AeroJS.
+ */
+export declare function useKnex(knexInstance: any, connectionName?: string): KnexDatabaseAdapter;
+//# sourceMappingURL=knex.d.ts.map

package/dist/database/knex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex.d.ts","sourceRoot":"","sources":["../../src/database/knex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,SAAgB,IAAI,EAAE,GAAG,CAAC;IAC1B,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,YAAY,EAAE,GAAG;IAMtB,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAInE,KAAK,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAW3E,OAAO,CAClB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,EAAO,GACvB,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAWnD,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAO1E,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAMhD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAMvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAMzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,sBAAsB;CAoB/B;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,cAAc,SAAY,GAAG,mBAAmB,CAM1F"}

package/dist/database/knex.js

@@ -0,0 +1,123 @@
+/**
+ * @file knex.ts
+ * @description First-Class Knex.js Integration for AeroJS.
+ * Bridges Knex query builder and connection pools to Aero's DatabaseAdapter,
+ * Active Record Models, Migrator, and HttpContext.
+ */
+import { Database, DB } from './connection.js';
+import { QueryBuilder } from './query-builder.js';
+import { Logger } from '../logging/logger.js';
+export class KnexDatabaseAdapter {
+    knex;
+    dialect;
+    constructor(knexInstance) {
+        this.knex = knexInstance;
+        const client = knexInstance?.client?.dialect || knexInstance?.client?.config?.client || 'default';
+        this.dialect = String(client).toLowerCase();
+    }
+    table(name) {
+        return new QueryBuilder(name, this);
+    }
+    async query(sql, bindings = []) {
+        const start = Date.now();
+        try {
+            const result = await this.knex.raw(sql, bindings);
+            return this.normalizeRows(result);
+        }
+        finally {
+            const duration = Date.now() - start;
+            Logger.logQuery(sql, bindings, duration);
+        }
+    }
+    async execute(sql, bindings = []) {
+        const start = Date.now();
+        try {
+            const result = await this.knex.raw(sql, bindings);
+            return this.normalizeExecuteResult(result);
+        }
+        finally {
+            const duration = Date.now() - start;
+            Logger.logQuery(sql, bindings, duration);
+        }
+    }
+    async transaction(callback) {
+        return await this.knex.transaction(async (trx) => {
+            const trxAdapter = new KnexDatabaseAdapter(trx);
+            return await callback(trxAdapter);
+        });
+    }
+    async beginTransaction() {
+        const trx = await this.knex.transaction();
+        return new KnexDatabaseAdapter(trx);
+    }
+    async savepoint(name) {
+        await this.execute(`SAVEPOINT ${name}`);
+    }
+    async rollbackTo(name) {
+        await this.execute(`ROLLBACK TO SAVEPOINT ${name}`);
+    }
+    async commit() {
+        if (typeof this.knex.commit === 'function') {
+            await this.knex.commit();
+        }
+    }
+    async rollback() {
+        if (typeof this.knex.rollback === 'function') {
+            await this.knex.rollback();
+        }
+    }
+    async close() {
+        if (typeof this.knex.destroy === 'function') {
+            await this.knex.destroy();
+        }
+    }
+    normalizeRows(result) {
+        if (!result)
+            return [];
+        // PostgreSQL: result.rows
+        if (Array.isArray(result.rows)) {
+            return result.rows;
+        }
+        // MySQL: [rows, fields]
+        if (Array.isArray(result) && Array.isArray(result[0])) {
+            return result[0];
+        }
+        // SQLite / Mock: result is array
+        if (Array.isArray(result)) {
+            return result;
+        }
+        return [result];
+    }
+    normalizeExecuteResult(result) {
+        if (!result)
+            return { affectedRows: 0 };
+        // MySQL / SQLite (result or result[0] if MySQL2 returns [ResultSetHeader, fields])
+        const header = Array.isArray(result) ? result[0] : result;
+        if (header && (header.insertId !== undefined || header.affectedRows !== undefined)) {
+            return {
+                insertId: header.insertId,
+                affectedRows: header.affectedRows ?? 1,
+            };
+        }
+        // PostgreSQL: result.rowCount
+        if (result.rowCount !== undefined) {
+            const firstRow = result.rows?.[0];
+            return {
+                insertId: firstRow?.id,
+                affectedRows: result.rowCount,
+            };
+        }
+        return { affectedRows: 1 };
+    }
+}
+/**
+ * Connects Knex as the underlying database engine for AeroJS.
+ */
+export function useKnex(knexInstance, connectionName = 'default') {
+    const adapter = new KnexDatabaseAdapter(knexInstance);
+    Database.setAdapter(adapter, connectionName);
+    Database.knex = knexInstance;
+    DB.knex = knexInstance;
+    return adapter;
+}
+//# sourceMappingURL=knex.js.map

package/dist/database/knex.js.map

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

package/dist/database/migrator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file migrator.ts
+ * @description Migration runner for AeroJS database schema migrations.
+ */
+export interface Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+export declare class Migrator {
+    table: string;
+    connection: string;
+    constructor(connection?: string);
+    ensureTableExists(): Promise<void>;
+    getExecutedMigrations(): Promise<string[]>;
+    getNextBatchNumber(): Promise<number>;
+    /**
+     * Runs an array of migration instances in chronological order.
+     */
+    runMigrations(migrations: {
+        name: string;
+        migration: Migration;
+    }[]): Promise<string[]>;
+    /**
+     * Rollbacks the last batch of executed migrations.
+     */
+    rollback(migrationMap: Record<string, Migration>): Promise<string[]>;
+}
+export default Migrator;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/database/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../src/database/migrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,SAAS;IACxB,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,qBAAa,QAAQ;IACZ,KAAK,SAAqB;IAC1B,UAAU,SAAa;gBAElB,UAAU,SAAY;IAIrB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAalC,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ1C,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAQlD;;OAEG;IACU,aAAa,CACxB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAAE,GACnD,OAAO,CAAC,MAAM,EAAE,CAAC;IAuBpB;;OAEG;IACU,QAAQ,CACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC;CAsBrB;AAED,eAAe,QAAQ,CAAC"}

package/dist/database/migrator.js

@@ -0,0 +1,83 @@
+/**
+ * @file migrator.ts
+ * @description Migration runner for AeroJS database schema migrations.
+ */
+import { Database } from './connection.js';
+import { Schema } from './schema.js';
+export class Migrator {
+    table = 'aero_migrations';
+    connection = 'default';
+    constructor(connection = 'default') {
+        this.connection = connection;
+    }
+    async ensureTableExists() {
+        await Schema.createTable(this.table, (table) => {
+            table.increments('id');
+            table.string('name', 255).unique();
+            table.integer('batch');
+            table.timestamp('executed_at');
+        }, this.connection);
+    }
+    async getExecutedMigrations() {
+        await this.ensureTableExists();
+        const rows = await Database.table(this.table, this.connection)
+            .select('name')
+            .get();
+        return rows.map((r) => r.name);
+    }
+    async getNextBatchNumber() {
+        await this.ensureTableExists();
+        const rows = await Database.table(this.table, this.connection).get();
+        if (rows.length === 0)
+            return 1;
+        const maxBatch = Math.max(...rows.map((r) => Number(r.batch || 0)));
+        return maxBatch + 1;
+    }
+    /**
+     * Runs an array of migration instances in chronological order.
+     */
+    async runMigrations(migrations) {
+        await this.ensureTableExists();
+        const executed = await this.getExecutedMigrations();
+        const batch = await this.getNextBatchNumber();
+        const ran = [];
+        for (const item of migrations) {
+            if (executed.includes(item.name)) {
+                continue;
+            }
+            await item.migration.up();
+            await Database.table(this.table, this.connection).insert({
+                name: item.name,
+                batch,
+                executed_at: new Date().toISOString(),
+            });
+            ran.push(item.name);
+        }
+        return ran;
+    }
+    /**
+     * Rollbacks the last batch of executed migrations.
+     */
+    async rollback(migrationMap) {
+        await this.ensureTableExists();
+        const rows = await Database.table(this.table, this.connection).get();
+        if (rows.length === 0)
+            return [];
+        const lastBatch = Math.max(...rows.map((r) => Number(r.batch || 0)));
+        const batchRows = rows.filter((r) => Number(r.batch) === lastBatch);
+        const rolledBack = [];
+        for (const r of batchRows) {
+            const mig = migrationMap[r.name];
+            if (mig) {
+                await mig.down();
+            }
+            await Database.table(this.table, this.connection)
+                .where('name', r.name)
+                .delete();
+            rolledBack.push(r.name);
+        }
+        return rolledBack;
+    }
+}
+export default Migrator;
+//# sourceMappingURL=migrator.js.map

package/dist/database/migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.js","sourceRoot":"","sources":["../../src/database/migrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,MAAM,OAAO,QAAQ;IACZ,KAAK,GAAG,iBAAiB,CAAC;IAC1B,UAAU,GAAG,SAAS,CAAC;IAE9B,YAAY,UAAU,GAAG,SAAS;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,MAAM,MAAM,CAAC,WAAW,CACtB,IAAI,CAAC,KAAK,EACV,CAAC,KAAK,EAAE,EAAE;YACR,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACnC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvB,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACjC,CAAC,EACD,IAAI,CAAC,UAAU,CAChB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,qBAAqB;QAChC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;aAC3D,MAAM,CAAC,MAAM,CAAC;aACd,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,kBAAkB;QAC7B,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa,CACxB,UAAoD;QAEpD,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAC1B,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;gBACvD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK;gBACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CACnB,YAAuC;QAEvC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;QACzE,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACnB,CAAC;YACD,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;iBAC9C,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;iBACrB,MAAM,EAAE,CAAC;YACZ,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED,eAAe,QAAQ,CAAC"}

package/dist/database/model-hooks.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @file model-hooks.ts
+ * @description Static Lifecycle Hook system for AeroJS Models. Inspired by @adonisjs/lucid's
+ * @poppinss/hooks pattern. Supports multiple handlers per event, async execution,
+ * decorator-based registration, and one-time hooks.
+ *
+ * Hospital use:
+ *   @beforeSave()  → auto hash password before every save
+ *   @beforeCreate() → generate MRN (Medical Record Number)
+ *   @afterCreate() → send welcome SMS to new patient
+ *   @beforeDelete() → block hard-delete on financial records
+ *   @afterUpdate()  → write immutable audit trail
+ */
+export type ModelHookEvent = 'beforeCreate' | 'afterCreate' | 'beforeSave' | 'afterSave' | 'beforeUpdate' | 'afterUpdate' | 'beforeDelete' | 'afterDelete' | 'beforeFind' | 'afterFind' | 'beforeFetch' | 'afterFetch';
+export type ModelHookHandler<T = any> = (instance: T) => Promise<void> | void;
+export declare class ModelHookRegistry {
+    private handlers;
+    /**
+     * Register a hook handler.
+     */
+    add(event: ModelHookEvent, handler: ModelHookHandler): void;
+    /**
+     * Execute all handlers for a given hook event in order.
+     */
+    execute(event: ModelHookEvent, instance: any): Promise<void>;
+    /**
+     * Remove all handlers for a specific event.
+     */
+    clear(event?: ModelHookEvent): void;
+    /**
+     * Returns a copy of all registered hooks (for inspection/testing).
+     */
+    all(): Map<ModelHookEvent, ModelHookHandler[]>;
+}
+/**
+ * Gets or creates the ModelHookRegistry for a given Model class.
+ */
+export declare function getHookRegistry(ModelClass: Function): ModelHookRegistry;
+export declare const beforeCreate: () => MethodDecorator;
+export declare const afterCreate: () => MethodDecorator;
+export declare const beforeSave: () => MethodDecorator;
+export declare const afterSave: () => MethodDecorator;
+export declare const beforeUpdate: () => MethodDecorator;
+export declare const afterUpdate: () => MethodDecorator;
+export declare const beforeDelete: () => MethodDecorator;
+export declare const afterDelete: () => MethodDecorator;
+export declare const beforeFind: () => MethodDecorator;
+export declare const afterFind: () => MethodDecorator;
+export declare const beforeFetch: () => MethodDecorator;
+export declare const afterFetch: () => MethodDecorator;
+/**
+ * Register a hook handler programmatically (no decorator needed).
+ *
+ * @example
+ * // In server.ts or a service provider:
+ * registerHook(Invoice, 'beforeDelete', async (invoice) => {
+ *   await AuditTrail.log({ action: 'VOID', recordId: invoice.id });
+ * });
+ */
+export declare function registerHook<T = any>(ModelClass: Function, event: ModelHookEvent, handler: ModelHookHandler<T>): void;
+//# sourceMappingURL=model-hooks.d.ts.map

package/dist/database/model-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-hooks.d.ts","sourceRoot":"","sources":["../../src/database/model-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,cAAc,GACd,aAAa,GACb,YAAY,GACZ,WAAW,GACX,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAI9E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAiD;IAEjE;;OAEG;IACI,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAOlE;;OAEG;IACU,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI;IAQ1C;;OAEG;IACI,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAC;CAGtD;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,QAAQ,GAAG,iBAAiB,CAKvE;AAuCD,eAAO,MAAM,YAAY,QAVH,eAUyC,CAAC;AAChE,eAAO,MAAM,WAAW,QAXF,eAWwC,CAAC;AAC/D,eAAO,MAAM,UAAU,QAZD,eAYuC,CAAC;AAC9D,eAAO,MAAM,SAAS,QAbA,eAasC,CAAC;AAC7D,eAAO,MAAM,YAAY,QAdH,eAcyC,CAAC;AAChE,eAAO,MAAM,WAAW,QAfF,eAewC,CAAC;AAC/D,eAAO,MAAM,YAAY,QAhBH,eAgByC,CAAC;AAChE,eAAO,MAAM,WAAW,QAjBF,eAiBwC,CAAC;AAC/D,eAAO,MAAM,UAAU,QAlBD,eAkBuC,CAAC;AAC9D,eAAO,MAAM,SAAS,QAnBA,eAmBsC,CAAC;AAC7D,eAAO,MAAM,WAAW,QApBF,eAoBwC,CAAC;AAC/D,eAAO,MAAM,UAAU,QArBD,eAqBuC,CAAC;AAI9D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,GAAG,EAClC,UAAU,EAAE,QAAQ,EACpB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,IAAI,CAEN"}