@acorex-platform/framework-server 0.0.10

package/jql/abstract/src/lib/entity-store/entity-store.service.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityStoreService = void 0;
+const common_1 = require("@nestjs/common");
+const jql_filter_util_1 = require("../jql-filter.util");
+const entity_schema_naming_util_1 = require("../entity-schema/entity-schema-naming.util");
+const entity_store_aggregate_util_1 = require("./entity-store-aggregate.util");
+const entity_store_request_util_1 = require("./entity-store-request.util");
+const entity_fulltext_search_util_1 = require("./entity-fulltext-search.util");
+//#endregion
+//#region ---- DB-agnostic entity store (JQL adapter) ----
+/**
+ * Per-entity structured storage backed by {@link JqlEngineBase}.
+ */
+class EntityStoreService {
+    constructor(config, engine, schemaResolver) {
+        this.config = config;
+        this.engine = engine;
+        this.schemaResolver = schemaResolver;
+        this.logger = new common_1.Logger(EntityStoreService.name);
+    }
+    get dbName() {
+        return this.config.dbName;
+    }
+    async onModuleInit() {
+        this.logger.log(`Entity store [${this.config.jqlInstance ?? this.engine.instanceName}] on JQL ${this.engine.dialect} (per-entity tables)`);
+    }
+    async getOne(entityName, id) {
+        const sourceName = await this.resolveSourceName(entityName);
+        const doc = await this.engine.findOne({
+            from: sourceName,
+            where: (0, jql_filter_util_1.eqCondition)('id', id),
+        });
+        if (!doc) {
+            throw new common_1.NotFoundException(`Entity not found: ${entityName}/${id}`);
+        }
+        return doc;
+    }
+    async query(entityName, request) {
+        const schema = await this.schemaResolver.ensureEntityReady(entityName);
+        const sourceName = (0, entity_schema_naming_util_1.resolveEntityJqlSourceName)(entityName);
+        const searchableFields = (0, entity_fulltext_search_util_1.resolveFullTextSearchFields)(schema);
+        const jqlQuery = (0, entity_store_request_util_1.buildEntityJqlQueryFromRequest)(sourceName, request, undefined, searchableFields);
+        if (jqlQuery.aggregate) {
+            const result = await this.engine.aggregate({
+                ...jqlQuery,
+                aggregate: jqlQuery.aggregate,
+            });
+            return { totalCount: result.total ?? result.items.length, items: result.items };
+        }
+        const result = await this.engine.find(jqlQuery);
+        return { totalCount: result.total ?? 0, items: result.items };
+    }
+    async aggregate(entityName, request) {
+        const sourceName = await this.resolveSourceName(entityName);
+        const jqlQuery = (0, entity_store_aggregate_util_1.buildEntityAggregateJqlQuery)(sourceName, request);
+        if (!jqlQuery.aggregate?.aggregations.length) {
+            return { rows: [] };
+        }
+        const result = await this.engine.aggregate({
+            ...jqlQuery,
+            aggregate: jqlQuery.aggregate,
+        });
+        return { rows: result.items };
+    }
+    async insertOne(entityName, entity) {
+        const sourceName = await this.resolveSourceName(entityName);
+        const record = (entity ?? {});
+        const id = typeof record['id'] === 'string' && record['id'] ? record['id'] : crypto.randomUUID();
+        const now = new Date();
+        const doc = {
+            ...record,
+            id,
+            created: record['created'] ?? { at: now, user: { id: 'system', type: 'system' } },
+            updated: record['updated'] ?? { at: now, user: { id: 'system', type: 'system' } },
+        };
+        await this.engine.insert({
+            into: sourceName,
+            documents: [doc],
+        });
+        return id;
+    }
+    async updateOne(entityName, id, patch) {
+        const sourceName = await this.resolveSourceName(entityName);
+        const existing = await this.getOne(entityName, id);
+        const base = (existing ?? {});
+        const { id: _omitId, ...safePatch } = patch;
+        const now = new Date();
+        const updated = {
+            ...base,
+            ...safePatch,
+            id,
+            updated: patch['updated'] ?? { at: now, user: { id: 'system', type: 'system' } },
+        };
+        await this.engine.update({
+            update: sourceName,
+            where: (0, jql_filter_util_1.eqCondition)('id', id),
+            set: updated,
+        });
+        return updated;
+    }
+    async deleteOne(entityName, id) {
+        const sourceName = await this.resolveSourceName(entityName);
+        const changes = await this.engine.delete({
+            from: sourceName,
+            where: (0, jql_filter_util_1.eqCondition)('id', id),
+        });
+        if (changes === 0) {
+            throw new common_1.NotFoundException(`Entity not found: ${entityName}/${id}`);
+        }
+    }
+    async initial(entityName, collection, options = { mergeType: 'merge', uniqueKeys: ['name'] }) {
+        if (!collection?.length) {
+            return collection;
+        }
+        const sourceName = await this.resolveSourceName(entityName);
+        const uniqueKeys = options.uniqueKeys ?? ['name'];
+        const mergeType = options.mergeType ?? 'merge';
+        const skipExistenceCheck = options.skipExistenceCheck ?? false;
+        let shouldInsert = true;
+        const existingCount = await this.engine.count({
+            from: sourceName,
+        });
+        if (!skipExistenceCheck && existingCount > 0) {
+            const existing = await this.engine.find({
+                from: sourceName,
+            });
+            for (const item of collection) {
+                const record = item;
+                const match = existing.items.find((rec) => uniqueKeys.every((key) => rec[key] === record[key]));
+                if (match) {
+                    shouldInsert = false;
+                    break;
+                }
+            }
+        }
+        if (!shouldInsert) {
+            return collection;
+        }
+        const now = new Date();
+        const defaultAudit = { at: now, user: { id: 'system', type: 'system' } };
+        if (mergeType === 'replace') {
+            await this.engine.delete({
+                from: sourceName,
+            });
+        }
+        const docs = collection.map((item) => {
+            const record = item;
+            const id = typeof record['id'] === 'string' && record['id'] ? record['id'] : crypto.randomUUID();
+            return {
+                ...record,
+                id,
+                created: record['created'] ?? defaultAudit,
+                updated: record['updated'] ?? defaultAudit,
+            };
+        });
+        try {
+            await this.engine.insert({
+                into: sourceName,
+                documents: docs,
+            });
+        }
+        catch (error) {
+            //TODO Abstract!!! why Sqlite
+            const code = error?.code;
+            if (code !== 11000 &&
+                code !== 'SQLITE_CONSTRAINT_UNIQUE' &&
+                code !== 'SQLITE_CONSTRAINT_PRIMARYKEY') {
+                throw error;
+            }
+        }
+        return collection;
+    }
+    async resolveSourceName(entityName) {
+        await this.schemaResolver.ensureEntityReady(entityName);
+        return (0, entity_schema_naming_util_1.resolveEntityJqlSourceName)(entityName);
+    }
+}
+exports.EntityStoreService = EntityStoreService;
+//#endregion
+//# sourceMappingURL=entity-store.service.js.map

