@acorex-platform/framework-server 0.0.10 → 0.0.14

package/jql/seed/src/lib/jql-seed-diff.util.js

@@ -0,0 +1,182 @@
+"use strict";
+//#region ---- JQL seed row diff (pure) ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JQL_SEED_DIFF_IGNORED_FIELDS = void 0;
+exports.buildJqlSeedRecordKey = buildJqlSeedRecordKey;
+exports.normalizeJqlSeedRecordForCompare = normalizeJqlSeedRecordForCompare;
+exports.listChangedFields = listChangedFields;
+exports.recordsEqualForSeedDiff = recordsEqualForSeedDiff;
+exports.classifyJqlSeedDiff = classifyJqlSeedDiff;
+exports.summarizeJqlSeedDiffOps = summarizeJqlSeedDiffOps;
+exports.defaultActionForDiffKind = defaultActionForDiffKind;
+/** Volatile fields ignored when comparing seed vs local payloads. */
+exports.JQL_SEED_DIFF_IGNORED_FIELDS = new Set([
+    'auditInfo',
+    'stateInfo',
+    'ownershipInfo',
+    'createdAt',
+    'updatedAt',
+    'createdBy',
+    'updatedBy',
+    '__v',
+    '_id',
+]);
+/**
+ * Stable string key for a record using uniqueKeys (default `id`).
+ * Returns null when any key part is missing.
+ */
+function buildJqlSeedRecordKey(record, uniqueKeys = ['id']) {
+    const parts = [];
+    for (const key of uniqueKeys) {
+        const value = record[key];
+        if (value === undefined || value === null || value === '') {
+            return null;
+        }
+        parts.push(String(value));
+    }
+    return parts.join('\u0001');
+}
+/** Deep-ish normalize for stable JSON compare (sort object keys, drop ignored fields). */
+function normalizeJqlSeedRecordForCompare(record, ignoredFields = exports.JQL_SEED_DIFF_IGNORED_FIELDS) {
+    return normalizeValue(record, ignoredFields);
+}
+function normalizeValue(value, ignoredFields) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeValue(item, ignoredFields));
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const keys = Object.keys(obj)
+            .filter((key) => !ignoredFields.has(key))
+            .sort((a, b) => a.localeCompare(b));
+        const out = {};
+        for (const key of keys) {
+            out[key] = normalizeValue(obj[key], ignoredFields);
+        }
+        return out;
+    }
+    return value;
+}
+function listChangedFields(seed, local, ignoredFields = exports.JQL_SEED_DIFF_IGNORED_FIELDS) {
+    const keys = new Set([
+        ...Object.keys(seed).filter((k) => !ignoredFields.has(k)),
+        ...Object.keys(local).filter((k) => !ignoredFields.has(k)),
+    ]);
+    const changed = [];
+    for (const key of [...keys].sort((a, b) => a.localeCompare(b))) {
+        const a = JSON.stringify(normalizeValue(seed[key], ignoredFields));
+        const b = JSON.stringify(normalizeValue(local[key], ignoredFields));
+        if (a !== b) {
+            changed.push(key);
+        }
+    }
+    return changed;
+}
+function recordsEqualForSeedDiff(seed, local) {
+    return (JSON.stringify(normalizeJqlSeedRecordForCompare(seed)) ===
+        JSON.stringify(normalizeJqlSeedRecordForCompare(local)));
+}
+/**
+ * Classify desired seed rows vs current DB rows.
+ * - add: in seed, not in DB
+ * - change: same key, payload differs
+ * - seed-removed: in DB, not in seed (only when removeMissingSeedKeys)
+ * - extra: in DB, not in seed (when removeMissingSeedKeys is false — informational)
+ */
+function classifyJqlSeedDiff(options) {
+    const uniqueKeys = options.uniqueKeys?.length ? options.uniqueKeys : ['id'];
+    const removeMissing = options.removeMissingSeedKeys === true;
+    const desiredByKey = new Map();
+    for (const row of options.desired) {
+        const key = buildJqlSeedRecordKey(row, uniqueKeys);
+        if (key) {
+            desiredByKey.set(key, row);
+        }
+    }
+    const currentByKey = new Map();
+    for (const row of options.current) {
+        const key = buildJqlSeedRecordKey(row, uniqueKeys);
+        if (key) {
+            currentByKey.set(key, row);
+        }
+    }
+    const ops = [];
+    for (const [recordKey, seed] of desiredByKey) {
+        const local = currentByKey.get(recordKey);
+        if (!local) {
+            ops.push({ recordKey, kind: 'add', seed });
+            continue;
+        }
+        if (recordsEqualForSeedDiff(seed, local)) {
+            continue;
+        }
+        ops.push({
+            recordKey,
+            kind: 'change',
+            seed,
+            local,
+            changedFields: listChangedFields(seed, local),
+        });
+    }
+    for (const [recordKey, local] of currentByKey) {
+        if (desiredByKey.has(recordKey)) {
+            continue;
+        }
+        ops.push({
+            recordKey,
+            kind: removeMissing ? 'seed-removed' : 'extra',
+            local,
+        });
+    }
+    return ops.sort((a, b) => a.recordKey.localeCompare(b.recordKey));
+}
+function summarizeJqlSeedDiffOps(ops) {
+    let add = 0;
+    let change = 0;
+    let seedRemoved = 0;
+    let extra = 0;
+    for (const op of ops) {
+        switch (op.kind) {
+            case 'add':
+                add += 1;
+                break;
+            case 'change':
+                change += 1;
+                break;
+            case 'seed-removed':
+                seedRemoved += 1;
+                break;
+            case 'extra':
+                extra += 1;
+                break;
+        }
+    }
+    return {
+        add,
+        change,
+        seedRemoved,
+        extra,
+        conflicts: change + seedRemoved,
+    };
+}
+/** Default action when user has not overridden a row. */
+function defaultActionForDiffKind(kind) {
+    switch (kind) {
+        case 'add':
+            return 'take-seed';
+        case 'change':
+            return 'take-seed';
+        case 'seed-removed':
+            return 'keep-local';
+        case 'extra':
+            return null;
+    }
+}
+//#endregion
+//# sourceMappingURL=jql-seed-diff.util.js.map

