@acorex-platform/framework-server 0.0.10

package/jql/seed/package.json

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

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

@@ -0,0 +1,13 @@
+export * from './lib/entity-seed-storage.adapter';
+export * from './lib/entity-data-seed.provider';
+export * from './lib/jql-auto-seed.resolve';
+export * from './lib/jql-auto-seed.service';
+export * from './lib/jql-engine-registry.service';
+export * from './lib/jql-multi-seed-runner.service';
+export * from './lib/jql-seed-phase.resolve';
+export * from './lib/jql-seed-provider.interface';
+export * from './lib/jql-seed-runner.service';
+export * from './lib/jql-seed-target.types';
+export * from './lib/jql-seed.module';
+export * from './lib/jql-seed.tokens';
+export * from './lib/jql-store-seed.writer';

package/jql/seed/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/entity-seed-storage.adapter"), exports);
+tslib_1.__exportStar(require("./lib/entity-data-seed.provider"), exports);
+tslib_1.__exportStar(require("./lib/jql-auto-seed.resolve"), exports);
+tslib_1.__exportStar(require("./lib/jql-auto-seed.service"), exports);
+tslib_1.__exportStar(require("./lib/jql-engine-registry.service"), exports);
+tslib_1.__exportStar(require("./lib/jql-multi-seed-runner.service"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed-phase.resolve"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed-provider.interface"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed-runner.service"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed-target.types"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed.module"), exports);
+tslib_1.__exportStar(require("./lib/jql-seed.tokens"), exports);
+tslib_1.__exportStar(require("./lib/jql-store-seed.writer"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/jql/seed/src/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkD;AAClD,0EAAgD;AAChD,sEAA4C;AAC5C,sEAA4C;AAC5C,4EAAkD;AAClD,8EAAoD;AACpD,uEAA6C;AAC7C,4EAAkD;AAClD,wEAA8C;AAC9C,sEAA4C;AAC5C,gEAAsC;AACtC,gEAAsC;AACtC,sEAA4C"}

package/jql/seed/src/lib/entity-data-seed.provider.d.ts

@@ -0,0 +1,14 @@
+import type { AXPModuleSeedCatalog } from '@acorex-platform-module/common/seed';
+import type { JqlSeedProvider } from './jql-seed-provider.interface';
+import type { JqlSeedTarget } from './jql-seed-target.types';
+/**
+ * Wraps module entity seed catalogs as {@link JqlSeedTarget} rows for the entity-storage instance.
+ */
+export declare class EntityDataSeedProvider implements JqlSeedProvider {
+    private readonly catalogs;
+    private readonly entityStorageInstance;
+    readonly name = "entity-data-catalogs";
+    readonly phase: "data";
+    constructor(catalogs: readonly AXPModuleSeedCatalog[], entityStorageInstance: string);
+    resolve(): Promise<readonly JqlSeedTarget[]>;
+}

package/jql/seed/src/lib/entity-data-seed.provider.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityDataSeedProvider = 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_seed_tokens_1 = require("./jql-seed.tokens");
+//#region ---- Entity data seed provider ----
+/**
+ * Wraps module entity seed catalogs as {@link JqlSeedTarget} rows for the entity-storage instance.
+ */
+let EntityDataSeedProvider = class EntityDataSeedProvider {
+    constructor(catalogs, entityStorageInstance) {
+        this.catalogs = catalogs;
+        this.entityStorageInstance = entityStorageInstance;
+        this.name = 'entity-data-catalogs';
+        this.phase = 'data';
+    }
+    async resolve() {
+        const targets = [];
+        for (const catalog of this.catalogs) {
+            for (const definition of catalog.definitions) {
+                targets.push({
+                    name: definition.name,
+                    phase: 'data',
+                    kind: 'entity',
+                    jqlInstance: this.entityStorageInstance,
+                    target: definition.entityName,
+                    records: definition.rows,
+                    seed: definition.seed,
+                });
+            }
+        }
+        return targets;
+    }
+};
+exports.EntityDataSeedProvider = EntityDataSeedProvider;
+exports.EntityDataSeedProvider = EntityDataSeedProvider = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(jql_seed_tokens_1.JQL_SEED_CATALOGS)),
+    tslib_1.__param(1, (0, common_1.Inject)(abstract_1.ENTITY_STORAGE_JQL_INSTANCE)),
+    tslib_1.__metadata("design:paramtypes", [Array, String])
+], EntityDataSeedProvider);
+//#endregion
+//# sourceMappingURL=entity-data-seed.provider.js.map

package/jql/seed/src/lib/entity-data-seed.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-data-seed.provider.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/entity-data-seed.provider.ts"],"names":[],"mappings":";;;;AAAA,2CAAoD;AAEpD,6EAA6F;AAG7F,uDAAsD;AAEtD,6CAA6C;AAE7C;;GAEG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAIjC,YAC6B,QAA0D,EAChD,qBAA8C;QADvC,aAAQ,GAAR,QAAQ,CAAiC;QAC/B,0BAAqB,GAArB,qBAAqB,CAAQ;QAL5E,SAAI,GAAG,sBAAsB,CAAC;QAC9B,UAAK,GAAG,MAAe,CAAC;IAK9B,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAAoB,EAAE,CAAC;QAEpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,IAAI,CAAC,qBAAqB;oBACvC,MAAM,EAAE,UAAU,CAAC,UAAU;oBAC7B,OAAO,EAAE,UAAU,CAAC,IAAiC;oBACrD,IAAI,EAAE,UAAU,CAAC,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AA5BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;IAMR,mBAAA,IAAA,eAAM,EAAC,mCAAiB,CAAC,CAAA;IACzB,mBAAA,IAAA,eAAM,EAAC,sCAA2B,CAAC,CAAA;;GAN3B,sBAAsB,CA4BlC;AAED,YAAY"}

package/jql/seed/src/lib/entity-seed-storage.adapter.d.ts

@@ -0,0 +1,3 @@
+import type { AXPEntitySeedStorage } from '@acorex-platform-module/common/seed';
+import type { EntityStorageBackend } from '@acorex-platform/framework-server/jql/abstract';
+export declare function createEntitySeedStorageAdapter(backend: EntityStorageBackend): AXPEntitySeedStorage;

package/jql/seed/src/lib/entity-seed-storage.adapter.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntitySeedStorageAdapter = createEntitySeedStorageAdapter;
+//#region ---- Entity storage → seed port adapter ----
+const DEFAULT_SEED_INITIAL_OPTIONS = {
+    mergeType: 'replace',
+    skipExistenceCheck: true,
+    uniqueKeys: ['id'],
+};
+function createEntitySeedStorageAdapter(backend) {
+    return {
+        initial: (entityName, collection, options) => backend.initial(entityName, collection, {
+            ...DEFAULT_SEED_INITIAL_OPTIONS,
+            ...options,
+        }),
+        async getAll(entityName) {
+            const result = await backend.query(entityName, { skip: 0, take: 0 });
+            return (result.items ?? []);
+        },
+        insertOne: (entityName, entity) => backend.insertOne(entityName, entity),
+        updateOne: (entityName, id, keyValues) => backend.updateOne(entityName, id, keyValues),
+    };
+}
+//#endregion
+//# sourceMappingURL=entity-seed-storage.adapter.js.map

package/jql/seed/src/lib/entity-seed-storage.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-seed-storage.adapter.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/entity-seed-storage.adapter.ts"],"names":[],"mappings":";;AAWA,wEAuBC;AA/BD,sDAAsD;AAEtD,MAAM,4BAA4B,GAAG;IACnC,SAAS,EAAE,SAAkB;IAC7B,kBAAkB,EAAE,IAAI;IACxB,UAAU,EAAE,CAAC,IAAI,CAAC;CACnB,CAAC;AAEF,SAAgB,8BAA8B,CAAC,OAA6B;IAC1E,OAAO;QACL,OAAO,EAAE,CACP,UAAkB,EAClB,UAAe,EACf,OAAwD,EACxD,EAAE,CACF,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE;YACtC,GAAG,4BAA4B;YAC/B,GAAG,OAAO;SACX,CAAiB;QAEpB,KAAK,CAAC,MAAM,CAAC,UAAkB;YAC7B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAqD,CAAC;QAClF,CAAC;QAED,SAAS,EAAE,CAAC,UAAkB,EAAE,MAA+B,EAAE,EAAE,CACjE,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAoB;QAE1D,SAAS,EAAE,CAAC,UAAkB,EAAE,EAAU,EAAE,SAAkC,EAAE,EAAE,CAChF,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,SAAS,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,YAAY"}

package/jql/seed/src/lib/jql-auto-seed.resolve.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Reads `JQL_AUTO_SEED` (default: `false`).
+ */
+export declare function resolveJqlAutoSeed(): boolean;

package/jql/seed/src/lib/jql-auto-seed.resolve.js

@@ -0,0 +1,13 @@
+"use strict";
+//#region ---- Auto seed env resolution ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveJqlAutoSeed = resolveJqlAutoSeed;
+/**
+ * Reads `JQL_AUTO_SEED` (default: `false`).
+ */
+function resolveJqlAutoSeed() {
+    const raw = (process.env['JQL_AUTO_SEED'] ?? 'false').trim().toLowerCase();
+    return raw === 'true' || raw === '1' || raw === 'yes';
+}
+//#endregion
+//# sourceMappingURL=jql-auto-seed.resolve.js.map

package/jql/seed/src/lib/jql-auto-seed.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-auto-seed.resolve.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-auto-seed.resolve.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAK5C,gDAGC;AAND;;GAEG;AACH,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3E,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC;AACxD,CAAC;AAED,YAAY"}

package/jql/seed/src/lib/jql-auto-seed.service.d.ts

@@ -0,0 +1,8 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { JqlSeedRunnerService } from './jql-seed-runner.service';
+export declare class JqlAutoSeedService implements OnApplicationBootstrap {
+    private readonly runner;
+    private readonly logger;
+    constructor(runner: JqlSeedRunnerService);
+    onApplicationBootstrap(): Promise<void>;
+}

package/jql/seed/src/lib/jql-auto-seed.service.js

@@ -0,0 +1,29 @@
+"use strict";
+var JqlAutoSeedService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlAutoSeedService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const jql_auto_seed_resolve_1 = require("./jql-auto-seed.resolve");
+const jql_seed_runner_service_1 = require("./jql-seed-runner.service");
+//#region ---- JQL auto seed service ----
+let JqlAutoSeedService = JqlAutoSeedService_1 = class JqlAutoSeedService {
+    constructor(runner) {
+        this.runner = runner;
+        this.logger = new common_1.Logger(JqlAutoSeedService_1.name);
+    }
+    async onApplicationBootstrap() {
+        if (!(0, jql_auto_seed_resolve_1.resolveJqlAutoSeed)()) {
+            this.logger.log('JQL auto seed disabled (JQL_AUTO_SEED=false)');
+            return;
+        }
+        await this.runner.run();
+    }
+};
+exports.JqlAutoSeedService = JqlAutoSeedService;
+exports.JqlAutoSeedService = JqlAutoSeedService = JqlAutoSeedService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [jql_seed_runner_service_1.JqlSeedRunnerService])
+], JqlAutoSeedService);
+//#endregion
+//# sourceMappingURL=jql-auto-seed.service.js.map