package/jql/abstract/src/lib/entity-store/entity-store.service.js.map

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

package/jql/abstract/src/lib/entity-store/entity-store.tokens.d.ts

@@ -0,0 +1,6 @@
+export declare const ENTITY_STORAGE_BACKEND: unique symbol;
+export declare const ENTITY_STORE_CONFIG: unique symbol;
+/** Resolved JQL instance name used by {@link EntityStoreService}. */
+export declare const ENTITY_STORAGE_JQL_INSTANCE: unique symbol;
+/** JQL engine bound to {@link ENTITY_STORAGE_JQL_INSTANCE}. */
+export declare const ENTITY_STORAGE_JQL_ENGINE: unique symbol;

package/jql/abstract/src/lib/entity-store/entity-store.tokens.js

@@ -0,0 +1,12 @@
+"use strict";
+//#region ---- Entity store DI tokens ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_STORAGE_JQL_ENGINE = exports.ENTITY_STORAGE_JQL_INSTANCE = exports.ENTITY_STORE_CONFIG = exports.ENTITY_STORAGE_BACKEND = void 0;
+exports.ENTITY_STORAGE_BACKEND = Symbol('ENTITY_STORAGE_BACKEND');
+exports.ENTITY_STORE_CONFIG = Symbol('ENTITY_STORE_CONFIG');
+/** Resolved JQL instance name used by {@link EntityStoreService}. */
+exports.ENTITY_STORAGE_JQL_INSTANCE = Symbol('ENTITY_STORAGE_JQL_INSTANCE');
+/** JQL engine bound to {@link ENTITY_STORAGE_JQL_INSTANCE}. */
+exports.ENTITY_STORAGE_JQL_ENGINE = Symbol('ENTITY_STORAGE_JQL_ENGINE');
+//#endregion
+//# sourceMappingURL=entity-store.tokens.js.map

