@metamask/snaps-cli 5.1.0 → 6.0.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [6.0.0]
+### Changed
+- **BREAKING:** Update ESM build to be fully compliant with the ESM standard ([#2210](https://github.com/MetaMask/snaps/pull/2210))
+- **BREAKING:** Change config to use Webpack by default ([#2214](https://github.com/MetaMask/snaps/pull/2214))
+  - You can still use Browserify by specifying `bundler: 'browserify'`.
+
+## [5.1.1]
+### Fixed
+- Support new lines in CLI message formatting ([#2194](https://github.com/MetaMask/snaps/pull/2194))
+
 ## [5.1.0]
 ### Changed
 - Optimize CLI Webpack configuration ([#2175](https://github.com/MetaMask/snaps/pull/2175))
@@ -109,7 +119,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - The version of the package no longer needs to match the version of all other
     MetaMask Snaps packages.
 
-[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@5.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@6.0.0...HEAD
+[6.0.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@5.1.1...@metamask/snaps-cli@6.0.0
+[5.1.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@5.1.0...@metamask/snaps-cli@5.1.1
 [5.1.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@5.0.0...@metamask/snaps-cli@5.1.0
 [5.0.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@4.0.1...@metamask/snaps-cli@5.0.0
 [4.0.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-cli@4.0.0...@metamask/snaps-cli@4.0.1

package/dist/builders.js

@@ -0,0 +1,10 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk6NJAXMSBjs = require('./chunk-6NJAXMSB.js');
+require('./chunk-X3D3MHWF.js');
+
+
+
+exports.TranspilationModes = _chunk6NJAXMSBjs.TranspilationModes; exports.default = _chunk6NJAXMSBjs.builders_default;
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/builders.mjs

@@ -0,0 +1,10 @@
+import {
+  TranspilationModes,
+  builders_default
+} from "./chunk-ZOQ32RQI.mjs";
+import "./chunk-T74IXMA3.mjs";
+export {
+  TranspilationModes,
+  builders_default as default
+};
+//# sourceMappingURL=builders.mjs.map

package/dist/builders.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-25SLEORF.mjs

@@ -0,0 +1,28 @@
+import {
+  getCompiler
+} from "./chunk-WKL7DYYW.mjs";
+
+// src/commands/build/implementation.ts
+async function build(config, options) {
+  const compiler = await getCompiler(config, options);
+  return await new Promise((resolve, reject) => {
+    compiler.run((runError) => {
+      if (runError) {
+        reject(runError);
+        return;
+      }
+      compiler.close((closeError) => {
+        if (closeError) {
+          reject(closeError);
+          return;
+        }
+        resolve();
+      });
+    });
+  });
+}
+
+export {
+  build
+};
+//# sourceMappingURL=chunk-25SLEORF.mjs.map

package/dist/chunk-25SLEORF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/build/implementation.ts"],"sourcesContent":["import type { ProcessedWebpackConfig } from '../../config';\nimport type { WebpackOptions } from '../../webpack';\nimport { getCompiler } from '../../webpack';\n\n/**\n * Build the snap bundle. This uses Webpack to build the bundle.\n *\n * @param config - The config object.\n * @param options - The Webpack options.\n * @returns A promise that resolves when the bundle is built.\n */\nexport async function build(\n  config: ProcessedWebpackConfig,\n  options?: WebpackOptions,\n) {\n  const compiler = await getCompiler(config, options);\n  return await new Promise<void>((resolve, reject) => {\n    compiler.run((runError) => {\n      if (runError) {\n        reject(runError);\n        return;\n      }\n\n      compiler.close((closeError) => {\n        if (closeError) {\n          reject(closeError);\n          return;\n        }\n\n        resolve();\n      });\n    });\n  });\n}\n"],"mappings":";;;;;AAWA,eAAsB,MACpB,QACA,SACA;AACA,QAAM,WAAW,MAAM,YAAY,QAAQ,OAAO;AAClD,SAAO,MAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAClD,aAAS,IAAI,CAAC,aAAa;AACzB,UAAI,UAAU;AACZ,eAAO,QAAQ;AACf;AAAA,MACF;AAEA,eAAS,MAAM,CAAC,eAAe;AAC7B,YAAI,YAAY;AACd,iBAAO,UAAU;AACjB;AAAA,QACF;AAEA,gBAAQ;AAAA,MACV,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/dist/chunk-2QVYYMUD.js

@@ -0,0 +1,365 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var _chunkMIV2UFTAjs = require('./chunk-MIV2UFTA.js');
+
+
+
+var _chunkL5TMG6BQjs = require('./chunk-L5TMG6BQ.js');
+
+
+var _chunk46JUPGRYjs = require('./chunk-46JUPGRY.js');
+
+// src/config.ts
+var _snapssdk = require('@metamask/snaps-sdk');
+
+
+
+
+
+
+var _node = require('@metamask/snaps-utils/node');
+var _utils = require('@metamask/utils');
+var _core = require('@swc/core');
+var _chalk = require('chalk');
+var _promises = require('fs/promises');
+var _module = require('module'); var _module2 = _interopRequireDefault(_module);
+var _path = require('path');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _superstruct = require('superstruct');
+var CONFIG_FILES = [_chunkL5TMG6BQjs.CONFIG_FILE, _chunkL5TMG6BQjs.TS_CONFIG_FILE];
+var SnapsBrowserifyBundlerCustomizerFunctionStruct = _superstruct.define.call(void 0, 
+  "function",
+  _superstruct.func.call(void 0, ).validator
+);
+var SnapsBrowserifyConfigStruct = _superstruct.object.call(void 0, {
+  bundler: _snapssdk.literal.call(void 0, "browserify"),
+  cliOptions: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      bundle: _superstruct.optional.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, )),
+      dist: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), "dist"),
+      eval: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      manifest: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      port: _superstruct.defaulted.call(void 0, _superstruct.number.call(void 0, ), 8081),
+      outfileName: _superstruct.defaulted.call(void 0, _superstruct.string.call(void 0, ), "bundle.js"),
+      root: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), process.cwd()),
+      sourceMaps: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+      src: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), "src/index.js"),
+      stripComments: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      suppressWarnings: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+      transpilationMode: _superstruct.defaulted.call(void 0, 
+        _snapssdk.union.call(void 0, [_snapssdk.literal.call(void 0, "localAndDeps"), _snapssdk.literal.call(void 0, "localOnly"), _snapssdk.literal.call(void 0, "none")]),
+        "localOnly"
+      ),
+      depsToTranspile: _superstruct.defaulted.call(void 0, _superstruct.array.call(void 0, _superstruct.string.call(void 0, )), []),
+      verboseErrors: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      writeManifest: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      serve: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true)
+    }),
+    {}
+  ),
+  bundlerCustomizer: _superstruct.optional.call(void 0, SnapsBrowserifyBundlerCustomizerFunctionStruct)
+});
+var SnapsWebpackCustomizeWebpackConfigFunctionStruct = _superstruct.define.call(void 0, 
+  "function",
+  _superstruct.func.call(void 0, ).validator
+);
+var SnapsWebpackConfigStruct = _superstruct.object.call(void 0, {
+  bundler: _superstruct.defaulted.call(void 0, _snapssdk.literal.call(void 0, "webpack"), "webpack"),
+  input: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), _path.resolve.call(void 0, process.cwd(), "src/index.js")),
+  sourceMap: _superstruct.defaulted.call(void 0, _snapssdk.union.call(void 0, [_superstruct.boolean.call(void 0, ), _snapssdk.literal.call(void 0, "inline")]), false),
+  evaluate: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+  output: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      path: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), _path.resolve.call(void 0, process.cwd(), "dist")),
+      filename: _superstruct.defaulted.call(void 0, _superstruct.string.call(void 0, ), "bundle.js"),
+      clean: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+      minimize: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true)
+    }),
+    {}
+  ),
+  manifest: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      path: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), _path.resolve.call(void 0, process.cwd(), "snap.manifest.json")),
+      update: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true)
+    }),
+    {}
+  ),
+  server: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      enabled: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true),
+      root: _superstruct.defaulted.call(void 0, _chunkMIV2UFTAjs.file.call(void 0, ), process.cwd()),
+      port: _superstruct.defaulted.call(void 0, _superstruct.number.call(void 0, ), 8081)
+    }),
+    {}
+  ),
+  environment: _superstruct.defaulted.call(void 0, _superstruct.record.call(void 0, _superstruct.string.call(void 0, ), _superstruct.unknown.call(void 0, )), {}),
+  stats: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      verbose: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+      builtIns: _superstruct.defaulted.call(void 0, 
+        _snapssdk.union.call(void 0, [
+          _superstruct.object.call(void 0, { ignore: _superstruct.defaulted.call(void 0, _superstruct.array.call(void 0, _superstruct.string.call(void 0, )), []) }),
+          _snapssdk.literal.call(void 0, false)
+        ]),
+        {}
+      ),
+      buffer: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), true)
+    }),
+    {}
+  ),
+  polyfills: _superstruct.defaulted.call(void 0, 
+    _snapssdk.union.call(void 0, [
+      _superstruct.boolean.call(void 0, ),
+      _superstruct.object.call(void 0, {
+        assert: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        buffer: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        console: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        constants: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        crypto: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        domain: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        events: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        http: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        https: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        os: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        path: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        punycode: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        process: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        querystring: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        stream: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        /* eslint-disable @typescript-eslint/naming-convention */
+        _stream_duplex: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        _stream_passthrough: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        _stream_readable: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        _stream_transform: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        _stream_writable: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        string_decoder: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        /* eslint-enable @typescript-eslint/naming-convention */
+        sys: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        timers: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        tty: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        url: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        util: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        vm: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false),
+        zlib: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false)
+      })
+    ]),
+    false
+  ),
+  customizeWebpackConfig: _superstruct.optional.call(void 0, 
+    SnapsWebpackCustomizeWebpackConfigFunctionStruct
+  ),
+  experimental: _superstruct.defaulted.call(void 0, 
+    _superstruct.object.call(void 0, {
+      wasm: _superstruct.defaulted.call(void 0, _superstruct.boolean.call(void 0, ), false)
+    }),
+    {}
+  )
+});
+var SnapsConfigStruct = _superstruct.type.call(void 0, {
+  bundler: _superstruct.defaulted.call(void 0, 
+    _snapssdk.union.call(void 0, [_snapssdk.literal.call(void 0, "browserify"), _snapssdk.literal.call(void 0, "webpack")]),
+    "webpack"
+  )
+});
+var LegacyOptionsStruct = _snapssdk.union.call(void 0, [
+  _node.named.call(void 0, 
+    "object with `transpilationMode` set to `localAndDeps` and `depsToTranspile` set to an array of strings",
+    _superstruct.type.call(void 0, {
+      depsToTranspile: _superstruct.array.call(void 0, _superstruct.string.call(void 0, )),
+      transpilationMode: _snapssdk.literal.call(void 0, "localAndDeps" /* LocalAndDeps */),
+      writeManifest: _superstruct.boolean.call(void 0, ),
+      bundlerCustomizer: _superstruct.optional.call(void 0, 
+        SnapsBrowserifyBundlerCustomizerFunctionStruct
+      )
+    })
+  ),
+  _node.named.call(void 0, 
+    "object without `depsToTranspile`",
+    _superstruct.type.call(void 0, {
+      depsToTranspile: _node.named.call(void 0, "empty array", _superstruct.empty.call(void 0, _superstruct.array.call(void 0, ))),
+      transpilationMode: _snapssdk.union.call(void 0, [
+        _snapssdk.literal.call(void 0, "localOnly" /* LocalOnly */),
+        _snapssdk.literal.call(void 0, "none" /* None */)
+      ]),
+      writeManifest: _superstruct.boolean.call(void 0, ),
+      bundlerCustomizer: _superstruct.optional.call(void 0, 
+        SnapsBrowserifyBundlerCustomizerFunctionStruct
+      )
+    })
+  )
+]);
+function getConfig(config, argv) {
+  const prefix = "The snap config file is invalid";
+  const suffix = _chalk.dim.call(void 0, 
+    // TODO: Link to `docs.metamask.io` once the docs are published.
+    "Refer to the documentation for more information: https://github.com/MetaMask/snaps/tree/main/packages/snaps-cli/"
+  );
+  const { bundler } = _node.createFromStruct.call(void 0, 
+    config,
+    SnapsConfigStruct,
+    prefix,
+    suffix
+  );
+  if (bundler === "browserify") {
+    const legacyConfig = _node.createFromStruct.call(void 0, 
+      config,
+      SnapsBrowserifyConfigStruct,
+      prefix,
+      suffix
+    );
+    return getWebpackConfig(mergeLegacyOptions(argv, legacyConfig));
+  }
+  return _node.createFromStruct.call(void 0, config, SnapsWebpackConfigStruct, prefix, suffix);
+}
+async function loadConfig(path, argv) {
+  try {
+    const contents = await _promises.readFile.call(void 0, path, "utf8");
+    const source = await _core.transform.call(void 0, contents, {
+      swcrc: false,
+      jsc: {
+        parser: {
+          syntax: "typescript"
+        }
+      },
+      module: {
+        type: "commonjs"
+      }
+    });
+    const config = new (0, _module2.default)(path);
+    config.paths = _module2.default._nodeModulePaths(_path.dirname.call(void 0, path));
+    config._compile(source.code, path);
+    if (!_utils.hasProperty.call(void 0, config.exports, "default")) {
+      return getConfig(config.exports, argv);
+    }
+    return getConfig(config.exports.default, argv);
+  } catch (error) {
+    if (error instanceof _node.SnapsStructError) {
+      throw new (0, _chunk46JUPGRYjs.ConfigError)(error.message);
+    }
+    throw new (0, _chunk46JUPGRYjs.ConfigError)(
+      `Unable to load snap config file at "${path}".
+
+${_node.indent.call(void 0, 
+        error.message
+      )}`
+    );
+  }
+}
+async function resolveConfig(path, argv) {
+  for (const configFile of CONFIG_FILES) {
+    const filePath = _path.resolve.call(void 0, path, configFile);
+    if (await _node.isFile.call(void 0, filePath)) {
+      return await loadConfig(filePath, argv);
+    }
+  }
+  throw new (0, _chunk46JUPGRYjs.ConfigError)(
+    `Could not find a "snap.config.js" or "snap.config.ts" file in the current or specified directory ("${path}").`
+  );
+}
+async function getConfigByArgv(argv, cwd = process.cwd()) {
+  if (argv.config) {
+    if (!await _node.isFile.call(void 0, argv.config)) {
+      throw new (0, _chunk46JUPGRYjs.ConfigError)(
+        `Could not find a config file at "${argv.config}". Make sure that the path is correct.`
+      );
+    }
+    return await loadConfig(argv.config, argv);
+  }
+  return await resolveConfig(cwd, argv);
+}
+function mergeLegacyOptions(argv, config) {
+  const cliOptions = Object.keys(config.cliOptions).reduce((accumulator, key) => {
+    if (argv[key] !== void 0) {
+      return {
+        ...accumulator,
+        [key]: argv[key]
+      };
+    }
+    return accumulator;
+  }, config.cliOptions);
+  return {
+    ...config,
+    cliOptions
+  };
+}
+function getWebpackConfig(legacyConfig) {
+  const defaultConfig = _superstruct.create.call(void 0, 
+    { bundler: "webpack" },
+    SnapsWebpackConfigStruct
+  );
+  const path = legacyConfig.cliOptions.bundle ? _path.dirname.call(void 0, legacyConfig.cliOptions.bundle) : legacyConfig.cliOptions.dist;
+  const filename = legacyConfig.cliOptions.bundle ? _path.basename.call(void 0, legacyConfig.cliOptions.bundle) : legacyConfig.cliOptions.outfileName;
+  return {
+    ...defaultConfig,
+    input: legacyConfig.cliOptions.src,
+    evaluate: legacyConfig.cliOptions.eval,
+    sourceMap: legacyConfig.cliOptions.sourceMaps,
+    output: {
+      path,
+      filename,
+      // The legacy config has an option to remove comments from the bundle, but
+      // the terser plugin does this by default, so we only enable the terser if
+      // the legacy config has `stripComments` set to `true`. This is not a
+      // perfect solution, but it's the best we can do without breaking the
+      // legacy config.
+      minimize: legacyConfig.cliOptions.stripComments,
+      // The legacy config does not have a `clean` option, so we default to
+      // `false` here.
+      clean: false
+    },
+    manifest: {
+      // The legacy config does not have a `manifest` option, so we default to
+      // `process.cwd()/snap.manifest.json`.
+      path: _path.resolve.call(void 0, process.cwd(), "snap.manifest.json"),
+      update: legacyConfig.cliOptions.writeManifest
+    },
+    server: {
+      enabled: legacyConfig.cliOptions.serve,
+      port: legacyConfig.cliOptions.port,
+      root: legacyConfig.cliOptions.root
+    },
+    stats: {
+      verbose: false,
+      // These plugins are designed to be used with the modern config format, so
+      // we disable them for the legacy config format.
+      builtIns: false,
+      buffer: false
+    },
+    legacy: _node.createFromStruct.call(void 0, 
+      {
+        ...legacyConfig.cliOptions,
+        bundlerCustomizer: legacyConfig.bundlerCustomizer
+      },
+      LegacyOptionsStruct,
+      "Invalid Browserify CLI options"
+    )
+  };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+exports.SnapsBrowserifyConfigStruct = SnapsBrowserifyConfigStruct; exports.SnapsWebpackConfigStruct = SnapsWebpackConfigStruct; exports.SnapsConfigStruct = SnapsConfigStruct; exports.LegacyOptionsStruct = LegacyOptionsStruct; exports.getConfig = getConfig; exports.loadConfig = loadConfig; exports.resolveConfig = resolveConfig; exports.getConfigByArgv = getConfigByArgv; exports.mergeLegacyOptions = mergeLegacyOptions; exports.getWebpackConfig = getWebpackConfig;
+//# sourceMappingURL=chunk-2QVYYMUD.js.map

package/dist/chunk-2QVYYMUD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { literal, union } from '@metamask/snaps-sdk';\nimport {\n  createFromStruct,\n  indent,\n  isFile,\n  SnapsStructError,\n  named,\n} from '@metamask/snaps-utils/node';\nimport { hasProperty } from '@metamask/utils';\nimport { transform } from '@swc/core';\nimport type { BrowserifyObject } from 'browserify';\nimport { dim } from 'chalk';\nimport { readFile } from 'fs/promises';\nimport Module from 'module';\nimport { basename, dirname, resolve } from 'path';\nimport type { Infer } from 'superstruct';\nimport {\n  array,\n  boolean,\n  create,\n  defaulted,\n  define,\n  func,\n  number,\n  object,\n  optional,\n  record,\n  string,\n  type,\n  unknown,\n  empty,\n} from 'superstruct';\nimport type { Configuration as WebpackConfiguration } from 'webpack';\n\nimport { TranspilationModes } from './builders';\nimport { ConfigError } from './errors';\nimport { file } from './structs';\nimport type { YargsArgs } from './types/yargs';\nimport { CONFIG_FILE, TS_CONFIG_FILE } from './utils';\n\nconst CONFIG_FILES = [CONFIG_FILE, TS_CONFIG_FILE];\n\n/**\n * The configuration for the Snaps CLI, stored as `snap.config.js` or\n * `snap.config.ts` in the root of the project.\n *\n * @deprecated The Browserify bundler is deprecated and will be removed in a\n * future release. Use the Webpack bundler instead.\n */\nexport type SnapBrowserifyConfig = {\n  /**\n   * The bundler to use to build the snap. For backwards compatibility, if not\n   * specified, Browserify will be used. However, the Browserify bundler is\n   * deprecated and will be removed in a future release, so it's recommended to\n   * use the Webpack bundler instead.\n   */\n  bundler: 'browserify';\n\n  /**\n   * The options for the Snaps CLI. These are merged with the options passed to\n   * the CLI, with the CLI options taking precedence.\n   *\n   * @deprecated The Browserify bundler is deprecated and will be removed in a\n   * future release. Use the Webpack bundler instead.\n   */\n  cliOptions?: {\n    /**\n     * The path to the snap bundle file.\n     *\n     * @default 'dist/bundle.js'\n     */\n    bundle?: string;\n\n    /**\n     * The directory to output the snap to. This is only used if `bundle` is\n     * not specified.\n     *\n     * @default 'dist'\n     */\n    dist?: string;\n\n    /**\n     * Whether to attempt to evaluate the snap in SES. This can catch some errors\n     * that would otherwise only be caught at runtime.\n     *\n     * @default true\n     */\n    eval?: boolean;\n\n    /**\n     * Whether to validate the snap manifest.\n     *\n     * @default true\n     */\n    manifest?: boolean;\n\n    /**\n     * The name of the bundle file. This is only used if `bundle` is not\n     * specified.\n     *\n     * @default 'bundle.js'\n     */\n    outfileName?: string;\n\n    /**\n     * The port to run the server on.\n     *\n     * @default 8081\n     */\n    port?: number;\n\n    /**\n     * The root directory to serve the snap from.\n     *\n     * @default `process.cwd()`\n     */\n    root?: string;\n\n    /**\n     * Whether to generate source maps for the snap bundle.\n     *\n     * @default false\n     */\n    sourceMaps?: boolean;\n\n    /**\n     * The path to the snap entry point.\n     *\n     * @default 'src/index.js'\n     */\n    src?: string;\n\n    /**\n     * Whether to remove comments from the bundle.\n     *\n     * @default true\n     */\n    stripComments?: boolean;\n\n    /**\n     * Whether to suppress warnings.\n     *\n     * @default false\n     */\n    suppressWarnings?: boolean;\n\n    /**\n     * The transpilation mode to use, which determines which files are\n     * transpiled.\n     *\n     * - `'localAndDeps'`: Transpile the snap entry point and all dependencies.\n     * - `'localOnly'`: Transpile only the snap entry point.\n     * - `'none'`: Don't transpile any files.\n     *\n     * @default 'localOnly'\n     */\n    transpilationMode?: 'localAndDeps' | 'localOnly' | 'none';\n\n    /**\n     * The dependencies to transpile when `transpilationMode` is set to\n     * `'localAndDeps'`. If not specified, all dependencies will be transpiled.\n     */\n    depsToTranspile?: string[];\n\n    /**\n     * Whether to show original errors.\n     *\n     * @default true\n     */\n    verboseErrors?: boolean;\n\n    /**\n     * Whether to write the updated manifest to disk.\n     *\n     * @default true\n     */\n    writeManifest?: boolean;\n\n    /**\n     * Whether to serve the snap locally.\n     *\n     * @default true\n     */\n    serve?: boolean;\n  };\n\n  /**\n   * A function that can be used to customize the Browserify instance used to\n   * build the snap.\n   *\n   * @param bundler - The Browserify instance.\n   * @deprecated The Browserify bundler is deprecated and will be removed in a\n   * future release. Use the Webpack bundler instead.\n   */\n  bundlerCustomizer?: (bundler: BrowserifyObject) => void;\n};\n\n/**\n * The configuration for the Snaps CLI, stored as `snap.config.js` or\n * `snap.config.ts` in the root of the project.\n */\nexport type SnapWebpackConfig = {\n  /**\n   * The bundler to use to build the snap. For backwards compatibility, if not\n   * specified, Browserify will be used. However, the Browserify bundler is\n   * deprecated and will be removed in a future release, so it's recommended to\n   * use the Webpack bundler instead.\n   */\n  bundler?: 'webpack';\n\n  /**\n   * The path to the snap entry point. This should be a JavaScript or TypeScript\n   * file.\n   */\n  input: string;\n\n  /**\n   * Whether to generate source maps for the snap. If `true`, source maps will\n   * be generated as separate files. If `'inline'`, source maps will be\n   * inlined in the generated JavaScript bundle.\n   *\n   * @default true\n   */\n  sourceMap?: boolean | 'inline';\n\n  /**\n   * Whether to attempt to evaluate the snap in SES. This can catch some errors\n   * that would otherwise only be caught at runtime.\n   *\n   * @default true\n   */\n  evaluate?: boolean;\n\n  output?: {\n    /**\n     * The path to the directory where the snap will be built. This directory\n     * will be created if it doesn't exist.\n     *\n     * If the path is relative, it will be resolved relative to the current\n     * working directory.\n     *\n     * @default 'dist'\n     */\n    path?: string;\n\n    /**\n     * The name of the JavaScript bundle file.\n     *\n     * @default 'bundle.js'\n     */\n    filename?: string;\n\n    /**\n     * Whether to clean the output directory before building the snap. If\n     * `true`, the output directory will be deleted and recreated. Otherwise,\n     * the output directory will be left as-is.\n     *\n     * @default false\n     */\n    clean?: boolean;\n\n    /**\n     * Whether to minimize the snap bundle. If `true`, the bundle will be\n     * minified. Otherwise, the bundle will be left as-is.\n     *\n     * @default true\n     */\n    minimize?: boolean;\n  };\n\n  manifest?: {\n    /**\n     * The path to the snap manifest file. If the path is relative, it will be\n     * resolved relative to the current working directory.\n     *\n     * @default 'snap.manifest.json'\n     */\n    path?: string;\n\n    /**\n     * Whether to automatically update the manifest. If `true`, the manifest\n     * will be updated with the latest shasum of the snap bundle, and some\n     * common fields will be updated if they are missing or incorrect. If\n     * `false`, the manifest will be left as-is.\n     *\n     * @default true\n     */\n    update?: boolean;\n  };\n\n  server?: {\n    /**\n     * Whether to enable the local server. If `true`, the snap will be served\n     * from a local server, when running the `watch` command. If `false`, the\n     * snap will not be served.\n     *\n     * @default true\n     */\n    enabled?: boolean;\n\n    /**\n     * The root directory to serve the snap from. If the path is relative, it\n     * will be resolved relative to the current working directory.\n     *\n     * @default `process.cwd()`\n     */\n    root?: string;\n\n    /**\n     * The port to run the server on.\n     *\n     * @default 8081\n     */\n    port?: number;\n  };\n\n  /**\n   * The environment variables to set when building the snap. These will be\n   * available in the snap as `process.env`. In addition to these environment\n   * variables, the following environment variables will always be set:\n   *\n   * - `NODE_DEBUG`: `false`\n   * - `NODE_ENV`: `'production'`\n   * - `DEBUG`: `false`\n   *\n   * Any environment variables specified here will override these defaults. You\n   * can also override any variables here by setting them in your shell when\n   * running the CLI.\n   */\n  environment?: Record<string, unknown>;\n\n  /**\n   * Options that control the logging output of the CLI.\n   */\n  stats?: {\n    /**\n     * Whether to enable verbose logging.\n     *\n     * @default false\n     */\n    verbose?: boolean;\n\n    /**\n     * Whether to log warnings about unresolved built-in modules. If `false`,\n     * warnings will not be logged.\n     */\n    builtIns?:\n      | {\n          /**\n           * The built-in modules to ignore when resolving modules. If a module\n           * is ignored, no warning will be logged if it is not resolved.\n           */\n          ignore?: string[];\n        }\n      | false;\n\n    /**\n     * Whether to log warnings about the use of the `Buffer` global. If `false`,\n     * warnings will not be logged. If `true`, the CLI will warn if the `Buffer`\n     * global is used, but not provided by Webpack's `DefinePlugin`.\n     */\n    buffer?: boolean;\n  };\n\n  /**\n   * Whether to provide polyfills for node builtins. If `true`, all the available\n   * polyfills will be provided. If `false` no polyfills will be provided. If a\n   * configuration object is passed only the polyfills set to `true` will be provided.\n   *\n   * @default false\n   * @example\n   * ```ts\n   * polyfills: true\n   *\n   * // or\n   *\n   * polyfills: {\n   *  assert: true,\n   *  buffer: true\n   * }\n   * ```\n   */\n  polyfills?:\n    | boolean\n    | {\n        assert?: boolean;\n        buffer?: boolean;\n        console?: boolean;\n        constants?: boolean;\n        crypto?: boolean;\n        domain?: boolean;\n        events?: boolean;\n        http?: boolean;\n        https?: boolean;\n        os?: boolean;\n        path?: boolean;\n        punycode?: boolean;\n        process?: boolean;\n        querystring?: boolean;\n        stream?: boolean;\n        /* eslint-disable @typescript-eslint/naming-convention */\n        _stream_duplex?: boolean;\n        _stream_passthrough?: boolean;\n        _stream_readable?: boolean;\n        _stream_transform?: boolean;\n        _stream_writable?: boolean;\n        string_decoder?: boolean;\n        /* eslint-enable @typescript-eslint/naming-convention */\n        sys?: boolean;\n        timers?: boolean;\n        tty?: boolean;\n        url?: boolean;\n        util?: boolean;\n        vm?: boolean;\n        zlib?: boolean;\n      };\n\n  /**\n   * A function to customize the Webpack configuration used to build the snap.\n   * This function will be called with the default Webpack configuration, and\n   * should return the modified configuration. If not specified, the default\n   * configuration will be used.\n   *\n   * It's recommended to use the `webpack-merge` package to merge the default\n   * configuration with your customizations. The merge function is exported as\n   * `merge` from the `@metamask/snaps-cli` package.\n   *\n   * @example\n   * ```ts\n   * import type { SnapsConfig } from '@metamask/snaps-cli';\n   * import { merge } from '@metamask/snaps-cli';\n   *\n   * const config: SnapsConfig = {\n   *   bundler: 'webpack',\n   *   entry: 'src/index.ts',\n   *   customizeWebpackConfig: (config) => merge(config, {\n   *     module: {\n   *       rules: [\n   *         {\n   *           test: /\\.wasm$/,\n   *           type: 'assets/resource',\n   *         },\n   *       ],\n   *     },\n   *   }),\n   * };\n   *\n   * export default config;\n   * ```\n   */\n  customizeWebpackConfig?: (\n    config: WebpackConfiguration,\n  ) => WebpackConfiguration;\n\n  /**\n   * Experimental features that can be enabled. These features are not\n   * guaranteed to be stable, and may be removed or changed in a future release.\n   */\n  experimental?: {\n    /**\n     * Whether to enable WebAssembly support. If `true`, the Webpack\n     * configuration will be modified to support WebAssembly. If `false`, the\n     * Webpack configuration will not be modified.\n     *\n     * @default false\n     */\n    wasm?: boolean;\n  };\n};\n\n/**\n * The configuration for the Snaps CLI, stored as `snap.config.js` or\n * `snap.config.ts` in the root of the project.\n */\nexport type SnapConfig = SnapBrowserifyConfig | SnapWebpackConfig;\n\ntype SnapsBrowserifyBundlerCustomizerFunction = (\n  bundler: BrowserifyObject,\n) => void;\n\n// This struct is essentially the same as the `func` struct, but it's defined\n// separately so that we include the function type in the inferred TypeScript\n// type definitions.\nconst SnapsBrowserifyBundlerCustomizerFunctionStruct =\n  define<SnapsBrowserifyBundlerCustomizerFunction>(\n    'function',\n    func().validator,\n  );\n\nexport const SnapsBrowserifyConfigStruct = object({\n  bundler: literal('browserify'),\n  cliOptions: defaulted(\n    object({\n      bundle: optional(file()),\n      dist: defaulted(file(), 'dist'),\n      eval: defaulted(boolean(), true),\n      manifest: defaulted(boolean(), true),\n      port: defaulted(number(), 8081),\n      outfileName: defaulted(string(), 'bundle.js'),\n      root: defaulted(file(), process.cwd()),\n      sourceMaps: defaulted(boolean(), false),\n      src: defaulted(file(), 'src/index.js'),\n      stripComments: defaulted(boolean(), true),\n      suppressWarnings: defaulted(boolean(), false),\n      transpilationMode: defaulted(\n        union([literal('localAndDeps'), literal('localOnly'), literal('none')]),\n        'localOnly',\n      ),\n      depsToTranspile: defaulted(array(string()), []),\n      verboseErrors: defaulted(boolean(), true),\n      writeManifest: defaulted(boolean(), true),\n      serve: defaulted(boolean(), true),\n    }),\n    {},\n  ),\n  bundlerCustomizer: optional(SnapsBrowserifyBundlerCustomizerFunctionStruct),\n});\n\ntype SnapsWebpackCustomizeWebpackConfigFunction = (\n  config: WebpackConfiguration,\n) => WebpackConfiguration;\n\n// This struct is essentially the same as the `func` struct, but it's defined\n// separately so that we include the function type in the inferred TypeScript\n// type definitions.\nconst SnapsWebpackCustomizeWebpackConfigFunctionStruct =\n  define<SnapsWebpackCustomizeWebpackConfigFunction>(\n    'function',\n    func().validator,\n  );\n\nexport const SnapsWebpackConfigStruct = object({\n  bundler: defaulted(literal('webpack'), 'webpack'),\n  input: defaulted(file(), resolve(process.cwd(), 'src/index.js')),\n  sourceMap: defaulted(union([boolean(), literal('inline')]), false),\n  evaluate: defaulted(boolean(), true),\n\n  output: defaulted(\n    object({\n      path: defaulted(file(), resolve(process.cwd(), 'dist')),\n      filename: defaulted(string(), 'bundle.js'),\n      clean: defaulted(boolean(), false),\n      minimize: defaulted(boolean(), true),\n    }),\n    {},\n  ),\n\n  manifest: defaulted(\n    object({\n      path: defaulted(file(), resolve(process.cwd(), 'snap.manifest.json')),\n      update: defaulted(boolean(), true),\n    }),\n    {},\n  ),\n\n  server: defaulted(\n    object({\n      enabled: defaulted(boolean(), true),\n      root: defaulted(file(), process.cwd()),\n      port: defaulted(number(), 8081),\n    }),\n    {},\n  ),\n\n  environment: defaulted(record(string(), unknown()), {}),\n\n  stats: defaulted(\n    object({\n      verbose: defaulted(boolean(), false),\n      builtIns: defaulted(\n        union([\n          object({ ignore: defaulted(array(string()), []) }),\n          literal(false),\n        ]),\n        {},\n      ),\n      buffer: defaulted(boolean(), true),\n    }),\n    {},\n  ),\n\n  polyfills: defaulted(\n    union([\n      boolean(),\n      object({\n        assert: defaulted(boolean(), false),\n        buffer: defaulted(boolean(), false),\n        console: defaulted(boolean(), false),\n        constants: defaulted(boolean(), false),\n        crypto: defaulted(boolean(), false),\n        domain: defaulted(boolean(), false),\n        events: defaulted(boolean(), false),\n        http: defaulted(boolean(), false),\n        https: defaulted(boolean(), false),\n        os: defaulted(boolean(), false),\n        path: defaulted(boolean(), false),\n        punycode: defaulted(boolean(), false),\n        process: defaulted(boolean(), false),\n        querystring: defaulted(boolean(), false),\n        stream: defaulted(boolean(), false),\n        /* eslint-disable @typescript-eslint/naming-convention */\n        _stream_duplex: defaulted(boolean(), false),\n        _stream_passthrough: defaulted(boolean(), false),\n        _stream_readable: defaulted(boolean(), false),\n        _stream_transform: defaulted(boolean(), false),\n        _stream_writable: defaulted(boolean(), false),\n        string_decoder: defaulted(boolean(), false),\n        /* eslint-enable @typescript-eslint/naming-convention */\n        sys: defaulted(boolean(), false),\n        timers: defaulted(boolean(), false),\n        tty: defaulted(boolean(), false),\n        url: defaulted(boolean(), false),\n        util: defaulted(boolean(), false),\n        vm: defaulted(boolean(), false),\n        zlib: defaulted(boolean(), false),\n      }),\n    ]),\n    false,\n  ),\n\n  customizeWebpackConfig: optional(\n    SnapsWebpackCustomizeWebpackConfigFunctionStruct,\n  ),\n\n  experimental: defaulted(\n    object({\n      wasm: defaulted(boolean(), false),\n    }),\n    {},\n  ),\n});\n\nexport const SnapsConfigStruct = type({\n  bundler: defaulted(\n    union([literal('browserify'), literal('webpack')]),\n    'webpack',\n  ),\n});\n\nexport const LegacyOptionsStruct = union([\n  named(\n    'object with `transpilationMode` set to `localAndDeps` and `depsToTranspile` set to an array of strings',\n    type({\n      depsToTranspile: array(string()),\n      transpilationMode: literal(TranspilationModes.LocalAndDeps),\n      writeManifest: boolean(),\n      bundlerCustomizer: optional(\n        SnapsBrowserifyBundlerCustomizerFunctionStruct,\n      ),\n    }),\n  ),\n  named(\n    'object without `depsToTranspile`',\n    type({\n      depsToTranspile: named('empty array', empty(array())),\n      transpilationMode: union([\n        literal(TranspilationModes.LocalOnly),\n        literal(TranspilationModes.None),\n      ]),\n      writeManifest: boolean(),\n      bundlerCustomizer: optional(\n        SnapsBrowserifyBundlerCustomizerFunctionStruct,\n      ),\n    }),\n  ),\n]);\n\nexport type LegacyOptions = Infer<typeof LegacyOptionsStruct>;\n\nexport type ProcessedBrowserifyConfig = Infer<\n  typeof SnapsBrowserifyConfigStruct\n>;\n\nexport type ProcessedWebpackConfig = Infer<typeof SnapsWebpackConfigStruct> & {\n  /**\n   * The legacy Browserify config, if the bundler is Browserify. This is used\n   * to support the legacy config format.\n   */\n  legacy?: LegacyOptions;\n};\n\nexport type ProcessedConfig = ProcessedWebpackConfig;\n\n/**\n * Get a validated snap config. This validates the config and adds default\n * values for any missing properties.\n *\n * @param config - The config to validate.\n * @param argv - The CLI arguments.\n * @returns The validated config.\n */\nexport function getConfig(config: unknown, argv: YargsArgs): ProcessedConfig {\n  const prefix = 'The snap config file is invalid';\n  const suffix = dim(\n    // TODO: Link to `docs.metamask.io` once the docs are published.\n    'Refer to the documentation for more information: https://github.com/MetaMask/snaps/tree/main/packages/snaps-cli/',\n  );\n\n  const { bundler } = createFromStruct(\n    config,\n    SnapsConfigStruct,\n    prefix,\n    suffix,\n  );\n\n  if (bundler === 'browserify') {\n    const legacyConfig = createFromStruct(\n      config,\n      SnapsBrowserifyConfigStruct,\n      prefix,\n      suffix,\n    );\n\n    return getWebpackConfig(mergeLegacyOptions(argv, legacyConfig));\n  }\n\n  return createFromStruct(config, SnapsWebpackConfigStruct, prefix, suffix);\n}\n\n/**\n * Load a snap config from a file. This supports both JavaScript and TypeScript\n * config files, in the CommonJS module format and the ES module format.\n *\n * This assumes that the config file exports a default object, either through\n * `module.exports` or `export default`.\n *\n * @param path - The full path to the config file.\n * @param argv - The CLI arguments.\n * @returns The validated config.\n * @throws If the config file is invalid, or if the config file does not have a\n * default export.\n */\nexport async function loadConfig(path: string, argv: YargsArgs) {\n  try {\n    const contents = await readFile(path, 'utf8');\n    const source = await transform(contents, {\n      swcrc: false,\n      jsc: {\n        parser: {\n          syntax: 'typescript',\n        },\n      },\n      module: {\n        type: 'commonjs',\n      },\n    });\n\n    const config = new Module(path);\n\n    // @ts-expect-error - This function is not typed.\n    config.paths = Module._nodeModulePaths(dirname(path));\n\n    // @ts-expect-error - This function is not typed.\n    config._compile(source.code, path);\n\n    if (!hasProperty(config.exports, 'default')) {\n      return getConfig(config.exports, argv);\n    }\n\n    return getConfig(config.exports.default, argv);\n  } catch (error) {\n    if (error instanceof SnapsStructError) {\n      throw new ConfigError(error.message);\n    }\n\n    throw new ConfigError(\n      `Unable to load snap config file at \"${path}\".\\n\\n${indent(\n        error.message,\n      )}`,\n    );\n  }\n}\n\n/**\n * Resolve a snap config. This function will look for a `snap.config.js` or\n * `snap.config.ts` file in the current or specified directory.\n *\n * @param path - The path to resolve the snap config from. Defaults to the\n * current working directory.\n * @param argv - The CLI arguments.\n * @returns The resolved and validated snap config.\n * @throws If a snap config could not be found.\n */\nexport async function resolveConfig(path: string, argv: YargsArgs) {\n  for (const configFile of CONFIG_FILES) {\n    const filePath = resolve(path, configFile);\n    if (await isFile(filePath)) {\n      return await loadConfig(filePath, argv);\n    }\n  }\n\n  throw new ConfigError(\n    `Could not find a \"snap.config.js\" or \"snap.config.ts\" file in the current or specified directory (\"${path}\").`,\n  );\n}\n\n/**\n * Get a snap config from the CLI arguments. This will either load the config\n * from the specified config file, or resolve the config from the current\n * working directory.\n *\n * @param argv - The CLI arguments.\n * @param cwd - The current working directory. Defaults to `process.cwd()`.\n * @returns The resolved and validated snap config.\n */\nexport async function getConfigByArgv(\n  argv: YargsArgs,\n  cwd: string = process.cwd(),\n) {\n  if (argv.config) {\n    if (!(await isFile(argv.config))) {\n      throw new ConfigError(\n        `Could not find a config file at \"${argv.config}\". Make sure that the path is correct.`,\n      );\n    }\n\n    return await loadConfig(argv.config, argv);\n  }\n\n  return await resolveConfig(cwd, argv);\n}\n\n/**\n * Merge legacy CLI options into the config. This is used to support the legacy\n * config format, where options can be specified both in the config file and\n * through CLI flags.\n *\n * @param argv - The CLI arguments.\n * @param config - The config to merge the CLI options into.\n * @returns The config with the CLI options merged in.\n * @deprecated This function is only used to support the legacy config format.\n */\nexport function mergeLegacyOptions(\n  argv: YargsArgs,\n  config: ProcessedBrowserifyConfig,\n) {\n  const cliOptions = Object.keys(config.cliOptions).reduce<\n    ProcessedBrowserifyConfig['cliOptions']\n  >((accumulator, key) => {\n    if (argv[key] !== undefined) {\n      return {\n        ...accumulator,\n        [key]: argv[key],\n      };\n    }\n\n    return accumulator;\n  }, config.cliOptions);\n\n  return {\n    ...config,\n    cliOptions,\n  };\n}\n\n/**\n * Get a Webpack config from a legacy browserify config. This is used to\n * support the legacy config format, and convert it to the new format.\n *\n * @param legacyConfig - The legacy browserify config.\n * @returns The Webpack config.\n */\nexport function getWebpackConfig(\n  legacyConfig: ProcessedBrowserifyConfig,\n): ProcessedWebpackConfig {\n  const defaultConfig = create(\n    { bundler: 'webpack' },\n    SnapsWebpackConfigStruct,\n  );\n\n  // The legacy config has two options for specifying the output path and\n  // filename: `bundle`, and `dist` + `outfileName`. If `bundle` is specified,\n  // we use that as the output path and filename. Otherwise, we use `dist` and\n  // `outfileName`.\n  const path = legacyConfig.cliOptions.bundle\n    ? dirname(legacyConfig.cliOptions.bundle)\n    : legacyConfig.cliOptions.dist;\n\n  const filename = legacyConfig.cliOptions.bundle\n    ? basename(legacyConfig.cliOptions.bundle)\n    : legacyConfig.cliOptions.outfileName;\n\n  return {\n    ...defaultConfig,\n    input: legacyConfig.cliOptions.src,\n    evaluate: legacyConfig.cliOptions.eval,\n    sourceMap: legacyConfig.cliOptions.sourceMaps,\n    output: {\n      path,\n      filename,\n\n      // The legacy config has an option to remove comments from the bundle, but\n      // the terser plugin does this by default, so we only enable the terser if\n      // the legacy config has `stripComments` set to `true`. This is not a\n      // perfect solution, but it's the best we can do without breaking the\n      // legacy config.\n      minimize: legacyConfig.cliOptions.stripComments,\n\n      // The legacy config does not have a `clean` option, so we default to\n      // `false` here.\n      clean: false,\n    },\n    manifest: {\n      // The legacy config does not have a `manifest` option, so we default to\n      // `process.cwd()/snap.manifest.json`.\n      path: resolve(process.cwd(), 'snap.manifest.json'),\n      update: legacyConfig.cliOptions.writeManifest,\n    },\n    server: {\n      enabled: legacyConfig.cliOptions.serve,\n      port: legacyConfig.cliOptions.port,\n      root: legacyConfig.cliOptions.root,\n    },\n    stats: {\n      verbose: false,\n\n      // These plugins are designed to be used with the modern config format, so\n      // we disable them for the legacy config format.\n      builtIns: false,\n      buffer: false,\n    },\n    legacy: createFromStruct(\n      {\n        ...legacyConfig.cliOptions,\n        bundlerCustomizer: legacyConfig.bundlerCustomizer,\n      },\n      LegacyOptionsStruct,\n      'Invalid Browserify CLI options',\n    ),\n  };\n}\n"]}