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

package/dist/cmds/serve/serveHandler.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serve = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const http_1 = __importDefault(require("http"));
+const serve_handler_1 = __importDefault(require("serve-handler"));
+const serveUtils_1 = require("./serveUtils");
+/**
+ * Starts a local, static HTTP server on the given port with the given root
+ * directory.
+ *
+ * @param argv - Arguments as an object generated by Yargs.
+ * @param argv.root - The root directory path string.
+ * @param argv.port - The server port.
+ */
+async function serve(argv) {
+    const { port, root: rootDir } = argv;
+    await (0, snaps_utils_1.validateDirPath)(rootDir, true);
+    (0, snaps_utils_1.logInfo)(`\nStarting server...`);
+    const server = http_1.default.createServer((req, res) => {
+        (0, serve_handler_1.default)(req, res, {
+            public: rootDir,
+            headers: [
+                {
+                    source: '**/*',
+                    headers: [
+                        {
+                            key: 'Cache-Control',
+                            value: 'no-cache',
+                        },
+                        {
+                            key: 'Access-Control-Allow-Origin',
+                            value: '*',
+                        },
+                    ],
+                },
+            ],
+        })?.catch((error) => {
+            (0, serveUtils_1.logServerError)(error, argv.port);
+            res.statusCode = 500;
+            res.end();
+        });
+    });
+    server.listen({ port }, () => (0, serveUtils_1.logServerListening)(port));
+    server.on('request', (request) => (0, serveUtils_1.logRequest)(request));
+    server.on('error', (error) => {
+        (0, serveUtils_1.logServerError)(error, argv.port);
+        process.exitCode = 1;
+    });
+    server.on('close', () => {
+        (0, snaps_utils_1.logInfo)('Server closed');
+        process.exitCode = 1;
+    });
+}
+exports.serve = serve;
+//# sourceMappingURL=serveHandler.js.map

package/dist/cmds/serve/serveHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveHandler.js","sourceRoot":"","sources":["../../../src/cmds/serve/serveHandler.ts"],"names":[],"mappings":";;;;;;AAAA,uDAAiE;AACjE,gDAAwB;AACxB,kEAAyC;AAGzC,6CAA8E;AAE9E;;;;;;;GAOG;AACI,KAAK,UAAU,KAAK,CAAC,IAAe;IACzC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAErC,MAAM,IAAA,6BAAe,EAAC,OAAiB,EAAE,IAAI,CAAC,CAAC;IAE/C,IAAA,qBAAO,EAAC,sBAAsB,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAG,cAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5C,IAAA,uBAAY,EAAC,GAAG,EAAE,GAAG,EAAE;YACrB,MAAM,EAAE,OAAiB;YACzB,OAAO,EAAE;gBACP;oBACE,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP;4BACE,GAAG,EAAE,eAAe;4BACpB,KAAK,EAAE,UAAU;yBAClB;wBACD;4BACE,GAAG,EAAE,6BAA6B;4BAClC,KAAK,EAAE,GAAG;yBACX;qBACF;iBACF;aACF;SACF,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAClB,IAAA,2BAAc,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAA,+BAAkB,EAAC,IAAI,CAAC,CAAC,CAAC;IAExD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAA,uBAAU,EAAC,OAAO,CAAC,CAAC,CAAC;IAEvD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3B,IAAA,2BAAc,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACtB,IAAA,qBAAO,EAAC,eAAe,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AA7CD,sBA6CC","sourcesContent":["import { logInfo, validateDirPath } from '@metamask/snaps-utils';\nimport http from 'http';\nimport serveHandler from 'serve-handler';\n\nimport { YargsArgs } from '../../types/yargs';\nimport { logRequest, logServerError, logServerListening } from './serveUtils';\n\n/**\n * Starts a local, static HTTP server on the given port with the given root\n * directory.\n *\n * @param argv - Arguments as an object generated by Yargs.\n * @param argv.root - The root directory path string.\n * @param argv.port - The server port.\n */\nexport async function serve(argv: YargsArgs): Promise<void> {\n  const { port, root: rootDir } = argv;\n\n  await validateDirPath(rootDir as string, true);\n\n  logInfo(`\\nStarting server...`);\n\n  const server = http.createServer((req, res) => {\n    serveHandler(req, res, {\n      public: rootDir as string,\n      headers: [\n        {\n          source: '**/*',\n          headers: [\n            {\n              key: 'Cache-Control',\n              value: 'no-cache',\n            },\n            {\n              key: 'Access-Control-Allow-Origin',\n              value: '*',\n            },\n          ],\n        },\n      ],\n    })?.catch((error) => {\n      logServerError(error, argv.port);\n      res.statusCode = 500;\n      res.end();\n    });\n  });\n\n  server.listen({ port }, () => logServerListening(port));\n\n  server.on('request', (request) => logRequest(request));\n\n  server.on('error', (error) => {\n    logServerError(error, argv.port);\n    process.exitCode = 1;\n  });\n\n  server.on('close', () => {\n    logInfo('Server closed');\n    process.exitCode = 1;\n  });\n}\n"]}

