@acorex-platform/framework-server 0.0.10

package/jql/schema/src/lib/entity-schema-jql-source.factory.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitySchemaJqlSourceFactory = void 0;
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const domain_data_type_mapper_1 = require("./domain-data-type.mapper");
+//#region ---- Entity schema JQL source factory ----
+class EntitySchemaJqlSourceFactory {
+    create(schema) {
+        const storageName = schema.tableName ?? (0, abstract_1.entityNameToStorageName)(schema.entityName);
+        const fields = this.buildFieldMap(schema);
+        return {
+            name: (0, abstract_1.resolveEntityJqlSourceName)(schema.entityName),
+            storage: 'structured',
+            table: storageName,
+            collection: schema.collectionName ?? storageName,
+            idField: 'id',
+            fields,
+            schema: {
+                ddl: buildPostgresCreateTableDdl(storageName, schema),
+                indexes: buildMongoIndexes(schema),
+            },
+        };
+    }
+    buildFieldMap(schema) {
+        const fields = {};
+        for (const column of schema.columns) {
+            fields[column.name] = {
+                column: (0, abstract_1.resolveColumnName)(column.name, column.columnName),
+                type: mapFieldDescriptorType(column.dataType),
+            };
+        }
+        return fields;
+    }
+}
+exports.EntitySchemaJqlSourceFactory = EntitySchemaJqlSourceFactory;
+function mapFieldDescriptorType(dataType) {
+    switch (dataType) {
+        case 'integer':
+        case 'numeric':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'timestamptz':
+            return 'date';
+        case 'jsonb':
+            return 'json';
+        default:
+            return 'string';
+    }
+}
+function buildPostgresCreateTableDdl(tableName, schema) {
+    const columnDefs = schema.columns.map((column) => {
+        const columnName = (0, abstract_1.resolveColumnName)(column.name, column.columnName);
+        const sqlType = (0, domain_data_type_mapper_1.mapJqlColumnToPostgresType)(column.dataType);
+        const nullable = column.nullable === false ? 'NOT NULL' : '';
+        const primary = column.isId ? 'PRIMARY KEY' : '';
+        return `${columnName} ${sqlType} ${nullable} ${primary}`.trim();
+    });
+    return `CREATE TABLE IF NOT EXISTS ${tableName} (\n  ${columnDefs.join(',\n  ')}\n);`;
+}
+function buildMongoIndexes(schema) {
+    const indexes = [{ id: 1 }];
+    for (const index of schema.indexes ?? []) {
+        const keys = {};
+        for (const columnName of index.columns) {
+            keys[columnName] = 1;
+        }
+        if (Object.keys(keys).length > 0) {
+            indexes.push(keys);
+        }
+    }
+    return indexes;
+}
+//#endregion
+//# sourceMappingURL=entity-schema-jql-source.factory.js.map

package/jql/schema/src/lib/entity-schema-jql-source.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schema-jql-source.factory.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/entity-schema-jql-source.factory.ts"],"names":[],"mappings":"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"}

package/jql/schema/src/lib/jql-auto-migrator.d.ts

@@ -0,0 +1,17 @@
+import { JqlEntitySchema } from '@acorex-platform/framework-server/jql/abstract';
+import type { Pool } from 'pg';
+export type JqlAutoMigrationStatus = 'created' | 'migrated' | 'unchanged';
+export interface JqlAutoMigrationResult {
+    status: JqlAutoMigrationStatus;
+    addedColumns: string[];
+    addedIndexes: string[];
+}
+/** Applies safe, idempotent schema changes for structured entity tables. */
+export declare class JqlAutoMigrator {
+    applyMigration(pool: Pool, schema: JqlEntitySchema): Promise<JqlAutoMigrationResult>;
+    private ensureSchemaHistoryTable;
+    private tableExists;
+    private listColumns;
+    private createIndexes;
+    private recordHistory;
+}