package/jql/seed/src/lib/jql-auto-seed.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-auto-seed.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-auto-seed.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAA4E;AAC5E,mEAA6D;AAC7D,uEAAiE;AAEjE,yCAAyC;AAGlC,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAG7B,YAA6B,MAA4B;QAA5B,WAAM,GAAN,MAAM,CAAsB;QAFxC,WAAM,GAAG,IAAI,eAAM,CAAC,oBAAkB,CAAC,IAAI,CAAC,CAAC;IAEF,CAAC;IAE7D,KAAK,CAAC,sBAAsB;QAC1B,IAAI,CAAC,IAAA,0CAAkB,GAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AAbY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;6CAI0B,8CAAoB;GAH9C,kBAAkB,CAa9B;AAED,YAAY"}

package/jql/seed/src/lib/jql-engine-registry.service.d.ts

@@ -0,0 +1,7 @@
+import { JqlEngineBase } from '@acorex-platform/framework-server/jql/abstract';
+export declare class JqlEngineRegistryService {
+    private readonly engines;
+    register(instanceName: string, engine: JqlEngineBase): void;
+    get(instanceName: string): JqlEngineBase;
+    has(instanceName: string): boolean;
+}

package/jql/seed/src/lib/jql-engine-registry.service.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlEngineRegistryService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+//#region ---- JQL engine registry ----
+let JqlEngineRegistryService = class JqlEngineRegistryService {
+    constructor() {
+        this.engines = new Map();
+    }
+    register(instanceName, engine) {
+        this.engines.set(instanceName, engine);
+    }
+    get(instanceName) {
+        const engine = this.engines.get(instanceName);
+        if (!engine) {
+            throw new Error(`JQL engine is not registered for instance "${instanceName}". ` +
+                'Register it via JqlEngineRegistryService.register().');
+        }
+        return engine;
+    }
+    has(instanceName) {
+        return this.engines.has(instanceName);
+    }
+};
+exports.JqlEngineRegistryService = JqlEngineRegistryService;
+exports.JqlEngineRegistryService = JqlEngineRegistryService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], JqlEngineRegistryService);
+//#endregion
+//# sourceMappingURL=jql-engine-registry.service.js.map