package/jql/seed/src/lib/jql-seed-diff.util.js.map

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

package/jql/seed/src/lib/jql-seed-list-catalog.command.d.ts

@@ -0,0 +1,10 @@
+import { ModuleRef } from '@nestjs/core';
+import type { AXPExecuteCommandResult } from '@acorex-platform/framework-shared/core';
+import type { AXPCommand } from '@acorex-platform/framework-shared/runtime';
+import { type JqlSeedCatalogDto } from './jql-seed-api.types';
+export declare class JqlSeedListCatalogCommand implements AXPCommand<Record<string, unknown>, JqlSeedCatalogDto> {
+    private readonly moduleRef;
+    constructor(moduleRef: ModuleRef);
+    execute(): Promise<AXPExecuteCommandResult<JqlSeedCatalogDto>>;
+}
+//# sourceMappingURL=jql-seed-list-catalog.command.d.ts.map

package/jql/seed/src/lib/jql-seed-list-catalog.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-list-catalog.command.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-list-catalog.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAE5E,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAK9B,qBAEa,yBACX,YAAW,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAErD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAE3C,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;CAOrE"}

package/jql/seed/src/lib/jql-seed-list-catalog.command.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlSeedListCatalogCommand = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const abstract_1 = require("@acorex-platform/framework-server/domain/abstract");
+const jql_seed_api_types_1 = require("./jql-seed-api.types");
+const jql_seed_runner_service_1 = require("./jql-seed-runner.service");
+//#region ---- List seed catalog server command ----
+let JqlSeedListCatalogCommand = class JqlSeedListCatalogCommand {
+    constructor(moduleRef) {
+        this.moduleRef = moduleRef;
+    }
+    async execute() {
+        const runner = await this.moduleRef.resolve(jql_seed_runner_service_1.JqlSeedRunnerService, undefined, {
+            strict: false,
+        });
+        const data = await runner.listCatalog();
+        return { success: true, data };
+    }
+};
+exports.JqlSeedListCatalogCommand = JqlSeedListCatalogCommand;
+exports.JqlSeedListCatalogCommand = JqlSeedListCatalogCommand = tslib_1.__decorate([
+    (0, abstract_1.ServerHandler)({ key: jql_seed_api_types_1.AXPJqlSeedServerCommands.ListCatalog }),
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.ModuleRef])
+], JqlSeedListCatalogCommand);
+//#endregion
+//# sourceMappingURL=jql-seed-list-catalog.command.js.map

