@xacos/orm 1.0.0

package/dist/__tests__/sqlite.integration.test.js

@@ -0,0 +1,106 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'bun:test';
+import { initDb, getKnex, closeDb } from '../connection/db';
+import { XModel } from '../XModel';
+import { Column } from '../decorators';
+import { unlinkSync, existsSync } from 'fs';
+const DB_PATH = './tmp-test.sqlite';
+process.env['DB_DRIVER'] = 'sqlite';
+process.env['DB_PATH'] = DB_PATH;
+class TestUser extends XModel {
+    static { this.table = 'test_users'; }
+}
+__decorate([
+    Column()
+], TestUser.prototype, "id", void 0);
+__decorate([
+    Column()
+], TestUser.prototype, "name", void 0);
+__decorate([
+    Column()
+], TestUser.prototype, "email", void 0);
+__decorate([
+    Column()
+], TestUser.prototype, "created_at", void 0);
+__decorate([
+    Column()
+], TestUser.prototype, "updated_at", void 0);
+beforeAll(async () => {
+    initDb();
+    const knex = getKnex();
+    // Create the test table directly
+    await knex.schema.createTableIfNotExists('test_users', t => {
+        t.increments('id');
+        t.string('name').notNullable();
+        t.string('email').notNullable().unique();
+        t.timestamps(true, true);
+    });
+});
+afterAll(async () => {
+    await closeDb();
+    if (existsSync(DB_PATH))
+        unlinkSync(DB_PATH);
+});
+beforeEach(async () => {
+    await getKnex()('test_users').delete();
+});
+describe('SQLite Integration — XModel', () => {
+    it('creates a record', async () => {
+        const user = await TestUser.create({ name: 'Alice', email: 'alice@test.com' });
+        expect(user.id).toBeGreaterThan(0);
+        expect(user.name).toBe('Alice');
+    });
+    it('finds a record by id', async () => {
+        const created = await TestUser.create({ name: 'Bob', email: 'bob@test.com' });
+        const found = await TestUser.find(created.id);
+        expect(found).not.toBeNull();
+        expect(found.name).toBe('Bob');
+    });
+    it('returns null for missing id', async () => {
+        const found = await TestUser.find(9999);
+        expect(found).toBeNull();
+    });
+    it('findOrFail throws for missing id', async () => {
+        await expect(TestUser.findOrFail(9999)).rejects.toThrow();
+    });
+    it('queries with where()', async () => {
+        await TestUser.create({ name: 'Carol', email: 'carol@test.com' });
+        await TestUser.create({ name: 'Dave', email: 'dave@test.com' });
+        const results = await TestUser.where('name', 'Carol').select();
+        expect(results).toHaveLength(1);
+        expect(results[0].name).toBe('Carol');
+    });
+    it('returns all records', async () => {
+        await TestUser.create({ name: 'Eve', email: 'eve@test.com' });
+        await TestUser.create({ name: 'Frank', email: 'frank@test.com' });
+        const all = await TestUser.all();
+        expect(all.length).toBeGreaterThanOrEqual(2);
+    });
+    it('updates a record', async () => {
+        const user = await TestUser.create({ name: 'Grace', email: 'grace@test.com' });
+        await TestUser.update(user.id, { name: 'Grace Updated' });
+        const updated = await TestUser.find(user.id);
+        expect(updated.name).toBe('Grace Updated');
+    });
+    it('deletes a record', async () => {
+        const user = await TestUser.create({ name: 'Heidi', email: 'heidi@test.com' });
+        await TestUser.destroy(user.id);
+        const found = await TestUser.find(user.id);
+        expect(found).toBeNull();
+    });
+    it('paginates results', async () => {
+        for (let i = 0; i < 20; i++) {
+            await TestUser.create({ name: `User${i}`, email: `user${i}@test.com` });
+        }
+        const page = await TestUser.paginate(1, 5);
+        expect(page.data).toHaveLength(5);
+        expect(page.total).toBe(20);
+        expect(page.lastPage).toBe(4);
+    });
+});
+//# sourceMappingURL=sqlite.integration.test.js.map

package/dist/__tests__/sqlite.integration.test.js.map

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

package/dist/connection/db.d.ts

