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

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":";;;AAAA,iDAA0C;AAC1C,2BAAgC;AAChC,+BAA4B;AAE5B,uDAA8D;AAY9D,0FAA0F;AACnF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CACpC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AADvF,QAAA,KAAK,SACkF;AAEpG,2GAA2G;AACpG,MAAM,aAAa,GAAG,CAAC,OAAkD,EAAE,EAAE;;IAClF,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEtC,OAAO;QACL,UAAU;QACV,MAAA,SAAS,CAAC,SAAS,mCAAI,EAAE;QACzB,qBAAqB;QACrB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAA,SAAS,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,aAAa,iBAUxB;AAEK,MAAM,gBAAgB,GAAG,CAAC,OAKhC,EAAoB,EAAE;IACrB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAA,2BAAS,EAAC;QAClC,OAAO;QACP,IAAI,EAAE,IAAA,qBAAa,EAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;KAC9D,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,sCAAsC,EAAE,CAAC;IAE9G,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAEpF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IAE/G,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC5D,CAAC,CAAC;AArBW,QAAA,gBAAgB,oBAqB3B;AAEK,MAAM,UAAU,GAAG,CAAC,OAAkD,EAAE,EAAE;IAC/E,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAE1C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE7E,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAErE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IAEnH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC,CAAC;AAbW,QAAA,UAAU,cAarB;AAEF,+FAA+F;AACxF,MAAM,sBAAsB,GAAG,CAAC,OAA0D,EAAE,EAAE,CACnG,IAAA,2BAAS,EAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAA,qBAAa,EAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAChH,GAAG,CACJ,CAAC;AAHS,QAAA,sBAAsB,0BAG/B;AAEG,MAAM,oBAAoB,GAAG,CAAC,OAKpC,EAAsB,EAAE;IACvB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,WAAW,GAAG,IAAA,aAAK,EAAC,IAAI,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAE9E,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,6DAA6D;aACtE,CAAC;QACJ,CAAC;QAED,OAAO,IAAA,wBAAgB,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAtBW,QAAA,oBAAoB,wBAsB/B"}

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;

package/src/lib/update/semver.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionOfRange = exports.rangePrefix = exports.prereleaseTag = exports.isValidVersion = exports.isInUpdateRange = exports.isNewer = exports.compareVersions = void 0;
+const NUMERIC = /^\d+$/;
+const parseVersion = (version) => {
+    const [core = '', ...prereleaseParts] = version.split('-');
+    const prerelease = prereleaseParts.join('-');
+    return {
+        numbers: core.split('.').map((part) => Number.parseInt(part, 10) || 0),
+        prerelease: prerelease === '' ? [] : prerelease.split('.'),
+    };
+};
+const comparePrerelease = (left, right) => {
+    // Semver: a version without a prerelease outranks the same version with one.
+    if (left.length === 0 && right.length === 0)
+        return 0;
+    if (left.length === 0)
+        return 1;
+    if (right.length === 0)
+        return -1;
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const leftPart = left[index];
+        const rightPart = right[index];
+        if (leftPart === undefined)
+            return -1;
+        if (rightPart === undefined)
+            return 1;
+        if (NUMERIC.test(leftPart) && NUMERIC.test(rightPart)) {
+            const leftNumber = Number.parseInt(leftPart, 10);
+            const rightNumber = Number.parseInt(rightPart, 10);
+            if (leftNumber !== rightNumber)
+                return leftNumber < rightNumber ? -1 : 1;
+            continue;
+        }
+        if (leftPart !== rightPart)
+            return leftPart < rightPart ? -1 : 1;
+    }
+    return 0;
+};
+/** `-1`, `0` or `1`, prerelease-aware for the `x.y.z-next.N` versions this repo publishes. */
+const compareVersions = (left, right) => {
+    var _a, _b;
+    const parsedLeft = parseVersion(left);
+    const parsedRight = parseVersion(right);
+    for (let index = 0; index < Math.max(parsedLeft.numbers.length, parsedRight.numbers.length); index += 1) {
+        const leftNumber = (_a = parsedLeft.numbers[index]) !== null && _a !== void 0 ? _a : 0;
+        const rightNumber = (_b = parsedRight.numbers[index]) !== null && _b !== void 0 ? _b : 0;
+        if (leftNumber !== rightNumber)
+            return leftNumber < rightNumber ? -1 : 1;
+    }
+    return comparePrerelease(parsedLeft.prerelease, parsedRight.prerelease);
+};
+exports.compareVersions = compareVersions;
+const isNewer = (candidate, than) => (0, exports.compareVersions)(candidate, than) > 0;
+exports.isNewer = isNewer;
+/** True when `version` sits inside `(after, upTo]`, the range a pending migration is selected by. */
+const isInUpdateRange = (options) => (0, exports.compareVersions)(options.version, options.after) > 0 && (0, exports.compareVersions)(options.version, options.upTo) <= 0;
+exports.isInUpdateRange = isInUpdateRange;
+const isValidVersion = (version) => /^\d+\.\d+\.\d+(?:[-+].*)?$/.test(version);
+exports.isValidVersion = isValidVersion;
+/**
+ * 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.
+ */
+const prereleaseTag = (version) => parseVersion(version).prerelease.find((part) => !NUMERIC.test(part));
+exports.prereleaseTag = prereleaseTag;
+/** The `^` or `~` a range keeps, or `''` for an exact one. `undefined` for a range with no single version. */
+const rangePrefix = (range) => {
+    const match = /^([\^~]?)(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)$/.exec(range.trim());
+    return match ? match[1] : undefined;
+};
+exports.rangePrefix = rangePrefix;
+/** The version a range points at, for example `5.0.0-next.46` for `^5.0.0-next.46`. */
+const versionOfRange = (range) => {
+    const match = /^[\^~]?(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)$/.exec(range.trim());
+    return match === null || match === void 0 ? void 0 : match[1];
+};
+exports.versionOfRange = versionOfRange;
+//# sourceMappingURL=semver.js.map

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

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

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

