@botpress/cli 0.0.9 → 0.0.10

package/dist/command-tree.js

@@ -0,0 +1,59 @@
+"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 command_tree_exports = {};
+__export(command_tree_exports, {
+  guards: () => guards,
+  zipTree: () => zipTree
+});
+module.exports = __toCommonJS(command_tree_exports);
+const guards = {
+  definition: {
+    isDef: (x) => "schema" in x,
+    isSubTree: (x) => "subcommands" in x
+  },
+  implementation: {
+    isImpl: (x) => typeof x === "function",
+    isSubTree: (x) => typeof x === "object"
+  },
+  command: {
+    isLeaf: (x) => "handler" in x,
+    isSubTree: (x) => "subcommands" in x
+  }
+};
+const zipTree = (defTree, implTree) => {
+  const tree = {};
+  for (const key in defTree) {
+    const def = defTree[key];
+    const impl = implTree[key];
+    if (guards.definition.isDef(def) && guards.implementation.isImpl(impl)) {
+      tree[key] = { ...def, handler: impl };
+      continue;
+    }
+    if (guards.definition.isSubTree(def) && guards.implementation.isSubTree(impl)) {
+      tree[key] = { ...def, subcommands: zipTree(def.subcommands, impl.subcommands) };
+      continue;
+    }
+  }
+  return tree;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  guards,
+  zipTree
+});

package/dist/config.js

