drizzle-kit 0.24.0-6205f01 → 0.24.0-6386ea9

package/bin.cjs

@@ -80519,7 +80519,7 @@ var init_studio2 = __esm({
   }
 });
 
-// ../node_modules/.pnpm/@drizzle-team+brocli@0.8.2/node_modules/@drizzle-team/brocli/index.js
+// ../node_modules/.pnpm/@drizzle-team+brocli@0.10.1/node_modules/@drizzle-team/brocli/index.js
 var __create2 = Object.create;
 var __defProp2 = Object.defineProperty;
 var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
@@ -80966,130 +80966,299 @@ var require_shell_quote = __commonJS2({
   }
 });
 var BroCliError = class extends Error {
-  constructor(message) {
+  constructor(message, event) {
     const errPrefix = "BroCli error: ";
     super(message === void 0 ? message : `${errPrefix}${message}`);
+    this.event = event;
   }
 };
 var import_clone = __toESM2(require_clone(), 1);
-var import_shell_quote = __toESM2(require_shell_quote(), 1);
-var defaultTheme = (calledFor) => {
-  if (Array.isArray(calledFor)) {
-    const cmds = calledFor.filter((cmd) => !cmd.hidden);
-    const tableCmds = cmds.map((cmd) => ({
-      name: cmd.name,
-      aliases: cmd.aliases ? cmd.aliases.join(", ") : "-",
-      description: cmd.description ?? "-"
-    }));
-    console.log(`Here's the list of all available commands:`);
-    console.table(tableCmds);
-    console.log(
-      "To read the details about any particular command type: [commandName] --help"
-    );
-  } else {
-    const options = calledFor.options ? Object.values(calledFor.options).filter((opt) => {
-      var _a;
-      return !((_a = opt.config) == null ? void 0 : _a.isHidden);
-    }).map(
-      ({ config: opt }) => ({
-        name: opt.name,
-        aliases: opt.aliases.length ? `${opt.aliases.join(", ")}` : "-",
-        description: opt.description ?? "-",
-        type: opt.type,
-        required: opt.isRequired ? "\u2713" : "\u2717"
-      })
-    ) : void 0;
-    console.log(
-      `Command: ${calledFor.name}${calledFor.aliases ? ` [${calledFor.aliases.join(", ")}]` : ""}${calledFor.description ? ` - ${calledFor.description}` : ""}`
-    );
-    if (!(options == null ? void 0 : options.length))
-      return;
-    console.log("\nOptions:");
-    console.table(options);
+var getOptionTypeText = (option) => {
+  let result = "";
+  switch (option.type) {
+    case "boolean":
+      result = "";
+      break;
+    case "number": {
+      if ((option.minVal ?? option.maxVal) !== void 0) {
+        let text = "";
+        if (option.isInt)
+          text = text + `integer `;
+        if (option.minVal !== void 0)
+          text = text + `[${option.minVal};`;
+        else
+          text = text + `(\u221E;`;
+        if (option.maxVal !== void 0)
+          text = text + `${option.maxVal}]`;
+        else
+          text = text + `\u221E)`;
+        result = text;
+        break;
+      }
+      if (option.isInt) {
+        result = "integer";
+        break;
+      }
+      result = "number";
+      break;
+    }
+    case "string": {
+      if (option.enumVals) {
+        result = "[ " + option.enumVals.join(" | ") + " ]";
+        break;
+      }
+      result = "string";
+      break;
+    }
+    case "positional": {
+      result = `${option.isRequired ? "<" : "["}${option.enumVals ? option.enumVals.join("|") : option.name}${option.isRequired ? ">" : "]"}`;
+      break;
+    }
+  }
+  if (option.isRequired && option.type !== "positional")
+    result = "!" + result.length ? " " : "" + result;
+  return result;
+};
+var defaultEventHandler = async (event) => {
+  var _a;
+  switch (event.type) {
+    case "command_help": {
+      const command2 = event.command;
+      const commandName = getCommandNameWithParents(command2);
+      const cliName = event.name;
+      const desc = command2.desc ?? command2.shortDesc;
+      const subs = (_a = command2.subcommands) == null ? void 0 : _a.filter((s2) => !s2.hidden);
+      const subcommands = subs && subs.length ? subs : void 0;
+      if (desc !== void 0) {
+        console.log(`
+${desc}`);
+      }
+      const opts = Object.values(command2.options ?? {}).filter(
+        (opt) => !opt.config.isHidden
+      );
+      const positionals = opts.filter((opt) => opt.config.type === "positional");
+      const options = opts.filter((opt) => opt.config.type !== "positional");
+      console.log("\nUsage:");
+      if (command2.handler) {
+        console.log(
+          `  ${cliName ? cliName + " " : ""}${commandName}${positionals.length ? " " + positionals.map(({ config: p2 }) => getOptionTypeText(p2)).join(" ") : ""} [flags]`
+        );
+      } else
+        console.log(`  ${cliName ? cliName + " " : ""}${commandName} [command]`);
+      if (command2.aliases) {
+        console.log(`
+Aliases:`);
+        console.log(`  ${[command2.name, ...command2.aliases].join(", ")}`);
+      }
+      if (subcommands) {
+        console.log("\nAvailable Commands:");
+        const padding = 3;
+        const maxLength = subcommands.reduce((p2, e2) => e2.name.length > p2 ? e2.name.length : p2, 0);
+        const paddedLength = maxLength + padding;
+        const preDescPad = 2 + paddedLength;
+        const data = subcommands.map(
+          (s2) => `  ${s2.name.padEnd(paddedLength)}${(() => {
+            const description = s2.shortDesc ?? s2.desc;
+            if (!(description == null ? void 0 : description.length))
+              return "";
+            const split = description.split("\n");
+            const first = split.shift();
+            const final = [first, ...split.map((s22) => "".padEnd(preDescPad) + s22)].join("\n");
+            return final;
+          })()}`
+        ).join("\n");
+        console.log(data);
+      }
+      if (options.length) {
+        const aliasLength = options.reduce((p2, e2) => {
+          const currentLength = e2.config.aliases.reduce((pa, a) => pa + a.length, 0) + (e2.config.aliases.length - 1) * 2 + 1;
+          return currentLength > p2 ? currentLength : p2;
+        }, 0);
+        const paddedAliasLength = aliasLength > 0 ? aliasLength + 1 : 0;
+        const nameLength = options.reduce((p2, e2) => {
+          const typeLen = getOptionTypeText(e2.config).length;
+          const length = typeLen > 0 ? e2.config.name.length + 1 + typeLen : e2.config.name.length;
+          return length > p2 ? length : p2;
+        }, 0) + 3;
+        const preDescPad = paddedAliasLength + nameLength + 2;
+        const data = options.map(
+          ({ config: opt }) => `  ${`${opt.aliases.length ? opt.aliases.join(", ") + "," : ""}`.padEnd(paddedAliasLength)}${`${opt.name}${(() => {
+            const typeText = getOptionTypeText(opt);
+            return typeText.length ? " " + typeText : "";
+          })()}`.padEnd(nameLength)}${(() => {
+            var _a2;
+            if (!((_a2 = opt.description) == null ? void 0 : _a2.length)) {
+              return opt.default !== void 0 ? `default: ${JSON.stringify(opt.default)}` : "";
+            }
+            const split = opt.description.split("\n");
+            const first = split.shift();
+            const def = opt.default !== void 0 ? ` (default: ${JSON.stringify(opt.default)})` : "";
+            const final = [first, ...split.map((s2) => "".padEnd(preDescPad) + s2)].join("\n") + def;
+            return final;
+          })()}`
+        ).join("\n");
+        console.log("\nFlags:");
+        console.log(data);
+      }
+      console.log("\nGlobal flags:");
+      console.log(`  -h, --help      help for ${commandName}`);
+      console.log(`  -v, --version   version${cliName ? ` for ${cliName}` : ""}`);
+      if (subcommands) {
+        console.log(
+          `
+Use "${cliName ? cliName + " " : ""}${commandName} [command] --help" for more information about a command.
+`
+        );
+      }
+      return true;
+    }
+    case "global_help": {
+      const cliName = event.name;
+      const desc = event.description;
+      const commands = event.commands.filter((c) => !c.hidden);
+      if (desc !== void 0) {
+        console.log(`${desc}
+`);
+      }
+      console.log("Usage:");
+      console.log(`  ${cliName ? cliName + " " : ""}[command]`);
+      if (commands.length) {
+        console.log("\nAvailable Commands:");
+        const padding = 3;
+        const maxLength = commands.reduce((p2, e2) => e2.name.length > p2 ? e2.name.length : p2, 0);
+        const paddedLength = maxLength + padding;
+        const data = commands.map(
+          (\u0441) => `  ${\u0441.name.padEnd(paddedLength)}${(() => {
+            const desc2 = \u0441.shortDesc ?? \u0441.desc;
+            if (!(desc2 == null ? void 0 : desc2.length))
+              return "";
+            const split = desc2.split("\n");
+            const first = split.shift();
+            const final = [first, ...split.map((s2) => "".padEnd(paddedLength + 2) + s2)].join("\n");
+            return final;
+          })()}`
+        ).join("\n");
+        console.log(data);
+      } else {
+        console.log("\nNo available commands.");
+      }
+      console.log("\nFlags:");
+      console.log(`  -h, --help      help${cliName ? ` for ${cliName}` : ""}`);
+      console.log(`  -v, --version   version${cliName ? ` for ${cliName}` : ""}`);
+      console.log("\n");
+      return true;
+    }
+    case "version": {
+      return true;
+    }
+    case "error": {
+      let msg;
+      switch (event.violation) {
+        case "above_max": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          const option = event.option;
+          const max = option.maxVal;
+          msg = `Invalid value: number type argument '${matchedName}' expects maximal value of ${max} as an input, got: ${data}`;
+          break;
+        }
+        case "below_min": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          const option = event.option;
+          const min = option.minVal;
+          msg = `Invalid value: number type argument '${matchedName}' expects minimal value of ${min} as an input, got: ${data}`;
+          break;
+        }
+        case "expected_int": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          msg = `Invalid value: number type argument '${matchedName}' expects an integer as an input, got: ${data}`;
+          break;
+        }
+        case "invalid_boolean_syntax": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          msg = `Invalid syntax: boolean type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value> | ${matchedName}.
+Allowed values: true, false, 0, 1`;
+          break;
+        }
+        case "invalid_string_syntax": {
+          const matchedName = event.offender.namePart;
+          msg = `Invalid syntax: string type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value>`;
+          break;
+        }
+        case "invalid_number_syntax": {
+          const matchedName = event.offender.namePart;
+          msg = `Invalid syntax: number type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value>`;
+          break;
+        }
+        case "invalid_number_value": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          msg = `Invalid value: number type argument '${matchedName}' expects a number as an input, got: ${data}`;
+          break;
+        }
+        case "enum_violation": {
+          const matchedName = event.offender.namePart;
+          const data = event.offender.dataPart;
+          const option = event.option;
+          const values = option.enumVals;
+          msg = option.type === "positional" ? `Invalid value: value for the positional argument '${option.name}' must be either one of the following: ${values.join(", ")}; Received: ${data}` : `Invalid value: value for the argument '${matchedName}' must be either one of the following: ${values.join(", ")}; Received: ${data}`;
+          break;
+        }
+        case "unknown_command_error": {
+          const msg2 = `Unknown command: '${event.offender}'.
+Type '--help' to get help on the cli.`;
+          console.error(msg2);
+          return true;
+        }
+        case "unknown_subcommand_error": {
+          const cName = getCommandNameWithParents(event.command);
+          const msg2 = `Unknown command: ${cName} ${event.offender}.
+Type '${cName} --help' to get the help on command.`;
+          console.error(msg2);
+          return true;
+        }
+        case "missing_args_error": {
+          const missingOpts = event.missing;
+          msg = `Command '${command.name}' is missing following required options: ${missingOpts.map((opt) => {
+            const name = opt.shift();
+            const aliases = opt;
+            if (aliases.length)
+              return `${name} [${aliases.join(", ")}]`;
+            return name;
+          }).join(", ")}`;
+          break;
+        }
+        case "unrecognized_args_error": {
+          const { command: command2, unrecognized } = event;
+          msg = `Unrecognized options for command '${command2.name}': ${unrecognized.join(", ")}`;
+          break;
+        }
+        case "unknown_error": {
+          const e2 = event.error;
+          console.error(typeof e2 === "object" && e2 !== null && "message" in e2 ? e2.message : e2);
+          return true;
+        }
+      }
+      console.error(msg);
+      return true;
+    }
   }
