@ethlete/cli 2.1.0-next.7 → 2.1.0-next.9

package/src/lib/update/packages.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rangeFor = exports.writeRanges = exports.declaredEthletePackages = exports.newestDeclaredVersion = exports.installedVersion = exports.findManifests = exports.readManifest = exports.manifestPath = exports.DEPENDENCY_FIELDS = exports.ROOT_MANIFEST = exports.ETHLETE_SCOPE = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const semver_1 = require("./semver");
+exports.ETHLETE_SCOPE = '@ethlete/';
+exports.ROOT_MANIFEST = 'package.json';
+exports.DEPENDENCY_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies'];
+const SKIPPED_DIRECTORIES = new Set(['coverage', 'dist', 'node_modules', 'tmp']);
+const readJson = (path) => {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const manifestPath = (root) => (0, path_1.join)(root, exports.ROOT_MANIFEST);
+exports.manifestPath = manifestPath;
+const readManifest = (root, relativePath = exports.ROOT_MANIFEST) => {
+    const parsed = readJson((0, path_1.join)(root, relativePath));
+    return isRecord(parsed) ? parsed : undefined;
+};
+exports.readManifest = readManifest;
+/**
+ * Every `package.json` in the repo, root first. An Nx repo keeps a manifest per buildable library, and
+ * those pin `@ethlete/*` too, so an update that only rewrites the root leaves the rest behind.
+ */
+const findManifests = (root) => {
+    const found = [];
+    const walk = (directory) => {
+        let entries;
+        try {
+            entries = (0, fs_1.readdirSync)(directory, { withFileTypes: true });
+        }
+        catch (_a) {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (entry.name.startsWith('.') || SKIPPED_DIRECTORIES.has(entry.name))
+                    continue;
+                walk((0, path_1.join)(directory, entry.name));
+                continue;
+            }
+            if (entry.name !== exports.ROOT_MANIFEST)
+                continue;
+            found.push((0, path_1.relative)(root, (0, path_1.join)(directory, entry.name)).split(path_1.sep).join('/'));
+        }
+    };
+    walk(root);
+    return found.sort((left, right) => {
+        if (left === exports.ROOT_MANIFEST)
+            return -1;
+        if (right === exports.ROOT_MANIFEST)
+            return 1;
+        return left.localeCompare(right);
+    });
+};
+exports.findManifests = findManifests;
+/** The version of `packageName` in `node_modules`, which is the one the running code came from. */
+const installedVersion = (root, packageName) => {
+    const path = (0, path_1.join)(root, 'node_modules', ...packageName.split('/'), exports.ROOT_MANIFEST);
+    if (!(0, fs_1.existsSync)(path))
+        return undefined;
+    const parsed = readJson(path);
+    return isRecord(parsed) && typeof parsed['version'] === 'string' ? parsed['version'] : undefined;
+};
+exports.installedVersion = installedVersion;
+/**
+ * The version an update starts from when nothing is installed: the newest one any manifest declares, so
+ * a library manifest that lags behind the root does not read as the current version.
+ */
+const newestDeclaredVersion = (sites) => sites.reduce((newest, site) => {
+    if (site.declaredVersion === undefined)
+        return newest;
+    return newest === undefined || (0, semver_1.compareVersions)(site.declaredVersion, newest) > 0 ? site.declaredVersion : newest;
+}, undefined);
+exports.newestDeclaredVersion = newestDeclaredVersion;
+/** Every `@ethlete/*` dependency the repo declares, gathered across all of its manifests. */
+const declaredEthletePackages = (options) => {
+    var _a, _b;
+    const { root, manifests = (0, exports.findManifests)(root) } = options;
+    const byName = new Map();
+    for (const relativePath of manifests) {
+        const manifest = (0, exports.readManifest)(root, relativePath);
+        if (!manifest)
+            continue;
+        for (const field of exports.DEPENDENCY_FIELDS) {
+            for (const [name, range] of Object.entries((_a = manifest[field]) !== null && _a !== void 0 ? _a : {})) {
+                if (!name.startsWith(exports.ETHLETE_SCOPE))
+                    continue;
+                const entry = (_b = byName.get(name)) !== null && _b !== void 0 ? _b : {
+                    name,
+                    sites: [],
+                    installedVersion: (0, exports.installedVersion)(root, name),
+                };
+                entry.sites.push({ manifestPath: relativePath, field, range, declaredVersion: (0, semver_1.versionOfRange)(range) });
+                byName.set(name, entry);
+            }
+        }
+    }
+    return [...byName.values()];
+};
+exports.declaredEthletePackages = declaredEthletePackages;
+const detectIndent = (source) => { var _a, _b; return (_b = (_a = /\n([ \t]+)"/.exec(source)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : '  '; };
+/**
+ * Writes new ranges into the manifests they came from, keeping each file's indentation. A whole file is
+ * re-serialised, so a comment or a key order the parser cannot represent would not survive -
+ * `package.json` holds neither.
+ */
+const writeRanges = (options) => {
+    const { root, writes } = options;
+    const written = [];
+    for (const relativePath of new Set(writes.map((write) => write.manifestPath))) {
+        const path = (0, path_1.join)(root, relativePath);
+        const source = (0, fs_1.readFileSync)(path, 'utf8');
+        const parsed = JSON.parse(source);
+        if (!isRecord(parsed))
+            throw new Error(`${path} is not a JSON object.`);
+        for (const write of writes.filter((candidate) => candidate.manifestPath === relativePath)) {
+            const field = parsed[write.field];
+            if (!isRecord(field))
+                continue;
+            field[write.name] = write.range;
+        }
+        const indent = detectIndent(source);
+        const trailingNewline = source.endsWith('\n') ? '\n' : '';
+        (0, fs_1.writeFileSync)(path, `${JSON.stringify(parsed, null, indent)}${trailingNewline}`, 'utf8');
+        written.push(relativePath);
+    }
+    return written;
+};
+exports.writeRanges = writeRanges;
+/**
+ * The range that carries `version` while keeping how the declared one was written, for example `^`.
+ * `undefined` for a range this cannot rewrite safely, such as `workspace:*` or `>=5 <6`.
+ */
+const rangeFor = (options) => {
+    const { current, version } = options;
+    const prefix = (0, semver_1.rangePrefix)(current);
+    return prefix === undefined ? undefined : `${prefix}${version}`;
+};
+exports.rangeFor = rangeFor;
+//# sourceMappingURL=packages.js.map

package/src/lib/update/packages.js.map

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

package/src/lib/update/pending.d.ts

@@ -0,0 +1,21 @@
+export declare const PENDING_FILE: string;
+export type PendingPackage = {
+    name: string;
+    /** The version that was installed before the update, which the migrations run from. */
+    from: string | null;
+    to: string;
+};
+export type PendingUpdate = {
+    startedAt: string;
+    packages: PendingPackage[];
+};
+/**
+ * Records what an update moved, before the install replaces the versions the migrations run from. An
+ * install or a codemod that fails leaves this file behind, so `et update --continue` can pick it up.
+ */
+export declare const writePendingUpdate: (options: {
+    root: string;
+    pending: PendingUpdate;
+}) => void;
+export declare const readPendingUpdate: (root: string) => PendingUpdate | undefined;
+export declare const clearPendingUpdate: (root: string) => void;

package/src/lib/update/pending.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearPendingUpdate = exports.readPendingUpdate = exports.writePendingUpdate = exports.PENDING_FILE = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const tasks_1 = require("./tasks");
+exports.PENDING_FILE = (0, path_1.join)(tasks_1.UPDATE_DIR, 'pending.json');
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Records what an update moved, before the install replaces the versions the migrations run from. An
+ * install or a codemod that fails leaves this file behind, so `et update --continue` can pick it up.
+ */
+const writePendingUpdate = (options) => {
+    const { root, pending } = options;
+    (0, fs_1.mkdirSync)((0, path_1.join)(root, tasks_1.UPDATE_DIR), { recursive: true });
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, exports.PENDING_FILE), `${JSON.stringify(pending, null, 2)}\n`, 'utf8');
+};
+exports.writePendingUpdate = writePendingUpdate;
+const readPendingUpdate = (root) => {
+    const path = (0, path_1.join)(root, exports.PENDING_FILE);
+    if (!(0, fs_1.existsSync)(path))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+    if (!isRecord(parsed) || !Array.isArray(parsed['packages']))
+        return undefined;
+    const packages = parsed['packages'].filter((entry) => isRecord(entry) && typeof entry['name'] === 'string' && typeof entry['to'] === 'string');
+    return {
+        startedAt: typeof parsed['startedAt'] === 'string' ? parsed['startedAt'] : 'an earlier run',
+        packages: packages.map((entry) => { var _a; return ({ name: entry.name, from: (_a = entry.from) !== null && _a !== void 0 ? _a : null, to: entry.to }); }),
+    };
+};
+exports.readPendingUpdate = readPendingUpdate;
+const clearPendingUpdate = (root) => (0, fs_1.rmSync)((0, path_1.join)(root, exports.PENDING_FILE), { force: true });
+exports.clearPendingUpdate = clearPendingUpdate;
+//# sourceMappingURL=pending.js.map

package/src/lib/update/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/pending.ts"],"names":[],"mappings":";;;AAAA,2BAAgF;AAChF,+BAA4B;AAC5B,mCAAqC;AAExB,QAAA,YAAY,GAAG,IAAA,WAAI,EAAC,kBAAU,EAAE,cAAc,CAAC,CAAC;AAc7D,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,OAAiD,EAAE,EAAE;IACtF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAElC,IAAA,cAAS,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,kBAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,IAAA,kBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,oBAAY,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3F,CAAC,CAAC;AALW,QAAA,kBAAkB,sBAK7B;AAEK,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAA6B,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,oBAAY,CAAC,CAAC;IAEtC,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,MAAe,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9E,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAA2B,EAAE,CACjC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAC1F,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,gBAAgB;QAC3F,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,WAAC,OAAA,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAA,KAAK,CAAC,IAAI,mCAAI,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA,EAAA,CAAC;KAClG,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,iBAAiB,qBAwB5B;AAEK,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAA,WAAM,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,oBAAY,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAAzF,QAAA,kBAAkB,sBAAuE"}

package/src/lib/update/plan.d.ts

@@ -0,0 +1,51 @@
+import { DeclaredPackage, DeclaredSite, RangeWrite } from './packages';
+import { Migration, PackageMigrations } from './migration-manifest';
+import { RegistryPackage } from './registry';
+export type UpdatedPackage = {
+    name: string;
+    /** The installed version the migrations run from, or `undefined` when nothing is installed. */
+    from?: string;
+    to: string;
+};
+export type PackageUpdate = UpdatedPackage & {
+    /** The dist tag the target came from, absent when the caller named a version. */
+    tag?: string;
+    /** Every range to rewrite, one per manifest and field that declares the package. */
+    writes: RangeWrite[];
+    /** The sites whose declared range no single version can be written into. */
+    unwritable: DeclaredSite[];
+};
+export type TargetChoice = {
+    update: PackageUpdate;
+} | {
+    problem: string;
+} | {
+    upToDate: true;
+};
+export type TargetRequest = {
+    /** A version the caller named with `--to`. */
+    version?: string;
+    /** A dist tag the caller named with `--tag`. */
+    tag?: string;
+};
+/** The version an update moves a package to, from the registry's dist tags or the caller's request. */
+export declare const chooseTarget: (options: {
+    declared: DeclaredPackage;
+    registry: RegistryPackage;
+    request?: TargetRequest;
+}) => TargetChoice;
+export declare const isDowngrade: (update: PackageUpdate) => boolean;
+export type PendingMigration = {
+    packageName: string;
+    migration: Migration;
+    /** Where the instructions of this migration live, when it names any. */
+    manifestPath?: string;
+};
+/** The migrations of one package that an update from `from` to `to` crosses. */
+export declare const pendingMigrations: (options: {
+    packageMigrations: PackageMigrations;
+    from: string;
+    to: string;
+}) => PendingMigration[];
+/** Oldest version first, and inside one version the package that others build on first. */
+export declare const orderMigrations: (pending: readonly PendingMigration[]) => PendingMigration[];

package/src/lib/update/plan.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orderMigrations = exports.pendingMigrations = exports.isDowngrade = exports.chooseTarget = void 0;
+const packages_1 = require("./packages");
+const registry_1 = require("./registry");
+const semver_1 = require("./semver");
+/**
+ * The order two migrations of the same version run in, following the dependency layering: a rewrite in
+ * `core` lands before the `components` one that builds on it.
+ */
+const PACKAGE_ORDER = [
+    '@ethlete/types',
+    '@ethlete/core',
+    '@ethlete/query',
+    '@ethlete/components',
+    '@ethlete/contentful',
+    '@ethlete/query-devtools',
+    '@ethlete/cdk',
+    '@ethlete/eslint-plugin',
+    '@ethlete/agent-rules',
+    '@ethlete/cli',
+];
+/** The version an update moves a package to, from the registry's dist tags or the caller's request. */
+const chooseTarget = (options) => {
+    var _a, _b, _c;
+    const { declared, registry, request = {} } = options;
+    const current = (_a = declared.installedVersion) !== null && _a !== void 0 ? _a : (0, packages_1.newestDeclaredVersion)(declared.sites);
+    if (request.version !== undefined) {
+        if (!(0, semver_1.isValidVersion)(request.version))
+            return { problem: `"${request.version}" is not a version.` };
+        if (!registry.versions.includes(request.version)) {
+            return { problem: `${declared.name}@${request.version} is not on the registry.` };
+        }
+    }
+    const tag = request.version === undefined
+        ? ((_b = request.tag) !== null && _b !== void 0 ? _b : (0, registry_1.tagForInstalled)({ version: current, distTags: registry.distTags }))
+        : undefined;
+    const to = (_c = request.version) !== null && _c !== void 0 ? _c : (tag === undefined ? undefined : registry.distTags[tag]);
+    if (to === undefined) {
+        return { problem: `${declared.name} has no "${tag}" version on the registry.` };
+    }
+    if (current !== undefined && (0, semver_1.compareVersions)(to, current) === 0)
+        return { upToDate: true };
+    // A dist tag can point at an older version than the installed one - the release of a package that
+    // never had a stable version leaves `next` behind. Following the tag this command picks by itself
+    // would be a silent downgrade, so it takes `--to` or `--tag` to ask for one.
+    const inferredTag = request.version === undefined && request.tag === undefined;
+    if (inferredTag && current !== undefined && (0, semver_1.compareVersions)(to, current) < 0) {
+        return {
+            problem: `${declared.name}: the "${tag}" tag points at ${to}, which is older than the ${current} this repo is on. ` +
+                `The tag is stale. Pass \`--to ${to}\` to move back on purpose.`,
+        };
+    }
+    const writes = [];
+    const unwritable = [];
+    for (const site of declared.sites) {
+        const range = (0, packages_1.rangeFor)({ current: site.range, version: to });
+        if (range === undefined)
+            unwritable.push(site);
+        else
+            writes.push({ name: declared.name, manifestPath: site.manifestPath, field: site.field, range });
+    }
+    return {
+        update: {
+            name: declared.name,
+            from: declared.installedVersion,
+            to,
+            tag,
+            writes,
+            unwritable,
+        },
+    };
+};
+exports.chooseTarget = chooseTarget;
+const isDowngrade = (update) => update.from !== undefined && !(0, semver_1.isNewer)(update.to, update.from);
+exports.isDowngrade = isDowngrade;
+/** The migrations of one package that an update from `from` to `to` crosses. */
+const pendingMigrations = (options) => {
+    const { packageMigrations, from, to } = options;
+    return packageMigrations.migrations
+        .filter((migration) => (0, semver_1.isInUpdateRange)({ version: migration.version, after: from, upTo: to }))
+        .map((migration) => ({
+        packageName: packageMigrations.packageName,
+        migration,
+        manifestPath: packageMigrations.manifestPath,
+    }));
+};
+exports.pendingMigrations = pendingMigrations;
+const packageRank = (name) => {
+    const index = PACKAGE_ORDER.indexOf(name);
+    return index === -1 ? PACKAGE_ORDER.length : index;
+};
+/** Oldest version first, and inside one version the package that others build on first. */
+const orderMigrations = (pending) => [...pending].sort((left, right) => {
+    const byVersion = (0, semver_1.compareVersions)(left.migration.version, right.migration.version);
+    if (byVersion !== 0)
+        return byVersion;
+    return packageRank(left.packageName) - packageRank(right.packageName);
+});
+exports.orderMigrations = orderMigrations;
+//# sourceMappingURL=plan.js.map

package/src/lib/update/plan.js.map

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

package/src/lib/update/registry.d.ts

@@ -0,0 +1,31 @@
+export declare const DEFAULT_REGISTRY = "https://registry.npmjs.org";
+export type RegistryPackage = {
+    distTags: Record<string, string>;
+    versions: string[];
+};
+export type RegistryLookup = {
+    ok: true;
+    package: RegistryPackage;
+} | {
+    ok: false;
+    reason: string;
+};
+/** The registry npm would use, so a run inside a repo with its own registry reads the same one. */
+export declare const registryUrl: (env?: NodeJS.ProcessEnv) => string;
+export declare const packageUrl: (options: {
+    registry: string;
+    packageName: string;
+}) => string;
+/** Asks the registry which versions of a package exist and what each dist tag points at. */
+export declare const fetchRegistryPackage: (options: {
+    packageName: string;
+    registry?: string;
+}) => Promise<RegistryLookup>;
+/**
+ * Which dist tag an update follows when the caller names none: the one the installed prerelease belongs
+ * to, so a repo on `-next.46` stays on `next` instead of being pulled back to the stable line.
+ */
+export declare const tagForInstalled: (options: {
+    version?: string;
+    distTags: Record<string, string>;
+}) => string;

package/src/lib/update/registry.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tagForInstalled = exports.fetchRegistryPackage = exports.packageUrl = exports.registryUrl = exports.DEFAULT_REGISTRY = void 0;
+const tslib_1 = require("tslib");
+const semver_1 = require("./semver");
+const TIMEOUT_MS = 15000;
+exports.DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+/** The registry npm would use, so a run inside a repo with its own registry reads the same one. */
+const registryUrl = (env = process.env) => { var _a, _b; return ((_b = (_a = env['npm_config_@ethlete:registry']) !== null && _a !== void 0 ? _a : env['npm_config_registry']) !== null && _b !== void 0 ? _b : exports.DEFAULT_REGISTRY).replace(/\/+$/, ''); };
+exports.registryUrl = registryUrl;
+const packageUrl = (options) => `${options.registry}/${options.packageName.replace('/', '%2f')}`;
+exports.packageUrl = packageUrl;
+/** Asks the registry which versions of a package exist and what each dist tag points at. */
+const fetchRegistryPackage = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { packageName, registry = (0, exports.registryUrl)() } = options;
+    let response;
+    try {
+        response = yield fetch((0, exports.packageUrl)({ registry, packageName }), {
+            // The abbreviated document holds the dist tags and the version list without every manifest.
+            headers: { Accept: 'application/vnd.npm.install-v1+json' },
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+    }
+    catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+    if (response.status === 404)
+        return { ok: false, reason: `${registry} has no ${packageName}.` };
+    if (!response.ok)
+        return { ok: false, reason: `${registry} answered ${response.status} for ${packageName}.` };
+    const body = yield response.json().catch(() => undefined);
+    const record = typeof body === 'object' && body !== null ? body : {};
+    const tags = record['dist-tags'];
+    const versions = record['versions'];
+    return {
+        ok: true,
+        package: {
+            distTags: typeof tags === 'object' && tags !== null ? tags : {},
+            versions: typeof versions === 'object' && versions !== null ? Object.keys(versions) : [],
+        },
+    };
+});
+exports.fetchRegistryPackage = fetchRegistryPackage;
+/**
+ * Which dist tag an update follows when the caller names none: the one the installed prerelease belongs
+ * to, so a repo on `-next.46` stays on `next` instead of being pulled back to the stable line.
+ */
+const tagForInstalled = (options) => {
+    const { version, distTags } = options;
+    const tag = version ? (0, semver_1.prereleaseTag)(version) : undefined;
+    return tag !== undefined && distTags[tag] !== undefined ? tag : 'latest';
+};
+exports.tagForInstalled = tagForInstalled;
+//# sourceMappingURL=registry.js.map

package/src/lib/update/registry.js.map

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

package/src/lib/update/run-migrations.d.ts

@@ -0,0 +1,44 @@
+import { Migration } from './migration-manifest';
+import { PackageManager } from './package-manager';
+import { PendingMigration } from './plan';
+export type MigrationState = 'applied' | 'failed' | 'unsupported' | 'task' | 'planned';
+export type MigrationOutcome = {
+    pending: PendingMigration;
+    state: MigrationState;
+    /** Why it did not apply, for a state other than `applied`. */
+    reason?: string;
+};
+/** Nx runs the auto migrations, so a repo without it gets the command printed instead. */
+export declare const hasNx: (root: string) => boolean;
+/** The `nx generate` arguments for one auto migration. Non-interactive: an update must not stop to ask. */
+export declare const generatorArgs: (options: {
+    migration: Migration;
+    dryRun: boolean;
+}) => string[];
+export declare const runAutoMigration: (options: {
+    root: string;
+    manager: PackageManager;
+    pending: PendingMigration;
+    dryRun: boolean;
+}) => MigrationOutcome;
+export declare const runInstall: (options: {
+    root: string;
+    manager: PackageManager;
+}) => {
+    ok: boolean;
+    reason: string;
+} | {
+    ok: boolean;
+    reason?: undefined;
+};
+/** The command a developer runs by hand when this repo has no Nx to run the generator with. */
+export declare const manualGeneratorCommand: (options: {
+    manager: PackageManager;
+    migration: Migration;
+}) => string;
+export declare const runPendingMigrations: (options: {
+    root: string;
+    manager: PackageManager;
+    pending: readonly PendingMigration[];
+    dryRun: boolean;
+}) => MigrationOutcome[];

package/src/lib/update/run-migrations.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPendingMigrations = exports.manualGeneratorCommand = exports.runInstall = exports.runAutoMigration = exports.generatorArgs = exports.hasNx = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const package_manager_1 = require("./package-manager");
+/** Nx runs the auto migrations, so a repo without it gets the command printed instead. */
+const hasNx = (root) => (0, fs_1.existsSync)((0, path_1.join)(root, 'node_modules', 'nx', 'package.json')) && (0, fs_1.existsSync)((0, path_1.join)(root, 'nx.json'));
+exports.hasNx = hasNx;
+/** The `nx generate` arguments for one auto migration. Non-interactive: an update must not stop to ask. */
+const generatorArgs = (options) => {
+    var _a, _b;
+    const { migration, dryRun } = options;
+    return [
+        'generate',
+        (_a = migration.generator) !== null && _a !== void 0 ? _a : '',
+        '--interactive=false',
+        ...Object.entries((_b = migration.options) !== null && _b !== void 0 ? _b : {}).map(([key, value]) => `--${key}=${String(value)}`),
+        ...(dryRun ? ['--dry-run'] : []),
+    ];
+};
+exports.generatorArgs = generatorArgs;
+const runAutoMigration = (options) => {
+    const { root, manager, pending, dryRun } = options;
+    const [binary, ...args] = (0, package_manager_1.nxCommand)({
+        manager,
+        args: (0, exports.generatorArgs)({ migration: pending.migration, dryRun }),
+    });
+    if (binary === undefined)
+        return { pending, state: 'failed', reason: 'no command to run the generator with' };
+    const result = (0, child_process_1.spawnSync)(binary, args, { cwd: root, stdio: 'inherit' });
+    if (result.error)
+        return { pending, state: 'failed', reason: result.error.message };
+    if (result.status !== 0)
+        return { pending, state: 'failed', reason: `${binary} exited with ${result.status}` };
+    return { pending, state: dryRun ? 'planned' : 'applied' };
+};
+exports.runAutoMigration = runAutoMigration;
+const runInstall = (options) => {
+    const { root, manager } = options;
+    const [binary, ...args] = manager.install;
+    if (binary === undefined)
+        return { ok: false, reason: 'no install command' };
+    const result = (0, child_process_1.spawnSync)(binary, args, { cwd: root, stdio: 'inherit' });
+    if (result.error)
+        return { ok: false, reason: result.error.message };
+    if (result.status !== 0)
+        return { ok: false, reason: `${manager.install.join(' ')} exited with ${result.status}` };
+    return { ok: true };
+};
+exports.runInstall = runInstall;
+/** The command a developer runs by hand when this repo has no Nx to run the generator with. */
+const manualGeneratorCommand = (options) => (0, package_manager_1.nxCommand)({ manager: options.manager, args: (0, exports.generatorArgs)({ migration: options.migration, dryRun: false }) }).join(' ');
+exports.manualGeneratorCommand = manualGeneratorCommand;
+const runPendingMigrations = (options) => {
+    const { root, manager, pending, dryRun } = options;
+    const nxAvailable = (0, exports.hasNx)(root);
+    return pending.map((entry) => {
+        if (entry.migration.kind !== 'auto')
+            return { pending: entry, state: 'task' };
+        if (!nxAvailable) {
+            return {
+                pending: entry,
+                state: 'unsupported',
+                reason: 'this repo has no Nx, so the generator has to be run by hand',
+            };
+        }
+        return (0, exports.runAutoMigration)({ root, manager, pending: entry, dryRun });
+    });
+};
+exports.runPendingMigrations = runPendingMigrations;
+//# sourceMappingURL=run-migrations.js.map

package/src/lib/update/run-migrations.js.map

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

package/src/lib/update/semver.d.ts

@@ -0,0 +1,19 @@
+/** `-1`, `0` or `1`, prerelease-aware for the `x.y.z-next.N` versions this repo publishes. */
+export declare const compareVersions: (left: string, right: string) => 0 | 1 | -1;
+export declare const isNewer: (candidate: string, than: string) => boolean;
+/** True when `version` sits inside `(after, upTo]`, the range a pending migration is selected by. */
+export declare const isInUpdateRange: (options: {
+    version: string;
+    after: string;
+    upTo: string;
+}) => boolean;
+export declare const isValidVersion: (version: string) => boolean;
+/**
+ * The dist tag a prerelease belongs to, for example `next` for `5.0.0-next.46`. A stable version has
+ * none, and neither has a prerelease that only numbers its identifiers.
+ */
+export declare const prereleaseTag: (version: string) => string | undefined;
+/** The `^` or `~` a range keeps, or `''` for an exact one. `undefined` for a range with no single version. */
+export declare const rangePrefix: (range: string) => string | undefined;
+/** The version a range points at, for example `5.0.0-next.46` for `^5.0.0-next.46`. */
+export declare const versionOfRange: (range: string) => string | undefined;