@acorex-platform/framework-server 0.0.10

package/identifier/src/lib/identifier.providers.js

@@ -0,0 +1,108 @@
+"use strict";
+//#region ---- Utility providers ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendSequenceProviderService = exports.BackendLookupProviderService = exports.BackendPolicyProviderService = exports.BackendChecksumProviderService = exports.BackendClockProviderService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const identifier_sequence_store_1 = require("./identifier-sequence.store");
+const identifier_rule_registry_1 = require("./identifier-rule.registry");
+let BackendClockProviderService = class BackendClockProviderService {
+    now() {
+        return new Date();
+    }
+};
+exports.BackendClockProviderService = BackendClockProviderService;
+exports.BackendClockProviderService = BackendClockProviderService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], BackendClockProviderService);
+let BackendChecksumProviderService = class BackendChecksumProviderService {
+    compute(algo, input) {
+        if (algo === 'luhn') {
+            let sum = 0;
+            let dbl = false;
+            for (let i = input.length - 1; i >= 0; i--) {
+                let d = parseInt(input[i], 10);
+                if (Number.isNaN(d)) {
+                    d = 0;
+                }
+                if (dbl) {
+                    d *= 2;
+                    if (d > 9) {
+                        d -= 9;
+                    }
+                }
+                sum += d;
+                dbl = !dbl;
+            }
+            return String((10 - (sum % 10)) % 10);
+        }
+        let weight = 2;
+        let total = 0;
+        for (let i = input.length - 1; i >= 0; i--) {
+            const d = parseInt(input[i], 10) || 0;
+            total += d * weight;
+            weight = weight === 7 ? 2 : weight + 1;
+        }
+        const r = total % 11;
+        const c = (11 - r) % 11;
+        return c === 10 ? 'X' : String(c);
+    }
+};
+exports.BackendChecksumProviderService = BackendChecksumProviderService;
+exports.BackendChecksumProviderService = BackendChecksumProviderService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], BackendChecksumProviderService);
+let BackendPolicyProviderService = class BackendPolicyProviderService {
+    isAllowed() {
+        return true;
+    }
+};
+exports.BackendPolicyProviderService = BackendPolicyProviderService;
+exports.BackendPolicyProviderService = BackendPolicyProviderService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], BackendPolicyProviderService);
+let BackendLookupProviderService = class BackendLookupProviderService {
+    constructor() {
+        this.map = new Map();
+    }
+    async get(key) {
+        return this.map.get(key);
+    }
+};
+exports.BackendLookupProviderService = BackendLookupProviderService;
+exports.BackendLookupProviderService = BackendLookupProviderService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], BackendLookupProviderService);
+let BackendSequenceProviderService = class BackendSequenceProviderService {
+    constructor(store, ruleRegistry) {
+        this.store = store;
+        this.ruleRegistry = ruleRegistry;
+    }
+    async next(scopeHash, ruleId, options) {
+        const id = scopeHash;
+        const row = await this.store.get(id);
+        const consume = options?.consume ?? false;
+        const rule = await this.ruleRegistry.findById(ruleId);
+        const minValue = rule?.scopeConfig?.minValue ?? 0;
+        if (!row) {
+            const initial = minValue;
+            await this.store.add({ id, ruleId, scopeHash: id, currentValue: initial });
+            return initial;
+        }
+        const nextVal = row.currentValue + (consume ? 1 : 0);
+        if (nextVal < minValue) {
+            await this.store.update(id, { currentValue: minValue });
+            return minValue;
+        }
+        await this.store.update(id, { currentValue: nextVal });
+        return consume ? nextVal : row.currentValue;
+    }
+};
+exports.BackendSequenceProviderService = BackendSequenceProviderService;
+exports.BackendSequenceProviderService = BackendSequenceProviderService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [identifier_sequence_store_1.BackendIdentifierSequenceStore,
+        identifier_rule_registry_1.BackendIdentifierRuleRegistry])
+], BackendSequenceProviderService);
+//#endregion
+//# sourceMappingURL=identifier.providers.js.map

package/identifier/src/lib/identifier.providers.js.map

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