package/jql/abstract/src/lib/entity-store/entity-store.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-store.tokens.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-store/entity-store.tokens.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAE7B,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAE1D,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE,qEAAqE;AACxD,QAAA,2BAA2B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AAEjF,+DAA+D;AAClD,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAE7E,YAAY"}

package/jql/abstract/src/lib/entity-store/entity-store.types.d.ts

@@ -0,0 +1,20 @@
+export interface AXPQuerySort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+export interface AXPQueryRequest {
+    skip?: number;
+    take?: number;
+    sort?: AXPQuerySort[];
+    filter?: unknown;
+    params?: Record<string, unknown>;
+}
+export interface AXPPagedListResult<T = unknown> {
+    total: number;
+    items: T[];
+}
+export interface EntityStoragePagedResponse {
+    totalCount: number;
+    items: unknown[];
+}
+export type AXPEntityOp = 'initial' | 'create' | 'update' | 'delete' | 'getOne' | 'getAll' | 'query' | 'count' | 'queryAll' | 'getMany' | 'exists' | 'upsertOne' | 'aggregate';

package/jql/abstract/src/lib/entity-store/entity-store.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- Query types ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=entity-store.types.js.map

package/jql/abstract/src/lib/entity-store/entity-store.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-store.types.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-store/entity-store.types.ts"],"names":[],"mappings":";AAAA,+BAA+B;;AA4C/B,YAAY"}

package/jql/abstract/src/lib/entity-store/entity-visibility-filter.util.d.ts

@@ -0,0 +1,22 @@
+import { AXPQueryRequest } from './entity-store.types';
+export declare const VISIBILITY_FILTER_BYPASS = "__bypassVisibilityFilter";
+export declare const OWNERSHIP_FILTER_BYPASS = "__bypassOwnershipFilter";
+interface AxpFilterGroup {
+    logic: 'and' | 'or';
+    filters: unknown[];
+}
+export interface EntityVisibilityFilterContext {
+    tenantId?: string;
+    applicationId?: string;
+    bypassVisibility?: boolean;
+    bypassOwnership?: boolean;
+}
+export declare function isFilterBypassed(params: Record<string, unknown> | undefined, key: string): boolean;
+export declare function bypassVisibilityFilter<T extends AXPQueryRequest>(request: T): T;
+export declare function bypassOwnershipFilter<T extends AXPQueryRequest>(request: T): T;
+export declare function bypassAllEntityVisibilityFilters<T extends AXPQueryRequest>(request: T): T;
+/** Builds AXP filter group for list/query visibility (tenant, application, hidden). */
+export declare function buildEntityVisibilityAxpFilter(context: EntityVisibilityFilterContext): AxpFilterGroup | undefined;
+/** AND-combines an existing AXP filter with an injected system filter. */
+export declare function mergeAxpQueryFilters(existing: unknown, injected: AxpFilterGroup | undefined): unknown;
+export {};

