niceeval 0.12.2-canary.31 → 0.13.0

package/dist/record/migration/orchestrate.d.mts

@@ -1,113 +0,0 @@
-import { Effect } from "effect";
-import type { AnyRecordAttachmentFamily, RecordAttachmentMigrationResolution, RecordAttachmentRegistry } from "../attachment/types.mjs";
-import type { RecordCoreV1 } from "../model/core.mjs";
-import type { RecordGitError, RecordMaintenanceLockError } from "../platform/errors.mjs";
-import type { RecordRoot } from "../platform/root.mjs";
-import { RecordFileSystem, RecordGit, RecordMaintenanceLock, type RecordBackupState } from "../platform/services.mjs";
-import { recordAttachmentMigrationStepFailed, recordCoreMigrationStepFailed, recordMigrationAuthorizationInvalid, recordMigrationConfirmationRequired, recordMigrationPlanStale, RecordMigrationInterruptedState, type RecordCoreMigrationPlanInvalid } from "./errors.mjs";
-import type { RecordMigrationAttachmentSource, RecordMigrationSource, RecordMigrationStorage, RecordMigrationStorageError } from "./internal.mjs";
-import { type RecordCoreMigrationPlan, type RecordCoreMigrationPlanSummary } from "./plan.mjs";
-import { RecordMigrationRegistry, type RecordCoreMigrationRegistry } from "./registry.mjs";
-export type RecordMigrationAuthorization = {
-    readonly state: "git-restore-point";
-} | {
-    readonly state: "accept-data-loss";
-};
-export type RecordMigrationAttachmentPlanState = "current" | "migrate" | "migration-unavailable" | "unsupported";
-export interface RecordMigrationAttachmentPlanSummary {
-    readonly owner: "run" | "attempt";
-    readonly name: string;
-    readonly schemaId: string;
-    readonly state: RecordMigrationAttachmentPlanState;
-    readonly reason?: string;
-}
-export interface RecordMigrationPlanSummary {
-    readonly core: RecordCoreMigrationPlanSummary;
-    readonly attachments: readonly RecordMigrationAttachmentPlanSummary[];
-    readonly backup: RecordBackupState;
-    readonly state: "needed" | "not-needed";
-}
-interface RecordMigrationAttachmentPlanEntry {
-    readonly source: RecordMigrationAttachmentSource;
-    readonly family: AnyRecordAttachmentFamily | undefined;
-    readonly resolution: RecordAttachmentMigrationResolution | undefined;
-}
-/**
- * Package-created plan bound to the source snapshot and Git observation. It
- * contains no CLI confirmation and cannot be reconstructed from its summary.
- */
-export declare class RecordMigrationPlan<CoreValue = RecordCoreV1> {
-    readonly summary: RecordMigrationPlanSummary;
-    private constructor();
-    static make<CoreValue>(input: {
-        readonly source: RecordMigrationSource<CoreValue>;
-        readonly core: RecordCoreMigrationPlan<CoreValue>;
-        readonly attachments: readonly RecordMigrationAttachmentPlanEntry[];
-        readonly backup: RecordBackupState;
-        readonly storage: RecordMigrationStorage<CoreValue>;
-    }): RecordMigrationPlan<CoreValue>;
-}
-/**
- * Shared reader/open code may call this guard after acquiring its shared
- * maintenance lock. Presence alone is terminal; content is intentionally not
- * decoded and no recovery action is attempted.
- */
-export declare function assertRecordMigrationNotInterrupted(root: RecordRoot): Effect.Effect<undefined, import("../platform/errors.mjs").RecordFileSystemError | RecordMigrationInterruptedState, RecordFileSystem>;
-/**
- * Read-only preflight. It holds the real exclusive maintenance lock, checks
- * the sentinel before opening the source, delegates exact decode/closure/path
- * validation to storage, and records the platform Git backup state.
- */
-/** @internal Generic seam for layout adapters and synthetic migration tests. */
-export declare function planRecordMigrationWithStorage<CoreValue>(input: {
-    readonly root: RecordRoot;
-    readonly core: RecordCoreMigrationRegistry<CoreValue>;
-    readonly attachments: RecordAttachmentRegistry;
-    readonly storage: RecordMigrationStorage<CoreValue>;
-}): Effect.Effect<RecordMigrationPlan<CoreValue>, import("../index.mjs").RecordCodecError | import("../index.mjs").RecordAttachmentPayloadInvalid | import("../index.mjs").RecordAttachmentClosureInvalid | import("../platform/errors.mjs").RecordGitCommandError | RecordMaintenanceLockError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState, RecordFileSystem | RecordMaintenanceLock | RecordGit>;
-export interface RecordMigrationReceipt {
-    readonly state: "migrated" | "not-needed";
-    readonly plan: RecordMigrationPlanSummary;
-}
-/**
- * Execute a package-issued plan in place. No handler catches interruption or
- * defects, and no failure path removes the sentinel. Thus converter, I/O, and
- * cancellation failure leave the root fail-closed for Git/backup recovery.
- */
-/** @internal Executes a plan issued by `planRecordMigrationWithStorage`. */
-export declare function migrateRecordWithStorage<CoreValue>(input: {
-    readonly plan: RecordMigrationPlan<CoreValue>;
-    readonly authorization: RecordMigrationAuthorization;
-}): Effect.Effect<Readonly<{
-    state: "not-needed";
-    plan: RecordMigrationPlanSummary;
-}> | Readonly<{
-    state: "migrated";
-    plan: RecordMigrationPlanSummary;
-}>, import("../index.mjs").RecordCodecError | import("../index.mjs").RecordAttachmentPayloadInvalid | import("../index.mjs").RecordAttachmentClosureInvalid | import("../platform/errors.mjs").RecordGitCommandError | RecordMaintenanceLockError | import("./errors.mjs").RecordCoreMigrationStepFailed | RecordMigrationInterruptedState | import("./errors.mjs").RecordMigrationPlanStale | import("./errors.mjs").RecordMigrationConfirmationRequired | import("./errors.mjs").RecordMigrationAuthorizationInvalid | import("./errors.mjs").RecordAttachmentMigrationStepFailed, RecordFileSystem | RecordMaintenanceLock | RecordGit>;
-/**
- * Public migration preflight. Applications install the current Core registry,
- * selected Attachment families, and layout adapter once through
- * `RecordMigrationRegistry`; callers only supply the durable Record root.
- */
-export declare function planRecordMigration(input: {
-    readonly root: RecordRoot;
-}): Effect.Effect<RecordMigrationPlan<RecordCoreV1>, import("../index.mjs").RecordCodecError | import("../index.mjs").RecordAttachmentPayloadInvalid | import("../index.mjs").RecordAttachmentClosureInvalid | import("../platform/errors.mjs").RecordGitCommandError | RecordMaintenanceLockError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState, RecordFileSystem | RecordMaintenanceLock | RecordGit | RecordMigrationRegistry>;
-/**
- * Public in-place execution remains bound to the exact installed registry
- * observed during preflight. Re-providing a different registry makes the plan
- * stale instead of allowing a copied summary to select different converters.
- */
-export declare function migrateRecord(input: {
-    readonly plan: RecordMigrationPlan;
-    readonly authorization: RecordMigrationAuthorization;
-}): Effect.Effect<Readonly<{
-    state: "not-needed";
-    plan: RecordMigrationPlanSummary;
-}> | Readonly<{
-    state: "migrated";
-    plan: RecordMigrationPlanSummary;
-}>, import("../index.mjs").RecordCodecError | import("../index.mjs").RecordAttachmentPayloadInvalid | import("../index.mjs").RecordAttachmentClosureInvalid | import("../platform/errors.mjs").RecordGitCommandError | RecordMaintenanceLockError | import("./errors.mjs").RecordCoreMigrationStepFailed | RecordMigrationInterruptedState | import("./errors.mjs").RecordMigrationPlanStale | import("./errors.mjs").RecordMigrationConfirmationRequired | import("./errors.mjs").RecordMigrationAuthorizationInvalid | import("./errors.mjs").RecordAttachmentMigrationStepFailed, RecordFileSystem | RecordMaintenanceLock | RecordGit | RecordMigrationRegistry>;
-export type RecordMigrationPlanError = RecordMigrationStorageError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState | RecordGitError | RecordMaintenanceLockError;
-export type RecordMigrationError = RecordMigrationStorageError | RecordMigrationInterruptedState | RecordGitError | RecordMaintenanceLockError | ReturnType<typeof recordMigrationPlanStale> | ReturnType<typeof recordMigrationConfirmationRequired> | ReturnType<typeof recordMigrationAuthorizationInvalid> | ReturnType<typeof recordCoreMigrationStepFailed> | ReturnType<typeof recordAttachmentMigrationStepFailed>;
-export {};

