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

package/dist/lib/release.js

@@ -0,0 +1,173 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, rename, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { extract } from 'tar';
+import { EXIT_INVALID, InstallerError, isInstallerError } from "./errors.js";
+import { RELEASE_APP_DIR, releaseDir, releaseId, stagingDir, } from "./layout.js";
+import { currentNodeMajor, rebuildCommandLine } from "./prechecks.js";
+import { CommandFailedError, tail } from "./run-command.js";
+/** Every official database dialect; each has its driver in `@nocobase/db-<dialect>`. */
+export const DIALECTS = [
+    'sqlite',
+    'postgres',
+    'mysql',
+    'mssql',
+    'oracle',
+    'dameng',
+    'kingbase',
+    'oceanbase',
+];
+export function verifyBuildTarget(target, expected = {
+    platform: process.platform,
+    arch: process.arch,
+    nodeMajor: currentNodeMajor(),
+}) {
+    if (!target ||
+        target.platform !== expected.platform ||
+        target.arch !== expected.arch ||
+        target.nodeMajor !== expected.nodeMajor) {
+        throw new InstallerError('BUILD_TARGET_MISMATCH', `The build targets ${target ? `${target.platform}-${target.arch} on Node ${target.nodeMajor}` : 'an unknown platform'}, but this machine is ${expected.platform}-${expected.arch} on Node ${expected.nodeMajor}.`);
+    }
+    return target;
+}
+export async function readReleaseManifest(dir) {
+    return JSON.parse(await readFile(path.join(dir, 'dist/package.json'), 'utf8'));
+}
+function stepFailure(code, step, error) {
+    // An interrupt, or a failure that already says what went wrong, passes through as it is.
+    if (isInstallerError(error))
+        return error;
+    const output = error instanceof CommandFailedError
+        ? tail(`${error.stdout}\n${error.stderr}`)
+        : undefined;
+    return new InstallerError(code, `${step} failed${error instanceof Error ? `: ${error.message}` : '.'}`, { cause: error, ...(output ? { details: { output } } : {}) });
+}
+/**
+ * Unpacks a deployment archive into a staging directory, reads which release it is from its manifest, checks that it
+ * was built for this machine, and moves it to `releases/<id>/app`. A release already on disk under the same id is the
+ * same build, so the staged copy is dropped and the existing one is used. Nothing here touches the running application,
+ * and on failure the staging directory is removed.
+ */
+export async function unpackRelease(options) {
+    const staging = stagingDir(options.layout);
+    const stagedApp = path.join(staging, RELEASE_APP_DIR);
+    await rm(staging, { recursive: true, force: true });
+    try {
+        await mkdir(stagedApp, { recursive: true });
+        try {
+            // The library `pnpm build --tar` packs with, so a deployment needs no `tar` of its own. Synchronous for the same
+            // reason the packing is: on a tree this size the promise form can leave the event loop with nothing pending.
+            extract({
+                file: options.archive,
+                cwd: stagedApp,
+                strict: true,
+                sync: true,
+            });
+        }
+        catch (error) {
+            throw stepFailure('UNPACK_FAILED', 'Unpacking the deployment archive', error);
+        }
+        let manifest;
+        try {
+            manifest = await readReleaseManifest(stagedApp);
+        }
+        catch (error) {
+            throw new InstallerError('ARCHIVE_INVALID', `${options.archive} holds no dist/package.json; it is not a deployment archive from \`pnpm build --tar\`.`, { exitCode: EXIT_INVALID, cause: error });
+        }
+        let buildTarget;
+        try {
+            buildTarget = verifyBuildTarget(manifest.nocobase?.buildTarget);
+        }
+        catch (error) {
+            if (!isInstallerError(error))
+                throw error;
+            throw new InstallerError(error.code, error.message, {
+                exitCode: EXIT_INVALID,
+                suggestions: [
+                    {
+                        message: 'Build the archive for this machine in the application project, then run this again:',
+                        run: rebuildCommandLine(),
+                    },
+                ],
+            });
+        }
+        const version = manifest.version ?? '0.0.0';
+        const builtAt = manifest.nocobase?.builtAt;
+        const relocatable = manifest.nocobase?.relocatable === true;
+        const basePath = relocatable ? undefined : manifest.nocobase?.basePath;
+        if (!builtAt || (!relocatable && !basePath) || !manifest.name) {
+            throw new InstallerError('ARCHIVE_TOO_OLD', `${options.archive} does not record where its client can be mounted and when it was built; it comes from a \`pnpm build\` older than app-installer needs.`, {
+                exitCode: EXIT_INVALID,
+                suggestions: [
+                    {
+                        message: 'Upgrade @nocobase/app-cli in the application project, build the archive again, then run this again:',
+                        run: rebuildCommandLine(),
+                    },
+                ],
+            });
+        }
+        const id = releaseId(version, builtAt);
+        const dir = releaseDir(options.layout, id);
+        const reused = existsSync(dir);
+        if (!reused) {
+            await mkdir(options.layout.releasesDir, { recursive: true });
+            await rename(staging, path.dirname(dir));
+        }
+        return {
+            id,
+            dir,
+            appName: manifest.name,
+            version,
+            builtAt,
+            relocatable,
+            ...(basePath === undefined ? {} : { basePath }),
+            buildTarget,
+            reused,
+        };
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+/**
+ * A deployment archive carries its database drivers in `dist/node_modules`, installed when it was built; nothing adds
+ * one afterwards. A dialect whose driver is absent would fail only when the application first connects.
+ */
+export function checkArchiveDriver(dir, dialect) {
+    if (dialect === 'sqlite')
+        return;
+    const driver = `@nocobase/db-${dialect}`;
+    if (existsSync(path.join(dir, 'dist/node_modules', driver, 'package.json'))) {
+        return;
+    }
+    throw new InstallerError('DRIVER_MISSING', `The archive holds no ${driver}, which the ${dialect} dialect needs; a deployment archive carries the drivers it was built with.`, {
+        exitCode: EXIT_INVALID,
+        suggestions: [
+            {
+                message: 'Add the driver in the application project:',
+                run: { command: 'pnpm', args: ['add', driver] },
+            },
+            {
+                message: 'Then build the archive again:',
+                run: rebuildCommandLine(),
+            },
+        ],
+    });
+}
+/**
+ * A release older than `APP_STORAGE_DIR` ignores it and keeps its data in `storage/` beside `dist/`, inside the release
+ * directory, where the next upgrade would leave it behind. Its first database write shows it.
+ */
+export function assertStorageOutsideRelease(dir) {
+    if (!existsSync(path.join(dir, 'storage')))
+        return;
+    throw new InstallerError('STORAGE_IN_RELEASE', `The release wrote its data into ${path.join(dir, 'storage')} instead of the installation's storage directory: its @nocobase/app-server predates APP_STORAGE_DIR.`, {
+        suggestions: [
+            {
+                message: 'Upgrade @nocobase/app-server and @nocobase/app-cli in the application project, then build the archive again:',
+                run: rebuildCommandLine(),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=release.js.map

package/dist/lib/release.js.map

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

package/dist/lib/run-command.js

@@ -0,0 +1,108 @@
+import { spawn } from 'node:child_process';
+import { interruptError, onInterrupt, takeInterrupt } from "./interrupt.js";
+export class CommandFailedError extends Error {
+    command;
+    exitCode;
+    stdout;
+    stderr;
+    constructor(command, exitCode, stdout, stderr, reason) {
+        super(reason ??
+            `${command} failed${exitCode === null ? '' : ` with exit code ${exitCode}`}.`);
+        this.name = 'CommandFailedError';
+        this.command = command;
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+/** How long a stopped command's process group gets to exit after SIGTERM before it is killed. */
+const KILL_GRACE_MS = 10_000;
+/**
+ * Signals the child's whole process group. `pnpm build` runs `tsc`, `vite` and native builds as its own children; killing
+ * only `pnpm` would leave them writing into a directory the caller is about to remove.
+ */
+function signalGroup(child, signal) {
+    if (child.pid === undefined)
+        return;
+    try {
+        process.kill(-child.pid, signal);
+    }
+    catch {
+        child.kill(signal);
+    }
+}
+/**
+ * Runs a child process, collecting its output, and rejects with `CommandFailedError` on a non-zero exit. The child leads
+ * its own process group, so a timeout or an interrupt stops everything it started, and the promise settles only once
+ * the group has exited.
+ */
+export const runCommand = (command, args, options = {}) => new Promise((resolve, reject) => {
+    const label = [command, ...args].join(' ');
+    if (takeInterrupt()) {
+        reject(interruptError());
+        return;
+    }
+    const child = spawn(command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: true,
+    });
+    let stdout = '';
+    let stderr = '';
+    let stopReason;
+    let killTimer;
+    const stop = (reason) => {
+        if (stopReason)
+            return;
+        stopReason = reason;
+        signalGroup(child, 'SIGTERM');
+        killTimer = setTimeout(() => signalGroup(child, 'SIGKILL'), KILL_GRACE_MS);
+        killTimer.unref();
+    };
+    const timer = options.timeoutMs
+        ? setTimeout(() => stop('timeout'), options.timeoutMs)
+        : undefined;
+    timer?.unref();
+    const stopListening = onInterrupt(() => stop('interrupt'));
+    child.stdout.on('data', (chunk) => {
+        stdout += chunk.toString();
+        options.echo?.write(chunk);
+    });
+    child.stderr.on('data', (chunk) => {
+        stderr += chunk.toString();
+        options.echo?.write(chunk);
+    });
+    const settle = () => {
+        clearTimeout(timer);
+        clearTimeout(killTimer);
+        stopListening();
+    };
+    child.once('error', (error) => {
+        settle();
+        reject(error);
+    });
+    child.once('close', (code) => {
+        settle();
+        if (stopReason === 'interrupt') {
+            // The interrupt is this step's failure; later recovery steps must not see it again.
+            takeInterrupt();
+            reject(interruptError());
+            return;
+        }
+        if (stopReason === 'timeout') {
+            reject(new CommandFailedError(label, code, stdout, stderr, `${label} timed out after ${Math.round(options.timeoutMs / 1000)}s.`));
+            return;
+        }
+        if (code === 0) {
+            resolve({ stdout, stderr });
+            return;
+        }
+        reject(new CommandFailedError(label, code, stdout, stderr));
+    });
+});
+/** The last `lines` lines of a command's output, for an error message that has to fit on a screen. */
+export function tail(text, lines = 20) {
+    return text.trimEnd().split('\n').slice(-lines).join('\n');
+}
+//# sourceMappingURL=run-command.js.map

package/dist/lib/run-command.js.map

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

package/dist/lib/service.js

@@ -0,0 +1,100 @@
+import { realpathSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { EXIT_INVALID, InstallerError, } from "./errors.js";
+import { checkHealth, pm2StartFailed, waitForHealthy } from "./health.js";
+import { interruptError, takeInterrupt } from "./interrupt.js";
+import { tail } from "./run-command.js";
+function sameDirectory(a, b) {
+    const real = (dir) => {
+        try {
+            return realpathSync(dir);
+        }
+        catch {
+            return path.resolve(dir);
+        }
+    };
+    return real(a) === real(b);
+}
+/**
+ * The pm2 process under the installation's name must be this installation's. Otherwise stopping it would stop another
+ * application, and `pm2 start` on the taken name would restart that process with this one's configuration.
+ */
+export async function checkPm2Ownership(options) {
+    const known = await options.pm2.describe(options.name);
+    if (known?.cwd && !sameDirectory(known.cwd, options.layout.root)) {
+        throw new InstallerError('PM2_NAME_IN_USE', `The pm2 process ${options.name} runs from ${known.cwd}, not from ${options.layout.root}.`, {
+            exitCode: EXIT_INVALID,
+            suggestions: [
+                {
+                    message: `Stop that process or rename it; installer.json names ${options.name} for this installation.`,
+                },
+            ],
+        });
+    }
+}
+/**
+ * Stops the application and waits until its health route stops answering. pm2 sends SIGINT and allows `kill_timeout`
+ * for it to finish what it is doing. An application pm2 does not know, such as one installed with `--no-start`, is
+ * simply not running.
+ */
+export async function stopApp(options) {
+    const known = await options.pm2.describe(options.name);
+    if (known)
+        await options.pm2.stop(options.name);
+    for (let attempt = 0; attempt < 60; attempt += 1) {
+        if (takeInterrupt())
+            throw interruptError();
+        if (!(await checkHealth(options.healthUrl, options.fetchImpl)))
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 1_000));
+    }
+    throw new Error(`${options.healthUrl} still answers after stopping ${options.name}; another process may be serving the application's port.`);
+}
+/**
+ * Starts whatever `current` points at and waits for it to be healthy. The process entry is deleted and registered again
+ * rather than restarted, so pm2's restart count starts from zero — the crash detection reads it — and a changed
+ * `ecosystem.config.cjs` is read again. A process pm2 reports as crashed ends the wait early.
+ */
+export async function startApp(options) {
+    await options.pm2.remove(options.name);
+    await options.pm2.start(options.layout.ecosystemFile, options.layout.root);
+    const healthy = await waitForHealthy(options.healthUrl, {
+        timeoutMs: options.timeoutMs,
+        fetchImpl: options.fetchImpl,
+        failed: pm2StartFailed(options.pm2, options.name),
+    });
+    if (healthy) {
+        await options.pm2.save();
+    }
+    else {
+        // A release that cannot start would otherwise be restarted by pm2 until it gives up.
+        await options.pm2.remove(options.name).catch(() => undefined);
+    }
+    return healthy;
+}
+export async function errorLogTail(layout) {
+    const text = await readFile(layout.errorLog, 'utf8').catch(() => '');
+    return tail(text, 30);
+}
+/** The command that shows more of the error log than `details.log` carries. */
+export function errorLogCommandLine(layout) {
+    return { command: 'tail', args: ['-n', '100', layout.errorLog] };
+}
+/**
+ * How to start the installation by hand once the cause is fixed. Two steps, since a suggestion runs one command: pm2
+ * starts it, then saves the process list so that `pm2 startup` brings it back after a reboot.
+ */
+export function startAdvice(layout, message) {
+    return [
+        {
+            message,
+            run: { command: 'pm2', args: ['start', layout.ecosystemFile] },
+        },
+        {
+            message: 'Then save the process list, so pm2 restores it after a reboot:',
+            run: { command: 'pm2', args: ['save'] },
+        },
+    ];
+}
+//# sourceMappingURL=service.js.map

package/dist/lib/service.js.map

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

package/dist/lib/source.js

@@ -0,0 +1,44 @@
+import { statSync } from 'node:fs';
+import path from 'node:path';
+import { EXIT_INVALID, InstallerError } from "./errors.js";
+import { quoteForShell } from '@nocobase/cli-envelope';
+import { installerCommand } from "./invocation.js";
+import { rebuildCommandLine } from "./prechecks.js";
+/**
+ * The archive `--archive` names, as an absolute path to a file that exists. Only a local path is accepted for now:
+ * fetching one would need downloads, credentials and checksums of its own.
+ */
+export function resolveArchivePath(cwd, value) {
+    if (/^[a-z][a-z0-9+.-]*:\/\//iu.test(value)) {
+        throw new InstallerError('INVALID_USAGE', `--archive takes a local path; download ${value} to the server first.`, { exitCode: EXIT_INVALID });
+    }
+    const file = path.resolve(cwd, value);
+    let isFile = false;
+    try {
+        isFile = statSync(file).isFile();
+    }
+    catch {
+        // Reported below.
+    }
+    if (!isFile) {
+        throw new InstallerError('ARCHIVE_NOT_FOUND', `${file} is not a file. Pass the deployment archive \`pnpm build --tar\` wrote to storage/exports/dist.tar.gz.`, { exitCode: EXIT_INVALID });
+    }
+    return file;
+}
+/**
+ * How to get a release that runs on this machine's Node: the archive is built again, in the application project, and
+ * the installation upgrades to it.
+ */
+export function nodeRebuildAdvice(state, root) {
+    return [
+        {
+            message: 'Build the archive again for this machine, in the application project:',
+            run: rebuildCommandLine(),
+        },
+        // No `run`: a suggestion's command runs as given, and the archive's path is not known here.
+        {
+            message: `Then copy it here and upgrade to it: ${installerCommand(`upgrade --dir ${quoteForShell(root)} --archive <the copied archive>`, { registry: state.registry })}`,
+        },
+    ];
+}
+//# sourceMappingURL=source.js.map

package/dist/lib/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/lib/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAa;IAC3D,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CACtB,eAAe,EACf,0CAA0C,KAAK,uBAAuB,EACtE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAC3B,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,GAAG,IAAI,wGAAwG,EAC/G,EAAE,QAAQ,EAAE,YAAY,EAAE,CAC3B,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAuC,EACvC,IAAY;IAEZ,OAAO;QACL;YACE,OAAO,EACL,uEAAuE;YACzE,GAAG,EAAE,kBAAkB,EAAE;SAC1B;QACD,4FAA4F;QAC5F;YACE,OAAO,EAAE,wCAAwC,gBAAgB,CAAC,iBAAiB,aAAa,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE;SACzK;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/state.js

@@ -0,0 +1,84 @@
+import { readFile, rename, writeFile } from 'node:fs/promises';
+import { EXIT_INVALID, InstallerError } from "./errors.js";
+import { installerCommandLine } from "./invocation.js";
+import { compareVersions } from "./version.js";
+/** Where a release has to be mounted, or `undefined` when it can be mounted anywhere. */
+export function fixedMountPathOf(record, state) {
+    return record.relocatable ? undefined : (record.basePath ?? state.basePath);
+}
+export async function readState(layout) {
+    let text;
+    try {
+        text = await readFile(layout.stateFile, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new InstallerError('NOT_INSTALLED', `${layout.root} holds no application installed by app-installer (installer.json is missing).`, {
+                exitCode: EXIT_INVALID,
+                suggestions: [
+                    {
+                        message: 'Run the command from the installation root, or name it with --dir.',
+                    },
+                ],
+            });
+        }
+        throw error;
+    }
+    const state = JSON.parse(text);
+    if (state.schemaVersion !== 1) {
+        throw new InstallerError('STATE_UNSUPPORTED', `installer.json has schemaVersion ${String(state.schemaVersion)}, which this app-installer does not understand.`, {
+            exitCode: EXIT_INVALID,
+            suggestions: [
+                {
+                    message: 'Use a newer app-installer:',
+                    run: installerCommandLine(['status', '--dir', layout.root], {
+                        version: 'latest',
+                        ...(typeof state.registry === 'string'
+                            ? { registry: state.registry }
+                            : {}),
+                    }),
+                },
+            ],
+        });
+    }
+    // `{ kind: 'template' }` was the published Hub template built on the server, which this installer no longer offers.
+    if (state.source.kind !== 'archive') {
+        throw new InstallerError('STATE_UNSUPPORTED', `${layout.root} was installed from a published template, which this app-installer no longer builds; it manages installations from deployment archives only.`, {
+            exitCode: EXIT_INVALID,
+            suggestions: [
+                {
+                    message: 'Keep managing it with the app-installer version that installed it, or install the application again from a deployment archive built by `pnpm build --tar`.',
+                },
+            ],
+        });
+    }
+    return state;
+}
+/** Writes the state through a temporary file and a rename, so a crash never leaves half a document behind. */
+export async function writeState(layout, state) {
+    const temporary = `${layout.stateFile}.${process.pid}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+    await rename(temporary, layout.stateFile);
+}
+export function findRelease(state, id) {
+    return state.releases.find((record) => record.id === id);
+}
+/**
+ * The release a `--to` names: an id exactly, or a version, meaning the newest build of it on record other than the
+ * running one. A version is what a person remembers; the id is what `status` prints when two builds of one version are
+ * on disk. Rolling back "to 1.0.0" while a later build of 1.0.0 runs means the earlier build, not the one already running.
+ */
+export function resolveReleaseRef(state, ref) {
+    const exact = findRelease(state, ref);
+    if (exact)
+        return exact;
+    const builds = [...state.releases]
+        .filter((record) => record.version === ref)
+        .sort((a, b) => b.builtAt.localeCompare(a.builtAt));
+    return builds.find((record) => record.id !== state.current) ?? builds[0];
+}
+/** Semantic-version order of two releases' versions; builds of one version compare equal. */
+export function compareReleaseVersions(a, b) {
+    return compareVersions(a.version, b.version) ?? 0;
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/lib/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAkC/C,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAC9B,MAAqB,EACrB,KAAuC;IAEvC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC9E,CAAC;AA6DD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC5C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,cAAc,CACtB,eAAe,EACf,GAAG,MAAM,CAAC,IAAI,+EAA+E,EAC7F;gBACE,QAAQ,EAAE,YAAY;gBACtB,WAAW,EAAE;oBACX;wBACE,OAAO,EACL,oEAAoE;qBACvE;iBACF;aACF,CACF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;IACjD,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,oCAAoC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,iDAAiD,EAChH;YACE,QAAQ,EAAE,YAAY;YACtB,WAAW,EAAE;gBACX;oBACE,OAAO,EAAE,4BAA4B;oBACrC,GAAG,EAAE,oBAAoB,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;wBAC1D,OAAO,EAAE,QAAQ;wBACjB,GAAG,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;4BACpC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;4BAC9B,CAAC,CAAC,EAAE,CAAC;qBACR,CAAC;iBACH;aACF;SACF,CACF,CAAC;IACJ,CAAC;IACD,oHAAoH;IACpH,IAAK,KAAK,CAAC,MAA2B,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,cAAc,CACtB,mBAAmB,EACnB,GAAG,MAAM,CAAC,IAAI,8IAA8I,EAC5J;YACE,QAAQ,EAAE,YAAY;YACtB,WAAW,EAAE;gBACX;oBACE,OAAO,EACL,4JAA4J;iBAC/J;aACF;SACF,CACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8GAA8G;AAC9G,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,KAAqB;IAErB,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC3D,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1E,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAqB,EACrB,EAAU;IAEV,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,GAAW;IAEX,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;SAC/B,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,KAAK,GAAG,CAAC;SAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CACpC,CAAgB,EAChB,CAAgB;IAEhB,OAAO,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/version.js

@@ -0,0 +1,51 @@
+function parse(version) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+.*)?$/u.exec(version.trim());
+    if (!match)
+        return undefined;
+    return {
+        core: [Number(match[1]), Number(match[2]), Number(match[3])],
+        prerelease: match[4] ? match[4].split('.') : [],
+    };
+}
+function compareIdentifiers(a, b) {
+    const numeric = /^\d+$/u;
+    if (numeric.test(a) && numeric.test(b))
+        return Number(a) - Number(b);
+    if (numeric.test(a))
+        return -1;
+    if (numeric.test(b))
+        return 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * Semantic version order: negative when `a` sorts first, positive when `b` does, zero when equal, and `undefined` when
+ * either is not a version at all. A prerelease sorts below its release, and `1.0.0-beta.10` above `1.0.0-beta.9`.
+ */
+export function compareVersions(a, b) {
+    const left = parse(a);
+    const right = parse(b);
+    if (!left || !right)
+        return undefined;
+    for (let index = 0; index < 3; index += 1) {
+        const difference = left.core[index] - right.core[index];
+        if (difference !== 0)
+            return difference;
+    }
+    if (left.prerelease.length === 0 || right.prerelease.length === 0) {
+        return right.prerelease.length - left.prerelease.length;
+    }
+    const length = Math.max(left.prerelease.length, right.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const x = left.prerelease[index];
+        const y = right.prerelease[index];
+        if (x === undefined)
+            return -1;
+        if (y === undefined)
+            return 1;
+        const difference = compareIdentifiers(x, y);
+        if (difference !== 0)
+            return difference;
+    }
+    return 0;
+}
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

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