package/jql/abstract/src/lib/entity-store/entity-visibility-filter.util.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OWNERSHIP_FILTER_BYPASS = exports.VISIBILITY_FILTER_BYPASS = void 0;
+exports.isFilterBypassed = isFilterBypassed;
+exports.bypassVisibilityFilter = bypassVisibilityFilter;
+exports.bypassOwnershipFilter = bypassOwnershipFilter;
+exports.bypassAllEntityVisibilityFilters = bypassAllEntityVisibilityFilters;
+exports.buildEntityVisibilityAxpFilter = buildEntityVisibilityAxpFilter;
+exports.mergeAxpQueryFilters = mergeAxpQueryFilters;
+//#region ---- Bypass param keys (parity with mock connectivity) ----
+exports.VISIBILITY_FILTER_BYPASS = '__bypassVisibilityFilter';
+exports.OWNERSHIP_FILTER_BYPASS = '__bypassOwnershipFilter';
+//#endregion
+//#region ---- Bypass helpers ----
+function isFilterBypassed(params, key) {
+    return params?.[key] === 'true' || params?.[key] === true;
+}
+function bypassVisibilityFilter(request) {
+    return {
+        ...request,
+        params: { ...request.params, [exports.VISIBILITY_FILTER_BYPASS]: 'true' },
+    };
+}
+function bypassOwnershipFilter(request) {
+    return {
+        ...request,
+        params: { ...request.params, [exports.OWNERSHIP_FILTER_BYPASS]: 'true' },
+    };
+}
+function bypassAllEntityVisibilityFilters(request) {
+    return {
+        ...request,
+        params: {
+            ...request.params,
+            [exports.VISIBILITY_FILTER_BYPASS]: 'true',
+            [exports.OWNERSHIP_FILTER_BYPASS]: 'true',
+        },
+    };
+}
+//#endregion
+//#region ---- Filter builders ----
+function axpOr(...filters) {
+    return { logic: 'or', filters };
+}
+function axpAnd(...filters) {
+    return { logic: 'and', filters };
+}
+function axpLeaf(field, operatorType, value) {
+    return value === undefined
+        ? { field, operator: { type: operatorType } }
+        : { field, operator: { type: operatorType }, value };
+}
+/** Records visible when isHidden is not explicitly true (matches mock semantics). */
+function buildHiddenVisibilityFilter() {
+    return axpOr(axpLeaf('stateInfo.isHidden', 'notEqual', true), axpLeaf('stateInfo.isHidden', 'isEmpty'), axpLeaf('stateInfo.isHidden', 'isNull'));
+}
+/**
+ * Tenant scope: records without tenantId pass; when context tenant is set, others must match.
+ */
+function buildTenantOwnershipFilter(tenantId) {
+    return axpOr(axpLeaf('ownershipInfo.tenantId', 'isEmpty'), axpLeaf('ownershipInfo.tenantId', 'isNull'), axpLeaf('ownershipInfo.tenantId', 'equal', tenantId));
+}
+/**
+ * Application scope: records without applicationId pass; when session application is set, others must match.
+ */
+function buildApplicationOwnershipFilter(applicationId) {
+    return axpOr(axpLeaf('ownershipInfo.applicationId', 'isEmpty'), axpLeaf('ownershipInfo.applicationId', 'isNull'), axpLeaf('ownershipInfo.applicationId', 'equal', applicationId));
+}
+/** Builds AXP filter group for list/query visibility (tenant, application, hidden). */
+function buildEntityVisibilityAxpFilter(context) {
+    const filters = [];
+    if (!context.bypassVisibility) {
+        filters.push(buildHiddenVisibilityFilter());
+    }
+    if (!context.bypassOwnership) {
+        if (context.tenantId) {
+            filters.push(buildTenantOwnershipFilter(context.tenantId));
+        }
+        if (context.applicationId) {
+            filters.push(buildApplicationOwnershipFilter(context.applicationId));
+        }
+    }
+    if (!filters.length) {
+        return undefined;
+    }
+    return axpAnd(...filters);
+}
+/** AND-combines an existing AXP filter with an injected system filter. */
+function mergeAxpQueryFilters(existing, injected) {
+    if (!injected?.filters.length) {
+        return existing;
+    }
+    if (!existing) {
+        return injected;
+    }
+    return axpAnd(existing, injected);
+}
+//#endregion
+//# sourceMappingURL=entity-visibility-filter.util.js.map

package/jql/abstract/src/lib/entity-store/entity-visibility-filter.util.js.map

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

package/jql/abstract/src/lib/entity-store/json-store-record-id.util.d.ts

@@ -0,0 +1,2 @@
+/** Resolves a stable primary key for generic JSON store rows. */
+export declare function resolveJsonStoreRecordId(record: unknown, rowIndex: number): string;

