@acorex-platform/framework-server 0.0.37 → 0.0.46

package/jql/seed/src/lib/jql-release-migrate.service.js

@@ -0,0 +1,103 @@
+"use strict";
+var JqlReleaseMigrateService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlReleaseMigrateService = 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_release_ledger_service_1 = require("./jql-release-ledger.service");
+const jql_release_migration_runner_1 = require("./jql-release-migration.runner");
+const jql_release_seed_reconcile_service_1 = require("./jql-release-seed-reconcile.service");
+//#region ---- Release migrate orchestrator ----
+let JqlReleaseMigrateService = JqlReleaseMigrateService_1 = class JqlReleaseMigrateService {
+    constructor(ledger, migrations, reconcile, schemaLoader) {
+        this.ledger = ledger;
+        this.migrations = migrations;
+        this.reconcile = reconcile;
+        this.schemaLoader = schemaLoader;
+        this.logger = new common_1.Logger(JqlReleaseMigrateService_1.name);
+    }
+    async run(options) {
+        const owner = `pid-${process.pid}-${Date.now()}`;
+        if (!options.dryRun) {
+            await this.ledger.acquireLock(owner);
+        }
+        try {
+            this.logger.log(`Release migrate start layers=${options.layers.join(',')} dryRun=${options.dryRun} force=${options.force}`);
+            const migrationResult = await this.migrations.run(options.dryRun);
+            const definitionTargets = options.layers.includes('bootstrap')
+                ? await this.reconcile.reconcile({
+                    phase: 'definitions',
+                    layers: ['bootstrap'],
+                    dryRun: options.dryRun,
+                    force: options.force,
+                })
+                : [];
+            this.logger.log('Phase: schemas');
+            await this.schemaLoader.buildAndRegisterAll();
+            const dataTargets = await this.reconcile.reconcile({
+                phase: 'data',
+                layers: options.layers,
+                dryRun: options.dryRun,
+                force: options.force,
+            });
+            const targets = [
+                ...definitionTargets,
+                ...dataTargets,
+            ];
+            const applied = targets.reduce((sum, target) => sum + target.applied, 0);
+            const kept = targets.reduce((sum, target) => sum + target.kept, 0);
+            const failed = targets.reduce((sum, target) => sum + target.failed, 0);
+            const skippedTargets = targets.filter((target) => target.skipped).length;
+            if (failed > 0) {
+                const failedKeys = targets
+                    .filter((target) => target.failed > 0)
+                    .map((target) => `${target.targetKey}(${target.failed})`)
+                    .join(', ');
+                throw new Error(`Release migrate finished with ${failed} seed apply failure(s): ${failedKeys}`);
+            }
+            const result = {
+                dryRun: options.dryRun,
+                layers: options.layers,
+                migrationsApplied: migrationResult.applied,
+                migrationsSkipped: migrationResult.skipped,
+                targets,
+                applied,
+                kept,
+                failed,
+                skippedTargets,
+            };
+            if (!options.dryRun) {
+                await this.ledger.recordRelease({
+                    version: process.env['npm_package_version'] ?? 'unknown',
+                    gitSha: process.env['GITHUB_SHA'] ?? process.env['GIT_SHA'] ?? 'local',
+                    summary: {
+                        layers: [...options.layers],
+                        migrationsApplied: [...migrationResult.applied],
+                        applied,
+                        kept,
+                        skippedTargets,
+                    },
+                });
+            }
+            this.logger.log(`Release migrate finished applied=${applied} kept=${kept} skippedTargets=${skippedTargets} ` +
+                `migrations=${migrationResult.applied.length}`);
+            return result;
+        }
+        finally {
+            if (!options.dryRun) {
+                await this.ledger.releaseLock();
+            }
+        }
+    }
+};
+exports.JqlReleaseMigrateService = JqlReleaseMigrateService;
+exports.JqlReleaseMigrateService = JqlReleaseMigrateService = JqlReleaseMigrateService_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [jql_release_ledger_service_1.JqlReleaseLedgerService,
+        jql_release_migration_runner_1.JqlReleaseMigrationRunner,
+        jql_release_seed_reconcile_service_1.JqlReleaseSeedReconcileService,
+        providers_1.DomainEntitySchemaLoader])
+], JqlReleaseMigrateService);
+//#endregion
+//# sourceMappingURL=jql-release-migrate.service.js.map

package/jql/seed/src/lib/jql-release-migrate.service.js.map

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