package/identifier/src/lib/identifier.types.d.ts

@@ -0,0 +1,31 @@
+export interface BackendIdentifierRequest {
+    /** Identifier rule id, e.g. `employee-code`. */
+    id: string;
+    tenantId?: string;
+    appId?: string;
+    payload?: Record<string, unknown>;
+}
+export interface BackendIdentifierResult {
+    code: string;
+    ruleId: string;
+    scopeHash: string;
+    consumed: boolean;
+    meta?: Record<string, unknown>;
+}
+export interface BackendIdentifierPeekResult extends BackendIdentifierResult {
+    consumed: false;
+    commitToken: string;
+}
+export type { AXPIdentifierRule } from '@acorex-platform-module/identifier-management/contracts';
+export interface BackendValidateIdentifierBody {
+    code: string;
+    entity: string;
+    tenantId?: string;
+}
+export interface BackendCommitByCodeBody {
+    request: BackendIdentifierRequest;
+    code: string;
+}
+export interface BackendCommitTokenBody {
+    token: string;
+}

package/identifier/src/lib/identifier.types.js

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

package/identifier/src/lib/identifier.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.types.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/identifier/src/lib/identifier.types.ts"],"names":[],"mappings":";AAAA,gCAAgC;;AAwChC,YAAY"}

package/identifier/src/lib/pattern-engine.d.ts

@@ -0,0 +1,20 @@
+import type { BackendEvalContext, BackendPatternToken } from './tokens.types';
+import { BackendTokenRegistryService } from './token-registry.service';
+export type BackendCompiledFragment = BackendPatternToken | {
+    type: 'literal';
+    text: string;
+};
+export interface BackendCompiledPattern {
+    pattern: string;
+    tokens: BackendCompiledFragment[];
+}
+export interface BackendPatternEngine {
+    compile(pattern: string): BackendCompiledPattern;
+    evaluate(compiled: BackendCompiledPattern, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendSimplePatternEngine implements BackendPatternEngine {
+    private readonly registry;
+    constructor(registry: BackendTokenRegistryService);
+    compile(pattern: string): BackendCompiledPattern;
+    evaluate(compiled: BackendCompiledPattern, ctx: BackendEvalContext): Promise<string>;
+}

package/identifier/src/lib/pattern-engine.js

@@ -0,0 +1,70 @@
+"use strict";
+//#region ---- Pattern engine ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendSimplePatternEngine = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const token_registry_service_1 = require("./token-registry.service");
+const TOKEN_REGEX = /\{([^{}]+)\}/g;
+let BackendSimplePatternEngine = class BackendSimplePatternEngine {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    compile(pattern) {
+        const tokens = [];
+        let match;
+        let index = 0;
+        let lastIndex = 0;
+        while ((match = TOKEN_REGEX.exec(pattern)) !== null) {
+            const literal = pattern.slice(lastIndex, match.index);
+            if (literal) {
+                tokens.push({ type: 'literal', text: literal });
+            }
+            const raw = match[0];
+            const inner = match[1];
+            const [name] = inner.split(':');
+            const token = {
+                name: name.trim(),
+                args: inner.includes(':') ? inner.substring(inner.indexOf(':') + 1).split(':') : [],
+                raw,
+                index: index++,
+            };
+            const handler = this.registry.get(token.name);
+            if (!handler) {
+                throw new Error(`Unknown token: ${token.name}`);
+            }
+            handler.validate?.(token);
+            tokens.push(token);
+            lastIndex = match.index + raw.length;
+        }
+        const tail = pattern.slice(lastIndex);
+        if (tail) {
+            tokens.push({ type: 'literal', text: tail });
+        }
+        return { pattern, tokens };
+    }
+    async evaluate(compiled, ctx) {
+        let built = '';
+        for (const frag of compiled.tokens) {
+            if (frag.type === 'literal') {
+                built += frag.text;
+                continue;
+            }
+            const token = frag;
+            ctx.cache.set('__acc__', built);
+            const handler = this.registry.get(token.name);
+            if (!handler) {
+                throw new Error(`Unknown token at eval: ${token.name}`);
+            }
+            built += await handler.eval(token, ctx);
+        }
+        return built;
+    }
+};
+exports.BackendSimplePatternEngine = BackendSimplePatternEngine;
+exports.BackendSimplePatternEngine = BackendSimplePatternEngine = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [token_registry_service_1.BackendTokenRegistryService])
+], BackendSimplePatternEngine);
+//#endregion
+//# sourceMappingURL=pattern-engine.js.map