package/jql/abstract/src/lib/entity-store/json-store-record-id.util.js

@@ -0,0 +1,23 @@
+"use strict";
+//#region ---- JSON store record id ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveJsonStoreRecordId = resolveJsonStoreRecordId;
+/** Resolves a stable primary key for generic JSON store rows. */
+function resolveJsonStoreRecordId(record, rowIndex) {
+    const row = (record ?? {});
+    if (row['id'] != null && row['id'] !== '') {
+        return String(row['id']);
+    }
+    if (row['fileId'] != null && row['fileId'] !== '') {
+        return String(row['fileId']);
+    }
+    if (typeof row['name'] === 'string' && row['name']) {
+        return row['name'];
+    }
+    if (typeof row['key'] === 'string' && row['key']) {
+        return row['key'];
+    }
+    return `__row_${rowIndex}`;
+}
+//#endregion
+//# sourceMappingURL=json-store-record-id.util.js.map

package/jql/abstract/src/lib/entity-store/json-store-record-id.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-store-record-id.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-store/json-store-record-id.util.ts"],"names":[],"mappings":";AAAA,wCAAwC;;AAGxC,4DAiBC;AAlBD,iEAAiE;AACjE,SAAgB,wBAAwB,CAAC,MAAe,EAAE,QAAgB;IACxE,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;IAEtD,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,SAAS,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,YAAY"}

package/jql/abstract/src/lib/jql-engine.base.d.ts

@@ -0,0 +1,43 @@
+import { JqlEntitySchema } from './entity-schema/jql-entity-schema.types';
+import { JqlDialect, JqlEngine } from './jql-engine.interface';
+import { JqlSourceRegistry } from './jql-source-registry';
+import { JqlSource } from './jql-source.types';
+import { JqlAggregate, JqlDelete, JqlInsert, JqlQuery, JqlResult, JqlUpdate } from './jql.types';
+/**
+ * Shared orchestration for dialect engines. Subclasses implement DB-specific primitives.
+ */
+export declare abstract class JqlEngineBase implements JqlEngine {
+    protected readonly registry: JqlSourceRegistry;
+    readonly instanceName: string;
+    abstract readonly dialect: JqlDialect;
+    private readonly ensuredSources;
+    private readonly ensuredEntityTables;
+    constructor(registry: JqlSourceRegistry, instanceName: string);
+    find<T = Record<string, unknown>>(query: JqlQuery): Promise<JqlResult<T>>;
+    findOne<T = Record<string, unknown>>(query: JqlQuery): Promise<T | null>;
+    count(query: Pick<JqlQuery, 'from' | 'where' | 'joins'>): Promise<number>;
+    aggregate<T = Record<string, unknown>>(query: JqlQuery & {
+        aggregate: JqlAggregate;
+    }): Promise<JqlResult<T>>;
+    insert(command: JqlInsert): Promise<string[]>;
+    update(command: JqlUpdate): Promise<number>;
+    delete(command: JqlDelete): Promise<number>;
+    /** Ensures physical schema (DDL / indexes) for a registered source (idempotent). */
+    ensureSource(source: JqlSource): Promise<void>;
+    /** Registers a source descriptor and ensures its physical schema. */
+    registerAndEnsureSource(source: JqlSource): Promise<void>;
+    /** Whether a JQL source name is registered on this engine instance. */
+    hasRegisteredSource(sourceName: string): boolean;
+    /** Ensures a per-entity structured table/collection (idempotent). */
+    ensureEntityTable(schema: JqlEntitySchema): Promise<void>;
+    protected abstract applySourceSchema(source: JqlSource): Promise<void>;
+    protected abstract applyEntityTableSchema(schema: JqlEntitySchema): Promise<void>;
+    protected abstract executeFind<T>(source: JqlSource, query: JqlQuery): Promise<JqlResult<T>>;
+    protected abstract executeCount(source: JqlSource, query: Pick<JqlQuery, 'where' | 'joins'>): Promise<number>;
+    protected abstract executeAggregate<T>(source: JqlSource, query: JqlQuery & {
+        aggregate: JqlAggregate;
+    }): Promise<JqlResult<T>>;
+    protected abstract executeInsert(source: JqlSource, command: JqlInsert): Promise<string[]>;
+    protected abstract executeUpdate(source: JqlSource, command: JqlUpdate): Promise<number>;
+    protected abstract executeDelete(source: JqlSource, command: JqlDelete): Promise<number>;
+}