package/jql/seed/src/lib/jql-engine-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-engine-registry.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-engine-registry.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAG5C,uCAAuC;AAGhC,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IAA9B;QACY,YAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAsB9D,CAAC;IApBC,QAAQ,CAAC,YAAoB,EAAE,MAAqB;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,YAAoB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,8CAA8C,YAAY,KAAK;gBAC7D,sDAAsD,CACzD,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,YAAoB;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;CACF,CAAA;AAvBY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;GACA,wBAAwB,CAuBpC;AAED,YAAY"}

package/jql/seed/src/lib/jql-multi-seed-runner.service.d.ts

@@ -0,0 +1,11 @@
+import type { JqlSeedProvider } from './jql-seed-provider.interface';
+import { JqlStoreSeedWriter } from './jql-store-seed.writer';
+import type { JqlSeedPhase } from './jql-seed-target.types';
+export declare class JqlMultiSeedRunnerService {
+    private readonly writer;
+    private readonly providers;
+    private readonly logger;
+    constructor(writer: JqlStoreSeedWriter, providers: JqlSeedProvider[] | null);
+    /** Runs all providers whose phase matches `definitions` or `data`. */
+    runPhase(phase: Exclude<JqlSeedPhase, 'schemas' | 'all'>): Promise<number>;
+}