package/dist/cmds/serve/serveUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Log a message with the URL and port of the server.
+ *
+ * @param port - The port that the server is running on.
+ */
+export declare function logServerListening(port: number): void;
+/**
+ * Log a message with the request URL.
+ *
+ * @param request - The request object.
+ * @param request.url - The URL of the request.
+ */
+export declare function logRequest(request: {
+    url?: string;
+}): void;
+/**
+ * Log an error message.
+ *
+ * @param error - The error to log.
+ * @param port - The port that the server is running on.
+ */
+export declare function logServerError(error: Error, port: number): void;

package/dist/cmds/serve/serveUtils.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logServerError = exports.logRequest = exports.logServerListening = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+/**
+ * Log a message with the URL and port of the server.
+ *
+ * @param port - The port that the server is running on.
+ */
+function logServerListening(port) {
+    (0, snaps_utils_1.logInfo)(`Server listening on: http://localhost:${port}`);
+}
+exports.logServerListening = logServerListening;
+/**
+ * Log a message with the request URL.
+ *
+ * @param request - The request object.
+ * @param request.url - The URL of the request.
+ */
+function logRequest(request) {
+    (0, snaps_utils_1.logInfo)(`Handling incoming request for: ${request.url ?? 'unknown'}`);
+}
+exports.logRequest = logRequest;
+/**
+ * Log an error message.
+ *
+ * @param error - The error to log.
+ * @param port - The port that the server is running on.
+ */
+function logServerError(error, port) {
+    if (error.code === 'EADDRINUSE') {
+        (0, snaps_utils_1.logError)(`Server error: Port ${port} already in use.`);
+    }
+    else {
+        (0, snaps_utils_1.logError)(`Server error: ${error.message}`);
+    }
+}
+exports.logServerError = logServerError;
+//# sourceMappingURL=serveUtils.js.map

package/dist/cmds/serve/serveUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveUtils.js","sourceRoot":"","sources":["../../../src/cmds/serve/serveUtils.ts"],"names":[],"mappings":";;;AAAA,uDAA0D;AAE1D;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,IAAA,qBAAO,EAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAFD,gDAEC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,OAAyB;IAClD,IAAA,qBAAO,EAAC,kCAAkC,OAAO,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC,CAAC;AACxE,CAAC;AAFD,gCAEC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,KAAY,EAAE,IAAY;IACvD,IAAK,KAAa,CAAC,IAAI,KAAK,YAAY,EAAE;QACxC,IAAA,sBAAQ,EAAC,sBAAsB,IAAI,kBAAkB,CAAC,CAAC;KACxD;SAAM;QACL,IAAA,sBAAQ,EAAC,iBAAiB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;KAC5C;AACH,CAAC;AAND,wCAMC","sourcesContent":["import { logError, logInfo } from '@metamask/snaps-utils';\n\n/**\n * Log a message with the URL and port of the server.\n *\n * @param port - The port that the server is running on.\n */\nexport function logServerListening(port: number) {\n  logInfo(`Server listening on: http://localhost:${port}`);\n}\n\n/**\n * Log a message with the request URL.\n *\n * @param request - The request object.\n * @param request.url - The URL of the request.\n */\nexport function logRequest(request: { url?: string }) {\n  logInfo(`Handling incoming request for: ${request.url ?? 'unknown'}`);\n}\n\n/**\n * Log an error message.\n *\n * @param error - The error to log.\n * @param port - The port that the server is running on.\n */\nexport function logServerError(error: Error, port: number) {\n  if ((error as any).code === 'EADDRINUSE') {\n    logError(`Server error: Port ${port} already in use.`);\n  } else {\n    logError(`Server error: ${error.message}`);\n  }\n}\n"]}

