@nocobase/app-installer 0.0.0-stage → 0.1.0-beta.4

package/dist/commands/install.js

@@ -0,0 +1,319 @@
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { runAppCli } from "../lib/app-cli.js";
+import { switchCurrent } from "../lib/current-link.js";
+import { buildEcosystemConfig, buildLauncher } from "../lib/ecosystem.js";
+import { quoteForShell } from '@nocobase/cli-envelope';
+import { buildAppEnv, endpointsOf, healthUrl, mountPathOf, readAppEnv, } from "../lib/env-file.js";
+import { EXIT_INVALID, InstallerError } from "../lib/errors.js";
+import { pm2StartFailed, waitForHealthy } from "../lib/health.js";
+import { readInitialAdmin } from "../lib/initial-admin.js";
+import { layoutOf, releaseLinkTarget } from "../lib/layout.js";
+import { acquireLock } from "../lib/lock.js";
+import { assertFixedMountPath, parseBasePathFlag } from "../lib/mount-path.js";
+import { checkEnvVariables, checkPlatform, checkPm2, checkPm2NameFree, checkPortFree, checkTargetEmpty, } from "../lib/prechecks.js";
+import { defaultRegistry, normalizeRegistry, } from "../lib/registry.js";
+import { DIALECTS, assertStorageOutsideRelease, checkArchiveDriver, unpackRelease, } from "../lib/release.js";
+import { runCommand } from "../lib/run-command.js";
+import { errorLogCommandLine, errorLogTail, startAdvice, } from "../lib/service.js";
+import { resolveArchivePath } from "../lib/source.js";
+import { writeState } from "../lib/state.js";
+export const INSTALL_ARGS = {
+    directory: Args.string({
+        description: 'Directory to install into. Must be new or empty. --dir names it too.',
+    }),
+};
+export const INSTALL_FLAGS = {
+    dir: Flags.string({
+        description: 'Directory to install into, as the other commands name it; the same as the DIRECTORY argument.',
+    }),
+    archive: Flags.string({
+        description: 'Deployment archive to install, as `pnpm build --tar` writes it to storage/exports/dist.tar.gz. Build it for this machine with --target and --node-version.',
+    }),
+    origin: Flags.string({
+        description: 'Public origin the application is reached at, without its base path, e.g. https://apps.example.com. Defaults to http://HOST:PORT.',
+    }),
+    'base-path': Flags.string({
+        description: "Path the application is mounted at, e.g. /crm, or / for the origin root. Written to app.env as APP_BASE_PATH; without it the server's default applies. An archive from before relocatable builds runs only at the path it was built for.",
+    }),
+    host: Flags.string({
+        default: '127.0.0.1',
+        description: 'Address the application listens on. Keep the loopback default behind a reverse proxy.',
+    }),
+    port: Flags.integer({
+        default: 13000,
+        min: 1,
+        max: 65535,
+        description: 'Port the application listens on. It must be free; give each installation on a machine its own.',
+    }),
+    dialect: Flags.string({
+        default: 'sqlite',
+        options: [...DIALECTS],
+        description: 'Database. Anything but SQLite needs --set for its connection; an archive must carry its driver.',
+    }),
+    set: Flags.string({
+        multiple: true,
+        description: 'A config.yml setting as key=value, applied with `nocobase config set`, e.g. database.connections.main.host=db.internal. Values are YAML scalars: quote text that looks like a number or boolean, as in key=\'"0123"\'.',
+    }),
+    'set-from-env': Flags.string({
+        multiple: true,
+        description: 'A setting read from an environment variable, as key=VARIABLE, e.g. database.connections.main.password=DB_PASSWORD.',
+    }),
+    registry: Flags.string({
+        description: 'npm registry for the installer commands suggested later.',
+    }),
+    name: Flags.string({
+        description: 'pm2 process name. Defaults to nocobase- followed by the directory name, so each installation on a machine has its own.',
+    }),
+    start: Flags.boolean({
+        allowNo: true,
+        default: true,
+        description: 'Start the application with pm2 once it is installed.',
+    }),
+    'health-timeout': Flags.integer({
+        default: 180,
+        min: 1,
+        description: 'Seconds to wait for the application to answer its health check.',
+    }),
+    json: Flags.boolean({
+        default: false,
+        description: 'Print one JSON result on stdout; progress stays on stderr.',
+    }),
+};
+function parsePairs(values, flag) {
+    return (values ?? []).map((value) => {
+        const index = value.indexOf('=');
+        if (index <= 0 || index === value.length - 1) {
+            throw new InstallerError('INVALID_USAGE', `--${flag} expects key=value, got "${value}".`, { exitCode: EXIT_INVALID });
+        }
+        return [value.slice(0, index), value.slice(index + 1)];
+    });
+}
+/** The sign-in line of the summary: who, and where the password is, never the password itself. */
+function describeInitialAdmin(admin) {
+    const who = [admin.username, admin.email && `(${admin.email})`]
+        .filter(Boolean)
+        .join(' ') || 'the account';
+    const password = admin.defaultPassword === true
+        ? `the default password from config.example.yml; change it after signing in`
+        : 'the password set there';
+    return `${who} under ${admin.key} in config.yml, with ${password}`;
+}
+/**
+ * Removes what a failed install wrote. The target was new or empty when the install began, so everything in it now
+ * came from this run. `created` is the topmost directory the install created, which may be a parent of the root.
+ */
+async function cleanUp(root, created) {
+    if (created) {
+        await rm(created, { recursive: true, force: true });
+        return;
+    }
+    for (const entry of await readdir(root).catch(() => [])) {
+        await rm(path.join(root, entry), { recursive: true, force: true });
+    }
+}
+export async function install(input, deps) {
+    const { flags } = input;
+    const { reporter, pm2 } = deps;
+    const run = deps.run ?? runCommand;
+    const cwd = deps.cwd ?? process.cwd();
+    const directory = input.directory ?? flags.dir;
+    if (directory === undefined) {
+        throw new InstallerError('INVALID_USAGE', 'Name the directory to install into, as an argument or with --dir.', { exitCode: EXIT_INVALID });
+    }
+    if (input.directory !== undefined &&
+        flags.dir !== undefined &&
+        path.resolve(cwd, input.directory) !== path.resolve(cwd, flags.dir)) {
+        throw new InstallerError('INVALID_USAGE', `The DIRECTORY argument (${input.directory}) and --dir (${flags.dir}) name different directories; give one of them.`, { exitCode: EXIT_INVALID });
+    }
+    if (flags.archive === undefined) {
+        throw new InstallerError('INVALID_USAGE', 'Name what to install: --archive with a deployment archive built by `pnpm build --tar`.', { exitCode: EXIT_INVALID });
+    }
+    const requestedBasePath = parseBasePathFlag(flags['base-path']);
+    const root = path.resolve(cwd, directory);
+    const layout = layoutOf(root);
+    const name = flags.name ?? `nocobase-${path.basename(root)}`;
+    const dialect = flags.dialect;
+    const registry = normalizeRegistry(flags.registry ?? defaultRegistry());
+    const origin = (flags.origin ?? `http://${flags.host}:${flags.port}`).replace(/\/+$/u, '');
+    const sets = parsePairs(flags.set, 'set');
+    const setsFromEnv = parsePairs(flags['set-from-env'], 'set-from-env');
+    if (!/^https?:\/\/[^/]+$/u.test(origin)) {
+        throw new InstallerError('INVALID_USAGE', `--origin must be a protocol and host without a path, such as https://apps.example.com; got "${origin}".`, { exitCode: EXIT_INVALID });
+    }
+    // Everything that can be checked is checked before the first write, so a failed precheck leaves nothing behind.
+    checkPlatform();
+    await checkTargetEmpty(root);
+    checkEnvVariables(setsFromEnv.map(([, variable]) => variable));
+    const archive = resolveArchivePath(cwd, flags.archive);
+    if (flags.start) {
+        await checkPm2(pm2);
+        await checkPm2NameFree(pm2, name);
+    }
+    await checkPortFree(flags.host, flags.port, { suggestPort: true });
+    if (!flags.origin) {
+        reporter.warn(`No --origin given; the application will build links for ${origin}. Pass --origin with the public address before exposing it.`);
+    }
+    // `mkdir` returns the first directory it created, so a failure can remove parents the install made as well.
+    const created = await mkdir(root, { recursive: true });
+    let releaseLock;
+    try {
+        releaseLock = await acquireLock(layout.lockFile);
+    }
+    catch (error) {
+        if (created)
+            await rm(created, { recursive: true, force: true });
+        throw error;
+    }
+    let switched = false;
+    try {
+        reporter.progress(`Unpacking ${archive} into ${root}`);
+        const prepared = await unpackRelease({ layout, archive });
+        checkArchiveDriver(prepared.dir, dialect);
+        reporter.progress(`Installing ${prepared.appName} ${prepared.version} (${prepared.id})`);
+        // A relocatable release is mounted where the installation says, or at the server's default. An earlier release
+        // runs only at the path its client was compiled for.
+        let mountPath;
+        if (prepared.relocatable) {
+            mountPath = requestedBasePath;
+        }
+        else {
+            mountPath = prepared.basePath;
+            if (requestedBasePath !== undefined) {
+                assertFixedMountPath(`${prepared.appName} ${prepared.version}`, mountPath, requestedBasePath);
+            }
+        }
+        await writeFile(layout.appEnv, buildAppEnv(layout, {
+            origin,
+            host: flags.host,
+            port: flags.port,
+            basePath: mountPath,
+        }));
+        const env = await readAppEnv(layout);
+        const cli = { releaseDir: prepared.dir, cwd: root, env, run };
+        reporter.progress('Writing config.yml');
+        await runAppCli(['config', 'init', '--config', layout.configFile, '--dialect', dialect], cli);
+        if (sets.length > 0) {
+            await runAppCli(['config', 'set', ...sets.map(([key, value]) => `${key}=${value}`)], cli);
+        }
+        for (const [key, variable] of setsFromEnv) {
+            await runAppCli(['config', 'set', '--from-env', `${key}=${variable}`], cli);
+        }
+        await runAppCli(['config', 'check'], cli);
+        reporter.progress('Applying database migrations');
+        await runAppCli(['db', 'apply'], cli);
+        assertStorageOutsideRelease(prepared.dir);
+        // Everything else the root needs is written first: the switch is the last write before starting, so a failure
+        // anywhere up to it leaves nothing half-installed for status and install to disagree about.
+        await mkdir(layout.logsDir, { recursive: true });
+        await writeFile(layout.ecosystemFile, buildEcosystemConfig({ name, nodePath: process.execPath }));
+        await writeFile(layout.launcherFile, buildLauncher());
+        const at = new Date().toISOString();
+        const state = {
+            schemaVersion: 1,
+            appName: prepared.appName,
+            basePath: mountPathOf(env) || '/',
+            source: { kind: 'archive' },
+            name,
+            registry,
+            dialect,
+            current: prepared.id,
+            releases: [
+                {
+                    id: prepared.id,
+                    version: prepared.version,
+                    builtAt: prepared.builtAt,
+                    installedAt: at,
+                    buildTarget: prepared.buildTarget,
+                    ...(prepared.relocatable
+                        ? { relocatable: true }
+                        : { basePath: prepared.basePath }),
+                },
+            ],
+            history: [{ action: 'install', to: prepared.id, at }],
+        };
+        await writeState(layout, state);
+        await switchCurrent(layout, releaseLinkTarget(prepared.id));
+        switched = true;
+        const url = healthUrl(env);
+        if (flags.start) {
+            reporter.progress('Starting the application with pm2');
+            await pm2.start(layout.ecosystemFile, root);
+            const healthy = await waitForHealthy(url, {
+                timeoutMs: flags['health-timeout'] * 1000,
+                fetchImpl: deps.fetchImpl,
+                failed: pm2StartFailed(pm2, name),
+            });
+            if (!healthy) {
+                // The name was free before this install, so the process under it is the one just started.
+                await pm2.remove(name).catch(() => undefined);
+                throw new InstallerError('START_FAILED', `The application did not become healthy at ${url} (waited up to ${flags['health-timeout']}s). It is installed but not running.`, {
+                    details: { log: await errorLogTail(layout) },
+                    suggestions: [
+                        {
+                            message: 'Read the error log:',
+                            run: errorLogCommandLine(layout),
+                        },
+                        ...startAdvice(layout, 'Start it again once fixed:'),
+                    ],
+                });
+            }
+            await pm2.save();
+        }
+        const endpoints = endpointsOf(env);
+        const initialAdmin = await readInitialAdmin(layout.configFile, path.join(prepared.dir, 'config.example.yml'));
+        // `nextCommands` are lines for a shell, as the application CLI's are, so one may chain two commands.
+        const startCommand = `pm2 start ${quoteForShell(layout.ecosystemFile)} && pm2 save`;
+        const nextCommands = [
+            ...(flags.start ? [] : [startCommand]),
+            'pm2 startup',
+        ];
+        return {
+            status: 'success',
+            result: {
+                directory: root,
+                version: prepared.version,
+                releaseId: prepared.id,
+                builtAt: prepared.builtAt,
+                release: prepared.dir,
+                appName: prepared.appName,
+                basePath: mountPathOf(env) || '/',
+                dialect,
+                url: endpoints.url,
+                endpoints,
+                healthUrl: url,
+                name,
+                started: flags.start,
+                configFile: layout.configFile,
+                storageDir: layout.storageDir,
+                initialAdmin,
+                nextCommands,
+            },
+            summary: [
+                `${prepared.appName} ${prepared.version} is installed at ${root}${flags.start ? ' and running' : ''}.`,
+                `  URL       ${endpoints.url}`,
+                `  Release   ${prepared.id}`,
+                `  Sign in   ${describeInitialAdmin(initialAdmin)}`,
+                `  Logs      pm2 logs ${name}`,
+                'Next steps',
+                ...(flags.start ? [] : [`  Start it: ${startCommand}`]),
+                '  Start pm2 at boot: run `pm2 startup` and execute the command it prints (needs sudo).',
+                `  Proxy ${origin} to http://${flags.host}:${flags.port} with location /.`,
+            ],
+        };
+    }
+    catch (error) {
+        // Before the switch nothing is in use yet, so a retry should find the target as empty as it was.
+        // After it, the release, configuration and data are real and stay.
+        if (!switched) {
+            await releaseLock();
+            await cleanUp(root, created);
+        }
+        throw error;
+    }
+    finally {
+        await releaseLock();
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/commands/rollback.js

@@ -0,0 +1,284 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { Flags } from '@oclif/core';
+import { backupHasDatabase, restoreDatabase } from "../lib/backup.js";
+import { confirm } from "../lib/confirm.js";
+import { switchCurrent } from "../lib/current-link.js";
+import { healthUrl, mountPathOf, readAppEnv } from "../lib/env-file.js";
+import { assertFixedMountPath } from "../lib/mount-path.js";
+import { EXIT_FAILED, EXIT_INVALID, EXIT_ROLLBACK_FAILED, InstallerError, } from "../lib/errors.js";
+import { layoutOf, releaseDir, releaseLinkTarget } from "../lib/layout.js";
+import { installerCommandLine } from "../lib/invocation.js";
+import { acquireLock } from "../lib/lock.js";
+import { checkPlatform, checkPm2, currentNodeMajor } from "../lib/prechecks.js";
+import { checkPm2Ownership, errorLogCommandLine, errorLogTail, startApp, stopApp, } from "../lib/service.js";
+import { nodeRebuildAdvice } from "../lib/source.js";
+import { fixedMountPathOf, readState, resolveReleaseRef, writeState, } from "../lib/state.js";
+export const ROLLBACK_FLAGS = {
+    dir: Flags.string({
+        description: 'Installation root managed by app-installer. Defaults to the current directory.',
+    }),
+    to: Flags.string({
+        description: 'Release to return to, by id or version (the newest build of it). Defaults to the one the last upgrade came from.',
+    }),
+    restore: Flags.boolean({
+        allowNo: true,
+        default: true,
+        description: 'Restore the SQLite databases backed up before the upgrade, when that upgrade migrated them.',
+    }),
+    'health-timeout': Flags.integer({
+        default: 180,
+        min: 1,
+        description: 'Seconds to wait for the release to answer its health check.',
+    }),
+    yes: Flags.boolean({
+        default: false,
+        description: 'Proceed without asking for confirmation.',
+    }),
+    json: Flags.boolean({
+        default: false,
+        description: 'Print one JSON result on stdout; progress stays on stderr.',
+    }),
+};
+function lastUpgrade(history, matches) {
+    for (let index = history.length - 1; index >= 0; index -= 1) {
+        const entry = history[index];
+        if (entry.action === 'upgrade' &&
+            entry.outcome !== 'rolled-back' &&
+            matches(entry)) {
+            return entry;
+        }
+    }
+    return undefined;
+}
+/**
+ * The id of the release to return to: the interrupted operation's origin, else where the last completed upgrade came
+ * from.
+ */
+export function defaultRollbackTarget(state) {
+    // An interrupted upgrade is undone; an interrupted rollback is finished.
+    if (state.pending) {
+        return state.pending.action === 'upgrade'
+            ? state.pending.from
+            : state.pending.to;
+    }
+    return lastUpgrade(state.history, (entry) => entry.to === state.current)
+        ?.from;
+}
+/**
+ * The backup that holds the databases as they were on `target`, and whether they need restoring: only when the upgrade
+ * away from `target` applied migrations.
+ *
+ * An interrupted upgrade may have migrated once it moved `current`, and how far it got is unknown, so it counts as
+ * migrated from then on; before that it had only stopped the application. An interrupted rollback restores what it set
+ * out to.
+ */
+export function backupFor(state, target) {
+    const pending = state.pending;
+    if (pending?.action === 'upgrade' && pending.from === target) {
+        return { backup: pending.backup, migrated: pending.switched === true };
+    }
+    if (pending?.action === 'rollback' && pending.to === target) {
+        return {
+            backup: pending.restoreFrom,
+            migrated: pending.restoreFrom !== undefined,
+        };
+    }
+    const upgrade = lastUpgrade(state.history, (entry) => entry.from === target && entry.to === state.current);
+    return {
+        backup: upgrade?.backup,
+        migrated: (upgrade?.migrations ?? 0) > 0,
+    };
+}
+export async function rollback(input, deps) {
+    const { flags } = input;
+    const { reporter, pm2 } = deps;
+    const root = path.resolve(deps.cwd ?? process.cwd(), flags.dir ?? '.');
+    const layout = layoutOf(root);
+    const releaseLock = await acquireLock(layout.lockFile);
+    try {
+        // Read under the lock: a run that waited on it must see what the previous one wrote.
+        const state = await readState(layout);
+        checkPlatform();
+        const from = state.current;
+        const interrupted = state.pending;
+        const requested = flags.to ?? defaultRollbackTarget(state);
+        if (requested === undefined) {
+            throw new InstallerError('NOTHING_TO_ROLL_BACK', `No upgrade led to ${from}, so there is no earlier release to return to.`, {
+                exitCode: EXIT_INVALID,
+                suggestions: [
+                    { message: 'Name a release on disk with --to; status lists them.' },
+                ],
+            });
+        }
+        const record = resolveReleaseRef(state, requested);
+        const target = record?.id ?? requested;
+        if (target === from && !interrupted) {
+            return {
+                status: 'success-noop',
+                result: { directory: root, current: from, rolledBack: false },
+                summary: [`The application is already on ${from}.`],
+            };
+        }
+        if (!record || !existsSync(releaseDir(layout, record.id))) {
+            throw new InstallerError('RELEASE_MISSING', `${requested} is not on disk; only releases app-installer kept can be returned to.`, {
+                exitCode: EXIT_INVALID,
+                suggestions: [{ message: 'status lists the releases on disk.' }],
+            });
+        }
+        const machineMajor = currentNodeMajor();
+        if (record.buildTarget.nodeMajor !== machineMajor) {
+            throw new InstallerError('NODE_MISMATCH', `${target} was built for Node ${record.buildTarget.nodeMajor}, but this machine runs Node ${machineMajor}; its native modules would not load.`, {
+                exitCode: EXIT_INVALID,
+                suggestions: nodeRebuildAdvice(state, root),
+            });
+        }
+        const env = await readAppEnv(layout);
+        // A release built before relocatable builds runs only at the path it was built for, which app.env may have moved
+        // away from since.
+        const fixedMountPath = fixedMountPathOf(record, state);
+        if (fixedMountPath !== undefined) {
+            assertFixedMountPath(target, fixedMountPath, mountPathOf(env));
+        }
+        const service = {
+            layout,
+            pm2,
+            name: state.name,
+            healthUrl: healthUrl(env),
+            fetchImpl: deps.fetchImpl,
+        };
+        await checkPm2(pm2);
+        await checkPm2Ownership(service);
+        // Restore only from a backup that actually holds the database: an external database is never in one, and an
+        // upgrade interrupted before its copy finished never records one.
+        const { backup, migrated } = backupFor(state, target);
+        const restoreFrom = flags.restore &&
+            migrated &&
+            backup !== undefined &&
+            backupHasDatabase(layout, backup)
+            ? backup
+            : undefined;
+        if (flags.restore && migrated && restoreFrom === undefined) {
+            reporter.warn(`The databases may have been migrated past ${target}, and app-installer holds no copy of them from before (an external database, or a backup that was cut short). Restore them from your own backup if ${target} misbehaves.`);
+        }
+        await confirm([
+            `Roll the application at ${root} back from ${from} to ${target}.`,
+            'The application stops while the release switches.',
+            restoreFrom
+                ? `The SQLite databases are restored from ${restoreFrom}: whatever was written since that upgrade is lost.`
+                : 'The databases are left as they are; rolling back does not undo migrations.',
+        ], { yes: flags.yes, json: flags.json });
+        state.pending = {
+            action: 'rollback',
+            from,
+            to: target,
+            startedAt: new Date().toISOString(),
+            ...(restoreFrom ? { restoreFrom } : {}),
+        };
+        await writeState(layout, state);
+        reporter.progress(`Stopping ${from}`);
+        try {
+            await stopApp(service);
+        }
+        catch (error) {
+            // Nothing was restored or switched: put back what was pending before this run, if anything.
+            if (interrupted)
+                state.pending = interrupted;
+            else
+                delete state.pending;
+            await writeState(layout, state);
+            throw new InstallerError('ROLLBACK_ABORTED', `Stopping ${from} failed: ${error instanceof Error ? error.message : String(error)}. Nothing was restored or switched.`, { exitCode: EXIT_FAILED, cause: error });
+        }
+        let restored = false;
+        let switched = false;
+        let healthy = false;
+        let failure;
+        try {
+            if (restoreFrom) {
+                reporter.progress(`Restoring the databases from ${restoreFrom}`);
+                await restoreDatabase(layout, restoreFrom);
+                restored = true;
+            }
+            await switchCurrent(layout, releaseLinkTarget(target));
+            switched = true;
+            // The link and installer.json agree from here, whatever happens next.
+            state.current = target;
+            await writeState(layout, state);
+            reporter.progress(`Starting ${target}`);
+            healthy = await startApp({
+                ...service,
+                timeoutMs: flags['health-timeout'] * 1000,
+            });
+        }
+        catch (error) {
+            failure = error;
+        }
+        if (!healthy) {
+            // The rollback stays pending, so running it again retries it — restore included — once the cause is fixed.
+            await writeState(layout, state);
+            const reason = failure instanceof Error ? ` (${failure.message})` : '';
+            throw new InstallerError('ROLLBACK_FAILED', switched
+                ? `${target} did not come back${reason}. The application is down.`
+                : `${restoreFrom && !restored ? 'Restoring the databases' : 'Switching to ' + target} failed${reason}; the application is stopped and still on ${from}.`, {
+                exitCode: EXIT_ROLLBACK_FAILED,
+                details: {
+                    log: await errorLogTail(layout),
+                    databaseRestored: restored,
+                },
+                suggestions: [
+                    {
+                        message: 'Read the error log:',
+                        run: errorLogCommandLine(layout),
+                    },
+                    {
+                        message: 'Once the cause is fixed, run the rollback again:',
+                        run: installerCommandLine(['rollback', '--dir', root], {
+                            registry: state.registry,
+                        }),
+                    },
+                    ...(switched
+                        ? [
+                            {
+                                message: `Or go back to ${from}:`,
+                                run: installerCommandLine(['rollback', '--dir', root, '--to', from, '--no-restore'], { registry: state.registry }),
+                            },
+                        ]
+                        : []),
+                ],
+            });
+        }
+        delete state.pending;
+        state.history.push({
+            action: 'rollback',
+            from,
+            to: target,
+            at: new Date().toISOString(),
+            databaseRestored: restored,
+        });
+        await writeState(layout, state);
+        return {
+            status: 'success',
+            result: {
+                directory: root,
+                from,
+                to: target,
+                rolledBack: true,
+                recovered: interrupted ? interrupted.action : null,
+                databaseRestored: restored,
+                backup: restoreFrom ?? null,
+            },
+            summary: [
+                interrupted
+                    ? `Recovered from the interrupted ${interrupted.action} (${interrupted.from} to ${interrupted.to}); the application runs ${target}.`
+                    : `Rolled the application back from ${from} to ${target}.`,
+                restored
+                    ? `  Databases restored from ${restoreFrom}`
+                    : '  Databases left as they were',
+            ],
+        };
+    }
+    finally {
+        await releaseLock();
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/commands/rollback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.js","sourceRoot":"","sources":["../../src/commands/rollback.ts"],"names":[],"mappings":"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"}