package/jql/seed/src/lib/jql-multi-seed-runner.service.js

@@ -0,0 +1,56 @@
+"use strict";
+var JqlMultiSeedRunnerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlMultiSeedRunnerService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const jql_store_seed_writer_1 = require("./jql-store-seed.writer");
+const jql_seed_tokens_1 = require("./jql-seed.tokens");
+//#region ---- Multi-provider JQL seed runner ----
+let JqlMultiSeedRunnerService = JqlMultiSeedRunnerService_1 = class JqlMultiSeedRunnerService {
+    constructor(writer, providers) {
+        this.writer = writer;
+        this.providers = providers;
+        this.logger = new common_1.Logger(JqlMultiSeedRunnerService_1.name);
+    }
+    /** Runs all providers whose phase matches `definitions` or `data`. */
+    async runPhase(phase) {
+        const providers = (this.providers ?? []).filter((provider) => provider.phase === phase);
+        let failureCount = 0;
+        if (!providers.length) {
+            this.logger.warn(`No JQL seed providers registered for phase "${phase}"`);
+            return failureCount;
+        }
+        for (const provider of providers) {
+            try {
+                const targets = await provider.resolve();
+                this.logger.log(`Provider "${provider.name}" resolved ${targets.length} seed target(s) for phase "${phase}"`);
+                for (const target of targets) {
+                    try {
+                        const count = await this.writer.write(target);
+                        this.logger.log(`Seeded ${count} record(s) → instance="${target.jqlInstance}" ` +
+                            `${target.kind}="${target.target}" (${target.name})`);
+                    }
+                    catch (error) {
+                        failureCount += 1;
+                        this.logger.error(`Seed target "${target.name}" failed`, error);
+                    }
+                }
+            }
+            catch (error) {
+                failureCount += 1;
+                this.logger.error(`Seed provider "${provider.name}" failed`, error);
+            }
+        }
+        return failureCount;
+    }
+};
+exports.JqlMultiSeedRunnerService = JqlMultiSeedRunnerService;
+exports.JqlMultiSeedRunnerService = JqlMultiSeedRunnerService = JqlMultiSeedRunnerService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(1, (0, common_1.Optional)()),
+    tslib_1.__param(1, (0, common_1.Inject)(jql_seed_tokens_1.JQL_SEED_PROVIDERS)),
+    tslib_1.__metadata("design:paramtypes", [jql_store_seed_writer_1.JqlStoreSeedWriter, Object])
+], JqlMultiSeedRunnerService);
+//#endregion
+//# sourceMappingURL=jql-multi-seed-runner.service.js.map