package/dist/record/migration/orchestrate.d.ts

@@ -1,113 +0,0 @@
-import { Effect } from "effect";
-import type { AnyRecordAttachmentFamily, RecordAttachmentMigrationResolution, RecordAttachmentRegistry } from "../attachment/types.js";
-import type { RecordCoreV1 } from "../model/core.js";
-import type { RecordGitError, RecordMaintenanceLockError } from "../platform/errors.js";
-import type { RecordRoot } from "../platform/root.js";
-import { RecordFileSystem, RecordGit, RecordMaintenanceLock, type RecordBackupState } from "../platform/services.js";
-import { recordAttachmentMigrationStepFailed, recordCoreMigrationStepFailed, recordMigrationAuthorizationInvalid, recordMigrationConfirmationRequired, recordMigrationPlanStale, RecordMigrationInterruptedState, type RecordCoreMigrationPlanInvalid } from "./errors.js";
-import type { RecordMigrationAttachmentSource, RecordMigrationSource, RecordMigrationStorage, RecordMigrationStorageError } from "./internal.js";
-import { type RecordCoreMigrationPlan, type RecordCoreMigrationPlanSummary } from "./plan.js";
-import { RecordMigrationRegistry, type RecordCoreMigrationRegistry } from "./registry.js";
-export type RecordMigrationAuthorization = {
-    readonly state: "git-restore-point";
-} | {
-    readonly state: "accept-data-loss";
-};
-export type RecordMigrationAttachmentPlanState = "current" | "migrate" | "migration-unavailable" | "unsupported";
-export interface RecordMigrationAttachmentPlanSummary {
-    readonly owner: "run" | "attempt";
-    readonly name: string;
-    readonly schemaId: string;
-    readonly state: RecordMigrationAttachmentPlanState;
-    readonly reason?: string;
-}
-export interface RecordMigrationPlanSummary {
-    readonly core: RecordCoreMigrationPlanSummary;
-    readonly attachments: readonly RecordMigrationAttachmentPlanSummary[];
-    readonly backup: RecordBackupState;
-    readonly state: "needed" | "not-needed";
-}
-interface RecordMigrationAttachmentPlanEntry {
-    readonly source: RecordMigrationAttachmentSource;
-    readonly family: AnyRecordAttachmentFamily | undefined;
-    readonly resolution: RecordAttachmentMigrationResolution | undefined;
-}
-/**
- * Package-created plan bound to the source snapshot and Git observation. It
- * contains no CLI confirmation and cannot be reconstructed from its summary.
- */
-export declare class RecordMigrationPlan<CoreValue = RecordCoreV1> {
-    readonly summary: RecordMigrationPlanSummary;
-    private constructor();
-    static make<CoreValue>(input: {
-        readonly source: RecordMigrationSource<CoreValue>;
-        readonly core: RecordCoreMigrationPlan<CoreValue>;
-        readonly attachments: readonly RecordMigrationAttachmentPlanEntry[];
-        readonly backup: RecordBackupState;
-        readonly storage: RecordMigrationStorage<CoreValue>;
-    }): RecordMigrationPlan<CoreValue>;
-}
-/**
- * Shared reader/open code may call this guard after acquiring its shared
- * maintenance lock. Presence alone is terminal; content is intentionally not
- * decoded and no recovery action is attempted.
- */
-export declare function assertRecordMigrationNotInterrupted(root: RecordRoot): Effect.Effect<undefined, import("../platform/errors.js").RecordFileSystemError | RecordMigrationInterruptedState, RecordFileSystem>;
-/**
- * Read-only preflight. It holds the real exclusive maintenance lock, checks
- * the sentinel before opening the source, delegates exact decode/closure/path
- * validation to storage, and records the platform Git backup state.
- */
-/** @internal Generic seam for layout adapters and synthetic migration tests. */
-export declare function planRecordMigrationWithStorage<CoreValue>(input: {
-    readonly root: RecordRoot;
-    readonly core: RecordCoreMigrationRegistry<CoreValue>;
-    readonly attachments: RecordAttachmentRegistry;
-    readonly storage: RecordMigrationStorage<CoreValue>;
-}): Effect.Effect<RecordMigrationPlan<CoreValue>, import("../index.js").RecordCodecError | import("../index.js").RecordAttachmentPayloadInvalid | import("../index.js").RecordAttachmentClosureInvalid | import("../platform/errors.js").RecordGitCommandError | RecordMaintenanceLockError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState, RecordFileSystem | RecordMaintenanceLock | RecordGit>;
-export interface RecordMigrationReceipt {
-    readonly state: "migrated" | "not-needed";
-    readonly plan: RecordMigrationPlanSummary;
-}
-/**
- * Execute a package-issued plan in place. No handler catches interruption or
- * defects, and no failure path removes the sentinel. Thus converter, I/O, and
- * cancellation failure leave the root fail-closed for Git/backup recovery.
- */
-/** @internal Executes a plan issued by `planRecordMigrationWithStorage`. */
-export declare function migrateRecordWithStorage<CoreValue>(input: {
-    readonly plan: RecordMigrationPlan<CoreValue>;
-    readonly authorization: RecordMigrationAuthorization;
-}): Effect.Effect<Readonly<{
-    state: "not-needed";
-    plan: RecordMigrationPlanSummary;
-}> | Readonly<{
-    state: "migrated";
-    plan: RecordMigrationPlanSummary;
-}>, import("../index.js").RecordCodecError | import("../index.js").RecordAttachmentPayloadInvalid | import("../index.js").RecordAttachmentClosureInvalid | import("../platform/errors.js").RecordGitCommandError | RecordMaintenanceLockError | import("./errors.js").RecordCoreMigrationStepFailed | RecordMigrationInterruptedState | import("./errors.js").RecordMigrationPlanStale | import("./errors.js").RecordMigrationConfirmationRequired | import("./errors.js").RecordMigrationAuthorizationInvalid | import("./errors.js").RecordAttachmentMigrationStepFailed, RecordFileSystem | RecordMaintenanceLock | RecordGit>;
-/**
- * Public migration preflight. Applications install the current Core registry,
- * selected Attachment families, and layout adapter once through
- * `RecordMigrationRegistry`; callers only supply the durable Record root.
- */
-export declare function planRecordMigration(input: {
-    readonly root: RecordRoot;
-}): Effect.Effect<RecordMigrationPlan<RecordCoreV1>, import("../index.js").RecordCodecError | import("../index.js").RecordAttachmentPayloadInvalid | import("../index.js").RecordAttachmentClosureInvalid | import("../platform/errors.js").RecordGitCommandError | RecordMaintenanceLockError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState, RecordFileSystem | RecordMaintenanceLock | RecordGit | RecordMigrationRegistry>;
-/**
- * Public in-place execution remains bound to the exact installed registry
- * observed during preflight. Re-providing a different registry makes the plan
- * stale instead of allowing a copied summary to select different converters.
- */
-export declare function migrateRecord(input: {
-    readonly plan: RecordMigrationPlan;
-    readonly authorization: RecordMigrationAuthorization;
-}): Effect.Effect<Readonly<{
-    state: "not-needed";
-    plan: RecordMigrationPlanSummary;
-}> | Readonly<{
-    state: "migrated";
-    plan: RecordMigrationPlanSummary;
-}>, import("../index.js").RecordCodecError | import("../index.js").RecordAttachmentPayloadInvalid | import("../index.js").RecordAttachmentClosureInvalid | import("../platform/errors.js").RecordGitCommandError | RecordMaintenanceLockError | import("./errors.js").RecordCoreMigrationStepFailed | RecordMigrationInterruptedState | import("./errors.js").RecordMigrationPlanStale | import("./errors.js").RecordMigrationConfirmationRequired | import("./errors.js").RecordMigrationAuthorizationInvalid | import("./errors.js").RecordAttachmentMigrationStepFailed, RecordFileSystem | RecordMaintenanceLock | RecordGit | RecordMigrationRegistry>;
-export type RecordMigrationPlanError = RecordMigrationStorageError | RecordCoreMigrationPlanInvalid | RecordMigrationInterruptedState | RecordGitError | RecordMaintenanceLockError;
-export type RecordMigrationError = RecordMigrationStorageError | RecordMigrationInterruptedState | RecordGitError | RecordMaintenanceLockError | ReturnType<typeof recordMigrationPlanStale> | ReturnType<typeof recordMigrationConfirmationRequired> | ReturnType<typeof recordMigrationAuthorizationInvalid> | ReturnType<typeof recordCoreMigrationStepFailed> | ReturnType<typeof recordAttachmentMigrationStepFailed>;
-export {};