package/jql/schema/src/lib/jql-auto-migrator.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlAutoMigrator = void 0;
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const domain_data_type_mapper_1 = require("./domain-data-type.mapper");
+//#region ---- PostgreSQL auto-migrator ----
+const SCHEMA_HISTORY_TABLE = 'jql_schema_history';
+/** Applies safe, idempotent schema changes for structured entity tables. */
+class JqlAutoMigrator {
+    async applyMigration(pool, schema) {
+        const tableName = schema.tableName;
+        await this.ensureSchemaHistoryTable(pool);
+        const tableExists = await this.tableExists(pool, tableName);
+        if (!tableExists) {
+            await pool.query(buildCreateTableDdl(tableName, schema));
+            await this.createIndexes(pool, tableName, schema);
+            await this.recordHistory(pool, schema, 'created', {
+                columns: schema.columns.map((column) => column.name),
+                fullTextSearchPaths: schema.fullTextSearchPaths,
+            });
+            return {
+                status: 'created',
+                addedColumns: schema.columns.map((column) => column.name),
+                addedIndexes: (schema.indexes ?? []).map((index) => index.columns.join('_')),
+            };
+        }
+        const existingColumns = await this.listColumns(pool, tableName);
+        const addedColumns = [];
+        for (const column of schema.columns) {
+            const columnName = (0, abstract_1.resolveColumnName)(column.name, column.columnName);
+            if (existingColumns.has(columnName)) {
+                continue;
+            }
+            const sqlType = (0, domain_data_type_mapper_1.mapJqlColumnToPostgresType)(column.dataType);
+            const nullable = column.nullable === false ? 'NOT NULL' : '';
+            await pool.query(`ALTER TABLE ${quoteIdentifier(tableName)} ADD COLUMN IF NOT EXISTS ${quoteIdentifier(columnName)} ${sqlType} ${nullable}`.trim());
+            addedColumns.push(column.name);
+        }
+        const addedIndexes = await this.createIndexes(pool, tableName, schema);
+        if (addedColumns.length === 0 && addedIndexes.length === 0) {
+            return { status: 'unchanged', addedColumns, addedIndexes };
+        }
+        await this.recordHistory(pool, schema, 'migrated', {
+            addedColumns,
+            addedIndexes,
+            fullTextSearchPaths: schema.fullTextSearchPaths,
+        });
+        return { status: 'migrated', addedColumns, addedIndexes };
+    }
+    async ensureSchemaHistoryTable(pool) {
+        await pool.query(`
+      CREATE TABLE IF NOT EXISTS ${SCHEMA_HISTORY_TABLE} (
+        id SERIAL PRIMARY KEY,
+        entity_name TEXT NOT NULL,
+        table_name TEXT NOT NULL,
+        action TEXT NOT NULL,
+        details JSONB,
+        applied_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      );
+    `);
+    }
+    async tableExists(pool, tableName) {
+        const result = await pool.query(`SELECT 1 FROM information_schema.tables WHERE table_schema = 'public' AND table_name = $1 LIMIT 1`, [tableName]);
+        return (result.rowCount ?? 0) > 0;
+    }
+    async listColumns(pool, tableName) {
+        const result = await pool.query(`SELECT column_name FROM information_schema.columns WHERE table_schema = 'public' AND table_name = $1`, [tableName]);
+        return new Set(result.rows.map((row) => String(row['column_name'])));
+    }
+    async createIndexes(pool, tableName, schema) {
+        const addedIndexes = [];
+        for (const index of schema.indexes ?? []) {
+            const columnNames = index.columns.map((columnName) => {
+                const column = schema.columns.find((item) => item.name === columnName);
+                return (0, abstract_1.resolveColumnName)(columnName, column?.columnName);
+            });
+            if (!columnNames.length) {
+                continue;
+            }
+            const indexName = `idx_${tableName}_${columnNames.join('_')}`;
+            const unique = index.unique ? 'UNIQUE ' : '';
+            await pool.query(`CREATE ${unique}INDEX IF NOT EXISTS ${quoteIdentifier(indexName)} ON ${quoteIdentifier(tableName)} (${columnNames.map(quoteIdentifier).join(', ')})`);
+            addedIndexes.push(indexName);
+        }
+        return addedIndexes;
+    }
+    async recordHistory(pool, schema, action, details) {
+        await pool.query(`INSERT INTO ${SCHEMA_HISTORY_TABLE} (entity_name, table_name, action, details) VALUES ($1, $2, $3, $4)`, [schema.entityName, schema.tableName, action, JSON.stringify(details)]);
+    }
+}
+exports.JqlAutoMigrator = JqlAutoMigrator;
+function buildCreateTableDdl(tableName, schema) {
+    const columnDefs = schema.columns.map((column) => {
+        const columnName = (0, abstract_1.resolveColumnName)(column.name, column.columnName);
+        const sqlType = (0, domain_data_type_mapper_1.mapJqlColumnToPostgresType)(column.dataType);
+        const nullable = column.nullable === false ? 'NOT NULL' : '';
+        const primary = column.isId ? 'PRIMARY KEY' : '';
+        return `${quoteIdentifier(columnName)} ${sqlType} ${nullable} ${primary}`.trim();
+    });
+    return `CREATE TABLE IF NOT EXISTS ${quoteIdentifier(tableName)} (\n  ${columnDefs.join(',\n  ')}\n);`;
+}
+function quoteIdentifier(identifier) {
+    return `"${identifier.replace(/"/g, '""')}"`;
+}
+//#endregion
+//# sourceMappingURL=jql-auto-migrator.js.map

