@metamask/snaps-cli 0.38.1-flask.1 → 1.0.0

package/dist/{esm/builders.js → builders.js}

@@ -1,130 +1,133 @@
-export var TranspilationModes;
-(function(TranspilationModes) {
-    TranspilationModes["LocalAndDeps"] = 'localAndDeps';
-    TranspilationModes["LocalOnly"] = 'localOnly';
-    TranspilationModes["None"] = 'none';
-})(TranspilationModes || (TranspilationModes = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranspilationModes = void 0;
+var TranspilationModes;
+(function (TranspilationModes) {
+    TranspilationModes["LocalAndDeps"] = "localAndDeps";
+    TranspilationModes["LocalOnly"] = "localOnly";
+    TranspilationModes["None"] = "none";
+})(TranspilationModes = exports.TranspilationModes || (exports.TranspilationModes = {}));
 const builders = {
-    // eslint-disable-next-line @typescript-eslint/naming-convention
-    config: {
-        alias: 'c',
-        describe: 'Path to config file',
-        type: 'string',
-        normalize: true
-    },
-    fix: {
-        describe: 'Attempt to fix snap.manifest.json',
-        type: 'boolean'
-    },
-    input: {
-        alias: 'i',
-        describe: 'Snap bundle file to evaluate',
-        type: 'string',
-        normalize: true
-    },
-    // Deprecated Browserify options.
     bundle: {
         alias: 'b',
         describe: 'Snap bundle file',
         type: 'string',
+        demandOption: true,
         normalize: true,
-        deprecated: 'Use --input instead.'
+        default: 'dist/bundle.js',
     },
     dist: {
         alias: 'd',
         describe: 'Output directory',
         type: 'string',
+        demandOption: true,
         normalize: true,
-        deprecated: true
+        default: 'dist',
     },
     eval: {
         alias: 'e',
         describe: 'Attempt to evaluate Snap bundle in SES',
         type: 'boolean',
-        deprecated: true
+        demandOption: false,
+        default: true,
     },
     manifest: {
         alias: 'm',
         describe: 'Validate snap.manifest.json',
         type: 'boolean',
-        deprecated: true
+        demandOption: false,
+        default: true,
     },
     port: {
         alias: 'p',
         describe: 'Local server port for testing',
         type: 'number',
-        coerce: (arg)=>{
+        demandOption: true,
+        default: 8081,
+        coerce: (arg) => {
             const port = Number.parseInt(String(arg), 10);
             if (Number.isNaN(port)) {
-                throw new Error(`Invalid port: "${String(arg)}".`);
+                throw new Error(`Invalid port: ${String(arg)}`);
             }
             return port;
         },
-        deprecated: true
     },
     outfileName: {
         alias: 'n',
         describe: 'Output file name',
         type: 'string',
-        deprecated: true
+        demandOption: false,
+        default: 'bundle.js',
     },
     root: {
         alias: 'r',
         describe: 'Server root directory',
         type: 'string',
+        demandOption: true,
         normalize: true,
-        deprecated: true
+        default: '.',
     },
     sourceMaps: {
         describe: 'Whether builds include sourcemaps',
         type: 'boolean',
-        deprecated: true
+        demandOption: false,
+        default: false,
     },
     src: {
         alias: 's',
         describe: 'Source file',
         type: 'string',
+        demandOption: true,
         normalize: true,
-        deprecated: true
+        default: 'src/index.js',
     },
     stripComments: {
         alias: 'strip',
         describe: 'Whether to remove code comments from the build output',
         type: 'boolean',
-        deprecated: true
+        demandOption: false,
+        default: true,
     },
     suppressWarnings: {
         type: 'boolean',
         describe: 'Whether to suppress warnings',
-        deprecated: true
+        demandOption: false,
+        default: false,
     },
     transpilationMode: {
         type: 'string',
-        describe: 'Whether to use Babel to transpile all source code (including dependencies), local source code only, or nothing',
+        describe: 'Whether to use Babel to transpile all source code (including dependencies), local source code only, or nothing.',
+        demandOption: false,
+        default: TranspilationModes.LocalOnly,
         choices: Object.values(TranspilationModes),
-        deprecated: true
     },
     depsToTranspile: {
         type: 'array',
         describe: 'Transpile only the listed dependencies.',
-        deprecated: true
+        demandOption: false,
     },
     verboseErrors: {
         type: 'boolean',
         describe: 'Display original errors',
-        deprecated: true
+        demandOption: false,
+        default: true,
     },
     writeManifest: {
-        describe: 'Make necessary changes to the snap manifest file',
+        describe: 'Make necessary changes to the Snap manifest file',
         type: 'boolean',
-        deprecated: true
+        demandOption: false,
+        default: true,
     },
     serve: {
-        describe: 'Serve snap file(s) locally for testing',
+        describe: 'Serve Snap file(s) locally for testing',
         type: 'boolean',
-        deprecated: true
-    }
+        demandOption: false,
+        default: true,
+    },
+    directory: {
+        describe: 'the directory to use',
+        type: 'string',
+    },
 };
-export default builders;
-
+exports.default = builders;
 //# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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","sourcesContent":["import { Options, PositionalOptions } from 'yargs';\n\nexport type SnapsCliBuilders = {\n  readonly bundle: Readonly<Options>;\n  readonly dist: Readonly<Options>;\n  readonly eval: Readonly<Options>;\n  readonly manifest: Readonly<Options>;\n  readonly outfileName: Readonly<Options>;\n  readonly port: Readonly<Options>;\n  readonly root: Readonly<Options>;\n  readonly sourceMaps: Readonly<Options>;\n  readonly src: Readonly<Options>;\n  readonly stripComments: Readonly<Options>;\n  readonly suppressWarnings: Readonly<Options>;\n  readonly transpilationMode: Readonly<Options>;\n  readonly depsToTranspile: Readonly<Options>;\n  readonly verboseErrors: Readonly<Options>;\n  readonly writeManifest: Readonly<Options>;\n  readonly serve: Readonly<Options>;\n  readonly directory: Readonly<PositionalOptions>;\n};\n\nexport enum TranspilationModes {\n  LocalAndDeps = 'localAndDeps',\n  LocalOnly = 'localOnly',\n  None = 'none',\n}\n\nconst builders: SnapsCliBuilders = {\n  bundle: {\n    alias: 'b',\n    describe: 'Snap bundle file',\n    type: 'string',\n    demandOption: true,\n    normalize: true,\n    default: 'dist/bundle.js',\n  },\n\n  dist: {\n    alias: 'd',\n    describe: 'Output directory',\n    type: 'string',\n    demandOption: true,\n    normalize: true,\n    default: 'dist',\n  },\n\n  eval: {\n    alias: 'e',\n    describe: 'Attempt to evaluate Snap bundle in SES',\n    type: 'boolean',\n    demandOption: false,\n    default: true,\n  },\n\n  manifest: {\n    alias: 'm',\n    describe: 'Validate snap.manifest.json',\n    type: 'boolean',\n    demandOption: false,\n    default: true,\n  },\n\n  port: {\n    alias: 'p',\n    describe: 'Local server port for testing',\n    type: 'number',\n    demandOption: true,\n    default: 8081,\n    coerce: (arg: unknown) => {\n      const port = Number.parseInt(String(arg), 10);\n      if (Number.isNaN(port)) {\n        throw new Error(`Invalid port: ${String(arg)}`);\n      }\n      return port;\n    },\n  },\n\n  outfileName: {\n    alias: 'n',\n    describe: 'Output file name',\n    type: 'string',\n    demandOption: false,\n    default: 'bundle.js',\n  },\n\n  root: {\n    alias: 'r',\n    describe: 'Server root directory',\n    type: 'string',\n    demandOption: true,\n    normalize: true,\n    default: '.',\n  },\n\n  sourceMaps: {\n    describe: 'Whether builds include sourcemaps',\n    type: 'boolean',\n    demandOption: false,\n    default: false,\n  },\n\n  src: {\n    alias: 's',\n    describe: 'Source file',\n    type: 'string',\n    demandOption: true,\n    normalize: true,\n    default: 'src/index.js',\n  },\n\n  stripComments: {\n    alias: 'strip',\n    describe: 'Whether to remove code comments from the build output',\n    type: 'boolean',\n    demandOption: false,\n    default: true,\n  },\n\n  suppressWarnings: {\n    type: 'boolean',\n    describe: 'Whether to suppress warnings',\n    demandOption: false,\n    default: false,\n  },\n\n  transpilationMode: {\n    type: 'string',\n    describe:\n      'Whether to use Babel to transpile all source code (including dependencies), local source code only, or nothing.',\n    demandOption: false,\n    default: TranspilationModes.LocalOnly,\n    choices: Object.values(TranspilationModes),\n  },\n\n  depsToTranspile: {\n    type: 'array',\n    describe: 'Transpile only the listed dependencies.',\n    demandOption: false,\n  },\n\n  verboseErrors: {\n    type: 'boolean',\n    describe: 'Display original errors',\n    demandOption: false,\n    default: true,\n  },\n\n  writeManifest: {\n    describe: 'Make necessary changes to the Snap manifest file',\n    type: 'boolean',\n    demandOption: false,\n    default: true,\n  },\n\n  serve: {\n    describe: 'Serve Snap file(s) locally for testing',\n    type: 'boolean',\n    demandOption: false,\n    default: true,\n  },\n\n  directory: {\n    describe: 'the directory to use',\n    type: 'string',\n  },\n};\n\nexport default builders;\n"]}

package/dist/{types/cli.d.ts → cli.d.ts}

@@ -5,4 +5,4 @@
  * @param argv - The raw command line arguments, i.e., `process.argv`.
  * @param commands - The list of commands to use.
  */
-export declare function cli(argv: string[], commands: any): Promise<void>;
+export declare function cli(argv: string[], commands: any): void;

package/dist/cli.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cli = void 0;
+const yargs_1 = __importDefault(require("yargs"));
+const builders_1 = __importDefault(require("./builders"));
+const utils_1 = require("./utils");
+/**
+ * The main CLI entry point function. This processes the command line args, and
+ * runs the appropriate function.
+ *
+ * @param argv - The raw command line arguments, i.e., `process.argv`.
+ * @param commands - The list of commands to use.
+ */
+function cli(argv, commands) {
+    const rawArgv = argv.slice(2);
+    // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+    (0, yargs_1.default)(rawArgv)
+        .scriptName('mm-snap')
+        .usage('Usage: $0 <command> [options]')
+        .example('$0 init', `\tInitialize a snap project in the current directory`)
+        .example('$0 init my-snap', `\tInitialize a snap project in the 'my-snap' directory`)
+        .example('$0 build -s src/index.js -d out', `\tBuild 'src/index.js' as './out/bundle.js'`)
+        .example('$0 build -s src/index.js -d out -n snap.js', `\tBuild 'src/index.js' as './out/snap.js'`)
+        .example('$0 serve -r out', `\tServe files in './out' on port 8080`)
+        .example('$0 serve -r out -p 9000', `\tServe files in './out' on port 9000`)
+        .example('$0 watch -s src/index.js -d out', `\tRebuild './out/bundle.js' on changes to files in 'src/index.js' parent and child directories`)
+        .command(commands)
+        .option('verboseErrors', builders_1.default.verboseErrors)
+        .option('suppressWarnings', builders_1.default.suppressWarnings)
+        .strict()
+        // Typecast: The @types/yargs type for .middleware is incorrect.
+        // yargs middleware functions receive the yargs instance as a second parameter.
+        // ref: https://yargs.js.org/docs/#api-reference-middlewarecallbacks-applybeforevalidation
+        .middleware(((yargsArgv, yargsInstance) => {
+        (0, utils_1.applyConfig)((0, utils_1.loadConfig)(), rawArgv, yargsArgv, yargsInstance);
+        (0, utils_1.setSnapGlobals)(yargsArgv);
+        (0, utils_1.sanitizeInputs)(yargsArgv);
+    }), true)
+        .fail((message, error, _yargs) => {
+        (0, utils_1.logError)(message, error);
+        process.exitCode = 1;
+    })
+        .demandCommand(1, 'You must specify at least one command.')
+        .help()
+        .alias('help', 'h').argv;
+}
+exports.cli = cli;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyC;AAGzC,0DAAkC;AAClC,mCAMiB;AAEjB;;;;;;GAMG;AACH,SAAgB,GAAG,CAAC,IAAc,EAAE,QAAa;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,oEAAoE;IACpE,IAAA,eAAK,EAAC,OAAO,CAAC;SACX,UAAU,CAAC,SAAS,CAAC;SACrB,KAAK,CAAC,+BAA+B,CAAC;SAEtC,OAAO,CAAC,SAAS,EAAE,sDAAsD,CAAC;SAC1E,OAAO,CACN,iBAAiB,EACjB,wDAAwD,CACzD;SACA,OAAO,CACN,iCAAiC,EACjC,6CAA6C,CAC9C;SACA,OAAO,CACN,4CAA4C,EAC5C,2CAA2C,CAC5C;SACA,OAAO,CAAC,iBAAiB,EAAE,uCAAuC,CAAC;SACnE,OAAO,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;SAC3E,OAAO,CACN,iCAAiC,EACjC,gGAAgG,CACjG;SAEA,OAAO,CAAC,QAAQ,CAAC;SAEjB,MAAM,CAAC,eAAe,EAAE,kBAAQ,CAAC,aAAa,CAAC;SAE/C,MAAM,CAAC,kBAAkB,EAAE,kBAAQ,CAAC,gBAAgB,CAAC;SAErD,MAAM,EAAE;QAET,gEAAgE;QAChE,+EAA+E;QAC/E,0FAA0F;SACzF,UAAU,CACT,CAAC,CAAC,SAAoB,EAAE,aAA+B,EAAE,EAAE;QACzD,IAAA,mBAAW,EAAC,IAAA,kBAAU,GAAE,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAA,sBAAc,EAAC,SAAS,CAAC,CAAC;QAC1B,IAAA,sBAAc,EAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAQ,EACT,IAAI,CACL;SAEA,IAAI,CAAC,CAAC,OAAe,EAAE,KAAY,EAAE,MAAM,EAAE,EAAE;QAC9C,IAAA,gBAAQ,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC;SAED,aAAa,CAAC,CAAC,EAAE,wCAAwC,CAAC;SAE1D,IAAI,EAAE;SACN,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC;AAC7B,CAAC;AAxDD,kBAwDC","sourcesContent":["import yargs, { Arguments } from 'yargs';\nimport yargsType from 'yargs/yargs';\n\nimport builders from './builders';\nimport {\n  applyConfig,\n  loadConfig,\n  sanitizeInputs,\n  setSnapGlobals,\n  logError,\n} from './utils';\n\n/**\n * The main CLI entry point function. This processes the command line args, and\n * runs the appropriate function.\n *\n * @param argv - The raw command line arguments, i.e., `process.argv`.\n * @param commands - The list of commands to use.\n */\nexport function cli(argv: string[], commands: any): void {\n  const rawArgv = argv.slice(2);\n  // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n  yargs(rawArgv)\n    .scriptName('mm-snap')\n    .usage('Usage: $0 <command> [options]')\n\n    .example('$0 init', `\\tInitialize a snap project in the current directory`)\n    .example(\n      '$0 init my-snap',\n      `\\tInitialize a snap project in the 'my-snap' directory`,\n    )\n    .example(\n      '$0 build -s src/index.js -d out',\n      `\\tBuild 'src/index.js' as './out/bundle.js'`,\n    )\n    .example(\n      '$0 build -s src/index.js -d out -n snap.js',\n      `\\tBuild 'src/index.js' as './out/snap.js'`,\n    )\n    .example('$0 serve -r out', `\\tServe files in './out' on port 8080`)\n    .example('$0 serve -r out -p 9000', `\\tServe files in './out' on port 9000`)\n    .example(\n      '$0 watch -s src/index.js -d out',\n      `\\tRebuild './out/bundle.js' on changes to files in 'src/index.js' parent and child directories`,\n    )\n\n    .command(commands)\n\n    .option('verboseErrors', builders.verboseErrors)\n\n    .option('suppressWarnings', builders.suppressWarnings)\n\n    .strict()\n\n    // Typecast: The @types/yargs type for .middleware is incorrect.\n    // yargs middleware functions receive the yargs instance as a second parameter.\n    // ref: https://yargs.js.org/docs/#api-reference-middlewarecallbacks-applybeforevalidation\n    .middleware(\n      ((yargsArgv: Arguments, yargsInstance: typeof yargsType) => {\n        applyConfig(loadConfig(), rawArgv, yargsArgv, yargsInstance);\n        setSnapGlobals(yargsArgv);\n        sanitizeInputs(yargsArgv);\n      }) as any,\n      true,\n    )\n\n    .fail((message: string, error: Error, _yargs) => {\n      logError(message, error);\n      process.exitCode = 1;\n    })\n\n    .demandCommand(1, 'You must specify at least one command.')\n\n    .help()\n    .alias('help', 'h').argv;\n}\n"]}

package/dist/cmds/build/buildHandler.d.ts

@@ -0,0 +1,13 @@
+import { YargsArgs } from '../../types/yargs';
+/**
+ * Builds all files in the given source directory to the given destination
+ * directory.
+ *
+ * Creates destination directory if it doesn't exist.
+ *
+ * @param argv - Argv from Yargs.
+ * @param argv.src - The source file path.
+ * @param argv.dist - The output directory path.
+ * @param argv.outfileName - The output file name.
+ */
+export declare function build(argv: YargsArgs): Promise<void>;

package/dist/cmds/build/buildHandler.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.build = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const utils_1 = require("../../utils");
+const evalHandler_1 = require("../eval/evalHandler");
+const manifestHandler_1 = require("../manifest/manifestHandler");
+const bundle_1 = require("./bundle");
+/**
+ * Builds all files in the given source directory to the given destination
+ * directory.
+ *
+ * Creates destination directory if it doesn't exist.
+ *
+ * @param argv - Argv from Yargs.
+ * @param argv.src - The source file path.
+ * @param argv.dist - The output directory path.
+ * @param argv.outfileName - The output file name.
+ */
+async function build(argv) {
+    const { src, dist, outfileName } = argv;
+    if (outfileName) {
+        (0, snaps_utils_1.validateOutfileName)(outfileName);
+    }
+    await (0, snaps_utils_1.validateFilePath)(src);
+    await (0, snaps_utils_1.validateDirPath)(dist, true);
+    const outfilePath = (0, snaps_utils_1.getOutfilePath)(dist, outfileName);
+    const result = await (0, bundle_1.bundle)(src, outfilePath, argv, (0, utils_1.loadConfig)().bundlerCustomizer);
+    if (result && argv.eval) {
+        await (0, evalHandler_1.evalHandler)({ ...argv, bundle: outfilePath });
+    }
+    if (argv.manifest) {
+        await (0, manifestHandler_1.manifestHandler)(argv);
+    }
+}
+exports.build = build;
+//# sourceMappingURL=buildHandler.js.map

package/dist/cmds/build/buildHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHandler.js","sourceRoot":"","sources":["../../../src/cmds/build/buildHandler.ts"],"names":[],"mappings":";;;AAAA,uDAK+B;AAG/B,uCAAyC;AACzC,qDAAkD;AAClD,iEAA8D;AAC9D,qCAAkC;AAElC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,KAAK,CAAC,IAAe;IACzC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACxC,IAAI,WAAW,EAAE;QACf,IAAA,iCAAmB,EAAC,WAAW,CAAC,CAAC;KAClC;IACD,MAAM,IAAA,8BAAgB,EAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAA,6BAAe,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAElC,MAAM,WAAW,GAAG,IAAA,4BAAc,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,IAAA,eAAM,EACzB,GAAG,EACH,WAAW,EACX,IAAI,EACJ,IAAA,kBAAU,GAAE,CAAC,iBAAiB,CAC/B,CAAC;IACF,IAAI,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE;QACvB,MAAM,IAAA,yBAAW,EAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;KACrD;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE;QACjB,MAAM,IAAA,iCAAe,EAAC,IAAI,CAAC,CAAC;KAC7B;AACH,CAAC;AAtBD,sBAsBC","sourcesContent":["import {\n  getOutfilePath,\n  validateDirPath,\n  validateFilePath,\n  validateOutfileName,\n} from '@metamask/snaps-utils';\n\nimport { YargsArgs } from '../../types/yargs';\nimport { loadConfig } from '../../utils';\nimport { evalHandler } from '../eval/evalHandler';\nimport { manifestHandler } from '../manifest/manifestHandler';\nimport { bundle } from './bundle';\n\n/**\n * Builds all files in the given source directory to the given destination\n * directory.\n *\n * Creates destination directory if it doesn't exist.\n *\n * @param argv - Argv from Yargs.\n * @param argv.src - The source file path.\n * @param argv.dist - The output directory path.\n * @param argv.outfileName - The output file name.\n */\nexport async function build(argv: YargsArgs): Promise<void> {\n  const { src, dist, outfileName } = argv;\n  if (outfileName) {\n    validateOutfileName(outfileName);\n  }\n  await validateFilePath(src);\n  await validateDirPath(dist, true);\n\n  const outfilePath = getOutfilePath(dist, outfileName);\n  const result = await bundle(\n    src,\n    outfilePath,\n    argv,\n    loadConfig().bundlerCustomizer,\n  );\n  if (result && argv.eval) {\n    await evalHandler({ ...argv, bundle: outfilePath });\n  }\n\n  if (argv.manifest) {\n    await manifestHandler(argv);\n  }\n}\n"]}

package/dist/cmds/build/bundle.d.ts

@@ -0,0 +1,15 @@
+import { BrowserifyObject } from 'browserify';
+import { YargsArgs } from '../../types/yargs';
+/**
+ * Builds a Snap bundle JS file from its JavaScript source.
+ *
+ * @param src - The source file path.
+ * @param dest - The destination file path.
+ * @param argv - Arguments as an object generated by `yargs`.
+ * @param argv.sourceMaps - Whether to output sourcemaps.
+ * @param argv.stripComments - Whether to remove comments from code.
+ * @param argv.transpilationMode - The Babel transpilation mode.
+ * @param bundlerTransform - An optional function which can be used to transform
+ * the Browserify instance, e.g., adding a custom transform or plugin.
+ */
+export declare function bundle(src: string, dest: string, argv: YargsArgs, bundlerTransform?: (bundler: BrowserifyObject) => void): Promise<boolean>;

package/dist/cmds/build/bundle.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundle = void 0;
+const snaps_browserify_plugin_1 = __importDefault(require("@metamask/snaps-browserify-plugin"));
+const browserify_1 = __importDefault(require("browserify"));
+const builders_1 = require("../../builders");
+const utils_1 = require("./utils");
+// We need to statically import all Browserify transforms and all Babel presets
+// and plugins, and calling `require` is the sanest way to do that.
+/* eslint-disable @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, node/global-require */
+/**
+ * Builds a Snap bundle JS file from its JavaScript source.
+ *
+ * @param src - The source file path.
+ * @param dest - The destination file path.
+ * @param argv - Arguments as an object generated by `yargs`.
+ * @param argv.sourceMaps - Whether to output sourcemaps.
+ * @param argv.stripComments - Whether to remove comments from code.
+ * @param argv.transpilationMode - The Babel transpilation mode.
+ * @param bundlerTransform - An optional function which can be used to transform
+ * the Browserify instance, e.g., adding a custom transform or plugin.
+ */
+async function bundle(src, dest, argv, bundlerTransform) {
+    const { sourceMaps: debug, transpilationMode } = argv;
+    const babelifyOptions = (0, utils_1.processDependencies)(argv);
+    return new Promise((resolve, _reject) => {
+        const bundler = (0, browserify_1.default)(src, {
+            debug,
+            extensions: ['.js', '.ts'],
+            // Standalone is required to properly support Snaps using module.exports
+            standalone: '<snap>',
+        });
+        if (transpilationMode !== builders_1.TranspilationModes.None) {
+            bundler.transform(require('babelify'), {
+                global: transpilationMode === builders_1.TranspilationModes.LocalAndDeps,
+                extensions: ['.js', '.ts'],
+                presets: [
+                    require('@babel/preset-typescript'),
+                    [
+                        require('@babel/preset-env'),
+                        {
+                            targets: {
+                                browsers: ['chrome >= 66', 'firefox >= 68'],
+                            },
+                        },
+                    ],
+                ],
+                plugins: [
+                    require('@babel/plugin-transform-runtime'),
+                    require('@babel/plugin-proposal-class-properties'),
+                    require('@babel/plugin-proposal-object-rest-spread'),
+                    require('@babel/plugin-proposal-optional-chaining'),
+                    require('@babel/plugin-proposal-nullish-coalescing-operator'),
+                ],
+                parserOpts: {
+                    attachComment: !argv.stripComments,
+                },
+                ...babelifyOptions,
+            });
+        }
+        bundlerTransform?.(bundler);
+        bundler.plugin(snaps_browserify_plugin_1.default, {
+            stripComments: argv.stripComments,
+            manifestPath: undefined,
+            eval: false,
+        });
+        bundler.bundle(async (bundleError, bundleBuffer) => await (0, utils_1.writeBundleFile)({
+            bundleError,
+            bundleBuffer,
+            src,
+            dest,
+            resolve,
+        }));
+    });
+}
+exports.bundle = bundle;
+//# sourceMappingURL=bundle.js.map

package/dist/cmds/build/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/cmds/build/bundle.ts"],"names":[],"mappings":";;;;;;AAAA,gGAAoE;AACpE,4DAA0D;AAE1D,6CAAoD;AAEpD,mCAA+D;AAE/D,+EAA+E;AAC/E,mEAAmE;AACnE,mHAAmH;AAEnH;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,MAAM,CAC1B,GAAW,EACX,IAAY,EACZ,IAAe,EACf,gBAAsD;IAEtD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,eAAe,GAAG,IAAA,2BAAmB,EAAC,IAAW,CAAC,CAAC;IACzD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,IAAA,oBAAU,EAAC,GAAG,EAAE;YAC9B,KAAK;YACL,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;YAC1B,wEAAwE;YACxE,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;QAEH,IAAI,iBAAiB,KAAK,6BAAkB,CAAC,IAAI,EAAE;YACjD,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACrC,MAAM,EAAE,iBAAiB,KAAK,6BAAkB,CAAC,YAAY;gBAC7D,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC1B,OAAO,EAAE;oBACP,OAAO,CAAC,0BAA0B,CAAC;oBACnC;wBACE,OAAO,CAAC,mBAAmB,CAAC;wBAC5B;4BACE,OAAO,EAAE;gCACP,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;6BAC5C;yBACF;qBACF;iBACF;gBACD,OAAO,EAAE;oBACP,OAAO,CAAC,iCAAiC,CAAC;oBAC1C,OAAO,CAAC,yCAAyC,CAAC;oBAClD,OAAO,CAAC,2CAA2C,CAAC;oBACpD,OAAO,CAAC,0CAA0C,CAAC;oBACnD,OAAO,CAAC,oDAAoD,CAAC;iBAC9D;gBACD,UAAU,EAAE;oBACV,aAAa,EAAE,CAAC,IAAI,CAAC,aAAa;iBACnC;gBACD,GAAI,eAAuB;aAC5B,CAAC,CAAC;SACJ;QAED,gBAAgB,EAAE,CAAC,OAAO,CAAC,CAAC;QAE5B,OAAO,CAAC,MAAM,CAAU,iCAAM,EAAE;YAC9B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CACZ,KAAK,EAAE,WAAW,EAAE,YAAoB,EAAE,EAAE,CAC1C,MAAM,IAAA,uBAAe,EAAC;YACpB,WAAW;YACX,YAAY;YACZ,GAAG;YACH,IAAI;YACJ,OAAO;SACR,CAAC,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAhED,wBAgEC","sourcesContent":["import plugin, { Options } from '@metamask/snaps-browserify-plugin';\nimport browserify, { BrowserifyObject } from 'browserify';\n\nimport { TranspilationModes } from '../../builders';\nimport { YargsArgs } from '../../types/yargs';\nimport { processDependencies, writeBundleFile } from './utils';\n\n// We need to statically import all Browserify transforms and all Babel presets\n// and plugins, and calling `require` is the sanest way to do that.\n/* eslint-disable @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires, node/global-require */\n\n/**\n * Builds a Snap bundle JS file from its JavaScript source.\n *\n * @param src - The source file path.\n * @param dest - The destination file path.\n * @param argv - Arguments as an object generated by `yargs`.\n * @param argv.sourceMaps - Whether to output sourcemaps.\n * @param argv.stripComments - Whether to remove comments from code.\n * @param argv.transpilationMode - The Babel transpilation mode.\n * @param bundlerTransform - An optional function which can be used to transform\n * the Browserify instance, e.g., adding a custom transform or plugin.\n */\nexport async function bundle(\n  src: string,\n  dest: string,\n  argv: YargsArgs,\n  bundlerTransform?: (bundler: BrowserifyObject) => void,\n): Promise<boolean> {\n  const { sourceMaps: debug, transpilationMode } = argv;\n  const babelifyOptions = processDependencies(argv as any);\n  return new Promise((resolve, _reject) => {\n    const bundler = browserify(src, {\n      debug,\n      extensions: ['.js', '.ts'],\n      // Standalone is required to properly support Snaps using module.exports\n      standalone: '<snap>',\n    });\n\n    if (transpilationMode !== TranspilationModes.None) {\n      bundler.transform(require('babelify'), {\n        global: transpilationMode === TranspilationModes.LocalAndDeps,\n        extensions: ['.js', '.ts'],\n        presets: [\n          require('@babel/preset-typescript'),\n          [\n            require('@babel/preset-env'),\n            {\n              targets: {\n                browsers: ['chrome >= 66', 'firefox >= 68'],\n              },\n            },\n          ],\n        ],\n        plugins: [\n          require('@babel/plugin-transform-runtime'),\n          require('@babel/plugin-proposal-class-properties'),\n          require('@babel/plugin-proposal-object-rest-spread'),\n          require('@babel/plugin-proposal-optional-chaining'),\n          require('@babel/plugin-proposal-nullish-coalescing-operator'),\n        ],\n        parserOpts: {\n          attachComment: !argv.stripComments,\n        },\n        ...(babelifyOptions as any),\n      });\n    }\n\n    bundlerTransform?.(bundler);\n\n    bundler.plugin<Options>(plugin, {\n      stripComments: argv.stripComments,\n      manifestPath: undefined,\n      eval: false,\n    });\n\n    bundler.bundle(\n      async (bundleError, bundleBuffer: Buffer) =>\n        await writeBundleFile({\n          bundleError,\n          bundleBuffer,\n          src,\n          dest,\n          resolve,\n        }),\n    );\n  });\n}\n"]}

package/dist/{types/commands/serve → cmds/build}/index.d.ts

@@ -1,9 +1,9 @@
-import type yargs from 'yargs';
-import type { YargsArgs } from '../../types/yargs';
-declare const command: {
+import yargs from 'yargs';
+import { YargsArgs } from '../../types/yargs';
+declare const _default: {
     command: string[];
     desc: string;
     builder: (yarg: yargs.Argv) => void;
     handler: (argv: YargsArgs) => Promise<void>;
 };
-export default command;
+export = _default;

package/dist/cmds/build/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const builders_1 = __importDefault(require("../../builders"));
+const buildHandler_1 = require("./buildHandler");
+const utils_1 = require("./utils");
+module.exports = {
+    command: ['build', 'b'],
+    desc: 'Build Snap from source',
+    builder: (yarg) => {
+        yarg
+            .option('dist', builders_1.default.dist)
+            .option('eval', builders_1.default.eval)
+            .option('manifest', builders_1.default.manifest)
+            .option('outfileName', builders_1.default.outfileName)
+            .option('sourceMaps', builders_1.default.sourceMaps)
+            .option('src', builders_1.default.src)
+            .option('stripComments', builders_1.default.stripComments)
+            .option('transpilationMode', builders_1.default.transpilationMode)
+            .option('depsToTranspile', builders_1.default.depsToTranspile)
+            .option('writeManifest', builders_1.default.writeManifest)
+            .implies('writeManifest', 'manifest')
+            .implies('depsToTranspile', 'transpilationMode')
+            .middleware((argv) => (0, utils_1.processInvalidTranspilation)(argv));
+    },
+    handler: async (argv) => (0, buildHandler_1.build)(argv),
+};
+//# sourceMappingURL=index.js.map

package/dist/cmds/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmds/build/index.ts"],"names":[],"mappings":";;;;AAEA,8DAAsC;AAEtC,iDAAuC;AACvC,mCAAsD;AAEtD,iBAAS;IACP,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;IACvB,IAAI,EAAE,wBAAwB;IAC9B,OAAO,EAAE,CAAC,IAAgB,EAAE,EAAE;QAC5B,IAAI;aACD,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,UAAU,EAAE,kBAAQ,CAAC,QAAQ,CAAC;aACrC,MAAM,CAAC,aAAa,EAAE,kBAAQ,CAAC,WAAW,CAAC;aAC3C,MAAM,CAAC,YAAY,EAAE,kBAAQ,CAAC,UAAU,CAAC;aACzC,MAAM,CAAC,KAAK,EAAE,kBAAQ,CAAC,GAAG,CAAC;aAC3B,MAAM,CAAC,eAAe,EAAE,kBAAQ,CAAC,aAAa,CAAC;aAC/C,MAAM,CAAC,mBAAmB,EAAE,kBAAQ,CAAC,iBAAiB,CAAC;aACvD,MAAM,CAAC,iBAAiB,EAAE,kBAAQ,CAAC,eAAe,CAAC;aACnD,MAAM,CAAC,eAAe,EAAE,kBAAQ,CAAC,aAAa,CAAC;aAC/C,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC;aACpC,OAAO,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;aAC/C,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mCAA2B,EAAC,IAAW,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAe,EAAE,EAAE,CAAC,IAAA,oBAAK,EAAC,IAAI,CAAC;CAChD,CAAC","sourcesContent":["import yargs from 'yargs';\n\nimport builders from '../../builders';\nimport { YargsArgs } from '../../types/yargs';\nimport { build } from './buildHandler';\nimport { processInvalidTranspilation } from './utils';\n\nexport = {\n  command: ['build', 'b'],\n  desc: 'Build Snap from source',\n  builder: (yarg: yargs.Argv) => {\n    yarg\n      .option('dist', builders.dist)\n      .option('eval', builders.eval)\n      .option('manifest', builders.manifest)\n      .option('outfileName', builders.outfileName)\n      .option('sourceMaps', builders.sourceMaps)\n      .option('src', builders.src)\n      .option('stripComments', builders.stripComments)\n      .option('transpilationMode', builders.transpilationMode)\n      .option('depsToTranspile', builders.depsToTranspile)\n      .option('writeManifest', builders.writeManifest)\n      .implies('writeManifest', 'manifest')\n      .implies('depsToTranspile', 'transpilationMode')\n      .middleware((argv) => processInvalidTranspilation(argv as any));\n  },\n  handler: async (argv: YargsArgs) => build(argv),\n};\n"]}

package/dist/cmds/build/utils.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="node" />
+import { YargsArgs } from '../../types/yargs';
+declare type WriteBundleFileArgs = {
+    bundleError: Error;
+    bundleBuffer: Buffer;
+    src: string;
+    dest: string;
+    resolve: (value: boolean) => void;
+};
+/**
+ * Performs postprocessing on the bundle contents and writes them to disk.
+ * Intended to be used in the callback passed to the Browserify `.bundle()`
+ * call.
+ *
+ * @param options - Options bag.
+ * @param options.bundleError - Any error received from Browserify.
+ * @param options.bundleBuffer - The {@link Buffer} with the bundle contents
+ * from Browserify.
+ * @param options.src - The source file path.
+ * @param options.dest - The destination file path.
+ * @param options.resolve - A {@link Promise} resolution function, so that we
+ * can use promises and `async`/`await` even though Browserify uses callbacks.
+ */
+export declare function writeBundleFile({ bundleError, bundleBuffer, src, dest, resolve, }: WriteBundleFileArgs): Promise<void>;
+/**
+ * Processes dependencies and updates `argv` with an options object.
+ *
+ * @param argv - The Yargs arguments object.
+ * @returns An object with options that can be passed to Babelify.
+ */
+export declare function processDependencies(argv: YargsArgs): Record<string, any>;
+/**
+ * Processes a string of space delimited dependencies into one RegExp string.
+ *
+ * @param dependencies - An array of dependencies to add to the RegExp.
+ * @returns A RegExp object.
+ */
+export declare function getDependencyRegExp(dependencies: string[]): RegExp | null;
+/**
+ * Helper function remove any leading and trailing slashes from dependency list.
+ *
+ * @param dependencies - An array of dependencies to sanitize.
+ * @returns An array of sanitized paths.
+ */
+export declare function sanitizeDependencyPaths(dependencies: string[]): string[];
+/**
+ * Check the Yargs argv object, to see if the provided options are valid. The
+ * options are invalid if both `depsToTranspile` are provided, and
+ * `transpilationMode` is not set to `localAndDeps`.
+ *
+ * @param argv - The Yargs arguments object.
+ * @throws If the `depsToTranspile` is set, and `transpilationMode` is not set
+ * to `localAndDeps`.
+ */
+export declare function processInvalidTranspilation(argv: YargsArgs): void;
+export {};

package/dist/cmds/build/utils.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processInvalidTranspilation = exports.sanitizeDependencyPaths = exports.getDependencyRegExp = exports.processDependencies = exports.writeBundleFile = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const fs_1 = require("fs");
+const builders_1 = require("../../builders");
+const utils_1 = require("../../utils");
+/**
+ * Performs postprocessing on the bundle contents and writes them to disk.
+ * Intended to be used in the callback passed to the Browserify `.bundle()`
+ * call.
+ *
+ * @param options - Options bag.
+ * @param options.bundleError - Any error received from Browserify.
+ * @param options.bundleBuffer - The {@link Buffer} with the bundle contents
+ * from Browserify.
+ * @param options.src - The source file path.
+ * @param options.dest - The destination file path.
+ * @param options.resolve - A {@link Promise} resolution function, so that we
+ * can use promises and `async`/`await` even though Browserify uses callbacks.
+ */
+async function writeBundleFile({ bundleError, bundleBuffer, src, dest, resolve, }) {
+    if (bundleError) {
+        await (0, utils_1.writeError)('Build error:', bundleError.message, bundleError);
+    }
+    try {
+        await fs_1.promises.writeFile(dest, bundleBuffer?.toString());
+        (0, snaps_utils_1.logInfo)(`Build success: '${src}' bundled as '${dest}'!`);
+        resolve(true);
+    }
+    catch (error) {
+        await (0, utils_1.writeError)('Write error:', error.message, error, dest);
+    }
+}
+exports.writeBundleFile = writeBundleFile;
+/**
+ * Processes dependencies and updates `argv` with an options object.
+ *
+ * @param argv - The Yargs arguments object.
+ * @returns An object with options that can be passed to Babelify.
+ */
+function processDependencies(argv) {
+    const { depsToTranspile, transpilationMode } = argv;
+    const babelifyOptions = {};
+    if (transpilationMode === builders_1.TranspilationModes.LocalAndDeps) {
+        const regexpStr = getDependencyRegExp(depsToTranspile);
+        if (regexpStr !== null) {
+            babelifyOptions.ignore = [regexpStr];
+        }
+    }
+    return babelifyOptions;
+}
+exports.processDependencies = processDependencies;
+/**
+ * Processes a string of space delimited dependencies into one RegExp string.
+ *
+ * @param dependencies - An array of dependencies to add to the RegExp.
+ * @returns A RegExp object.
+ */
+function getDependencyRegExp(dependencies) {
+    let regexp = null;
+    if (!dependencies || dependencies.includes('.') || !dependencies.length) {
+        return regexp;
+    }
+    const paths = sanitizeDependencyPaths(dependencies);
+    regexp = `/node_modules/(?!${paths.shift() ?? ''}`;
+    paths.forEach((path) => (regexp += `|${path}`));
+    regexp += '/)';
+    return RegExp(regexp, 'u');
+}
+exports.getDependencyRegExp = getDependencyRegExp;
+/**
+ * Helper function remove any leading and trailing slashes from dependency list.
+ *
+ * @param dependencies - An array of dependencies to sanitize.
+ * @returns An array of sanitized paths.
+ */
+function sanitizeDependencyPaths(dependencies) {
+    return dependencies.map((dependency) => {
+        return dependency.replace(/^[/\\]+/u, '').replace(/[/\\]+$/u, '');
+    });
+}
+exports.sanitizeDependencyPaths = sanitizeDependencyPaths;
+/**
+ * Check the Yargs argv object, to see if the provided options are valid. The
+ * options are invalid if both `depsToTranspile` are provided, and
+ * `transpilationMode` is not set to `localAndDeps`.
+ *
+ * @param argv - The Yargs arguments object.
+ * @throws If the `depsToTranspile` is set, and `transpilationMode` is not set
+ * to `localAndDeps`.
+ */
+function processInvalidTranspilation(argv) {
+    if (argv.depsToTranspile &&
+        argv.transpilationMode !== builders_1.TranspilationModes.LocalAndDeps) {
+        throw new Error('"depsToTranspile" can only be specified if "transpilationMode" is set to "localAndDeps" .');
+    }
+}
+exports.processInvalidTranspilation = processInvalidTranspilation;
+//# sourceMappingURL=utils.js.map