@xacos/orm 1.0.0

package/dist/factories/Factory.js

@@ -0,0 +1,48 @@
+import { faker } from '@faker-js/faker';
+class FactoryBuilder {
+    constructor(count) {
+        this.count = count;
+    }
+    /**
+     * Create `count` instances of a model using the provided definition function.
+     *
+     * @example
+     * await Factory.times(10).create(User, () => ({
+     *   name: Factory.faker.person.fullName(),
+     *   email: Factory.faker.internet.email(),
+     * }));
+     */
+    async create(ModelClass, definition) {
+        const results = [];
+        for (let i = 0; i < this.count; i++) {
+            const data = await definition();
+            const instance = await ModelClass.create(data);
+            results.push(instance);
+        }
+        return results;
+    }
+    /**
+     * Build plain objects without persisting to DB.
+     * Useful for unit tests that don't need a DB.
+     */
+    async build(definition) {
+        const results = [];
+        for (let i = 0; i < this.count; i++) {
+            results.push((await definition()));
+        }
+        return results;
+    }
+}
+export class Factory {
+    /** Access Faker directly: Factory.faker.person.fullName() */
+    static { this.faker = faker; }
+    static times(count) {
+        return new FactoryBuilder(count);
+    }
+    /** Shorthand for Factory.times(1).create(...) */
+    static async create(ModelClass, definition) {
+        const [result] = await Factory.times(1).create(ModelClass, definition);
+        return result;
+    }
+}
+//# sourceMappingURL=Factory.js.map

package/dist/factories/Factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.js","sourceRoot":"","sources":["../../src/factories/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKxC,MAAM,cAAc;IAClB,YAAoB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAErC;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,UAAoE,EACpE,UAA2B;QAE3B,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,UAAU,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,IAAkB,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,QAAa,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAI,UAA2B;QACxC,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,UAAU,EAAE,CAAM,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,OAAO;IAClB,6DAA6D;aACtD,UAAK,GAAG,KAAK,CAAC;IAErB,MAAM,CAAC,KAAK,CAAC,KAAa;QACxB,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,UAAoE,EACpE,UAA2B;QAE3B,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACvE,OAAO,MAAO,CAAC;IACjB,CAAC"}

package/dist/factories/Factory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Factory.test.d.ts.map

package/dist/factories/Factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.test.d.ts","sourceRoot":"","sources":["../../src/factories/Factory.test.ts"],"names":[],"mappings":""}

