@ethlete/cli 2.0.1-next.0 → 2.1.0-next.10

package/src/lib/update/migration-manifest.d.ts

@@ -0,0 +1,40 @@
+/** The `package.json` field a package points at its own migration manifest with. */
+export declare const MIGRATIONS_MANIFEST_KEY = "ethlete";
+export declare const MIGRATION_KINDS: readonly ["auto", "manual", "assisted"];
+export type MigrationKind = (typeof MIGRATION_KINDS)[number];
+export type Migration = {
+    /** Unique inside its package, and stable: it names the migration in every report. */
+    name: string;
+    /** The version the change landed in. The migration is pending for an update that crosses it. */
+    version: string;
+    kind: MigrationKind;
+    description: string;
+    /** `auto` only: the Nx generator that rewrites the code, as `@ethlete/core:migrate-x`. */
+    generator?: string;
+    /** `auto` only: flags handed to the generator, for example `{ skipFormat: true }`. */
+    options?: Record<string, string | number | boolean>;
+    /** Markdown next to the manifest: the recommendation for `manual`, the prompt for `assisted`. */
+    instructions?: string;
+    /** Path on the docs site, for example `/components/button`. */
+    docs?: string;
+};
+export type PackageMigrations = {
+    packageName: string;
+    migrations: Migration[];
+    /** Where the manifest was read from, so an instructions path can be resolved against it. */
+    manifestPath?: string;
+    problems: string[];
+};
+/**
+ * The migrations an installed package ships, read from the manifest its `package.json` points at.
+ * A package that declares none is not a problem — most versions need no migration.
+ */
+export declare const readPackageMigrations: (options: {
+    root: string;
+    packageName: string;
+}) => PackageMigrations;
+/** The absolute path of a migration's instructions file, or `undefined` when it names none. */
+export declare const instructionsPath: (options: {
+    manifestPath?: string;
+    migration: Migration;
+}) => string | undefined;