package/dist/record/migration/orchestrate.js

@@ -1,16 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./orchestrate.cjs");
-const __niceevalExport0 = __niceevalCanonical["RecordMigrationPlan"];
-export { __niceevalExport0 as RecordMigrationPlan };
-const __niceevalExport1 = __niceevalCanonical["assertRecordMigrationNotInterrupted"];
-export { __niceevalExport1 as assertRecordMigrationNotInterrupted };
-const __niceevalExport2 = __niceevalCanonical["migrateRecord"];
-export { __niceevalExport2 as migrateRecord };
-const __niceevalExport3 = __niceevalCanonical["migrateRecordWithStorage"];
-export { __niceevalExport3 as migrateRecordWithStorage };
-const __niceevalExport4 = __niceevalCanonical["planRecordMigration"];
-export { __niceevalExport4 as planRecordMigration };
-const __niceevalExport5 = __niceevalCanonical["planRecordMigrationWithStorage"];
-export { __niceevalExport5 as planRecordMigrationWithStorage };
-//# sourceMappingURL=orchestrate.js.map

package/dist/record/migration/orchestrate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestrate.js","sources":[],"names":[],"mappings":""}

package/dist/record/migration/plan.cjs

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecordCoreMigrationPlan = void 0;
-exports.makeRecordCoreMigrationPlan = makeRecordCoreMigrationPlan;
-exports.recordCoreMigrationPlanResolution = recordCoreMigrationPlanResolution;
-const effect_1 = require("effect");
-const errors_ts_1 = require("./errors.cjs");
-/** Runtime execution state never becomes part of a plan's public summary. */
-const corePlanResolutions = new WeakMap();
-/**
- * Package-created, pure Core plan. The source snapshot stays opaque to callers
- * so a later execution boundary cannot substitute a different value or path.
- */
-class RecordCoreMigrationPlan {
-    summary;
-    constructor(summary) {
-        this.summary = summary;
-        Object.freeze(this);
-    }
-    static make(input) {
-        const resolution = input.registry.resolve(input.sourceFormat);
-        const issues = [];
-        if (resolution.state === "migration-edge-missing") {
-            issues.push({
-                code: "record-core-migration-edge-missing",
-                from: resolution.from,
-                to: resolution.to,
-            });
-        }
-        else if (resolution.state === "unsupported") {
-            issues.push({
-                code: "record-core-migration-source-unsupported",
-                format: input.sourceFormat,
-            });
-        }
-        if (issues.length > 0) {
-            return effect_1.Either.left((0, errors_ts_1.recordCoreMigrationPlanInvalid)(issues));
-        }
-        const edges = resolution.state === "migration-required" ? resolution.edges : Object.freeze([]);
-        const steps = Object.freeze(edges.map((edge) => Object.freeze({ from: edge.from, to: edge.to })));
-        const plan = new RecordCoreMigrationPlan(Object.freeze({
-            sourceFormat: input.sourceFormat,
-            targetFormat: input.registry.currentFormat,
-            steps,
-            state: steps.length === 0 ? "not-needed" : "needed",
-        }));
-        corePlanResolutions.set(plan, resolution);
-        return effect_1.Either.right(plan);
-    }
-}
-exports.RecordCoreMigrationPlan = RecordCoreMigrationPlan;
-function makeRecordCoreMigrationPlan(input) {
-    return RecordCoreMigrationPlan.make(input);
-}
-/** @internal Only migration orchestration may recover converter capabilities. */
-function recordCoreMigrationPlanResolution(plan) {
-    const resolution = corePlanResolutions.get(plan);
-    if (resolution === undefined) {
-        throw new Error("Record Core migration plan is not package-created");
-    }
-    return resolution;
-}
-//# sourceMappingURL=plan.cjs.map