package/dist/factories/Factory.test.js

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'bun:test';
+import { Factory } from './Factory';
+describe('Factory', () => {
+    it('builds N plain objects', async () => {
+        const items = await Factory.times(3).build(() => ({
+            name: Factory.faker.person.fullName(),
+        }));
+        expect(items).toHaveLength(3);
+        expect(typeof items[0]?.name).toBe('string');
+    });
+    it('times(0) returns empty array', async () => {
+        const items = await Factory.times(0).build(() => ({ x: 1 }));
+        expect(items).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=Factory.test.js.map

package/dist/factories/Factory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.test.js","sourceRoot":"","sources":["../../src/factories/Factory.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;QACtC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAChD,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;SACtC,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { initDb, closeDb, getKnex, initMongo, initOrmFromEnv, getMongoose, isKnexInitialized, isMongooseConnected, type InitDbOptions, type InitMongoOptions } from "./connection/db";
+export { buildKnexConfig } from "./connection/drivers";
+export { buildMongoUri } from "./connection/mongoUri";
+export { XModel, RelationScope } from "./XModel";
+export { default } from "./XModel";
+export { XMongoModel } from "./XMongoModel";
+export * from "./decorators";
+export { Migration } from "./migrations/Migration";
+export { Schema } from "./migrations/Schema";
+export { MigrationRunner } from "./migrations/MigrationRunner";
+export { augmentTable, type XCreateTableBuilder } from "./migrations/columnHelpers";
+export { Seeder } from "./seeders/Seeder";
+export { SeederRunner } from "./seeders/SeederRunner";
+export { Factory } from "./factories/Factory";
+export { paginate } from "./utils/paginate";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtL,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export { initDb, closeDb, getKnex, initMongo, initOrmFromEnv, getMongoose, isKnexInitialized, isMongooseConnected } from "./connection/db";
+export { buildKnexConfig } from "./connection/drivers";
+export { buildMongoUri } from "./connection/mongoUri";
+export { XModel, RelationScope } from "./XModel";
+export { default } from "./XModel";
+export { XMongoModel } from "./XMongoModel";
+export * from "./decorators";
+export { Migration } from "./migrations/Migration";
+export { Schema } from "./migrations/Schema";
+export { MigrationRunner } from "./migrations/MigrationRunner";
+export { augmentTable } from "./migrations/columnHelpers";
+export { Seeder } from "./seeders/Seeder";
+export { SeederRunner } from "./seeders/SeederRunner";
+export { Factory } from "./factories/Factory";
+export { paginate } from "./utils/paginate";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAA6C,MAAM,iBAAiB,CAAC;AACtL,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAA4B,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/migrations/Migration.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.d.ts","sourceRoot":"","sources":["../../src/migrations/Migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1C,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC7C"}

package/dist/migrations/Migration.js

@@ -0,0 +1,3 @@
+export class Migration {
+}
+//# sourceMappingURL=Migration.js.map

package/dist/migrations/Migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migration.js","sourceRoot":"","sources":["../../src/migrations/Migration.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,SAAS;CAI9B"}

package/dist/migrations/MigrationRunner.d.ts

@@ -0,0 +1,14 @@
+export declare class MigrationRunner {
+    private readonly schema;
+    private ensureMigrationsTable;
+    getPending(migrationsDir: string): Promise<string[]>;
+    run(migrationsDir: string): Promise<void>;
+    rollback(migrationsDir: string): Promise<void>;
+    fresh(migrationsDir: string): Promise<void>;
+    status(migrationsDir: string): Promise<Array<{
+        name: string;
+        ran: boolean;
+        batch?: number | undefined;
+    }>>;
+}
+//# sourceMappingURL=MigrationRunner.d.ts.map

package/dist/migrations/MigrationRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner.d.ts","sourceRoot":"","sources":["../../src/migrations/MigrationRunner.ts"],"names":[],"mappings":"AA6CA,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;YAEzB,qBAAqB;IAa7B,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBpD,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B9C,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CA0BhH"}

package/dist/migrations/MigrationRunner.js

@@ -0,0 +1,142 @@
+import { readdirSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { getKnex } from "../connection/db";
+import { Schema } from "./Schema";
+async function listUserTables(knex) {
+    const client = knex.client.config.client;
+    if (client === "better-sqlite3" || client === "sqlite3") {
+        const rows = (await knex
+            .select("name")
+            .from("sqlite_master")
+            .where("type", "table")
+            .whereNotIn("name", ["sqlite_sequence", "sqlite_stat1"]));
+        return rows.map((row) => row.name);
+    }
+    if (client === "mysql2" || client === "mysql") {
+        const dbName = knex.client.config.connection.database;
+        if (!dbName)
+            return [];
+        const rows = (await knex
+            .select("TABLE_NAME")
+            .from("information_schema.tables")
+            .where({
+            table_schema: dbName,
+            table_type: "BASE TABLE",
+        }));
+        return rows.map((row) => row.TABLE_NAME);
+    }
+    if (client === "pg") {
+        const rows = (await knex
+            .select("tablename")
+            .from("pg_tables")
+            .where("schemaname", "public"));
+        return rows.map((row) => row.tablename);
+    }
+    throw new Error(`[XAOCS ORM] Unsupported SQL client for migrations: ${String(client)}`);
+}
+export class MigrationRunner {
+    constructor() {
+        this.schema = new Schema();
+    }
+    async ensureMigrationsTable() {
+        const knex = getKnex();
+        const exists = await knex.schema.hasTable("xacos_migrations");
+        if (exists)
+            return;
+        await knex.schema.createTable("xacos_migrations", (table) => {
+            table.increments("id").primary();
+            table.string("name", 255).notNullable();
+            table.integer("batch").notNullable();
+            table.timestamp("ran_at").defaultTo(knex.fn.now());
+        });
+    }
+    async getPending(migrationsDir) {
+        await this.ensureMigrationsTable();
+        const knex = getKnex();
+        const ranRows = (await knex.select("name").from("xacos_migrations"));
+        const ran = new Set(ranRows.map((row) => row.name));
+        let files;
+        try {
+            files = readdirSync(migrationsDir);
+        }
+        catch {
+            return [];
+        }
+        return files
+            .filter((file) => file.endsWith(".ts") || file.endsWith(".js"))
+            .filter((file) => !ran.has(file))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    async run(migrationsDir) {
+        await this.ensureMigrationsTable();
+        const knex = getKnex();
+        const pending = await this.getPending(migrationsDir);
+        if (pending.length === 0)
+            return;
+        const lastBatchRow = await knex("xacos_migrations").max({ b: "batch" }).first();
+        const batch = Number(lastBatchRow?.b ?? 0) + 1;
+        for (const file of pending) {
+            const abs = join(migrationsDir, file);
+            const mod = (await import(pathToFileURL(abs).href));
+            const MigrationClass = mod.default;
+            if (!MigrationClass) {
+                throw new Error(`[XAOCS ORM] Migration file must default-export a Migration class: ${file}`);
+            }
+            const migration = new MigrationClass();
+            await migration.up(this.schema);
+            await knex("xacos_migrations").insert({ name: file, batch, ran_at: knex.fn.now() });
+        }
+    }
+    async rollback(migrationsDir) {
+        await this.ensureMigrationsTable();
+        const knex = getKnex();
+        const lastBatchRow = await knex("xacos_migrations").max({ b: "batch" }).first();
+        const lastBatch = Number(lastBatchRow?.b ?? 0);
+        if (!lastBatch)
+            return;
+        const rows = (await knex("xacos_migrations").where("batch", lastBatch).orderBy("id", "desc"));
+        const schema = new Schema();
+        for (const row of rows) {
+            const abs = join(migrationsDir, row.name);
+            const mod = (await import(pathToFileURL(abs).href));
+            const MigrationClass = mod.default;
+            if (!MigrationClass) {
+                throw new Error(`[XAOCS ORM] Migration file must default-export a Migration class: ${row.name}`);
+            }
+            const migration = new MigrationClass();
+            await migration.down(schema);
+            await knex("xacos_migrations").where("id", row.id).del();
+        }
+    }
+    async fresh(migrationsDir) {
+        const knex = getKnex();
+        const tables = await listUserTables(knex);
+        for (const name of tables) {
+            await knex.schema.dropTableIfExists(name);
+        }
+        await this.run(migrationsDir);
+    }
+    async status(migrationsDir) {
+        await this.ensureMigrationsTable();
+        const knex = getKnex();
+        const ranRows = (await knex.select("name", "batch").from("xacos_migrations"));
+        const ranMap = new Map(ranRows.map((row) => [row.name, row.batch]));
+        let files;
+        try {
+            files = readdirSync(migrationsDir);
+        }
+        catch {
+            files = [];
+        }
+        const migrationFiles = files
+            .filter((file) => file.endsWith(".ts") || file.endsWith(".js"))
+            .sort((a, b) => a.localeCompare(b));
+        return migrationFiles.map((file) => ({
+            name: file,
+            ran: ranMap.has(file),
+            batch: ranMap.get(file),
+        }));
+    }
+}
+//# sourceMappingURL=MigrationRunner.js.map

package/dist/migrations/MigrationRunner.js.map

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

package/dist/migrations/MigrationRunner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MigrationRunner.test.d.ts.map

package/dist/migrations/MigrationRunner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner.test.d.ts","sourceRoot":"","sources":["../../src/migrations/MigrationRunner.test.ts"],"names":[],"mappings":""}

package/dist/migrations/MigrationRunner.test.js

@@ -0,0 +1,26 @@
+import { afterAll, beforeAll, describe, expect, it } from "bun:test";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { closeDb, getKnex, initDb, MigrationRunner } from "../index";
+describe("MigrationRunner", () => {
+    const fixturesDir = join(fileURLToPath(new URL(".", import.meta.url)), "..", "..", "test-fixtures", "migrations");
+    beforeAll(() => {
+        initDb({ __memorySqlite: true });
+    });
+    afterAll(async () => {
+        await closeDb();
+    });
+    it("runs pending migrations, rolls back the last batch, and reapplies on fresh", async () => {
+        const runner = new MigrationRunner();
+        const knex = getKnex();
+        await runner.run(fixturesDir);
+        expect(await knex.schema.hasTable("migration_test")).toBe(true);
+        expect((await runner.getPending(fixturesDir)).length).toBe(0);
+        await runner.rollback(fixturesDir);
+        expect(await knex.schema.hasTable("migration_test")).toBe(false);
+        await runner.fresh(fixturesDir);
+        expect(await knex.schema.hasTable("migration_test")).toBe(true);
+        expect(await knex.schema.hasTable("xacos_migrations")).toBe(true);
+    });
+});
+//# sourceMappingURL=MigrationRunner.test.js.map

package/dist/migrations/MigrationRunner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationRunner.test.js","sourceRoot":"","sources":["../../src/migrations/MigrationRunner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAErE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IAElH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QAEvB,MAAM,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE9D,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjE,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/migrations/Schema.d.ts

@@ -0,0 +1,7 @@
+import { type XCreateTableBuilder } from "./columnHelpers";
+export declare class Schema {
+    createTable(name: string, callback: (table: XCreateTableBuilder) => void): Promise<void>;
+    dropTable(name: string): Promise<void>;
+    hasTable(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=Schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/migrations/Schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,qBAAa,MAAM;IACX,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/C"}

package/dist/migrations/Schema.js

@@ -0,0 +1,17 @@
+import { getKnex } from "../connection/db";
+import { augmentTable } from "./columnHelpers";
+export class Schema {
+    async createTable(name, callback) {
+        const knex = getKnex();
+        await knex.schema.createTable(name, (table) => {
+            callback(augmentTable(table, knex));
+        });
+    }
+    async dropTable(name) {
+        await getKnex().schema.dropTableIfExists(name);
+    }
+    async hasTable(name) {
+        return getKnex().schema.hasTable(name);
+    }
+}
+//# sourceMappingURL=Schema.js.map

package/dist/migrations/Schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.js","sourceRoot":"","sources":["../../src/migrations/Schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAA4B,MAAM,iBAAiB,CAAC;AAEzE,MAAM,OAAO,MAAM;IACjB,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,QAA8C;QAC5E,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5C,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,MAAM,OAAO,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/migrations/columnHelpers.d.ts

@@ -0,0 +1,9 @@
+import type { Knex } from "knex";
+/** Augmented table builder: use `xacosTimestamps()` / `xacosSoftDeletes()` to avoid clashing with Knex's `timestamps()`. */
+export type XCreateTableBuilder = Knex.CreateTableBuilder & {
+    id(): void;
+    xacosTimestamps(): void;
+    xacosSoftDeletes(): void;
+};
+export declare function augmentTable(table: Knex.CreateTableBuilder, knex: Knex): XCreateTableBuilder;
+//# sourceMappingURL=columnHelpers.d.ts.map

package/dist/migrations/columnHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnHelpers.d.ts","sourceRoot":"","sources":["../../src/migrations/columnHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,4HAA4H;AAC5H,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,GAAG;IAC1D,EAAE,IAAI,IAAI,CAAC;IACX,eAAe,IAAI,IAAI,CAAC;IACxB,gBAAgB,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,IAAI,GAAG,mBAAmB,CAiB5F"}

package/dist/migrations/columnHelpers.js

@@ -0,0 +1,15 @@
+export function augmentTable(table, knex) {
+    const extended = table;
+    extended.id = () => {
+        table.bigIncrements("id").primary();
+    };
+    extended.xacosTimestamps = () => {
+        table.timestamp("created_at").defaultTo(knex.fn.now()).notNullable();
+        table.timestamp("updated_at").defaultTo(knex.fn.now()).notNullable();
+    };
+    extended.xacosSoftDeletes = () => {
+        table.timestamp("deleted_at").nullable();
+    };
+    return extended;
+}
+//# sourceMappingURL=columnHelpers.js.map

package/dist/migrations/columnHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnHelpers.js","sourceRoot":"","sources":["../../src/migrations/columnHelpers.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,KAA8B,EAAE,IAAU;IACrE,MAAM,QAAQ,GAAG,KAA4B,CAAC;IAE9C,QAAQ,CAAC,EAAE,GAAG,GAAG,EAAE;QACjB,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC,CAAC;IAEF,QAAQ,CAAC,eAAe,GAAG,GAAG,EAAE;QAC9B,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,GAAG,GAAG,EAAE;QAC/B,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/seeders/Seeder.d.ts

@@ -0,0 +1,8 @@
+export declare abstract class Seeder {
+    /**
+     * Implement this method with your seed logic.
+     * Called by the SeederRunner when `xacos db:seed` is invoked.
+     */
+    abstract run(): Promise<void>;
+}
+//# sourceMappingURL=Seeder.d.ts.map

package/dist/seeders/Seeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Seeder.d.ts","sourceRoot":"","sources":["../../src/seeders/Seeder.ts"],"names":[],"mappings":"AAAA,8BAAsB,MAAM;IAC1B;;;OAGG;IACH,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAC9B"}

package/dist/seeders/Seeder.js

@@ -0,0 +1,3 @@
+export class Seeder {
+}
+//# sourceMappingURL=Seeder.js.map

package/dist/seeders/Seeder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Seeder.js","sourceRoot":"","sources":["../../src/seeders/Seeder.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,MAAM;CAM3B"}

package/dist/seeders/SeederRunner.d.ts

@@ -0,0 +1,20 @@
+export declare class SeederRunner {
+    private seedersDir;
+    constructor(seedersDir: string);
+    /**
+     * Run a specific seeder by class name.
+     * e.g. runOne('UserSeeder')
+     */
+    runOne(name: string): Promise<void>;
+    /**
+     * Run all seeders in the seeders directory, in alphabetical order.
+     */
+    runAll(): Promise<void>;
+    /**
+     * Scan the seeders directory and return file names sorted correctly.
+     * Files prefixed with numbers sort numerically: 001_, 002_, etc.
+     * Files without prefix sort alphabetically after numbered ones.
+     */
+    private getSortedFiles;
+}
+//# sourceMappingURL=SeederRunner.d.ts.map

package/dist/seeders/SeederRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeederRunner.d.ts","sourceRoot":"","sources":["../../src/seeders/SeederRunner.ts"],"names":[],"mappings":"AAIA,qBAAa,YAAY;IACX,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAEtC;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BzC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAa7B;;;;OAIG;IACH,OAAO,CAAC,cAAc;CAevB"}

package/dist/seeders/SeederRunner.js

@@ -0,0 +1,68 @@
+import { resolve } from 'path';
+import { existsSync, readdirSync } from 'fs';
+export class SeederRunner {
+    constructor(seedersDir) {
+        this.seedersDir = seedersDir;
+    }
+    /**
+     * Run a specific seeder by class name.
+     * e.g. runOne('UserSeeder')
+     */
+    async runOne(name) {
+        const path = resolve(this.seedersDir, `${name}.ts`);
+        const jsPath = resolve(this.seedersDir, `${name}.js`);
+        let targetPath = path;
+        if (!existsSync(path)) {
+            if (existsSync(jsPath)) {
+                targetPath = jsPath;
+            }
+            else {
+                throw new Error(`[XAOCS] Seeder not found: ${name} at ${path}`);
+            }
+        }
+        const mod = await import(targetPath);
+        const SeederClass = mod.default ?? mod[name];
+        if (!SeederClass) {
+            throw new Error(`[XAOCS] Seeder class not exported from ${name}.ts`);
+        }
+        const instance = new SeederClass();
+        console.log(`  ▶ Running seeder: ${name}`);
+        await instance.run();
+        console.log(`  ✓ Done: ${name}`);
+    }
+    /**
+     * Run all seeders in the seeders directory, in alphabetical order.
+     */
+    async runAll() {
+        const files = this.getSortedFiles();
+        if (files.length === 0) {
+            console.log('[XAOCS] No seeder files found.');
+            return;
+        }
+        for (const file of files) {
+            const name = file.replace(/\.(ts|js)$/, '');
+            await this.runOne(name);
+        }
+    }
+    /**
+     * Scan the seeders directory and return file names sorted correctly.
+     * Files prefixed with numbers sort numerically: 001_, 002_, etc.
+     * Files without prefix sort alphabetically after numbered ones.
+     */
+    getSortedFiles() {
+        const fullPath = resolve(this.seedersDir);
+        if (!existsSync(fullPath))
+            return [];
+        return readdirSync(fullPath)
+            .filter((f) => f.endsWith('.ts') || f.endsWith('.js'))
+            .sort((a, b) => {
+            // Extract leading number if present: "001_UserSeeder.ts" → 1
+            const numA = parseInt(a.match(/^(\d+)/)?.[1] ?? 'Infinity', 10);
+            const numB = parseInt(b.match(/^(\d+)/)?.[1] ?? 'Infinity', 10);
+            if (numA !== numB)
+                return numA - numB;
+            return a.localeCompare(b);
+        });
+    }
+}
+//# sourceMappingURL=SeederRunner.js.map

package/dist/seeders/SeederRunner.js.map

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

package/dist/seeders/SeederRunner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SeederRunner.test.d.ts.map

package/dist/seeders/SeederRunner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeederRunner.test.d.ts","sourceRoot":"","sources":["../../src/seeders/SeederRunner.test.ts"],"names":[],"mappings":""}

package/dist/seeders/SeederRunner.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
+import { SeederRunner } from './SeederRunner';
+import { writeFileSync, mkdirSync, rmSync } from 'fs';
+import { resolve } from 'path';
+const TMP = resolve('./tmp-seeders-test');
+describe('SeederRunner', () => {
+    beforeEach(() => {
+        mkdirSync(TMP, { recursive: true });
+        writeFileSync(`${TMP}/TestSeeder.ts`, `export default class TestSeeder { async run() { (global as any).__seederRan = true; } }`);
+    });
+    afterEach(() => rmSync(TMP, { recursive: true, force: true }));
+    it('throws when seeder file does not exist', async () => {
+        const runner = new SeederRunner(TMP);
+        await expect(runner.runOne('NonExistent')).rejects.toThrow('Seeder not found');
+    });
+    it('runs a single seeder', async () => {
+        const runner = new SeederRunner(TMP);
+        global.__seederRan = false;
+        await runner.runOne('TestSeeder');
+        expect(global.__seederRan).toBe(true);
+    });
+    it('runs all seeders in directory', async () => {
+        writeFileSync(`${TMP}/AnotherSeeder.ts`, `export default class AnotherSeeder { async run() { (global as any).__anotherRan = true; } }`);
+        const runner = new SeederRunner(TMP);
+        global.__seederRan = false;
+        global.__anotherRan = false;
+        await runner.runAll();
+        expect(global.__seederRan).toBe(true);
+        expect(global.__anotherRan).toBe(true);
+    });
+    it('sorts seeders: numbered before alpha', async () => {
+        // create files in reverse to ensure sorting matters
+        writeFileSync(`${TMP}/ZebraSeeder.ts`, 'export default class ZebraSeeder { async run() { (global as any).__order.push("zebra"); } }');
+        writeFileSync(`${TMP}/001_UserSeeder.ts`, 'export default class UserSeeder { async run() { (global as any).__order.push("user"); } }');
+        writeFileSync(`${TMP}/002_PostSeeder.ts`, 'export default class PostSeeder { async run() { (global as any).__order.push("post"); } }');
+        const runner = new SeederRunner(TMP);
+        global.__order = [];
+        // We need to clear out the default seeders created in beforeEach if they interfere
+        rmSync(resolve(TMP, 'TestSeeder.ts'));
+        await runner.runAll();
+        expect(global.__order).toEqual(['user', 'post', 'zebra']);
+    });
+});
+//# sourceMappingURL=SeederRunner.test.js.map

package/dist/seeders/SeederRunner.test.js.map

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