@@ -0,0 +1,25 @@
+import { type Knex } from "knex";
+import mongoose from "mongoose";
+export type InitDbOptions = {
+    readonly __memorySqlite: true;
+} | Knex.Config;
+export declare function isKnexInitialized(): boolean;
+export declare function isMongooseConnected(): boolean;
+export declare function initDb(config?: InitDbOptions): Knex;
+export declare function getKnex(): Knex;
+export type InitMongoOptions = Readonly<{
+    uri?: string;
+    /** Passed to `mongoose.connect` (pool size, timeouts, TLS, etc.). */
+    connectOptions?: mongoose.ConnectOptions;
+}>;
+/**
+ * Connect Mongoose (MongoDB). Does not use Knex; do not run SQL migrations — define schemas on {@link XMongoModel} instead.
+ */
+export declare function initMongo(options?: InitMongoOptions): Promise<typeof mongoose>;
+/**
+ * Auto-select Knex vs Mongoose from `DB_DRIVER` (mongodb → Mongoose, otherwise → Knex).
+ */
+export declare function initOrmFromEnv(): Promise<"knex" | "mongoose">;
+export declare function getMongoose(): typeof mongoose;
+export declare function closeDb(): Promise<void>;
+//# sourceMappingURL=db.d.ts.map

package/dist/connection/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/connection/db.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,KAAK,IAAI,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,QAAQ,MAAM,UAAU,CAAC;AAMhC,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAA;CAAE,GACjC,IAAI,CAAC,MAAM,CAAC;AAEhB,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAqCnD;AAED,wBAAgB,OAAO,IAAI,IAAI,CAU9B;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC;CAC1C,CAAC,CAAC;AAEH;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAgBpF;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAQnE;AAED,wBAAgB,WAAW,IAAI,OAAO,QAAQ,CAK7C;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7C"}

package/dist/connection/db.js