package/jql/seed/src/lib/jql-multi-seed-runner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-multi-seed-runner.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-multi-seed-runner.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAAsE;AAEtE,mEAA6D;AAE7D,uDAAuD;AAEvD,kDAAkD;AAG3C,IAAM,yBAAyB,iCAA/B,MAAM,yBAAyB;IAGpC,YACmB,MAA0B,EACH,SAAoD;QAD3E,WAAM,GAAN,MAAM,CAAoB;QACc,cAAS,GAAT,SAAS,CAA0B;QAJ7E,WAAM,GAAG,IAAI,eAAM,CAAC,2BAAyB,CAAC,IAAI,CAAC,CAAC;IAKlE,CAAC;IAEJ,sEAAsE;IACtE,KAAK,CAAC,QAAQ,CAAC,KAA+C;QAC5D,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACxF,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,KAAK,GAAG,CAAC,CAAC;YAC1E,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,aAAa,QAAQ,CAAC,IAAI,cAAc,OAAO,CAAC,MAAM,8BAA8B,KAAK,GAAG,CAC7F,CAAC;gBAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;wBAC9C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,UAAU,KAAK,0BAA0B,MAAM,CAAC,WAAW,IAAI;4BAC7D,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,IAAI,GAAG,CACvD,CAAC;oBACJ,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,YAAY,IAAI,CAAC,CAAC;wBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,IAAI,CAAC,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;CACF,CAAA;AA7CY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;IAMR,mBAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,mBAAA,IAAA,eAAM,EAAC,oCAAkB,CAAC,CAAA;6CADd,0CAAkB;GAJlC,yBAAyB,CA6CrC;AAED,YAAY"}

package/jql/seed/src/lib/jql-seed-phase.resolve.d.ts

@@ -0,0 +1,10 @@
+import type { JqlSeedPhase } from './jql-seed-target.types';
+/**
+ * Reads `JQL_SEED_PHASE` or CLI `--phase=` (definitions | schemas | data | all).
+ * Default: `all`.
+ */
+export declare function resolveJqlSeedPhase(explicit?: string): JqlSeedPhase;
+/** Expands `all` into the ordered pipeline steps. */
+export declare function expandJqlSeedPhases(phase: JqlSeedPhase): readonly JqlSeedPhase[];
+/** Parses `--phase=definitions` style args from `process.argv`. */
+export declare function parseSeedPhaseFromArgv(argv?: string[]): string | undefined;

package/jql/seed/src/lib/jql-seed-phase.resolve.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveJqlSeedPhase = resolveJqlSeedPhase;
+exports.expandJqlSeedPhases = expandJqlSeedPhases;
+exports.parseSeedPhaseFromArgv = parseSeedPhaseFromArgv;
+//#region ---- Seed phase resolution ----
+const VALID_PHASES = ['definitions', 'schemas', 'data', 'all'];
+/**
+ * Reads `JQL_SEED_PHASE` or CLI `--phase=` (definitions | schemas | data | all).
+ * Default: `all`.
+ */
+function resolveJqlSeedPhase(explicit) {
+    const raw = (explicit ?? process.env['JQL_SEED_PHASE'] ?? 'all').trim().toLowerCase();
+    if (VALID_PHASES.includes(raw)) {
+        return raw;
+    }
+    throw new Error(`Unsupported JQL seed phase "${raw}". Supported: ${VALID_PHASES.join(', ')}.`);
+}
+/** Expands `all` into the ordered pipeline steps. */
+function expandJqlSeedPhases(phase) {
+    if (phase === 'all') {
+        return ['definitions', 'schemas', 'data'];
+    }
+    return [phase];
+}
+/** Parses `--phase=definitions` style args from `process.argv`. */
+function parseSeedPhaseFromArgv(argv = process.argv) {
+    for (const arg of argv) {
+        if (arg.startsWith('--phase=')) {
+            return arg.slice('--phase='.length);
+        }
+    }
+    return undefined;
+}
+//#endregion
+//# sourceMappingURL=jql-seed-phase.resolve.js.map