package/jql/seed/src/lib/jql-release-migrate.tokens.d.ts

@@ -0,0 +1,5 @@
+import type { JqlReleaseMigration } from './jql-release-migrate.types';
+/** App-registered once-only release migrations (empty by default). */
+export declare const JQL_RELEASE_MIGRATIONS: unique symbol;
+export type JqlReleaseMigrations = readonly JqlReleaseMigration[];
+//# sourceMappingURL=jql-release-migrate.tokens.d.ts.map

package/jql/seed/src/lib/jql-release-migrate.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migrate.tokens.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migrate.tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG,SAAS,mBAAmB,EAAE,CAAC"}

package/jql/seed/src/lib/jql-release-migrate.tokens.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JQL_RELEASE_MIGRATIONS = void 0;
+//#region ---- Release migrate tokens ----
+/** App-registered once-only release migrations (empty by default). */
+exports.JQL_RELEASE_MIGRATIONS = Symbol('JQL_RELEASE_MIGRATIONS');
+//#endregion
+//# sourceMappingURL=jql-release-migrate.tokens.js.map

package/jql/seed/src/lib/jql-release-migrate.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migrate.tokens.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migrate.tokens.ts"],"names":[],"mappings":";;;AAEA,0CAA0C;AAE1C,sEAAsE;AACzD,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAIvE,YAAY"}

package/jql/seed/src/lib/jql-release-migrate.types.d.ts

@@ -0,0 +1,63 @@
+/** Owned seed layer applied on an existing database after a release. */
+export type JqlReleaseLayer = 'bootstrap' | 'pack' | 'demo';
+export declare const JQL_RELEASE_LAYERS: readonly JqlReleaseLayer[];
+export declare const JQL_RELEASE_LEDGER_SOURCE = "jql_release_ledger";
+export declare const JQL_RELEASE_LEDGER_COLLECTION = "jql_release_ledger";
+export declare const JQL_RELEASE_LOCK_ID = "lock";
+export declare const JQL_RELEASE_LOCK_TTL_MS: number;
+export type JqlReleaseLedgerKind = 'lock' | 'migration' | 'seed-target' | 'release';
+export interface JqlReleaseMigrationContext {
+    readonly entityBackend: import('@acorex-platform/framework-server/jql/abstract').EntityStorageBackend;
+    getEngine(instanceName: string): import('@acorex-platform/framework-server/jql/abstract').JqlEngineBase;
+}
+/**
+ * Hand-written, once-only data/schema transform.
+ * Use for renames, backfills, and splits — not for catalog row upserts.
+ */
+export interface JqlReleaseMigration {
+    readonly id: string;
+    readonly checksum: string;
+    readonly description?: string;
+    up(context: JqlReleaseMigrationContext): Promise<void>;
+}
+export interface JqlReleaseMigrateOptions {
+    readonly enabled: boolean;
+    readonly dryRun: boolean;
+    /** Re-analyze even when the target checksum matches the ledger. */
+    readonly force: boolean;
+    readonly layers: readonly JqlReleaseLayer[];
+}
+export interface JqlReleaseSeedTargetLedger {
+    readonly targetKey: string;
+    readonly checksum: string;
+    readonly recordChecksums: Readonly<Record<string, string>>;
+    readonly layer: JqlReleaseLayer;
+    readonly appliedAt: string;
+}
+export interface JqlReleaseMigrationLedger {
+    readonly migrationId: string;
+    readonly checksum: string;
+    readonly appliedAt: string;
+}
+export interface JqlReleaseTargetResult {
+    readonly targetKey: string;
+    readonly layer: JqlReleaseLayer;
+    readonly phase: 'definitions' | 'data';
+    readonly skipped: boolean;
+    readonly skipReason?: string;
+    readonly applied: number;
+    readonly kept: number;
+    readonly failed: number;
+}
+export interface JqlReleaseMigrateResult {
+    readonly dryRun: boolean;
+    readonly layers: readonly JqlReleaseLayer[];
+    readonly migrationsApplied: readonly string[];
+    readonly migrationsSkipped: readonly string[];
+    readonly targets: readonly JqlReleaseTargetResult[];
+    readonly applied: number;
+    readonly kept: number;
+    readonly failed: number;
+    readonly skippedTargets: number;
+}
+//# sourceMappingURL=jql-release-migrate.types.d.ts.map