package/jql/schema/src/lib/jql-auto-migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-auto-migrator.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-auto-migrator.ts"],"names":[],"mappings":";;;AAAA,6EAAoG;AAEpG,uEAAuE;AAEvE,4CAA4C;AAE5C,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAUlD,4EAA4E;AAC5E,MAAa,eAAe;IAC1B,KAAK,CAAC,cAAc,CAAC,IAAU,EAAE,MAAuB;QACtD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAU,CAAC;QACpC,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;YACzD,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE;gBAChD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;gBACpD,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;aAChD,CAAC,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;gBACzD,YAAY,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aAC7E,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAChE,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,IAAA,4BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YACrE,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,IAAA,oDAA0B,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,CAAC,KAAK,CACd,eAAe,eAAe,CAAC,SAAS,CAAC,6BAA6B,eAAe,CAAC,UAAU,CAAC,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC,IAAI,EAAE,CAClI,CAAC;YACF,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAEvE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE;YACjD,YAAY;YACZ,YAAY;YACZ,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;SAChD,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,wBAAwB,CAAC,IAAU;QAC/C,MAAM,IAAI,CAAC,KAAK,CAAC;mCACc,oBAAoB;;;;;;;;KAQlD,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,SAAiB;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,mGAAmG,EACnG,CAAC,SAAS,CAAC,CACZ,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,SAAiB;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,sGAAsG,EACtG,CAAC,SAAS,CAAC,CACZ,CAAC;QAEF,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAU,EACV,SAAiB,EACjB,MAAuB;QAEvB,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACzC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;gBACnD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;gBACvE,OAAO,IAAA,4BAAiB,EAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,KAAK,CACd,UAAU,MAAM,uBAAuB,eAAe,CAAC,SAAS,CAAC,OAAO,eAAe,CAAC,SAAS,CAAC,KAAK,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtJ,CAAC;YACF,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAU,EACV,MAAuB,EACvB,MAAc,EACd,OAAgC;QAEhC,MAAM,IAAI,CAAC,KAAK,CACd,eAAe,oBAAoB,qEAAqE,EACxG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CACvE,CAAC;IACJ,CAAC;CACF;AAxHD,0CAwHC;AAED,SAAS,mBAAmB,CAAC,SAAiB,EAAE,MAAuB;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/C,MAAM,UAAU,GAAG,IAAA,4BAAiB,EAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,IAAA,oDAA0B,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,OAAO,8BAA8B,eAAe,CAAC,SAAS,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AACzG,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB;IACzC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AAC/C,CAAC;AAED,YAAY"}

package/jql/schema/src/lib/jql-schema-history.hydrator.d.ts

@@ -0,0 +1,4 @@
+import type { Pool } from 'pg';
+import { JqlEntitySchema } from '@acorex-platform/framework-server/jql/abstract';
+/** Loads entity schemas recorded in {@link SCHEMA_HISTORY_TABLE} (PostgreSQL entity storage). */
+export declare function loadSchemasFromHistory(pool: Pool): Promise<JqlEntitySchema[]>;