package/jql/seed/src/lib/jql-seed-phase.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-phase.resolve.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-phase.resolve.ts"],"names":[],"mappings":";;AAUA,kDAUC;AAGD,kDAMC;AAGD,wDAQC;AAtCD,yCAAyC;AAEzC,MAAM,YAAY,GAA4B,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAExF;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,QAAiB;IACnD,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEtF,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAmB,CAAC,EAAE,CAAC;QAC/C,OAAO,GAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,KAAK,CACb,+BAA+B,GAAG,iBAAiB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9E,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,SAAgB,mBAAmB,CAAC,KAAmB;IACrD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,mEAAmE;AACnE,SAAgB,sBAAsB,CAAC,OAAiB,OAAO,CAAC,IAAI;IAClE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,YAAY"}

package/jql/seed/src/lib/jql-seed-provider.interface.d.ts

@@ -0,0 +1,10 @@
+import type { JqlSeedPhase, JqlSeedTarget } from './jql-seed-target.types';
+/**
+ * Supplies seed targets for one concern (domain definitions, entity data, …).
+ * Runners group providers by {@link JqlSeedProvider.phase}.
+ */
+export interface JqlSeedProvider {
+    readonly name: string;
+    readonly phase: Exclude<JqlSeedPhase, 'schemas' | 'all'>;
+    resolve(): Promise<readonly JqlSeedTarget[]>;
+}

package/jql/seed/src/lib/jql-seed-provider.interface.js

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

package/jql/seed/src/lib/jql-seed-provider.interface.js.map

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

package/jql/seed/src/lib/jql-seed-runner.service.d.ts

@@ -0,0 +1,19 @@
+import { DomainEntitySchemaLoader } from '@acorex-platform/framework-server/domain/providers';
+import type { JqlSeedPhase } from './jql-seed-target.types';
+import { JqlMultiSeedRunnerService } from './jql-multi-seed-runner.service';
+export interface JqlSeedRunOptions {
+    phase?: JqlSeedPhase | string;
+}
+export declare class JqlSeedRunnerService {
+    private readonly multiSeedRunner;
+    private readonly schemaLoader;
+    private readonly logger;
+    constructor(multiSeedRunner: JqlMultiSeedRunnerService, schemaLoader: DomainEntitySchemaLoader);
+    /**
+     * Ordered pipeline:
+     * 1. `definitions` — JQL seed providers (domain entity definitions, …)
+     * 2. `schemas` — register entity schemas from domain store
+     * 3. `data` — entity row seed providers
+     */
+    run(options?: JqlSeedRunOptions): Promise<void>;
+}

package/jql/seed/src/lib/jql-seed-runner.service.js