package/dist/cmds/watch/index.d.ts

@@ -0,0 +1,9 @@
+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;

package/dist/cmds/watch/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cmds/watch/index.ts"],"names":[],"mappings":";;;;AAEA,8DAAsC;AAEtC,0CAA6D;AAC7D,iDAAuC;AAEvC,iBAAS;IACP,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;IACvB,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,CAAC,IAAgB,EAAE,EAAE;QAC5B,IAAI;aACD,MAAM,CAAC,KAAK,EAAE,kBAAQ,CAAC,GAAG,CAAC;aAC3B,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,aAAa,EAAE,kBAAQ,CAAC,WAAW,CAAC;aAC3C,MAAM,CAAC,YAAY,EAAE,kBAAQ,CAAC,UAAU,CAAC;aACzC,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,UAAU,EAAE,kBAAQ,CAAC,QAAQ,CAAC;aACrC,MAAM,CAAC,eAAe,EAAE,kBAAQ,CAAC,aAAa,CAAC;aAC/C,MAAM,CAAC,OAAO,EAAE,kBAAQ,CAAC,KAAK,CAAC;aAC/B,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,MAAM,CAAC,MAAM,EAAE,kBAAQ,CAAC,IAAI,CAAC;aAC7B,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 { processInvalidTranspilation } from '../build/utils';\nimport { watch } from './watchHandler';\n\nexport = {\n  command: ['watch', 'w'],\n  desc: 'Build Snap on change',\n  builder: (yarg: yargs.Argv) => {\n    yarg\n      .option('src', builders.src)\n      .option('eval', builders.eval)\n      .option('dist', builders.dist)\n      .option('outfileName', builders.outfileName)\n      .option('sourceMaps', builders.sourceMaps)\n      .option('stripComments', builders.stripComments)\n      .option('transpilationMode', builders.transpilationMode)\n      .option('depsToTranspile', builders.depsToTranspile)\n      .option('manifest', builders.manifest)\n      .option('writeManifest', builders.writeManifest)\n      .option('serve', builders.serve)\n      .option('root', builders.root)\n      .option('port', builders.port)\n      .implies('writeManifest', 'manifest')\n      .implies('depsToTranspile', 'transpilationMode')\n      .middleware((argv) => processInvalidTranspilation(argv as any));\n  },\n  handler: async (argv: YargsArgs) => watch(argv),\n};\n"]}

package/dist/cmds/watch/watchHandler.d.ts