package/dist/record/migration/plan.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["plan.ts"],"names":[],"mappings":";;;AA0DA,kEAKC;AAED,8EAMC;AAvED,mCAAgC;AAEhC,2CAAsI;AAYtI,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,IAAI,OAAO,EAAmB,CAAC;AAC3D;;;GAGG;AACH,MAAa,uBAAuB;IACH;IAA7B,YAA6B,OAAuC;QAAvC,YAAO,GAAP,OAAO,CAAgC;QAChE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,CAAC,IAAI,CAAY,KAGtB;QACG,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,IAAI,UAAU,CAAC,KAAK,KAAK,wBAAwB,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,oCAAoC;gBAC1C,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,EAAE,EAAE,UAAU,CAAC,EAAE;aACpB,CAAC,CAAC;QACP,CAAC;aACI,IAAI,UAAU,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,0CAA0C;gBAChD,MAAM,EAAE,KAAK,CAAC,YAAY;aAC7B,CAAC,CAAC;QACP,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,eAAM,CAAC,IAAI,CAAC,IAAA,0CAA8B,EAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,KAAK,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/F,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAClG,MAAM,IAAI,GAAG,IAAI,uBAAuB,CAAY,MAAM,CAAC,MAAM,CAAC;YAC9D,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa;YAC1C,KAAK;YACL,KAAK,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;SACtD,CAAC,CAAC,CAAC;QACJ,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,OAAO,eAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACJ;AArCD,0DAqCC;AACD,SAAgB,2BAA2B,CAAY,KAGtD;IACG,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AACD,iFAAiF;AACjF,SAAgB,iCAAiC,CAAY,IAAwC;IACjG,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,UAAsD,CAAC;AAClE,CAAC","sourcesContent":["import { Either } from \"effect\";\nimport type { RecordFormatId } from \"../model/identifiers.ts\";\nimport { recordCoreMigrationPlanInvalid, type RecordCoreMigrationPlanInvalid, type RecordCoreMigrationPlanIssue, } from \"./errors.ts\";\nimport { type RecordCoreMigrationRegistry, type RecordCoreMigrationResolution, } from \"./registry.ts\";\nexport interface RecordCoreMigrationPlanStep {\n    readonly from: RecordFormatId;\n    readonly to: RecordFormatId;\n}\nexport interface RecordCoreMigrationPlanSummary {\n    readonly sourceFormat: RecordFormatId;\n    readonly targetFormat: RecordFormatId;\n    readonly steps: readonly RecordCoreMigrationPlanStep[];\n    readonly state: \"needed\" | \"not-needed\";\n}\n/** Runtime execution state never becomes part of a plan's public summary. */\nconst corePlanResolutions = new WeakMap<object, unknown>();\n/**\n * Package-created, pure Core plan. The source snapshot stays opaque to callers\n * so a later execution boundary cannot substitute a different value or path.\n */\nexport class RecordCoreMigrationPlan<CoreValue> {\n    private constructor(readonly summary: RecordCoreMigrationPlanSummary) {\n        Object.freeze(this);\n    }\n    static make<CoreValue>(input: {\n        readonly registry: RecordCoreMigrationRegistry<CoreValue>;\n        readonly sourceFormat: RecordFormatId;\n    }): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid> {\n        const resolution = input.registry.resolve(input.sourceFormat);\n        const issues: RecordCoreMigrationPlanIssue[] = [];\n        if (resolution.state === \"migration-edge-missing\") {\n            issues.push({\n                code: \"record-core-migration-edge-missing\",\n                from: resolution.from,\n                to: resolution.to,\n            });\n        }\n        else if (resolution.state === \"unsupported\") {\n            issues.push({\n                code: \"record-core-migration-source-unsupported\",\n                format: input.sourceFormat,\n            });\n        }\n        if (issues.length > 0) {\n            return Either.left(recordCoreMigrationPlanInvalid(issues));\n        }\n        const edges = resolution.state === \"migration-required\" ? resolution.edges : Object.freeze([]);\n        const steps = Object.freeze(edges.map((edge) => Object.freeze({ from: edge.from, to: edge.to })));\n        const plan = new RecordCoreMigrationPlan<CoreValue>(Object.freeze({\n            sourceFormat: input.sourceFormat,\n            targetFormat: input.registry.currentFormat,\n            steps,\n            state: steps.length === 0 ? \"not-needed\" : \"needed\",\n        }));\n        corePlanResolutions.set(plan, resolution);\n        return Either.right(plan);\n    }\n}\nexport function makeRecordCoreMigrationPlan<CoreValue>(input: {\n    readonly registry: RecordCoreMigrationRegistry<CoreValue>;\n    readonly sourceFormat: RecordFormatId;\n}): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid> {\n    return RecordCoreMigrationPlan.make(input);\n}\n/** @internal Only migration orchestration may recover converter capabilities. */\nexport function recordCoreMigrationPlanResolution<CoreValue>(plan: RecordCoreMigrationPlan<CoreValue>): RecordCoreMigrationResolution<CoreValue> {\n    const resolution = corePlanResolutions.get(plan);\n    if (resolution === undefined) {\n        throw new Error(\"Record Core migration plan is not package-created\");\n    }\n    return resolution as RecordCoreMigrationResolution<CoreValue>;\n}\n"]}