@@ -0,0 +1,58 @@
+import { PackageManager } from './package-manager';
+import { UpdatedPackage } from './plan';
+import { MigrationOutcome } from './run-migrations';
+export declare const UPDATE_DIR: string;
+export declare const TASKS_FILE = "tasks.md";
+export declare const TASKS_DATA_FILE = "tasks.json";
+export declare const DOCS_BASE_URL = "https://ethlete-sdk-docs.web.app";
+export type UpdateTask = {
+    packageName: string;
+    name: string;
+    version: string;
+    kind: 'manual' | 'assisted' | 'unsupported';
+    description: string;
+    /** Repo-relative path of the copied instructions, when the migration ships any. */
+    instructionsFile?: string;
+    docsUrl?: string;
+    /** For an `unsupported` auto migration: the generator command to run by hand. */
+    command?: string;
+};
+export declare const taskFileName: (options: {
+    packageName: string;
+    name: string;
+}) => string;
+/** The tasks an update leaves behind: what needs a decision, a prompt, or a command Nx could not run. */
+export declare const collectTasks: (options: {
+    outcomes: readonly MigrationOutcome[];
+    manager: PackageManager;
+}) => UpdateTask[];
+export declare const renderTasks: (options: {
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    tasks: readonly UpdateTask[];
+}) => string;
+/**
+ * One task as its own file: what moved and where to read more, then the instructions the package ships.
+ * The header is what makes the file readable on its own once the update is over.
+ */
+export declare const renderTaskFile: (options: {
+    task: UpdateTask;
+    instructions: string;
+}) => string;
+export type WrittenTasks = {
+    /** Repo-relative path of the report. */
+    reportPath: string;
+    dataPath: string;
+    tasks: UpdateTask[];
+};
+/**
+ * Writes the report, the machine-readable task list an agent reads, and a copy of every instructions
+ * file, so the whole task list stands on its own once `node_modules` changes again.
+ */
+export declare const writeUpdateTasks: (options: {
+    root: string;
+    updates: readonly UpdatedPackage[];
+    outcomes: readonly MigrationOutcome[];
+    manager: PackageManager;
+    generatedAt: string;
+}) => WrittenTasks;

