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

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,45 @@
+export declare const ETHLETE_SCOPE = "@ethlete/";
+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;
+};
+export type DeclaredPackage = {
+    name: 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;
+    /** 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) => Manifest | undefined;
+/** 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;
+/** Every `@ethlete/*` dependency the manifest declares, with the version behind its range. */
+export declare const declaredEthletePackages: (options: {
+    root: string;
+    manifest: Manifest;
+}) => DeclaredPackage[];
+export type RangeWrite = {
+    name: string;
+    field: DependencyField;
+    range: string;
+};
+/**
+ * Writes new ranges into the manifest, keeping its indentation. The 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[];
+}) => void;
+/**
+ * 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,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rangeFor = exports.writeRanges = exports.declaredEthletePackages = exports.installedVersion = exports.readManifest = exports.manifestPath = exports.DEPENDENCY_FIELDS = 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.DEPENDENCY_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies'];
+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, 'package.json');
+exports.manifestPath = manifestPath;
+const readManifest = (root) => {
+    const parsed = readJson((0, exports.manifestPath)(root));
+    return isRecord(parsed) ? parsed : undefined;
+};
+exports.readManifest = readManifest;
+/** 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('/'), 'package.json');
+    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;
+/** Every `@ethlete/*` dependency the manifest declares, with the version behind its range. */
+const declaredEthletePackages = (options) => {
+    var _a;
+    const { root, manifest } = options;
+    const declared = [];
+    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;
+            declared.push({
+                name,
+                field,
+                range,
+                declaredVersion: (0, semver_1.versionOfRange)(range),
+                installedVersion: (0, exports.installedVersion)(root, name),
+            });
+        }
+    }
+    return declared;
+};
+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 manifest, keeping its indentation. The 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 path = (0, exports.manifestPath)(root);
+    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) {
+        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');
+};
+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,52 @@
+import { DeclaredPackage, DependencyField } 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 & {
+    field: DependencyField;
+    /** The range the manifest declares now. */
+    declaredRange: string;
+    /** The dist tag the target came from, absent when the caller named a version. */
+    tag?: string;
+    /** The range to write, or `undefined` when the declared one cannot be rewritten safely. */
+    nextRange?: string;
+};
+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,83 @@
+"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 : declared.declaredVersion;
+    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 };
+    return {
+        update: {
+            name: declared.name,
+            field: declared.field,
+            declaredRange: declared.range,
+            from: declared.installedVersion,
+            to,
+            tag,
+            nextRange: (0, packages_1.rangeFor)({ current: declared.range, version: to }),
+        },
+    };
+};
+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;