package/dist/record/migration/plan.d.cts

@@ -1,32 +0,0 @@
-import { Either } from "effect";
-import type { RecordFormatId } from "../model/identifiers.cjs";
-import { type RecordCoreMigrationPlanInvalid } from "./errors.cjs";
-import { type RecordCoreMigrationRegistry, type RecordCoreMigrationResolution } from "./registry.cjs";
-export interface RecordCoreMigrationPlanStep {
-    readonly from: RecordFormatId;
-    readonly to: RecordFormatId;
-}
-export interface RecordCoreMigrationPlanSummary {
-    readonly sourceFormat: RecordFormatId;
-    readonly targetFormat: RecordFormatId;
-    readonly steps: readonly RecordCoreMigrationPlanStep[];
-    readonly state: "needed" | "not-needed";
-}
-/**
- * Package-created, pure Core plan. The source snapshot stays opaque to callers
- * so a later execution boundary cannot substitute a different value or path.
- */
-export declare class RecordCoreMigrationPlan<CoreValue> {
-    readonly summary: RecordCoreMigrationPlanSummary;
-    private constructor();
-    static make<CoreValue>(input: {
-        readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-        readonly sourceFormat: RecordFormatId;
-    }): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-}
-export declare function makeRecordCoreMigrationPlan<CoreValue>(input: {
-    readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-    readonly sourceFormat: RecordFormatId;
-}): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-/** @internal Only migration orchestration may recover converter capabilities. */
-export declare function recordCoreMigrationPlanResolution<CoreValue>(plan: RecordCoreMigrationPlan<CoreValue>): RecordCoreMigrationResolution<CoreValue>;

package/dist/record/migration/plan.d.mts

@@ -1,32 +0,0 @@
-import { Either } from "effect";
-import type { RecordFormatId } from "../model/identifiers.mjs";
-import { type RecordCoreMigrationPlanInvalid } from "./errors.mjs";
-import { type RecordCoreMigrationRegistry, type RecordCoreMigrationResolution } from "./registry.mjs";
-export interface RecordCoreMigrationPlanStep {
-    readonly from: RecordFormatId;
-    readonly to: RecordFormatId;
-}
-export interface RecordCoreMigrationPlanSummary {
-    readonly sourceFormat: RecordFormatId;
-    readonly targetFormat: RecordFormatId;
-    readonly steps: readonly RecordCoreMigrationPlanStep[];
-    readonly state: "needed" | "not-needed";
-}
-/**
- * Package-created, pure Core plan. The source snapshot stays opaque to callers
- * so a later execution boundary cannot substitute a different value or path.
- */
-export declare class RecordCoreMigrationPlan<CoreValue> {
-    readonly summary: RecordCoreMigrationPlanSummary;
-    private constructor();
-    static make<CoreValue>(input: {
-        readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-        readonly sourceFormat: RecordFormatId;
-    }): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-}
-export declare function makeRecordCoreMigrationPlan<CoreValue>(input: {
-    readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-    readonly sourceFormat: RecordFormatId;
-}): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-/** @internal Only migration orchestration may recover converter capabilities. */
-export declare function recordCoreMigrationPlanResolution<CoreValue>(plan: RecordCoreMigrationPlan<CoreValue>): RecordCoreMigrationResolution<CoreValue>;

