agl 21.0.2 → 22.0.0

package/dist_ts_migration/v23_runtimeconfig.d.ts

@@ -0,0 +1,11 @@
+import * as plugins from '../dist_ts/plugins.js';
+import { type IControllerAuthDocument } from '../dist_ts/interfaces.auth.js';
+export declare const migrateV23RuntimeConfigDocument: (valueArg: Record<string, unknown>) => {
+    document: IControllerAuthDocument;
+    migrated: boolean;
+};
+export declare class RuntimeConfigV23Migration {
+    private readonly database;
+    constructor(database: plugins.smartdata.SmartdataDb | undefined);
+    run(): Promise<void>;
+}

package/dist_ts_migration/v23_runtimeconfig.js

@@ -0,0 +1,87 @@
+import * as plugins from '../dist_ts/plugins.js';
+import { assertControllerAuthDocument, ControllerAuthModel, } from '../dist_ts/classes.authmodels.js';
+import { AuthError } from '../dist_ts/interfaces.auth.js';
+const migrationPageLimit = 128;
+const assertRuntimeConfigDocument = assertControllerAuthDocument;
+const persistedBodyFromRawDocument = (valueArg) => {
+    const body = { ...valueArg };
+    delete body._id;
+    delete body._smartdataRevision;
+    return body;
+};
+const isAbsoluteNormalizedPath = (valueArg) => (typeof valueArg === 'string'
+    && valueArg.length > 0
+    && plugins.path.isAbsolute(valueArg)
+    && plugins.path.normalize(valueArg) === valueArg);
+export const migrateV23RuntimeConfigDocument = (valueArg) => {
+    const config = valueArg.config;
+    if (!config || typeof config !== 'object' || Array.isArray(config)) {
+        throw new Error('Invalid legacy controller runtime configuration.');
+    }
+    const configRecord = config;
+    if (!Object.hasOwn(configRecord, 'workspaceDirectory')) {
+        assertRuntimeConfigDocument(valueArg);
+        return { document: valueArg, migrated: false };
+    }
+    if (!isAbsoluteNormalizedPath(configRecord.workspaceDirectory)) {
+        throw new Error('Legacy controller workspace is not an absolute normalized path.');
+    }
+    const projectsRoot = Object.hasOwn(configRecord, 'projectsRoot')
+        ? configRecord.projectsRoot
+        : configRecord.workspaceDirectory;
+    if (!isAbsoluteNormalizedPath(projectsRoot)) {
+        throw new Error('Legacy controller projects root is not an absolute normalized path.');
+    }
+    const migratedConfig = { ...configRecord, projectsRoot };
+    delete migratedConfig.workspaceDirectory;
+    const migrated = { ...valueArg, config: migratedConfig };
+    assertRuntimeConfigDocument(migrated);
+    return { document: migrated, migrated: true };
+};
+export class RuntimeConfigV23Migration {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    async run() {
+        if (!this.database) {
+            throw new AuthError('not_initialized', 'The authentication store database is unavailable.');
+        }
+        const collection = ControllerAuthModel.collection.mongoDbCollection;
+        let lastId;
+        while (true) {
+            const cursor = collection.find(lastId ? { _id: { $gt: lastId } } : {}).sort({ _id: 1 }).limit(migrationPageLimit);
+            let documents;
+            try {
+                documents = await cursor.toArray();
+            }
+            finally {
+                await cursor.close();
+            }
+            for (const raw of documents) {
+                const migration = migrateV23RuntimeConfigDocument(persistedBodyFromRawDocument(raw));
+                if (!migration.migrated)
+                    continue;
+                const selector = raw._smartdataRevision === undefined
+                    ? { _id: raw._id, _smartdataRevision: { $exists: false } }
+                    : { _id: raw._id, _smartdataRevision: raw._smartdataRevision };
+                const replaced = await collection.findOneAndReplace(selector, { _id: raw._id, ...migration.document, _smartdataRevision: plugins.crypto.randomUUID() }, { returnDocument: 'after', includeResultMetadata: false, upsert: false });
+                if (replaced)
+                    continue;
+                const concurrent = await collection.findOne({ _id: raw._id });
+                if (!concurrent) {
+                    throw new AuthError('concurrent_change', 'The runtime configuration migration changed concurrently.');
+                }
+                const reconciled = migrateV23RuntimeConfigDocument(persistedBodyFromRawDocument(concurrent));
+                if (reconciled.migrated) {
+                    throw new AuthError('concurrent_change', 'The runtime configuration migration changed concurrently.');
+                }
+            }
+            const last = documents.at(-1);
+            if (!last || documents.length < migrationPageLimit)
+                break;
+            lastId = last._id;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidjIzX3J1bnRpbWVjb25maWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19taWdyYXRpb24vdjIzX3J1bnRpbWVjb25maWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEVBQ0wsNEJBQTRCLEVBQzVCLG1CQUFtQixHQUNwQixNQUFNLDZCQUE2QixDQUFDO0FBQ3JDLE9BQU8sRUFBRSxTQUFTLEVBQWdDLE1BQU0sMEJBQTBCLENBQUM7QUFFbkYsTUFBTSxrQkFBa0IsR0FBRyxHQUFHLENBQUM7QUFDL0IsTUFBTSwyQkFBMkIsR0FFa0IsNEJBQTRCLENBQUM7QUFFaEYsTUFBTSw0QkFBNEIsR0FBRyxDQUNuQyxRQUFpQyxFQUNSLEVBQUU7SUFDM0IsTUFBTSxJQUFJLEdBQUcsRUFBRSxHQUFHLFFBQVEsRUFBRSxDQUFDO0lBQzdCLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQztJQUNoQixPQUFPLElBQUksQ0FBQyxrQkFBa0IsQ0FBQztJQUMvQixPQUFPLElBQUksQ0FBQztBQUNkLENBQUMsQ0FBQztBQUVGLE1BQU0sd0JBQXdCLEdBQUcsQ0FBQyxRQUFpQixFQUFzQixFQUFFLENBQUMsQ0FDMUUsT0FBTyxRQUFRLEtBQUssUUFBUTtPQUN6QixRQUFRLENBQUMsTUFBTSxHQUFHLENBQUM7T0FDbkIsT0FBTyxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDO09BQ2pDLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxLQUFLLFFBQVEsQ0FDakQsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLENBQzdDLFFBQWlDLEVBQ3lCLEVBQUU7SUFDNUQsTUFBTSxNQUFNLEdBQUcsUUFBUSxDQUFDLE1BQU0sQ0FBQztJQUMvQixJQUFJLENBQUMsTUFBTSxJQUFJLE9BQU8sTUFBTSxLQUFLLFFBQVEsSUFB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

package/dist_ts_migration/v2_controllerdataroot.d.ts

@@ -58,6 +58,7 @@ export interface IControllerDataRootMigrationOptions {
     newEmbeddedSocketPath: string;
     invokerPid: number;
     listDataWriterProcesses: () => Promise<readonly IControllerDataWriterProcessRecord[]>;
+    preserveEmbeddedDataDirectory?: boolean;
     isSocketListening?: (socketPathArg: string) => Promise<boolean>;
     relocateCredentialStore?: (intentArg: Readonly<IControllerCredentialRelocationIntent>, signalArg?: AbortSignal) => Promise<void>;
     relocateStoppedDatabaseRoot?: (inputArg: Readonly<plugins.smartdb.ILocalSmartDbStoppedStorageRootRelocationInput>, signalArg?: AbortSignal) => Promise<plugins.smartdb.ILocalSmartDbStoppedStorageRootRelocationReceipt>;
@@ -85,6 +86,8 @@ export declare class ControllerDataRootMigrationRunner {
     private readonly relocateStoppedDatabaseRoot;
     constructor(options: IControllerDataRootMigrationOptions);
     prepareStartup(): Promise<IControllerDataRootStartupPreparation>;
+    /** Validates all authoritative v2 state without creating roots, locks, or journals. */
+    preflight(): Promise<void>;
     run(): Promise<IControllerDataRootMigrationResult>;
     private normalizeDatabaseConfiguration;
     private validateCommonParent;
@@ -99,6 +102,8 @@ export declare class ControllerDataRootMigrationRunner {
     private assertTargetMarker;
     private runLocked;
     private result;
+    private preservedTargetDatabasePath;
+    private targetContainsOnlyPreservedDatabase;
     private assertNoConflictingWriters;
     private createInitialJournal;
     private readBoundedDirectory;