package/identifier/src/lib/pattern-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-engine.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/identifier/src/lib/pattern-engine.ts"],"names":[],"mappings":";AAAA,kCAAkC;;;;AAElC,2CAA4C;AAE5C,qEAAuE;AAcvE,MAAM,WAAW,GAAG,eAAe,CAAC;AAG7B,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAA6B,QAAqC;QAArC,aAAQ,GAAR,QAAQ,CAA6B;IAAG,CAAC;IAEtE,OAAO,CAAC,OAAe;QACrB,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,IAAI,KAA6B,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACtD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,KAAK,GAAwB;gBACjC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;gBACjB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;gBACnF,GAAG;gBACH,KAAK,EAAE,KAAK,EAAE;aACf,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgC,EAAE,GAAuB;QACtE,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnC,IAAK,IAA0B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACnD,KAAK,IAAK,IAAyB,CAAC,IAAI,CAAC;gBACzC,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,IAA2B,CAAC;YAC1C,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAzDY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;6CAE4B,oDAA2B;GADvD,0BAA0B,CAyDtC;AAED,YAAY"}

package/identifier/src/lib/token-registry.service.d.ts

@@ -0,0 +1,8 @@
+import type { BackendTokenHandler, BackendTokenRegistry } from './tokens.types';
+export declare class BackendTokenRegistryService implements BackendTokenRegistry {
+    private readonly handlers;
+    register(handler: BackendTokenHandler): void;
+    unregister(name: string): void;
+    get(name: string): BackendTokenHandler | undefined;
+    list(): BackendTokenHandler[];
+}

package/identifier/src/lib/token-registry.service.js