+  return false;
 };
+var eventHandlerWrapper = (customEventHandler) => async (event) => await customEventHandler(event) ? true : await defaultEventHandler(event);
+var import_shell_quote = __toESM2(require_shell_quote(), 1);
 function isInt(value) {
   return value === Math.floor(value);
 }
-var unknownCommand = (caller) => {
-  const msg = `Unknown command: '${caller}'.
-Type '--help' to get help on the cli.`;
-  return new Error(msg);
-};
-var unknownSubcommand = (command2, caller) => {
-  const name = getCommandNameRecursive(command2);
-  const msg = `Unknown command: ${name} ${caller}.
-Type '${name} --help' to get the help on command.`;
-  new Error(
-    msg
-  );
-  return new Error(msg);
-};
-var missingRequired = (command2, missingOpts) => {
-  const msg = `Command '${command2.name}' is missing following required options: ${missingOpts.map((opt) => {
-    const name = opt.shift();
-    const aliases = opt;
-    if (aliases.length)
-      return `${name} [${aliases.join(", ")}]`;
-    return name;
-  }).join(", ")}`;
-  return new Error(msg);
-};
-var unrecognizedOptions = (command2, unrecognizedArgs) => {
-  const msg = `Unrecognized options for command '${command2.name}': ${unrecognizedArgs.join(", ")}`;
-  return new Error(msg);
-};
-var invalidBooleanSyntax = (matchedName) => {
-  return new Error(
-    `Invalid syntax: boolean type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value> | ${matchedName}.
-Allowed values: true, false, 0, 1`
-  );
-};
-var invalidStringSyntax = (matchedName) => {
-  return new Error(
-    `Invalid syntax: string type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value>`
-  );
-};
-var enumViolation = (matchedName, data, values) => {
-  return new Error(
-    `Invalid value: value for the argument '${matchedName}' must be either one of the following: ${values.join(", ")}; Received: ${data}`
-  );
-};
-var enumViolationPos = (matchedName, data, values) => {
-  return new Error(
-    `Invalid value: value for the argument '${matchedName}' must be either one of the following: ${values.join(", ")}; Received: ${data}`
-  );
-};
-var invalidNumberSyntax = (matchedName) => {
-  return new Error(
-    `Invalid syntax: number type argument '${matchedName}' must have it's value passed in the following formats: ${matchedName}=<value> | ${matchedName} <value>`
-  );
-};
-var invalidNumberValue = (matchedName, data) => {
-  return new Error(
-    `Invalid value: number type argument '${matchedName}' expects a number as an input, got: ${data}`
-  );
-};
-var invalidInteger = (matchedName, data) => {
-  return new Error(
-    `Invalid value: number type argument '${matchedName}' expects an integer as an input, got: ${data}`
-  );
-};
-var belowMin = (matchedName, data, min) => {
-  return new Error(
-    `Invalid value: number type argument '${matchedName}' expects minimal value of ${min} as an input, got: ${data}`
-  );
-};
-var aboveMax = (matchedName, data, max) => {
-  return new Error(
-    `Invalid value: number type argument '${matchedName}' expects maximal value of ${max} as an input, got: ${data}`
-  );
-};
+var executeOrLog = async (target) => typeof target === "string" ? console.log(target) : target ? await target() : void 0;
 var generatePrefix = (name) => name.startsWith("-") ? name : name.length > 1 ? `--${name}` : `-${name}`;
 var validateOptions = (config) => {
   const cloned = (0, import_clone.default)(config);
   const entries = [];
-  const storedNames = {};
+  const storedNames = [];
   const cfgEntries = Object.entries(cloned);
   for (const [key, value] of cfgEntries) {
     const cfg = value._.config;
@@ -81099,13 +81268,13 @@ var validateOptions = (config) => {
       continue;
     if (cfg.name.includes("=")) {
       throw new BroCliError(
-        `Can't define option ${cfg.name} - option names and aliases cannot contain '='!`
+        `Can't define option '${generatePrefix(cfg.name)}' - option names and aliases cannot contain '='!`
       );
     }
     for (const alias of cfg.aliases) {
       if (alias.includes("=")) {
         throw new BroCliError(
-          `Can't define option ${cfg.name} - option names and aliases cannot contain '='!`
+          `Can't define option '${generatePrefix(cfg.name)}' - option names and aliases cannot contain '='!`
         );
       }
     }
@@ -81123,33 +81292,33 @@ var validateOptions = (config) => {
     for (const name of allNames) {
       const match2 = reservedNames.find((n) => n === name);
       if (match2)
-        throw new BroCliError(`Can't define option ${cfg.name} - name '${match2}' is reserved!`);
+        throw new BroCliError(`Can't define option '${cfg.name}' - name '${match2}' is reserved!`);
     }
-    const storageVals = Object.values(storedNames);
-    for (const storage2 of storageVals) {
+    for (const storage2 of storedNames) {
       const nameOccupier = storage2.find((e2) => e2 === cfg.name);
       if (!nameOccupier)
         continue;
       throw new BroCliError(
-        `Can't define option '${cfg.name}': name is already in use by option '${storage2[0]}'!`
+        `Can't define option '${cfg.name}' - name is already in use by option '${storage2[0]}'!`
       );
     }
     for (const alias of cfg.aliases) {
-      for (const storage2 of storageVals) {
+      for (const storage2 of storedNames) {
         const nameOccupier = storage2.find((e2) => e2 === alias);
         if (!nameOccupier)
           continue;
         throw new BroCliError(
-          `Can't define option '${cfg.name}': alias '${alias}' is already in use by option '${storage2[0]}'!`
+          `Can't define option '${cfg.name}' - alias '${alias}' is already in use by option '${storage2[0]}'!`
         );
       }
     }
-    storedNames[cfg.name] = [cfg.name, ...cfg.aliases];
-    storedNames[cfg.name].forEach((name, idx) => {
-      if (storedNames[cfg.name].findIndex((e2) => e2 === name) === idx)
+    const currentNames = [cfg.name, ...cfg.aliases];
+    storedNames.push(currentNames);
+    currentNames.forEach((name, idx) => {
+      if (currentNames.findIndex((e2) => e2 === name) === idx)
         return;
       throw new BroCliError(
-        `Can't define option '${cfg.name}': duplicate aliases '${name}'!`
+        `Can't define option '${cfg.name}' - duplicate alias '${name}'!`
       );
     });
     entries.push([key, { config: cfg, $output: void 0 }]);
@@ -81170,14 +81339,17 @@ var command = (command2) => {
       `Can't define command '${cmd.name}' - command can't have subcommands and positional args at the same time!`
     );
   }
+  if (!command2.handler && !command2.subcommands) {
+    throw new BroCliError(
+      `Can't define command '${cmd.name}' - command without subcommands must have a handler present!`
+    );
+  }
   const processedOptions = command2.options ? validateOptions(command2.options) : void 0;
   cmd.options = processedOptions;
   cmd.name = cmd.name ?? ((_a = cmd.aliases) == null ? void 0 : _a.shift());
   if (!cmd.name)
     throw new BroCliError(`Can't define command without name!`);
   cmd.aliases = ((_b = cmd.aliases) == null ? void 0 : _b.length) ? cmd.aliases : void 0;
-  if (!cmd.handler)
-    throw new BroCliError(`Can't define command '${cmd.name}' - command must have a handler!`);
   if (cmd.name.startsWith("-")) {
     throw new BroCliError(`Can't define command '${cmd.name}' - command name can't start with '-'!`);
   }
@@ -81207,7 +81379,7 @@ var command = (command2) => {
   }
   return cmd;
 };
-var getCommandInner = (commands, candidates, args) => {
+var getCommandInner = (commands, candidates, args, cliName, cliDescription) => {
   const { data: arg, originalIndex: index4 } = candidates.shift();
   const command2 = commands.find((c) => {
     const names = c.aliases ? [c.name, ...c.aliases] : [c.name];
@@ -81228,12 +81400,20 @@ var getCommandInner = (commands, candidates, args) => {
     };
   }
   const newCandidates = candidates.map((c) => ({ data: c.data, originalIndex: c.originalIndex - 1 }));
-  const subcommand = getCommandInner(command2.subcommands, newCandidates, newArgs);
-  if (!subcommand.command)
-    throw unknownSubcommand(command2, candidates[0].data);
+  const subcommand = getCommandInner(command2.subcommands, newCandidates, newArgs, cliName, cliDescription);
+  if (!subcommand.command) {
+    throw new BroCliError(void 0, {
+      type: "error",
+      violation: "unknown_subcommand_error",
+      name: cliName,
+      description: cliDescription,
+      command: command2,
+      offender: candidates[0].data
+    });
+  }
   return subcommand;
 };
-var getCommand = (commands, args) => {
+var getCommand = (commands, args, cliName, cliDescription) => {
   var _a;
   const candidates = [];
   for (let i2 = 0; i2 < args.length; ++i2) {
@@ -81267,15 +81447,23 @@ var getCommand = (commands, args) => {
       args: removeByIndex(args, firstCandidate.originalIndex)
     };
   }
-  const { command: command2, args: argsRes } = getCommandInner(commands, candidates, args);
-  if (!command2)
-    throw unknownCommand(firstCandidate.data);
+  const { command: command2, args: argsRes } = getCommandInner(commands, candidates, args, cliName, cliDescription);
+  if (!command2) {
+    throw new BroCliError(void 0, {
+      type: "error",
+      violation: "unknown_command_error",
+      commands,
+      name: cliName,
+      description: cliDescription,
+      offender: firstCandidate.data
+    });
+  }
   return {
     command: command2,
     args: argsRes
   };
 };
-var parseArg = (options, positionals, arg, nextArg) => {
+var parseArg = (command2, options, positionals, arg, nextArg, cliName, cliDescription) => {
   let data = void 0;
   const argSplit = arg.split("=");
   const hasEq = arg.includes("=");
@@ -81296,8 +81484,18 @@ var parseArg = (options, positionals, arg, nextArg) => {
     if (!positionals.length)
       return {};
     const pos = positionals.shift();
-    if (pos[1].enumVals && !pos[1].enumVals.find((val2) => val2 === dataPart)) {
-      throw enumViolationPos(pos[1].name, arg, pos[1].enumVals);
+    if (pos[1].enumVals && !pos[1].enumVals.find((val2) => val2 === arg)) {
+      throw new BroCliError(void 0, {
+        type: "error",
+        name: cliName,
+        description: cliDescription,
+        violation: "enum_violation",
+        command: command2,
+        option: pos[1],
+        offender: {
+          dataPart: arg
+        }
+      });
     }
     data = arg;
     return {
@@ -81332,32 +81530,126 @@ var parseArg = (options, positionals, arg, nextArg) => {
         skipNext = false;
         return true;
       }
-      throw invalidBooleanSyntax(match2);
+      throw new BroCliError(void 0, {
+        type: "error",
+        name: cliName,
+        description: cliDescription,
+        violation: "invalid_boolean_syntax",
+        option: opt,
+        command: command2,
+        offender: {
+          namePart,
+          dataPart
+        }
+      });
     } else {
       const match2 = names.find((name) => name === namePart);
       if (!match2)
         return false;
       if (opt.type === "string") {
-        if (!hasEq && nextArg === void 0)
-          throw invalidStringSyntax(match2);
+        if (!hasEq && nextArg === void 0) {
+          throw new BroCliError(void 0, {
+            type: "error",
+            name: cliName,
+            description: cliDescription,
+            violation: "invalid_string_syntax",
+            option: opt,
+            command: command2,
+            offender: {
+              namePart,
+              dataPart
+            }
+          });
+        }
         if (opt.enumVals && !opt.enumVals.find((val2) => val2 === dataPart)) {
-          throw enumViolation(match2, dataPart, opt.enumVals);
+          throw new BroCliError(void 0, {
+            type: "error",
+            name: cliName,
+            description: cliDescription,
+            violation: "enum_violation",
+            option: opt,
+            command: command2,
+            offender: {
+              namePart,
+              dataPart
+            }
+          });
         }
         data = dataPart;
         return true;
       }
-      if (!hasEq && nextArg === void 0)
-        throw invalidNumberSyntax(match2);
+      if (!hasEq && nextArg === void 0) {
+        throw new BroCliError(void 0, {
+          type: "error",
+          name: cliName,
+          description: cliDescription,
+          violation: "invalid_number_syntax",
+          option: opt,
+          command: command2,
+          offender: {
+            namePart,
+            dataPart
+          }
+        });
+      }
       const numData = Number(dataPart);
-      if (isNaN(numData))
-        throw invalidNumberValue(match2, dataPart);
-      if (opt.isInt && !isInt(numData))
-        throw invalidInteger(match2, dataPart);
-      if (opt.minVal !== void 0 && numData < opt.minVal)
-        throw belowMin(match2, dataPart, opt.minVal);
-      if (opt.maxVal !== void 0 && numData > opt.maxVal)
-        throw aboveMax(match2, dataPart, opt.maxVal);
-      data = dataPart;
+      if (isNaN(numData)) {
+        throw new BroCliError(void 0, {
+          type: "error",
+          name: cliName,
+          description: cliDescription,
+          violation: "invalid_number_value",
+          option: opt,
+          command: command2,
+          offender: {
+            namePart,
+            dataPart
+          }
+        });
+      }
+      if (opt.isInt && !isInt(numData)) {
+        throw new BroCliError(void 0, {
+          type: "error",
+          name: cliName,
+          description: cliDescription,
+          violation: "expected_int",
+          option: opt,
+          command: command2,
+          offender: {
+            namePart,
+            dataPart
+          }
+        });
+      }
+      if (opt.minVal !== void 0 && numData < opt.minVal) {
+        throw new BroCliError(void 0, {
+          type: "error",
+          name: cliName,
+          description: cliDescription,
+          violation: "below_min",
+          option: opt,
+          command: command2,
+          offender: {
+            namePart,
+            dataPart
+          }
+        });
+      }
+      if (opt.maxVal !== void 0 && numData > opt.maxVal) {
+        throw new BroCliError(void 0, {
+          type: "error",
+          name: cliName,
+          description: cliDescription,
+          violation: "above_max",
+          option: opt,
+          command: command2,
+          offender: {
+            namePart,
+            dataPart
+          }
+        });
+      }
+      data = numData;
       return true;
     }
   });
@@ -81368,7 +81660,7 @@ var parseArg = (options, positionals, arg, nextArg) => {
     option: option == null ? void 0 : option[1]
   };
 };
-var parseOptions = (command2, args, omitKeysOfUndefinedOptions) => {
+var parseOptions = (command2, args, cliName, cliDescription, omitKeysOfUndefinedOptions) => {
   const options = command2.options;
   const optEntries = Object.entries(options ?? {}).map(
     (opt) => [opt[0], opt[1].config]
@@ -81388,16 +81680,16 @@ var parseOptions = (command2, args, omitKeysOfUndefinedOptions) => {
       skipNext,
       isHelp,
       isVersion
-    } = parseArg(nonPositionalEntries, positionalEntries, arg, nextArg);
+    } = parseArg(command2, nonPositionalEntries, positionalEntries, arg, nextArg, cliName, cliDescription);
     if (!option)
       unrecognizedArgsArr.push(arg.split("=")[0]);
     if (skipNext)
       ++i2;
-    result[name] = data;
     if (isHelp)
       return "help";
     if (isVersion)
       return "version";
+    result[name] = data;
   }
   for (const [optKey, option] of optEntries) {
     const data = result[optKey] ?? option.default;
@@ -81410,19 +81702,29 @@ var parseOptions = (command2, args, omitKeysOfUndefinedOptions) => {
     if (option.isRequired && result[optKey] === void 0)
       missingRequiredArr.push([option.name, ...option.aliases]);
   }
-  if (missingRequiredArr.length)
-    throw missingRequired(command2, missingRequiredArr);
-  if (unrecognizedArgsArr.length)
-    throw unrecognizedOptions(command2, unrecognizedArgsArr);
-  return result;
-};
-var executeOrLog = async (target) => {
-  if (!target || typeof target === "string")
-    console.log(target);
-  else
-    await target();
+  if (missingRequiredArr.length) {
+    throw new BroCliError(void 0, {
+      type: "error",
+      violation: "missing_args_error",
+      name: cliName,
+      description: cliDescription,
+      command: command2,
+      missing: missingRequiredArr
+    });
+  }
+  if (unrecognizedArgsArr.length) {
+    throw new BroCliError(void 0, {
+      type: "error",
+      violation: "unrecognized_args_error",
+      name: cliName,
+      description: cliDescription,
+      command: command2,
+      unrecognized: unrecognizedArgsArr
+    });
+  }
+  return Object.keys(result).length ? result : void 0;
 };
-var getCommandNameRecursive = (command2) => command2.parent ? `${getCommandNameRecursive(command2.parent)} ${command2.name}` : command2.name;
+var getCommandNameWithParents = (command2) => command2.parent ? `${getCommandNameWithParents(command2.parent)} ${command2.name}` : command2.name;
 var validateCommands = (commands, parent) => {
   const storedNames = {};
   for (const cmd of commands) {
@@ -81431,8 +81733,8 @@ var validateCommands = (commands, parent) => {
       const nameOccupier = storage2.find((e2) => e2 === cmd.name);
       if (!nameOccupier)
         continue;
-      throw new Error(
-        `Can't define command '${getCommandNameRecursive(cmd)}': name is already in use by command '${parent ? `${getCommandNameRecursive(parent)} ` : ""}${storage2[0]}'!`
+      throw new BroCliError(
+        `Can't define command '${getCommandNameWithParents(cmd)}': name is already in use by command '${parent ? `${getCommandNameWithParents(parent)} ` : ""}${storage2[0]}'!`
       );
     }
     if (cmd.aliases) {
@@ -81441,8 +81743,8 @@ var validateCommands = (commands, parent) => {
           const nameOccupier = storage2.find((e2) => e2 === alias);
           if (!nameOccupier)
             continue;
-          throw new Error(
-            `Can't define command '${getCommandNameRecursive(cmd)}': alias '${alias}' is already in use by command '${parent ? `${getCommandNameRecursive(parent)} ` : ""}${storage2[0]}'!`
+          throw new BroCliError(
+            `Can't define command '${getCommandNameWithParents(cmd)}': alias '${alias}' is already in use by command '${parent ? `${getCommandNameWithParents(parent)} ` : ""}${storage2[0]}'!`
           );
         }
       }
@@ -81454,53 +81756,135 @@ var validateCommands = (commands, parent) => {
   return commands;
 };
 var removeByIndex = (arr, idx) => [...arr.slice(0, idx), ...arr.slice(idx + 1, arr.length)];
-var help = async (command2, commands, helpHandler) => typeof command2 === "object" ? command2.help !== void 0 ? await executeOrLog(command2.help) : await helpHandler(command2) : await helpHandler(commands);
-var rawCli = async (commands, config) => {
+var run = async (commands, config) => {
   var _a, _b;
-  const processedCmds = validateCommands(commands);
+  const eventHandler = (config == null ? void 0 : config.theme) ? eventHandlerWrapper(config.theme) : defaultEventHandler;
   const argSource = (config == null ? void 0 : config.argSource) ?? process.argv;
   const version3 = config == null ? void 0 : config.version;
-  const helpHandler = (config == null ? void 0 : config.help) ?? defaultTheme;
+  const help = config == null ? void 0 : config.help;
   const omitKeysOfUndefinedOptions = (config == null ? void 0 : config.omitKeysOfUndefinedOptions) ?? false;
-  let args = argSource.slice(2, argSource.length);
-  if (!args.length)
-    return await helpHandler(processedCmds);
-  const helpIndex = args.findIndex((arg) => arg === "--help" || arg === "-h");
-  if (helpIndex !== -1 && (helpIndex > 0 ? ((_a = args[helpIndex - 1]) == null ? void 0 : _a.startsWith("-")) && !args[helpIndex - 1].includes("=") ? false : true : true)) {
-    const command3 = getCommand(processedCmds, args).command;
-    return help(command3, processedCmds, helpHandler);
-  }
-  const versionIndex = args.findIndex((arg) => arg === "--version" || arg === "-v");
-  if (versionIndex !== -1 && (versionIndex > 0 ? ((_b = args[versionIndex - 1]) == null ? void 0 : _b.startsWith("-")) ? false : true : true)) {
-    return await executeOrLog(version3);
-  }
-  const { command: command2, args: newArgs } = getCommand(processedCmds, args);
-  if (!command2)
-    return helpHandler(processedCmds);
-  if (command2 === "help") {
-    const { command: helpCommand } = getCommand(processedCmds, newArgs);
-    return help(helpCommand, processedCmds, helpHandler);
-  }
-  const optionResult = parseOptions(command2, newArgs, omitKeysOfUndefinedOptions);
-  if (optionResult === "help")
-    return await help(command2, commands, helpHandler);
-  if (optionResult === "version")
-    return await executeOrLog(version3);
-  if (optionResult) {
-    if (config == null ? void 0 : config.hook)
-      await config.hook("pre", command2);
-    await command2.handler(command2.transform ? await command2.transform(optionResult) : optionResult);
-    if (config == null ? void 0 : config.hook)
-      await config.hook("post", command2);
-  }
-  return void 0;
-};
-var run = async (commands, config) => {
+  const cliName = config == null ? void 0 : config.name;
+  const cliDescription = config == null ? void 0 : config.description;
   try {
-    await rawCli(commands, config);
+    const processedCmds = validateCommands(commands);
+    let args = argSource.slice(2, argSource.length);
+    if (!args.length) {
+      return help !== void 0 ? await executeOrLog(help) : await eventHandler({
+        type: "global_help",
+        description: cliDescription,
+        name: cliName,
+        commands: processedCmds
+      });
+    }
+    const helpIndex = args.findIndex((arg) => arg === "--help" || arg === "-h");
+    if (helpIndex !== -1 && (helpIndex > 0 ? ((_a = args[helpIndex - 1]) == null ? void 0 : _a.startsWith("-")) && !args[helpIndex - 1].includes("=") ? false : true : true)) {
+      const command3 = getCommand(processedCmds, args, cliName, cliDescription).command;
+      if (typeof command3 === "object") {
+        return command3.help !== void 0 ? await executeOrLog(command3.help) : await eventHandler({
+          type: "command_help",
+          description: cliDescription,
+          name: cliName,
+          command: command3
+        });
+      } else {
+        return help !== void 0 ? await executeOrLog(help) : await eventHandler({
+          type: "global_help",
+          description: cliDescription,
+          name: cliName,
+          commands: processedCmds
+        });
+      }
+    }
+    const versionIndex = args.findIndex((arg) => arg === "--version" || arg === "-v");
+    if (versionIndex !== -1 && (versionIndex > 0 ? ((_b = args[versionIndex - 1]) == null ? void 0 : _b.startsWith("-")) ? false : true : true)) {
+      return version3 !== void 0 ? await executeOrLog(version3) : await eventHandler({
+        type: "version",
+        name: cliName,
+        description: cliDescription
+      });
+    }
+    const { command: command2, args: newArgs } = getCommand(processedCmds, args, cliName, cliDescription);
+    if (!command2) {
+      return help !== void 0 ? await executeOrLog(help) : await eventHandler({
+        type: "global_help",
+        description: cliDescription,
+        name: cliName,
+        commands: processedCmds
+      });
+    }
+    if (command2 === "help") {
+      let helpCommand;
+      let newestArgs = newArgs;
+      do {
+        const res = getCommand(processedCmds, newestArgs, cliName, cliDescription);
+        helpCommand = res.command;
+        newestArgs = res.args;
+      } while (helpCommand === "help");
+      return helpCommand ? helpCommand.help !== void 0 ? await executeOrLog(helpCommand.help) : await eventHandler({
+        type: "command_help",
+        description: cliDescription,
+        name: cliName,
+        command: helpCommand
+      }) : help !== void 0 ? await executeOrLog(help) : await eventHandler({
+        type: "global_help",
+        description: cliDescription,
+        name: cliName,
+        commands: processedCmds
+      });
+    }
+    const optionResult = parseOptions(command2, newArgs, cliName, cliDescription, omitKeysOfUndefinedOptions);
+    if (optionResult === "help") {
+      return command2.help !== void 0 ? await executeOrLog(command2.help) : await eventHandler({
+        type: "command_help",
+        description: cliDescription,
+        name: cliName,
+        command: command2
+      });
+    }
+    if (optionResult === "version") {
+      return version3 !== void 0 ? await executeOrLog(version3) : await eventHandler({
+        type: "version",
+        name: cliName,
+        description: cliDescription
+      });
+    }
+    if (command2.handler) {
+      if (config == null ? void 0 : config.hook)
+        await config.hook("before", command2);
+      await command2.handler(command2.transform ? await command2.transform(optionResult) : optionResult);
+      if (config == null ? void 0 : config.hook)
+        await config.hook("after", command2);
+      return;
+    } else {
+      return command2.help !== void 0 ? await executeOrLog(command2.help) : await eventHandler({
+        type: "command_help",
+        description: cliDescription,
+        name: cliName,
+        command: command2
+      });
+    }
   } catch (e2) {
-    console.error(typeof e2 === "object" && e2 !== null && "message" in e2 ? e2.message : e2);
-    process.exit(1);
+    if (e2 instanceof BroCliError) {
+      if (e2.event)
+        await eventHandler(e2.event);
+      else {
+        if (!(config == null ? void 0 : config.noExit))
+          console.error(e2.message);
+        else
+          return e2.message;
+      }
+    } else {
+      await eventHandler({
+        type: "error",
+        violation: "unknown_error",
+        name: cliName,
+        description: cliDescription,
+        error: e2
+      });
+    }
+    if (!(config == null ? void 0 : config.noExit))
+      process.exit(1);
+    return;
   }
 };
 var OptionBuilderBase = class _OptionBuilderBase {
@@ -81578,7 +81962,7 @@ var OptionBuilderBase = class _OptionBuilderBase {
   max(value) {
     const config = this.config();
     const minVal = config.minVal;
-    if (minVal !== void 0 && minVal < value) {
+    if (minVal !== void 0 && minVal > value) {
       throw new BroCliError("Unable to define option's max value to be lower than min value!");
     }
     return new _OptionBuilderBase({ ...config, maxVal: value });
@@ -83402,7 +83786,7 @@ init_utils2();
 var version2 = async () => {
   const { npmVersion } = await ormCoreVersions();
   const ormVersion = npmVersion ? `drizzle-orm: v${npmVersion}` : "";
-  const envVersion = "0.24.0-6205f01";
+  const envVersion = "0.24.0-6386ea9";
   const kitVersion = envVersion ? `v${envVersion}` : "--";
   const versions = `drizzle-kit: ${kitVersion}
 ${ormVersion}`;
@@ -83437,6 +83821,7 @@ var legacy = [
   legacyCommand("check:sqlite", "check")
 ];
 run([generate, migrate, pull, push, studio, up, check, drop, ...legacy], {
+  name: "drizzle-kit",
   version: version2
 });
 /*! Bundled license information:

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "drizzle-kit",
-	"version": "0.24.0-6205f01",
+	"version": "0.24.0-6386ea9",
 	"homepage": "https://orm.drizzle.team",
 	"keywords": [
 		"drizzle",
@@ -42,7 +42,7 @@
 		"publish": "npm publish package.tgz"
 	},
 	"dependencies": {
-		"@drizzle-team/brocli": "^0.8.2",
+		"@drizzle-team/brocli": "^0.10.1",
 		"@esbuild-kit/esm-loader": "^2.5.5",
 		"esbuild": "^0.19.7",
 		"esbuild-register": "^3.5.0"
@@ -92,7 +92,7 @@
 		"hono": "^4.1.5",
 		"json-diff": "1.0.6",
 		"minimatch": "^7.4.3",
-		"mysql2": "2.3.3",
+		"mysql2": "3.3.3",
 		"node-fetch": "^3.3.2",
 		"pg": "^8.11.5",
 		"pluralize": "^8.0.0",