@botpress/cli 2.1.1 → 2.1.2

package/dist/linter/spectral-functions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/linter/spectral-functions.ts"],
+  "sourcesContent": ["import { RulesetFunctionContext } from '@stoplight/spectral-core'\n\ntype MessageFn = ({ path }: { path: (string | number)[] }) => string\n\n/**\n * When the input is falsy, return a message that is generated by the provided function\n */\nexport const truthyWithMessage = (fn: MessageFn) => (input: string, _: unknown, context: RulesetFunctionContext) => {\n  const messages = []\n\n  if (!input) {\n    const message = fn({ path: context.path })\n    messages.push({ message })\n  }\n\n  return messages\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,MAAM,oBAAoB,CAAC,OAAkB,CAAC,OAAe,GAAY,YAAoC;AAClH,QAAM,WAAW,CAAC;AAElB,MAAI,CAAC,OAAO;AACV,UAAM,UAAU,GAAG,EAAE,MAAM,QAAQ,KAAK,CAAC;AACzC,aAAS,KAAK,EAAE,QAAQ,CAAC;AAAA,EAC3B;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/logger/base-logger.js

@@ -0,0 +1,170 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_logger_exports = {};
+__export(base_logger_exports, {
+  BaseLogger: () => BaseLogger
+});
+module.exports = __toCommonJS(base_logger_exports);
+var import_boxen = __toESM(require("boxen"));
+var import_chalk = __toESM(require("chalk"));
+var import_lodash = __toESM(require("lodash"));
+var import_util = __toESM(require("util"));
+var utils = __toESM(require("../utils"));
+const STDOUT_CHUNK_SIZE = 100;
+const DEFAULT_OPTIONS = { verbose: false };
+const NO_COLOR = (str) => str;
+const PINK = [255, 100, 255];
+const ORANGE = [255, 165, 0];
+const PURPLE = [128, 0, 128];
+const BG_COLORS = {
+  blue: import_chalk.default.bgBlueBright,
+  green: import_chalk.default.bgGreenBright,
+  yellow: import_chalk.default.bgYellowBright,
+  red: import_chalk.default.bgRedBright,
+  white: import_chalk.default.bgWhite,
+  pink: (str) => import_chalk.default.bgRgb(...PINK)(str),
+  orange: (str) => import_chalk.default.bgRgb(...ORANGE)(str),
+  purple: (str) => import_chalk.default.bgRgb(...PURPLE)(str)
+};
+const FG_COLORS = {
+  blue: import_chalk.default.blueBright,
+  green: import_chalk.default.green,
+  yellow: import_chalk.default.yellowBright,
+  red: import_chalk.default.red,
+  white: import_chalk.default.white,
+  pink: (str) => import_chalk.default.rgb(...PINK)(str),
+  orange: (str) => import_chalk.default.rgb(...ORANGE)(str),
+  purple: (str) => import_chalk.default.rgb(...PURPLE)(str)
+};
+const checkmark = {
+  default: "\u2713",
+  windows: "\u221A",
+  mac: "\u2714"
+};
+const cross = {
+  default: "\xD7",
+  mac: "\u2716"
+};
+const danger = { default: "\u26A0" };
+const circle = { default: "\u25CB" };
+const disc = { default: "\u25CF" };
+const space = { default: " " };
+const renderers = {
+  "\u2713": checkmark,
+  "\xD7": cross,
+  "\u26A0": danger,
+  "\u25CB": circle,
+  "\u25CF": disc,
+  " ": space
+};
+const BOX_OPTIONS = {
+  padding: 1,
+  margin: 1,
+  borderStyle: "round",
+  borderColor: "yellow"
+};
+class BaseLogger {
+  opts;
+  constructor(opts = {}) {
+    this.opts = { ...DEFAULT_OPTIONS, ...opts };
+  }
+  log(message, props = {}) {
+    if (this.opts.json && !props.stderr) {
+      return;
+    }
+    const prefix = this._resolvePrefix(props.prefix);
+    this.print(message, { ...props, prefix });
+  }
+  json(data, opts = { depth: Infinity }) {
+    if (this.opts.json) {
+      this.print(JSON.stringify(data, void 0, 2));
+      return;
+    }
+    const { depth } = opts;
+    const msg = import_util.default.inspect(data, { colors: true, depth });
+    this.log(msg);
+  }
+  debug(message) {
+    if (!this.opts.verbose) {
+      return;
+    }
+    this.log(import_chalk.default.grey(message), { prefix: { symbol: "\u25CF", fg: "blue" } });
+  }
+  started(message) {
+    this.log(message, { prefix: { symbol: "\u25CB", fg: "purple" } });
+  }
+  success(message) {
+    this.log(message, { prefix: { symbol: "\u2713", fg: "green" } });
+  }
+  warn(message) {
+    this.log(message, { prefix: { symbol: "\u26A0", fg: "yellow" } });
+  }
+  error(message) {
+    this.log(message, { prefix: { symbol: "\xD7", fg: "red" }, stderr: true });
+  }
+  box(message) {
+    const box = (0, import_boxen.default)(message, BOX_OPTIONS);
+    this.log(box);
+  }
+  _resolvePrefix(prefix) {
+    if (!prefix) {
+      return;
+    }
+    if (import_lodash.default.isString(prefix)) {
+      return prefix;
+    }
+    const { symbol, fg, bg, indent } = prefix;
+    const renderedSymbol = this._renderSymbol(symbol);
+    const fgcolor = fg ? FG_COLORS[fg] : NO_COLOR;
+    const bgcolor = bg ? BG_COLORS[bg] : NO_COLOR;
+    const indentStr = indent ? " ".repeat(indent) : "";
+    const symbolStr = fgcolor(bgcolor(renderedSymbol));
+    return `${indentStr}${symbolStr}`;
+  }
+  _renderSymbol(symbol) {
+    const renderer = renderers[symbol];
+    if (process.platform === "win32") {
+      return renderer.windows || renderer.default;
+    } else if (process.platform === "darwin") {
+      return renderer.mac || renderer.default;
+    } else {
+      return renderer.default;
+    }
+  }
+  render(message, stream = process.stdout) {
+    for (const chunk of utils.string.chunkString(message, STDOUT_CHUNK_SIZE)) {
+      stream.write(chunk);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseLogger
+});
+//# sourceMappingURL=base-logger.js.map

package/dist/logger/base-logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/logger/base-logger.ts"],
+  "sourcesContent": ["import boxen from 'boxen'\nimport chalk from 'chalk'\nimport _ from 'lodash'\nimport util from 'util'\nimport * as utils from '../utils'\n\nexport type LoggerOptions = {\n  verbose: boolean\n  json?: boolean // prevents loggin anything else than json\n}\n\nconst STDOUT_CHUNK_SIZE = 100\nconst DEFAULT_OPTIONS: LoggerOptions = { verbose: false }\n\ntype ChalkColor = (str: string) => string\nconst NO_COLOR: ChalkColor = (str: string) => str\n\nconst PINK = [255, 100, 255] as const\nconst ORANGE = [255, 165, 0] as const\nconst PURPLE = [128, 0, 128] as const\n\nconst BG_COLORS: Record<Color, ChalkColor> = {\n  blue: chalk.bgBlueBright,\n  green: chalk.bgGreenBright,\n  yellow: chalk.bgYellowBright,\n  red: chalk.bgRedBright,\n  white: chalk.bgWhite,\n  pink: (str: string) => chalk.bgRgb(...PINK)(str),\n  orange: (str: string) => chalk.bgRgb(...ORANGE)(str),\n  purple: (str: string) => chalk.bgRgb(...PURPLE)(str),\n}\n\nconst FG_COLORS: Record<Color, ChalkColor> = {\n  blue: chalk.blueBright,\n  green: chalk.green,\n  yellow: chalk.yellowBright,\n  red: chalk.red,\n  white: chalk.white,\n  pink: (str: string) => chalk.rgb(...PINK)(str),\n  orange: (str: string) => chalk.rgb(...ORANGE)(str),\n  purple: (str: string) => chalk.rgb(...PURPLE)(str),\n}\n\ntype Symbol = '\u2713' | '\u26A0' | '\u00D7' | '\u25CF' | ' ' | '\u25CB'\ntype Color = 'blue' | 'green' | 'yellow' | 'red' | 'pink' | 'white' | 'orange' | 'purple'\ntype LogPrefix = { symbol: Symbol; fg?: Color; bg?: Color; indent?: number } | string\ntype SymbolRenderer<T extends Symbol> = { default: T; windows?: string; mac?: string }\n\ntype LogProps = {\n  prefix: LogPrefix\n  stderr?: boolean\n}\n\ntype PrintProps = {\n  metadata: any\n  prefix: string\n  stderr?: boolean\n}\n\nconst checkmark: SymbolRenderer<'\u2713'> = {\n  default: '\u2713',\n  windows: '\u221A',\n  mac: '\u2714',\n}\n\nconst cross: SymbolRenderer<'\u00D7'> = {\n  default: '\u00D7',\n  mac: '\u2716',\n}\n\nconst danger: SymbolRenderer<'\u26A0'> = { default: '\u26A0' }\nconst circle: SymbolRenderer<'\u25CB'> = { default: '\u25CB' }\nconst disc: SymbolRenderer<'\u25CF'> = { default: '\u25CF' }\nconst space: SymbolRenderer<' '> = { default: ' ' }\n\nconst renderers: Record<Symbol, SymbolRenderer<Symbol>> = {\n  '\u2713': checkmark,\n  '\u00D7': cross,\n  '\u26A0': danger,\n  '\u25CB': circle,\n  '\u25CF': disc,\n  ' ': space,\n}\n\nconst BOX_OPTIONS: boxen.Options = {\n  padding: 1,\n  margin: 1,\n  borderStyle: 'round',\n  borderColor: 'yellow',\n}\n\nexport abstract class BaseLogger {\n  protected opts: LoggerOptions\n\n  public constructor(opts: Partial<LoggerOptions> = {}) {\n    this.opts = { ...DEFAULT_OPTIONS, ...opts }\n  }\n\n  public log(message: string, props: Partial<LogProps> = {}): void {\n    if (this.opts.json && !props.stderr) {\n      return\n    }\n\n    const prefix = this._resolvePrefix(props.prefix)\n    this.print(message, { ...props, prefix })\n  }\n\n  public json(data: any, opts: Partial<{ depth: number }> = { depth: Infinity }): void {\n    if (this.opts.json) {\n      this.print(JSON.stringify(data, undefined, 2))\n      return\n    }\n\n    const { depth } = opts\n    const msg = util.inspect(data, { colors: true, depth })\n    this.log(msg)\n  }\n\n  public debug(message: string): void {\n    if (!this.opts.verbose) {\n      return\n    }\n    this.log(chalk.grey(message), { prefix: { symbol: '\u25CF', fg: 'blue' } })\n  }\n\n  public started(message: string): void {\n    this.log(message, { prefix: { symbol: '\u25CB', fg: 'purple' } })\n  }\n\n  public success(message: string): void {\n    this.log(message, { prefix: { symbol: '\u2713', fg: 'green' } })\n  }\n\n  public warn(message: string): void {\n    this.log(message, { prefix: { symbol: '\u26A0', fg: 'yellow' } })\n  }\n\n  public error(message: string): void {\n    this.log(message, { prefix: { symbol: '\u00D7', fg: 'red' }, stderr: true })\n  }\n\n  public box(message: string): void {\n    const box = boxen(message, BOX_OPTIONS)\n    this.log(box)\n  }\n\n  protected abstract print(message: string, props?: Partial<PrintProps>): void\n\n  private _resolvePrefix(prefix: LogPrefix | undefined): string | undefined {\n    if (!prefix) {\n      return\n    }\n\n    if (_.isString(prefix)) {\n      return prefix\n    }\n\n    const { symbol, fg, bg, indent } = prefix\n    const renderedSymbol = this._renderSymbol(symbol)\n    const fgcolor = fg ? FG_COLORS[fg] : NO_COLOR\n    const bgcolor = bg ? BG_COLORS[bg] : NO_COLOR\n    const indentStr = indent ? ' '.repeat(indent) : ''\n    const symbolStr = fgcolor(bgcolor(renderedSymbol))\n    return `${indentStr}${symbolStr}`\n  }\n\n  private _renderSymbol(symbol: Symbol): string {\n    const renderer = renderers[symbol]\n    if (process.platform === 'win32') {\n      return renderer.windows || renderer.default\n    } else if (process.platform === 'darwin') {\n      return renderer.mac || renderer.default\n    } else {\n      return renderer.default\n    }\n  }\n\n  protected render(message: string, stream: NodeJS.WriteStream = process.stdout): void {\n    // chunking the message ensures that the process won't exit before the message is fully written\n    for (const chunk of utils.string.chunkString(message, STDOUT_CHUNK_SIZE)) {\n      stream.write(chunk)\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["chalk", "util", "boxen", "_"]
+}

package/dist/logger/index.js

@@ -0,0 +1,86 @@
+"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 logger_exports = {};
+__export(logger_exports, {
+  Logger: () => Logger,
+  SingleLineLogger: () => SingleLineLogger
+});
+module.exports = __toCommonJS(logger_exports);
+var import_readline = require("readline");
+var import_base_logger = require("./base-logger");
+class Logger extends import_base_logger.BaseLogger {
+  static _previousLine;
+  // this is global to the whole process
+  print(message, props = {}) {
+    this.cleanup();
+    const stream = props.stderr ? process.stderr : process.stdout;
+    const { prefix } = props;
+    if (prefix) {
+      this.render(`${prefix} ${message}
+`, stream);
+      return;
+    }
+    this.render(`${message}
+`, stream);
+  }
+  line() {
+    this.cleanup();
+    const currentLine = new SingleLineLogger({ ...this.opts });
+    Logger._previousLine = currentLine;
+    return currentLine;
+  }
+  cleanup() {
+    if (Logger._previousLine) {
+      Logger._previousLine.commit();
+      Logger._previousLine = void 0;
+    }
+  }
+}
+class SingleLineLogger extends import_base_logger.BaseLogger {
+  _commited = false;
+  constructor(opts) {
+    super(opts);
+  }
+  commit() {
+    if (this._commited) {
+      return;
+    }
+    this._commited = true;
+    console.log();
+  }
+  print(message, props = {}) {
+    if (this._commited) {
+      return;
+    }
+    (0, import_readline.clearLine)(process.stdout, 0);
+    const { prefix } = props;
+    (0, import_readline.cursorTo)(process.stdout, 0);
+    if (prefix) {
+      this.render(`${prefix} ${message}`);
+      return;
+    }
+    this.render(message);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Logger,
+  SingleLineLogger
+});
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/logger/index.ts"],
+  "sourcesContent": ["/* eslint-disable no-console */\nimport { cursorTo, clearLine } from 'readline'\nimport { BaseLogger, LoggerOptions } from './base-logger'\n\nexport class Logger extends BaseLogger {\n  private static _previousLine: SingleLineLogger | undefined // this is global to the whole process\n\n  protected print(message: string, props: Partial<{ prefix: string; stderr?: boolean }> = {}): void {\n    this.cleanup()\n    const stream = props.stderr ? process.stderr : process.stdout\n    const { prefix } = props\n    if (prefix) {\n      this.render(`${prefix} ${message}\\n`, stream)\n      return\n    }\n    this.render(`${message}\\n`, stream)\n  }\n\n  public line(): SingleLineLogger {\n    this.cleanup()\n    const currentLine = new SingleLineLogger({ ...this.opts })\n    Logger._previousLine = currentLine\n    return currentLine\n  }\n\n  public cleanup(): void {\n    if (Logger._previousLine) {\n      Logger._previousLine.commit()\n      Logger._previousLine = undefined\n    }\n  }\n}\n\nexport class SingleLineLogger extends BaseLogger {\n  private _commited = false\n\n  public constructor(opts: LoggerOptions) {\n    super(opts)\n  }\n\n  public commit(): void {\n    if (this._commited) {\n      return\n    }\n    this._commited = true\n    console.log()\n  }\n\n  protected print(message: string, props: Partial<{ prefix: string }> = {}): void {\n    if (this._commited) {\n      return\n    }\n\n    clearLine(process.stdout, 0)\n    const { prefix } = props\n    cursorTo(process.stdout, 0)\n    if (prefix) {\n      this.render(`${prefix} ${message}`)\n      return\n    }\n    this.render(message)\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,sBAAoC;AACpC,yBAA0C;AAEnC,MAAM,eAAe,8BAAW;AAAA,EACrC,OAAe;AAAA;AAAA,EAEL,MAAM,SAAiB,QAAuD,CAAC,GAAS;AAChG,SAAK,QAAQ;AACb,UAAM,SAAS,MAAM,SAAS,QAAQ,SAAS,QAAQ;AACvD,UAAM,EAAE,OAAO,IAAI;AACnB,QAAI,QAAQ;AACV,WAAK,OAAO,GAAG,UAAU;AAAA,GAAa,MAAM;AAC5C;AAAA,IACF;AACA,SAAK,OAAO,GAAG;AAAA,GAAa,MAAM;AAAA,EACpC;AAAA,EAEO,OAAyB;AAC9B,SAAK,QAAQ;AACb,UAAM,cAAc,IAAI,iBAAiB,EAAE,GAAG,KAAK,KAAK,CAAC;AACzD,WAAO,gBAAgB;AACvB,WAAO;AAAA,EACT;AAAA,EAEO,UAAgB;AACrB,QAAI,OAAO,eAAe;AACxB,aAAO,cAAc,OAAO;AAC5B,aAAO,gBAAgB;AAAA,IACzB;AAAA,EACF;AACF;AAEO,MAAM,yBAAyB,8BAAW;AAAA,EACvC,YAAY;AAAA,EAEb,YAAY,MAAqB;AACtC,UAAM,IAAI;AAAA,EACZ;AAAA,EAEO,SAAe;AACpB,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AACA,SAAK,YAAY;AACjB,YAAQ,IAAI;AAAA,EACd;AAAA,EAEU,MAAM,SAAiB,QAAqC,CAAC,GAAS;AAC9E,QAAI,KAAK,WAAW;AAClB;AAAA,IACF;AAEA,mCAAU,QAAQ,QAAQ,CAAC;AAC3B,UAAM,EAAE,OAAO,IAAI;AACnB,kCAAS,QAAQ,QAAQ,CAAC;AAC1B,QAAI,QAAQ;AACV,WAAK,OAAO,GAAG,UAAU,SAAS;AAClC;AAAA,IACF;AACA,SAAK,OAAO,OAAO;AAAA,EACrB;AACF;",
+  "names": []
+}

package/dist/package-ref.js

@@ -0,0 +1,107 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var package_ref_exports = {};
+__export(package_ref_exports, {
+  formatPackageRef: () => formatPackageRef,
+  isLatest: () => isLatest,
+  parsePackageRef: () => parsePackageRef
+});
+module.exports = __toCommonJS(package_ref_exports);
+var import_semver = __toESM(require("semver"));
+var utils = __toESM(require("./utils"));
+const packageTypes = {
+  integration: null,
+  interface: null,
+  plugin: null
+};
+const isPackageType = (type) => type in packageTypes;
+const LATEST_TAG = "latest";
+const isLatest = (ref) => ref.version === LATEST_TAG;
+const formatPackageRef = (ref) => {
+  if (ref.type === "path") {
+    return ref.path;
+  }
+  if (ref.type === "id") {
+    return ref.id;
+  }
+  if (ref.pkg) {
+    return `${ref.pkg}:${ref.name}@${ref.version}`;
+  }
+  return `${ref.name}@${ref.version}`;
+};
+const parsePackageRef = (ref) => {
+  if (!ref) {
+    return;
+  }
+  if (utils.id.isValidID(ref)) {
+    return { type: "id", id: ref };
+  }
+  if (utils.path.isPath(ref)) {
+    return { type: "path", path: ref };
+  }
+  return parseNamePackageRef(ref);
+};
+const parseNamePackageRef = (ref) => {
+  if (!ref) {
+    return;
+  }
+  if (ref.includes(":")) {
+    const [pkg, nameVersion] = ref.split(":");
+    if (!pkg || !nameVersion) {
+      return;
+    }
+    if (!isPackageType(pkg)) {
+      return;
+    }
+    const parsed = parseNamePackageRef(nameVersion);
+    if (!parsed) {
+      return;
+    }
+    return { ...parsed, pkg };
+  }
+  if (!ref.includes("@")) {
+    return { type: "name", name: ref, version: LATEST_TAG };
+  }
+  const [name, version] = ref.split("@");
+  if (!name || !version) {
+    return;
+  }
+  const cleanedVersion = version === LATEST_TAG ? version : import_semver.default.clean(version);
+  if (!cleanedVersion) {
+    return;
+  }
+  return { type: "name", name, version: cleanedVersion };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatPackageRef,
+  isLatest,
+  parsePackageRef
+});
+//# sourceMappingURL=package-ref.js.map

package/dist/package-ref.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/package-ref.ts"],
+  "sourcesContent": ["import * as sdk from '@botpress/sdk'\nimport semver from 'semver'\nimport * as utils from './utils'\n\ntype PackageType = sdk.Package['type']\nconst packageTypes: Record<PackageType, null> = {\n  integration: null,\n  interface: null,\n  plugin: null,\n}\nconst isPackageType = (type: string): type is PackageType => type in packageTypes\n\nexport type UUIDPackageRef = {\n  type: 'id'\n  id: string\n}\n\nexport type NamePackageRef = {\n  type: 'name'\n  pkg?: PackageType\n  name: string\n  version: string\n}\n\nexport type LocalPackageRef = {\n  type: 'path'\n  path: string\n}\n\nexport type ApiPackageRef = UUIDPackageRef | NamePackageRef\nexport type PackageRef = ApiPackageRef | LocalPackageRef\n\nconst LATEST_TAG = 'latest'\n\nexport const isLatest = (ref: NamePackageRef): boolean => ref.version === LATEST_TAG\n\nexport const formatPackageRef = (ref: PackageRef): string => {\n  if (ref.type === 'path') {\n    return ref.path\n  }\n  if (ref.type === 'id') {\n    return ref.id\n  }\n  if (ref.pkg) {\n    return `${ref.pkg}:${ref.name}@${ref.version}`\n  }\n  return `${ref.name}@${ref.version}`\n}\n\nexport const parsePackageRef = (ref: string): PackageRef | undefined => {\n  if (!ref) {\n    return\n  }\n\n  if (utils.id.isValidID(ref)) {\n    return { type: 'id', id: ref }\n  }\n\n  if (utils.path.isPath(ref)) {\n    return { type: 'path', path: ref }\n  }\n\n  return parseNamePackageRef(ref)\n}\n\nconst parseNamePackageRef = (ref: string): NamePackageRef | undefined => {\n  if (!ref) {\n    return\n  }\n\n  if (ref.includes(':')) {\n    const [pkg, nameVersion] = ref.split(':')\n    if (!pkg || !nameVersion) {\n      return\n    }\n    if (!isPackageType(pkg)) {\n      return\n    }\n    const parsed = parseNamePackageRef(nameVersion)\n    if (!parsed) {\n      return\n    }\n    return { ...parsed, pkg }\n  }\n\n  if (!ref.includes('@')) {\n    return { type: 'name', name: ref, version: LATEST_TAG }\n  }\n\n  const [name, version] = ref.split('@')\n  if (!name || !version) {\n    return\n  }\n\n  const cleanedVersion = version === LATEST_TAG ? version : semver.clean(version)\n  if (!cleanedVersion) {\n    return\n  }\n\n  return { type: 'name', name, version: cleanedVersion }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,oBAAmB;AACnB,YAAuB;AAGvB,MAAM,eAA0C;AAAA,EAC9C,aAAa;AAAA,EACb,WAAW;AAAA,EACX,QAAQ;AACV;AACA,MAAM,gBAAgB,CAAC,SAAsC,QAAQ;AAsBrE,MAAM,aAAa;AAEZ,MAAM,WAAW,CAAC,QAAiC,IAAI,YAAY;AAEnE,MAAM,mBAAmB,CAAC,QAA4B;AAC3D,MAAI,IAAI,SAAS,QAAQ;AACvB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,IAAI,SAAS,MAAM;AACrB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,IAAI,KAAK;AACX,WAAO,GAAG,IAAI,OAAO,IAAI,QAAQ,IAAI;AAAA,EACvC;AACA,SAAO,GAAG,IAAI,QAAQ,IAAI;AAC5B;AAEO,MAAM,kBAAkB,CAAC,QAAwC;AACtE,MAAI,CAAC,KAAK;AACR;AAAA,EACF;AAEA,MAAI,MAAM,GAAG,UAAU,GAAG,GAAG;AAC3B,WAAO,EAAE,MAAM,MAAM,IAAI,IAAI;AAAA,EAC/B;AAEA,MAAI,MAAM,KAAK,OAAO,GAAG,GAAG;AAC1B,WAAO,EAAE,MAAM,QAAQ,MAAM,IAAI;AAAA,EACnC;AAEA,SAAO,oBAAoB,GAAG;AAChC;AAEA,MAAM,sBAAsB,CAAC,QAA4C;AACvE,MAAI,CAAC,KAAK;AACR;AAAA,EACF;AAEA,MAAI,IAAI,SAAS,GAAG,GAAG;AACrB,UAAM,CAAC,KAAK,WAAW,IAAI,IAAI,MAAM,GAAG;AACxC,QAAI,CAAC,OAAO,CAAC,aAAa;AACxB;AAAA,IACF;AACA,QAAI,CAAC,cAAc,GAAG,GAAG;AACvB;AAAA,IACF;AACA,UAAM,SAAS,oBAAoB,WAAW;AAC9C,QAAI,CAAC,QAAQ;AACX;AAAA,IACF;AACA,WAAO,EAAE,GAAG,QAAQ,IAAI;AAAA,EAC1B;AAEA,MAAI,CAAC,IAAI,SAAS,GAAG,GAAG;AACtB,WAAO,EAAE,MAAM,QAAQ,MAAM,KAAK,SAAS,WAAW;AAAA,EACxD;AAEA,QAAM,CAAC,MAAM,OAAO,IAAI,IAAI,MAAM,GAAG;AACrC,MAAI,CAAC,QAAQ,CAAC,SAAS;AACrB;AAAA,EACF;AAEA,QAAM,iBAAiB,YAAY,aAAa,UAAU,cAAAA,QAAO,MAAM,OAAO;AAC9E,MAAI,CAAC,gBAAgB;AACnB;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,QAAQ,MAAM,SAAS,eAAe;AACvD;",
+  "names": ["semver"]
+}

package/dist/package-ref.test.js

@@ -0,0 +1,109 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_package_ref = require("./package-ref");
+const path = "/my/path";
+const prefixedUlid = "intver_01HF58RDKE3M7K5RJ5XZ7GF6HE";
+const uuid = "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11";
+const name = "myintegration";
+(0, import_vitest.describe)("parsePackageRef", () => {
+  (0, import_vitest.test)("parse empty string should return undefined", () => {
+    const ref = "";
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    (0, import_vitest.expect)(result).toBeUndefined();
+  });
+  (0, import_vitest.test)("parse with invalid version should return undefined", () => {
+    const ref0 = `${name}@lol`;
+    const ref1 = `${name}@1`;
+    const ref2 = `${name}@1.0`;
+    const result0 = (0, import_package_ref.parsePackageRef)(ref0);
+    const result1 = (0, import_package_ref.parsePackageRef)(ref1);
+    const result2 = (0, import_package_ref.parsePackageRef)(ref2);
+    (0, import_vitest.expect)(result0).toBeUndefined();
+    (0, import_vitest.expect)(result1).toBeUndefined();
+    (0, import_vitest.expect)(result2).toBeUndefined();
+  });
+  (0, import_vitest.test)("parse with an absolute path should return path", () => {
+    const ref = path;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "path", path: ref };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a prefixed ULID sets `id` type", () => {
+    const ref = prefixedUlid;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "id", id: ref };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a legacy UUID sets `id` type", () => {
+    const ref = uuid;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "id", id: ref };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a name and version should return name and version", () => {
+    const version = "1.0.0";
+    const ref = `${name}@${version}`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "name", name, version };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a name and latest should return name and latest", () => {
+    const version = "latest";
+    const ref = `${name}@${version}`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "name", name, version };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with only a name should return name and latest", () => {
+    const ref = name;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "name", name, version: "latest" };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a package type and a name should return the pkg, name and latest", () => {
+    const ref = `integration:${name}`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "name", name, version: "latest", pkg: "integration" };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a package type, a name and a version should return all", () => {
+    const ref = `integration:${name}@1.0.0`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    const expected = { type: "name", name, version: "1.0.0", pkg: "integration" };
+    (0, import_vitest.expect)(result).toEqual(expected);
+  });
+  (0, import_vitest.test)("parse with a package type and a version should return undefined", () => {
+    const ref = `plugin:@1.0.0`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    (0, import_vitest.expect)(result).toBeUndefined();
+  });
+  (0, import_vitest.test)("parse with an invalid package type should return undefined", () => {
+    const ref = `bot:${name}@1.0.0`;
+    const result = (0, import_package_ref.parsePackageRef)(ref);
+    (0, import_vitest.expect)(result).toBeUndefined();
+  });
+});
+(0, import_vitest.describe)("formatPackageRef", () => {
+  (0, import_vitest.test)("format with a path should return path", () => {
+    const ref = { type: "path", path };
+    const result = (0, import_package_ref.formatPackageRef)(ref);
+    (0, import_vitest.expect)(result).toEqual(ref.path);
+  });
+  (0, import_vitest.test)("format with a prefixed ULID uses `id` type", () => {
+    const ref = { type: "id", id: prefixedUlid };
+    const result = (0, import_package_ref.formatPackageRef)(ref);
+    (0, import_vitest.expect)(result).toEqual(ref.id);
+  });
+  (0, import_vitest.test)("format with a legacy UUID uses `id` type", () => {
+    const ref = { type: "id", id: uuid };
+    const result = (0, import_package_ref.formatPackageRef)(ref);
+    (0, import_vitest.expect)(result).toEqual(ref.id);
+  });
+  (0, import_vitest.test)("format with a name and version should return name and version", () => {
+    const version = "1.0.0";
+    const ref = { type: "name", name, version };
+    const result = (0, import_package_ref.formatPackageRef)(ref);
+    (0, import_vitest.expect)(result).toEqual(`${name}@${version}`);
+  });
+});
+//# sourceMappingURL=package-ref.test.js.map

