presetter 3.1.0 → 3.3.0

package/README.md

@@ -4,14 +4,14 @@
 
 🏄🏻 _Setup build settings from a template, quick and right!_
 
-•   [Quick Start](#quick-start)   •   [Usage](#usage)   •   [Customisation](#customisation)   •
+•   [Quick Start](#quick-start)   •   [Usage](#usage)   •   [Customization](#customization)   •
 
 [![npm](https://img.shields.io/npm/v/presetter?style=flat-square)](https://github.com/alvis/presetter/releases)
 [![build](https://img.shields.io/github/workflow/status/alvis/presetter/code%20test?style=flat-square)](https://github.com/alvis/presetter/actions)
 [![maintainability](https://img.shields.io/codeclimate/maintainability/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/maintainability)
 [![coverage](https://img.shields.io/codeclimate/coverage/alvis/presetter?style=flat-square)](https://codeclimate.com/github/alvis/presetter/test_coverage)
 [![security](https://img.shields.io/snyk/vulnerabilities/github/alvis/presetter/packages/presetter/package.json.svg?style=flat-square)](https://snyk.io/test/github/alvis/presetter?targetFile=packages/presetter/package.json&style=flat-square)
-[![dependencies](https://img.shields.io/david/alvis/presetter?path=packages/presetter&style=flat-square)](https://david-dm.org/alvis/presetter?path=packages/presetter)
+[![dependencies](https://img.shields.io/librariesio/release/npm/presetter-presetter?style=flat-square)](https://libraries.io/npm/presetter-presetter)
 [![license](https://img.shields.io/github/license/alvis/presetter.svg?style=flat-square)](https://github.com/alvis/presetter/blob/master/LICENSE)
 
 </div>
@@ -21,7 +21,7 @@ How many dev dependencies you have to install before you can kick start a projec
 
 What's more, what if you want to update configs for all projects? :man_facepalming:
 
-**Presetter is a utility for setting up building tools for your project from a template.** This means with just only two dev packages, namely this package and your favourite template preset, all essential development packages, such as typescript, eslint and jest, together with their configuration files provided by the preset, are automatically setup for you upon the project's initialisation.
+**Presetter is a utility for setting up building tools for your project from a template.** This means with just only two dev packages, namely this package and your favorite template preset, all essential development packages, such as typescript, eslint and jest, together with their configuration files provided by the preset, are automatically setup for you upon the project's initialization.
 
 ---
 
@@ -128,13 +128,13 @@ _PROTIPS_: Install `presetter` globally via `npm install -g presetter` and you c
 
 ---
 
-## Customisation
+## Customization
 
-Presetter support customisation in two ways.
+Presetter support customization in two ways.
 
-#### Preset Customisation
+#### Preset Customization
 
-If your preset support customisation, you can supply the customisation parameter via the `config` field in `.presetterrc`.
+If your preset support customization, you can supply the customization parameter via the `config` field in `.presetterrc`.
 e.g. For [presetter-preset-essentials](https://github.com/alvis/presetter/tree/master/packages/preset-essentials), you can adding an expression to `.gitignore` with the following in `.presetterrc`:
 
 ```json

package/lib/content.d.ts

@@ -1,5 +1,5 @@
 import type { DynamicAsset, DynamicAssetField, PresetAsset, PresetContext, RequiredResolution, ResolvedPresetContext, Template } from './types';
-export declare function customise(template: Template, custom?: string[] | Record<string, unknown>): Template;
+export declare function customize(template: Template, custom?: string[] | Record<string, unknown>): Template;
 export declare function generateContent(assets: PresetAsset[], context: PresetContext): Promise<Record<string, Template>>;
 export declare function getConfigKey(filename: string): string;
 export declare function getVariable(assets: PresetAsset[], context: PresetContext): Record<string, string>;

package/lib/content.js

@@ -1,141 +1,70 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.customise = customise;
-exports.generateContent = generateContent;
-exports.getConfigKey = getConfigKey;
-exports.getVariable = getVariable;
-exports.resolveContext = resolveContext;
-exports.resolveDynamicMap = resolveDynamicMap;
-
-var _path = require("path");
-
-var _io = require("./io");
-
-var _template = require("./template");
-
-/*
- *                            *** MIT LICENSE ***
- * -------------------------------------------------------------------------
- * This code may be modified and distributed under the MIT license.
- * See the LICENSE file for details.
- * -------------------------------------------------------------------------
- *
- * @summary   Collection of config related helpers
- *
- * @author    Alvis HT Tang <alvis@hilbert.space>
- * @license   MIT
- * @copyright Copyright (c) 2021 - All Rights Reserved.
- * -------------------------------------------------------------------------
- */
-
-/**
- * customise the template with customisation from .presetterrc
- * @param template template configuration
- * @param custom content to be merged with the template configuration
- * @returns customised configuration
- */
-function customise(template, custom) {
-  if (typeof template === 'string' && Array.isArray(custom)) {
-    return (0, _template.merge)(template.split('\n'), custom).join('\n');
-  } else if (typeof template === 'object' && !Array.isArray(custom)) {
-    return (0, _template.merge)(template, custom);
-  } else {
-    return template;
-  }
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDynamicMap = exports.resolveContext = exports.getVariable = exports.getConfigKey = exports.generateContent = exports.customize = void 0;
+const path_1 = require("path");
+const io_1 = require("./io");
+const template_1 = require("./template");
+function customize(template, custom) {
+    if (typeof template === 'string' && Array.isArray(custom)) {
+        return (0, template_1.merge)(template.split('\n'), custom).join('\n');
+    }
+    else if (typeof template === 'object' && !Array.isArray(custom)) {
+        return (0, template_1.merge)(template, custom);
+    }
+    else {
+        return template;
+    }
 }
-/**
- * generate configuration content from preset with user customisation
- * @param assets list of preset assets
- * @param context context about the target project and any customisation in .presetterrc
- * @returns a map of configuration content
- */
-
-
+exports.customize = customize;
 async function generateContent(assets, context) {
-  const resolvedContext = await resolveContext(assets, context);
-  const resolvedTemplate = await resolveDynamicMap(assets, resolvedContext, 'template'); // merge templates with custom configuration
-
-  const custom = Object.fromEntries(await Promise.all(Object.entries(resolvedTemplate).map(async ([relativePath, templateConfig]) => {
-    const customConfig = resolvedContext.custom.config[getConfigKey(relativePath)];
-    return [relativePath, customise(templateConfig, customConfig)];
-  })));
-  return (0, _template.template)(custom, resolvedContext.custom.variable);
+    const resolvedContext = await resolveContext(assets, context);
+    const resolvedTemplate = await resolveDynamicMap(assets, resolvedContext, 'template');
+    const custom = Object.fromEntries(await Promise.all(Object.entries(resolvedTemplate).map(async ([relativePath, templateConfig]) => {
+        const customConfig = resolvedContext.custom.config[getConfigKey(relativePath)];
+        return [relativePath, customize(templateConfig, customConfig)];
+    })));
+    return (0, template_1.template)(custom, resolvedContext.custom.variable);
 }
-/**
- * compute the corresponding field within the config field of .presetterrc
- * @param filename symlink name
- * @returns field name in config
- */
-
-
+exports.generateContent = generateContent;
 function getConfigKey(filename) {
-  return (0, _path.basename)(filename, (0, _path.extname)(filename)).replace(/^\./, '').replace(/rc$/, '').replace(/\.config$/, '');
+    return (0, path_1.basename)(filename, (0, path_1.extname)(filename))
+        .replace(/^\./, '')
+        .replace(/rc$/, '')
+        .replace(/\.config$/, '');
 }
-/**
- * combine the default variables from presets with custom variables
- * @param assets list of preset assets
- * @param context context about the target project and any customisation in .presetterrc
- * @returns combined variables
- */
-
-
+exports.getConfigKey = getConfigKey;
 function getVariable(assets, context) {
-  const variables = assets.map(asset => asset.variable).filter(variable => !!variable);
-  const variableFromPresets = variables.reduce((merged, variable) => (0, _template.merge)(merged, variable), {});
-  const variableWithCustomConfig = (0, _template.merge)(variableFromPresets, context.custom.variable);
-  return { ...variableWithCustomConfig
-  };
+    const variables = assets
+        .map((asset) => asset.variable)
+        .filter((variable) => !!variable);
+    const variableFromPresets = variables.reduce((merged, variable) => (0, template_1.merge)(merged, variable), {});
+    const variableWithCustomConfig = (0, template_1.merge)(variableFromPresets, context.custom.variable);
+    return Object.assign({}, variableWithCustomConfig);
 }
-/**
- * resolve context values which may be dynamic
- * @param assets list of preset assets
- * @param context context about the target project and any customisation in .presetterrc
- * @returns a context with no further dynamic content
- */
-
-
+exports.getVariable = getVariable;
 async function resolveContext(assets, context) {
-  var _context$custom$noSym;
-
-  const variableContext = { ...context,
-    custom: { ...context.custom,
-      variable: getVariable(assets, context)
-    }
-  };
-  const config = (0, _template.merge)(await resolveDynamicMap(assets, variableContext, 'supplementaryConfig'), context.custom.config);
-  const customList = (_context$custom$noSym = context.custom.noSymlinks) !== null && _context$custom$noSym !== void 0 ? _context$custom$noSym : [];
-  const assetList = assets.map(async ({
-    noSymlinks
-  }) => (0, _io.loadDynamic)(noSymlinks !== null && noSymlinks !== void 0 ? noSymlinks : [], variableContext));
-  const noSymlinks = [...(await Promise.all(assetList)), ...customList].flat();
-  return { ...variableContext,
-    custom: { ...variableContext.custom,
-      config,
-      noSymlinks: [...new Set(noSymlinks)]
-    }
-  };
+    var _a;
+    const variableContext = Object.assign(Object.assign({}, context), { custom: Object.assign(Object.assign({}, context.custom), { variable: getVariable(assets, context) }) });
+    const config = (0, template_1.merge)(await resolveDynamicMap(assets, variableContext, 'supplementaryConfig'), context.custom.config);
+    const customList = (_a = context.custom.noSymlinks) !== null && _a !== void 0 ? _a : [];
+    const assetList = assets.map(async ({ noSymlinks }) => (0, io_1.loadDynamic)(noSymlinks !== null && noSymlinks !== void 0 ? noSymlinks : [], variableContext));
+    const noSymlinks = [...(await Promise.all(assetList)), ...customList].flat();
+    return Object.assign(Object.assign({}, variableContext), { custom: Object.assign(Object.assign({}, variableContext.custom), { config, noSymlinks: [...new Set(noSymlinks)] }) });
 }
-/**
- * resolve a dynamic asset content
- * @param assets list of preset assets
- * @param context arguments to be passed to the generator function
- * @param field field name of PresetAsset to be resolved
- * @returns content of the resolved field
- */
-
-
+exports.resolveContext = resolveContext;
 async function resolveDynamicMap(assets, context, field) {
-  // load templated configuration from presets
-  const templates = await Promise.all(assets.map(async asset => {
-    const content = asset[field];
-    return Object.fromEntries(await Promise.all(Object.entries(content instanceof Function ? await content(context) : { ...content
-    }).map(async ([relativePath, value]) => [relativePath, // load a file if it's a valid path only
-    typeof value === 'string' && (0, _path.isAbsolute)(value) ? await (0, _io.loadFile)(value) : await (0, _io.loadDynamic)(value, context)])));
-  })); // merge all maps
-
-  return templates.reduce((merged, map) => (0, _template.merge)(merged, map), {});
+    const templates = await Promise.all(assets.map(async (asset) => {
+        const content = asset[field];
+        return Object.fromEntries(await Promise.all(Object.entries(content instanceof Function
+            ? await content(context)
+            : Object.assign({}, content)).map(async ([relativePath, value]) => [
+            relativePath,
+            typeof value === 'string' && (0, path_1.isAbsolute)(value)
+                ? await (0, io_1.loadFile)(value)
+                : await (0, io_1.loadDynamic)(value, context),
+        ])));
+    }));
+    return templates.reduce((merged, map) => (0, template_1.merge)(merged, map), {});
 }
-//# sourceMappingURL=content.js.map
+exports.resolveDynamicMap = resolveDynamicMap;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NvdXJjZS9jb250ZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWVBLCtCQUFxRDtBQUVyRCw2QkFBNkM7QUFDN0MseUNBQTZDO0FBa0I3QyxTQUFnQixTQUFTLENBQ3ZCLFFBQWtCLEVBQ2xCLE1BQTJDO0lBRTNDLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLEVBQUU7UUFDekQsT0FBTyxJQUFBLGdCQUFLLEVBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxNQUFNLENBQUMsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7S0FDdkQ7U0FBTSxJQUFJLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLEVBQUU7UUFDakUsT0FBTyxJQUFBLGdCQUFLLEVBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0tBQ2hDO1NBQU07UUFDTCxPQUFPLFFBQVEsQ0FBQztLQUNqQjtBQUNILENBQUM7QUFYRCw4QkFXQztBQU9NLEtBQUssVUFBVSxlQUFlLENBQ25DLE1BQXFCLEVBQ3JCLE9BQXNCO0lBRXRCLE1BQU0sZUFBZSxHQUFHLE1BQU0sY0FBYyxDQUFDLE1BQU0sRUFBRSxPQUFPLENBQUMsQ0FBQztJQUU5RCxNQUFNLGdCQUFnQixHQUFHLE1BQU0saUJBQWlCLENBQzlDLE1BQU0sRUFDTixlQUFlLEVBQ2YsVUFBVSxDQUNYLENBQUM7SUFHRixNQUFNLE1BQU0sR0FBRyxNQUFNLENBQUMsV0FBVyxDQUMvQixNQUFNLE9BQU8sQ0FBQyxHQUFHLENBQ2YsTUFBTSxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDLEdBQUcsQ0FDbEMsS0FBSyxFQUFFLENBQUMsWUFBWSxFQUFFLGNBQWMsQ0FBQyxFQUErQixFQUFFO1FBQ3BF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

package/lib/directive.js

@@ -1,222 +1,93 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isApplyDirective = isApplyDirective;
-exports.isDirective = isDirective;
-exports.isImportDirective = isImportDirective;
-exports.resolveDirective = resolveDirective;
-
-/*
- *                            *** MIT LICENSE ***
- * -------------------------------------------------------------------------
- * This code may be modified and distributed under the MIT license.
- * See the LICENSE file for details.
- * -------------------------------------------------------------------------
- *
- * @summary   Collection of helpers for parsing configuration
- *
- * @author    Alvis HT Tang <alvis@hilbert.space>
- * @license   MIT
- * @copyright Copyright (c) 2021 - All Rights Reserved.
- * -------------------------------------------------------------------------
- */
-
-/** syntax for an apply direc ti ve */
-
-/** syntax for an import directive */
-
-/** context that pass down to all parsers */
-
-/** syntax for an apply directive */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDirective = exports.isDirective = exports.isImportDirective = exports.isApplyDirective = void 0;
 const applyRegex = /^@apply ((\.+\/|@)?[a-zA-Z]+[a-zA-Z0-9_/.-]*[a-zA-Z0-9_]+)(\[([a-zA-Z]+[a-zA-Z0-9_.]*)\])?$/;
-/** syntax for an import directive */
-
 const importRegex = /^@import ((\.+\/|@)?[a-zA-Z]+[a-zA-Z0-9_/.-]*[a-zA-Z0-9_]+)(\[([a-zA-Z]+[a-zA-Z0-9_.]*)\])?$/;
-/**
- * indicate whether the given value is an apply directive
- * @param value value to be tested
- * @returns true if the value is an apply directive
- */
-
 function isApplyDirective(value) {
-  return typeof value === 'string' && !!applyRegex.exec(value);
+    return typeof value === 'string' && !!applyRegex.exec(value);
 }
-/**
- * indicate whether the given value is an import directive
- * @param value value to be tested
- * @returns true if the value is an import directive
- */
-
-
+exports.isApplyDirective = isApplyDirective;
 function isImportDirective(value) {
-  return typeof value === 'string' && !!importRegex.exec(value);
+    return typeof value === 'string' && !!importRegex.exec(value);
 }
-/**
- * indicate whether the given value is a directive
- * @param value value to be tested
- * @returns true if the value is a directive
- */
-
-
+exports.isImportDirective = isImportDirective;
 function isDirective(value) {
-  return isApplyDirective(value) || isImportDirective(value);
+    return isApplyDirective(value) || isImportDirective(value);
 }
-/**
- * resolve directives from configuration options
- * @param config configuration options
- * @param context background context about the configuration
- * @returns resolved configuration options with directive replaced
- */
-
-
+exports.isDirective = isDirective;
 function resolveDirective(config, context) {
-  const packages = new Set();
-  const stringifiedConfig = stringifyConfigObject(config, { ...context,
-    packages
-  });
-  const importMap = Object.fromEntries([...packages.values()].map((packageName, key) => [packageName, `import${key}`]));
-  return {
-    importMap,
-    stringifiedConfig
-  };
+    const packages = new Set();
+    const stringifiedConfig = stringifyConfigObject(config, Object.assign(Object.assign({}, context), { packages }));
+    const importMap = Object.fromEntries([...packages.values()].map((packageName, key) => [
+        packageName,
+        `import${key}`,
+    ]));
+    return { importMap, stringifiedConfig };
 }
-/**
- * resolve an apply directive
- * @param directiveMeta a potential directive in the form of [directive, options]
- * @param context shared context passed from the upstream
- * @returns resolved string or null if no directive is found
- */
-
-
+exports.resolveDirective = resolveDirective;
 function resolveApplyDirective(directiveMeta, context) {
-  const [directive, ...args] = directiveMeta;
-  const {
-    packages
-  } = context;
-
-  if (typeof directive === 'string') {
-    const match = applyRegex.exec(directive);
-
-    if (match) {
-      const [_, packageName, _prefix, _importBracket, importName] = match;
-      const resolvedArgs = args.map(arg => stringifyValue(arg, context));
-      const argsExpression = `[${resolvedArgs.join(', ')}]`;
-      const resolvedName = registerUsage(packages, packageName, importName);
-      return `${resolvedName}(...(${argsExpression} as const))`;
+    const [directive, ...args] = directiveMeta;
+    const { packages } = context;
+    if (typeof directive === 'string') {
+        const match = applyRegex.exec(directive);
+        if (match) {
+            const [_, packageName, _prefix, _importBracket, importName] = match;
+            const resolvedArgs = args.map((arg) => stringifyValue(arg, context));
+            const argsExpression = `[${resolvedArgs.join(', ')}]`;
+            const resolvedName = registerUsage(packages, packageName, importName);
+            return `${resolvedName}(...(${argsExpression} as const))`;
+        }
     }
-  } // return null for a non-match
-
-
-  return null;
+    return null;
 }
-/**
- * resolve an import directive
- * @param directive a potential directive string
- * @param context shared context passed from the upstream
- * @returns resolved string or null if no directive is found
- */
-
-
 function resolveImportDirective(directive, context) {
-  const {
-    packages
-  } = context;
-  const match = importRegex.exec(directive);
-
-  if (match) {
-    const [_, packageName, _prefix, _importBracket, importName] = match;
-    return registerUsage(packages, packageName, importName);
-  } // return null for a non-match
-
-
-  return null;
+    const { packages } = context;
+    const match = importRegex.exec(directive);
+    if (match) {
+        const [_, packageName, _prefix, _importBracket, importName] = match;
+        return registerUsage(packages, packageName, importName);
+    }
+    return null;
 }
-/**
- * stringify a value which has a type object
- * @param value the value to be stringified
- * @param context shared context passed from the upstream
- * @returns stringified value
- */
-
-
 function stringifyObjectValue(value, context) {
-  if (Array.isArray(value)) {
-    var _resolveApplyDirectiv;
-
-    return (_resolveApplyDirectiv = resolveApplyDirective(value, context)) !== null && _resolveApplyDirectiv !== void 0 ? _resolveApplyDirectiv : stringifyConfigArray(value, context);
-  } else if (value !== null) {
-    return stringifyConfigObject(value, context);
-  } else {
-    return 'null';
-  }
+    var _a;
+    if (Array.isArray(value)) {
+        return ((_a = resolveApplyDirective(value, context)) !== null && _a !== void 0 ? _a : stringifyConfigArray(value, context));
+    }
+    else if (value !== null) {
+        return stringifyConfigObject(value, context);
+    }
+    else {
+        return 'null';
+    }
 }
-/**
- * stringify an array
- * @param config an object to be parsed
- * @param context shared context passed from the upstream
- * @returns stringified object
- */
-
-
 function stringifyConfigArray(config, context) {
-  const values = config.map(value => stringifyValue(value, context));
-  return `[${values.join(', ')}]`;
+    const values = config.map((value) => stringifyValue(value, context));
+    return `[${values.join(', ')}]`;
 }
-/**
- * stringify an object
- * @param config an object to be parsed
- * @param context shared context passed from the upstream
- * @returns stringified object
- */
-
-
 function stringifyConfigObject(config, context) {
-  const values = Object.entries(config).map(([key, value]) => {
-    return `${JSON.stringify(key)}: ${stringifyValue(value, context)}`;
-  });
-  return `{${values.join(', ')}}`;
+    const values = Object.entries(config).map(([key, value]) => {
+        return `${JSON.stringify(key)}: ${stringifyValue(value, context)}`;
+    });
+    return `{${values.join(', ')}}`;
 }
-/**
- * stringify a value
- * @param value the value to be stringified
- * @param context shared context passed from the upstream
- * @returns stringified value
- */
-
-
 function stringifyValue(value, context) {
-  var _resolveImportDirecti;
-
-  switch (typeof value) {
-    case 'string':
-      return (_resolveImportDirecti = resolveImportDirective(value, context)) !== null && _resolveImportDirecti !== void 0 ? _resolveImportDirecti : JSON.stringify(value);
-
-    case 'object':
-      return stringifyObjectValue(value, context);
-
-    case 'boolean':
-    case 'number':
-    default:
-      return JSON.stringify(value);
-  }
+    var _a;
+    switch (typeof value) {
+        case 'string':
+            return (_a = resolveImportDirective(value, context)) !== null && _a !== void 0 ? _a : JSON.stringify(value);
+        case 'object':
+            return stringifyObjectValue(value, context);
+        case 'boolean':
+        case 'number':
+        default:
+            return JSON.stringify(value);
+    }
 }
-/**
- * add the needed package name to the registry and return its resolved name
- * @param packages package registry
- * @param packageName name of the package to be imported
- * @param importName named import to be used
- * @returns resolved symbol
- */
-
-
 function registerUsage(packages, packageName, importName) {
-  // add package and import to the register
-  packages.add(packageName); // replace the directive with the value path
-
-  const packageKey = [...packages.values()].findIndex(name => name === packageName);
-  const named = importName ? `.${importName}` : '';
-  return `import${packageKey}${named}`;
+    packages.add(packageName);
+    const packageKey = [...packages.values()].findIndex((name) => name === packageName);
+    const named = importName ? `.${importName}` : '';
+    return `import${packageKey}${named}`;
 }
-//# sourceMappingURL=directive.js.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGlyZWN0aXZlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc291cmNlL2RpcmVjdGl2ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFnQ0EsTUFBTSxVQUFVLEdBQ2QsNkZBQTZGLENBQUM7QUFHaEcsTUFBTSxXQUFXLEdBQ2YsOEZBQThGLENBQUM7QUFPakcsU0FBZ0IsZ0JBQWdCLENBQUMsS0FBYztJQUM3QyxPQUFPLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxDQUFDLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUMvRCxDQUFDO0FBRkQsNENBRUM7QUFPRCxTQUFnQixpQkFBaUIsQ0FBQyxLQUFjO0lBQzlDLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLENBQUMsQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO0FBQ2hFLENBQUM7QUFGRCw4Q0FFQztBQU9ELFNBQWdCLFdBQVcsQ0FDekIsS0FBYztJQUVkLE9BQU8sZ0JBQWdCLENBQUMsS0FBSyxDQUFDLElBQUksaUJBQWlCLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDN0QsQ0FBQztBQUpELGtDQUlDO0FBUUQsU0FBZ0IsZ0JBQWdCLENBQzlCLE1BQStCLEVBQy9CLE9BQXNCO0lBS3RCLE1BQU0sUUFBUSxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7SUFDbkMsTUFBTSxpQkFBaUIsR0FBRyxxQkFBcUIsQ0FBQyxNQUFNLGtDQUNqRCxPQUFPLEtBQ1YsUUFBUSxJQUNSLENBQUM7SUFFSCxNQUFNLFNBQVMsR0FBRyxNQUFNLENBQUMsV0FBVyxDQUNsQyxDQUFDLEdBQUcsUUFBUSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsV0FBVyxFQUFFLEdBQUcsRUFBRSxFQUFFLENBQUM7UUFDL0MsV0FBVztRQUNYLFNBQVMsR0FBRyxFQUFFO0tBQ2YsQ0FBQyxDQUNILENBQUM7SUFFRixPQUFPLEVB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

package/lib/error.js

@@ -1,40 +1,16 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.wrap = wrap;
-
-/*
- *                            *** MIT LICENSE ***
- * -------------------------------------------------------------------------
- * This code may be modified and distributed under the MIT license.
- * See the LICENSE file for details.
- * -------------------------------------------------------------------------
- *
- * @summary   Helpers for handling errors
- *
- * @author    Alvis HT Tang <alvis@hilbert.space>
- * @license   MIT
- * @copyright Copyright (c) 2020 - All Rights Reserved.
- * -------------------------------------------------------------------------
- */
-
-/**
- * prepend a rejected error message with a better explanation
- * @param promise a promise to be resolved
- * @param message a custom message to be prepended to any rejected message
- * @returns wrapped error
- */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrap = void 0;
 async function wrap(promise, message) {
-  try {
-    return await promise;
-  } catch (error) {
-    if (error instanceof Error) {
-      error.message = `${message}: ${error.message}`;
+    try {
+        return await promise;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            error.message = `${message}: ${error.message}`;
+        }
+        throw error;
     }
-
-    throw error;
-  }
 }
-//# sourceMappingURL=error.js.map
+exports.wrap = wrap;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zb3VyY2UvZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBcUJPLEtBQUssVUFBVSxJQUFJLENBQ3hCLE9BQW1CLEVBQ25CLE9BQWU7SUFFZixJQUFJO1FBQ0YsT0FBTyxNQUFNLE9BQU8sQ0FBQztLQUN0QjtJQUFDLE9BQU8sS0FBSyxFQUFFO1FBQ2QsSUFBSSxLQUFLLFlBQVksS0FBSyxFQUFFO1lBQzFCLEtBQUssQ0FBQyxPQUFPLEdBQUcsR0FBRyxPQUFPLEtBQUssS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO1NBQ2hEO1FBRUQsTUFBTSxLQUFLLENBQUM7S0FDYjtBQUNILENBQUM7QUFiRCxvQkFhQyJ9