@@ -0,0 +1,100 @@
+import knex from "knex";
+import mongoose from "mongoose";
+import { buildKnexConfig } from "./drivers";
+import { buildMongoUri } from "./mongoUri";
+let knexInstance = null;
+export function isKnexInitialized() {
+    return knexInstance !== null;
+}
+export function isMongooseConnected() {
+    return mongoose.connection.readyState === 1;
+}
+export function initDb(config) {
+    if (mongoose.connection.readyState === 1) {
+        throw new Error("[XAOCS ORM] Cannot initialize Knex while Mongoose is connected. Call closeDb() first.");
+    }
+    const driver = process.env["DB_DRIVER"] ?? "sqlite";
+    if (!config && driver === "mongodb") {
+        throw new Error("[XAOCS ORM] DB_DRIVER is mongodb: use await initMongo() for Mongoose. Knex SQL migrations are not used with MongoDB.");
+    }
+    if (knexInstance) {
+        return knexInstance;
+    }
+    let knexConfig;
+    if (config && typeof config === "object" && "__memorySqlite" in config && config.__memorySqlite) {
+        knexConfig = {
+            client: "sqlite3",
+            connection: {
+                filename: ":memory:",
+            },
+            useNullAsDefault: true,
+            pool: {
+                min: 1,
+                max: 1,
+            },
+        };
+    }
+    else if (config && typeof config === "object" && "client" in config) {
+        knexConfig = config;
+    }
+    else {
+        knexConfig = buildKnexConfig();
+    }
+    knexInstance = knex(knexConfig);
+    return knexInstance;
+}
+export function getKnex() {
+    if (knexInstance) {
+        return knexInstance;
+    }
+    if (mongoose.connection.readyState === 1) {
+        throw new Error("[XAOCS ORM] Knex is not initialized; Mongoose is active. SQL helpers and MigrationRunner require Knex — with MongoDB define schemas on XMongoModel subclasses instead of migrations.");
+    }
+    throw new Error("[XAOCS ORM] DB not initialized. Call initDb() or await initMongo() first.");
+}
+/**
+ * Connect Mongoose (MongoDB). Does not use Knex; do not run SQL migrations — define schemas on {@link XMongoModel} instead.
+ */
+export async function initMongo(options) {
+    if (knexInstance) {
+        throw new Error("[XAOCS ORM] Cannot connect Mongoose while Knex is active. Call closeDb() first.");
+    }
+    if (mongoose.connection.readyState === 1) {
+        return mongoose;
+    }
+    const uri = options?.uri ?? buildMongoUri();
+    const defaults = {
+        serverSelectionTimeoutMS: 10_000,
+        maxPoolSize: 10,
+    };
+    await mongoose.connect(uri, { ...defaults, ...options?.connectOptions });
+    return mongoose;
+}
+/**
+ * Auto-select Knex vs Mongoose from `DB_DRIVER` (mongodb → Mongoose, otherwise → Knex).
+ */
+export async function initOrmFromEnv() {
+    const driver = process.env["DB_DRIVER"] ?? "sqlite";
+    if (driver === "mongodb") {
+        await initMongo();
+        return "mongoose";
+    }
+    initDb();
+    return "knex";
+}
+export function getMongoose() {
+    if (mongoose.connection.readyState !== 1) {
+        throw new Error("[XAOCS ORM] Mongoose is not connected. Call await initMongo() first.");
+    }
+    return mongoose;
+}
+export async function closeDb() {
+    if (knexInstance) {
+        await knexInstance.destroy();
+        knexInstance = null;
+    }
+    if (mongoose.connection.readyState !== 0) {
+        await mongoose.disconnect();
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/connection/db.js.map

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

package/dist/connection/drivers.d.ts

@@ -0,0 +1,3 @@
+import type { Knex } from "knex";
+export declare function buildKnexConfig(): Knex.Config;
+//# sourceMappingURL=drivers.d.ts.map

package/dist/connection/drivers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drivers.d.ts","sourceRoot":"","sources":["../../src/connection/drivers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkCjC,wBAAgB,eAAe,IAAI,IAAI,CAAC,MAAM,CA6B7C"}

package/dist/connection/drivers.js

@@ -0,0 +1,58 @@
+function mysqlConnection() {
+    const database = process.env["DB_DATABASE"];
+    const user = process.env["DB_USERNAME"];
+    const password = process.env["DB_PASSWORD"];
+    if (!database || !user) {
+        throw new Error("[XAOCS ORM] DB_DATABASE and DB_USERNAME are required for mysql driver");
+    }
+    return {
+        host: process.env["DB_HOST"] ?? "localhost",
+        port: Number(process.env["DB_PORT"] ?? 3306),
+        database,
+        user,
+        password: password ?? "",
+    };
+}
+function postgresConnection() {
+    const database = process.env["DB_DATABASE"];
+    const user = process.env["DB_USERNAME"];
+    const password = process.env["DB_PASSWORD"];
+    if (!database || !user) {
+        throw new Error("[XAOCS ORM] DB_DATABASE and DB_USERNAME are required for postgres driver");
+    }
+    return {
+        host: process.env["DB_HOST"] ?? "localhost",
+        port: Number(process.env["DB_PORT"] ?? 5432),
+        database,
+        user,
+        password: password ?? "",
+    };
+}
+export function buildKnexConfig() {
+    const driver = process.env["DB_DRIVER"] ?? "sqlite";
+    switch (driver) {
+        case "mysql":
+            return {
+                client: "mysql2",
+                connection: mysqlConnection(),
+            };
+        case "postgres":
+            return {
+                client: "pg",
+                connection: postgresConnection(),
+            };
+        case "sqlite":
+            return {
+                client: "sqlite3",
+                connection: {
+                    filename: process.env["DB_PATH"] ?? "./database/db.sqlite",
+                },
+                useNullAsDefault: true,
+            };
+        case "mongodb":
+            throw new Error("[XAOCS ORM] MongoDB does not use Knex. Set DB_DRIVER=mongodb and call await initMongo() (or initOrmFromEnv()). Define Mongoose schemas on XMongoModel subclasses — SQL migrations do not apply.");
+        default:
+            throw new Error(`[XAOCS ORM] Unsupported driver: ${driver}`);
+    }
+}
+//# sourceMappingURL=drivers.js.map

package/dist/connection/drivers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drivers.js","sourceRoot":"","sources":["../../src/connection/drivers.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,WAAW;QAC3C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAC5C,QAAQ;QACR,IAAI;QACJ,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,WAAW;QAC3C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAC5C,QAAQ;QACR,IAAI;QACJ,QAAQ,EAAE,QAAQ,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC;IAEpD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,eAAe,EAAE;aAC9B,CAAC;QACJ,KAAK,UAAU;YACb,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,kBAAkB,EAAE;aACjC,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE;oBACV,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,sBAAsB;iBAC3D;gBACD,gBAAgB,EAAE,IAAI;aACvB,CAAC;QACJ,KAAK,SAAS;YACZ,MAAM,IAAI,KAAK,CACb,iMAAiM,CAClM,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/connection/mongoUri.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds a Mongo connection URI from env.
+ * Prefer `MONGODB_URI` or `DATABASE_URL` when set.
+ */
+export declare function buildMongoUri(): string;
+//# sourceMappingURL=mongoUri.d.ts.map

package/dist/connection/mongoUri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoUri.d.ts","sourceRoot":"","sources":["../../src/connection/mongoUri.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAmBtC"}

package/dist/connection/mongoUri.js

@@ -0,0 +1,22 @@
+/**
+ * Builds a Mongo connection URI from env.
+ * Prefer `MONGODB_URI` or `DATABASE_URL` when set.
+ */
+export function buildMongoUri() {
+    const direct = process.env["MONGODB_URI"] ?? process.env["DATABASE_URL"];
+    if (direct) {
+        return direct;
+    }
+    const user = process.env["DB_USERNAME"] ?? "";
+    const password = process.env["DB_PASSWORD"] ?? "";
+    const host = process.env["DB_HOST"] ?? "localhost";
+    const port = process.env["DB_PORT"] ?? "27017";
+    const database = process.env["DB_DATABASE"] ?? "xacos";
+    if (user) {
+        const u = encodeURIComponent(user);
+        const p = encodeURIComponent(password);
+        return `mongodb://${u}:${p}@${host}:${port}/${database}`;
+    }
+    return `mongodb://${host}:${port}/${database}`;
+}
+//# sourceMappingURL=mongoUri.js.map

package/dist/connection/mongoUri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoUri.js","sourceRoot":"","sources":["../../src/connection/mongoUri.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC;IAEvD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED,OAAO,aAAa,IAAI,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,47 @@
+export type ModelConstructor = {
+    new (...args: never[]): unknown;
+    readonly table: string;
+};
+export type RelationMeta = Readonly<{
+    kind: "hasMany";
+    related: () => ModelConstructor;
+    foreignKey: string;
+    propertyKey: string;
+}> | Readonly<{
+    kind: "belongsTo";
+    related: () => ModelConstructor;
+    foreignKey: string;
+    propertyKey: string;
+}> | Readonly<{
+    kind: "hasOne";
+    related: () => ModelConstructor;
+    foreignKey: string;
+    propertyKey: string;
+}> | Readonly<{
+    kind: "belongsToMany";
+    related: () => ModelConstructor;
+    pivotTable: string;
+    propertyKey: string;
+}>;
+export type ColumnOptions = Readonly<{
+    hidden?: boolean;
+    default?: unknown;
+}>;
+type StandardDecoratorContext = {
+    kind: string;
+    name: string | symbol;
+    addInitializer?: (initializer: () => void) => void;
+};
+/** Register relation metadata when runtime decorators receive no prototype (e.g. some Bun/TS field transforms). */
+export declare function registerRelation(constructor: object, meta: RelationMeta): void;
+/** Register column metadata without a decorator. */
+export declare function registerColumnMeta(constructor: object, propertyKey: string, options: ColumnOptions): void;
+export declare function HasMany(related: () => ModelConstructor, foreignKey: string): (targetOrInitialValue: object | undefined, propertyKeyOrContext: string | symbol | StandardDecoratorContext) => void;
+export declare function BelongsTo(related: () => ModelConstructor, foreignKey: string): (targetOrInitialValue: object | undefined, propertyKeyOrContext: string | symbol | StandardDecoratorContext) => void;
+export declare function HasOne(related: () => ModelConstructor, foreignKey: string): (targetOrInitialValue: object | undefined, propertyKeyOrContext: string | symbol | StandardDecoratorContext) => void;
+export declare function BelongsToMany(related: () => ModelConstructor, pivotTable: string): (targetOrInitialValue: object | undefined, propertyKeyOrContext: string | symbol | StandardDecoratorContext) => void;
+export declare function Column(options?: ColumnOptions): (targetOrInitialValue: object | undefined, propertyKeyOrContext: string | symbol | StandardDecoratorContext) => void;
+export declare function getColumnOptions(constructor: object, propertyKey: string): ColumnOptions | undefined;
+export declare function getRelations(ctor: object): RelationMeta[];
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

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

package/dist/decorators.js

@@ -0,0 +1,149 @@
+function constructorFromTarget(target) {
+    if (!target || typeof target !== "object") {
+        throw new Error("[XAOCS ORM] Decorators must be applied to class members with a valid prototype target");
+    }
+    const ctor = target.constructor;
+    if (!ctor) {
+        throw new Error("[XAOCS ORM] Decorators require a constructor on the decorated target");
+    }
+    return ctor;
+}
+function isStandardDecoratorContext(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "kind" in value &&
+        "name" in value);
+}
+function pushRelation(constructor, meta) {
+    const ctor = constructor;
+    if (!ctor.__xacosRelations)
+        ctor.__xacosRelations = [];
+    ctor.__xacosRelations.push(meta);
+}
+/** Register relation metadata when runtime decorators receive no prototype (e.g. some Bun/TS field transforms). */
+export function registerRelation(constructor, meta) {
+    pushRelation(constructor, meta);
+}
+/** Register column metadata without a decorator. */
+export function registerColumnMeta(constructor, propertyKey, options) {
+    ensureColumnMap(constructor).set(propertyKey, options);
+}
+function ensureColumnMap(constructor) {
+    const ctor = constructor;
+    if (!ctor.__xacosColumns)
+        ctor.__xacosColumns = new Map();
+    return ctor.__xacosColumns;
+}
+export function HasMany(related, foreignKey) {
+    return (targetOrInitialValue, propertyKeyOrContext) => {
+        if (isStandardDecoratorContext(propertyKeyOrContext)) {
+            const context = propertyKeyOrContext;
+            if (context.kind !== "field" && context.kind !== "accessor")
+                return;
+            const key = String(context.name);
+            context.addInitializer?.(function () {
+                const ctor = constructorFromTarget(this);
+                pushRelation(ctor, { kind: "hasMany", related, foreignKey, propertyKey: key });
+            });
+            return;
+        }
+        const key = String(propertyKeyOrContext);
+        const ctor = constructorFromTarget(targetOrInitialValue);
+        pushRelation(ctor, { kind: "hasMany", related, foreignKey, propertyKey: key });
+    };
+}
+export function BelongsTo(related, foreignKey) {
+    return (targetOrInitialValue, propertyKeyOrContext) => {
+        if (isStandardDecoratorContext(propertyKeyOrContext)) {
+            const context = propertyKeyOrContext;
+            if (context.kind !== "field" && context.kind !== "accessor")
+                return;
+            const key = String(context.name);
+            context.addInitializer?.(function () {
+                const ctor = constructorFromTarget(this);
+                pushRelation(ctor, { kind: "belongsTo", related, foreignKey, propertyKey: key });
+            });
+            return;
+        }
+        const key = String(propertyKeyOrContext);
+        const ctor = constructorFromTarget(targetOrInitialValue);
+        pushRelation(ctor, { kind: "belongsTo", related, foreignKey, propertyKey: key });
+    };
+}
+export function HasOne(related, foreignKey) {
+    return (targetOrInitialValue, propertyKeyOrContext) => {
+        if (isStandardDecoratorContext(propertyKeyOrContext)) {
+            const context = propertyKeyOrContext;
+            if (context.kind !== "field" && context.kind !== "accessor")
+                return;
+            const key = String(context.name);
+            context.addInitializer?.(function () {
+                const ctor = constructorFromTarget(this);
+                pushRelation(ctor, { kind: "hasOne", related, foreignKey, propertyKey: key });
+            });
+            return;
+        }
+        const key = String(propertyKeyOrContext);
+        const ctor = constructorFromTarget(targetOrInitialValue);
+        pushRelation(ctor, { kind: "hasOne", related, foreignKey, propertyKey: key });
+    };
+}
+export function BelongsToMany(related, pivotTable) {
+    return (targetOrInitialValue, propertyKeyOrContext) => {
+        if (isStandardDecoratorContext(propertyKeyOrContext)) {
+            const context = propertyKeyOrContext;
+            if (context.kind !== "field" && context.kind !== "accessor")
+                return;
+            const key = String(context.name);
+            context.addInitializer?.(function () {
+                const ctor = constructorFromTarget(this);
+                pushRelation(ctor, { kind: "belongsToMany", related, pivotTable, propertyKey: key });
+            });
+            return;
+        }
+        const key = String(propertyKeyOrContext);
+        const ctor = constructorFromTarget(targetOrInitialValue);
+        pushRelation(ctor, { kind: "belongsToMany", related, pivotTable, propertyKey: key });
+    };
+}
+export function Column(options = {}) {
+    return (targetOrInitialValue, propertyKeyOrContext) => {
+        if (isStandardDecoratorContext(propertyKeyOrContext)) {
+            const context = propertyKeyOrContext;
+            if (context.kind !== "field" && context.kind !== "accessor") {
+                return;
+            }
+            const key = String(context.name);
+            context.addInitializer?.(function () {
+                const ctor = constructorFromTarget(this);
+                ensureColumnMap(ctor).set(key, options);
+            });
+            return;
+        }
+        const key = String(propertyKeyOrContext);
+        const ctor = constructorFromTarget(targetOrInitialValue);
+        ensureColumnMap(ctor).set(key, options);
+    };
+}
+export function getColumnOptions(constructor, propertyKey) {
+    let current = constructor;
+    while (current) {
+        const map = current.__xacosColumns;
+        const hit = map?.get(propertyKey);
+        if (hit)
+            return hit;
+        current = Object.getPrototypeOf(current);
+    }
+    return undefined;
+}
+export function getRelations(ctor) {
+    const collected = [];
+    let current = ctor;
+    while (current) {
+        const own = current.__xacosRelations ?? [];
+        collected.push(...own);
+        current = Object.getPrototypeOf(current);
+    }
+    return collected;
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

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

package/dist/factories/Factory.d.ts

@@ -0,0 +1,34 @@
+import type { XModel } from '../XModel';
+type DefinitionFn<T> = () => Promise<Partial<T>> | Partial<T>;
+declare class FactoryBuilder {
+    private count;
+    constructor(count: number);
+    /**
+     * 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(),
+     * }));
+     */
+    create<T extends XModel>(ModelClass: typeof XModel & {
+        create(data: Partial<T>): Promise<T>;
+    }, definition: DefinitionFn<T>): Promise<T[]>;
+    /**
+     * Build plain objects without persisting to DB.
+     * Useful for unit tests that don't need a DB.
+     */
+    build<T>(definition: DefinitionFn<T>): Promise<T[]>;
+}
+export declare class Factory {
+    /** Access Faker directly: Factory.faker.person.fullName() */
+    static faker: import("@faker-js/faker").Faker;
+    static times(count: number): FactoryBuilder;
+    /** Shorthand for Factory.times(1).create(...) */
+    static create<T extends XModel>(ModelClass: typeof XModel & {
+        create(data: Partial<T>): Promise<T>;
+    }, definition: DefinitionFn<T>): Promise<T>;
+}
+export {};
+//# sourceMappingURL=Factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../src/factories/Factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,KAAK,YAAY,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE9D,cAAM,cAAc;IACN,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;IAEjC;;;;;;;;OAQG;IACG,MAAM,CAAC,CAAC,SAAS,MAAM,EAC3B,UAAU,EAAE,OAAO,MAAM,GAAG;QAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,EACpE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,EAAE,CAAC;IAUf;;;OAGG;IACG,KAAK,CAAC,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAO1D;AAED,qBAAa,OAAO;IAClB,6DAA6D;IAC7D,MAAM,CAAC,KAAK,kCAAS;IAErB,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAI3C,iDAAiD;WACpC,MAAM,CAAC,CAAC,SAAS,MAAM,EAClC,UAAU,EAAE,OAAO,MAAM,GAAG;QAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,EACpE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC;CAId"}