@@ -0,0 +1,27 @@
+"use strict";
+//#region ---- Token registry ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendTokenRegistryService = void 0;
+class BackendTokenRegistryService {
+    constructor() {
+        this.handlers = new Map();
+    }
+    register(handler) {
+        const existing = this.handlers.get(handler.name);
+        if (!existing || (handler.priority ?? 0) > (existing.priority ?? 0)) {
+            this.handlers.set(handler.name, handler);
+        }
+    }
+    unregister(name) {
+        this.handlers.delete(name);
+    }
+    get(name) {
+        return this.handlers.get(name);
+    }
+    list() {
+        return Array.from(this.handlers.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+}
+exports.BackendTokenRegistryService = BackendTokenRegistryService;
+//#endregion
+//# sourceMappingURL=token-registry.service.js.map

package/identifier/src/lib/token-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-registry.service.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/identifier/src/lib/token-registry.service.ts"],"names":[],"mappings":";AAAA,kCAAkC;;;AAIlC,MAAa,2BAA2B;IAAxC;QACmB,aAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAoBrE,CAAC;IAlBC,QAAQ,CAAC,OAA4B;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;CACF;AArBD,kEAqBC;AAED,YAAY"}

package/identifier/src/lib/tokens-default.d.ts

@@ -0,0 +1,33 @@
+import type { BackendChecksumProvider, BackendClockProvider, BackendEvalContext, BackendPatternToken, BackendTokenHandler } from './tokens.types';
+export declare class BackendDateToken implements BackendTokenHandler {
+    private readonly clock;
+    readonly name = "date";
+    constructor(clock: BackendClockProvider);
+    eval(token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendConstToken implements BackendTokenHandler {
+    readonly name = "const";
+    eval(token: BackendPatternToken): Promise<string>;
+}
+export declare class BackendFieldToken implements BackendTokenHandler {
+    readonly name = "field";
+    eval(token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendTenantToken implements BackendTokenHandler {
+    readonly name = "tenant";
+    eval(_token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendAppToken implements BackendTokenHandler {
+    readonly name = "app";
+    eval(_token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendSeqToken implements BackendTokenHandler {
+    readonly name = "seq";
+    eval(token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export declare class BackendCheckToken implements BackendTokenHandler {
+    private readonly checksum;
+    readonly name = "check";
+    constructor(checksum: BackendChecksumProvider);
+    eval(token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}

package/identifier/src/lib/tokens-default.js

@@ -0,0 +1,99 @@
+"use strict";
+//#region ---- Built-in token handlers ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendCheckToken = exports.BackendSeqToken = exports.BackendAppToken = exports.BackendTenantToken = exports.BackendFieldToken = exports.BackendConstToken = exports.BackendDateToken = void 0;
+const utils_1 = require("./utils");
+class BackendDateToken {
+    constructor(clock) {
+        this.clock = clock;
+        this.name = 'date';
+    }
+    async eval(token, ctx) {
+        const fmt = token.args[0] ?? 'YYYYMMDD';
+        const d = ctx.services.clock?.now() ?? ctx.now;
+        const y = String(d.getFullYear());
+        const m = (0, utils_1.padNumber)(d.getMonth() + 1, 2);
+        const day = (0, utils_1.padNumber)(d.getDate(), 2);
+        switch (fmt) {
+            case 'YYYY':
+                return y;
+            case 'YYYYMM':
+                return y + m;
+            case 'YYYYMMDD':
+            default:
+                return y + m + day;
+        }
+    }
+}
+exports.BackendDateToken = BackendDateToken;
+class BackendConstToken {
+    constructor() {
+        this.name = 'const';
+    }
+    async eval(token) {
+        return token.args.join(':');
+    }
+}
+exports.BackendConstToken = BackendConstToken;
+class BackendFieldToken {
+    constructor() {
+        this.name = 'field';
+    }
+    async eval(token, ctx) {
+        const key = token.args[0];
+        if (!key) {
+            return '';
+        }
+        const value = ctx.request.payload?.[key];
+        return value == null ? '' : String(value);
+    }
+}
+exports.BackendFieldToken = BackendFieldToken;
+class BackendTenantToken {
+    constructor() {
+        this.name = 'tenant';
+    }
+    async eval(_token, ctx) {
+        return ctx.request.tenantId ?? '';
+    }
+}
+exports.BackendTenantToken = BackendTenantToken;
+class BackendAppToken {
+    constructor() {
+        this.name = 'app';
+    }
+    async eval(_token, ctx) {
+        return ctx.request.appId ?? '';
+    }
+}
+exports.BackendAppToken = BackendAppToken;
+class BackendSeqToken {
+    constructor() {
+        this.name = 'seq';
+    }
+    async eval(token, ctx) {
+        const pad = Number(token.args[0] ?? '0') || 0;
+        const consume = ctx.evaluationMode === 'commit';
+        const ruleId = ctx.cache.get('ruleId');
+        const n = await ctx.services.sequence.next(ctx.cache.get('scopeHash'), ruleId, {
+            pad,
+            consume,
+        });
+        return pad ? (0, utils_1.padNumber)(n, pad) : String(n);
+    }
+}
+exports.BackendSeqToken = BackendSeqToken;
+class BackendCheckToken {
+    constructor(checksum) {
+        this.checksum = checksum;
+        this.name = 'check';
+    }
+    async eval(token, ctx) {
+        const algo = token.args[0] ?? 'luhn';
+        const acc = String(ctx.cache.get('__acc__') ?? '');
+        return ctx.services.checksum.compute(algo, acc);
+    }
+}
+exports.BackendCheckToken = BackendCheckToken;
+//#endregion
+//# sourceMappingURL=tokens-default.js.map

package/identifier/src/lib/tokens-default.js.map

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

package/identifier/src/lib/tokens.types.d.ts

@@ -0,0 +1,54 @@
+import type { BackendIdentifierRequest } from './identifier.types';
+export interface BackendPatternToken {
+    name: string;
+    args: string[];
+    raw: string;
+    index: number;
+}
+export interface BackendEvalServices {
+    sequence: BackendSequenceProvider;
+    checksum: BackendChecksumProvider;
+    lookup?: BackendLookupProvider;
+    policy?: BackendPolicyProvider;
+    clock?: BackendClockProvider;
+}
+export interface BackendEvalContext {
+    pattern: string;
+    request: BackendIdentifierRequest;
+    cache: Map<string, unknown>;
+    now: Date;
+    services: BackendEvalServices;
+    evaluationMode: 'preview' | 'commit';
+}
+export interface BackendTokenHandler {
+    readonly name: string;
+    readonly priority?: number;
+    validate?(token: BackendPatternToken): void | never;
+    eval(token: BackendPatternToken, ctx: BackendEvalContext): Promise<string>;
+}
+export interface BackendTokenRegistry {
+    register(handler: BackendTokenHandler): void;
+    unregister(name: string): void;
+    get(name: string): BackendTokenHandler | undefined;
+    list(): BackendTokenHandler[];
+}
+export interface BackendSequenceProvider {
+    next(scopeHash: string, ruleId: string, options?: {
+        pad?: number;
+        consume?: boolean;
+    }): Promise<number>;
+}
+export interface BackendChecksumProvider {
+    compute(algo: 'luhn' | 'mod11', input: string): string;
+}
+export interface BackendLookupProvider {
+    get(key: string, params?: Record<string, unknown>): Promise<string | undefined>;
+}
+export interface BackendPolicyProvider {
+    isAllowed(tokenName: string, request: BackendIdentifierRequest): boolean;
+}
+export interface BackendClockProvider {
+    now(): Date;
+}
+/** NestJS multi-provider token for registering identifier rules on the backend. */
+export declare const BACKEND_IDENTIFIER_RULES = "BACKEND_IDENTIFIER_RULES";

package/identifier/src/lib/tokens.types.js

@@ -0,0 +1,8 @@
+"use strict";
+//#region ---- Token contracts ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKEND_IDENTIFIER_RULES = void 0;
+//#endregion
+/** NestJS multi-provider token for registering identifier rules on the backend. */
+exports.BACKEND_IDENTIFIER_RULES = 'BACKEND_IDENTIFIER_RULES';
+//# sourceMappingURL=tokens.types.js.map

package/identifier/src/lib/tokens.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.types.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/identifier/src/lib/tokens.types.ts"],"names":[],"mappings":";AAAA,mCAAmC;;;AA8DnC,YAAY;AAEZ,mFAAmF;AACtE,QAAA,wBAAwB,GAAG,0BAA0B,CAAC"}

package/identifier/src/lib/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function buildScopeHash(parts: Array<string | undefined>): string;
+export declare function padNumber(num: number, size: number): string;

package/identifier/src/lib/utils.js

@@ -0,0 +1,17 @@
+"use strict";
+//#region ---- Utility functions ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildScopeHash = buildScopeHash;
+exports.padNumber = padNumber;
+function buildScopeHash(parts) {
+    return parts.filter(Boolean).join('|');
+}
+function padNumber(num, size) {
+    const s = String(num);
+    if (s.length >= size) {
+        return s;
+    }
+    return '0'.repeat(size - s.length) + s;
+}
+//#endregion
+//# sourceMappingURL=utils.js.map

package/identifier/src/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/identifier/src/lib/utils.ts"],"names":[],"mappings":";AAAA,qCAAqC;;AAErC,wCAEC;AAED,8BAMC;AAVD,SAAgB,cAAc,CAAC,KAAgC;IAC7D,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,SAAS,CAAC,GAAW,EAAE,IAAY;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,YAAY"}

package/jql/abstract/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@acorex-platform/framework-server/jql/abstract",
+  "version": "0.0.0-ACOREX",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0"
+  }
+}

package/jql/abstract/src/index.d.ts

@@ -0,0 +1,26 @@
+export * from './lib/jql.types';
+export * from './lib/jql-source.types';
+export * from './lib/jql.tokens';
+export * from './lib/jql-engine.interface';
+export * from './lib/jql-engine.base';
+export * from './lib/jql-source-registry';
+export * from './lib/jql-operator.util';
+export * from './lib/jql-filter.util';
+export * from './lib/odata/odata-query.parser';
+export * from './lib/odata/odata-query.types';
+export * from './lib/entity-store/entity-store.types';
+export * from './lib/entity-store/entity-store-initial.types';
+export * from './lib/entity-store/entity-store-backend.interface';
+export * from './lib/entity-store/entity-store.tokens';
+export * from './lib/entity-schema/jql-entity-schema.types';
+export * from './lib/entity-schema/jql-entity-schema-not-found.error';
+export * from './lib/entity-schema/entity-schema-naming.util';
+export * from './lib/entity-schema/entity-storage-source.util';
+export * from './lib/entity-store/entity-store-request.util';
+export * from './lib/entity-store/entity-fulltext-search.util';
+export * from './lib/entity-store/entity-fulltext-search-paths.util';
+export * from './lib/entity-store/entity-visibility-filter.util';
+export * from './lib/entity-store/category-hierarchy-filter.util';
+export * from './lib/entity-store/entity-store-aggregate.util';
+export * from './lib/entity-store/json-store-record-id.util';
+export * from './lib/entity-store/entity-store.service';

package/jql/abstract/src/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/jql.types"), exports);
+tslib_1.__exportStar(require("./lib/jql-source.types"), exports);
+tslib_1.__exportStar(require("./lib/jql.tokens"), exports);
+tslib_1.__exportStar(require("./lib/jql-engine.interface"), exports);
+tslib_1.__exportStar(require("./lib/jql-engine.base"), exports);
+tslib_1.__exportStar(require("./lib/jql-source-registry"), exports);
+tslib_1.__exportStar(require("./lib/jql-operator.util"), exports);
+tslib_1.__exportStar(require("./lib/jql-filter.util"), exports);
+tslib_1.__exportStar(require("./lib/odata/odata-query.parser"), exports);
+tslib_1.__exportStar(require("./lib/odata/odata-query.types"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store.types"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store-initial.types"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store-backend.interface"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store.tokens"), exports);
+tslib_1.__exportStar(require("./lib/entity-schema/jql-entity-schema.types"), exports);
+tslib_1.__exportStar(require("./lib/entity-schema/jql-entity-schema-not-found.error"), exports);
+tslib_1.__exportStar(require("./lib/entity-schema/entity-schema-naming.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-schema/entity-storage-source.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store-request.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-fulltext-search.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-fulltext-search-paths.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-visibility-filter.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/category-hierarchy-filter.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store-aggregate.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/json-store-record-id.util"), exports);
+tslib_1.__exportStar(require("./lib/entity-store/entity-store.service"), exports);
+//# sourceMappingURL=index.js.map

package/jql/abstract/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/jql/abstract/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,iEAAuC;AACvC,2DAAiC;AACjC,qEAA2C;AAC3C,gEAAsC;AACtC,oEAA0C;AAC1C,kEAAwC;AACxC,gEAAsC;AACtC,yEAA+C;AAC/C,wEAA8C;AAC9C,gFAAsD;AACtD,wFAA8D;AAC9D,4FAAkE;AAClE,iFAAuD;AACvD,sFAA4D;AAC5D,gGAAsE;AACtE,wFAA8D;AAC9D,yFAA+D;AAC/D,uFAA6D;AAC7D,yFAA+D;AAC/D,+FAAqE;AACrE,2FAAiE;AACjE,4FAAkE;AAClE,yFAA+D;AAC/D,uFAA6D;AAC7D,kFAAwD"}

package/jql/abstract/src/lib/entity-schema/entity-schema-naming.util.d.ts

@@ -0,0 +1,6 @@
+/** Converts an entity name (e.g. `TaskManagement.Task`) to a physical table/collection name. */
+export declare function entityNameToStorageName(entityName: string): string;
+/** JQL source name for an entity (same as logical entity name). */
+export declare function resolveEntityJqlSourceName(entityName: string): string;
+/** Resolves a logical column name to its physical snake_case column name. */
+export declare function resolveColumnName(name: string, columnName?: string): string;