@@ -0,0 +1,14 @@
+import { YargsArgs } from '../../types/yargs';
+/**
+ * Watch a directory and its subdirectories for changes, and build when files
+ * are added or changed.
+ *
+ * Ignores 'node_modules' and dotfiles.
+ * Creates destination directory if it doesn't exist.
+ *
+ * @param argv - Arguments as an object generated by 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 watch(argv: YargsArgs): Promise<void>;

package/dist/cmds/watch/watchHandler.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watch = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const chokidar_1 = __importDefault(require("chokidar"));
+const utils_1 = require("../../utils");
+const bundle_1 = require("../build/bundle");
+const evalHandler_1 = require("../eval/evalHandler");
+const manifestHandler_1 = require("../manifest/manifestHandler");
+const serveHandler_1 = require("../serve/serveHandler");
+/**
+ * Watch a directory and its subdirectories for changes, and build when files
+ * are added or changed.
+ *
+ * Ignores 'node_modules' and dotfiles.
+ * Creates destination directory if it doesn't exist.
+ *
+ * @param argv - Arguments as an object generated by Yargs.
+ * @param argv.src - The source file path.
+ * @param argv.dist - The output directory path.
+ * @param argv.'outfileName' - The output file name.
+ */
+async function watch(argv) {
+    const { dist, eval: shouldEval, manifest, outfileName, src, serve: shouldServe, } = 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 rootDir = src.includes('/')
+        ? src.substring(0, src.lastIndexOf('/') + 1)
+        : '.';
+    const outfilePath = (0, snaps_utils_1.getOutfilePath)(dist, outfileName);
+    const buildSnap = async (path, logMessage) => {
+        if (logMessage !== undefined) {
+            (0, snaps_utils_1.logInfo)(logMessage);
+        }
+        try {
+            await (0, bundle_1.bundle)(src, outfilePath, argv, (0, utils_1.loadConfig)().bundlerCustomizer);
+            if (manifest) {
+                await (0, manifestHandler_1.manifestHandler)(argv);
+            }
+            if (shouldEval) {
+                await (0, evalHandler_1.evalHandler)({ ...argv, bundle: outfilePath });
+            }
+        }
+        catch (error) {
+            (0, snaps_utils_1.logError)(`Error ${path === undefined
+                ? 'during initial build'
+                : `while processing "${path}"`}.`, error);
+        }
+    };
+    chokidar_1.default
+        .watch(rootDir, {
+        ignoreInitial: true,
+        ignored: [
+            '**/node_modules/**',
+            `**/${dist}/**`,
+            `**/test/**`,
+            `**/tests/**`,
+            `**/*.test.js`,
+            `**/*.test.ts`,
+            /* istanbul ignore next */
+            (str) => str !== '.' && str.startsWith('.'),
+        ],
+    })
+        .on('ready', () => {
+        buildSnap()
+            .then(() => {
+            if (shouldServe) {
+                return (0, serveHandler_1.serve)(argv);
+            }
+            return undefined;
+        })
+            .catch((error) => {
+            (0, snaps_utils_1.logError)('Error during initial build.', error);
+        });
+    })
+        .on('add', (path) => {
+        buildSnap(path, `File added: ${path}`).catch((error) => {
+            (0, snaps_utils_1.logError)(`Error while processing "${path}".`, error);
+        });
+    })
+        .on('change', (path) => {
+        buildSnap(path, `File changed: ${path}`).catch((error) => {
+            (0, snaps_utils_1.logError)(`Error while processing "${path}".`, error);
+        });
+    })
+        .on('unlink', (path) => (0, snaps_utils_1.logInfo)(`File removed: ${path}`))
+        .on('error', (error) => {
+        (0, snaps_utils_1.logError)(`Watcher error: ${error.message}`, error);
+    })
+        .add(rootDir);
+    (0, snaps_utils_1.logInfo)(`Watching '${rootDir}' for changes...`);
+}
+exports.watch = watch;
+//# sourceMappingURL=watchHandler.js.map

package/dist/cmds/watch/watchHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchHandler.js","sourceRoot":"","sources":["../../../src/cmds/watch/watchHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getOutfilePath,\n  logError,\n  logInfo,\n  validateDirPath,\n  validateFilePath,\n  validateOutfileName,\n} from '@metamask/snaps-utils';\nimport chokidar from 'chokidar';\n\nimport { YargsArgs } from '../../types/yargs';\nimport { loadConfig } from '../../utils';\nimport { bundle } from '../build/bundle';\nimport { evalHandler } from '../eval/evalHandler';\nimport { manifestHandler } from '../manifest/manifestHandler';\nimport { serve } from '../serve/serveHandler';\n\n/**\n * Watch a directory and its subdirectories for changes, and build when files\n * are added or changed.\n *\n * Ignores 'node_modules' and dotfiles.\n * Creates destination directory if it doesn't exist.\n *\n * @param argv - Arguments as an object generated by 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 watch(argv: YargsArgs): Promise<void> {\n  const {\n    dist,\n    eval: shouldEval,\n    manifest,\n    outfileName,\n    src,\n    serve: shouldServe,\n  } = argv;\n  if (outfileName) {\n    validateOutfileName(outfileName);\n  }\n  await validateFilePath(src);\n  await validateDirPath(dist, true);\n  const rootDir = src.includes('/')\n    ? src.substring(0, src.lastIndexOf('/') + 1)\n    : '.';\n  const outfilePath = getOutfilePath(dist, outfileName);\n\n  const buildSnap = async (path?: string, logMessage?: string) => {\n    if (logMessage !== undefined) {\n      logInfo(logMessage);\n    }\n\n    try {\n      await bundle(src, outfilePath, argv, loadConfig().bundlerCustomizer);\n\n      if (manifest) {\n        await manifestHandler(argv);\n      }\n\n      if (shouldEval) {\n        await evalHandler({ ...argv, bundle: outfilePath });\n      }\n    } catch (error) {\n      logError(\n        `Error ${\n          path === undefined\n            ? 'during initial build'\n            : `while processing \"${path}\"`\n        }.`,\n        error,\n      );\n    }\n  };\n\n  chokidar\n    .watch(rootDir, {\n      ignoreInitial: true,\n      ignored: [\n        '**/node_modules/**',\n        `**/${dist}/**`,\n        `**/test/**`,\n        `**/tests/**`,\n        `**/*.test.js`,\n        `**/*.test.ts`,\n        /* istanbul ignore next */\n        (str: string) => str !== '.' && str.startsWith('.'),\n      ],\n    })\n\n    .on('ready', () => {\n      buildSnap()\n        .then(() => {\n          if (shouldServe) {\n            return serve(argv);\n          }\n\n          return undefined;\n        })\n        .catch((error) => {\n          logError('Error during initial build.', error);\n        });\n    })\n    .on('add', (path) => {\n      buildSnap(path, `File added: ${path}`).catch((error) => {\n        logError(`Error while processing \"${path}\".`, error);\n      });\n    })\n    .on('change', (path) => {\n      buildSnap(path, `File changed: ${path}`).catch((error) => {\n        logError(`Error while processing \"${path}\".`, error);\n      });\n    })\n    .on('unlink', (path) => logInfo(`File removed: ${path}`))\n    .on('error', (error: Error) => {\n      logError(`Watcher error: ${error.message}`, error);\n    })\n\n    .add(rootDir);\n\n  logInfo(`Watching '${rootDir}' for changes...`);\n}\n"]}