@@ -0,0 +1,50 @@
+"use strict";
+var JqlSeedRunnerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSeedRunnerService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const providers_1 = require("@acorex-platform/framework-server/domain/providers");
+const jql_seed_phase_resolve_1 = require("./jql-seed-phase.resolve");
+const jql_multi_seed_runner_service_1 = require("./jql-multi-seed-runner.service");
+let JqlSeedRunnerService = JqlSeedRunnerService_1 = class JqlSeedRunnerService {
+    constructor(multiSeedRunner, schemaLoader) {
+        this.multiSeedRunner = multiSeedRunner;
+        this.schemaLoader = schemaLoader;
+        this.logger = new common_1.Logger(JqlSeedRunnerService_1.name);
+    }
+    /**
+     * Ordered pipeline:
+     * 1. `definitions` — JQL seed providers (domain entity definitions, …)
+     * 2. `schemas` — register entity schemas from domain store
+     * 3. `data` — entity row seed providers
+     */
+    async run(options = {}) {
+        const phases = (0, jql_seed_phase_resolve_1.expandJqlSeedPhases)((0, jql_seed_phase_resolve_1.resolveJqlSeedPhase)(options.phase));
+        let failureCount = 0;
+        if (phases.includes('definitions')) {
+            this.logger.log('Phase: definitions');
+            failureCount += await this.multiSeedRunner.runPhase('definitions');
+        }
+        if (phases.includes('schemas')) {
+            this.logger.log('Phase: schemas');
+            await this.schemaLoader.buildAndRegisterAll();
+        }
+        if (phases.includes('data')) {
+            this.logger.log('Phase: data');
+            failureCount += await this.multiSeedRunner.runPhase('data');
+        }
+        if (failureCount > 0) {
+            throw new Error(`JQL seed finished with ${failureCount} failure(s)`);
+        }
+        this.logger.log('JQL seed finished');
+    }
+};
+exports.JqlSeedRunnerService = JqlSeedRunnerService;
+exports.JqlSeedRunnerService = JqlSeedRunnerService = JqlSeedRunnerService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [jql_multi_seed_runner_service_1.JqlMultiSeedRunnerService,
+        providers_1.DomainEntitySchemaLoader])
+], JqlSeedRunnerService);
+//#endregion
+//# sourceMappingURL=jql-seed-runner.service.js.map

package/jql/seed/src/lib/jql-seed-runner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-runner.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-runner.service.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,kFAA8F;AAC9F,qEAGkC;AAElC,mFAA4E;AASrE,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAG/B,YACmB,eAA0C,EAC1C,YAAsC;QADtC,oBAAe,GAAf,eAAe,CAA2B;QAC1C,iBAAY,GAAZ,YAAY,CAA0B;QAJxC,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;IAK7D,CAAC;IAEJ;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,UAA6B,EAAE;QACvC,MAAM,MAAM,GAAG,IAAA,4CAAmB,EAAC,IAAA,4CAAmB,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YACtC,YAAY,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAClC,MAAM,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC/B,YAAY,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,aAAa,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AAvCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;6CAKyB,yDAAyB;QAC5B,oCAAwB;GAL9C,oBAAoB,CAuChC;AAED,YAAY"}

package/jql/seed/src/lib/jql-seed-target.types.d.ts

@@ -0,0 +1,28 @@
+import type { AXPEntitySeedStorage } from '@acorex-platform-module/common/seed';
+/** Seed pipeline phase. */
+export type JqlSeedPhase = 'definitions' | 'schemas' | 'data' | 'all';
+/** How records are written to the target. */
+export type JqlSeedMergeType = 'replace' | 'merge';
+/**
+ * Target kind:
+ * - `store` — JQL source/store on a JQL instance (e.g. domain `entities` store)
+ * - `entity` — entity-storage row collection (full entity name as target)
+ */
+export type JqlSeedTargetKind = 'store' | 'entity';
+/**
+ * Describes one seed write: which JQL instance, which store/entity, and which rows.
+ */
+export interface JqlSeedTarget {
+    readonly name: string;
+    readonly phase: Exclude<JqlSeedPhase, 'schemas' | 'all'>;
+    readonly kind: JqlSeedTargetKind;
+    /** JQL instance name (`entity-storage`, `entity-definition`, …). */
+    readonly jqlInstance: string;
+    /** Store name when `kind=store`; full entity name when `kind=entity`. */
+    readonly target: string;
+    readonly records: readonly Record<string, unknown>[];
+    readonly mergeType?: JqlSeedMergeType;
+    readonly uniqueKeys?: readonly string[];
+    /** When set, {@link JqlStoreSeedWriter} runs this instead of blind `initial` on {@link records}. */
+    readonly seed?: (storage: AXPEntitySeedStorage) => Promise<void>;
+}

package/jql/seed/src/lib/jql-seed-target.types.js

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

package/jql/seed/src/lib/jql-seed-target.types.js.map

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

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