package/jql/schema/src/lib/jql-schema-history.hydrator.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSchemasFromHistory = loadSchemasFromHistory;
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+//#region ---- Schema history hydration ----
+const SCHEMA_HISTORY_TABLE = 'jql_schema_history';
+/** Loads entity schemas recorded in {@link SCHEMA_HISTORY_TABLE} (PostgreSQL entity storage). */
+async function loadSchemasFromHistory(pool) {
+    const history = await pool.query(`
+    SELECT DISTINCT ON (entity_name)
+      entity_name,
+      table_name,
+      details
+    FROM ${SCHEMA_HISTORY_TABLE}
+    ORDER BY entity_name, applied_at DESC
+  `);
+    if (!history.rows.length) {
+        return [];
+    }
+    const tableNames = [...new Set(history.rows.map((row) => row.table_name))];
+    const columnsByTable = await loadTableColumns(pool, tableNames);
+    const schemas = [];
+    for (const row of history.rows) {
+        const tableColumns = columnsByTable.get(row.table_name);
+        if (!tableColumns?.size) {
+            continue;
+        }
+        schemas.push(buildSchemaFromHistoryRow(row, tableColumns));
+    }
+    return schemas;
+}
+async function loadTableColumns(pool, tableNames) {
+    const result = await pool.query(`SELECT table_name, column_name, data_type, is_nullable
+     FROM information_schema.columns
+     WHERE table_schema = 'public' AND table_name = ANY($1::text[])
+     ORDER BY table_name, ordinal_position`, [tableNames]);
+    const byTable = new Map();
+    for (const row of result.rows) {
+        const table = byTable.get(row.table_name) ?? new Map();
+        table.set(row.column_name, {
+            dataType: row.data_type,
+            nullable: row.is_nullable === 'YES',
+        });
+        byTable.set(row.table_name, table);
+    }
+    return byTable;
+}
+function buildSchemaFromHistoryRow(row, tableColumns) {
+    const logicalNames = row.details?.columns?.length
+        ? row.details.columns
+        : [...tableColumns.keys()].map((column) => column);
+    const columns = [];
+    for (const name of logicalNames) {
+        const columnName = resolvePhysicalColumnName(name, tableColumns);
+        const meta = tableColumns.get(columnName);
+        columns.push({
+            name,
+            columnName,
+            dataType: meta ? mapPostgresDataType(meta.dataType) : inferFallbackDataType(name),
+            nullable: name === 'id' ? false : (meta?.nullable ?? true),
+            isId: name === 'id',
+            isForeignKey: name === 'parentId',
+        });
+    }
+    return {
+        entityName: row.entity_name,
+        tableName: row.table_name,
+        collectionName: row.table_name,
+        columns,
+        hierarchical: tableColumns.has('parent_id'),
+        fullTextSearchPaths: row.details?.fullTextSearchPaths,
+    };
+}
+function resolvePhysicalColumnName(logicalName, tableColumns) {
+    const candidate = (0, abstract_1.resolveColumnName)(logicalName);
+    if (tableColumns.has(candidate)) {
+        return candidate;
+    }
+    if (tableColumns.has(logicalName)) {
+        return logicalName;
+    }
+    return candidate;
+}
+function mapPostgresDataType(pgType) {
+    const normalized = pgType.toLowerCase();
+    if (normalized === 'jsonb' || normalized === 'json') {
+        return 'jsonb';
+    }
+    if (normalized.includes('int')) {
+        return 'integer';
+    }
+    if (normalized === 'numeric' || normalized === 'double precision' || normalized === 'real') {
+        return 'numeric';
+    }
+    if (normalized === 'boolean') {
+        return 'boolean';
+    }
+    if (normalized.includes('timestamp')) {
+        return 'timestamptz';
+    }
+    if (normalized === 'uuid') {
+        return 'uuid';
+    }
+    return 'text';
+}
+function inferFallbackDataType(logicalName) {
+    if (logicalName === 'created' || logicalName === 'updated') {
+        return 'jsonb';
+    }
+    return 'text';
+}
+//#endregion
+//# sourceMappingURL=jql-schema-history.hydrator.js.map

package/jql/schema/src/lib/jql-schema-history.hydrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-schema-history.hydrator.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-schema-history.hydrator.ts"],"names":[],"mappings":"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"}

package/jql/schema/src/lib/jql-schema-registry.service.d.ts

@@ -0,0 +1,8 @@
+import { JqlEntitySchema } from '@acorex-platform/framework-server/jql/abstract';
+export declare class JqlSchemaRegistry {
+    private readonly schemas;
+    register(schema: JqlEntitySchema): void;
+    get(entityName: string): JqlEntitySchema | undefined;
+    has(entityName: string): boolean;
+    list(): JqlEntitySchema[];
+}