package/dist/main.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+const cmds_1 = __importDefault(require("./cmds"));
+global.snaps = {
+    verboseErrors: false,
+    suppressWarnings: false,
+    isWatching: false,
+};
+(0, cli_1.cli)(process.argv, cmds_1.default);
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;;;;AAEA,+BAA4B;AAC5B,kDAA8B;AAE9B,MAAM,CAAC,KAAK,GAAG;IACb,aAAa,EAAE,KAAK;IACpB,gBAAgB,EAAE,KAAK;IACvB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,IAAA,SAAG,EAAC,OAAO,CAAC,IAAI,EAAE,cAAQ,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\n\nimport { cli } from './cli';\nimport commands from './cmds';\n\nglobal.snaps = {\n  verboseErrors: false,\n  suppressWarnings: false,\n  isWatching: false,\n};\n\ncli(process.argv, commands);\n"]}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './misc';
+export * from './snap-config';

package/dist/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./misc"), exports);
+__exportStar(require("./snap-config"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,gDAA8B","sourcesContent":["export * from './misc';\nexport * from './snap-config';\n"]}

package/dist/utils/misc.d.ts

@@ -0,0 +1,53 @@
+import { Arguments } from 'yargs';
+export declare const permRequestKeys: string[];
+export declare const CONFIG_FILE = "snap.config.js";
+/**
+ * Sets global variable snaps which tracks user settings:
+ * watch mode activation, verbose errors messages, and whether to suppress
+ * warnings.
+ *
+ * @param argv - Arguments as an object generated by `yargs`.
+ */
+export declare function setSnapGlobals(argv: Arguments): void;
+/**
+ * Attempts to convert a string to a boolean and throws if the value is invalid.
+ *
+ * @param value - The value to convert to a boolean.
+ * @returns `true` if the value is the string `"true"`, `false` if it is the
+ * string `"false"`, the value if it is already a boolean, or an error
+ * otherwise.
+ */
+export declare function booleanStringToBoolean(value: unknown): boolean;
+/**
+ * Sanitizes inputs. Currently normalizes "./" paths to ".".
+ * Yargs handles other path normalization as specified in builders.
+ *
+ * @param argv - Arguments as an object generated by yargs.
+ */
+export declare function sanitizeInputs(argv: Arguments): void;
+/**
+ * Logs an error message to console. Logs original error if it exists and
+ * the verboseErrors global is true.
+ *
+ * @param message - The error message.
+ * @param error - The original error.
+ */
+export declare function logError(message: string | null, error?: Error): void;
+/**
+ * Logs an error, attempts to unlink the destination file, and kills the
+ * process.
+ *
+ * @param prefix - The message prefix.
+ * @param message - The error message.
+ * @param error - The original error.
+ * @param destFilePath - The output file path.
+ */
+export declare function writeError(prefix: string, message: string, error: Error, destFilePath?: string): Promise<void>;
+/**
+ * Trims leading and trailing periods "." and forward slashes "/" from the
+ * given path string.
+ *
+ * @param pathString - The path string to trim.
+ * @returns The trimmed path string.
+ */
+export declare function trimPathString(pathString: string): string;

package/dist/utils/misc.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimPathString = exports.writeError = exports.logError = exports.sanitizeInputs = exports.booleanStringToBoolean = exports.setSnapGlobals = exports.CONFIG_FILE = exports.permRequestKeys = void 0;
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const utils_1 = require("@metamask/utils");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+exports.permRequestKeys = [
+    '@context',
+    'id',
+    'parentCapability',
+    'invoker',
+    'date',
+    'caveats',
+    'proof',
+];
+exports.CONFIG_FILE = 'snap.config.js';
+// CLI arguments whose values are file paths
+const pathArguments = new Set([
+    'src',
+    's',
+    'dist',
+    'd',
+    'bundle',
+    'b',
+    'root',
+    'r',
+]);
+/**
+ * Sets global variable snaps which tracks user settings:
+ * watch mode activation, verbose errors messages, and whether to suppress
+ * warnings.
+ *
+ * @param argv - Arguments as an object generated by `yargs`.
+ */
+function setSnapGlobals(argv) {
+    if (['w', 'watch'].includes(argv._[0])) {
+        global.snaps.isWatching = true;
+    }
+    else {
+        global.snaps.isWatching = false;
+    }
+    if ((0, utils_1.hasProperty)(argv, 'verboseErrors')) {
+        global.snaps.verboseErrors = booleanStringToBoolean(argv.verboseErrors);
+    }
+    if ((0, utils_1.hasProperty)(argv, 'suppressWarnings')) {
+        global.snaps.suppressWarnings = booleanStringToBoolean(argv.suppressWarnings);
+    }
+}
+exports.setSnapGlobals = setSnapGlobals;
+/**
+ * Attempts to convert a string to a boolean and throws if the value is invalid.
+ *
+ * @param value - The value to convert to a boolean.
+ * @returns `true` if the value is the string `"true"`, `false` if it is the
+ * string `"false"`, the value if it is already a boolean, or an error
+ * otherwise.
+ */
+function booleanStringToBoolean(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    else if (value === 'true') {
+        return true;
+    }
+    else if (value === 'false') {
+        return false;
+    }
+    throw new Error(`Expected a boolean or the strings "true" or "false". Received: "${String(value)}"`);
+}
+exports.booleanStringToBoolean = booleanStringToBoolean;
+/**
+ * Sanitizes inputs. Currently normalizes "./" paths to ".".
+ * Yargs handles other path normalization as specified in builders.
+ *
+ * @param argv - Arguments as an object generated by yargs.
+ */
+function sanitizeInputs(argv) {
+    Object.keys(argv).forEach((key) => {
+        if (typeof argv[key] === 'string') {
+            // Node's path.normalize() does not do this
+            if (argv[key] === './') {
+                argv[key] = '.';
+            }
+            if (pathArguments.has(key)) {
+                argv[key] = path_1.default.normalize(argv[key]);
+            }
+        }
+    });
+}
+exports.sanitizeInputs = sanitizeInputs;
+/**
+ * Logs an error message to console. Logs original error if it exists and
+ * the verboseErrors global is true.
+ *
+ * @param message - The error message.
+ * @param error - The original error.
+ */
+function logError(message, error) {
+    if (message !== null) {
+        (0, snaps_utils_1.logError)(message);
+    }
+    if (error && global.snaps.verboseErrors) {
+        (0, snaps_utils_1.logError)(error);
+    }
+    if (message === null && (!error || (error && !global.snaps.verboseErrors))) {
+        (0, snaps_utils_1.logError)('Unknown error.');
+    }
+}
+exports.logError = logError;
+/**
+ * Logs an error, attempts to unlink the destination file, and kills the
+ * process.
+ *
+ * @param prefix - The message prefix.
+ * @param message - The error message.
+ * @param error - The original error.
+ * @param destFilePath - The output file path.
+ */
+async function writeError(prefix, message, error, destFilePath) {
+    let processedPrefix = prefix;
+    if (!prefix.endsWith(' ')) {
+        processedPrefix += ' ';
+    }
+    logError(processedPrefix + message, error);
+    try {
+        if (destFilePath) {
+            await fs_1.promises.unlink(destFilePath);
+        }
+    }
+    catch (unlinkError) {
+        logError(`${processedPrefix}Failed to unlink mangled file.`, unlinkError);
+    }
+    // unless the watcher is active, exit
+    if (!global.snaps.isWatching) {
+        // TODO(ritave): Remove process exit and change into collapse of functions
+        //               https://github.com/MetaMask/snaps-monorepo/issues/81
+        process.exit(1);
+    }
+}
+exports.writeError = writeError;
+/**
+ * Trims leading and trailing periods "." and forward slashes "/" from the
+ * given path string.
+ *
+ * @param pathString - The path string to trim.
+ * @returns The trimmed path string.
+ */
+function trimPathString(pathString) {
+    return pathString.replace(/^[./]+|[./]+$/gu, '');
+}
+exports.trimPathString = trimPathString;
+//# sourceMappingURL=misc.js.map

package/dist/utils/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"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","sourcesContent":["import { logError as logErrorUtil } from '@metamask/snaps-utils';\nimport { hasProperty } from '@metamask/utils';\nimport { promises as filesystem } from 'fs';\nimport path from 'path';\nimport { Arguments } from 'yargs';\n\nexport const permRequestKeys = [\n  '@context',\n  'id',\n  'parentCapability',\n  'invoker',\n  'date',\n  'caveats',\n  'proof',\n];\n\nexport const CONFIG_FILE = 'snap.config.js';\n\n// CLI arguments whose values are file paths\nconst pathArguments = new Set([\n  'src',\n  's',\n  'dist',\n  'd',\n  'bundle',\n  'b',\n  'root',\n  'r',\n]);\n\n/**\n * Sets global variable snaps which tracks user settings:\n * watch mode activation, verbose errors messages, and whether to suppress\n * warnings.\n *\n * @param argv - Arguments as an object generated by `yargs`.\n */\nexport function setSnapGlobals(argv: Arguments) {\n  if (['w', 'watch'].includes(argv._[0] as string)) {\n    global.snaps.isWatching = true;\n  } else {\n    global.snaps.isWatching = false;\n  }\n\n  if (hasProperty(argv, 'verboseErrors')) {\n    global.snaps.verboseErrors = booleanStringToBoolean(argv.verboseErrors);\n  }\n\n  if (hasProperty(argv, 'suppressWarnings')) {\n    global.snaps.suppressWarnings = booleanStringToBoolean(\n      argv.suppressWarnings,\n    );\n  }\n}\n\n/**\n * Attempts to convert a string to a boolean and throws if the value is invalid.\n *\n * @param value - The value to convert to a boolean.\n * @returns `true` if the value is the string `\"true\"`, `false` if it is the\n * string `\"false\"`, the value if it is already a boolean, or an error\n * otherwise.\n */\nexport function booleanStringToBoolean(value: unknown): boolean {\n  if (typeof value === 'boolean') {\n    return value;\n  } else if (value === 'true') {\n    return true;\n  } else if (value === 'false') {\n    return false;\n  }\n\n  throw new Error(\n    `Expected a boolean or the strings \"true\" or \"false\". Received: \"${String(\n      value,\n    )}\"`,\n  );\n}\n\n/**\n * Sanitizes inputs. Currently normalizes \"./\" paths to \".\".\n * Yargs handles other path normalization as specified in builders.\n *\n * @param argv - Arguments as an object generated by yargs.\n */\nexport function sanitizeInputs(argv: Arguments) {\n  Object.keys(argv).forEach((key) => {\n    if (typeof argv[key] === 'string') {\n      // Node's path.normalize() does not do this\n      if (argv[key] === './') {\n        argv[key] = '.';\n      }\n\n      if (pathArguments.has(key)) {\n        argv[key] = path.normalize(argv[key] as string);\n      }\n    }\n  });\n}\n\n/**\n * Logs an error message to console. Logs original error if it exists and\n * the verboseErrors global is true.\n *\n * @param message - The error message.\n * @param error - The original error.\n */\nexport function logError(message: string | null, error?: Error): void {\n  if (message !== null) {\n    logErrorUtil(message);\n  }\n\n  if (error && global.snaps.verboseErrors) {\n    logErrorUtil(error);\n  }\n\n  if (message === null && (!error || (error && !global.snaps.verboseErrors))) {\n    logErrorUtil('Unknown error.');\n  }\n}\n\n/**\n * Logs an error, attempts to unlink the destination file, and kills the\n * process.\n *\n * @param prefix - The message prefix.\n * @param message - The error message.\n * @param error - The original error.\n * @param destFilePath - The output file path.\n */\nexport async function writeError(\n  prefix: string,\n  message: string,\n  error: Error,\n  destFilePath?: string,\n): Promise<void> {\n  let processedPrefix = prefix;\n  if (!prefix.endsWith(' ')) {\n    processedPrefix += ' ';\n  }\n\n  logError(processedPrefix + message, error);\n  try {\n    if (destFilePath) {\n      await filesystem.unlink(destFilePath);\n    }\n  } catch (unlinkError) {\n    logError(`${processedPrefix}Failed to unlink mangled file.`, unlinkError);\n  }\n\n  // unless the watcher is active, exit\n  if (!global.snaps.isWatching) {\n    // TODO(ritave): Remove process exit and change into collapse of functions\n    //               https://github.com/MetaMask/snaps-monorepo/issues/81\n    process.exit(1);\n  }\n}\n\n/**\n * Trims leading and trailing periods \".\" and forward slashes \"/\" from the\n * given path string.\n *\n * @param pathString - The path string to trim.\n * @returns The trimmed path string.\n */\nexport function trimPathString(pathString: string): string {\n  return pathString.replace(/^[./]+|[./]+$/gu, '');\n}\n"]}

package/dist/utils/snap-config.d.ts

@@ -0,0 +1,48 @@
+import type browserify from 'browserify';
+import { Infer } from 'superstruct';
+import { Arguments } from 'yargs';
+import yargs from 'yargs/yargs';
+export declare type BundleCustomizer = (bundler: browserify.BrowserifyObject) => void;
+export declare const SnapConfigStruct: import("superstruct").Struct<{
+    cliOptions?: Record<string, unknown> | undefined;
+    bundlerCustomizer?: Function | undefined;
+}, {
+    cliOptions: import("superstruct").Struct<Record<string, unknown> | undefined, null>;
+    bundlerCustomizer: import("superstruct").Struct<Function | undefined, null>;
+}>;
+export declare type SnapConfig = Omit<Infer<typeof SnapConfigStruct>, 'bundlerCustomizer'> & {
+    bundlerCustomizer?: BundleCustomizer;
+};
+/**
+ * Check if the given value is a {@link SnapConfig} object. Note that this
+ * function does not check the validity of the `bundleCustomizer` property, as
+ * it is not possible to check the validity of a function in JavaScript.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a valid {@link SnapConfig} object, `false`
+ * otherwise.
+ */
+export declare function isSnapConfig(value: unknown): value is SnapConfig;
+/**
+ * Attempt to load the snap config file (`snap.config.js`). By default will use
+ * the cached config, if it was loaded before, and `cached` is `true`. If the
+ * config file is not found, or the config is invalid, this function will kill
+ * the process.
+ *
+ * @param cached - Whether to use the cached config. Defaults to `true`.
+ * @returns The snap config.
+ */
+export declare function loadConfig(cached?: boolean): SnapConfig;
+/**
+ * Attempts to read configuration options for package.json and the config file,
+ * and apply them to argv if they weren't already set.
+ *
+ * Arguments are only set per the snap-cli config file if they were not specified
+ * on the command line.
+ *
+ * @param snapConfig - The snap config.
+ * @param processArgv - The command line arguments, i.e., `process.argv`.
+ * @param yargsArgv - The processed `yargs` arguments.
+ * @param yargsInstance - An instance of `yargs`.
+ */
+export declare function applyConfig(snapConfig: SnapConfig, processArgv: string[], yargsArgv: Arguments, yargsInstance: typeof yargs): void;