package/dist/record/migration/plan.d.ts

@@ -1,32 +0,0 @@
-import { Either } from "effect";
-import type { RecordFormatId } from "../model/identifiers.js";
-import { type RecordCoreMigrationPlanInvalid } from "./errors.js";
-import { type RecordCoreMigrationRegistry, type RecordCoreMigrationResolution } from "./registry.js";
-export interface RecordCoreMigrationPlanStep {
-    readonly from: RecordFormatId;
-    readonly to: RecordFormatId;
-}
-export interface RecordCoreMigrationPlanSummary {
-    readonly sourceFormat: RecordFormatId;
-    readonly targetFormat: RecordFormatId;
-    readonly steps: readonly RecordCoreMigrationPlanStep[];
-    readonly state: "needed" | "not-needed";
-}
-/**
- * Package-created, pure Core plan. The source snapshot stays opaque to callers
- * so a later execution boundary cannot substitute a different value or path.
- */
-export declare class RecordCoreMigrationPlan<CoreValue> {
-    readonly summary: RecordCoreMigrationPlanSummary;
-    private constructor();
-    static make<CoreValue>(input: {
-        readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-        readonly sourceFormat: RecordFormatId;
-    }): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-}
-export declare function makeRecordCoreMigrationPlan<CoreValue>(input: {
-    readonly registry: RecordCoreMigrationRegistry<CoreValue>;
-    readonly sourceFormat: RecordFormatId;
-}): Either.Either<RecordCoreMigrationPlan<CoreValue>, RecordCoreMigrationPlanInvalid>;
-/** @internal Only migration orchestration may recover converter capabilities. */
-export declare function recordCoreMigrationPlanResolution<CoreValue>(plan: RecordCoreMigrationPlan<CoreValue>): RecordCoreMigrationResolution<CoreValue>;

package/dist/record/migration/plan.js

@@ -1,10 +0,0 @@
-import { createRequire as __niceevalCreateRequire } from "node:module";
-const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
-const __niceevalCanonical = __niceevalRequire("./plan.cjs");
-const __niceevalExport0 = __niceevalCanonical["RecordCoreMigrationPlan"];
-export { __niceevalExport0 as RecordCoreMigrationPlan };
-const __niceevalExport1 = __niceevalCanonical["makeRecordCoreMigrationPlan"];
-export { __niceevalExport1 as makeRecordCoreMigrationPlan };
-const __niceevalExport2 = __niceevalCanonical["recordCoreMigrationPlanResolution"];
-export { __niceevalExport2 as recordCoreMigrationPlanResolution };
-//# sourceMappingURL=plan.js.map

package/dist/record/migration/plan.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plan.js","sources":[],"names":[],"mappings":""}

package/dist/record/migration/registry.cjs