package/jql/abstract/src/lib/jql-engine.base.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlEngineBase = void 0;
+//#region ---- Abstract JQL engine (template-method) ----
+/**
+ * Shared orchestration for dialect engines. Subclasses implement DB-specific primitives.
+ */
+class JqlEngineBase {
+    constructor(registry, instanceName) {
+        this.registry = registry;
+        this.instanceName = instanceName;
+        this.ensuredSources = new Set();
+        this.ensuredEntityTables = new Set();
+    }
+    async find(query) {
+        const source = this.registry.get(query.from);
+        await this.ensureSource(source);
+        return this.executeFind(source, query);
+    }
+    async findOne(query) {
+        const result = await this.find({ ...query, skip: 0, take: 1 });
+        return result.items[0] ?? null;
+    }
+    async count(query) {
+        const source = this.registry.get(query.from);
+        await this.ensureSource(source);
+        return this.executeCount(source, query);
+    }
+    async aggregate(query) {
+        const source = this.registry.get(query.from);
+        await this.ensureSource(source);
+        return this.executeAggregate(source, query);
+    }
+    async insert(command) {
+        const source = this.registry.get(command.into);
+        await this.ensureSource(source);
+        return this.executeInsert(source, command);
+    }
+    async update(command) {
+        const source = this.registry.get(command.update);
+        await this.ensureSource(source);
+        return this.executeUpdate(source, command);
+    }
+    async delete(command) {
+        const source = this.registry.get(command.from);
+        await this.ensureSource(source);
+        return this.executeDelete(source, command);
+    }
+    /** Ensures physical schema (DDL / indexes) for a registered source (idempotent). */
+    async ensureSource(source) {
+        if (this.ensuredSources.has(source.name)) {
+            return;
+        }
+        await this.applySourceSchema(source);
+        this.ensuredSources.add(source.name);
+    }
+    /** Registers a source descriptor and ensures its physical schema. */
+    async registerAndEnsureSource(source) {
+        if (!this.registry.has(source.name)) {
+            this.registry.register(source);
+        }
+        await this.ensureSource(source);
+    }
+    /** Whether a JQL source name is registered on this engine instance. */
+    hasRegisteredSource(sourceName) {
+        return this.registry.has(sourceName);
+    }
+    /** Ensures a per-entity structured table/collection (idempotent). */
+    async ensureEntityTable(schema) {
+        if (this.ensuredEntityTables.has(schema.entityName)) {
+            return;
+        }
+        await this.applyEntityTableSchema(schema);
+        this.ensuredEntityTables.add(schema.entityName);
+    }
+}
+exports.JqlEngineBase = JqlEngineBase;
+//#endregion
+//# sourceMappingURL=jql-engine.base.js.map

package/jql/abstract/src/lib/jql-engine.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-engine.base.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/abstract/src/lib/jql-engine.base.ts"],"names":[],"mappings":";;;AAaA,yDAAyD;AAEzD;;GAEG;AACH,MAAsB,aAAa;IAMjC,YACqB,QAA2B,EAC9B,YAAoB;QADjB,aAAQ,GAAR,QAAQ,CAAmB;QAC9B,iBAAY,GAAZ,YAAY,CAAQ;QALrB,mBAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,wBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAKtD,CAAC;IAEJ,KAAK,CAAC,IAAI,CAA8B,KAAe;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,WAAW,CAAI,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CAA8B,KAAe;QACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAI,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAiD;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,gBAAgB,CAAI,MAAM,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAkB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAkB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAkB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,YAAY,CAAC,MAAiB;QAClC,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,uBAAuB,CAAC,MAAiB;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,uEAAuE;IACvE,mBAAmB,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,iBAAiB,CAAC,MAAuB;QAC7C,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;CA0BF;AA9GD,sCA8GC;AAED,YAAY"}