package/jql/schema/src/lib/jql-schema-registry.service.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSchemaRegistry = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+//#region ---- Schema registry ----
+let JqlSchemaRegistry = class JqlSchemaRegistry {
+    constructor() {
+        this.schemas = new Map();
+    }
+    register(schema) {
+        this.schemas.set(schema.entityName, schema);
+    }
+    get(entityName) {
+        return this.schemas.get(entityName);
+    }
+    has(entityName) {
+        return this.schemas.has(entityName);
+    }
+    list() {
+        return [...this.schemas.values()];
+    }
+};
+exports.JqlSchemaRegistry = JqlSchemaRegistry;
+exports.JqlSchemaRegistry = JqlSchemaRegistry = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], JqlSchemaRegistry);
+//#endregion
+//# sourceMappingURL=jql-schema-registry.service.js.map

package/jql/schema/src/lib/jql-schema-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-schema-registry.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-schema-registry.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAG5C,mCAAmC;AAG5B,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACY,YAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAiBhE,CAAC;IAfC,QAAQ,CAAC,MAAuB;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAlBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;GACA,iBAAiB,CAkB7B;AAED,YAAY"}

package/jql/schema/src/lib/jql-schema.controller.d.ts

@@ -0,0 +1,14 @@
+import { AXPPropertyDefinition } from '@acorex-platform/framework-server/domain/abstract';
+import { JqlIndexDefinition, JqlSchemaRegistrationResult } from '@acorex-platform/framework-server/jql/abstract';
+import { JqlSchemaService } from './jql-schema.service';
+export interface RegisterEntitySchemaDto {
+    entityName: string;
+    properties: AXPPropertyDefinition[];
+    indexes?: JqlIndexDefinition[];
+    hierarchical?: boolean;
+}
+export declare class JqlSchemaController {
+    private readonly schemaService;
+    constructor(schemaService: JqlSchemaService);
+    registerSchema(body: RegisterEntitySchemaDto): Promise<JqlSchemaRegistrationResult>;
+}

package/jql/schema/src/lib/jql-schema.controller.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSchemaController = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const jql_schema_service_1 = require("./jql-schema.service");
+let JqlSchemaController = class JqlSchemaController {
+    constructor(schemaService) {
+        this.schemaService = schemaService;
+    }
+    async registerSchema(body) {
+        return this.schemaService.registerFromProperties(body);
+    }
+};
+exports.JqlSchemaController = JqlSchemaController;
+tslib_1.__decorate([
+    (0, common_1.Post)(),
+    tslib_1.__param(0, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], JqlSchemaController.prototype, "registerSchema", null);
+exports.JqlSchemaController = JqlSchemaController = tslib_1.__decorate([
+    (0, common_1.Controller)('api/entity-storage/schema'),
+    tslib_1.__metadata("design:paramtypes", [jql_schema_service_1.JqlSchemaService])
+], JqlSchemaController);
+//#endregion
+//# sourceMappingURL=jql-schema.controller.js.map

package/jql/schema/src/lib/jql-schema.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-schema.controller.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-schema.controller.ts"],"names":[],"mappings":";;;;AAAA,2CAAwD;AAGxD,6DAAwD;AAYjD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,YAA6B,aAA+B;QAA/B,kBAAa,GAAb,aAAa,CAAkB;IAAG,CAAC;IAG1D,AAAN,KAAK,CAAC,cAAc,CACV,IAA6B;QAErC,OAAO,IAAI,CAAC,aAAa,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AATY,kDAAmB;AAIxB;IADL,IAAA,aAAI,GAAE;IAEJ,mBAAA,IAAA,aAAI,GAAE,CAAA;;;;yDAGR;8BARU,mBAAmB;IAD/B,IAAA,mBAAU,EAAC,2BAA2B,CAAC;6CAEM,qCAAgB;GADjD,mBAAmB,CAS/B;AAED,YAAY"}

package/jql/schema/src/lib/jql-schema.module.d.ts

@@ -0,0 +1,4 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class JqlSchemaModule {
+    static forRoot(): DynamicModule;
+}

package/jql/schema/src/lib/jql-schema.module.js

@@ -0,0 +1,35 @@
+"use strict";
+var JqlSchemaModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSchemaModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const jql_schema_controller_1 = require("./jql-schema.controller");
+const jql_schema_registry_service_1 = require("./jql-schema-registry.service");
+const jql_schema_service_1 = require("./jql-schema.service");
+//#region ---- JQL schema module ----
+let JqlSchemaModule = JqlSchemaModule_1 = class JqlSchemaModule {
+    static forRoot() {
+        return {
+            module: JqlSchemaModule_1,
+            controllers: [jql_schema_controller_1.JqlSchemaController],
+            providers: [
+                jql_schema_registry_service_1.JqlSchemaRegistry,
+                {
+                    provide: jql_schema_service_1.JqlSchemaService,
+                    useFactory: (registry, engine) => new jql_schema_service_1.JqlSchemaService(registry, engine),
+                    inject: [jql_schema_registry_service_1.JqlSchemaRegistry, abstract_1.ENTITY_STORAGE_JQL_ENGINE],
+                },
+            ],
+            exports: [jql_schema_registry_service_1.JqlSchemaRegistry, jql_schema_service_1.JqlSchemaService],
+            global: true,
+        };
+    }
+};
+exports.JqlSchemaModule = JqlSchemaModule;
+exports.JqlSchemaModule = JqlSchemaModule = JqlSchemaModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], JqlSchemaModule);
+//#endregion
+//# sourceMappingURL=jql-schema.module.js.map