@@ -1,150 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecordMigrationRegistry = exports.CurrentRecordCoreMigrationRegistry = exports.RecordCoreMigrationRegistry = void 0;
-exports.makeRecordCoreMigrationRegistry = makeRecordCoreMigrationRegistry;
-exports.makeCurrentRecordMigrationRegistry = makeCurrentRecordMigrationRegistry;
-const effect_1 = require("effect");
-const core_ts_1 = require("../codec/core.cjs");
-const identifiers_ts_1 = require("../codec/identifiers.cjs");
-const identifiers_ts_2 = require("../model/identifiers.cjs");
-const identity_ts_1 = require("./identity.cjs");
-const errors_ts_1 = require("./errors.cjs");
-const storage_ts_1 = require("./storage.cjs");
-function freezeArray(items) {
-    return Object.freeze([...items]);
-}
-/**
- * Pure Core-major graph. It does not claim future formats exist: v1 can be the
- * current format with an empty edge list. When future formats are registered,
- * every edge remains one major wide and the graph remains unbranched.
- */
-class RecordCoreMigrationRegistry {
-    currentFormat;
-    #edgesByFrom;
-    constructor(currentFormat, edgesByFrom) {
-        this.currentFormat = currentFormat;
-        this.#edgesByFrom = edgesByFrom;
-        Object.freeze(this);
-    }
-    static make(input) {
-        const issues = [];
-        const currentMajor = (0, identity_ts_1.recordFormatMajor)(input.currentFormat);
-        if (currentMajor === undefined) {
-            issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)("record-core-migration-edge-invalid", [
-                "currentFormat",
-            ]));
-        }
-        const byFrom = new Map();
-        const byTo = new Map();
-        for (const [index, edge] of input.edges.entries()) {
-            const path = ["edges", String(index)];
-            if (!(0, identity_ts_1.areAdjacentRecordFormats)(edge.from, edge.to)) {
-                issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)("record-core-migration-edge-invalid", path));
-                continue;
-            }
-            const targetMajor = (0, identity_ts_1.recordFormatMajor)(edge.to);
-            if (targetMajor === undefined || currentMajor === undefined || targetMajor > currentMajor) {
-                issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)("record-core-migration-edge-invalid", path));
-                continue;
-            }
-            if (typeof edge.convert !== "function") {
-                issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)("record-core-migration-edge-invalid", [
-                    ...path,
-                    "convert",
-                ]));
-                continue;
-            }
-            const normalized = Object.freeze({
-                from: edge.from,
-                to: edge.to,
-                convert: edge.convert,
-            });
-            const previousFrom = byFrom.get(normalized.from);
-            if (previousFrom !== undefined) {
-                issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)(previousFrom.to === normalized.to
-                    ? "record-core-migration-edge-duplicate"
-                    : "record-core-migration-edge-fork", path));
-                continue;
-            }
-            if (byTo.has(normalized.to)) {
-                issues.push((0, errors_ts_1.recordCoreMigrationRegistryIssue)("record-core-migration-edge-fork", path));
-                continue;
-            }
-            byFrom.set(normalized.from, normalized);
-            byTo.set(normalized.to, normalized);
-        }
-        if (issues.length > 0) {
-            return effect_1.Either.left((0, errors_ts_1.recordCoreMigrationRegistryInvalid)(issues));
-        }
-        return effect_1.Either.right(new RecordCoreMigrationRegistry(input.currentFormat, byFrom));
-    }
-    resolve(from) {
-        if (from === this.currentFormat) {
-            return Object.freeze({ state: "current" });
-        }
-        const sourceMajor = (0, identity_ts_1.recordFormatMajor)(from);
-        const targetMajor = (0, identity_ts_1.recordFormatMajor)(this.currentFormat);
-        if (sourceMajor === undefined ||
-            targetMajor === undefined ||
-            sourceMajor >= targetMajor) {
-            return Object.freeze({ state: "unsupported" });
-        }
-        const edges = [];
-        let current = from;
-        while (current !== this.currentFormat) {
-            const edge = this.#edgesByFrom.get(current);
-            if (edge === undefined) {
-                return Object.freeze({
-                    state: "migration-edge-missing",
-                    from: current,
-                    to: this.currentFormat,
-                });
-            }
-            edges.push(edge);
-            current = edge.to;
-        }
-        return Object.freeze({
-            state: "migration-required",
-            edges: freezeArray(edges),
-        });
-    }
-}
-exports.RecordCoreMigrationRegistry = RecordCoreMigrationRegistry;
-function makeRecordCoreMigrationRegistry(input) {
-    return RecordCoreMigrationRegistry.make(input);
-}
-/**
- * Today's installed Core is v1. Its registry deliberately has no imaginary
- * future converters; later releases add adjacent edges only when their formats
- * are actually introduced.
- */
-exports.CurrentRecordCoreMigrationRegistry = (() => {
-    const currentFormat = effect_1.Schema.decodeUnknownEither(identifiers_ts_1.RecordFormatIdSchema, core_ts_1.RecordExactParseOptions)(identifiers_ts_2.RECORD_FORMAT_V1);
-    if (effect_1.Either.isLeft(currentFormat)) {
-        throw new Error("The built-in Record v1 format identity is invalid");
-    }
-    const built = RecordCoreMigrationRegistry.make({
-        currentFormat: currentFormat.right,
-        edges: [],
-    });
-    if (effect_1.Either.isLeft(built)) {
-        throw new Error("The built-in Record v1 migration registry is invalid");
-    }
-    return built.right;
-})();
-class RecordMigrationRegistry extends effect_1.Context.Tag("@niceeval/record/RecordMigrationRegistry")() {
-}
-exports.RecordMigrationRegistry = RecordMigrationRegistry;
-/**
- * Compose today's concrete v1 storage with the Attachment families selected
- * by the application. The public plan/run API never asks callers to pass the
- * three internals individually.
- */
-function makeCurrentRecordMigrationRegistry(input) {
-    return Object.freeze({
-        core: exports.CurrentRecordCoreMigrationRegistry,
-        attachments: input.attachments,
-        storage: storage_ts_1.CurrentRecordMigrationStorage,
-    });
-}
-//# sourceMappingURL=registry.cjs.map

