presetter 3.1.1 → 3.4.0

package/lib/run.js

@@ -1,134 +1,66 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.run = run;
-
-var _execa = _interopRequireDefault(require("execa"));
-
-var _fsExtra = require("fs-extra");
-
-var _lodash = require("lodash");
-
-var _path = require("path");
-
-var _error = require("./error");
-
-var _package = require("./package");
-
-var _preset = require("./preset");
-
-var _scripts = require("./scripts");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
-/*
- *                            *** MIT LICENSE ***
- * -------------------------------------------------------------------------
- * This code may be modified and distributed under the MIT license.
- * See the LICENSE file for details.
- * -------------------------------------------------------------------------
- *
- * @summary   Run a task
- *
- * @author    Alvis HT Tang <alvis@hilbert.space>
- * @license   MIT
- * @copyright Copyright (c) 2019 - All Rights Reserved.
- * -------------------------------------------------------------------------
- */
-
-/** manage ~package.json */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = void 0;
+const execa_1 = __importDefault(require("execa"));
+const fs_extra_1 = require("fs-extra");
+const lodash_1 = require("lodash");
+const path_1 = require("path");
+const error_1 = require("./error");
+const package_1 = require("./package");
+const preset_1 = require("./preset");
+const scripts_1 = require("./scripts");
 class TemporaryPackageJSONManager {
-  /**
-   * create a temporary package.json manager
-   * @param packageDetail the content of the target project's package.json
-   */
-  constructor(packageDetail) {
-    this.package = void 0;
-    this.path = void 0;
-    this.shouldRestore = void 0;
-    this.path = (0, _path.resolve)((0, _path.dirname)(packageDetail.path), '~' + (0, _path.basename)(packageDetail.path));
-    this.package = packageDetail;
-    this.shouldRestore = !(0, _fsExtra.pathExistsSync)(this.path);
-  }
-  /**
-   * setup an environment for running a task with presetter
-   * @param task name of the task to be replaced by the template
-   */
-
-
-  async replace(task) {
-    // delete the current task to avoid duplicated task running
-    delete this.package.json.scripts[task]; // get the merged script definitions
-
-    const template = await (0, _preset.getScripts)(await (0, _preset.getContext)());
-    this.package.json.scripts = (0, _scripts.composeScripts)({
-      template,
-      target: { ...this.package.json.scripts
-      }
-    }); // move the existing package.json to a safe place
-
-    if (this.shouldRestore) {
-      await (0, _error.wrap)((0, _fsExtra.move)(this.package.path, this.path), `failed to backup package.json`);
-    } // generate a temporary package.json in order to let npm to see all the definitions
-
-
-    const PADDING = 2;
-    const content = JSON.stringify(this.package.json, null, PADDING);
-    await (0, _error.wrap)((0, _fsExtra.writeFile)(this.package.path, content), 'failed to write to package.json');
-  }
-  /**
-   * clean up the temporary artifacts
-   */
-
-
-  async restore() {
-    if (this.shouldRestore) {
-      await (0, _error.wrap)((0, _fsExtra.unlink)(this.package.path).then(async () => (0, _fsExtra.move)(this.path, this.package.path)), `failed to restore package.json`);
+    constructor(packageDetail) {
+        this.path = (0, path_1.resolve)((0, path_1.dirname)(packageDetail.path), '~' + (0, path_1.basename)(packageDetail.path));
+        this.package = packageDetail;
+        this.shouldRestore = !(0, fs_extra_1.pathExistsSync)(this.path);
+    }
+    async replace(task) {
+        delete this.package.json.scripts[task];
+        const template = await (0, preset_1.getScripts)();
+        this.package.json.scripts = (0, scripts_1.composeScripts)({
+            template,
+            target: Object.assign({}, this.package.json.scripts),
+        });
+        if (this.shouldRestore) {
+            await (0, error_1.wrap)((0, fs_extra_1.move)(this.package.path, this.path), `failed to backup package.json`);
+        }
+        const PADDING = 2;
+        const content = JSON.stringify(this.package.json, null, PADDING);
+        await (0, error_1.wrap)((0, fs_extra_1.writeFile)(this.package.path, content), 'failed to write to package.json');
+    }
+    async restore() {
+        if (this.shouldRestore) {
+            await (0, error_1.wrap)((0, fs_extra_1.unlink)(this.package.path).then(async () => (0, fs_extra_1.move)(this.path, this.package.path)), `failed to restore package.json`);
+        }
     }
-  }
-
 }
-/**
- * run a task defined in the combined script definitions
- * @param task the name of the task to be run
- * @param argv parameters supplied for the task
- */
-
-
 async function run(task, argv = []) {
-  // try to find the target project's package.json
-  const packageDetail = await (0, _package.getPackage)();
-  const manager = new TemporaryPackageJSONManager(packageDetail); // setup
-
-  await manager.replace(task);
-  const restore = (0, _lodash.once)(async isInterrupted => {
-    // stop listening to SIGINT in order to avoid double handling during the restoration process
-    process.removeListener('SIGINT', restore); // restore package.json
-
-    await manager.restore();
-
-    if (isInterrupted) {
-      const SIGINT = 130;
-      process.exit(SIGINT);
+    const packageDetail = await (0, package_1.getPackage)();
+    const manager = new TemporaryPackageJSONManager(packageDetail);
+    await manager.replace(task);
+    const restore = (0, lodash_1.once)(async (isInterrupted) => {
+        process.removeListener('SIGINT', restore);
+        await manager.restore();
+        if (isInterrupted) {
+            const SIGINT = 130;
+            process.exit(SIGINT);
+        }
+    });
+    process.on('SIGINT', restore.bind(run, true));
+    const { exitCode } = await (0, execa_1.default)('npm', ['run', task, '--', ...argv], {
+        cwd: (0, path_1.dirname)(packageDetail.path),
+        stdio: 'inherit',
+        reject: false,
+        shell: true,
+    });
+    await restore(false);
+    if (exitCode > 0) {
+        process.exit(exitCode);
     }
-  });
-  process.on('SIGINT', restore.bind(run, true)); // run the task
-
-  const {
-    exitCode
-  } = await (0, _execa.default)('npm', ['run', task, '--', ...argv], {
-    cwd: (0, _path.dirname)(packageDetail.path),
-    stdio: 'inherit',
-    reject: false,
-    shell: true
-  }); // restore package.json
-
-  await restore(false); // set the exit code as the same as the returned
-
-  if (exitCode > 0) {
-    process.exit(exitCode);
-  }
 }
-//# sourceMappingURL=run.js.map
+exports.run = run;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVuLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL3J1bi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFlQSxrREFBMEI7QUFDMUIsdUNBQW1FO0FBQ25FLG1DQUE4QjtBQUM5QiwrQkFBa0Q7QUFFbEQsbUNBQStCO0FBQy9CLHVDQUF1QztBQUN2QyxxQ0FBc0M7QUFDdEMsdUNBQTJDO0FBSzNDLE1BQU0sMkJBQTJCO0lBVS9CLFlBQVksYUFBc0I7UUFDaEMsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFBLGNBQU8sRUFDakIsSUFBQSxjQUFPLEVBQUMsYUFBYSxDQUFDLElBQUksQ0FBQyxFQUMzQixHQUFHLEdBQUcsSUFBQSxlQUFRLEVBQUMsYUFBYSxDQUFDLElBQUksQ0FBQyxDQUNuQyxDQUFDO1FBRUYsSUFBSSxDQUFDLE9BQU8sR0FBRyxhQUFhLENBQUM7UUFDN0IsSUFBSSxDQUFDLGFBQWEsR0FBRyxDQUFDLElBQUEseUJBQWMsRUFBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQU1NLEtBQUssQ0FBQyxPQUFPLENBQUMsSUFBWTtRQUUvQixPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUd2QyxNQUFNLFFBQVEsR0FBRyxNQUFNLElBQUEsbUJBQVUsR0FBRSxDQUFDO1FBQ3BDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFBLHdCQUFjLEVBQUM7WUFDekMsUUFBUTtZQUNSLE1BQU0sb0JBQ0QsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUM3QjtTQUNGLENBQUMsQ0FBQztRQUdILElBQUksSUFBSSxDQUFDLGFBQWEsRUFBRTtZQUN0QixNQUFNLElBQUEsWUFBSSxFQUNSLElBQUEsZUFBSSxFQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJLENBQUMsRUFDbEMsK0JBQStCLENBQ2hDLENBQUM7U0FDSDtRQUdELE1BQU0sT0FBTyxHQUFHLENBQUMsQ0FBQztRQUNsQixNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUNqRSxNQUFNLElBQUEsWUFBSSxFQUNSLElBQUEsb0JBQVMsRUFBQyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxPQUFPLENBQUMsRUFDckMsaUNBQWlDLENBQ2xDLENBQUM7SUFDSixDQUFDO0lBS00sS0FBSyxDQUFDLE9BQU87UUFDbEIsSUFBSSxJQUFJLENBQUMsYUFBYSxFQUFFO1lBQ3RCLE1BQU0sSUFBQSxZQUFJLEVBQ1IsSUFBQSxpQkFBTSxFQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLEtBQUssSUFBSSxFQUFFLENBQ3hDLElBQUEsZUFBSSxFQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FDbkMsRUFDRCxnQ0FBZ0MsQ0FDakMsQ0FBQztTQUNIO0lBQ0gsQ0FBQztDQUNGO0FBT00sS0FBSyxVQUFVLEdBQUcsQ0FBQyxJQUFZLEVBQUUsT0FBaUIsRUFBRTtJQUV6RCxNQUFNLGFBQWEsR0FBRyxNQUFNLElBQUEsb0JBQVUsR0FBRSxDQUFDO0lBQ3pDLE1BQU0sT0FBTyxHQUFHLElBQUksMkJBQTJCLENBQUMsYUFBYSxDQUFDLENBQUM7SUFHL0QsTUFBTSxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzVCLE1BQU0sT0FBTyxHQUFHLElBQUEsYUFBSSxFQUFDLEtBQUssRUFBRSxhQUFzQixFQUFpQixFQUFFO1FBRW5FLE9BQU8sQ0FBQyxjQUFjLENBQUMsUUFBUSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBRzFDLE1BQU0sT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBRXhCLElBQUksYUFBYSxFQUFFO1lBQ2pCLE1BQU0sTUFBTSxHQUFHLEdBQUcsQ0FBQztZQUNuQixPQUFPLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1NBQ3RCO0lBQ0gsQ0FBQyxDQUFDLENBQUM7SUFDSCxPQUFPLENBQUMsRUFBRSxDQUFDLFFBQVEsRUFBRSxPQUFPLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFDO0lBRzlDLE1BQU0sRUFBRSxRQUFRLEVBQUUsR0FBRyxNQUFNLElBQUEsZUFBSyxFQUFDLEtBQUssRUFBRSxDQUFDLEtBQUssRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEdBQUcsSUFBSSxDQUFDLEVBQUU7UUFDcEUsR0FBRyxFQUFFLElBQUEsY0FBTyxFQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUM7UUFDaEMsS0FBSyxFQUFFLFNBQVM7UUFDaEIsTUFBTSxFQUFFLEtBQUs7UUFDYixLQUFLLEVBQUUsSUFBSTtLQUNaLENBQUMsQ0FBQztJQUdILE1BQU0sT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBR3JCLElBQUksUUFBUSxHQUFHLENBQUMsRUFBRTtRQUNoQixPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0tBQ3hCO0FBQ0gsQ0FBQztBQXBDRCxrQkFvQ0MifQ==

package/lib/scripts.js

@@ -1,138 +1,62 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.composeScripts = composeScripts;
-
-var _lodash = require("lodash");
-
-var _mvdanSh = require("mvdan-sh");
-
-var _path = require("path");
-
-/*
- *                            *** MIT LICENSE ***
- * -------------------------------------------------------------------------
- * This code may be modified and distributed under the MIT license.
- * See the LICENSE file for details.
- * -------------------------------------------------------------------------
- *
- * @summary   Handle script merging
- *
- * @author    Alvis HT Tang <alvis@hilbert.space>
- * @license   MIT
- * @copyright Copyright (c) 2019 - All Rights Reserved.
- * -------------------------------------------------------------------------
- */
-// shell command parser
-const parser = _mvdanSh.syntax.NewParser(); // shell command generator
-
-
-const printer = _mvdanSh.syntax.NewPrinter();
-/** resource context to be passed for processing */
-
-
-/**
- * merge the script definitions from the template and the target package.json
- * @param args template and customised scripts to be merged
- * @param args.template scripts defined from the template
- * @param args.target scripts defined from target's package.json
- * @returns a dictionary of merged definitions
- */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeScripts = void 0;
+const lodash_1 = require("lodash");
+const mvdan_sh_1 = require("mvdan-sh");
+const path_1 = require("path");
+const parser = mvdan_sh_1.syntax.NewParser();
+const printer = mvdan_sh_1.syntax.NewPrinter();
 function composeScripts(args) {
-  const {
-    template,
-    target
-  } = args;
-  return (0, _lodash.mapValues)({ ...template,
-    ...target
-  }, command => {
-    try {
-      // parse the shell command into its ast
-      const ast = parser.Parse(command); // walk through the tree and replace any call to the runner e.g. preset task1 task2 -- --help
-
-      _mvdanSh.syntax.Walk(ast, node => replaceRunnerNode(node, {
-        template,
-        target
-      })); // remove any unnecessary subshell
-
-
-      const [statement] = ast.Stmts;
-
-      if (isNodeType(statement.Cmd, 'Subshell')) {
-        statement.Cmd = statement.Cmd.Stmts[0].Cmd;
-      } // generate the code from ast
-
-
-      return printer.Print(ast).trim();
-    } catch (error) {
-      if (error instanceof Error) {
-        throw error;
-      } else {
-        // parser.Parse may throw an empty object as an error, catch here
-        throw new Error(`failed to parse command: ${command}`);
-      }
-    }
-  });
+    const { template, target } = args;
+    return (0, lodash_1.mapValues)(Object.assign(Object.assign({}, template), target), (command) => {
+        try {
+            const ast = parser.Parse(command);
+            mvdan_sh_1.syntax.Walk(ast, (node) => replaceRunnerNode(node, { template, target }));
+            const [statement] = ast.Stmts;
+            if (isNodeType(statement.Cmd, 'Subshell')) {
+                statement.Cmd = statement.Cmd.Stmts[0].Cmd;
+            }
+            return printer.Print(ast).trim();
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            else {
+                throw new Error(`failed to parse command: ${command}`);
+            }
+        }
+    });
 }
-/**
- * typeguard helper for different node type
- * @param node a node to be tested
- * @param type node type
- * @returns true if the node is the specified type
- */
-
-
+exports.composeScripts = composeScripts;
 function isNodeType(node, type) {
-  return _mvdanSh.syntax.NodeType(node) === type;
+    return mvdan_sh_1.syntax.NodeType(node) === type;
 }
-/**
- * resolve a runner command
- * @param command the command to be replaced
- * @param context resource context
- * @returns the resolved command
- */
-
-
 function resolveRunner(command, context) {
-  const parts = command.split(' '); // extract tasks and their arguments
-
-  const destinations = parts.slice(1).filter(task => !task.startsWith('-'));
-  const destinationArgs = parts.filter(part => part !== '--' && part.startsWith('-')); // resolve tasks into its full form e.g. task1 task2
-
-  return destinations.map(destination => {
-    const expandedCommand = context.template[destination] || (context.target[destination] === command ? undefined : context.target[destination]);
-
-    if (expandedCommand === undefined) {
-      throw new Error(`"${destination}" cannot be resolved in "${command}"`);
-    }
-
-    return [expandedCommand, ...destinationArgs].join(' ');
-  }).join(' && ');
+    const parts = command.split(' ');
+    const destinations = parts.slice(1).filter((task) => !task.startsWith('-'));
+    const destinationArgs = parts.filter((part) => part !== '--' && part.startsWith('-'));
+    return destinations
+        .map((destination) => {
+        const expandedCommand = context.template[destination] ||
+            (context.target[destination] === command
+                ? undefined
+                : context.target[destination]);
+        if (expandedCommand === undefined) {
+            throw new Error(`"${destination}" cannot be resolved in "${command}"`);
+        }
+        return [expandedCommand, ...destinationArgs].join(' ');
+    })
+        .join(' && ');
 }
-/**
- * replace a runner node with the actual command
- * @param node an expression node
- * @param context resource context
- * @returns boolean true for no error
- */
-
-
 function replaceRunnerNode(node, context) {
-  // replace only it's a runner call, not anything else
-  if (isNodeType(node, 'Stmt') && isNodeType(node.Cmd, 'CallExpr')) {
-    // parse assigned arguments e.g. task1 args --help
-    const parts = node.Cmd.Args.map(part => part.Parts[0].Value); // only resolve if the `run` cli shipped in this package is invoke
-
-    if ((0, _path.basename)(parts[0]) === 'run') {
-      // resolve tasks into its full form e.g. task1 task2
-      const resolvedCommand = resolveRunner(parts.join(' '), context); // replace the task definition with its expanded statement
-
-      node.Cmd = parser.Parse(`(${resolvedCommand})`).Stmts[0].Cmd;
+    if (isNodeType(node, 'Stmt') && isNodeType(node.Cmd, 'CallExpr')) {
+        const parts = node.Cmd.Args.map((part) => part.Parts[0].Value);
+        if ((0, path_1.basename)(parts[0]) === 'run') {
+            const resolvedCommand = resolveRunner(parts.join(' '), context);
+            node.Cmd = parser.Parse(`(${resolvedCommand})`).Stmts[0].Cmd;
+        }
     }
-  }
-
-  return true;
+    return true;
 }
-//# sourceMappingURL=scripts.js.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NyaXB0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NvdXJjZS9zY3JpcHRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWVBLG1DQUFtQztBQUNuQyx1Q0FBa0M7QUFDbEMsK0JBQWdDO0FBY2hDLE1BQU0sTUFBTSxHQUFHLGlCQUFNLENBQUMsU0FBUyxFQUFFLENBQUM7QUFHbEMsTUFBTSxPQUFPLEdBQUcsaUJBQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztBQWlCcEMsU0FBZ0IsY0FBYyxDQUFDLElBSzlCO0lBQ0MsTUFBTSxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUM7SUFFbEMsT0FBTyxJQUFBLGtCQUFTLGtDQUFNLFFBQVEsR0FBSyxNQUFNLEdBQUksQ0FBQyxPQUFPLEVBQVUsRUFBRTtRQUMvRCxJQUFJO1lBRUYsTUFBTSxHQUFHLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUdsQyxpQkFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLGlCQUFpQixDQUFDLElBQUksRUFBRSxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUM7WUFHMUUsTUFBTSxDQUFDLFNBQVMsQ0FBQyxHQUFHLEdBQUcsQ0FBQyxLQUFLLENBQUM7WUFDOUIsSUFBSSxVQUFVLENBQUMsU0FBUyxDQUFDLEdBQUcsRUFBRSxVQUFVLENBQUMsRUFBRTtnQkFDekMsU0FBUyxDQUFDLEdBQUcsR0FBRyxTQUFTLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUM7YUFDNUM7WUFHRCxPQUFPLE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUM7U0FDbEM7UUFBQyxPQUFPLEtBQWMsRUFBRTtZQUN2QixJQUFJLEtBQUssWUFBWSxLQUFLLEVBQUU7Z0JBQzFCLE1B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

package/lib/template.d.ts

@@ -1,8 +1,11 @@
 import type { IgnoreRule } from './types';
+export declare type MergeMode = 'addition' | 'overwrite';
 export declare function filter<C extends Record<string, unknown>>(subject: C, ...ignores: IgnoreRule[]): C;
 export declare function filter(subject: unknown[], ...ignores: IgnoreRule[]): unknown[];
 export declare function isJSON(subject: unknown): subject is Record<string, any>;
-export declare function merge<Source extends Record<string, any> | unknown[]>(source: Source, replacement?: Record<string, any> | unknown[]): Source;
+export declare function merge<S extends string | Record<string, any> | unknown[]>(source: S, replacement?: string | Record<string, any> | unknown[], options?: {
+    mode?: MergeMode;
+}): S;
 export declare function template(content: string, parameter: Record<string, string>): string;
 export declare function template<Content extends Record<string, unknown> | unknown[]>(content: Content, parameter: Record<string, string>): Content;
 export declare function template(content: unknown, parameter: Record<string, string>): unknown;