package/src/lib/update/tasks.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeUpdateTasks = exports.renderTaskFile = exports.renderTasks = exports.collectTasks = exports.taskFileName = exports.DOCS_BASE_URL = exports.TASKS_DATA_FILE = exports.TASKS_FILE = exports.UPDATE_DIR = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const migration_manifest_1 = require("./migration-manifest");
+const run_migrations_1 = require("./run-migrations");
+exports.UPDATE_DIR = (0, path_1.join)('.ethlete', 'update');
+exports.TASKS_FILE = 'tasks.md';
+exports.TASKS_DATA_FILE = 'tasks.json';
+exports.DOCS_BASE_URL = 'https://ethlete-sdk-docs.web.app';
+const withoutScope = (packageName) => packageName.replace('@ethlete/', '');
+const taskFileName = (options) => `${withoutScope(options.packageName)}-${options.name}.md`;
+exports.taskFileName = taskFileName;
+/** The tasks an update leaves behind: what needs a decision, a prompt, or a command Nx could not run. */
+const collectTasks = (options) => {
+    const { outcomes, manager } = options;
+    const tasks = [];
+    for (const outcome of outcomes) {
+        const { migration, packageName, manifestPath } = outcome.pending;
+        const source = (0, migration_manifest_1.instructionsPath)({ manifestPath, migration });
+        const shared = {
+            packageName,
+            name: migration.name,
+            version: migration.version,
+            description: migration.description,
+            instructionsFile: source ? (0, path_1.join)(exports.UPDATE_DIR, (0, exports.taskFileName)({ packageName, name: migration.name })) : undefined,
+            docsUrl: migration.docs ? `${exports.DOCS_BASE_URL}${migration.docs}` : undefined,
+        };
+        if (outcome.state === 'unsupported') {
+            tasks.push(Object.assign(Object.assign({}, shared), { kind: 'unsupported', command: (0, run_migrations_1.manualGeneratorCommand)({ manager, migration }) }));
+            continue;
+        }
+        if (outcome.state !== 'task')
+            continue;
+        if (migration.kind === 'manual' || migration.kind === 'assisted')
+            tasks.push(Object.assign(Object.assign({}, shared), { kind: migration.kind }));
+    }
+    return tasks;
+};
+exports.collectTasks = collectTasks;
+const KIND_HEADINGS = {
+    unsupported: 'Codemods to run by hand',
+    manual: 'Changes that need a decision',
+    assisted: 'Changes an agent can make',
+};
+const renderTask = (task) => [
+    `### ${task.packageName} — ${task.name}`,
+    '',
+    `Landed in ${task.version}. ${task.description}`,
+    ...(task.command ? ['', `Run: \`${task.command}\``] : []),
+    ...(task.instructionsFile ? ['', `Instructions: \`${task.instructionsFile}\``] : []),
+    ...(task.docsUrl ? ['', `Docs: ${task.docsUrl}`] : []),
+    '',
+].join('\n');
+const renderGroup = (kind, tasks) => {
+    const group = tasks.filter((task) => task.kind === kind);
+    if (group.length === 0)
+        return [];
+    return [`## ${KIND_HEADINGS[kind]}`, '', ...group.map(renderTask)];
+};
+const renderTasks = (options) => {
+    const { updates, outcomes, tasks } = options;
+    const applied = outcomes.filter((outcome) => outcome.state === 'applied');
+    const failed = outcomes.filter((outcome) => outcome.state === 'failed');
+    return [
+        '# Ethlete update: what is left to do',
+        '',
+        '`et update` moved these packages:',
+        '',
+        ...updates.map((update) => { var _a; return `- \`${update.name}\`: ${(_a = update.from) !== null && _a !== void 0 ? _a : 'not installed'} → ${update.to}`; }),
+        '',
+        ...(applied.length > 0
+            ? [
+                'It applied these codemods:',
+                '',
+                ...applied.map((outcome) => `- \`${outcome.pending.packageName}\` ${outcome.pending.migration.name} (${outcome.pending.migration.generator})`),
+                '',
+            ]
+            : []),
+        ...(failed.length > 0
+            ? [
+                'These codemods failed. Run each one again by hand and read its output:',
+                '',
+                ...failed.map((outcome) => `- \`${outcome.pending.packageName}\` ${outcome.pending.migration.name} — ${outcome.reason}`),
+                '',
+            ]
+            : []),
+        ...(tasks.length === 0
+            ? ['Nothing else needs a decision.', '']
+            : [
+                'Everything below needs a decision the codemods cannot make.',
+                '',
+                ...renderGroup('unsupported', tasks),
+                ...renderGroup('manual', tasks),
+                ...renderGroup('assisted', tasks),
+            ]),
+    ].join('\n');
+};
+exports.renderTasks = renderTasks;
+/**
+ * One task as its own file: what moved and where to read more, then the instructions the package ships.
+ * The header is what makes the file readable on its own once the update is over.
+ */
+const renderTaskFile = (options) => {
+    const { task, instructions } = options;
+    return [
+        `<!-- Written by et update. ${task.packageName} ${task.version}, migration "${task.name}". -->`,
+        '',
+        ...(task.kind === 'assisted'
+            ? ['> Hand this file to an agent. It describes one change to apply across this repository.', '']
+            : []),
+        `- Package: \`${task.packageName}\``,
+        `- Landed in: ${task.version}`,
+        `- Summary: ${task.description}`,
+        ...(task.docsUrl ? [`- Docs: ${task.docsUrl}`] : []),
+        '',
+        '---',
+        '',
+        instructions.trim(),
+    ].join('\n');
+};
+exports.renderTaskFile = renderTaskFile;
+/**
+ * Writes the report, the machine-readable task list an agent reads, and a copy of every instructions
+ * file, so the whole task list stands on its own once `node_modules` changes again.
+ */
+const writeUpdateTasks = (options) => {
+    const { root, updates, outcomes, manager, generatedAt } = options;
+    const tasks = (0, exports.collectTasks)({ outcomes, manager });
+    const directory = (0, path_1.join)(root, exports.UPDATE_DIR);
+    (0, fs_1.mkdirSync)(directory, { recursive: true });
+    for (const outcome of outcomes) {
+        const source = (0, migration_manifest_1.instructionsPath)({
+            manifestPath: outcome.pending.manifestPath,
+            migration: outcome.pending.migration,
+        });
+        const task = tasks.find((candidate) => candidate.packageName === outcome.pending.packageName && candidate.name === outcome.pending.migration.name);
+        if (!source || !task)
+            continue;
+        (0, fs_1.writeFileSync)((0, path_1.join)(directory, (0, exports.taskFileName)({ packageName: task.packageName, name: task.name })), `${(0, exports.renderTaskFile)({ task, instructions: (0, fs_1.readFileSync)(source, 'utf8') })}\n`, 'utf8');
+    }
+    const reportPath = (0, path_1.join)(exports.UPDATE_DIR, exports.TASKS_FILE);
+    const dataPath = (0, path_1.join)(exports.UPDATE_DIR, exports.TASKS_DATA_FILE);
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, reportPath), `${(0, exports.renderTasks)({ updates, outcomes, tasks })}\n`, 'utf8');
+    (0, fs_1.writeFileSync)((0, path_1.join)(root, dataPath), `${JSON.stringify({
+        generatedAt,
+        updates: updates.map((update) => { var _a; return ({ package: update.name, from: (_a = update.from) !== null && _a !== void 0 ? _a : null, to: update.to }); }),
+        applied: outcomes
+            .filter((outcome) => outcome.state === 'applied')
+            .map((outcome) => {
+            var _a;
+            return ({
+                package: outcome.pending.packageName,
+                name: outcome.pending.migration.name,
+                generator: (_a = outcome.pending.migration.generator) !== null && _a !== void 0 ? _a : null,
+            });
+        }),
+        failed: outcomes
+            .filter((outcome) => outcome.state === 'failed')
+            .map((outcome) => {
+            var _a;
+            return ({
+                package: outcome.pending.packageName,
+                name: outcome.pending.migration.name,
+                reason: (_a = outcome.reason) !== null && _a !== void 0 ? _a : null,
+            });
+        }),
+        tasks,
+    }, null, 2)}\n`, 'utf8');
+    return { reportPath, dataPath, tasks };
+};
+exports.writeUpdateTasks = writeUpdateTasks;
+//# sourceMappingURL=tasks.js.map

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

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

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

@@ -0,0 +1,12 @@
+export type UpdateCommandOptions = {
+    /** Arguments after `update`, for example `['core', '--tag', 'next']`. */
+    argv: string[];
+    root?: string;
+    /** How the caller is invoked, used in the usage line. */
+    invocation?: string;
+};
+/**
+ * Moves this repo's `@ethlete/*` dependencies to a newer version and runs the migrations those versions
+ * ship. Everything the codemods cannot decide is written to a task list under `.ethlete/update`.
+ */
+export declare const updateCommand: ({ argv, root, invocation, }: UpdateCommandOptions) => Promise<number>;