@@ -0,0 +1,14 @@
+import { DynamicModule, Type, type ForwardReference } from '@nestjs/common';
+import type { AXPModuleSeedCatalog } from '@acorex-platform-module/common/seed';
+import type { JqlSeedProvider } from './jql-seed-provider.interface';
+export interface JqlSeedModuleOptions {
+    catalogs?: readonly AXPModuleSeedCatalog[];
+    providers?: readonly JqlSeedProvider[];
+    /** Nest injectable classes implementing {@link JqlSeedProvider} (must be exported from {@link imports}). */
+    injectableProviders?: ReadonlyArray<Type<JqlSeedProvider>>;
+    /** Modules that export {@link injectableProviders}. */
+    imports?: ReadonlyArray<Type | DynamicModule | ForwardReference>;
+}
+export declare class JqlSeedModule {
+    static forRoot(options?: JqlSeedModuleOptions): DynamicModule;
+}

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

@@ -0,0 +1,68 @@
+"use strict";
+var JqlSeedModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSeedModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const providers_1 = require("@acorex-platform/framework-server/domain/providers");
+const jql_auto_seed_service_1 = require("./jql-auto-seed.service");
+const entity_data_seed_provider_1 = require("./entity-data-seed.provider");
+const jql_engine_registry_service_1 = require("./jql-engine-registry.service");
+const jql_multi_seed_runner_service_1 = require("./jql-multi-seed-runner.service");
+const jql_seed_runner_service_1 = require("./jql-seed-runner.service");
+const jql_store_seed_writer_1 = require("./jql-store-seed.writer");
+const jql_seed_tokens_1 = require("./jql-seed.tokens");
+//#endregion
+//#region ---- JQL seed module ----
+let JqlSeedModule = JqlSeedModule_1 = class JqlSeedModule {
+    static forRoot(options = {}) {
+        const domainInstance = (0, providers_1.resolveDomainDefinitionJqlInstance)();
+        const domainEngineToken = (0, abstract_1.JQL_ENGINE)(domainInstance);
+        return {
+            module: JqlSeedModule_1,
+            imports: [...(options.imports ?? [])],
+            providers: [
+                {
+                    provide: jql_seed_tokens_1.JQL_SEED_CATALOGS,
+                    useValue: options.catalogs ?? [],
+                },
+                {
+                    provide: jql_seed_tokens_1.JQL_SEED_EXTRA_PROVIDERS,
+                    useValue: options.providers ?? [],
+                },
+                {
+                    provide: jql_engine_registry_service_1.JqlEngineRegistryService,
+                    useFactory: (entityStorageEngine, domainEngine, entityStorageInstance) => {
+                        const registry = new jql_engine_registry_service_1.JqlEngineRegistryService();
+                        registry.register(entityStorageInstance, entityStorageEngine);
+                        registry.register(domainInstance, domainEngine);
+                        return registry;
+                    },
+                    inject: [abstract_1.ENTITY_STORAGE_JQL_ENGINE, domainEngineToken, abstract_1.ENTITY_STORAGE_JQL_INSTANCE],
+                },
+                jql_store_seed_writer_1.JqlStoreSeedWriter,
+                jql_multi_seed_runner_service_1.JqlMultiSeedRunnerService,
+                entity_data_seed_provider_1.EntityDataSeedProvider,
+                {
+                    provide: jql_seed_tokens_1.JQL_SEED_PROVIDERS,
+                    useFactory: (entityDataProvider, extraProviders, ...injectableProviders) => [entityDataProvider, ...extraProviders, ...injectableProviders],
+                    inject: [
+                        entity_data_seed_provider_1.EntityDataSeedProvider,
+                        jql_seed_tokens_1.JQL_SEED_EXTRA_PROVIDERS,
+                        ...(options.injectableProviders ?? []),
+                    ],
+                },
+                jql_seed_runner_service_1.JqlSeedRunnerService,
+                jql_auto_seed_service_1.JqlAutoSeedService,
+            ],
+            exports: [jql_seed_runner_service_1.JqlSeedRunnerService],
+        };
+    }
+};
+exports.JqlSeedModule = JqlSeedModule;
+exports.JqlSeedModule = JqlSeedModule = JqlSeedModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], JqlSeedModule);
+//#endregion
+//# sourceMappingURL=jql-seed.module.js.map