@rangka/core 0.0.1

package/dist/db/__tests__/sequence.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { KyselyModelOps } from '../model-ops.js';
+function createMockDb() {
+    const returningFn = vi.fn();
+    const executeTakeFirstOrThrowFn = vi.fn();
+    const onConflictDoUpdateSetFn = vi.fn();
+    const onConflictColumnsFn = vi.fn();
+    const onConflictFn = vi.fn();
+    const valuesFn = vi.fn();
+    const returningAllFn = vi.fn();
+    const insertIntoFn = vi.fn();
+    executeTakeFirstOrThrowFn.mockResolvedValue({ next_val: 1 });
+    returningFn.mockReturnValue({ executeTakeFirstOrThrow: executeTakeFirstOrThrowFn });
+    onConflictDoUpdateSetFn.mockReturnValue({ returning: returningFn });
+    onConflictColumnsFn.mockReturnValue({ doUpdateSet: onConflictDoUpdateSetFn });
+    onConflictFn.mockImplementation((cb) => {
+        const oc = { columns: onConflictColumnsFn };
+        return cb(oc);
+    });
+    valuesFn.mockReturnValue({ onConflict: onConflictFn });
+    const insertReturningAllExecute = vi.fn().mockResolvedValue({ id: 'abc', name: 'INV-00001' });
+    returningAllFn.mockReturnValue({ executeTakeFirstOrThrow: insertReturningAllExecute });
+    insertIntoFn.mockImplementation((table) => {
+        if (table === 'naming_sequence') {
+            return { values: valuesFn };
+        }
+        return {
+            values: vi.fn().mockReturnValue({ returningAll: returningAllFn }),
+        };
+    });
+    return {
+        db: {
+            insertInto: insertIntoFn,
+            selectFrom: vi.fn(),
+            updateTable: vi.fn(),
+            deleteFrom: vi.fn(),
+        },
+        insertIntoFn,
+        executeTakeFirstOrThrowFn,
+        valuesFn,
+        insertReturningAllExecute,
+    };
+}
+function createModel(fields) {
+    return {
+        qualifiedName: 'sales.invoice',
+        app: 'sales',
+        module: 'sales',
+        name: 'invoice',
+        auditLog: false,
+        traits: [],
+        fields,
+        indexes: [],
+    };
+}
+const mockRegistry = { getModel: vi.fn() };
+describe('KyselyModelOps sequence field', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('assigns sequence value on create when field is empty', async () => {
+        const { db, insertReturningAllExecute } = createMockDb();
+        insertReturningAllExecute.mockResolvedValue({ id: 'abc', invoice_number: 'INV-00001' });
+        const model = createModel([
+            {
+                name: 'invoice_number',
+                config: { type: 'sequence', prefix: 'INV-', digits: 5 },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = { customer: 'cust-1' };
+        await ops.create(data);
+        expect(data.invoice_number).toBe('INV-00001');
+    });
+    it('does not override sequence value if already provided', async () => {
+        const { db, insertIntoFn } = createMockDb();
+        const model = createModel([
+            {
+                name: 'invoice_number',
+                config: { type: 'sequence', prefix: 'INV-', digits: 5 },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = { invoice_number: 'CUSTOM-001', customer: 'cust-1' };
+        await ops.create(data);
+        expect(data.invoice_number).toBe('CUSTOM-001');
+        const namingCalls = insertIntoFn.mock.calls.filter((c) => c[0] === 'naming_sequence');
+        expect(namingCalls).toHaveLength(0);
+    });
+    it('formats sequence without prefix when prefix is omitted', async () => {
+        const { db, executeTakeFirstOrThrowFn } = createMockDb();
+        executeTakeFirstOrThrowFn.mockResolvedValue({ next_val: 42 });
+        const model = createModel([
+            {
+                name: 'code',
+                config: { type: 'sequence', digits: 4 },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = {};
+        await ops.create(data);
+        expect(data.code).toBe('0042');
+    });
+    it('formats sequence without padding when digits is omitted', async () => {
+        const { db, executeTakeFirstOrThrowFn } = createMockDb();
+        executeTakeFirstOrThrowFn.mockResolvedValue({ next_val: 7 });
+        const model = createModel([
+            {
+                name: 'ref',
+                config: { type: 'sequence', prefix: 'REF-' },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = {};
+        await ops.create(data);
+        expect(data.ref).toBe('REF-7');
+    });
+    it('handles multiple sequence fields on the same model', async () => {
+        const { db, executeTakeFirstOrThrowFn } = createMockDb();
+        let callCount = 0;
+        executeTakeFirstOrThrowFn.mockImplementation(() => {
+            callCount++;
+            return Promise.resolve({ next_val: callCount });
+        });
+        const model = createModel([
+            {
+                name: 'invoice_number',
+                config: { type: 'sequence', prefix: 'INV-', digits: 5 },
+                provenance: { source: 'base' },
+            },
+            {
+                name: 'receipt_number',
+                config: { type: 'sequence', prefix: 'REC-', digits: 3 },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = {};
+        await ops.create(data);
+        expect(data.invoice_number).toBe('INV-00001');
+        expect(data.receipt_number).toBe('REC-002');
+    });
+    it('skips sequence logic when model has no sequence fields', async () => {
+        const { db, insertIntoFn } = createMockDb();
+        const model = createModel([
+            {
+                name: 'title',
+                config: { type: 'string' },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data = { title: 'Test' };
+        await ops.create(data);
+        const namingCalls = insertIntoFn.mock.calls.filter((c) => c[0] === 'naming_sequence');
+        expect(namingCalls).toHaveLength(0);
+    });
+    it('increments correctly for subsequent calls', async () => {
+        const { db, executeTakeFirstOrThrowFn } = createMockDb();
+        executeTakeFirstOrThrowFn
+            .mockResolvedValueOnce({ next_val: 1 })
+            .mockResolvedValueOnce({ next_val: 2 });
+        const model = createModel([
+            {
+                name: 'order_number',
+                config: { type: 'sequence', prefix: 'ORD-', digits: 6 },
+                provenance: { source: 'base' },
+            },
+        ]);
+        const ops = new KyselyModelOps({ db, model, registry: mockRegistry });
+        const data1 = {};
+        await ops.create(data1);
+        expect(data1.order_number).toBe('ORD-000001');
+        const data2 = {};
+        await ops.create(data2);
+        expect(data2.order_number).toBe('ORD-000002');
+    });
+});
+//# sourceMappingURL=sequence.test.js.map

package/dist/db/__tests__/sequence.test.js.map

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

package/dist/db/auto-sync.d.ts

@@ -0,0 +1,16 @@
+import type { Kysely } from 'kysely';
+import type { SchemaRegistry } from '../schema/registry.js';
+import type { DdlOperation } from './types.js';
+export interface AutoSyncOptions {
+    allowDestructive?: boolean;
+}
+export interface AutoSyncResult {
+    applied: DdlOperation[];
+    warnings: DdlOperation[];
+}
+/**
+ * Compares the desired schema (from the registry) against the actual database state
+ * and applies any DDL operations needed to bring the database in sync.
+ */
+export declare function autoSync(registry: SchemaRegistry, db: Kysely<unknown>, options?: AutoSyncOptions): Promise<AutoSyncResult>;
+//# sourceMappingURL=auto-sync.d.ts.map

package/dist/db/auto-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-sync.d.ts","sourceRoot":"","sources":["../../src/db/auto-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAqCzB"}

package/dist/db/auto-sync.js

@@ -0,0 +1,104 @@
+import { sql } from 'kysely';
+import { SchemaToDesired } from './desired-state.js';
+import { DiffEngine } from './diff-engine.js';
+import { introspect } from './introspect.js';
+/**
+ * Compares the desired schema (from the registry) against the actual database state
+ * and applies any DDL operations needed to bring the database in sync.
+ */
+export async function autoSync(registry, db, options = {}) {
+    const desired = new SchemaToDesired().convert(registry);
+    const actual = await introspect(db);
+    const operations = new DiffEngine().diff(desired, actual);
+    if (operations.length === 0) {
+        console.log(`[rangka:sync] Schema is up to date`);
+        return { applied: [], warnings: [] };
+    }
+    const applied = [];
+    const warnings = [];
+    for (const op of operations) {
+        if (op.destructive) {
+            await handleDestructiveOp(op, options, applied, warnings, db);
+        }
+        else {
+            await applyOperation(op, db);
+            applied.push(op);
+        }
+    }
+    if (applied.length > 0) {
+        console.log(`[rangka:sync] Applied ${applied.length} operation(s):`);
+        for (const op of applied) {
+            console.log(`  ${formatOperation(op)}`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.warn(`[rangka:sync] ${warnings.length} skipped (destructive):`);
+        for (const op of warnings) {
+            console.warn(`  ${formatOperation(op)}`);
+        }
+    }
+    return { applied, warnings };
+}
+/** Apply a non-destructive DDL operation. */
+async function applyOperation(op, db) {
+    await sql.raw(op.sql).execute(db);
+}
+/**
+ * Handle a destructive operation: apply it if allowed, otherwise log a warning.
+ */
+async function handleDestructiveOp(op, options, applied, warnings, db) {
+    if (options.allowDestructive) {
+        const ddlSql = generateDestructiveSql(op);
+        await sql.raw(ddlSql).execute(db);
+        applied.push(op);
+    }
+    else {
+        warnings.push(op);
+    }
+}
+function formatOperation(op) {
+    switch (op.type) {
+        case 'CREATE_TABLE':
+            return `+ table ${op.table}`;
+        case 'ADD_COLUMN':
+            return `+ column ${op.table}.${extractColumnFromSql(op.sql)}`;
+        case 'ALTER_COLUMN_TYPE':
+            return `~ column type ${op.table}.${extractColumnFromSql(op.sql)}`;
+        case 'CREATE_INDEX':
+            return `+ index on ${op.table}`;
+        case 'ADD_FOREIGN_KEY':
+            return `+ foreign key on ${op.table}`;
+        case 'ADD_CHECK_CONSTRAINT':
+            return `+ check constraint on ${op.table}`;
+        case 'DROP_TABLE':
+            return `- table ${op.table} (orphaned)`;
+        case 'DROP_COLUMN':
+            return `- column ${op.detail ?? op.table} (orphaned)`;
+        default:
+            return `${op.type} on ${op.table}`;
+    }
+}
+function extractColumnFromSql(s) {
+    const match = s.match(/COLUMN "([^"]+)"/i) ?? s.match(/COLUMN\s+(\S+)/i);
+    return match ? match[1] : 'unknown';
+}
+/** Generate the raw SQL for a destructive operation (DROP COLUMN / DROP TABLE). */
+function generateDestructiveSql(op) {
+    switch (op.type) {
+        case 'DROP_COLUMN': {
+            const match = op.detail?.match(/Orphaned column: (.+)\.(.+)/);
+            if (match)
+                return `ALTER TABLE "${match[1]}" DROP COLUMN "${match[2]}"`;
+            return op.sql;
+        }
+        case 'DROP_TABLE': {
+            const match = op.detail?.match(/Orphaned table: (.+)/);
+            if (match)
+                return `DROP TABLE "${match[1]}"`;
+            return op.sql;
+        }
+        default:
+            return op.sql;
+    }
+}
+//# sourceMappingURL=auto-sync.js.map

package/dist/db/auto-sync.js.map

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

package/dist/db/client.d.ts

@@ -0,0 +1,45 @@
+import { Kysely } from 'kysely';
+import type { SchemaRegistry } from '../schema/registry.js';
+export interface DatabaseClientConfig {
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    password: string;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * Thin wrapper around Kysely that resolves qualified model names
+ * (e.g. "sales.Invoice") to their underlying table names automatically.
+ */
+export declare class DatabaseClient {
+    private readonly db;
+    private readonly pool;
+    private readonly qualifiedNameToTable;
+    constructor(config: DatabaseClientConfig, registry?: SchemaRegistry);
+    /**
+     * Verify the database connection is reachable.
+     * Throws with actionable diagnostics if it cannot connect.
+     */
+    verifyConnection(): Promise<void>;
+    selectFrom(model: string): import("kysely").SelectQueryBuilder<any, string, {}>;
+    insertInto(model: string): import("kysely").InsertQueryBuilder<any, string, import("kysely").InsertResult>;
+    updateTable(model: string): import("kysely").UpdateQueryBuilder<any, string, string, import("kysely").UpdateResult>;
+    deleteFrom(model: string): import("kysely").DeleteQueryBuilder<any, string, import("kysely").DeleteResult>;
+    /** Execute a callback within a database transaction. */
+    transaction<T>(callback: (trx: Kysely<any>) => Promise<T>): Promise<T>;
+    /** Direct access to the underlying Kysely instance. */
+    get kysely(): Kysely<any>;
+    /** Close the connection pool and release resources. */
+    destroy(): Promise<void>;
+    /** Maps a qualified model name to its table name, falling back to the raw input. */
+    private resolveTable;
+    /** Create the underlying pg connection pool. */
+    private createPool;
+    /** Pre-compute the mapping from qualified model names to SQL table names. */
+    private buildTableNameMap;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmB,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;gBAE/C,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,cAAc;IAMnE;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBvC,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,WAAW,CAAC,KAAK,EAAE,MAAM;IAIzB,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,wDAAwD;IAElD,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5E,uDAAuD;IAEvD,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,CAExB;IAED,uDAAuD;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,oFAAoF;IACpF,OAAO,CAAC,YAAY;IAIpB,gDAAgD;IAChD,OAAO,CAAC,UAAU;IAYlB,6EAA6E;IAC7E,OAAO,CAAC,iBAAiB;CAS1B"}

package/dist/db/client.js

@@ -0,0 +1,116 @@
+import { Kysely, PostgresDialect } from 'kysely';
+import pg from 'pg';
+import { modelToTableName } from './field-mapper.js';
+/**
+ * Thin wrapper around Kysely that resolves qualified model names
+ * (e.g. "sales.Invoice") to their underlying table names automatically.
+ */
+export class DatabaseClient {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db;
+    pool;
+    qualifiedNameToTable;
+    constructor(config, registry) {
+        this.pool = this.createPool(config);
+        this.db = new Kysely({ dialect: new PostgresDialect({ pool: this.pool }) });
+        this.qualifiedNameToTable = this.buildTableNameMap(registry);
+    }
+    /**
+     * Verify the database connection is reachable.
+     * Throws with actionable diagnostics if it cannot connect.
+     */
+    async verifyConnection() {
+        let client;
+        try {
+            client = await this.pool.connect();
+            await client.query('SELECT 1');
+        }
+        catch (err) {
+            const pgErr = err;
+            const detail = formatConnectionError(pgErr, this.pool);
+            throw new Error(`Database connection failed: ${detail}`, { cause: err });
+        }
+        finally {
+            client?.release();
+        }
+    }
+    // --- Query builders (resolve model name to table name automatically) ---
+    selectFrom(model) {
+        return this.db.selectFrom(this.resolveTable(model));
+    }
+    insertInto(model) {
+        return this.db.insertInto(this.resolveTable(model));
+    }
+    updateTable(model) {
+        return this.db.updateTable(this.resolveTable(model));
+    }
+    deleteFrom(model) {
+        return this.db.deleteFrom(this.resolveTable(model));
+    }
+    /** Execute a callback within a database transaction. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async transaction(callback) {
+        return this.db.transaction().execute(callback);
+    }
+    /** Direct access to the underlying Kysely instance. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get kysely() {
+        return this.db;
+    }
+    /** Close the connection pool and release resources. */
+    async destroy() {
+        await this.db.destroy();
+    }
+    // --- Private helpers ---
+    /** Maps a qualified model name to its table name, falling back to the raw input. */
+    resolveTable(nameOrQualified) {
+        return this.qualifiedNameToTable.get(nameOrQualified) ?? nameOrQualified;
+    }
+    /** Create the underlying pg connection pool. */
+    createPool(config) {
+        return new pg.Pool({
+            host: config.host,
+            port: config.port ?? 5432,
+            database: config.database,
+            user: config.user,
+            password: config.password,
+            min: config.pool?.min ?? 2,
+            max: config.pool?.max ?? 10,
+        });
+    }
+    /** Pre-compute the mapping from qualified model names to SQL table names. */
+    buildTableNameMap(registry) {
+        const map = new Map();
+        if (registry) {
+            for (const model of registry.getAllModels()) {
+                map.set(model.qualifiedName, modelToTableName(model.qualifiedName));
+            }
+        }
+        return map;
+    }
+}
+function formatConnectionError(err, pool) {
+    const opts = pool.options;
+    const host = opts.host ?? 'localhost';
+    const port = opts.port ?? 5432;
+    const database = opts.database ?? '(unknown)';
+    switch (err.code) {
+        case 'ECONNREFUSED':
+            return (`Could not connect to PostgreSQL at ${host}:${port}. ` +
+                `Is the server running and accepting connections?`);
+        case 'ENOTFOUND':
+            return `Host "${host}" not found. Check the database host configuration.`;
+        case 'ETIMEDOUT':
+            return (`Connection to ${host}:${port} timed out. ` +
+                `Check network connectivity and firewall rules.`);
+        case '3D000':
+            return `Database "${database}" does not exist on ${host}:${port}.`;
+        case '28P01':
+            return `Authentication failed for user "${opts.user ?? '(unknown)'}". Check credentials.`;
+        case '28000':
+            return `Authorization failed for user "${opts.user ?? '(unknown)'}". Check pg_hba.conf or user permissions.`;
+        default:
+            return err.message ?? 'Unknown error';
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/db/client.js.map

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

package/dist/db/desired-state.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaRegistry } from '../schema/registry.js';
+import type { DesiredState } from './types.js';
+/**
+ * Converts the in-memory schema registry into the desired database state
+ * (list of table definitions) used by the diff engine for migrations.
+ */
+export declare class SchemaToDesired {
+    convert(registry: SchemaRegistry): DesiredState;
+    /**
+     * Converts a single model into its primary table definition plus any
+     * extra join/pivot tables required by its fields.
+     */
+    private modelToTables;
+    /** Generates index definitions from a model's declared indexes. */
+    private buildIndexes;
+    /** Table definition for the naming_sequence counter table. */
+    private buildNamingSequenceTable;
+}
+//# sourceMappingURL=desired-state.d.ts.map

package/dist/db/desired-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desired-state.d.ts","sourceRoot":"","sources":["../../src/db/desired-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,YAAY,CAAC;AAIjF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY;IA0B/C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAmBrB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAepB,8DAA8D;IAC9D,OAAO,CAAC,wBAAwB;CAoBjC"}

package/dist/db/desired-state.js

@@ -0,0 +1,82 @@
+import { mapFieldsToColumns, modelToTableName } from './field-mapper.js';
+import { getJobTables } from '../jobs/tables.js';
+/**
+ * Converts the in-memory schema registry into the desired database state
+ * (list of table definitions) used by the diff engine for migrations.
+ */
+export class SchemaToDesired {
+    convert(registry) {
+        const tables = [];
+        const models = registry.getAllModels();
+        let hasSequenceField = false;
+        for (const model of models) {
+            const { primaryTable, joinTables } = this.modelToTables(model);
+            tables.push(primaryTable);
+            tables.push(...joinTables);
+            if (model.fields.some((f) => f.config.type === 'sequence')) {
+                hasSequenceField = true;
+            }
+        }
+        // Add the naming_sequence helper table if any model uses sequence fields
+        if (hasSequenceField) {
+            tables.push(this.buildNamingSequenceTable());
+        }
+        // Always include the internal job queue tables
+        tables.push(...getJobTables());
+        return { tables };
+    }
+    /**
+     * Converts a single model into its primary table definition plus any
+     * extra join/pivot tables required by its fields.
+     */
+    modelToTables(model) {
+        const tableName = modelToTableName(model.qualifiedName);
+        const mapping = mapFieldsToColumns(model);
+        const indexes = this.buildIndexes(model, tableName);
+        const primaryTable = {
+            name: tableName,
+            columns: mapping.columns,
+            foreignKeys: mapping.foreignKeys,
+            checkConstraints: mapping.checkConstraints,
+            indexes,
+        };
+        return { primaryTable, joinTables: mapping.extraTables };
+    }
+    /** Generates index definitions from a model's declared indexes. */
+    buildIndexes(model, tableName) {
+        if (!model.indexes || model.indexes.length === 0)
+            return [];
+        return model.indexes.map((idx) => {
+            const prefix = idx.unique ? 'uidx' : 'idx';
+            const indexName = `${prefix}_${tableName}_${idx.fields.join('_')}`;
+            return {
+                name: indexName,
+                table: tableName,
+                columns: idx.fields,
+                unique: idx.unique ?? false,
+            };
+        });
+    }
+    /** Table definition for the naming_sequence counter table. */
+    buildNamingSequenceTable() {
+        return {
+            name: 'naming_sequence',
+            columns: [
+                { name: 'model', type: 'VARCHAR(255)', nullable: false },
+                { name: 'field', type: 'VARCHAR(255)', nullable: false },
+                { name: 'next_val', type: 'BIGINT', nullable: false, defaultValue: '1' },
+            ],
+            foreignKeys: [],
+            checkConstraints: [],
+            indexes: [
+                {
+                    name: 'uidx_naming_sequence_key',
+                    table: 'naming_sequence',
+                    columns: ['model', 'field'],
+                    unique: true,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=desired-state.js.map

package/dist/db/desired-state.js.map

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