package/dist/record/migration/registry.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { Context, Either, Schema } from \"effect\";\nimport type { RecordAttachmentRegistry } from \"../attachment/types.ts\";\nimport { RecordExactParseOptions } from \"../codec/core.ts\";\nimport { RecordFormatIdSchema } from \"../codec/identifiers.ts\";\nimport type { RecordCoreV1 } from \"../model/core.ts\";\nimport type { RecordFormatId } from \"../model/identifiers.ts\";\nimport { RECORD_FORMAT_V1 } from \"../model/identifiers.ts\";\nimport { areAdjacentRecordFormats, recordFormatMajor, } from \"./identity.ts\";\nimport { recordCoreMigrationRegistryInvalid, recordCoreMigrationRegistryIssue, type RecordCoreMigrationRegistryInvalid, type RecordCoreMigrationRegistryIssue, } from \"./errors.ts\";\nimport type { RecordCoreMigrationEdge, RecordCoreMigrationRegistryInput, } from \"./types.ts\";\nimport type { RecordMigrationStorage } from \"./internal.ts\";\nimport { CurrentRecordMigrationStorage } from \"./storage.ts\";\nexport type RecordCoreMigrationResolution<CoreValue> = {\n    readonly state: \"current\";\n} | {\n    readonly state: \"migration-required\";\n    readonly edges: readonly RecordCoreMigrationEdge<CoreValue>[];\n} | {\n    readonly state: \"migration-edge-missing\";\n    readonly from: RecordFormatId;\n    readonly to: RecordFormatId;\n} | {\n    readonly state: \"unsupported\";\n};\nfunction freezeArray<Value>(items: readonly Value[]): readonly Value[] {\n    return Object.freeze([...items]);\n}\n/**\n * Pure Core-major graph. It does not claim future formats exist: v1 can be the\n * current format with an empty edge list. When future formats are registered,\n * every edge remains one major wide and the graph remains unbranched.\n */\nexport class RecordCoreMigrationRegistry<CoreValue> {\n    readonly #edgesByFrom: ReadonlyMap<string, RecordCoreMigrationEdge<CoreValue>>;\n    private constructor(readonly currentFormat: RecordFormatId, edgesByFrom: ReadonlyMap<string, RecordCoreMigrationEdge<CoreValue>>) {\n        this.#edgesByFrom = edgesByFrom;\n        Object.freeze(this);\n    }\n    static make<CoreValue>(input: RecordCoreMigrationRegistryInput<CoreValue>): Either.Either<RecordCoreMigrationRegistry<CoreValue>, RecordCoreMigrationRegistryInvalid> {\n        const issues: RecordCoreMigrationRegistryIssue[] = [];\n        const currentMajor = recordFormatMajor(input.currentFormat);\n        if (currentMajor === undefined) {\n            issues.push(recordCoreMigrationRegistryIssue(\"record-core-migration-edge-invalid\", [\n                \"currentFormat\",\n            ]));\n        }\n        const byFrom = new Map<string, RecordCoreMigrationEdge<CoreValue>>();\n        const byTo = new Map<string, RecordCoreMigrationEdge<CoreValue>>();\n        for (const [index, edge] of input.edges.entries()) {\n            const path = [\"edges\", String(index)];\n            if (!areAdjacentRecordFormats(edge.from, edge.to)) {\n                issues.push(recordCoreMigrationRegistryIssue(\"record-core-migration-edge-invalid\", path));\n                continue;\n            }\n            const targetMajor = recordFormatMajor(edge.to);\n            if (targetMajor === undefined || currentMajor === undefined || targetMajor > currentMajor) {\n                issues.push(recordCoreMigrationRegistryIssue(\"record-core-migration-edge-invalid\", path));\n                continue;\n            }\n            if (typeof edge.convert !== \"function\") {\n                issues.push(recordCoreMigrationRegistryIssue(\"record-core-migration-edge-invalid\", [\n                    ...path,\n                    \"convert\",\n                ]));\n                continue;\n            }\n            const normalized = Object.freeze({\n                from: edge.from,\n                to: edge.to,\n                convert: edge.convert,\n            });\n            const previousFrom = byFrom.get(normalized.from);\n            if (previousFrom !== undefined) {\n                issues.push(recordCoreMigrationRegistryIssue(previousFrom.to === normalized.to\n                    ? \"record-core-migration-edge-duplicate\"\n                    : \"record-core-migration-edge-fork\", path));\n                continue;\n            }\n            if (byTo.has(normalized.to)) {\n                issues.push(recordCoreMigrationRegistryIssue(\"record-core-migration-edge-fork\", path));\n                continue;\n            }\n            byFrom.set(normalized.from, normalized);\n            byTo.set(normalized.to, normalized);\n        }\n        if (issues.length > 0) {\n            return Either.left(recordCoreMigrationRegistryInvalid(issues));\n        }\n        return Either.right(new RecordCoreMigrationRegistry(input.currentFormat, byFrom));\n    }\n    resolve(from: RecordFormatId): RecordCoreMigrationResolution<CoreValue> {\n        if (from === this.currentFormat) {\n            return Object.freeze({ state: \"current\" });\n        }\n        const sourceMajor = recordFormatMajor(from);\n        const targetMajor = recordFormatMajor(this.currentFormat);\n        if (sourceMajor === undefined ||\n            targetMajor === undefined ||\n            sourceMajor >= targetMajor) {\n            return Object.freeze({ state: \"unsupported\" });\n        }\n        const edges: RecordCoreMigrationEdge<CoreValue>[] = [];\n        let current = from;\n        while (current !== this.currentFormat) {\n            const edge = this.#edgesByFrom.get(current);\n            if (edge === undefined) {\n                return Object.freeze({\n                    state: \"migration-edge-missing\",\n                    from: current,\n                    to: this.currentFormat,\n                });\n            }\n            edges.push(edge);\n            current = edge.to;\n        }\n        return Object.freeze({\n            state: \"migration-required\",\n            edges: freezeArray(edges),\n        });\n    }\n}\nexport function makeRecordCoreMigrationRegistry<CoreValue>(input: RecordCoreMigrationRegistryInput<CoreValue>): Either.Either<RecordCoreMigrationRegistry<CoreValue>, RecordCoreMigrationRegistryInvalid> {\n    return RecordCoreMigrationRegistry.make(input);\n}\n/**\n * Today's installed Core is v1. Its registry deliberately has no imaginary\n * future converters; later releases add adjacent edges only when their formats\n * are actually introduced.\n */\nexport const CurrentRecordCoreMigrationRegistry: RecordCoreMigrationRegistry<RecordCoreV1> = (() => {\n    const currentFormat = Schema.decodeUnknownEither(RecordFormatIdSchema, RecordExactParseOptions)(RECORD_FORMAT_V1);\n    if (Either.isLeft(currentFormat)) {\n        throw new Error(\"The built-in Record v1 format identity is invalid\");\n    }\n    const built = RecordCoreMigrationRegistry.make<RecordCoreV1>({\n        currentFormat: currentFormat.right,\n        edges: [],\n    });\n    if (Either.isLeft(built)) {\n        throw new Error(\"The built-in Record v1 migration registry is invalid\");\n    }\n    return built.right;\n})();\n/**\n * Installed migration capabilities live at the application composition edge.\n * Public plan/run calls only name a Record root; the current Core registry,\n * selected Attachment families, and current-layout storage stay behind this\n * Effect service.\n */\nexport interface RecordMigrationRegistryService {\n    readonly core: RecordCoreMigrationRegistry<RecordCoreV1>;\n    readonly attachments: RecordAttachmentRegistry;\n    readonly storage: RecordMigrationStorage<RecordCoreV1>;\n}\nexport class RecordMigrationRegistry extends Context.Tag(\"@niceeval/record/RecordMigrationRegistry\")<RecordMigrationRegistry, RecordMigrationRegistryService>() {\n}\n/**\n * Compose today's concrete v1 storage with the Attachment families selected\n * by the application. The public plan/run API never asks callers to pass the\n * three internals individually.\n */\nexport function makeCurrentRecordMigrationRegistry(input: {\n    readonly attachments: RecordAttachmentRegistry;\n}): RecordMigrationRegistryService {\n    return Object.freeze({\n        core: CurrentRecordCoreMigrationRegistry,\n        attachments: input.attachments,\n        storage: CurrentRecordMigrationStorage,\n    });\n}\n"]}