@strapi/upgrade 0.0.0-experimental.00380841fe1b29f71fe755bb387fa1f75073621b

package/LICENSE

@@ -0,0 +1,37 @@
+Copyright (c) 2015-present Strapi Solutions SAS
+
+Portions of the Strapi software are licensed as follows:
+
+* All software that resides under an "ee/" directory (the “EE Software”), if that directory exists, is licensed under the license defined below.
+
+Enterprise License
+
+If you or the company you represent has entered into a written agreement referencing the Enterprise Edition of the Strapi source code available at
+https://github.com/strapi/strapi, then such agreement applies to your use of the Enterprise Edition of the Strapi Software. If you or the company you
+represent is using the Enterprise Edition of the Strapi Software in connection with a subscription to our cloud offering, then the agreement you have
+agreed to with respect to our cloud offering and the licenses included in such agreement apply to your use of the Enterprise Edition of the Strapi Software.
+Otherwise, the Strapi Enterprise Software License Agreement (found here https://strapi.io/enterprise-terms) applies to your use of the Enterprise Edition of the Strapi Software.
+
+BY ACCESSING OR USING THE ENTERPRISE EDITION OF THE STRAPI SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE RELEVANT REFERENCED AGREEMENT.
+IF YOU ARE NOT AUTHORIZED TO ACCEPT THESE TERMS ON BEHALF OF THE COMPANY YOU REPRESENT OR IF YOU DO NOT AGREE TO ALL OF THE RELEVANT TERMS AND CONDITIONS REFERENCED AND YOU
+HAVE NOT OTHERWISE EXECUTED A WRITTEN AGREEMENT WITH STRAPI, YOU ARE NOT AUTHORIZED TO ACCESS OR USE OR ALLOW ANY USER TO ACCESS OR USE ANY PART OF
+THE ENTERPRISE EDITION OF THE STRAPI SOFTWARE.  YOUR ACCESS RIGHTS ARE CONDITIONAL ON YOUR CONSENT TO THE RELEVANT REFERENCED TERMS TO THE EXCLUSION OF ALL OTHER TERMS;
+IF THE RELEVANT REFERENCED TERMS ARE CONSIDERED AN OFFER BY YOU, ACCEPTANCE IS EXPRESSLY LIMITED TO THE RELEVANT REFERENCED TERMS.
+
+* All software outside of the above-mentioned directories or restrictions above is available under the "MIT Expat" license as set forth below.
+
+MIT Expat License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# Strapi Upgrade Tool
+
+## Description
+
+The Strapi Upgrade Tool is the CLI for facilitating upgrades between Strapi versions.
+
+It handles updating a project's package.json with the correct version of Strapi, running the package installer, and running suggested code transforms for breaking changes (in major versions).
+
+Once released, it will be the recommended way to update to any major, minor, and patch versions of Strapi instead of manually modifying package.json files.
+
+The tool offers the following commands:
+
+```
+  major [options]     Upgrade to the next available major version of Strapi
+  minor [options]     Upgrade to the latest minor and patch version of Strapi for the
+                      current major
+  patch [options]     Upgrade to latest patch version of Strapi for the current major
+                      and minor
+  codemods [options]  Run a set of available codemods for the selected target version
+                      without updating the Strapi dependencies
+```
+
+### What's a codemod / code transform?
+
+Codemods are a scripted way to refactor code. Here we are providing and running these scripts for users for any changes necessary in user code between Strapi versions.
+
+For example, if we need to rename a package used by Strapi projects, instead of instructing users to change the import, we provide a script that searches through the user's project and does the replacement for them.
+
+### Types of Transforms
+
+The upgrade tool provides two types of transforms:
+
+- `json`: for updating a project's .json files, primarily intended for the `package.json`
+- `code`: codemods; for updating a project's .js and .ts files
+
+### Data Migrations
+
+Data migrations are not handled by the upgrade tool.
+
+For Strapi v4, no data migrations will be allowed and no support is planned (except in extenuating circumstances eg, a critical security issue somehow relating to the database shape)
+
+For Strapi v5, automated data migrations can be added in the `packages/core/database` package of the `develop` branch of this repo.
+
+## Usage
+
+This package is not yet released, so currently it can be run on a project in the monorepo /examples directory with the following command:
+
+`../../packages/utils/upgrade/bin/upgrade`
+
+Run the command with the `--help` option to see all the available options.
+
+[Coming Soon] The Strapi Upgrade tool will be available using `npx @strapi/upgrade` and an alias for that within a project using `strapi upgrade`
+
+## Writing a code transforms
+
+To begin your code transform script, create a file `upgrade/resources/codemods/{X.X.X}/{short-description-of-action}.{code|json}.ts` where `X.X.X` is the target version of Strapi the codemod will be run for.
+
+For example, all breaking changes for the initial release of Strapi v5 will go in `upgrade/resources/codemods/5.0.0`
+
+Note that "short-description-of-action" will be converted to text displayed to the user with hyphens converted to spaces, for example: "short description of action"
+
+### 'json' transforms
+
+Your transform will be called for every json file in a user's project, and you must return the json object (modified or not) at the end to be passed to the next transform.
+
+Here is an example JSON Transform script:
+
+```typescript
+import path from 'node:path';
+
+import type { JSONTransform } from '../../..';
+
+const transform: JSONTransform = (file, params) => {
+  // Extract the json api and the cwd so we can target specific files
+  const { cwd, json } = params;
+
+  // To target only a root level package.json file:
+  const rootPackageJsonPath = path.join(cwd, 'package.json');
+  if (file.path !== rootPackageJsonPath) {
+    // Return the json object unmodified to pass it to the next transform
+    return file.json;
+  }
+
+  // Use json() to get useful helpers for performing your transform
+  const j = json(file.json);
+
+  const strapiDepAddress = 'dependencies.@strapi/strapi';
+
+  // if this file contains a value at dependencies.@strapi/strapi
+  if (j.has(strapiDepAddress)) {
+    // we set the value to 5.0.0
+    j.set(strapiDepAddress, '5.0.0');
+  }
+
+  // at the end we must return the modified json object
+  return j.root();
+};
+
+export default transform;
+```
+
+For reference, these are the types for the relevant objects, which can be found in `packages/utils/upgrade/src/modules/json/types.ts`:
+
+```typescript
+export interface JSONTransformParams {
+  cwd: string;
+  json: (object: Utils.JSONObject) => JSONTransformAPI;
+}
+
+export interface JSONTransformAPI {
+  get<T extends Utils.JSONValue>(path?: string, defaultValue?: T): T | undefined;
+  has(path: string): boolean;
+  set(path: string, value: Utils.JSONValue): this;
+  merge(other: Utils.JSONObject): this;
+  root(): Utils.JSONObject;
+  remove(path: string): this;
+}
+
+export type JSONTransform = (file: JSONSourceFile, params: JSONTransformParams) => Utils.JSONObject;
+```
+
+The methods available from `json()` are wrappers for the lodash methods of the same name:
+
+- **get(path, default)**: get path or default if not found
+- **set(path, value)**: set path (such as 'engines.node', 'dependencies', 'author.name') to value
+- **has(path)**: checks if path exists
+- **merge(obj)**: merges two json objects
+- **root()**: returns the whole json object
+- **remove(path)**: removes the attribute given the path (such as 'dependencies.strapi')
+
+### 'code' codemod transforms
+
+Codemod transforms use the [`jscodeshift`](https://github.com/facebook/jscodeshift) library to modify code passed in. Please see their documentation for advanced details.
+
+The `file` and `api` parameters come directly from the [jsoncodeshift arguments of the same name](https://github.com/facebook/jscodeshift#arguments).
+
+```typescript
+import type { Transform } from 'jscodeshift';
+
+const transform: Transform = (file, api) => {
+  // Extract the jscodeshift API
+  const { j } = api;
+  // Parse the file content
+  const root = j(file.source);
+
+  root
+    // Find console.log calls expressions
+    .find(j.CallExpression, {
+      callee: { object: { name: 'console' }, property: { name: 'log' } },
+    })
+    // For each call expression
+    .forEach((path) => {
+      const { callee } = path.node;
+
+      if (
+        // Make sure the callee is a member expression (object/property)
+        j.MemberExpression.check(callee) &&
+        // Make sure the property is an actual identifier (contains a name property)
+        j.Identifier.check(callee.property)
+      ) {
+        // Update the property's identifier name
+        callee.property.name = 'info';
+      }
+    });
+
+  // Return the updated file content
+  return root.toSource();
+};
+
+export default transform;
+```

package/bin/upgrade.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli.js');

package/dist/cli.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var os = require('os');
+var chalk = require('chalk');
+var commander = require('commander');
+var upgrade = require('./src/cli/commands/upgrade.js');
+var codemods = require('./src/cli/commands/codemods.js');
+var _package = require('./package.json.js');
+
+upgrade.register(commander.program);
+codemods.register(commander.program);
+commander.program.usage('<command> [options]').on('command:*', ([invalidCmd])=>{
+    console.error(chalk.red(`[ERROR] Invalid command: ${invalidCmd}.${os.EOL} See --help for a list of available commands.`));
+    process.exit(1);
+}).helpOption('-h, --help', 'Print command line options').addHelpCommand('help [command]', 'Print options for a specific command').version(_package.version).parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli/index.ts"],"sourcesContent":["import os from 'os';\nimport chalk from 'chalk';\nimport { program } from 'commander';\n\nimport { register as registerUpgradeCommands } from './commands/upgrade';\nimport { register as registerCodemodsCommands } from './commands/codemods';\n\nimport { version as packageJSONVersion } from '../../package.json';\n\nregisterUpgradeCommands(program);\nregisterCodemodsCommands(program);\n\nprogram\n  .usage('<command> [options]')\n  .on('command:*', ([invalidCmd]) => {\n    console.error(\n      chalk.red(\n        `[ERROR] Invalid command: ${invalidCmd}.${os.EOL} See --help for a list of available commands.`\n      )\n    );\n\n    process.exit(1);\n  })\n  .helpOption('-h, --help', 'Print command line options')\n  .addHelpCommand('help [command]', 'Print options for a specific command')\n  .version(packageJSONVersion)\n  .parse(process.argv);\n"],"names":["registerUpgradeCommands","program","registerCodemodsCommands","usage","on","invalidCmd","console","error","chalk","red","os","EOL","process","exit","helpOption","addHelpCommand","version","packageJSONVersion","parse","argv"],"mappings":";;;;;;;;;AASAA,gBAAwBC,CAAAA,iBAAAA,CAAAA;AACxBC,iBAAyBD,CAAAA,iBAAAA,CAAAA;AAEzBA,iBACGE,CAAAA,KAAK,CAAC,qBACNC,CAAAA,CAAAA,EAAE,CAAC,WAAa,EAAA,CAAC,CAACC,UAAW,CAAA,GAAA;AAC5BC,IAAAA,OAAAA,CAAQC,KAAK,CACXC,KAAMC,CAAAA,GAAG,CACP,CAAC,yBAAyB,EAAEJ,UAAAA,CAAW,CAAC,EAAEK,EAAAA,CAAGC,GAAG,CAAC,6CAA6C,CAAC,CAAA,CAAA;AAInGC,IAAAA,OAAAA,CAAQC,IAAI,CAAC,CAAA,CAAA;AACf,CAAA,CAAA,CACCC,UAAU,CAAC,YAAc,EAAA,4BAAA,CAAA,CACzBC,cAAc,CAAC,gBAAA,EAAkB,sCACjCC,CAAAA,CAAAA,OAAO,CAACC,gBAAAA,CAAAA,CACRC,KAAK,CAACN,QAAQO,IAAI,CAAA;;"}

package/dist/cli.mjs

@@ -0,0 +1,14 @@
+import os from 'os';
+import chalk from 'chalk';
+import { program } from 'commander';
+import { register } from './src/cli/commands/upgrade.mjs';
+import { register as register$1 } from './src/cli/commands/codemods.mjs';
+import { version } from './package.json.mjs';
+
+register(program);
+register$1(program);
+program.usage('<command> [options]').on('command:*', ([invalidCmd])=>{
+    console.error(chalk.red(`[ERROR] Invalid command: ${invalidCmd}.${os.EOL} See --help for a list of available commands.`));
+    process.exit(1);
+}).helpOption('-h, --help', 'Print command line options').addHelpCommand('help [command]', 'Print options for a specific command').version(version).parse(process.argv);
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sources":["../src/cli/index.ts"],"sourcesContent":["import os from 'os';\nimport chalk from 'chalk';\nimport { program } from 'commander';\n\nimport { register as registerUpgradeCommands } from './commands/upgrade';\nimport { register as registerCodemodsCommands } from './commands/codemods';\n\nimport { version as packageJSONVersion } from '../../package.json';\n\nregisterUpgradeCommands(program);\nregisterCodemodsCommands(program);\n\nprogram\n  .usage('<command> [options]')\n  .on('command:*', ([invalidCmd]) => {\n    console.error(\n      chalk.red(\n        `[ERROR] Invalid command: ${invalidCmd}.${os.EOL} See --help for a list of available commands.`\n      )\n    );\n\n    process.exit(1);\n  })\n  .helpOption('-h, --help', 'Print command line options')\n  .addHelpCommand('help [command]', 'Print options for a specific command')\n  .version(packageJSONVersion)\n  .parse(process.argv);\n"],"names":["registerUpgradeCommands","program","registerCodemodsCommands","usage","on","invalidCmd","console","error","chalk","red","os","EOL","process","exit","helpOption","addHelpCommand","version","packageJSONVersion","parse","argv"],"mappings":";;;;;;;AASAA,QAAwBC,CAAAA,OAAAA,CAAAA;AACxBC,UAAyBD,CAAAA,OAAAA,CAAAA;AAEzBA,OACGE,CAAAA,KAAK,CAAC,qBACNC,CAAAA,CAAAA,EAAE,CAAC,WAAa,EAAA,CAAC,CAACC,UAAW,CAAA,GAAA;AAC5BC,IAAAA,OAAAA,CAAQC,KAAK,CACXC,KAAMC,CAAAA,GAAG,CACP,CAAC,yBAAyB,EAAEJ,UAAAA,CAAW,CAAC,EAAEK,EAAAA,CAAGC,GAAG,CAAC,6CAA6C,CAAC,CAAA,CAAA;AAInGC,IAAAA,OAAAA,CAAQC,IAAI,CAAC,CAAA,CAAA;AACf,CAAA,CAAA,CACCC,UAAU,CAAC,YAAc,EAAA,4BAAA,CAAA,CACzBC,cAAc,CAAC,gBAAA,EAAkB,sCACjCC,CAAAA,CAAAA,OAAO,CAACC,OAAAA,CAAAA,CACRC,KAAK,CAACN,QAAQO,IAAI,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * as tasks from './tasks';
+export * as modules from './modules';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+'use strict';
+
+var index = require('./src/tasks/index.js');
+var index$1 = require('./src/modules/index.js');
+
+
+
+exports.tasks = index;
+exports.modules = index$1;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import * as index from './src/tasks/index.mjs';
+export { index as tasks };
+import * as index$1 from './src/modules/index.mjs';
+export { index$1 as modules };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/modules/codemod/codemod.d.ts

@@ -0,0 +1,17 @@
+import type { Codemod as CodemodInterface, FormatOptions, Kind, UID } from './types';
+import type { Version } from '../version';
+type CreateCodemodPayload = Pick<CodemodInterface, 'kind' | 'version' | 'baseDirectory' | 'filename'>;
+export declare class Codemod implements CodemodInterface {
+    uid: UID;
+    kind: Kind;
+    version: Version.SemVer;
+    baseDirectory: string;
+    filename: string;
+    path: string;
+    constructor(options: CreateCodemodPayload);
+    private createUID;
+    format(options?: FormatOptions): string;
+}
+export declare const codemodFactory: (options: CreateCodemodPayload) => Codemod;
+export {};
+//# sourceMappingURL=codemod.d.ts.map

package/dist/modules/codemod/codemod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod/codemod.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,KAAK,oBAAoB,GAAG,IAAI,CAC9B,gBAAgB,EAChB,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,CAClD,CAAC;AAEF,qBAAa,OAAQ,YAAW,gBAAgB;IAC9C,GAAG,EAAE,GAAG,CAAC;IAET,IAAI,EAAE,IAAI,CAAC;IAEX,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;IAExB,aAAa,EAAE,MAAM,CAAC;IAEtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,oBAAoB;IAUzC,OAAO,CAAC,SAAS;IAQjB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa;CAqB/B;AAED,eAAO,MAAM,cAAc,YAAa,oBAAoB,YAAyB,CAAC"}

package/dist/modules/codemod/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CODEMOD_CODE_SUFFIX = "code";
+export declare const CODEMOD_JSON_SUFFIX = "json";
+export declare const CODEMOD_ALLOWED_SUFFIXES: string[];
+export declare const CODEMOD_EXTENSION = "ts";
+export declare const CODEMOD_FILE_REGEXP: RegExp;
+//# sourceMappingURL=constants.d.ts.map

package/dist/modules/codemod/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,wBAAwB,UAA6C,CAAC;AAEnF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,eAAO,MAAM,mBAAmB,QAE/B,CAAC"}

package/dist/modules/codemod/index.d.ts

@@ -0,0 +1,4 @@
+export type * as Codemod from './types';
+export { codemodFactory } from './codemod';
+export * as constants from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/codemod/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod/index.ts"],"names":[],"mappings":"AAAA,YAAY,KAAK,OAAO,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}

package/dist/modules/codemod/types.d.ts

@@ -0,0 +1,26 @@
+import type { Version } from '../version';
+export type Kind = 'code' | 'json';
+export type UID = `${Version.LiteralSemVer}-${string}-${Kind}`;
+export interface Codemod {
+    uid: UID;
+    kind: Kind;
+    version: Version.SemVer;
+    baseDirectory: string;
+    filename: string;
+    path: string;
+    /**
+     * Return a formatted version of the codemod name
+     */
+    format(options?: FormatOptions): string;
+}
+export interface FormatOptions {
+    stripKind?: boolean;
+    stripExtension?: boolean;
+    stripHyphens?: boolean;
+}
+export type List = Codemod[];
+export interface VersionedCollection {
+    version: Version.SemVer;
+    codemods: List;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/codemod/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AACnC,MAAM,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;AAE/D,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;IACxB,QAAQ,EAAE,IAAI,CAAC;CAChB"}

package/dist/modules/codemod-repository/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const INTERNAL_CODEMODS_DIRECTORY: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/modules/codemod-repository/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-repository/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,QAQvC,CAAC"}

package/dist/modules/codemod-repository/index.d.ts

@@ -0,0 +1,4 @@
+export type * from './types';
+export { codemodRepositoryFactory } from './repository';
+export * as constants from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/codemod-repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-repository/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAC;AAE7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC"}

package/dist/modules/codemod-repository/repository.d.ts

@@ -0,0 +1,22 @@
+import type { Codemod } from '../codemod';
+import type { Version } from '../version';
+import type { CodemodRepository as CodemodRepositoryInterface, FindQuery } from './types';
+export declare class CodemodRepository implements CodemodRepositoryInterface {
+    private groups;
+    private versions;
+    cwd: string;
+    constructor(cwd: string);
+    refresh(): this;
+    count(version: Version.SemVer): number;
+    versionExists(version: Version.SemVer): boolean;
+    has(uid: string): boolean;
+    find(q: FindQuery): Codemod.VersionedCollection[];
+    findByVersion(version: Version.SemVer): Codemod.Codemod[];
+    findAll(): Codemod.VersionedCollection[];
+    private refreshAvailableVersions;
+    private refreshAvailableFiles;
+    private refreshAvailableFilesForVersion;
+}
+export declare const parseCodemodKindFromFilename: (filename: string) => Codemod.Kind;
+export declare const codemodRepositoryFactory: (cwd?: string) => CodemodRepository;
+//# sourceMappingURL=repository.d.ts.map

package/dist/modules/codemod-repository/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-repository/repository.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,IAAI,0BAA0B,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE1F,qBAAa,iBAAkB,YAAW,0BAA0B;IAClE,OAAO,CAAC,MAAM,CAAmD;IAEjE,OAAO,CAAC,QAAQ,CAAmB;IAE5B,GAAG,EAAE,MAAM,CAAC;gBAEP,GAAG,EAAE,MAAM;IASvB,OAAO;IAOP,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM;IAI7B,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM;IAIrC,GAAG,CAAC,GAAG,EAAE,MAAM;IAYf,IAAI,CAAC,CAAC,EAAE,SAAS;IAkCjB,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM;IAOrC,OAAO;IASP,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,+BAA+B;CAsBxC;AAED,eAAO,MAAM,4BAA4B,aAAc,MAAM,KAAG,QAAQ,IAOvE,CAAC;AAEF,eAAO,MAAM,wBAAwB,SAAS,MAAM,sBAEnD,CAAC"}

package/dist/modules/codemod-repository/types.d.ts

@@ -0,0 +1,16 @@
+import type { Codemod } from '../codemod';
+import type { Version } from '../version';
+export interface FindQuery {
+    range?: Version.Range;
+    uids?: string[];
+}
+export interface CodemodRepository {
+    cwd: string;
+    refresh(): this;
+    find(query: FindQuery): Codemod.VersionedCollection[];
+    findByVersion(version: Version.SemVer): Codemod.List;
+    versionExists(version: Version.SemVer): boolean;
+    has(uid: string): boolean;
+    count(version: Version.SemVer): number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/codemod-repository/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-repository/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,OAAO,IAAI,IAAI,CAAC;IAEhB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAEtD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAErD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;CACxC"}

package/dist/modules/codemod-runner/codemod-runner.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from '../logger';
+import type { Project } from '../project';
+import type { CodemodRunnerInterface, CodemodRunnerReport, SelectCodemodsCallback } from './types';
+import type { Version } from '../version';
+export declare class CodemodRunner implements CodemodRunnerInterface {
+    private readonly project;
+    private range;
+    private isDry;
+    private logger;
+    private selectCodemodsCallback;
+    constructor(project: Project, range: Version.Range);
+    setRange(range: Version.Range): this;
+    setLogger(logger: Logger): this;
+    onSelectCodemods(callback: SelectCodemodsCallback | null): this;
+    dry(enabled?: boolean): this;
+    private createRepository;
+    private safeRunAndReport;
+    runByUID(uid: string, codemodsDirectory?: string): Promise<CodemodRunnerReport>;
+    run(codemodsDirectory?: string): Promise<CodemodRunnerReport>;
+}
+export declare const codemodRunnerFactory: (project: Project, range: Version.Range) => CodemodRunner;
+//# sourceMappingURL=codemod-runner.d.ts.map

package/dist/modules/codemod-runner/codemod-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod-runner.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-runner/codemod-runner.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,aAAc,YAAW,sBAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,KAAK,CAAgB;IAE7B,OAAO,CAAC,KAAK,CAAU;IAEvB,OAAO,CAAC,MAAM,CAAgB;IAE9B,OAAO,CAAC,sBAAsB,CAAgC;gBAElD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK;IAUlD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK;IAK7B,SAAS,CAAC,MAAM,EAAE,MAAM;IAKxB,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAKxD,GAAG,CAAC,OAAO,GAAE,OAAc;IAK3B,OAAO,CAAC,gBAAgB;YAWV,gBAAgB;IA4BxB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAa/E,GAAG,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmCpE;AAED,eAAO,MAAM,oBAAoB,YAAa,OAAO,SAAS,aAAa,kBAE1E,CAAC"}

package/dist/modules/codemod-runner/index.d.ts

@@ -0,0 +1,3 @@
+export type * from './types';
+export { codemodRunnerFactory } from './codemod-runner';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/codemod-runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-runner/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/modules/codemod-runner/types.d.ts

@@ -0,0 +1,20 @@
+import { Codemod } from '../codemod';
+import type { Logger } from '../logger';
+import type { Version } from '../version';
+export type SelectCodemodsCallback = (codemods: Codemod.VersionedCollection[]) => Promise<Codemod.VersionedCollection[]>;
+export type CodemodRunnerReport = {
+    success: true;
+    error: null;
+} | {
+    success: false;
+    error: Error;
+};
+export interface CodemodRunnerInterface {
+    setRange(range: Version.Range): this;
+    setLogger(logger: Logger): this;
+    dry(enabled?: boolean): this;
+    onSelectCodemods(callback: SelectCodemodsCallback | null): this;
+    run(codemodsDirectory?: string): Promise<CodemodRunnerReport>;
+    runByUID(uid: string, codemodsDirectory?: string): Promise<CodemodRunnerReport>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/codemod-runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/codemod-runner/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,sBAAsB,GAAG,CACnC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,EAAE,KACpC,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAC3B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC;IAEhE,GAAG,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjF"}

package/dist/modules/common/types.d.ts

@@ -0,0 +1,3 @@
+import { MaybePromise } from '../../types';
+export type ConfirmationCallback = (message: string) => MaybePromise<boolean>;
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC,OAAO,CAAC,CAAC"}

package/dist/modules/error/index.d.ts

@@ -0,0 +1,2 @@
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/modules/error/utils.d.ts

@@ -0,0 +1,13 @@
+import type { Version } from '../version';
+export declare class UnexpectedError extends Error {
+    constructor();
+}
+export declare class NPMCandidateNotFoundError extends Error {
+    target: Version.SemVer | Version.Range | Version.ReleaseType;
+    constructor(target: Version.SemVer | Version.Range | Version.ReleaseType, message?: string);
+}
+export declare class AbortedError extends Error {
+    constructor(message?: string);
+}
+export declare const unknownToError: (e: unknown) => Error;
+//# sourceMappingURL=utils.d.ts.map

package/dist/modules/error/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/modules/error/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,qBAAa,eAAgB,SAAQ,KAAK;;CAIzC;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;gBAG3D,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,WAAW,EAC5D,OAAO,GAAE,MAA8D;CAM1E;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,GAAE,MAA0B;CAGhD;AAED,eAAO,MAAM,cAAc,MAAO,OAAO,KAAG,KAU3C,CAAC"}

package/dist/modules/file-scanner/index.d.ts

@@ -0,0 +1,3 @@
+export type * from './types';
+export { fileScannerFactory } from './scanner';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/file-scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/file-scanner/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,SAAS,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/modules/file-scanner/scanner.d.ts

@@ -0,0 +1,8 @@
+import type { FileScanner as FileScannerInterface } from './types';
+export declare class FileScanner implements FileScannerInterface {
+    cwd: string;
+    constructor(cwd: string);
+    scan(patterns: string[]): string[];
+}
+export declare const fileScannerFactory: (cwd: string) => FileScanner;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/modules/file-scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/modules/file-scanner/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEnE,qBAAa,WAAY,YAAW,oBAAoB;IAC/C,GAAG,EAAE,MAAM,CAAC;gBAEP,GAAG,EAAE,MAAM;IAIvB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE;CASxB;AAED,eAAO,MAAM,kBAAkB,QAAS,MAAM,gBAAyB,CAAC"}

package/dist/modules/file-scanner/types.d.ts

@@ -0,0 +1,5 @@
+export interface FileScanner {
+    cwd: string;
+    scan(patterns: string[]): string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/modules/file-scanner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/file-scanner/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CACpC"}

package/dist/modules/format/formats.d.ts

@@ -0,0 +1,17 @@
+import type { AppProject, PluginProject, ProjectType } from '../project';
+import type { Codemod } from '../codemod';
+import type { Version } from '../version';
+import type { Report } from '../report';
+export declare const path: (path: string) => string;
+export declare const version: (version: Version.LiteralVersion | Version.SemVer) => string;
+export declare const codemodUID: (uid: string) => string;
+export declare const projectDetails: (project: AppProject | PluginProject) => string;
+export declare const projectType: (type: ProjectType) => string;
+export declare const versionRange: (range: Version.Range) => string;
+export declare const transform: (transformFilePath: string) => string;
+export declare const highlight: (arg: unknown) => string;
+export declare const upgradeStep: (text: string, step: [current: number, total: number]) => string;
+export declare const reports: (reports: Report.CodemodReport[]) => string;
+export declare const codemodList: (codemods: Codemod.List) => string;
+export declare const durationMs: (elapsedMs: number) => string;
+//# sourceMappingURL=formats.d.ts.map

package/dist/modules/format/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/modules/format/formats.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,IAAI,SAAU,MAAM,WAAqB,CAAC;AAEvD,eAAO,MAAM,OAAO,YAAa,QAAQ,cAAc,GAAG,QAAQ,MAAM,WAEvE,CAAC;AAEF,eAAO,MAAM,UAAU,QAAS,MAAM,WAErC,CAAC;AAEF,eAAO,MAAM,cAAc,YAAa,UAAU,GAAG,aAAa,WAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,SAAU,WAAW,WAAqB,CAAC;AAEnE,eAAO,MAAM,YAAY,UAAW,aAAa,WAAmC,CAAC;AAErF,eAAO,MAAM,SAAS,sBAAuB,MAAM,WAAkC,CAAC;AAEtF,eAAO,MAAM,SAAS,QAAS,OAAO,WAA8B,CAAC;AAErE,eAAO,MAAM,WAAW,SAAU,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,WAE/E,CAAC;AAEF,eAAO,MAAM,OAAO,YAAa,OAAO,aAAa,EAAE,WAgCtD,CAAC;AAEF,eAAO,MAAM,WAAW,oCA2BvB,CAAC;AAEF,eAAO,MAAM,UAAU,cAAe,MAAM,WAI3C,CAAC"}

package/dist/modules/format/index.d.ts

@@ -0,0 +1,2 @@
+export * from './formats';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/format/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/modules/index.d.ts

@@ -0,0 +1,14 @@
+export * as codemod from './codemod';
+export * as codemodRepository from './codemod-repository';
+export * as error from './error';
+export * as fileScanner from './file-scanner';
+export * as f from './format';
+export * as logger from './logger';
+export * as project from './project';
+export * as report from './report';
+export * as requirement from './requirement';
+export * as runner from './runner';
+export * as timer from './timer';
+export * as upgrader from './upgrader';
+export * as version from './version';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,WAAW,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}