package/jql/seed/src/lib/jql-release-migrate.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migrate.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migrate.types.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAIxD,CAAC;AAEF,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAClE,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,OAAO,gDAAgD,EAAE,oBAAoB,CAAC;IACtG,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,gDAAgD,EAAE,aAAa,CAAC;CACzG;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,EAAE,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC"}

package/jql/seed/src/lib/jql-release-migrate.types.js

@@ -0,0 +1,15 @@
+"use strict";
+//#region ---- Release migrate types ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JQL_RELEASE_LOCK_TTL_MS = exports.JQL_RELEASE_LOCK_ID = exports.JQL_RELEASE_LEDGER_COLLECTION = exports.JQL_RELEASE_LEDGER_SOURCE = exports.JQL_RELEASE_LAYERS = void 0;
+exports.JQL_RELEASE_LAYERS = [
+    'bootstrap',
+    'pack',
+    'demo',
+];
+exports.JQL_RELEASE_LEDGER_SOURCE = 'jql_release_ledger';
+exports.JQL_RELEASE_LEDGER_COLLECTION = 'jql_release_ledger';
+exports.JQL_RELEASE_LOCK_ID = 'lock';
+exports.JQL_RELEASE_LOCK_TTL_MS = 30 * 60 * 1000;
+//#endregion
+//# sourceMappingURL=jql-release-migrate.types.js.map

package/jql/seed/src/lib/jql-release-migrate.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migrate.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migrate.types.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;AAK5B,QAAA,kBAAkB,GAA+B;IAC5D,WAAW;IACX,MAAM;IACN,MAAM;CACP,CAAC;AAEW,QAAA,yBAAyB,GAAG,oBAAoB,CAAC;AACjD,QAAA,6BAA6B,GAAG,oBAAoB,CAAC;AACrD,QAAA,mBAAmB,GAAG,MAAM,CAAC;AAC7B,QAAA,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAqEtD,YAAY"}

package/jql/seed/src/lib/jql-release-migrate.util.d.ts

@@ -0,0 +1,35 @@
+import type { JqlSeedApplyDecisionDto, JqlSeedDiffOpDto } from './jql-seed-api.types';
+import type { JqlSeedDiffAction } from './jql-seed-diff.util';
+import type { JqlReleaseLayer } from './jql-release-migrate.types';
+export declare function isJqlReleaseLayer(value: string): value is JqlReleaseLayer;
+/**
+ * bootstrap wins, then demo/sample, then pack/core.
+ * Untagged catalogs (command/query/widget) are treated as bootstrap.
+ */
+export declare function resolveReleaseSeedLayer(tags: readonly string[] | undefined): JqlReleaseLayer;
+export declare function hashNormalizedJson(value: unknown): string;
+export declare function hashSeedRecord(record: Record<string, unknown>): string;
+export declare function hashSeedRecords(records: readonly Record<string, unknown>[], uniqueKeys?: readonly string[]): string;
+export declare function buildSeedRecordChecksums(records: readonly Record<string, unknown>[], uniqueKeys?: readonly string[]): Record<string, string>;
+export declare function isSystemSeedRow(row: Record<string, unknown> | undefined): boolean;
+/** Seed-owned: system/immutable, or no tenant clone marker. */
+export declare function isSeedOwnedRow(row: Record<string, unknown> | undefined): boolean;
+/** Local diverged from the last seed payload we successfully applied. */
+export declare function isUserEditedSeedRow(local: Record<string, unknown> | undefined, lastAppliedRecordHash: string | undefined): boolean;
+export declare function decideReleaseSeedAction(args: {
+    readonly op: JqlSeedDiffOpDto;
+    readonly layer: JqlReleaseLayer;
+    readonly lastAppliedRecordHash?: string;
+}): JqlSeedDiffAction | null;
+export declare function expandReleaseSeedDecisions(args: {
+    readonly targetKey: string;
+    readonly layer: JqlReleaseLayer;
+    readonly ops: readonly JqlSeedDiffOpDto[];
+    readonly lastRecordChecksums?: Readonly<Record<string, string>>;
+}): JqlSeedApplyDecisionDto[];
+export declare function mergeRecordChecksumsAfterApply(args: {
+    readonly previous: Readonly<Record<string, string>>;
+    readonly desired: Readonly<Record<string, string>>;
+    readonly decisions: readonly JqlSeedApplyDecisionDto[];
+}): Record<string, string>;
+//# sourceMappingURL=jql-release-migrate.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migrate.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migrate.util.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAKnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAClC,eAAe,CAYjB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEtE;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3C,UAAU,GAAE,SAAS,MAAM,EAAW,GACrC,MAAM,CAYR;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3C,UAAU,GAAE,SAAS,MAAM,EAAW,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AASD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,OAAO,CAGT;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,OAAO,CAST;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,qBAAqB,EAAE,MAAM,GAAG,SAAS,GACxC,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,iBAAiB,GAAG,IAAI,CAwC3B;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjE,GAAG,uBAAuB,EAAE,CAkB5B;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBzB"}