package/jql/schema/src/lib/jql-schema.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-schema.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-schema.module.ts"],"names":[],"mappings":";;;;;AAAA,2CAAuD;AACvD,6EAGwD;AACxD,mEAA8D;AAC9D,+EAAkE;AAClE,6DAAwD;AAExD,qCAAqC;AAG9B,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,WAAW,EAAE,CAAC,2CAAmB,CAAC;YAClC,SAAS,EAAE;gBACT,+CAAiB;gBACjB;oBACE,OAAO,EAAE,qCAAgB;oBACzB,UAAU,EAAE,CAAC,QAA2B,EAAE,MAAqB,EAAE,EAAE,CACjE,IAAI,qCAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC;oBACxC,MAAM,EAAE,CAAC,+CAAiB,EAAE,oCAAyB,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,CAAC,+CAAiB,EAAE,qCAAgB,CAAC;YAC9C,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAlBY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,eAAe,CAkB3B;AAED,YAAY"}

package/jql/schema/src/lib/jql-schema.service.d.ts

@@ -0,0 +1,30 @@
+import { AXPPropertyDefinition, AXPEntityDefinition } from '@acorex-platform/framework-server/domain/abstract';
+import { JqlEngineBase, JqlEntitySchema, JqlIndexDefinition, JqlSchemaRegistrationResult } from '@acorex-platform/framework-server/jql/abstract';
+import { JqlSchemaRegistry } from './jql-schema-registry.service';
+export interface RegisterEntitySchemaInput {
+    entityName: string;
+    properties: AXPPropertyDefinition[];
+    indexes?: JqlIndexDefinition[];
+    hierarchical?: boolean;
+}
+export declare class JqlSchemaService {
+    private readonly registry;
+    private readonly engine;
+    private readonly logger;
+    private readonly sourceFactory;
+    private schemaHistoryHydrated;
+    constructor(registry: JqlSchemaRegistry, engine: JqlEngineBase);
+    registerFromEntityDefinition(entity: AXPEntityDefinition, entityName?: string): Promise<JqlSchemaRegistrationResult>;
+    registerFromProperties(input: RegisterEntitySchemaInput): Promise<JqlSchemaRegistrationResult>;
+    registerSchema(schema: JqlEntitySchema): Promise<JqlSchemaRegistrationResult>;
+    ensureEntityReady(entityName: string): Promise<JqlEntitySchema>;
+    getRegisteredSchema(entityName: string): JqlEntitySchema | undefined;
+    /**
+     * Registers schemas for entities that already exist in PostgreSQL (`jql_schema_history`)
+     * but are missing from the in-memory registry (e.g. when domain definitions were not seeded).
+     */
+    hydrateMissingFromSchemaHistory(): Promise<number>;
+    private hydrateMissingFromSchemaHistoryOnce;
+    private resolvePostgresPool;
+    private normalizeSchema;
+}

package/jql/schema/src/lib/jql-schema.service.js

