@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.1.0

package/dist/lib/cjs/npm-publish.d.cts

@@ -0,0 +1,19 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for NPM publish.
+ */
+/**
+ * Publish to NPM.
+ *
+ * Authentication is intentionally not handled here. The publish is expected to run from a CI job
+ * configured as a {@link https://docs.npmjs.com/trusted-publishers | trusted publisher} on npmjs.com,
+ * where the npm CLI exchanges the job's short-lived OIDC token for a publish grant on its own. No NPM
+ * token is read, written, or stored, and the published package gets provenance for free.
+ *
+ * Requires npm `11.5.1` or later.
+ *
+ * @param isBeta - Whether to publish to the beta NPM registry.
+ */
+export declare function publish(isBeta?: boolean): Promise<void>;

package/dist/lib/cjs/npm-run.cjs

@@ -0,0 +1,120 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var npm_run_exports = {};
+__export(npm_run_exports, {
+  NpmRunOptionalResult: () => NpmRunOptionalResult,
+  npmRun: () => npmRun,
+  npmRunOptional: () => npmRunOptional
+});
+module.exports = __toCommonJS(npm_run_exports);
+var import_debug = require('@mnaoumov/typescript-lib/debug');
+var import_npm = require('./npm.cjs');
+var import_package_manager = require('./package-manager.cjs');
+var import_root = require('./root.cjs');
+var NpmRunOptionalResult = /* @__PURE__ */ ((NpmRunOptionalResult2) => {
+  NpmRunOptionalResult2["Skipped"] = "skipped";
+  NpmRunOptionalResult2["Success"] = "success";
+  return NpmRunOptionalResult2;
+})(NpmRunOptionalResult || {});
+async function npmRun(command) {
+  const packageJson = await (0, import_npm.readPackageJson)();
+  const isKnownCommand = Object.keys(packageJson.scripts ?? {}).includes(command);
+  if (isKnownCommand) {
+    await (0, import_root.execFromRoot)([...(0, import_package_manager.getPackageManagerRunCommand)(), command]);
+  } else {
+    throw new Error(`Command ${command} is not defined in the package.json`);
+  }
+}
+async function npmRunOptional(command) {
+  const packageJson = await (0, import_npm.readPackageJson)();
+  const isKnownCommand = Object.keys(packageJson.scripts ?? {}).includes(command);
+  if (isKnownCommand) {
+    await (0, import_root.execFromRoot)([...(0, import_package_manager.getPackageManagerRunCommand)(), command]);
+    return "success" /* Success */;
+  }
+  (0, import_debug.getLibDebugger)("npmRunOptional")(`Command ${command} is not defined in the package.json, skipping`);
+  return "skipped" /* Skipped */;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NpmRunOptionalResult,
+  npmRun,
+  npmRunOptional
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25wbS1ydW4udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBOUE0gcnVuIHV0aWxpdGllcy5cbiAqL1xuXG5pbXBvcnQgeyBnZXRMaWJEZWJ1Z2dlciB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kZWJ1Zyc7XG5cbmltcG9ydCB7IHJlYWRQYWNrYWdlSnNvbiB9IGZyb20gJy4vbnBtLnRzJztcbmltcG9ydCB7IGdldFBhY2thZ2VNYW5hZ2VyUnVuQ29tbWFuZCB9IGZyb20gJy4vcGFja2FnZS1tYW5hZ2VyLnRzJztcbmltcG9ydCB7IGV4ZWNGcm9tUm9vdCB9IGZyb20gJy4vcm9vdC50cyc7XG5cbi8qKlxuICogVGhlIHJlc3VsdCBvZiBydW5uaW5nIGFuIG9wdGlvbmFsIG5wbSBjb21tYW5kLlxuICovXG5leHBvcnQgZW51bSBOcG1SdW5PcHRpb25hbFJlc3VsdCB7XG4gIC8qKlxuICAgKiBUaGUgY29tbWFuZCB3YXMgc2tpcHBlZCBiZWNhdXNlIGl0IHdhcyBub3QgZGVmaW5lZCBpbiB0aGUgcGFja2FnZS5qc29uIHNjcmlwdHMuXG4gICAqL1xuICBTa2lwcGVkID0gJ3NraXBwZWQnLFxuXG4gIC8qKlxuICAgKiBUaGUgY29tbWFuZCB3YXMgZm91bmQgYW5kIHJ1biBzdWNjZXNzZnVsbHkuXG4gICAqL1xuICBTdWNjZXNzID0gJ3N1Y2Nlc3MnXG59XG5cbi8qKlxuICogUnVucyBhIGNvbW1hbmQgdXNpbmcgbnBtIGNoZWNraW5nIGlmIHRoZSBjb21tYW5kIGlzIG92ZXJyaWRkZW4gaW4gdGhlIHBhY2thZ2UuanNvbi5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZCAtIFRoZSBjb21tYW5kIHRvIHJ1bi5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIG5wbVJ1bihjb21tYW5kOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgcGFja2FnZUpzb24gPSBhd2FpdCByZWFkUGFja2FnZUpzb24oKTtcbiAgY29uc3QgaXNLbm93bkNvbW1hbmQgPSBPYmplY3Qua2V5cyhwYWNrYWdlSnNvbi5zY3JpcHRzID8/IHt9KS5pbmNsdWRlcyhjb21tYW5kKTtcbiAgaWYgKGlzS25vd25Db21tYW5kKSB7XG4gICAgYXdhaXQgZXhlY0Zyb21Sb290KFsuLi5nZXRQYWNrYWdlTWFuYWdlclJ1bkNvbW1hbmQoKSwgY29tbWFuZF0pO1xuICB9IGVsc2Uge1xuICAgIHRocm93IG5ldyBFcnJvcihgQ29tbWFuZCAke2NvbW1hbmR9IGlzIG5vdCBkZWZpbmVkIGluIHRoZSBwYWNrYWdlLmpzb25gKTtcbiAgfVxufVxuXG4vKipcbiAqIFJ1bnMgYSBjb21tYW5kIHVzaW5nIG5wbSBvbmx5IGlmIHRoZSBjb21tYW5kIGlzIGRlZmluZWQgaW4gdGhlIHBhY2thZ2UuanNvbiBzY3JpcHRzLlxuICogSWYgdGhlIGNvbW1hbmQgaXMgbm90IGRlZmluZWQsIGl0IGlzIHNpbGVudGx5IHNraXBwZWQuXG4gKlxuICogQHBhcmFtIGNvbW1hbmQgLSBUaGUgY29tbWFuZCB0byBydW4uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIHtAbGluayBOcG1SdW5PcHRpb25hbFJlc3VsdC5TdWNjZXNzfSBpZiB0aGUgY29tbWFuZCB3YXNcbiAqIGZvdW5kIGFuZCBydW4sIG9yIHtAbGluayBOcG1SdW5PcHRpb25hbFJlc3VsdC5Ta2lwcGVkfSBvdGhlcndpc2UuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBucG1SdW5PcHRpb25hbChjb21tYW5kOiBzdHJpbmcpOiBQcm9taXNlPE5wbVJ1bk9wdGlvbmFsUmVzdWx0PiB7XG4gIGNvbnN0IHBhY2thZ2VKc29uID0gYXdhaXQgcmVhZFBhY2thZ2VKc29uKCk7XG4gIGNvbnN0IGlzS25vd25Db21tYW5kID0gT2JqZWN0LmtleXMocGFja2FnZUpzb24uc2NyaXB0cyA/PyB7fSkuaW5jbHVkZXMoY29tbWFuZCk7XG4gIGlmIChpc0tub3duQ29tbWFuZCkge1xuICAgIGF3YWl0IGV4ZWNGcm9tUm9vdChbLi4uZ2V0UGFja2FnZU1hbmFnZXJSdW5Db21tYW5kKCksIGNvbW1hbmRdKTtcbiAgICByZXR1cm4gTnBtUnVuT3B0aW9uYWxSZXN1bHQuU3VjY2VzcztcbiAgfVxuICBnZXRMaWJEZWJ1Z2dlcignbnBtUnVuT3B0aW9uYWwnKShgQ29tbWFuZCAke2NvbW1hbmR9IGlzIG5vdCBkZWZpbmVkIGluIHRoZSBwYWNrYWdlLmpzb24sIHNraXBwaW5nYCk7XG4gIHJldHVybiBOcG1SdW5PcHRpb25hbFJlc3VsdC5Ta2lwcGVkO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxtQkFBK0I7QUFFL0IsaUJBQWdDO0FBQ2hDLDZCQUE0QztBQUM1QyxrQkFBNkI7QUFLdEIsSUFBSyx1QkFBTCxrQkFBS0EsMEJBQUw7QUFJTCxFQUFBQSxzQkFBQSxhQUFVO0FBS1YsRUFBQUEsc0JBQUEsYUFBVTtBQVRBLFNBQUFBO0FBQUEsR0FBQTtBQWlCWixlQUFzQixPQUFPLFNBQWdDO0FBQzNELFFBQU0sY0FBYyxVQUFNLDRCQUFnQjtBQUMxQyxRQUFNLGlCQUFpQixPQUFPLEtBQUssWUFBWSxXQUFXLENBQUMsQ0FBQyxFQUFFLFNBQVMsT0FBTztBQUM5RSxNQUFJLGdCQUFnQjtBQUNsQixjQUFNLDBCQUFhLENBQUMsT0FBRyxvREFBNEIsR0FBRyxPQUFPLENBQUM7QUFBQSxFQUNoRSxPQUFPO0FBQ0wsVUFBTSxJQUFJLE1BQU0sV0FBVyxPQUFPLHFDQUFxQztBQUFBLEVBQ3pFO0FBQ0Y7QUFVQSxlQUFzQixlQUFlLFNBQWdEO0FBQ25GLFFBQU0sY0FBYyxVQUFNLDRCQUFnQjtBQUMxQyxRQUFNLGlCQUFpQixPQUFPLEtBQUssWUFBWSxXQUFXLENBQUMsQ0FBQyxFQUFFLFNBQVMsT0FBTztBQUM5RSxNQUFJLGdCQUFnQjtBQUNsQixjQUFNLDBCQUFhLENBQUMsT0FBRyxvREFBNEIsR0FBRyxPQUFPLENBQUM7QUFDOUQsV0FBTztBQUFBLEVBQ1Q7QUFDQSxtQ0FBZSxnQkFBZ0IsRUFBRSxXQUFXLE9BQU8sK0NBQStDO0FBQ2xHLFNBQU87QUFDVDsiLAogICJuYW1lcyI6IFsiTnBtUnVuT3B0aW9uYWxSZXN1bHQiXQp9Cg==

package/dist/lib/cjs/npm-run.d.cts

@@ -0,0 +1,34 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * NPM run utilities.
+ */
+/**
+ * The result of running an optional npm command.
+ */
+export declare enum NpmRunOptionalResult {
+    /**
+     * The command was skipped because it was not defined in the package.json scripts.
+     */
+    Skipped = "skipped",
+    /**
+     * The command was found and run successfully.
+     */
+    Success = "success"
+}
+/**
+ * Runs a command using npm checking if the command is overridden in the package.json.
+ *
+ * @param command - The command to run.
+ */
+export declare function npmRun(command: string): Promise<void>;
+/**
+ * Runs a command using npm only if the command is defined in the package.json scripts.
+ * If the command is not defined, it is silently skipped.
+ *
+ * @param command - The command to run.
+ * @returns A {@link Promise} that resolves to {@link NpmRunOptionalResult.Success} if the command was
+ * found and run, or {@link NpmRunOptionalResult.Skipped} otherwise.
+ */
+export declare function npmRunOptional(command: string): Promise<NpmRunOptionalResult>;

package/dist/lib/cjs/npm.cjs

@@ -0,0 +1,200 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+(function () {
+function ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+function keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var npm_exports = {};
+__export(npm_exports, {
+  editNpmShrinkWrapJson: () => editNpmShrinkWrapJson,
+  editPackageJson: () => editPackageJson,
+  editPackageJsonSync: () => editPackageJsonSync,
+  editPackageLockJson: () => editPackageLockJson,
+  editPackageLockJsonSync: () => editPackageLockJsonSync,
+  getNpmShrinkWrapJsonPath: () => getNpmShrinkWrapJsonPath,
+  getPackageJsonPath: () => getPackageJsonPath,
+  getPackageLockJsonPath: () => getPackageLockJsonPath,
+  readPackageJson: () => readPackageJson,
+  readPackageJsonSync: () => readPackageJsonSync,
+  readPackageLockJson: () => readPackageLockJson,
+  readPackageLockJsonSync: () => readPackageLockJsonSync,
+  writePackageJson: () => writePackageJson,
+  writePackageJsonSync: () => writePackageJsonSync,
+  writePackageLockJson: () => writePackageLockJson,
+  writePackageLockJsonSync: () => writePackageLockJsonSync
+});
+module.exports = __toCommonJS(npm_exports);
+var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_json = require('./json.cjs');
+var import_repo_paths = require('./repo-paths.cjs');
+var import_root = require('./root.cjs');
+async function editNpmShrinkWrapJson(editFunction, options = {}) {
+  const {
+    cwd,
+    shouldSkipIfMissing
+  } = options;
+  await (0, import_json.editJson)((0, import_object_utils.normalizeOptionalProperties)({ editFunction, path: getNpmShrinkWrapJsonPath(cwd), shouldSkipIfMissing }));
+}
+async function editPackageJson(editFunction, options = {}) {
+  const {
+    cwd,
+    shouldSkipIfMissing
+  } = options;
+  await (0, import_json.editJson)((0, import_object_utils.normalizeOptionalProperties)({ editFunction, path: getPackageJsonPath(cwd), shouldSkipIfMissing }));
+}
+function editPackageJsonSync(editFunction, options = {}) {
+  const {
+    cwd,
+    shouldSkipIfMissing
+  } = options;
+  (0, import_json.editJsonSync)((0, import_object_utils.normalizeOptionalProperties)({ editFunction, path: getPackageJsonPath(cwd), shouldSkipIfMissing }));
+}
+async function editPackageLockJson(editFunction, options = {}) {
+  const {
+    cwd,
+    shouldSkipIfMissing
+  } = options;
+  await (0, import_json.editJson)((0, import_object_utils.normalizeOptionalProperties)({ editFunction, path: getPackageLockJsonPath(cwd), shouldSkipIfMissing }));
+}
+function editPackageLockJsonSync(editFunction, options = {}) {
+  const {
+    cwd,
+    shouldSkipIfMissing
+  } = options;
+  (0, import_json.editJsonSync)((0, import_object_utils.normalizeOptionalProperties)({ editFunction, path: getPackageLockJsonPath(cwd), shouldSkipIfMissing }));
+}
+function getNpmShrinkWrapJsonPath(cwd) {
+  return (0, import_type_guards.ensureNonNullable)(
+    (0, import_root.resolvePathFromRoot)((0, import_object_utils.normalizeOptionalProperties)({ cwd, path: import_repo_paths.RepoPaths.NpmShrinkwrapJson })),
+    "Could not determine the npm-shrinkwrap.json path"
+  );
+}
+function getPackageJsonPath(cwd) {
+  return (0, import_type_guards.ensureNonNullable)(
+    (0, import_root.resolvePathFromRoot)((0, import_object_utils.normalizeOptionalProperties)({ cwd, path: import_repo_paths.RepoPaths.PackageJson })),
+    "Could not determine the package.json path"
+  );
+}
+function getPackageLockJsonPath(cwd) {
+  return (0, import_type_guards.ensureNonNullable)(
+    (0, import_root.resolvePathFromRoot)((0, import_object_utils.normalizeOptionalProperties)({ cwd, path: import_repo_paths.RepoPaths.PackageLockJson })),
+    "Could not determine the package-lock.json path"
+  );
+}
+async function readPackageJson(cwd) {
+  return await (0, import_json.readJson)(getPackageJsonPath(cwd));
+}
+function readPackageJsonSync(cwd) {
+  return (0, import_json.readJsonSync)(getPackageJsonPath(cwd));
+}
+async function readPackageLockJson(cwd) {
+  return await (0, import_json.readJson)(getPackageLockJsonPath(cwd));
+}
+function readPackageLockJsonSync(cwd) {
+  return (0, import_json.readJsonSync)(getPackageLockJsonPath(cwd));
+}
+async function writePackageJson(packageJson, cwd) {
+  await (0, import_json.writeJson)(getPackageJsonPath(cwd), packageJson);
+}
+function writePackageJsonSync(packageJson, cwd) {
+  (0, import_json.writeJsonSync)(getPackageJsonPath(cwd), packageJson);
+}
+async function writePackageLockJson(packageLockJson, cwd) {
+  await (0, import_json.writeJson)(getPackageLockJsonPath(cwd), packageLockJson);
+}
+function writePackageLockJsonSync(packageLockJson, cwd) {
+  (0, import_json.writeJsonSync)(getPackageLockJsonPath(cwd), packageLockJson);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  editNpmShrinkWrapJson,
+  editPackageJson,
+  editPackageJsonSync,
+  editPackageLockJson,
+  editPackageLockJsonSync,
+  getNpmShrinkWrapJsonPath,
+  getPackageJsonPath,
+  getPackageLockJsonPath,
+  readPackageJson,
+  readPackageJsonSync,
+  readPackageLockJson,
+  readPackageLockJsonSync,
+  writePackageJson,
+  writePackageJsonSync,
+  writePackageLockJson,
+  writePackageLockJsonSync
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25wbS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIENvbnRhaW5zIHV0aWxpdHkgZnVuY3Rpb25zIGZvciBOUE0gcGFja2FnZS5qc29uLlxuICovXG5cbmltcG9ydCB0eXBlIHtcbiAgUGFja2FnZUpzb24sXG4gIFByb21pc2FibGVcbn0gZnJvbSAndHlwZS1mZXN0JztcblxuaW1wb3J0IHsgbm9ybWFsaXplT3B0aW9uYWxQcm9wZXJ0aWVzIH0gZnJvbSAnQG1uYW91bW92L3R5cGVzY3JpcHQtbGliL29iamVjdC11dGlscyc7XG5pbXBvcnQgeyBlbnN1cmVOb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5cbmltcG9ydCB0eXBlIHtcbiAgRWRpdEpzb25QYXJhbXMsXG4gIEVkaXRKc29uU3luY1BhcmFtc1xufSBmcm9tICcuL2pzb24udHMnO1xuaW1wb3J0IHR5cGUgeyBSZXNvbHZlUGF0aEZyb21Sb290UGFyYW1zIH0gZnJvbSAnLi9yb290LnRzJztcblxuaW1wb3J0IHtcbiAgZWRpdEpzb24sXG4gIGVkaXRKc29uU3luYyxcbiAgcmVhZEpzb24sXG4gIHJlYWRKc29uU3luYyxcbiAgd3JpdGVKc29uLFxuICB3cml0ZUpzb25TeW5jXG59IGZyb20gJy4vanNvbi50cyc7XG5pbXBvcnQgeyBSZXBvUGF0aHMgfSBmcm9tICcuL3JlcG8tcGF0aHMudHMnO1xuaW1wb3J0IHsgcmVzb2x2ZVBhdGhGcm9tUm9vdCB9IGZyb20gJy4vcm9vdC50cyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGVkaXROcG1TaHJpbmtXcmFwSnNvbn0uXG4gKi9cbmV4cG9ydCB0eXBlIEVkaXROcG1TaHJpbmtXcmFwSnNvbk9wdGlvbnMgPSBFZGl0UGFja2FnZUpzb25PcHRpb25zO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHtAbGluayBlZGl0UGFja2FnZUpzb259LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEVkaXRQYWNrYWdlSnNvbk9wdGlvbnMge1xuICAvKipcbiAgICogQSBjdXJyZW50IHdvcmtpbmcgZm9sZGVyIHdoZXJlIGBwYWNrYWdlLmpzb25gIGlzIGxvY2F0ZWQuXG4gICAqL1xuICByZWFkb25seSBjd2Q/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIElmIGB0cnVlYCwgc2tpcHMgZWRpdGluZyBpZiB0aGUgZmlsZSBkb2VzIG5vdCBleGlzdC5cbiAgICpcbiAgICogQGRlZmF1bHQgYGZhbHNlYFxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkU2tpcElmTWlzc2luZz86IGJvb2xlYW47XG59XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGVkaXRQYWNrYWdlSnNvblN5bmN9LlxuICovXG5leHBvcnQgdHlwZSBFZGl0UGFja2FnZUpzb25TeW5jT3B0aW9ucyA9IEVkaXRQYWNrYWdlSnNvbk9wdGlvbnM7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGVkaXRQYWNrYWdlTG9ja0pzb259LlxuICovXG5leHBvcnQgdHlwZSBFZGl0UGFja2FnZUxvY2tKc29uT3B0aW9ucyA9IEVkaXRQYWNrYWdlSnNvbk9wdGlvbnM7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGVkaXRQYWNrYWdlTG9ja0pzb25TeW5jfS5cbiAqL1xuZXhwb3J0IHR5cGUgRWRpdFBhY2thZ2VMb2NrSnNvblN5bmNPcHRpb25zID0gRWRpdFBhY2thZ2VKc29uT3B0aW9ucztcblxuLyoqXG4gKiBBIHR5cGUgb2YgdGhlIGBwYWNrYWdlLmpzb25gIGZpbGUuXG4gKi9cblxuLyoqXG4gKiBBIHR5cGUgb2YgdGhlIGBwYWNrYWdlLWxvY2suanNvbmAgZmlsZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQYWNrYWdlTG9ja0pzb24gZXh0ZW5kcyBQYXJ0aWFsPFBhY2thZ2VKc29uPiB7XG4gIC8qKlxuICAgKiBQYWNrYWdlcyBpbiB0aGUgYHBhY2thZ2UtbG9jay5qc29uYCBmaWxlLlxuICAgKi9cbiAgcGFja2FnZXM/OiBSZWNvcmQ8c3RyaW5nLCBQYWNrYWdlSnNvbj47XG59XG5cbi8qKlxuICogUmVhZHMsIGVkaXRzLCBhbmQgd3JpdGVzIGJhY2sgdGhlIGBwYWNrYWdlLWxvY2suanNvbmAgZmlsZSB1c2luZyB0aGUgcHJvdmlkZWQgZWRpdCBmdW5jdGlvbi5cbiAqXG4gKiBAcGFyYW0gZWRpdEZ1bmN0aW9uIC0gVGhlIGZ1bmN0aW9uIHRvIGVkaXQgdGhlIHBhcnNlZCBgUGFja2FnZUpzb25gIG9iamVjdC5cbiAqIEBwYXJhbSBvcHRpb25zIC0gQWRkaXRpb25hbCBvcHRpb25zIGZvciBlZGl0aW5nLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBmaWxlIGhhcyBiZWVuIGVkaXRlZCBhbmQgd3JpdHRlbi5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGVkaXROcG1TaHJpbmtXcmFwSnNvbihcbiAgZWRpdEZ1bmN0aW9uOiAocGFja2FnZUxvY2tKc29uOiBQYWNrYWdlTG9ja0pzb24pID0+IFByb21pc2FibGU8dm9pZD4sXG4gIG9wdGlvbnM6IEVkaXROcG1TaHJpbmtXcmFwSnNvbk9wdGlvbnMgPSB7fVxuKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHtcbiAgICBjd2QsXG4gICAgc2hvdWxkU2tpcElmTWlzc2luZ1xuICB9ID0gb3B0aW9ucztcbiAgYXdhaXQgZWRpdEpzb248UGFja2FnZUpzb24+KG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxFZGl0SnNvblBhcmFtczxQYWNrYWdlSnNvbj4+KHsgZWRpdEZ1bmN0aW9uLCBwYXRoOiBnZXROcG1TaHJpbmtXcmFwSnNvblBhdGgoY3dkKSwgc2hvdWxkU2tpcElmTWlzc2luZyB9KSk7XG59XG5cbi8qKlxuICogUmVhZHMsIGVkaXRzLCBhbmQgd3JpdGVzIGJhY2sgdGhlIGBwYWNrYWdlLmpzb25gIGZpbGUgdXNpbmcgdGhlIHByb3ZpZGVkIGVkaXQgZnVuY3Rpb24uXG4gKlxuICogQHBhcmFtIGVkaXRGdW5jdGlvbiAtIFRoZSBmdW5jdGlvbiB0byBlZGl0IHRoZSBwYXJzZWQgYFBhY2thZ2VKc29uYCBvYmplY3QuXG4gKiBAcGFyYW0gb3B0aW9ucyAtIEFkZGl0aW9uYWwgb3B0aW9ucyBmb3IgZWRpdGluZy5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgZmlsZSBoYXMgYmVlbiBlZGl0ZWQgYW5kIHdyaXR0ZW4uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBlZGl0UGFja2FnZUpzb24oXG4gIGVkaXRGdW5jdGlvbjogKHBhY2thZ2VKc29uOiBQYWNrYWdlSnNvbikgPT4gUHJvbWlzYWJsZTx2b2lkPixcbiAgb3B0aW9uczogRWRpdFBhY2thZ2VKc29uT3B0aW9ucyA9IHt9XG4pOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3Qge1xuICAgIGN3ZCxcbiAgICBzaG91bGRTa2lwSWZNaXNzaW5nXG4gIH0gPSBvcHRpb25zO1xuICBhd2FpdCBlZGl0SnNvbjxQYWNrYWdlSnNvbj4obm9ybWFsaXplT3B0aW9uYWxQcm9wZXJ0aWVzPEVkaXRKc29uUGFyYW1zPFBhY2thZ2VKc29uPj4oeyBlZGl0RnVuY3Rpb24sIHBhdGg6IGdldFBhY2thZ2VKc29uUGF0aChjd2QpLCBzaG91bGRTa2lwSWZNaXNzaW5nIH0pKTtcbn1cblxuLyoqXG4gKiBSZWFkcywgZWRpdHMsIGFuZCB3cml0ZXMgYmFjayB0aGUgYHBhY2thZ2UuanNvbmAgZmlsZSB1c2luZyB0aGUgcHJvdmlkZWQgZWRpdCBmdW5jdGlvbi5cbiAqXG4gKiBAcGFyYW0gZWRpdEZ1bmN0aW9uIC0gVGhlIGZ1bmN0aW9uIHRvIGVkaXQgdGhlIHBhcnNlZCBgUGFja2FnZUpzb25gIG9iamVjdC5cbiAqIEBwYXJhbSBvcHRpb25zIC0gQWRkaXRpb25hbCBvcHRpb25zIGZvciBlZGl0aW5nLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZWRpdFBhY2thZ2VKc29uU3luYyhcbiAgZWRpdEZ1bmN0aW9uOiAocGFja2FnZUpzb246IFBhY2thZ2VKc29uKSA9PiB2b2lkLFxuICBvcHRpb25zOiBFZGl0UGFja2FnZUpzb25TeW5jT3B0aW9ucyA9IHt9XG4pOiB2b2lkIHtcbiAgY29uc3Qge1xuICAgIGN3ZCxcbiAgICBzaG91bGRTa2lwSWZNaXNzaW5nXG4gIH0gPSBvcHRpb25zO1xuICBlZGl0SnNvblN5bmM8UGFja2FnZUpzb24+KG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxFZGl0SnNvblN5bmNQYXJhbXM8UGFja2FnZUpzb24+Pih7IGVkaXRGdW5jdGlvbiwgcGF0aDogZ2V0UGFja2FnZUpzb25QYXRoKGN3ZCksIHNob3VsZFNraXBJZk1pc3NpbmcgfSkpO1xufVxuXG4vKipcbiAqIFJlYWRzLCBlZGl0cywgYW5kIHdyaXRlcyBiYWNrIHRoZSBgcGFja2FnZS1sb2NrLmpzb25gIGZpbGUgdXNpbmcgdGhlIHByb3ZpZGVkIGVkaXQgZnVuY3Rpb24uXG4gKlxuICogQHBhcmFtIGVkaXRGdW5jdGlvbiAtIFRoZSBmdW5jdGlvbiB0byBlZGl0IHRoZSBwYXJzZWQgYFBhY2thZ2VKc29uYCBvYmplY3QuXG4gKiBAcGFyYW0gb3B0aW9ucyAtIEFkZGl0aW9uYWwgb3B0aW9ucyBmb3IgZWRpdGluZy5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgZmlsZSBoYXMgYmVlbiBlZGl0ZWQgYW5kIHdyaXR0ZW4uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBlZGl0UGFja2FnZUxvY2tKc29uKFxuICBlZGl0RnVuY3Rpb246IChwYWNrYWdlTG9ja0pzb246IFBhY2thZ2VMb2NrSnNvbikgPT4gUHJvbWlzYWJsZTx2b2lkPixcbiAgb3B0aW9uczogRWRpdFBhY2thZ2VMb2NrSnNvbk9wdGlvbnMgPSB7fVxuKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHtcbiAgICBjd2QsXG4gICAgc2hvdWxkU2tpcElmTWlzc2luZ1xuICB9ID0gb3B0aW9ucztcbiAgYXdhaXQgZWRpdEpzb248UGFja2FnZUpzb24+KG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxFZGl0SnNvblBhcmFtczxQYWNrYWdlSnNvbj4+KHsgZWRpdEZ1bmN0aW9uLCBwYXRoOiBnZXRQYWNrYWdlTG9ja0pzb25QYXRoKGN3ZCksIHNob3VsZFNraXBJZk1pc3NpbmcgfSkpO1xufVxuXG4vKipcbiAqIFJlYWRzLCBlZGl0cywgYW5kIHdyaXRlcyBiYWNrIHRoZSBgcGFja2FnZS1sb2NrLmpzb25gIGZpbGUgdXNpbmcgdGhlIHByb3ZpZGVkIGVkaXQgZnVuY3Rpb24uXG4gKlxuICogQHBhcmFtIGVkaXRGdW5jdGlvbiAtIFRoZSBmdW5jdGlvbiB0byBlZGl0IHRoZSBwYXJzZWQgYFBhY2thZ2VMb2NrSnNvbmAgb2JqZWN0LlxuICogQHBhcmFtIG9wdGlvbnMgLSBBZGRpdGlvbmFsIG9wdGlvbnMgZm9yIGVkaXRpbmcuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlZGl0UGFja2FnZUxvY2tKc29uU3luYyhcbiAgZWRpdEZ1bmN0aW9uOiAocGFja2FnZUxvY2tKc29uOiBQYWNrYWdlTG9ja0pzb24pID0+IHZvaWQsXG4gIG9wdGlvbnM6IEVkaXRQYWNrYWdlTG9ja0pzb25TeW5jT3B0aW9ucyA9IHt9XG4pOiB2b2lkIHtcbiAgY29uc3Qge1xuICAgIGN3ZCxcbiAgICBzaG91bGRTa2lwSWZNaXNzaW5nXG4gIH0gPSBvcHRpb25zO1xuICBlZGl0SnNvblN5bmM8UGFja2FnZUxvY2tKc29uPihub3JtYWxpemVPcHRpb25hbFByb3BlcnRpZXM8RWRpdEpzb25TeW5jUGFyYW1zPFBhY2thZ2VMb2NrSnNvbj4+KHsgZWRpdEZ1bmN0aW9uLCBwYXRoOiBnZXRQYWNrYWdlTG9ja0pzb25QYXRoKGN3ZCksIHNob3VsZFNraXBJZk1pc3NpbmcgfSkpO1xufVxuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBwYXRoIHRvIHRoZSBgbnBtLXNocmlua3dyYXAuanNvbmAgZmlsZSBpbiB0aGUgc3BlY2lmaWVkIGZvbGRlciBvciBpbiB0aGUgcm9vdCBpZiBubyBmb2xkZXIgaXMgc3BlY2lmaWVkLlxuICpcbiAqIEBwYXJhbSBjd2QgLSBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB3aGVyZSBgbnBtLXNocmlua3dyYXAuanNvbmAgaXMgbG9jYXRlZC5cbiAqIEByZXR1cm5zIFRoZSByZXNvbHZlZCBwYXRoIHRvIHRoZSBgbnBtLXNocmlua3dyYXAuanNvbmAgZmlsZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE5wbVNocmlua1dyYXBKc29uUGF0aChjd2Q/OiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gZW5zdXJlTm9uTnVsbGFibGUoXG4gICAgcmVzb2x2ZVBhdGhGcm9tUm9vdChub3JtYWxpemVPcHRpb25hbFByb3BlcnRpZXM8UmVzb2x2ZVBhdGhGcm9tUm9vdFBhcmFtcz4oeyBjd2QsIHBhdGg6IFJlcG9QYXRocy5OcG1TaHJpbmt3cmFwSnNvbiB9KSksXG4gICAgJ0NvdWxkIG5vdCBkZXRlcm1pbmUgdGhlIG5wbS1zaHJpbmt3cmFwLmpzb24gcGF0aCdcbiAgKTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlcyB0aGUgcGF0aCB0byB0aGUgYHBhY2thZ2UuanNvbmAgZmlsZSBpbiB0aGUgc3BlY2lmaWVkIGZvbGRlciBvciBpbiB0aGUgcm9vdCBpZiBubyBmb2xkZXIgaXMgc3BlY2lmaWVkLlxuICpcbiAqIEBwYXJhbSBjd2QgLSBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB3aGVyZSBgcGFja2FnZS5qc29uYCBpcyBsb2NhdGVkLlxuICogQHJldHVybnMgVGhlIHJlc29sdmVkIHBhdGggdG8gdGhlIGBwYWNrYWdlLmpzb25gIGZpbGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRQYWNrYWdlSnNvblBhdGgoY3dkPzogc3RyaW5nKTogc3RyaW5nIHtcbiAgcmV0dXJuIGVuc3VyZU5vbk51bGxhYmxlKFxuICAgIHJlc29sdmVQYXRoRnJvbVJvb3Qobm9ybWFsaXplT3B0aW9uYWxQcm9wZXJ0aWVzPFJlc29sdmVQYXRoRnJvbVJvb3RQYXJhbXM+KHsgY3dkLCBwYXRoOiBSZXBvUGF0aHMuUGFja2FnZUpzb24gfSkpLFxuICAgICdDb3VsZCBub3QgZGV0ZXJtaW5lIHRoZSBwYWNrYWdlLmpzb24gcGF0aCdcbiAgKTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlcyB0aGUgcGF0aCB0byB0aGUgYHBhY2thZ2UtbG9jay5qc29uYCBmaWxlIGluIHRoZSBzcGVjaWZpZWQgZm9sZGVyIG9yIGluIHRoZSByb290IGlmIG5vIGZvbGRlciBpcyBzcGVjaWZpZWQuXG4gKlxuICogQHBhcmFtIGN3ZCAtIFRoZSBjdXJyZW50IHdvcmtpbmcgZm9sZGVyIHdoZXJlIGBwYWNrYWdlLWxvY2suanNvbmAgaXMgbG9jYXRlZC5cbiAqIEByZXR1cm5zIFRoZSByZXNvbHZlZCBwYXRoIHRvIHRoZSBgcGFja2FnZS1sb2NrLmpzb25gIGZpbGUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRQYWNrYWdlTG9ja0pzb25QYXRoKGN3ZD86IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBlbnN1cmVOb25OdWxsYWJsZShcbiAgICByZXNvbHZlUGF0aEZyb21Sb290KG5vcm1hbGl6ZU9wdGlvbmFsUHJvcGVydGllczxSZXNvbHZlUGF0aEZyb21Sb290UGFyYW1zPih7IGN3ZCwgcGF0aDogUmVwb1BhdGhzLlBhY2thZ2VMb2NrSnNvbiB9KSksXG4gICAgJ0NvdWxkIG5vdCBkZXRlcm1pbmUgdGhlIHBhY2thZ2UtbG9jay5qc29uIHBhdGgnXG4gICk7XG59XG5cbi8qKlxuICogUmVhZHMgdGhlIGBwYWNrYWdlLmpzb25gIGZpbGUgZnJvbSB0aGUgc3BlY2lmaWVkIGZvbGRlciBvciBmcm9tIHRoZSByb290IGlmIG5vIGZvbGRlciBpcyBzcGVjaWZpZWQuXG4gKlxuICogQHBhcmFtIGN3ZCAtIFRoZSBjdXJyZW50IHdvcmtpbmcgZm9sZGVyIHdoZXJlIGBwYWNrYWdlLmpzb25gIGlzIGxvY2F0ZWQuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIHBhcnNlZCBgUGFja2FnZUpzb25gIG9iamVjdC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJlYWRQYWNrYWdlSnNvbihjd2Q/OiBzdHJpbmcpOiBQcm9taXNlPFBhY2thZ2VKc29uPiB7XG4gIHJldHVybiBhd2FpdCByZWFkSnNvbjxQYWNrYWdlSnNvbj4oZ2V0UGFja2FnZUpzb25QYXRoKGN3ZCkpO1xufVxuXG4vKipcbiAqIFJlYWRzIHRoZSBgcGFja2FnZS5qc29uYCBmaWxlIGZyb20gdGhlIHNwZWNpZmllZCBmb2xkZXIgb3IgZnJvbSB0aGUgcm9vdCBpZiBubyBmb2xkZXIgaXMgc3BlY2lmaWVkLlxuICpcbiAqIEBwYXJhbSBjd2QgLSBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB3aGVyZSBgcGFja2FnZS5qc29uYCBpcyBsb2NhdGVkLlxuICogQHJldHVybnMgVGhlIHBhcnNlZCBgUGFja2FnZUpzb25gIG9iamVjdC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlYWRQYWNrYWdlSnNvblN5bmMoY3dkPzogc3RyaW5nKTogUGFja2FnZUpzb24ge1xuICByZXR1cm4gcmVhZEpzb25TeW5jPFBhY2thZ2VKc29uPihnZXRQYWNrYWdlSnNvblBhdGgoY3dkKSk7XG59XG5cbi8qKlxuICogUmVhZHMgdGhlIGBwYWNrYWdlLWxvY2suanNvbmAgZmlsZSBmcm9tIHRoZSBzcGVjaWZpZWQgZm9sZGVyIG9yIGZyb20gdGhlIHJvb3QgaWYgbm8gZm9sZGVyIGlzIHNwZWNpZmllZC5cbiAqXG4gKiBAcGFyYW0gY3dkIC0gVGhlIGN1cnJlbnQgd29ya2luZyBmb2xkZXIgd2hlcmUgYHBhY2thZ2UtbG9jay5qc29uYCBpcyBsb2NhdGVkLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aXRoIHRoZSBwYXJzZWQgYFBhY2thZ2VKc29uYCBvYmplY3QuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiByZWFkUGFja2FnZUxvY2tKc29uKGN3ZD86IHN0cmluZyk6IFByb21pc2U8UGFja2FnZUxvY2tKc29uPiB7XG4gIHJldHVybiBhd2FpdCByZWFkSnNvbjxQYWNrYWdlTG9ja0pzb24+KGdldFBhY2thZ2VMb2NrSnNvblBhdGgoY3dkKSk7XG59XG5cbi8qKlxuICogUmVhZHMgdGhlIGBwYWNrYWdlLWxvY2suanNvbmAgZmlsZSBmcm9tIHRoZSBzcGVjaWZpZWQgZm9sZGVyIG9yIGZyb20gdGhlIHJvb3QgaWYgbm8gZm9sZGVyIGlzIHNwZWNpZmllZC5cbiAqXG4gKiBAcGFyYW0gY3dkIC0gVGhlIGN1cnJlbnQgd29ya2luZyBmb2xkZXIgd2hlcmUgYHBhY2thZ2UtbG9jay5qc29uYCBpcyBsb2NhdGVkLlxuICogQHJldHVybnMgVGhlIHBhcnNlZCBgUGFja2FnZUxvY2tKc29uYCBvYmplY3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZWFkUGFja2FnZUxvY2tKc29uU3luYyhjd2Q/OiBzdHJpbmcpOiBQYWNrYWdlTG9ja0pzb24ge1xuICByZXR1cm4gcmVhZEpzb25TeW5jPFBhY2thZ2VMb2NrSnNvbj4oZ2V0UGFja2FnZUxvY2tKc29uUGF0aChjd2QpKTtcbn1cblxuLyoqXG4gKiBXcml0ZXMgdGhlIHByb3ZpZGVkIGBQYWNrYWdlSnNvbmAgb2JqZWN0IHRvIHRoZSBgcGFja2FnZS5qc29uYCBmaWxlIGluIHRoZSBzcGVjaWZpZWQgZm9sZGVyIG9yIGluIHRoZSByb290LlxuICpcbiAqIEBwYXJhbSBwYWNrYWdlSnNvbiAtIFRoZSBgUGFja2FnZUpzb25gIG9iamVjdCB0byB3cml0ZS5cbiAqIEBwYXJhbSBjd2QgLSBUaGUgY3VycmVudCB3b3JraW5nIGZvbGRlciB3aGVyZSBgcGFja2FnZS5qc29uYCBpcyBsb2NhdGVkLlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBmaWxlIGhhcyBiZWVuIHdyaXR0ZW4uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3cml0ZVBhY2thZ2VKc29uKHBhY2thZ2VKc29uOiBQYWNrYWdlSnNvbiwgY3dkPzogc3RyaW5nKTogUHJvbWlzZTx2b2lkPiB7XG4gIGF3YWl0IHdyaXRlSnNvbihnZXRQYWNrYWdlSnNvblBhdGgoY3dkKSwgcGFja2FnZUpzb24pO1xufVxuXG4vKipcbiAqIFdyaXRlcyB0aGUgcHJvdmlkZWQgYFBhY2thZ2VKc29uYCBvYmplY3QgdG8gdGhlIGBwYWNrYWdlLmpzb25gIGZpbGUgaW4gdGhlIHNwZWNpZmllZCBmb2xkZXIgb3IgaW4gdGhlIHJvb3QuXG4gKlxuICogQHBhcmFtIHBhY2thZ2VKc29uIC0gVGhlIGBQYWNrYWdlSnNvbmAgb2JqZWN0IHRvIHdyaXRlLlxuICogQHBhcmFtIGN3ZCAtIFRoZSBjdXJyZW50IHdvcmtpbmcgZm9sZGVyIHdoZXJlIGBwYWNrYWdlLmpzb25gIGlzIGxvY2F0ZWQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB3cml0ZVBhY2thZ2VKc29uU3luYyhwYWNrYWdlSnNvbjogUGFja2FnZUpzb24sIGN3ZD86IHN0cmluZyk6IHZvaWQge1xuICB3cml0ZUpzb25TeW5jKGdldFBhY2thZ2VKc29uUGF0aChjd2QpLCBwYWNrYWdlSnNvbik7XG59XG5cbi8qKlxuICogV3JpdGVzIHRoZSBwcm92aWRlZCBgUGFja2FnZUpzb25gIG9iamVjdCB0byB0aGUgYHBhY2thZ2UtbG9jay5qc29uYCBmaWxlIGluIHRoZSBzcGVjaWZpZWQgZm9sZGVyIG9yIGluIHRoZSByb290LlxuICpcbiAqIEBwYXJhbSBwYWNrYWdlTG9ja0pzb24gLSBUaGUgYFBhY2thZ2VMb2NrSnNvbmAgb2JqZWN0IHRvIHdyaXRlLlxuICogQHBhcmFtIGN3ZCAtIFRoZSBjdXJyZW50IHdvcmtpbmcgZm9sZGVyIHdoZXJlIGBwYWNrYWdlLWxvY2suanNvbmAgaXMgbG9jYXRlZC5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgZmlsZSBoYXMgYmVlbiB3cml0dGVuLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gd3JpdGVQYWNrYWdlTG9ja0pzb24ocGFja2FnZUxvY2tKc29uOiBQYWNrYWdlTG9ja0pzb24sIGN3ZD86IHN0cmluZyk6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCB3cml0ZUpzb24oZ2V0UGFja2FnZUxvY2tKc29uUGF0aChjd2QpLCBwYWNrYWdlTG9ja0pzb24pO1xufVxuXG4vKipcbiAqIFdyaXRlcyB0aGUgcHJvdmlkZWQgYFBhY2thZ2VMb2NrSnNvbmAgb2JqZWN0IHRvIHRoZSBgcGFja2FnZS1sb2NrLmpzb25gIGZpbGUgaW4gdGhlIHNwZWNpZmllZCBmb2xkZXIgb3IgaW4gdGhlIHJvb3QuXG4gKlxuICogQHBhcmFtIHBhY2thZ2VMb2NrSnNvbiAtIFRoZSBgUGFja2FnZUxvY2tKc29uYCBvYmplY3QgdG8gd3JpdGUuXG4gKiBAcGFyYW0gY3dkIC0gVGhlIGN1cnJlbnQgd29ya2luZyBmb2xkZXIgd2hlcmUgYHBhY2thZ2UtbG9jay5qc29uYCBpcyBsb2NhdGVkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gd3JpdGVQYWNrYWdlTG9ja0pzb25TeW5jKHBhY2thZ2VMb2NrSnNvbjogUGFja2FnZUxvY2tKc29uLCBjd2Q/OiBzdHJpbmcpOiB2b2lkIHtcbiAgd3JpdGVKc29uU3luYyhnZXRQYWNrYWdlTG9ja0pzb25QYXRoKGN3ZCksIHBhY2thZ2VMb2NrSnNvbik7XG59XG5cbi8vIFR5cGVTY3JpcHQncyBkZWNsYXJhdGlvbiBlbWl0IGFkZHMgYHdpdGggeyAncmVzb2x1dGlvbi1tb2RlJzogJ2ltcG9ydCcgfWAgdG8gaW1wb3J0IGRlY2xhcmF0aW9ucyBvbmx5LlxuLy8gQSByZS1leHBvcnQtZnJvbSB3b3VsZCB0aHVzIHJlc29sdmUgRVNNLW9ubHkgYHR5cGUtZmVzdGAgdW5kZXIgYHJlcXVpcmVgIGluIHRoZSBgLmQuY3RzYCBidWlsZCAoVFMxNDc5KS5cbi8vIFJlLWV4cG9ydGluZyB0aGUgYmluZGluZyBpbXBvcnRlZCBhYm92ZSBrZWVwcyB0aGF0IHJlc29sdXRpb24gbW9kZSBhdHRhY2hlZC5cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSB1bmljb3JuL3ByZWZlci1leHBvcnQtZnJvbSAtLSBgZXhwb3J0XHUyMDI2ZnJvbWAgcmUtaW50cm9kdWNlcyBUUzE0NzksIHNlZSBhYm92ZS5cbmV4cG9ydCB0eXBlIHsgUGFja2FnZUpzb24gfTtcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFXQSwwQkFBNEM7QUFDNUMseUJBQWtDO0FBUWxDLGtCQU9PO0FBQ1Asd0JBQTBCO0FBQzFCLGtCQUFvQztBQTREcEMsZUFBc0Isc0JBQ3BCLGNBQ0EsVUFBd0MsQ0FBQyxHQUMxQjtBQUNmLFFBQU07QUFBQSxJQUNKO0FBQUEsSUFDQTtBQUFBLEVBQ0YsSUFBSTtBQUNKLFlBQU0sMEJBQXNCLGlEQUF5RCxFQUFFLGNBQWMsTUFBTSx5QkFBeUIsR0FBRyxHQUFHLG9CQUFvQixDQUFDLENBQUM7QUFDbEs7QUFTQSxlQUFzQixnQkFDcEIsY0FDQSxVQUFrQyxDQUFDLEdBQ3BCO0FBQ2YsUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBQ0osWUFBTSwwQkFBc0IsaURBQXlELEVBQUUsY0FBYyxNQUFNLG1CQUFtQixHQUFHLEdBQUcsb0JBQW9CLENBQUMsQ0FBQztBQUM1SjtBQVFPLFNBQVMsb0JBQ2QsY0FDQSxVQUFzQyxDQUFDLEdBQ2pDO0FBQ04sUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBQ0osb0NBQTBCLGlEQUE2RCxFQUFFLGNBQWMsTUFBTSxtQkFBbUIsR0FBRyxHQUFHLG9CQUFvQixDQUFDLENBQUM7QUFDOUo7QUFTQSxlQUFzQixvQkFDcEIsY0FDQSxVQUFzQyxDQUFDLEdBQ3hCO0FBQ2YsUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBQ0osWUFBTSwwQkFBc0IsaURBQXlELEVBQUUsY0FBYyxNQUFNLHVCQUF1QixHQUFHLEdBQUcsb0JBQW9CLENBQUMsQ0FBQztBQUNoSztBQVFPLFNBQVMsd0JBQ2QsY0FDQSxVQUEwQyxDQUFDLEdBQ3JDO0FBQ04sUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsRUFDRixJQUFJO0FBQ0osb0NBQThCLGlEQUFpRSxFQUFFLGNBQWMsTUFBTSx1QkFBdUIsR0FBRyxHQUFHLG9CQUFvQixDQUFDLENBQUM7QUFDMUs7QUFRTyxTQUFTLHlCQUF5QixLQUFzQjtBQUM3RCxhQUFPO0FBQUEsUUFDTCxxQ0FBb0IsaURBQXVELEVBQUUsS0FBSyxNQUFNLDRCQUFVLGtCQUFrQixDQUFDLENBQUM7QUFBQSxJQUN0SDtBQUFBLEVBQ0Y7QUFDRjtBQVFPLFNBQVMsbUJBQW1CLEtBQXNCO0FBQ3ZELGFBQU87QUFBQSxRQUNMLHFDQUFvQixpREFBdUQsRUFBRSxLQUFLLE1BQU0sNEJBQVUsWUFBWSxDQUFDLENBQUM7QUFBQSxJQUNoSDtBQUFBLEVBQ0Y7QUFDRjtBQVFPLFNBQVMsdUJBQXVCLEtBQXNCO0FBQzNELGFBQU87QUFBQSxRQUNMLHFDQUFvQixpREFBdUQsRUFBRSxLQUFLLE1BQU0sNEJBQVUsZ0JBQWdCLENBQUMsQ0FBQztBQUFBLElBQ3BIO0FBQUEsRUFDRjtBQUNGO0FBUUEsZUFBc0IsZ0JBQWdCLEtBQW9DO0FBQ3hFLFNBQU8sVUFBTSxzQkFBc0IsbUJBQW1CLEdBQUcsQ0FBQztBQUM1RDtBQVFPLFNBQVMsb0JBQW9CLEtBQTJCO0FBQzdELGFBQU8sMEJBQTBCLG1CQUFtQixHQUFHLENBQUM7QUFDMUQ7QUFRQSxlQUFzQixvQkFBb0IsS0FBd0M7QUFDaEYsU0FBTyxVQUFNLHNCQUEwQix1QkFBdUIsR0FBRyxDQUFDO0FBQ3BFO0FBUU8sU0FBUyx3QkFBd0IsS0FBK0I7QUFDckUsYUFBTywwQkFBOEIsdUJBQXVCLEdBQUcsQ0FBQztBQUNsRTtBQVNBLGVBQXNCLGlCQUFpQixhQUEwQixLQUE2QjtBQUM1RixZQUFNLHVCQUFVLG1CQUFtQixHQUFHLEdBQUcsV0FBVztBQUN0RDtBQVFPLFNBQVMscUJBQXFCLGFBQTBCLEtBQW9CO0FBQ2pGLGlDQUFjLG1CQUFtQixHQUFHLEdBQUcsV0FBVztBQUNwRDtBQVNBLGVBQXNCLHFCQUFxQixpQkFBa0MsS0FBNkI7QUFDeEcsWUFBTSx1QkFBVSx1QkFBdUIsR0FBRyxHQUFHLGVBQWU7QUFDOUQ7QUFRTyxTQUFTLHlCQUF5QixpQkFBa0MsS0FBb0I7QUFDN0YsaUNBQWMsdUJBQXVCLEdBQUcsR0FBRyxlQUFlO0FBQzVEOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/npm.d.cts

@@ -0,0 +1,168 @@
+/// <reference path="./library-references.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for NPM package.json.
+ */
+import type { PackageJson, Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+/**
+ * Options for {@link editNpmShrinkWrapJson}.
+ */
+export type EditNpmShrinkWrapJsonOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageJson}.
+ */
+export interface EditPackageJsonOptions {
+    /**
+     * A current working folder where `package.json` is located.
+     */
+    readonly cwd?: string;
+    /**
+     * If `true`, skips editing if the file does not exist.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipIfMissing?: boolean;
+}
+/**
+ * Options for {@link editPackageJsonSync}.
+ */
+export type EditPackageJsonSyncOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageLockJson}.
+ */
+export type EditPackageLockJsonOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageLockJsonSync}.
+ */
+export type EditPackageLockJsonSyncOptions = EditPackageJsonOptions;
+/**
+ * A type of the `package.json` file.
+ */
+/**
+ * A type of the `package-lock.json` file.
+ */
+export interface PackageLockJson extends Partial<PackageJson> {
+    /**
+     * Packages in the `package-lock.json` file.
+     */
+    packages?: Record<string, PackageJson>;
+}
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editNpmShrinkWrapJson(editFunction: (packageLockJson: PackageLockJson) => Promisable<void>, options?: EditNpmShrinkWrapJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editPackageJson(editFunction: (packageJson: PackageJson) => Promisable<void>, options?: EditPackageJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ */
+export declare function editPackageJsonSync(editFunction: (packageJson: PackageJson) => void, options?: EditPackageJsonSyncOptions): void;
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editPackageLockJson(editFunction: (packageLockJson: PackageLockJson) => Promisable<void>, options?: EditPackageLockJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageLockJson` object.
+ * @param options - Additional options for editing.
+ */
+export declare function editPackageLockJsonSync(editFunction: (packageLockJson: PackageLockJson) => void, options?: EditPackageLockJsonSyncOptions): void;
+/**
+ * Resolves the path to the `npm-shrinkwrap.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `npm-shrinkwrap.json` is located.
+ * @returns The resolved path to the `npm-shrinkwrap.json` file.
+ */
+export declare function getNpmShrinkWrapJsonPath(cwd?: string): string;
+/**
+ * Resolves the path to the `package.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns The resolved path to the `package.json` file.
+ */
+export declare function getPackageJsonPath(cwd?: string): string;
+/**
+ * Resolves the path to the `package-lock.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns The resolved path to the `package-lock.json` file.
+ */
+export declare function getPackageLockJsonPath(cwd?: string): string;
+/**
+ * Reads the `package.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns A {@link Promise} that resolves with the parsed `PackageJson` object.
+ */
+export declare function readPackageJson(cwd?: string): Promise<PackageJson>;
+/**
+ * Reads the `package.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns The parsed `PackageJson` object.
+ */
+export declare function readPackageJsonSync(cwd?: string): PackageJson;
+/**
+ * Reads the `package-lock.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns A {@link Promise} that resolves with the parsed `PackageJson` object.
+ */
+export declare function readPackageLockJson(cwd?: string): Promise<PackageLockJson>;
+/**
+ * Reads the `package-lock.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns The parsed `PackageLockJson` object.
+ */
+export declare function readPackageLockJsonSync(cwd?: string): PackageLockJson;
+/**
+ * Writes the provided `PackageJson` object to the `package.json` file in the specified folder or in the root.
+ *
+ * @param packageJson - The `PackageJson` object to write.
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns A {@link Promise} that resolves when the file has been written.
+ */
+export declare function writePackageJson(packageJson: PackageJson, cwd?: string): Promise<void>;
+/**
+ * Writes the provided `PackageJson` object to the `package.json` file in the specified folder or in the root.
+ *
+ * @param packageJson - The `PackageJson` object to write.
+ * @param cwd - The current working folder where `package.json` is located.
+ */
+export declare function writePackageJsonSync(packageJson: PackageJson, cwd?: string): void;
+/**
+ * Writes the provided `PackageJson` object to the `package-lock.json` file in the specified folder or in the root.
+ *
+ * @param packageLockJson - The `PackageLockJson` object to write.
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns A {@link Promise} that resolves when the file has been written.
+ */
+export declare function writePackageLockJson(packageLockJson: PackageLockJson, cwd?: string): Promise<void>;
+/**
+ * Writes the provided `PackageLockJson` object to the `package-lock.json` file in the specified folder or in the root.
+ *
+ * @param packageLockJson - The `PackageLockJson` object to write.
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ */
+export declare function writePackageLockJsonSync(packageLockJson: PackageLockJson, cwd?: string): void;
+export type { PackageJson };