@@ -6,8 +6,8 @@ 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 });
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -35,6 +35,7 @@ __export(config_exports, {
   devSchema: () => devSchema,
   generateSchema: () => generateSchema,
   globalSchema: () => globalSchema,
+  initSchema: () => initSchema,
   integrationRef: () => integrationRef,
   listBotsSchema: () => listBotsSchema,
   listIntegrationsSchema: () => listIntegrationsSchema,
@@ -120,6 +121,14 @@ const workspaceId = {
   type: "string",
   description: "The Workspace Id to deploy to"
 };
+const type = {
+  type: "string",
+  choices: ["bot", "integration"]
+};
+const name = {
+  type: "string",
+  description: "The name of the project"
+};
 const botRef = {
   type: "string",
   description: "The bot ID. Bot Name is not supported.",
@@ -218,6 +227,12 @@ const deleteIntegrationSchema = {
   ...globalSchema,
   ...loggedInSchema
 };
+const initSchema = {
+  ...globalSchema,
+  workDir,
+  type,
+  name
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addSchema,
@@ -231,6 +246,7 @@ const deleteIntegrationSchema = {
   devSchema,
   generateSchema,
   globalSchema,
+  initSchema,
   integrationRef,
   listBotsSchema,
   listIntegrationsSchema,

package/dist/consts.js

@@ -29,6 +29,9 @@ __export(consts_exports, {
   defaultBotpressHome: () => defaultBotpressHome,
   defaultEntrypoint: () => defaultEntrypoint,
   defaultOutputFolder: () => defaultOutputFolder,
+  echoBotName: () => echoBotName,
+  emptyIntegrationName: () => emptyIntegrationName,
+  fromCliRootDir: () => fromCliRootDir,
   fromHomeDir: () => fromHomeDir,
   fromOutDir: () => fromOutDir,
   fromWorkDir: () => fromWorkDir
@@ -41,6 +44,13 @@ const defaultOutputFolder = ".botpress";
 const defaultEntrypoint = import_path.default.join("src", "index.ts");
 const defaultBotpressApi = "https://api.botpress.cloud";
 const defaultBotpressApp = "https://app.botpress.cloud";
+const echoBotName = "echo-bot";
+const emptyIntegrationName = "empty-integration";
+const fromCliRootDir = {
+  packageJson: "package.json",
+  echoBotTemplate: import_path.default.join("templates", echoBotName),
+  emptyIntegrationTemplate: import_path.default.join("templates", emptyIntegrationName)
+};
 const fromHomeDir = {
   userCacheFile: "user.cache.json"
 };
@@ -61,6 +71,9 @@ const fromOutDir = {
   defaultBotpressHome,
   defaultEntrypoint,
   defaultOutputFolder,
+  echoBotName,
+  emptyIntegrationName,
+  fromCliRootDir,
   fromHomeDir,
   fromOutDir,
   fromWorkDir

package/dist/errors.js

@@ -0,0 +1,156 @@
+"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(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  BotpressCLIError: () => BotpressCLIError,
+  ExclusiveBotFeatureError: () => ExclusiveBotFeatureError,
+  ExclusiveIntegrationFeatureError: () => ExclusiveIntegrationFeatureError,
+  HTTPError: () => HTTPError,
+  InvalidIntegrationReferenceError: () => InvalidIntegrationReferenceError,
+  NoBotsFoundError: () => NoBotsFoundError,
+  NoBundleFoundError: () => NoBundleFoundError,
+  NoWorkspacesFoundError: () => NoWorkspacesFoundError,
+  NotLoggedInError: () => NotLoggedInError,
+  ParamRequiredError: () => ParamRequiredError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_client = require("@botpress/client");
+var import_axios = __toESM(require("axios"));
+var import_verror = require("verror");
+var consts = __toESM(require("./consts"));
+const isKnownApiError = (e) => (0, import_client.isApiError)(e) && !(e instanceof import_client.UnknownError);
+class BotpressCLIError extends import_verror.VError {
+  static wrap(thrown, message) {
+    const err = BotpressCLIError.map(thrown);
+    return new BotpressCLIError(err, message ?? "");
+  }
+  static map(thrown) {
+    if (thrown instanceof import_client.UnknownError) {
+      return new HTTPError(500, "An unknown error has occurred.");
+    }
+    if (isKnownApiError(thrown)) {
+      return HTTPError.fromApi(thrown);
+    }
+    if (import_axios.default.isAxiosError(thrown)) {
+      return HTTPError.fromAxios(thrown);
+    }
+    if (thrown instanceof Error) {
+      const { message } = thrown;
+      return new BotpressCLIError(message);
+    }
+    return new BotpressCLIError(`${thrown}`);
+  }
+}
+class ExclusiveBotFeatureError extends BotpressCLIError {
+  constructor() {
+    const message = "This feature is only available for bots. This project is an integration";
+    super(message);
+  }
+}
+class ExclusiveIntegrationFeatureError extends BotpressCLIError {
+  constructor() {
+    const message = "This feature is only available for integration. This project is a bot";
+    super(message);
+  }
+}
+class HTTPError extends BotpressCLIError {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+  }
+  static fromAxios(e) {
+    const message = this._axiosMsg(e);
+    return new HTTPError(e.response?.status, message);
+  }
+  static fromApi(e) {
+    const { message, code } = e;
+    return new HTTPError(code, message);
+  }
+  static _axiosMsg(e) {
+    let message = e.message;
+    if (e.response?.statusText) {
+      message += `
+  ${e.response?.statusText}`;
+    }
+    if (e.response?.status && e.request?.method && e.request?.path) {
+      message += `
+  (${e.response?.status}) ${e.request.method} ${e.request.path}`;
+    }
+    if (e.response?.data?.message) {
+      message += `
+  ${e.response?.data?.message}`;
+    }
+    return message;
+  }
+}
+class NoBundleFoundError extends BotpressCLIError {
+  constructor() {
+    const message = "No bundle found. Please run `bp bundle` first.";
+    super(message);
+  }
+}
+class NoBotsFoundError extends BotpressCLIError {
+  constructor() {
+    const message = `No Bot found in your Workspace. Please create one first at ${consts.defaultBotpressApp}.`;
+    super(message);
+  }
+}
+class NoWorkspacesFoundError extends BotpressCLIError {
+  constructor() {
+    const message = "No Workspace found. Please create one first.";
+    super(message);
+  }
+}
+class NotLoggedInError extends BotpressCLIError {
+  constructor() {
+    const message = "Not logged in. Please run `bp login` first.";
+    super(message);
+  }
+}
+class ParamRequiredError extends BotpressCLIError {
+  constructor(param) {
+    const message = `${param} is required.`;
+    super(message);
+  }
+}
+class InvalidIntegrationReferenceError extends BotpressCLIError {
+  constructor(ref) {
+    const message = `Invalid integration reference "${ref}".`;
+    super(message);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BotpressCLIError,
+  ExclusiveBotFeatureError,
+  ExclusiveIntegrationFeatureError,
+  HTTPError,
+  InvalidIntegrationReferenceError,
+  NoBotsFoundError,
+  NoBundleFoundError,
+  NoWorkspacesFoundError,
+  NotLoggedInError,
+  ParamRequiredError
+});

package/dist/index.js

@@ -22,12 +22,11 @@ var import_process = require("process");
 var app = __toESM(require("./app"));
 var config = __toESM(require("./config"));
 var import_logger = require("./logger");
-const { name, version } = require("../package.json");
-const pkg = { name, version };
-const errorLogger = new import_logger.Logger();
+var pathutils = __toESM(require("./path-utils"));
+const CLI_ROOT_DIR = pathutils.join(__dirname, "..");
 const logError = (thrown) => {
   const error = app.errors.BotpressCLIError.map(thrown);
-  errorLogger.error(error.message);
+  new import_logger.Logger().error(error.message);
 };
 const onError = (thrown) => {
   logError(thrown);
@@ -52,7 +51,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.loginSchema, argv);
-      const commands = await app.forUser({ ...parsed, ...pkg });
+      const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.login(parsed);
       commands.teardown();
     } catch (e) {
@@ -66,7 +65,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.logoutSchema, argv);
-      const commands = await app.forUser({ ...parsed, ...pkg });
+      const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.logout();
       commands.teardown();
     } catch (e) {
@@ -81,7 +80,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.createBotSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.createBot(parsed);
         commands.teardown();
       } catch (e) {
@@ -95,7 +94,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.listBotsSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.listBots(parsed);
         commands.teardown();
       } catch (e) {
@@ -109,7 +108,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.readBotSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.getBot(argv.botRef, parsed);
         commands.teardown();
       } catch (e) {
@@ -123,7 +122,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.deleteBotSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.deleteBot(argv.botRef, parsed);
         commands.teardown();
       } catch (e) {
@@ -139,7 +138,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.listIntegrationsSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.listIntegrations(parsed);
         commands.teardown();
       } catch (e) {
@@ -153,7 +152,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.readIntegrationSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.getIntegration(argv.integrationRef, parsed);
         commands.teardown();
       } catch (e) {
@@ -167,7 +166,7 @@ import_yargs_extra.default.command(
     async (argv) => {
       try {
         const parsed = parseArguments(config.readIntegrationSchema, argv);
-        const commands = await app.forUser({ ...parsed, ...pkg });
+        const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
         await commands.deleteIntegration(argv.integrationRef, parsed);
         commands.teardown();
       } catch (e) {
@@ -176,13 +175,27 @@ import_yargs_extra.default.command(
     }
   );
 }).command(
+  "init",
+  "Initialize a new project",
+  () => import_yargs_extra.default.options(config.initSchema),
+  async (argv) => {
+    try {
+      const parsed = parseArguments(config.initSchema, argv);
+      const commands = await app.forUser({ ...parsed, cliRootPath: CLI_ROOT_DIR });
+      await commands.initProject(parsed);
+      commands.teardown();
+    } catch (e) {
+      onError(e);
+    }
+  }
+).command(
   "bundle",
   "Bundle a botpress project",
   () => import_yargs_extra.default.options(config.bundleSchema),
   async (argv) => {
     try {
       const parsed = parseArguments(config.bundleSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.bundleProject(parsed);
       commands.teardown();
     } catch (e) {
@@ -196,7 +209,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.generateSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.generateTypings(parsed);
       commands.teardown();
     } catch (e) {
@@ -210,7 +223,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.buildSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.buildProject(parsed);
       commands.teardown();
     } catch (e) {
@@ -224,7 +237,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.serveSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.serveProject(parsed);
       commands.teardown();
     } catch (e) {
@@ -238,7 +251,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.deploySchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.deployProject(parsed);
       commands.teardown();
     } catch (e) {
@@ -252,7 +265,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.devSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.devProject(parsed);
       commands.teardown();
     } catch (e) {
@@ -266,7 +279,7 @@ import_yargs_extra.default.command(
   async (argv) => {
     try {
       const parsed = parseArguments(config.addSchema, argv);
-      const commands = await app.forProject({ ...parsed, ...pkg });
+      const commands = await app.forProject({ ...parsed, cliRootPath: CLI_ROOT_DIR });
       await commands.installIntegration(argv.integrationRef, parsed);
       commands.teardown();
     } catch (e) {

package/dist/integration-ref.js

@@ -0,0 +1,61 @@
+"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(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var integration_ref_exports = {};
+__export(integration_ref_exports, {
+  formatIntegrationRef: () => formatIntegrationRef,
+  parseIntegrationRef: () => parseIntegrationRef
+});
+module.exports = __toCommonJS(integration_ref_exports);
+var import_semver = __toESM(require("semver"));
+var uuid = __toESM(require("uuid"));
+const LATEST_TAG = "latest";
+const formatIntegrationRef = (ref) => {
+  if (ref.type === "id") {
+    return ref.id;
+  }
+  return `${ref.name}@${ref.version}`;
+};
+const parseIntegrationRef = (ref) => {
+  if (uuid.validate(ref)) {
+    return { type: "id", id: ref };
+  }
+  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 = {
+  formatIntegrationRef,
+  parseIntegrationRef
+});

package/dist/path-utils.js

@@ -28,6 +28,7 @@ __export(path_utils_exports, {
   cwd: () => cwd,
   isAbsolute: () => isAbsolute,
   isPath: () => isPath,
+  join: () => join,
   relativeFrom: () => relativeFrom,
   rmExtension: () => rmExtension,
   toUnix: () => toUnix
@@ -37,6 +38,10 @@ var import_path = __toESM(require("path"));
 const cwd = () => process.cwd();
 const isAbsolute = (path) => import_path.default.isAbsolute(path);
 const isPath = (path) => isAbsolute(path) || path.startsWith(".");
+const join = (abs, ...paths) => {
+  const joined = import_path.default.join(abs, ...paths);
+  return import_path.default.normalize(joined);
+};
 const rmExtension = (filename) => filename.replace(/\.[^/.]+$/, "");
 const toUnix = (path) => path.split(import_path.default.sep).join(import_path.default.posix.sep);
 const absoluteFrom = (rootdir, target) => {
@@ -60,6 +65,7 @@ const relativeFrom = (rootdir, target) => {
   cwd,
   isAbsolute,
   isPath,
+  join,
   relativeFrom,
   rmExtension,
   toUnix

package/dist/register-yargs.js

@@ -0,0 +1,85 @@
+"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(
+  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, props) => {
+  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, props);
+        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);
+        await command.handler({ ...parsed, ...props });
+      }
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  registerYargs
+});

package/dist/typings.js

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 typings_exports = {};
+module.exports = __toCommonJS(typings_exports);