@@ -0,0 +1,121 @@
+"use strict";
+var JqlSchemaService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSchemaService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const entity_schema_builder_1 = require("./entity-schema-builder");
+const entity_schema_jql_source_factory_1 = require("./entity-schema-jql-source.factory");
+const jql_schema_history_hydrator_1 = require("./jql-schema-history.hydrator");
+const jql_schema_registry_service_1 = require("./jql-schema-registry.service");
+let JqlSchemaService = JqlSchemaService_1 = class JqlSchemaService {
+    constructor(registry, engine) {
+        this.registry = registry;
+        this.engine = engine;
+        this.logger = new common_1.Logger(JqlSchemaService_1.name);
+        this.sourceFactory = new entity_schema_jql_source_factory_1.EntitySchemaJqlSourceFactory();
+        this.schemaHistoryHydrated = false;
+    }
+    async registerFromEntityDefinition(entity, entityName) {
+        const schema = entity_schema_builder_1.EntitySchemaBuilder.fromEntityDefinition(entity, { entityName });
+        return this.registerSchema(schema);
+    }
+    async registerFromProperties(input) {
+        const schema = entity_schema_builder_1.EntitySchemaBuilder.fromProperties(input.properties, {
+            entityName: input.entityName,
+            hierarchical: input.hierarchical,
+            indexes: input.indexes,
+        });
+        return this.registerSchema(schema);
+    }
+    async registerSchema(schema) {
+        const normalized = this.normalizeSchema(schema);
+        this.registry.register(normalized);
+        const source = this.sourceFactory.create(normalized);
+        await this.engine.registerAndEnsureSource(source);
+        await this.engine.ensureEntityTable(normalized);
+        return {
+            entityName: normalized.entityName,
+            tableName: normalized.tableName ?? (0, abstract_1.entityNameToStorageName)(normalized.entityName),
+            columns: normalized.columns,
+            status: 'created',
+        };
+    }
+    async ensureEntityReady(entityName) {
+        if (!this.registry.get(entityName)) {
+            await this.hydrateMissingFromSchemaHistoryOnce();
+        }
+        const schema = this.registry.get(entityName);
+        if (!schema) {
+            throw new abstract_1.JqlEntitySchemaNotFoundError(entityName);
+        }
+        const source = this.sourceFactory.create(schema);
+        await this.engine.registerAndEnsureSource(source);
+        await this.engine.ensureEntityTable(schema);
+        return schema;
+    }
+    getRegisteredSchema(entityName) {
+        return this.registry.get(entityName);
+    }
+    /**
+     * Registers schemas for entities that already exist in PostgreSQL (`jql_schema_history`)
+     * but are missing from the in-memory registry (e.g. when domain definitions were not seeded).
+     */
+    async hydrateMissingFromSchemaHistory() {
+        if (this.engine.dialect !== 'postgres') {
+            return 0;
+        }
+        const pool = await this.resolvePostgresPool();
+        if (!pool) {
+            this.logger.warn('PostgreSQL pool unavailable; skipping schema history hydration');
+            return 0;
+        }
+        try {
+            const schemas = await (0, jql_schema_history_hydrator_1.loadSchemasFromHistory)(pool);
+            let registered = 0;
+            for (const schema of schemas) {
+                if (this.registry.has(schema.entityName)) {
+                    continue;
+                }
+                await this.registerSchema(schema);
+                registered += 1;
+            }
+            if (registered > 0) {
+                this.logger.log(`Hydrated ${registered} entity schemas from PostgreSQL schema history`);
+            }
+            return registered;
+        }
+        catch (error) {
+            this.logger.error('Failed to hydrate entity schemas from PostgreSQL schema history', error);
+            return 0;
+        }
+    }
+    async hydrateMissingFromSchemaHistoryOnce() {
+        if (this.schemaHistoryHydrated) {
+            return;
+        }
+        this.schemaHistoryHydrated = true;
+        await this.hydrateMissingFromSchemaHistory();
+    }
+    async resolvePostgresPool() {
+        const candidate = this.engine;
+        return candidate.getPool?.();
+    }
+    normalizeSchema(schema) {
+        const storageName = schema.tableName ?? (0, abstract_1.entityNameToStorageName)(schema.entityName);
+        return {
+            ...schema,
+            tableName: storageName,
+            collectionName: schema.collectionName ?? storageName,
+        };
+    }
+};
+exports.JqlSchemaService = JqlSchemaService;
+exports.JqlSchemaService = JqlSchemaService = JqlSchemaService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [jql_schema_registry_service_1.JqlSchemaRegistry,
+        abstract_1.JqlEngineBase])
+], JqlSchemaService);
+//#endregion
+//# sourceMappingURL=jql-schema.service.js.map

package/jql/schema/src/lib/jql-schema.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-schema.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/schema/src/lib/jql-schema.service.ts"],"names":[],"mappings":"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"}