package/jql/seed/src/lib/jql-seed-list-catalog.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-list-catalog.command.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-list-catalog.command.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,uCAAyC;AAGzC,gFAAkF;AAClF,6DAG8B;AAC9B,uEAAiE;AAEjE,oDAAoD;AAI7C,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IAGpC,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,8CAAoB,EAAE,SAAS,EAAE;YAC3E,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;CACF,CAAA;AAZY,8DAAyB;oCAAzB,yBAAyB;IAFrC,IAAA,wBAAa,EAAC,EAAE,GAAG,EAAE,6CAAwB,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAA,mBAAU,GAAE;6CAI6B,gBAAS;GAHtC,yBAAyB,CAYrC;AAED,YAAY"}

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

@@ -0,0 +1,12 @@
+import type { NormalizedJqlSeedSelection } from './jql-seed-selection.types';
+import type { JqlSeedPhase } from './jql-seed-target.types';
+import type { JqlSeedRunOptions, ResolvedJqlSeedRunOptions } from './jql-seed-selection.types';
+/** Parses CLI args and environment variables into one normalized run options object. */
+export declare function resolveJqlSeedOptionsFromEnvAndArgv(argv?: readonly string[]): ResolvedJqlSeedRunOptions;
+/** Merges explicit run options with CLI/env (explicit options win). */
+export declare function resolveJqlSeedRunOptions(options?: JqlSeedRunOptions, argv?: readonly string[]): ResolvedJqlSeedRunOptions;
+export declare function hasDataSeedSelector(selection: NormalizedJqlSeedSelection): boolean;
+export declare function isSelectiveSelection(selection: NormalizedJqlSeedSelection): boolean;
+/** Rejects data-only selectors when the resolved phase has no data step. */
+export declare function validatePhaseSelectors(phases: readonly JqlSeedPhase[], selection: NormalizedJqlSeedSelection): void;
+//# sourceMappingURL=jql-seed-options.resolve.d.ts.map