package/src/lib/update/migration-manifest.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instructionsPath = exports.readPackageMigrations = exports.MIGRATION_KINDS = exports.MIGRATIONS_MANIFEST_KEY = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const semver_1 = require("./semver");
+/** The `package.json` field a package points at its own migration manifest with. */
+exports.MIGRATIONS_MANIFEST_KEY = 'ethlete';
+exports.MIGRATION_KINDS = ['auto', 'manual', 'assisted'];
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const readJson = (path) => {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const readString = (record, key) => {
+    const value = record[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+};
+const readOptions = (value) => {
+    if (!isRecord(value))
+        return undefined;
+    const options = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean')
+            options[key] = entry;
+    }
+    return options;
+};
+const parseEntry = (options) => {
+    const { value, origin, index } = options;
+    const at = `${origin} entry ${index}`;
+    if (!isRecord(value))
+        return { problem: `${at} is not an object.` };
+    const name = readString(value, 'name');
+    const version = readString(value, 'version');
+    const kind = readString(value, 'kind');
+    const description = readString(value, 'description');
+    if (!name)
+        return { problem: `${at} has no "name".` };
+    if (!version)
+        return { problem: `${origin} "${name}" has no "version".` };
+    if (!(0, semver_1.isValidVersion)(version))
+        return { problem: `${origin} "${name}" has an invalid version "${version}".` };
+    if (!kind)
+        return { problem: `${origin} "${name}" has no "kind".` };
+    if (!exports.MIGRATION_KINDS.includes(kind)) {
+        return { problem: `${origin} "${name}" has kind "${kind}" — use one of ${exports.MIGRATION_KINDS.join(', ')}.` };
+    }
+    if (!description)
+        return { problem: `${origin} "${name}" has no "description".` };
+    const generator = readString(value, 'generator');
+    const instructions = readString(value, 'instructions');
+    if (kind === 'auto' && !generator)
+        return { problem: `${origin} "${name}" is auto but names no "generator".` };
+    if (kind === 'assisted' && !instructions) {
+        return { problem: `${origin} "${name}" is assisted but names no "instructions" file.` };
+    }
+    return {
+        migration: {
+            name,
+            version,
+            kind: kind,
+            description,
+            generator,
+            options: readOptions(value['options']),
+            instructions,
+            docs: readString(value, 'docs'),
+        },
+    };
+};
+const parseManifest = (options) => {
+    const { source, origin, packageName } = options;
+    if (!isRecord(source))
+        return { packageName, migrations: [], problems: [`${origin} is not a JSON object.`] };
+    const entries = source['migrations'];
+    if (!Array.isArray(entries))
+        return { packageName, migrations: [], problems: [`${origin} has no "migrations" array.`] };
+    const migrations = [];
+    const problems = [];
+    const seen = new Set();
+    entries.forEach((value, index) => {
+        const parsed = parseEntry({ value, origin, index });
+        if (parsed.problem !== undefined) {
+            problems.push(parsed.problem);
+            return;
+        }
+        const { migration } = parsed;
+        if (seen.has(migration.name)) {
+            problems.push(`${origin} declares "${migration.name}" twice.`);
+            return;
+        }
+        seen.add(migration.name);
+        migrations.push(migration);
+    });
+    return { packageName, migrations, problems };
+};
+/**
+ * The migrations an installed package ships, read from the manifest its `package.json` points at.
+ * A package that declares none is not a problem — most versions need no migration.
+ */
+const readPackageMigrations = (options) => {
+    const { root, packageName } = options;
+    const packageJsonPath = (0, path_1.join)(root, 'node_modules', ...packageName.split('/'), 'package.json');
+    if (!(0, fs_1.existsSync)(packageJsonPath)) {
+        return { packageName, migrations: [], problems: [`${packageName} is not installed.`] };
+    }
+    const packageJson = readJson(packageJsonPath);
+    const field = isRecord(packageJson) ? packageJson[exports.MIGRATIONS_MANIFEST_KEY] : undefined;
+    const declared = isRecord(field) ? field['migrations'] : undefined;
+    if (typeof declared !== 'string')
+        return { packageName, migrations: [], problems: [] };
+    const manifestPath = (0, path_1.resolve)((0, path_1.dirname)(packageJsonPath), declared);
+    if (!(0, fs_1.existsSync)(manifestPath)) {
+        return {
+            packageName,
+            migrations: [],
+            problems: [`${packageName} points "${exports.MIGRATIONS_MANIFEST_KEY}.migrations" at ${manifestPath}, which is missing.`],
+        };
+    }
+    return Object.assign(Object.assign({}, parseManifest({ source: readJson(manifestPath), origin: `${packageName} migrations.json`, packageName })), { manifestPath });
+};
+exports.readPackageMigrations = readPackageMigrations;
+/** The absolute path of a migration's instructions file, or `undefined` when it names none. */
+const instructionsPath = (options) => {
+    const { manifestPath, migration } = options;
+    if (!migration.instructions)
+        return undefined;
+    if ((0, path_1.isAbsolute)(migration.instructions))
+        return migration.instructions;
+    return manifestPath ? (0, path_1.resolve)((0, path_1.dirname)(manifestPath), migration.instructions) : undefined;
+};
+exports.instructionsPath = instructionsPath;
+//# sourceMappingURL=migration-manifest.js.map

package/src/lib/update/migration-manifest.js.map

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

package/src/lib/update/package-manager.d.ts

@@ -0,0 +1,23 @@
+import { Manifest } from './packages';
+export type PackageManagerName = 'yarn' | 'pnpm' | 'bun' | 'npm';
+export type PackageManager = {
+    name: PackageManagerName;
+    /** The command that installs what `package.json` declares. */
+    install: string[];
+    /** How this manager runs a binary from `node_modules`, for example `yarn nx`. */
+    run: string[];
+};
+/**
+ * The package manager this repo uses: what `packageManager` declares, else the lockfile that is there,
+ * else npm. `et update` runs the install itself, so it has to be the same one the repo already uses.
+ */
+export declare const detectPackageManager: (options: {
+    root: string;
+    manifest?: Manifest;
+    env?: NodeJS.ProcessEnv;
+}) => PackageManager;
+/** The command that runs an `nx` from this repo, for example `yarn nx generate …`. */
+export declare const nxCommand: (options: {
+    manager: PackageManager;
+    args: readonly string[];
+}) => string[];

package/src/lib/update/package-manager.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nxCommand = exports.detectPackageManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const MANAGERS = {
+    yarn: { name: 'yarn', install: ['yarn', 'install'], run: ['yarn'] },
+    pnpm: { name: 'pnpm', install: ['pnpm', 'install'], run: ['pnpm', 'exec'] },
+    bun: { name: 'bun', install: ['bun', 'install'], run: ['bunx'] },
+    npm: { name: 'npm', install: ['npm', 'install'], run: ['npx'] },
+};
+const LOCKFILES = [
+    ['yarn.lock', 'yarn'],
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['bun.lockb', 'bun'],
+    ['bun.lock', 'bun'],
+    ['package-lock.json', 'npm'],
+];
+const declaredName = (manifest, userAgent) => {
+    var _a;
+    const declared = (_a = manifest === null || manifest === void 0 ? void 0 : manifest.packageManager) !== null && _a !== void 0 ? _a : userAgent;
+    return declared
+        ? Object.keys(MANAGERS).find((name) => declared.startsWith(name))
+        : undefined;
+};
+/**
+ * The package manager this repo uses: what `packageManager` declares, else the lockfile that is there,
+ * else npm. `et update` runs the install itself, so it has to be the same one the repo already uses.
+ */
+const detectPackageManager = (options) => {
+    var _a;
+    const { root, manifest, env = process.env } = options;
+    const declared = declaredName(manifest, env['npm_config_user_agent']);
+    if (declared)
+        return MANAGERS[declared];
+    const found = LOCKFILES.find(([fileName]) => (0, fs_1.existsSync)((0, path_1.join)(root, fileName)));
+    return MANAGERS[(_a = found === null || found === void 0 ? void 0 : found[1]) !== null && _a !== void 0 ? _a : 'npm'];
+};
+exports.detectPackageManager = detectPackageManager;
+/** The command that runs an `nx` from this repo, for example `yarn nx generate …`. */
+const nxCommand = (options) => [
+    ...options.manager.run,
+    'nx',
+    ...options.args,
+];
+exports.nxCommand = nxCommand;
+//# sourceMappingURL=package-manager.js.map

package/src/lib/update/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/update/package-manager.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,+BAA4B;AAa5B,MAAM,QAAQ,GAA+C;IAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;IACnE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAC3E,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;IAChE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE;CAChE,CAAC;AAEF,MAAM,SAAS,GAAmC;IAChD,CAAC,WAAW,EAAE,MAAM,CAAC;IACrB,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,mBAAmB,EAAE,KAAK,CAAC;CAC7B,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAA8B,EAAE,SAA6B,EAAE,EAAE;;IACrF,MAAM,QAAQ,GAAG,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,cAAc,mCAAI,SAAS,CAAC;IAEvD,OAAO,QAAQ;QACb,CAAC,CAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAA0B,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3F,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,oBAAoB,GAAG,CAAC,OAIpC,EAAkB,EAAE;;IACnB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACtD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAEtE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/E,OAAO,QAAQ,CAAC,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAG,CAAC,CAAC,mCAAI,KAAK,CAAC,CAAC;AACvC,CAAC,CAAC;AAbW,QAAA,oBAAoB,wBAa/B;AAEF,sFAAsF;AAC/E,MAAM,SAAS,GAAG,CAAC,OAA6D,EAAE,EAAE,CAAC;IAC1F,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG;IACtB,IAAI;IACJ,GAAG,OAAO,CAAC,IAAI;CAChB,CAAC;AAJW,QAAA,SAAS,aAIpB"}

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

@@ -0,0 +1,65 @@
+export declare const ETHLETE_SCOPE = "@ethlete/";
+export declare const ROOT_MANIFEST = "package.json";
+export declare const DEPENDENCY_FIELDS: readonly ["dependencies", "devDependencies", "peerDependencies"];
+export type DependencyField = (typeof DEPENDENCY_FIELDS)[number];
+export type Manifest = Partial<Record<DependencyField, Record<string, string>>> & {
+    packageManager?: string;
+};
+/** One place a manifest declares a package: which file, which field, and the range written there. */
+export type DeclaredSite = {
+    /** Relative to the root, with `/` separators. `package.json` for the root manifest. */
+    manifestPath: string;
+    field: DependencyField;
+    range: string;
+    /** The version the range points at, or `undefined` for a range no single version can be read from. */
+    declaredVersion?: string;
+};
+export type DeclaredPackage = {
+    name: string;
+    /** Every field of every manifest in the repo that declares this package. */
+    sites: DeclaredSite[];
+    /** The version in `node_modules`, which is what the migrations of an update run against. */
+    installedVersion?: string;
+};
+export declare const manifestPath: (root: string) => string;
+export declare const readManifest: (root: string, relativePath?: string) => Manifest | undefined;
+/**
+ * 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.
+ */
+export declare const findManifests: (root: string) => string[];
+/** The version of `packageName` in `node_modules`, which is the one the running code came from. */
+export declare const installedVersion: (root: string, packageName: string) => string | undefined;
+/**
+ * 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.
+ */
+export declare const newestDeclaredVersion: (sites: readonly DeclaredSite[]) => string | undefined;
+/** Every `@ethlete/*` dependency the repo declares, gathered across all of its manifests. */
+export declare const declaredEthletePackages: (options: {
+    root: string;
+    manifests?: readonly string[];
+}) => DeclaredPackage[];
+export type RangeWrite = {
+    name: string;
+    manifestPath: string;
+    field: DependencyField;
+    range: string;
+};
+/**
+ * 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.
+ */
+export declare const writeRanges: (options: {
+    root: string;
+    writes: readonly RangeWrite[];
+}) => string[];
+/**
+ * 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`.
+ */
+export declare const rangeFor: (options: {
+    current: string;
+    version: string;
+}) => string | undefined;

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[];