package/jql/seed/src/lib/jql-release-migrate.util.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJqlReleaseLayer = isJqlReleaseLayer;
+exports.resolveReleaseSeedLayer = resolveReleaseSeedLayer;
+exports.hashNormalizedJson = hashNormalizedJson;
+exports.hashSeedRecord = hashSeedRecord;
+exports.hashSeedRecords = hashSeedRecords;
+exports.buildSeedRecordChecksums = buildSeedRecordChecksums;
+exports.isSystemSeedRow = isSystemSeedRow;
+exports.isSeedOwnedRow = isSeedOwnedRow;
+exports.isUserEditedSeedRow = isUserEditedSeedRow;
+exports.decideReleaseSeedAction = decideReleaseSeedAction;
+exports.expandReleaseSeedDecisions = expandReleaseSeedDecisions;
+exports.mergeRecordChecksumsAfterApply = mergeRecordChecksumsAfterApply;
+const node_crypto_1 = require("node:crypto");
+const jql_seed_diff_util_1 = require("./jql-seed-diff.util");
+const jql_release_migrate_types_1 = require("./jql-release-migrate.types");
+//#region ---- Release migrate helpers ----
+function isJqlReleaseLayer(value) {
+    return jql_release_migrate_types_1.JQL_RELEASE_LAYERS.includes(value);
+}
+/**
+ * bootstrap wins, then demo/sample, then pack/core.
+ * Untagged catalogs (command/query/widget) are treated as bootstrap.
+ */
+function resolveReleaseSeedLayer(tags) {
+    const set = new Set(tags ?? []);
+    if (set.has('bootstrap')) {
+        return 'bootstrap';
+    }
+    if (set.has('demo') || set.has('sample')) {
+        return 'demo';
+    }
+    if (set.has('pack') || set.has('core')) {
+        return 'pack';
+    }
+    return 'bootstrap';
+}
+function hashNormalizedJson(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(value)).digest('hex');
+}
+function hashSeedRecord(record) {
+    return hashNormalizedJson((0, jql_seed_diff_util_1.normalizeJqlSeedRecordForCompare)(record));
+}
+function hashSeedRecords(records, uniqueKeys = ['id']) {
+    const items = records
+        .map((record) => {
+        const key = (0, jql_seed_diff_util_1.buildJqlSeedRecordKey)(record, uniqueKeys);
+        if (!key) {
+            return null;
+        }
+        return { key, value: (0, jql_seed_diff_util_1.normalizeJqlSeedRecordForCompare)(record) };
+    })
+        .filter((item) => item != null)
+        .sort((left, right) => left.key.localeCompare(right.key));
+    return hashNormalizedJson(items);
+}
+function buildSeedRecordChecksums(records, uniqueKeys = ['id']) {
+    const checksums = {};
+    for (const record of records) {
+        const key = (0, jql_seed_diff_util_1.buildJqlSeedRecordKey)(record, uniqueKeys);
+        if (!key) {
+            continue;
+        }
+        checksums[key] = hashSeedRecord(record);
+    }
+    return checksums;
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function isSystemSeedRow(row) {
+    const state = asRecord(row?.['stateInfo']);
+    return state?.['isSystem'] === true || state?.['isImmutable'] === true;
+}
+/** Seed-owned: system/immutable, or no tenant clone marker. */
+function isSeedOwnedRow(row) {
+    if (!row) {
+        return false;
+    }
+    if (isSystemSeedRow(row)) {
+        return true;
+    }
+    const clonedFromId = row['clonedFromId'];
+    return clonedFromId == null || clonedFromId === '';
+}
+/** Local diverged from the last seed payload we successfully applied. */
+function isUserEditedSeedRow(local, lastAppliedRecordHash) {
+    if (!local || !lastAppliedRecordHash) {
+        return false;
+    }
+    return hashSeedRecord(local) !== lastAppliedRecordHash;
+}
+function decideReleaseSeedAction(args) {
+    const { op, layer, lastAppliedRecordHash } = args;
+    if (op.kind === 'extra') {
+        return null;
+    }
+    if (op.kind === 'add') {
+        return 'take-seed';
+    }
+    if (op.kind === 'change') {
+        if (layer === 'bootstrap') {
+            return 'take-seed';
+        }
+        if (layer === 'pack') {
+            return isSeedOwnedRow(op.local) || isSeedOwnedRow(op.seed)
+                ? 'take-seed'
+                : 'keep-local';
+        }
+        if (isSystemSeedRow(op.local) || isSystemSeedRow(op.seed)) {
+            return 'take-seed';
+        }
+        if (lastAppliedRecordHash &&
+            !isUserEditedSeedRow(op.local, lastAppliedRecordHash)) {
+            return 'take-seed';
+        }
+        return 'keep-local';
+    }
+    if (op.kind === 'seed-removed') {
+        if (layer === 'bootstrap' && isSystemSeedRow(op.local)) {
+            return 'delete';
+        }
+        return 'keep-local';
+    }
+    return null;
+}
+function expandReleaseSeedDecisions(args) {
+    const decisions = [];
+    for (const op of args.ops) {
+        const action = decideReleaseSeedAction({
+            op,
+            layer: args.layer,
+            lastAppliedRecordHash: args.lastRecordChecksums?.[op.recordKey],
+        });
+        if (!action) {
+            continue;
+        }
+        decisions.push({
+            targetKey: args.targetKey,
+            recordKey: op.recordKey,
+            action,
+        });
+    }
+    return decisions;
+}
+function mergeRecordChecksumsAfterApply(args) {
+    const next = { ...args.previous };
+    const byKey = new Map(args.decisions.map((decision) => [decision.recordKey, decision.action]));
+    for (const [recordKey, checksum] of Object.entries(args.desired)) {
+        const action = byKey.get(recordKey);
+        if (action === 'keep-local') {
+            continue;
+        }
+        if (action === 'delete') {
+            delete next[recordKey];
+            continue;
+        }
+        next[recordKey] = checksum;
+    }
+    for (const decision of args.decisions) {
+        if (decision.action === 'delete') {
+            delete next[decision.recordKey];
+        }
+    }
+    return next;
+}
+//#endregion
+//# sourceMappingURL=jql-release-migrate.util.js.map

package/jql/seed/src/lib/jql-release-migrate.util.js.map

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

package/jql/seed/src/lib/jql-release-migration.runner.d.ts

@@ -0,0 +1,17 @@
+import type { EntityStorageBackend } from '@acorex-platform/framework-server/jql/abstract';
+import { JqlEngineRegistryService } from './jql-engine-registry.service';
+import { JqlReleaseLedgerService } from './jql-release-ledger.service';
+import type { JqlReleaseMigration } from './jql-release-migrate.types';
+export declare class JqlReleaseMigrationRunner {
+    private readonly ledger;
+    private readonly engineRegistry;
+    private readonly entityBackend;
+    private readonly migrations;
+    private readonly logger;
+    constructor(ledger: JqlReleaseLedgerService, engineRegistry: JqlEngineRegistryService, entityBackend: EntityStorageBackend, migrations: readonly JqlReleaseMigration[] | null);
+    run(dryRun: boolean): Promise<{
+        applied: string[];
+        skipped: string[];
+    }>;
+}
+//# sourceMappingURL=jql-release-migration.runner.d.ts.map

package/jql/seed/src/lib/jql-release-migration.runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-migration.runner.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-migration.runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAIvE,qBACa,yBAAyB;IAIlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAE/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAG9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAGlD,MAAM,EAAE,uBAAuB,EAC/B,cAAc,EAAE,wBAAwB,EAExC,aAAa,EAAE,oBAAoB,EAGnC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GAAG,IAAI;IAG9D,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CAuDH"}

package/jql/seed/src/lib/jql-release-migration.runner.js

@@ -0,0 +1,69 @@
+"use strict";
+var JqlReleaseMigrationRunner_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlReleaseMigrationRunner = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@acorex-platform/framework-server/core");
+const jql_engine_registry_service_1 = require("./jql-engine-registry.service");
+const jql_release_ledger_service_1 = require("./jql-release-ledger.service");
+const jql_release_migrate_tokens_1 = require("./jql-release-migrate.tokens");
+//#region ---- Release migration runner ----
+let JqlReleaseMigrationRunner = JqlReleaseMigrationRunner_1 = class JqlReleaseMigrationRunner {
+    constructor(ledger, engineRegistry, entityBackend, migrations) {
+        this.ledger = ledger;
+        this.engineRegistry = engineRegistry;
+        this.entityBackend = entityBackend;
+        this.migrations = migrations;
+        this.logger = new common_1.Logger(JqlReleaseMigrationRunner_1.name);
+    }
+    async run(dryRun) {
+        const applied = [];
+        const skipped = [];
+        const pending = [...(this.migrations ?? [])].sort((left, right) => left.id.localeCompare(right.id));
+        if (!pending.length) {
+            this.logger.log('No release migrations registered');
+            return { applied, skipped };
+        }
+        for (const migration of pending) {
+            const existing = await this.ledger.getAppliedMigration(migration.id);
+            if (existing) {
+                if (existing.checksum !== migration.checksum) {
+                    throw new Error(`Release migration "${migration.id}" checksum changed after apply ` +
+                        `(ledger=${existing.checksum}, current=${migration.checksum})`);
+                }
+                skipped.push(migration.id);
+                this.logger.log(`Skip migration ${migration.id} (already applied)`);
+                continue;
+            }
+            if (dryRun) {
+                this.logger.log(`[dry-run] Would apply migration ${migration.id}${migration.description ? ` — ${migration.description}` : ''}`);
+                applied.push(migration.id);
+                continue;
+            }
+            this.logger.log(`Applying migration ${migration.id}${migration.description ? ` — ${migration.description}` : ''}`);
+            await migration.up({
+                entityBackend: this.entityBackend,
+                getEngine: (instanceName) => this.engineRegistry.get(instanceName),
+            });
+            await this.ledger.recordMigration({
+                migrationId: migration.id,
+                checksum: migration.checksum,
+                appliedAt: new Date().toISOString(),
+            });
+            applied.push(migration.id);
+        }
+        return { applied, skipped };
+    }
+};
+exports.JqlReleaseMigrationRunner = JqlReleaseMigrationRunner;
+exports.JqlReleaseMigrationRunner = JqlReleaseMigrationRunner = JqlReleaseMigrationRunner_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(2, (0, common_1.Inject)(core_1.ENTITY_STORAGE_BACKEND)),
+    tslib_1.__param(3, (0, common_1.Optional)()),
+    tslib_1.__param(3, (0, common_1.Inject)(jql_release_migrate_tokens_1.JQL_RELEASE_MIGRATIONS)),
+    tslib_1.__metadata("design:paramtypes", [jql_release_ledger_service_1.JqlReleaseLedgerService,
+        jql_engine_registry_service_1.JqlEngineRegistryService, Object, Object])
+], JqlReleaseMigrationRunner);
+//#endregion
+//# sourceMappingURL=jql-release-migration.runner.js.map