package/jql/seed/src/lib/jql-seed-options.resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-options.resolve.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-options.resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AA6IpC,wFAAwF;AACxF,wBAAgB,mCAAmC,CACjD,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,yBAAyB,CA+C3B;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,iBAAsB,EAC/B,IAAI,GAAE,SAAS,MAAM,EAAiB,GACrC,yBAAyB,CAwD3B;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,0BAA0B,GACpC,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,0BAA0B,GACpC,OAAO,CAET;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,SAAS,EAAE,0BAA0B,GACpC,IAAI,CAmBN"}

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

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveJqlSeedOptionsFromEnvAndArgv = resolveJqlSeedOptionsFromEnvAndArgv;
+exports.resolveJqlSeedRunOptions = resolveJqlSeedRunOptions;
+exports.hasDataSeedSelector = hasDataSeedSelector;
+exports.isSelectiveSelection = isSelectiveSelection;
+exports.validatePhaseSelectors = validatePhaseSelectors;
+const jql_seed_phase_resolve_1 = require("./jql-seed-phase.resolve");
+//#region ---- JQL seed options resolution ----
+const LIST_KEYS = {
+    modules: 'JQL_SEED_MODULES',
+    seeds: 'JQL_SEED_SEEDS',
+    entities: 'JQL_SEED_ENTITIES',
+    providers: 'JQL_SEED_PROVIDERS',
+    tags: 'JQL_SEED_TAGS',
+    excludeModules: 'JQL_SEED_EXCLUDE_MODULES',
+    excludeSeeds: 'JQL_SEED_EXCLUDE_SEEDS',
+    excludeEntities: 'JQL_SEED_EXCLUDE_ENTITIES',
+    excludeProviders: 'JQL_SEED_EXCLUDE_PROVIDERS',
+    excludeTags: 'JQL_SEED_EXCLUDE_TAGS',
+};
+const BOOLEAN_KEYS = {
+    dryRun: 'JQL_SEED_DRY_RUN',
+    list: 'JQL_SEED_LIST',
+    listFlat: 'JQL_SEED_LIST_FLAT',
+};
+const CLI_LIST_KEYS = {
+    modules: '--modules',
+    seeds: '--seeds',
+    entities: '--entities',
+    providers: '--providers',
+    tags: '--tags',
+    excludeModules: '--exclude-modules',
+    excludeSeeds: '--exclude-seeds',
+    excludeEntities: '--exclude-entities',
+    excludeProviders: '--exclude-providers',
+    excludeTags: '--exclude-tags',
+};
+const DATA_ONLY_SELECTOR_KEYS = [
+    'modules',
+    'seeds',
+    'entities',
+    'providers',
+    'tags',
+    'excludeModules',
+    'excludeSeeds',
+    'excludeEntities',
+    'excludeProviders',
+    'excludeTags',
+];
+const EMPTY_SELECTION = {
+    modules: [],
+    seeds: [],
+    entities: [],
+    providers: [],
+    tags: [],
+    excludeModules: [],
+    excludeSeeds: [],
+    excludeEntities: [],
+    excludeProviders: [],
+    excludeTags: [],
+    dryRun: false,
+    list: false,
+    listFlat: false,
+    removeMissingSeedKeys: false,
+};
+function splitListValue(raw) {
+    if (!raw?.trim()) {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+}
+function readCliValue(argv, prefix) {
+    for (const arg of argv) {
+        if (arg.startsWith(prefix + '=')) {
+            return arg.slice(prefix.length + 1);
+        }
+    }
+    return undefined;
+}
+function readBoolean(argv, flag, envKey) {
+    if (argv.includes(flag)) {
+        return true;
+    }
+    const env = process.env[envKey]?.trim().toLowerCase();
+    return env === '1' || env === 'true' || env === 'yes';
+}
+function readList(argv, cliPrefix, envKey) {
+    const cli = readCliValue(argv, cliPrefix);
+    if (cli !== undefined) {
+        return splitListValue(cli);
+    }
+    return splitListValue(process.env[envKey]);
+}
+function normalizeSelectionInput(input) {
+    if (!input) {
+        return { ...EMPTY_SELECTION };
+    }
+    return {
+        modules: [...(input.modules ?? [])],
+        seeds: [...(input.seeds ?? [])],
+        entities: [...(input.entities ?? [])],
+        providers: [...(input.providers ?? [])],
+        tags: [...(input.tags ?? [])],
+        excludeModules: [...(input.excludeModules ?? [])],
+        excludeSeeds: [...(input.excludeSeeds ?? [])],
+        excludeEntities: [...(input.excludeEntities ?? [])],
+        excludeProviders: [...(input.excludeProviders ?? [])],
+        excludeTags: [...(input.excludeTags ?? [])],
+        dryRun: input.dryRun ?? false,
+        list: input.list ?? false,
+        listFlat: input.listFlat ?? false,
+        removeMissingSeedKeys: input.removeMissingSeedKeys ?? false,
+    };
+}
+/** Parses CLI args and environment variables into one normalized run options object. */
+function resolveJqlSeedOptionsFromEnvAndArgv(argv = process.argv) {
+    const phase = (0, jql_seed_phase_resolve_1.resolveJqlSeedPhase)(readCliValue(argv, '--phase') ?? process.env['JQL_SEED_PHASE']);
+    const selection = {
+        modules: readList(argv, CLI_LIST_KEYS.modules, LIST_KEYS.modules),
+        seeds: readList(argv, CLI_LIST_KEYS.seeds, LIST_KEYS.seeds),
+        entities: readList(argv, CLI_LIST_KEYS.entities, LIST_KEYS.entities),
+        providers: readList(argv, CLI_LIST_KEYS.providers, LIST_KEYS.providers),
+        tags: readList(argv, CLI_LIST_KEYS.tags, LIST_KEYS.tags),
+        excludeModules: readList(argv, CLI_LIST_KEYS.excludeModules, LIST_KEYS.excludeModules),
+        excludeSeeds: readList(argv, CLI_LIST_KEYS.excludeSeeds, LIST_KEYS.excludeSeeds),
+        excludeEntities: readList(argv, CLI_LIST_KEYS.excludeEntities, LIST_KEYS.excludeEntities),
+        excludeProviders: readList(argv, CLI_LIST_KEYS.excludeProviders, LIST_KEYS.excludeProviders),
+        excludeTags: readList(argv, CLI_LIST_KEYS.excludeTags, LIST_KEYS.excludeTags),
+        dryRun: readBoolean(argv, '--dry-run', BOOLEAN_KEYS.dryRun),
+        list: readBoolean(argv, '--list', BOOLEAN_KEYS.list),
+        listFlat: readBoolean(argv, '--list-flat', BOOLEAN_KEYS.listFlat),
+        removeMissingSeedKeys: readBoolean(argv, '--remove-missing-seed-keys', 'JQL_SEED_REMOVE_MISSING_SEED_KEYS'),
+    };
+    return { phase, selection };
+}
+/** Merges explicit run options with CLI/env (explicit options win). */
+function resolveJqlSeedRunOptions(options = {}, argv = process.argv) {
+    const fromEnv = resolveJqlSeedOptionsFromEnvAndArgv(argv);
+    const explicitSelection = normalizeSelectionInput(options.selection);
+    const hasExplicitSelection = options.selection !== undefined &&
+        Object.values(explicitSelection).some((value) => typeof value === 'boolean' ? value : value.length > 0);
+    return {
+        phase: options.phase !== undefined
+            ? (0, jql_seed_phase_resolve_1.resolveJqlSeedPhase)(options.phase)
+            : fromEnv.phase,
+        selection: hasExplicitSelection
+            ? {
+                modules: explicitSelection.modules.length
+                    ? explicitSelection.modules
+                    : fromEnv.selection.modules,
+                seeds: explicitSelection.seeds.length
+                    ? explicitSelection.seeds
+                    : fromEnv.selection.seeds,
+                entities: explicitSelection.entities.length
+                    ? explicitSelection.entities
+                    : fromEnv.selection.entities,
+                providers: explicitSelection.providers.length
+                    ? explicitSelection.providers
+                    : fromEnv.selection.providers,
+                tags: explicitSelection.tags.length
+                    ? explicitSelection.tags
+                    : fromEnv.selection.tags,
+                excludeModules: explicitSelection.excludeModules.length
+                    ? explicitSelection.excludeModules
+                    : fromEnv.selection.excludeModules,
+                excludeSeeds: explicitSelection.excludeSeeds.length
+                    ? explicitSelection.excludeSeeds
+                    : fromEnv.selection.excludeSeeds,
+                excludeEntities: explicitSelection.excludeEntities.length
+                    ? explicitSelection.excludeEntities
+                    : fromEnv.selection.excludeEntities,
+                excludeProviders: explicitSelection.excludeProviders.length
+                    ? explicitSelection.excludeProviders
+                    : fromEnv.selection.excludeProviders,
+                excludeTags: explicitSelection.excludeTags.length
+                    ? explicitSelection.excludeTags
+                    : fromEnv.selection.excludeTags,
+                dryRun: explicitSelection.dryRun || fromEnv.selection.dryRun,
+                list: explicitSelection.list || fromEnv.selection.list,
+                listFlat: explicitSelection.listFlat || fromEnv.selection.listFlat,
+                removeMissingSeedKeys: explicitSelection.removeMissingSeedKeys ||
+                    fromEnv.selection.removeMissingSeedKeys,
+            }
+            : fromEnv.selection,
+    };
+}
+function hasDataSeedSelector(selection) {
+    return DATA_ONLY_SELECTOR_KEYS.some((key) => selection[key].length > 0);
+}
+function isSelectiveSelection(selection) {
+    return DATA_ONLY_SELECTOR_KEYS.some((key) => selection[key].length > 0);
+}
+/** Rejects data-only selectors when the resolved phase has no data step. */
+function validatePhaseSelectors(phases, selection) {
+    if (phases.includes('data')) {
+        return;
+    }
+    if (!hasDataSeedSelector(selection)) {
+        return;
+    }
+    const examples = [
+        'pnpm seed:local -- --phase=data --modules=platform-management',
+        'pnpm seed:local -- --phase=all --modules=platform-management',
+    ];
+    throw new Error(`Data seed selectors (--modules, --seeds, --entities, --providers, --tags, and exclude variants) ` +
+        `cannot be used with phase "${phases.join(', ')}" because the data phase is not included. ` +
+        `Example: ${examples.join(' or ')}`);
+}
+//#endregion
+//# sourceMappingURL=jql-seed-options.resolve.js.map

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

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

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

@@ -8,3 +8,4 @@ export declare function resolveJqlSeedPhase(explicit?: string): JqlSeedPhase;
 export declare function expandJqlSeedPhases(phase: JqlSeedPhase): readonly JqlSeedPhase[];
 /** Parses `--phase=definitions` style args from `process.argv`. */
 export declare function parseSeedPhaseFromArgv(argv?: string[]): string | undefined;
+//# sourceMappingURL=jql-seed-phase.resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-phase.resolve.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-phase.resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAW5D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAYnE;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,GAClB,SAAS,YAAY,EAAE,CAMzB;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,MAAM,EAAiB,GAC5B,MAAM,GAAG,SAAS,CAQpB"}

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

@@ -4,13 +4,20 @@ exports.resolveJqlSeedPhase = resolveJqlSeedPhase;
 exports.expandJqlSeedPhases = expandJqlSeedPhases;
 exports.parseSeedPhaseFromArgv = parseSeedPhaseFromArgv;
 //#region ---- Seed phase resolution ----
-const VALID_PHASES = ['definitions', 'schemas', 'data', 'all'];
+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();
+    const raw = (explicit ?? process.env['JQL_SEED_PHASE'] ?? 'all')
+        .trim()
+        .toLowerCase();
     if (VALID_PHASES.includes(raw)) {
         return raw;
     }

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

@@ -1 +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"}
+{"version":3,"file":"jql-seed-phase.resolve.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-phase.resolve.ts"],"names":[],"mappings":";;AAeA,kDAYC;AAGD,kDAQC;AAGD,wDAUC;AAjDD,yCAAyC;AAEzC,MAAM,YAAY,GAA4B;IAC5C,aAAa;IACb,SAAS;IACT,MAAM;IACN,KAAK;CACN,CAAC;AAEF;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,QAAiB;IACnD,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC;SAC7D,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IAEjB,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,CACjC,KAAmB;IAEnB,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,CACpC,OAAiB,OAAO,CAAC,IAAI;IAE7B,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-plan.util.d.ts

@@ -0,0 +1,12 @@
+import type { JqlSeedProvider } from './jql-seed-provider.interface';
+import type { NormalizedJqlSeedSelection } from './jql-seed-selection.types';
+import type { JqlSeedPhase, JqlSeedTarget } from './jql-seed-target.types';
+export declare function formatJqlSeedExecutionPlan(options: {
+    phase: JqlSeedPhase;
+    selection: NormalizedJqlSeedSelection;
+    targets: readonly JqlSeedTarget[];
+}): string;
+export declare function formatJqlSeedRegistryList(providers: readonly JqlSeedProvider[], targetsByPhase: ReadonlyMap<Exclude<JqlSeedPhase, 'schemas' | 'all'>, readonly JqlSeedTarget[]>): string;
+/** One line per target: `key` and `name` only (tab-separated, with header). */
+export declare function formatJqlSeedRegistryListFlat(targetsByPhase: ReadonlyMap<Exclude<JqlSeedPhase, 'schemas' | 'all'>, readonly JqlSeedTarget[]>): string;
+//# sourceMappingURL=jql-seed-plan.util.d.ts.map

package/jql/seed/src/lib/jql-seed-plan.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-seed-plan.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-seed-plan.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI3E,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,0BAA0B,CAAC;IACtC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CACnC,GAAG,MAAM,CAgCT;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,cAAc,EAAE,WAAW,CACzB,OAAO,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAC,EACxC,SAAS,aAAa,EAAE,CACzB,GACA,MAAM,CAsDR;AAED,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,WAAW,CACzB,OAAO,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,CAAC,EACxC,SAAS,aAAa,EAAE,CACzB,GACA,MAAM,CAgBR"}

package/jql/seed/src/lib/jql-seed-plan.util.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatJqlSeedExecutionPlan = formatJqlSeedExecutionPlan;
+exports.formatJqlSeedRegistryList = formatJqlSeedRegistryList;
+exports.formatJqlSeedRegistryListFlat = formatJqlSeedRegistryListFlat;
+const jql_seed_options_resolve_1 = require("./jql-seed-options.resolve");
+//#region ---- JQL seed plan formatting ----
+function formatJqlSeedExecutionPlan(options) {
+    const lines = [
+        'JQL seed plan',
+        '',
+        `Phase: ${options.phase}`,
+        `Mode: ${(0, jql_seed_options_resolve_1.isSelectiveSelection)(options.selection) ? 'selective' : 'full'}`,
+        `Selected targets: ${options.targets.length}`,
+        '',
+    ];
+    options.targets.forEach((target, index) => {
+        lines.push(`${index + 1}. ${target.key}`);
+        if (target.moduleName) {
+            lines.push(`   module: ${target.moduleName}`);
+        }
+        if (target.kind !== 'task') {
+            lines.push(`   ${target.kind}: ${target.target}`);
+        }
+        lines.push(`   kind: ${target.kind}`);
+        if (target.providerName) {
+            lines.push(`   provider: ${target.providerName}`);
+        }
+        if (target.tags?.length) {
+            lines.push(`   tags: ${target.tags.join(', ')}`);
+        }
+        if (target.dependsOn?.length) {
+            lines.push(`   depends on: ${target.dependsOn.join(', ')}`);
+        }
+        lines.push('');
+    });
+    return lines.join('\n').trimEnd();
+}
+function formatJqlSeedRegistryList(providers, targetsByPhase) {
+    const lines = ['JQL seed registry', ''];
+    for (const provider of providers) {
+        lines.push(`Provider: ${provider.name}`);
+        lines.push(`  phase: ${provider.phase}`);
+        if (provider.moduleName) {
+            lines.push(`  module: ${provider.moduleName}`);
+        }
+        if (provider.tags?.length) {
+            lines.push(`  tags: ${provider.tags.join(', ')}`);
+        }
+        lines.push('');
+    }
+    for (const [phase, targets] of targetsByPhase.entries()) {
+        lines.push(`Phase: ${phase}`);
+        lines.push('');
+        const byModule = new Map();
+        for (const target of targets) {
+            const moduleName = target.moduleName ?? '(none)';
+            const group = byModule.get(moduleName) ?? [];
+            group.push(target);
+            byModule.set(moduleName, group);
+        }
+        for (const [moduleName, moduleTargets] of [...byModule.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+            lines.push(`  Module: ${moduleName}`);
+            for (const target of moduleTargets) {
+                lines.push(`    - key: ${target.key}`);
+                lines.push(`      name: ${target.name}`);
+                lines.push(`      provider: ${target.providerName ?? 'n/a'}`);
+                lines.push(`      phase: ${target.phase}`);
+                lines.push(`      kind: ${target.kind}`);
+                if (target.kind !== 'task') {
+                    lines.push(`      ${target.kind}: ${target.target}`);
+                }
+                if (target.tags?.length) {
+                    lines.push(`      tags: ${target.tags.join(', ')}`);
+                }
+                if (target.dependsOn?.length) {
+                    lines.push(`      dependencies: ${target.dependsOn.join(', ')}`);
+                }
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n').trimEnd();
+}
+/** One line per target: `key` and `name` only (tab-separated, with header). */
+function formatJqlSeedRegistryListFlat(targetsByPhase) {
+    const lines = ['key\tname'];
+    const seen = new Set();
+    for (const targets of targetsByPhase.values()) {
+        for (const target of targets) {
+            if (seen.has(target.key)) {
+                continue;
+            }
+            seen.add(target.key);
+            lines.push(`${target.key}\t${target.name}`);
+        }
+    }
+    return lines.join('\n');
+}
+//#endregion
+//# sourceMappingURL=jql-seed-plan.util.js.map