package/dist/package-ref.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/package-ref.test.ts"],
+  "sourcesContent": ["import { test, expect, describe } from 'vitest'\nimport { formatPackageRef, PackageRef, parsePackageRef } from './package-ref'\n\nconst path = '/my/path'\nconst prefixedUlid = 'intver_01HF58RDKE3M7K5RJ5XZ7GF6HE'\nconst uuid = 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'\nconst name = 'myintegration'\n\ndescribe('parsePackageRef', () => {\n  test('parse empty string should return undefined', () => {\n    // arrange\n    const ref = ''\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    expect(result).toBeUndefined()\n  })\n\n  test('parse with invalid version should return undefined', () => {\n    // arrange\n    const ref0 = `${name}@lol`\n    const ref1 = `${name}@1`\n    const ref2 = `${name}@1.0`\n    // act\n    const result0 = parsePackageRef(ref0)\n    const result1 = parsePackageRef(ref1)\n    const result2 = parsePackageRef(ref2)\n    // assert\n    expect(result0).toBeUndefined()\n    expect(result1).toBeUndefined()\n    expect(result2).toBeUndefined()\n  })\n\n  test('parse with an absolute path should return path', () => {\n    // arrange\n    const ref = path\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'path', path: ref }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a prefixed ULID sets `id` type', () => {\n    // arrange\n    const ref = prefixedUlid\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'id', id: ref }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a legacy UUID sets `id` type', () => {\n    // arrange\n    const ref = uuid\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'id', id: ref }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a name and version should return name and version', () => {\n    // arrange\n    const version = '1.0.0'\n    const ref = `${name}@${version}`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'name', name, version }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a name and latest should return name and latest', () => {\n    // arrange\n    const version = 'latest'\n    const ref = `${name}@${version}`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'name', name, version }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with only a name should return name and latest', () => {\n    // arrange\n    const ref = name\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'name', name, version: 'latest' }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a package type and a name should return the pkg, name and latest', () => {\n    // arrange\n    const ref = `integration:${name}`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'name', name, version: 'latest', pkg: 'integration' }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a package type, a name and a version should return all', () => {\n    // arrange\n    const ref = `integration:${name}@1.0.0`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    const expected: PackageRef = { type: 'name', name, version: '1.0.0', pkg: 'integration' }\n    expect(result).toEqual(expected)\n  })\n\n  test('parse with a package type and a version should return undefined', () => {\n    // arrange\n    const ref = `plugin:@1.0.0`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    expect(result).toBeUndefined()\n  })\n\n  test('parse with an invalid package type should return undefined', () => {\n    // arrange\n    const ref = `bot:${name}@1.0.0`\n    // act\n    const result = parsePackageRef(ref)\n    // assert\n    expect(result).toBeUndefined()\n  })\n})\n\ndescribe('formatPackageRef', () => {\n  test('format with a path should return path', () => {\n    // arrange\n    const ref: PackageRef = { type: 'path', path }\n    // act\n    const result = formatPackageRef(ref)\n    // assert\n    expect(result).toEqual(ref.path)\n  })\n\n  test('format with a prefixed ULID uses `id` type', () => {\n    // arrange\n    const ref: PackageRef = { type: 'id', id: prefixedUlid }\n    // act\n    const result = formatPackageRef(ref)\n    // assert\n    expect(result).toEqual(ref.id)\n  })\n\n  test('format with a legacy UUID uses `id` type', () => {\n    // arrange\n    const ref: PackageRef = { type: 'id', id: uuid }\n    // act\n    const result = formatPackageRef(ref)\n    // assert\n    expect(result).toEqual(ref.id)\n  })\n\n  test('format with a name and version should return name and version', () => {\n    // arrange\n    const version = '1.0.0'\n    const ref: PackageRef = { type: 'name', name, version }\n    // act\n    const result = formatPackageRef(ref)\n    // assert\n    expect(result).toEqual(`${name}@${version}`)\n  })\n})\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/register-yargs.js

@@ -0,0 +1,91 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var register_yargs_exports = {};
+__export(register_yargs_exports, {
+  registerYargs: () => registerYargs
+});
+module.exports = __toCommonJS(register_yargs_exports);
+var import_yargs_extra = require("@bpinternal/yargs-extra");
+var import_lodash = __toESM(require("lodash"));
+var tree = __toESM(require("./command-tree"));
+const parseArguments = (schema, argv) => {
+  const yargsEnv = (0, import_yargs_extra.parseEnv)(schema, "BP");
+  return (0, import_yargs_extra.cleanupConfig)(schema, { ...argv, ...yargsEnv });
+};
+const registerYargs = (yargz, commands) => {
+  for (const cmdName in commands) {
+    const command = commands[cmdName];
+    if (tree.guards.command.isSubTree(command)) {
+      yargz.command(cmdName, command.description ?? cmdName, (y) => {
+        registerYargs(y, command.subcommands);
+        return y;
+      });
+      continue;
+    }
+    const { schema, description, alias } = command;
+    const aliases = alias ? [cmdName, alias] : [cmdName];
+    const options = Object.entries(schema);
+    let positionals = options.filter(
+      (value) => !!value[1].positional
+    );
+    let usage = aliases;
+    if (positionals.length) {
+      positionals = import_lodash.default.sortBy(positionals, ([, option]) => option.idx);
+      const positionalArgs = positionals.map(
+        ([optName, option]) => option.demandOption ? `<${optName}>` : `[${optName}]`
+      );
+      const positionalStr = positionalArgs.join(" ");
+      usage = aliases.map((optAlias) => `${optAlias} ${positionalStr}`);
+    }
+    yargz.command(
+      usage,
+      description ?? cmdName,
+      (y) => {
+        for (const [key, option] of Object.entries(schema)) {
+          if (option.positional) {
+            y = y.positional(key, option);
+          } else {
+            y = y.option(key, option);
+          }
+        }
+        return y;
+      },
+      async (argv) => {
+        const parsed = parseArguments(schema, argv);
+        const { exitCode } = await command.handler({ ...parsed });
+        process.exit(exitCode);
+      }
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerYargs
+});
+//# sourceMappingURL=register-yargs.js.map