package/jql/abstract/src/lib/jql-engine.interface.d.ts

@@ -0,0 +1,20 @@
+import { JqlEntitySchema } from './entity-schema/jql-entity-schema.types';
+import { JqlAggregate, JqlDelete, JqlInsert, JqlQuery, JqlResult, JqlUpdate } from './jql.types';
+export type JqlDialect = 'mongodb' | 'postgres' | 'json' | 'sqlite';
+/**
+ * Database-agnostic dynamic-data ORM. Implementations live in jql/{mongodb,postgres}.
+ */
+export interface JqlEngine {
+    readonly dialect: JqlDialect;
+    find<T = Record<string, unknown>>(query: JqlQuery): Promise<JqlResult<T>>;
+    findOne<T = Record<string, unknown>>(query: JqlQuery): Promise<T | null>;
+    count(query: Pick<JqlQuery, 'from' | 'where' | 'joins'>): Promise<number>;
+    aggregate<T = Record<string, unknown>>(query: JqlQuery & {
+        aggregate: JqlAggregate;
+    }): Promise<JqlResult<T>>;
+    insert(command: JqlInsert): Promise<string[]>;
+    update(command: JqlUpdate): Promise<number>;
+    delete(command: JqlDelete): Promise<number>;
+    /** Ensures a per-entity structured table/collection exists and is migrated. */
+    ensureEntityTable(schema: JqlEntitySchema): Promise<void>;
+}

package/jql/abstract/src/lib/jql-engine.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=jql-engine.interface.js.map

package/jql/abstract/src/lib/jql-engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-engine.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/abstract/src/lib/jql-engine.interface.ts"],"names":[],"mappings":";;AAmCA,YAAY"}

package/jql/abstract/src/lib/jql-filter.util.d.ts

@@ -0,0 +1,5 @@
+import { JqlCondition, JqlFilter } from './jql.types';
+/** Combines two filters with AND logic. */
+export declare function andFilters(left?: JqlFilter, right?: JqlFilter): JqlFilter | undefined;
+/** Builds a simple equality condition. */
+export declare function eqCondition(field: string, value: unknown): JqlCondition;

package/jql/abstract/src/lib/jql-filter.util.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.andFilters = andFilters;
+exports.eqCondition = eqCondition;
+const jql_types_1 = require("./jql.types");
+//#region ---- Filter helpers ----
+/** Combines two filters with AND logic. */
+function andFilters(left, right) {
+    if (!left) {
+        return right;
+    }
+    if (!right) {
+        return left;
+    }
+    return {
+        logic: 'and',
+        filters: flattenAndGroup(left, right),
+    };
+}
+function flattenAndGroup(...filters) {
+    const result = [];
+    for (const filter of filters) {
+        if ((0, jql_types_1.isJqlGroup)(filter) && filter.logic === 'and') {
+            result.push(...filter.filters);
+        }
+        else {
+            result.push(filter);
+        }
+    }
+    return result;
+}
+/** Builds a simple equality condition. */
+function eqCondition(field, value) {
+    return { field, op: 'eq', value };
+}
+//#endregion
+//# sourceMappingURL=jql-filter.util.js.map

package/jql/abstract/src/lib/jql-filter.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-filter.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/abstract/src/lib/jql-filter.util.ts"],"names":[],"mappings":";;AAKA,gCAWC;AAeD,kCAEC;AAjCD,2CAA4E;AAE5E,kCAAkC;AAElC,2CAA2C;AAC3C,SAAgB,UAAU,CAAC,IAAgB,EAAE,KAAiB;IAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;KACnB,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,GAAG,OAAoB;IAC9C,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,IAAA,sBAAU,EAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0CAA0C;AAC1C,SAAgB,WAAW,CAAC,KAAa,EAAE,KAAc;IACvD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,YAAY"}

package/jql/abstract/src/lib/jql-operator.util.d.ts

@@ -0,0 +1,3 @@
+import { JqlOperator } from './jql.types';
+/** Normalizes legacy/API operator strings to canonical {@link JqlOperator}. */
+export declare function normalizeJqlOperator(raw: string): JqlOperator;