package/jql/seed/src/lib/jql-release-migration.runner.js.map

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

package/jql/seed/src/lib/jql-release-seed-reconcile.service.d.ts

@@ -0,0 +1,19 @@
+import { JqlSeedDiffService } from './jql-seed-diff.service';
+import { JqlMultiSeedRunnerService } from './jql-multi-seed-runner.service';
+import { JqlReleaseLedgerService } from './jql-release-ledger.service';
+import type { JqlReleaseLayer, JqlReleaseTargetResult } from './jql-release-migrate.types';
+export declare class JqlReleaseSeedReconcileService {
+    private readonly multiSeedRunner;
+    private readonly diff;
+    private readonly ledger;
+    private readonly logger;
+    constructor(multiSeedRunner: JqlMultiSeedRunnerService, diff: JqlSeedDiffService, ledger: JqlReleaseLedgerService);
+    reconcile(args: {
+        readonly phase: 'definitions' | 'data';
+        readonly layers: readonly JqlReleaseLayer[];
+        readonly dryRun: boolean;
+        readonly force: boolean;
+    }): Promise<JqlReleaseTargetResult[]>;
+    private reconcileTarget;
+}
+//# sourceMappingURL=jql-release-seed-reconcile.service.d.ts.map

package/jql/seed/src/lib/jql-release-seed-reconcile.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-release-seed-reconcile.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/jql/seed/src/lib/jql-release-seed-reconcile.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAQvE,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAMrC,qBACa,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;gBAGvD,eAAe,EAAE,yBAAyB,EAC1C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,uBAAuB;IAG5C,SAAS,CAAC,IAAI,EAAE;QACpB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;QACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;QAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;YA8CvB,eAAe;CA4I9B"}