convoker 0.2.0 → 0.3.0

package/dist/chunks/{error-CBR2veuf.js → error-CyKscMUD.js}

@@ -87,9 +87,9 @@ export {
   o as C,
   i as H,
   n as I,
-  c as M,
+  d as M,
   a as T,
   u as U,
-  d as a,
+  c as a,
   l as e
 };

package/dist/chunks/{index-D7JQKzRX.js → index-BluQjWvw.js}

@@ -1,6 +1,6 @@
 import { D as y } from "./color-CiruG_zQ.js";
-import { v as p } from "./standard-schema-CFxVDMhv.js";
-import { I as f } from "./error-CBR2veuf.js";
+import { v as p } from "./standard-schema-BHKzvwIS.js";
+import { I as f } from "./error-CyKscMUD.js";
 import { i as $, a as v, b } from "./utils-DdmSEjLc.js";
 import { r as m, a as g, c as d, b as x, d as D } from "./__vite-browser-external-DQYBmsno.js";
 let l = y;

package/dist/chunks/{input-BfYvlWdG.js → input-WNu16aNE.js}

@@ -1,4 +1,4 @@
-import { v as o } from "./standard-schema-CFxVDMhv.js";
+import { v as o } from "./standard-schema-BHKzvwIS.js";
 async function a(r, t) {
   async function i(e) {
     if (typeof r == "string")

package/dist/chunks/{standard-schema-CFxVDMhv.js → standard-schema-BHKzvwIS.js}

@@ -1,4 +1,4 @@
-import { I as i } from "./error-CBR2veuf.js";
+import { I as i } from "./error-CyKscMUD.js";
 async function o(a, t) {
   const s = await a["~standard"].validate(t);
   if (s.issues) {

package/dist/command.d.ts

@@ -1,7 +1,7 @@
 /**
  * Command action function.
  */
-export declare type ActionFn<T extends Input> = (input: InferInput<T>) => void | Promise<void>;
+export declare type ActionFn<T extends Input> = (input: InferInput<T>) => any | Promise<any>;
 
 /**
  * A basic input type.
@@ -57,6 +57,10 @@ export declare class Command<T extends Input = Input> {
      * The action function of this command.
      */
     $fn: ActionFn<T> | undefined;
+    /**
+     * The middlewares associated with this command.
+     */
+    $middlewares: MiddlewareFn<T>[];
     /**
      * The error handler of this command.
      */
@@ -92,6 +96,12 @@ export declare class Command<T extends Input = Input> {
      * @returns this
      */
     input<TInput extends Input>(input: TInput): Command<TInput>;
+    /**
+     * Adds a chain of middlewares.
+     * @param fns The middlewares to use.
+     * @returns this
+     */
+    use(...fns: MiddlewareFn<T>[]): this;
     /**
      * Sets the action function for this command.
      * @param fn The action.
@@ -135,6 +145,11 @@ export declare class Command<T extends Input = Input> {
      */
     parse(argv: string[]): Promise<ParseResult<T>>;
     private buildInputMap;
+    /**
+     * Allows surpassing the amount of arguments specified.
+     * @returns this
+     */
+    allowSurpassArgLimit(): this;
     /**
      * Gets the full command path (name including parents).
      * @returns The full command path.
@@ -227,6 +242,11 @@ declare interface Input {
  */
 declare type Kind = BasicKind | StandardSchemaV1<any, any>;
 
+/**
+ * Command middleware function.
+ */
+export declare type MiddlewareFn<T extends Input = Input> = (input: InferInput<T>, next: () => Promise<any>) => any | Promise<any>;
+
 /**
  * An option.
  */

package/dist/command.js

@@ -1,217 +1,225 @@
 import { D as V, b, c as v, g as O } from "./chunks/color-CiruG_zQ.js";
-import { s as q } from "./chunks/index-D7JQKzRX.js";
-import { m as R, i as A, b as W, a as j } from "./chunks/utils-DdmSEjLc.js";
-import { T as H, M as z, a as N, C as J, H as P, U as K } from "./chunks/error-CBR2veuf.js";
-import { P as B, c as G, O as _ } from "./chunks/input-BfYvlWdG.js";
+import { s as R } from "./chunks/index-BluQjWvw.js";
+import { m as z, i as A, b as j, a as P } from "./chunks/utils-DdmSEjLc.js";
+import { M as U, a as J, T as N, C as K, H as L, U as x } from "./chunks/error-CyKscMUD.js";
+import { P as q, c as G, O as F } from "./chunks/input-WNu16aNE.js";
 async function Q() {
-  if (W && process.stdout?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
-    return n.toWeb(process.stdout);
+  if (j && process.stdout?.writable) {
+    const { Writable: r } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    return r.toWeb(process.stdout);
   }
-  return A && Deno.stdout?.writable ? Deno.stdout.writable : j && Bun.stdout ? Bun.stdout : new WritableStream({
-    write(n) {
-      console.log(String(n));
+  return A && Deno.stdout?.writable ? Deno.stdout.writable : P && Bun.stdout ? Bun.stdout : new WritableStream({
+    write(r) {
+      console.log(String(r));
     }
   });
 }
 async function X() {
-  if (W && process.stderr?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
-    return n.toWeb(process.stderr);
+  if (j && process.stderr?.writable) {
+    const { Writable: r } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    return r.toWeb(process.stderr);
   }
-  return A && Deno.stderr?.writable ? Deno.stderr.writable : j && Bun.stderr ? Bun.stderr : new WritableStream({
-    write(n) {
-      console.error(String(n));
+  return A && Deno.stderr?.writable ? Deno.stderr.writable : P && Bun.stderr ? Bun.stderr : new WritableStream({
+    write(r) {
+      console.error(String(r));
     }
   });
 }
 async function Y() {
-  if (W && process.stdin?.readable) {
-    const { Readable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((e) => e._);
-    return n.toWeb(process.stdin);
+  if (j && process.stdin?.readable) {
+    const { Readable: r } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    return r.toWeb(process.stdin);
   }
-  return A && Deno.stdin?.readable ? Deno.stdin.readable : j ? Bun.stdin.stream() : new ReadableStream({
-    start(n) {
-      n.close();
+  return A && Deno.stdin?.readable ? Deno.stdin.readable : P ? Bun.stdin.stream() : new ReadableStream({
+    start(r) {
+      r.close();
     }
   });
 }
 let m = V, g;
-function I(n) {
-  m = n;
+function H(r) {
+  m = r;
 }
-async function L(n) {
-  g = R(
+async function _(r) {
+  g = z(
     {
       format: "text",
       stdout: await Q(),
       stderr: await X(),
       stdin: await Y()
     },
-    n
+    r
   );
 }
 async function Z() {
-  await L({});
+  await _({});
 }
-function S(n, ...e) {
-  const t = (/* @__PURE__ */ new Date()).toISOString(), r = e.map((i) => typeof i == "string" ? i : JSON.stringify(i, null, 2)).join(" ");
+function S(r, ...t) {
+  const e = (/* @__PURE__ */ new Date()).toISOString(), n = t.map((i) => typeof i == "string" ? i : JSON.stringify(i, null, 2)).join(" ");
   switch (g.format) {
     case "json":
-      return JSON.stringify({ timestamp: t, level: n, message: r }) + `
+      return JSON.stringify({ timestamp: e, level: r, message: n }) + `
 `;
     case "xml":
       return `<log>
-  <timestamp>${t}</timestamp>
-  <level>${n}</level>
-  <message>${r}</message>
+  <timestamp>${e}</timestamp>
+  <level>${r}</level>
+  <message>${n}</message>
 </log>
 `;
     case "yaml":
-      return `- timestamp: ${t}
-  level: ${n}
-  message: "${r.replace(/"/g, '\\"')}"
+      return `- timestamp: ${e}
+  level: ${r}
+  message: "${n.replace(/"/g, '\\"')}"
 `;
     case "csv":
-      return `"${t}","${n}","${r.replace(/"/g, '""')}"
+      return `"${e}","${r}","${n.replace(/"/g, '""')}"
 `;
     case "text":
     default:
-      return `[${t}] [${n.toUpperCase()}] ${r}
+      return `[${e}] [${r.toUpperCase()}] ${n}
 `;
   }
 }
-function E(n, e) {
-  switch (n) {
+function E(r, t) {
+  switch (r) {
     case "trace":
-      return m.secondary ? m.secondary(e) : e;
+      return m.secondary ? m.secondary(t) : t;
     case "info":
-      return m.info ? m.info(e) : e;
+      return m.info ? m.info(t) : t;
     case "warn":
-      return m.warning ? m.warning(e) : e;
+      return m.warning ? m.warning(t) : t;
     case "error":
-      return m.error ? m.error(e) : e;
+      return m.error ? m.error(t) : t;
     case "fatal":
-      return m.error ? m.error(m.styles?.bold?.(e) ?? e) : e;
+      return m.error ? m.error(m.styles?.bold?.(t) ?? t) : t;
     default:
-      return e;
+      return t;
   }
 }
-async function k(n, e) {
-  const t = n.getWriter();
+async function k(r, t) {
+  const e = r.getWriter();
   try {
-    await t.write(e);
+    await e.write(t);
   } finally {
-    t.releaseLock();
+    e.releaseLock();
   }
 }
-async function x(...n) {
-  const e = S("trace", ...n), t = E("trace", e);
-  await k(g.stdout, t);
+async function ee(...r) {
+  const t = S("trace", ...r), e = E("trace", t);
+  await k(g.stdout, e);
 }
-async function tt(...n) {
-  const e = S("info", ...n), t = E("info", e);
-  await k(g.stdout, t);
+async function te(...r) {
+  const t = S("info", ...r), e = E("info", t);
+  await k(g.stdout, e);
 }
-async function et(...n) {
-  const e = S("warn", ...n), t = E("warn", e);
-  await k(g.stdout, t);
+async function ne(...r) {
+  const t = S("warn", ...r), e = E("warn", t);
+  await k(g.stdout, e);
 }
-async function nt(...n) {
-  const e = S("error", ...n), t = E("error", e);
-  await k(g.stderr, t);
+async function re(...r) {
+  const t = S("error", ...r), e = E("error", t);
+  await k(g.stderr, e);
 }
-async function rt(...n) {
-  const e = S("fatal", ...n), t = E("fatal", e);
-  await k(g.stderr, t), A ? Deno.exit(-1) : (W || j) && process.exit(-1);
+async function se(...r) {
+  const t = S("fatal", ...r), e = E("fatal", t);
+  await k(g.stderr, e), A ? Deno.exit(-1) : (j || P) && process.exit(-1);
 }
-const ct = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const de = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  error: nt,
-  fatal: rt,
-  info: tt,
-  setConfig: L,
-  setTheme: I,
+  error: re,
+  fatal: se,
+  info: te,
+  setConfig: _,
+  setTheme: H,
   setup: Z,
-  trace: x,
-  warn: et
+  trace: ee,
+  warn: ne
 }, Symbol.toStringTag, { value: "Module" }));
-class F {
+class B {
   /**
    * Creates a new command.
    * @param names The names (aliases).
    * @param desc The description.
    * @param version The version.
    */
-  constructor(e, t, r) {
-    this.$children = /* @__PURE__ */ new Map(), this.$allowUnknownOptions = !1, this.$allowSurpassArgLimit = !1, this.$input = {}, this.$fn = void 0, this.$errorFn = void 0, this.$names = Array.isArray(e) ? e : [e], this.$description = t, this.$version = r;
+  constructor(t, e, n) {
+    this.$children = /* @__PURE__ */ new Map(), this.$allowUnknownOptions = !1, this.$allowSurpassArgLimit = !1, this.$input = {}, this.$fn = void 0, this.$middlewares = [], this.$errorFn = void 0, this.$names = Array.isArray(t) ? t : [t], this.$description = e, this.$version = n;
   }
   /**
    * Adds a set of aliases to this command.
    * @param aliases The aliases to add.
    * @returns this
    */
-  alias(...e) {
-    return this.$names.concat(e), this.$parent?.add(this), this;
+  alias(...t) {
+    return this.$names.concat(t), this.$parent?.add(this), this;
   }
   /**
    * Adds a description to this command.
    * @param desc The description.
    * @returns this
    */
-  description(e) {
-    return this.$description = e, this;
+  description(t) {
+    return this.$description = t, this;
   }
   /**
    * Adds a version to this command.
    * @param version The version.
    * @returns this
    */
-  version(e) {
-    return this.$version = e, this;
+  version(t) {
+    return this.$version = t, this;
   }
   /**
    * Sets the input for this command.
    * @param version The input.
    * @returns this
    */
-  input(e) {
-    return this.$input = e, this;
+  input(t) {
+    return this.$input = t, this;
+  }
+  /**
+   * Adds a chain of middlewares.
+   * @param fns The middlewares to use.
+   * @returns this
+   */
+  use(...t) {
+    return this.$middlewares.push(...t), this;
   }
   /**
    * Sets the action function for this command.
    * @param fn The action.
    * @returns this
    */
-  action(e) {
-    return this.$fn = e, this;
+  action(t) {
+    return this.$fn = t, this;
   }
   /**
    * Sets the error function for this command.
    * @param fn The error handler.
    * @returns this
    */
-  error(e) {
-    return this.$errorFn = e, this;
+  error(t) {
+    return this.$errorFn = t, this;
   }
   /**
    * Adds an existing command to this.
    * @param command The command.
    * @returns this
    */
-  add(e) {
-    e.$parent = this;
-    const t = { command: e, alias: e.$names[0] };
-    for (let r = 0; r < e.$names.length; r++)
-      r === 0 && this.$children.set(e.$names[r], { command: e }), this.$children.set(e.$names[r], t);
+  add(t) {
+    t.$parent = this;
+    const e = { command: t, alias: t.$names[0] };
+    for (let n = 0; n < t.$names.length; n++)
+      n === 0 && this.$children.set(t.$names[n], { command: t }), this.$children.set(t.$names[n], e);
     return this;
   }
-  subCommand(e, t, r) {
-    if (typeof t == "function") {
-      const a = new F(e);
-      return t(a), this.add(a), this;
+  subCommand(t, e, n) {
+    if (typeof e == "function") {
+      const a = new B(t);
+      return e(a), this.add(a), this;
     }
-    const i = new F(e, t, r);
+    const i = new B(t, e, n);
     return this.add(i), i;
   }
   /**
@@ -226,132 +234,136 @@ class F {
    * @param argv The arguments to parse.
    * @returns A parse result.
    */
-  async parse(e) {
-    let t = this, r = !1;
-    const i = {}, a = [], d = {}, s = [], c = t.buildInputMap();
-    function u(f, o) {
-      const l = c.get(f);
-      return l ? l.value : (!t.$allowUnknownOptions && !o && s.push(new K(t, f)), null);
+  async parse(t) {
+    let e = this, n = !1;
+    const i = {}, a = [], f = {}, s = [], c = e.buildInputMap();
+    function d(u, o) {
+      const l = c.get(u);
+      return l ? l.value : (!e.$allowUnknownOptions && !o && s.push(new x(e, u)), null);
     }
-    function h(f, o, l) {
-      o.$kind === "boolean" ? d[f] = "true" : l !== void 0 && (d[f] = l);
+    function h(u, o, l) {
+      o.$kind === "boolean" ? f[u] = "true" : l !== void 0 && (f[u] = l);
     }
-    let p = !1, C = !1;
-    for (let f = 0; f < e.length; f++) {
-      const o = e[f];
+    let p = !1, W = !1;
+    for (let u = 0; u < t.length; u++) {
+      const o = t[u];
       if (o.startsWith("--")) {
         const [l, w] = o.slice(2).split("=");
         let y = !1;
-        l === "help" ? (C = !0, y = !0) : l === "version" && (p = !0, y = !0);
-        const $ = u(l, y);
+        l === "help" ? (W = !0, y = !0) : l === "version" && (p = !0, y = !0);
+        const $ = d(l, y);
         $ && (w === void 0 ? h(
           l,
           $,
-          $.$kind === "boolean" ? void 0 : e[++f]
+          $.$kind === "boolean" ? void 0 : t[++u]
         ) : h(l, $, w));
       } else if (o.startsWith("-")) {
         const [l, w] = o.slice(1).split("="), y = l.split("");
         let $ = w;
         for (const D of y) {
-          let T = !1;
-          D === "h" ? (C = !0, T = !0) : D === "V" && (p = !0, T = !0);
-          const U = u(D, T);
-          U && (U.$kind !== "boolean" && $ === void 0 && ($ = e[++f]), h(D, U, $), $ = void 0);
+          let C = !1;
+          D === "h" ? (W = !0, C = !0) : D === "V" && (p = !0, C = !0);
+          const T = d(D, C);
+          T && (T.$kind !== "boolean" && $ === void 0 && ($ = t[++u]), h(D, T, $), $ = void 0);
         }
       } else
-        t.$children.has(o) && !r ? (t = t.$children.get(o).command, t.$theme && (q(t.$theme), I(t.$theme))) : (r = !0, a.push(o));
+        e.$children.has(o) && !n ? (e = e.$children.get(o).command, e.$theme && (R(e.$theme), H(e.$theme))) : (n = !0, a.push(o));
     }
     let M = 0;
-    for (const f in t.$input) {
-      const o = t.$input[f];
+    for (const u in e.$input) {
+      const o = e.$input[u];
       let l;
-      if (o instanceof B) {
-        if (o.$list) {
-          if (l = a.slice(M), M = a.length, !t.$allowSurpassArgLimit && l.length === 0)
-            throw new H(t);
-        } else if (l = a[M++], M > a.length && !t.$allowSurpassArgLimit)
-          throw new H(t);
-      } else
+      if (o instanceof q)
+        o.$list ? (l = a.slice(M), M = a.length, !e.$allowSurpassArgLimit && l.length === 0 && o.$required && s.push(new U(e, u, o))) : (l = a[M++], l === void 0 && o.$required && s.push(new U(e, u, o)));
+      else
         for (const w of o.$names)
-          if (d[w] !== void 0) {
-            l = o.$list ? d[w] : d[w].split(o.$separator ?? ",");
+          if (f[w] !== void 0) {
+            l = o.$list ? f[w].split(o.$separator ?? ",") : f[w];
             break;
           }
-      l !== void 0 ? i[f] = await G(o.$kind, l) : o.$default !== void 0 ? i[f] = o.$default : o.$required && (o instanceof _ ? s.push(new z(t, f, o)) : s.push(new N(t, f, o)));
+      l !== void 0 ? i[u] = await G(o.$kind, l) : o.$default !== void 0 ? i[u] = o.$default : o.$required && (o instanceof F ? s.push(new J(e, u, o)) : s.push(new U(e, u, o)));
     }
-    return {
+    const I = a.slice(M);
+    return !e.$allowSurpassArgLimit && I.length > 0 && s.push(new N(e)), {
       input: i,
-      command: t,
+      command: e,
       errors: s,
       isVersion: p,
-      isHelp: C
+      isHelp: W
     };
   }
-  buildInputMap(e) {
-    const t = /* @__PURE__ */ new Map();
-    let r = 0;
+  buildInputMap(t) {
+    const e = /* @__PURE__ */ new Map();
+    let n = 0;
     for (const i in this.$input) {
       const a = this.$input[i];
-      if (a instanceof B)
-        t.set(r++, { value: a, key: i });
+      if (a instanceof q)
+        e.set(n++, { value: a, key: i });
       else
-        for (const d of a.$names)
-          t.set(d, { value: a, key: i });
+        for (const f of a.$names)
+          e.set(f, { value: a, key: i });
     }
-    if (!e)
+    if (!t)
       for (const [i, a] of this.$parent?.buildInputMap() ?? [])
-        t.set(i, a);
+        e.set(i, a);
     for (const [, { command: i }] of this.$children)
-      for (const [a, d] of i.buildInputMap(!0))
-        t.set(a, d);
-    return t;
+      for (const [a, f] of i.buildInputMap(!0))
+        e.set(a, f);
+    return e;
+  }
+  /**
+   * Allows surpassing the amount of arguments specified.
+   * @returns this
+   */
+  allowSurpassArgLimit() {
+    return this.$allowSurpassArgLimit = !0, this;
   }
   /**
    * Gets the full command path (name including parents).
    * @returns The full command path.
    */
   fullCommandPath() {
-    const e = [];
-    let t = this;
-    for (; t; )
-      e.unshift(t.$names[0]), t = t.$parent;
-    return e.join(" ");
+    const t = [];
+    let e = this;
+    for (; e; )
+      t.unshift(e.$names[0]), e = e.$parent;
+    return t.join(" ");
   }
   /**
    * The default error screen.
    * @param errors The errors.
    */
-  defaultErrorScreen(e) {
-    let t = !1;
-    const r = [];
-    for (const s of e)
-      s instanceof J ? (s instanceof P || s.print(), t = !0) : r.push(s);
-    if (r.length) throw r[0];
-    if (!t) return;
+  defaultErrorScreen(t) {
+    let e = !1;
+    const n = [];
+    for (const s of t)
+      s instanceof K ? (s instanceof L || s.print(), e = !0) : n.push(s);
+    if (n.length) throw n[0];
+    if (!e) return;
     const i = (s, c) => s.padEnd(c, " ");
     console.log(
       `${b("usage:")} ${v(this.fullCommandPath())} ${O("[options] [arguments]")}`
     ), this.$description && console.log(`${this.$description}`), this.$version && console.log(`${b("version")} ${this.$version}`);
-    const a = Object.entries(this.$input).filter(([, s]) => s instanceof _).map(([s, c]) => ({ key: s, entry: c }));
+    const a = Object.entries(this.$input).filter(([, s]) => s instanceof F).map(([s, c]) => ({ key: s, entry: c }));
     if (a.length > 0) {
       console.log(b("options:"));
       const s = Math.max(
         ...a.map(({ entry: c }) => c.$names.join(", ").length)
       );
       for (const { entry: c } of a) {
-        const u = c.$names.map((p) => p.length === 1 ? `-${p}` : `--${p}`).join(", "), h = `  ${v(i(u, s + 4))}${O(c.$description ?? "")}`;
+        const d = c.$names.map((p) => p.length === 1 ? `-${p}` : `--${p}`).join(", "), h = `  ${v(i(d, s + 4))}${O(c.$description ?? "")}`;
         console.log(h);
       }
     }
-    const d = Object.entries(this.$input).filter(([, s]) => s instanceof B).map(([s, c]) => ({
+    const f = Object.entries(this.$input).filter(([, s]) => s instanceof q).map(([s, c]) => ({
       key: s,
       entry: c
     }));
-    if (d.length > 0) {
+    if (f.length > 0) {
       console.log(b("arguments:"));
-      const s = Math.max(...d.map(({ key: c }) => c.length));
-      for (const { key: c, entry: u } of d) {
-        const h = u.$required ? `<${c}>` : `[${c}]`, p = `  ${v(i(h, s + 4))}${O(u.$description ?? "")}`;
+      const s = Math.max(...f.map(({ key: c }) => c.length));
+      for (const { key: c, entry: d } of f) {
+        const h = d.$required ? `<${c}>` : `[${c}]`, p = `  ${v(i(h, s + 4))}${O(d.$description ?? "")}`;
         console.log(p);
       }
     }
@@ -359,14 +371,14 @@ class F {
       console.log(b("sub commands:"));
       const s = Array.from(
         new Map(
-          [...this.$children.values()].map((u) => [
-            u.command.$names[0],
-            u.command
+          [...this.$children.values()].map((d) => [
+            d.command.$names[0],
+            d.command
           ])
         ).values()
-      ), c = Math.max(...s.map((u) => u.$names[0].length));
-      for (const u of s) {
-        const h = `  ${v(i(u.$names[0], c + 4))}${O(u.$description) ?? ""}`;
+      ), c = Math.max(...s.map((d) => d.$names[0].length));
+      for (const d of s) {
+        const h = `  ${v(i(d.$names[0], c + 4))}${O(d.$description) ?? ""}`;
         console.log(h);
       }
       console.log(), console.log(
@@ -380,40 +392,75 @@ class F {
    * @param input The parsed input, if possible.
    * @returns this
    */
-  async handleErrors(e, t) {
-    let r = this;
-    for (; !r.$errorFn && r.$parent; )
-      r = r.$parent;
-    return r.$errorFn ? await r.$errorFn(r, e, t ?? {}) : this.defaultErrorScreen(e), this;
+  async handleErrors(t, e) {
+    let n = this;
+    for (; !n.$errorFn && n.$parent; )
+      n = n.$parent;
+    return n.$errorFn ? await n.$errorFn(n, t, e ?? {}) : this.defaultErrorScreen(t), this;
   }
   /**
    * Runs a command.
    * @param argv The arguments to run the command with. Defaults to your runtime's `argv` equivalent.
    * @returns this
    */
-  async run(e) {
-    e || (e = typeof Bun < "u" ? Bun.argv.slice(2) : typeof Deno < "u" ? Deno.args : process.argv.slice(2));
-    const t = await this.parse(e);
-    if (t.isHelp)
-      return t.command.handleErrors([new P(t.command)]), this;
-    if (t.isVersion)
+  async run(t) {
+    t || (t = typeof Bun < "u" ? Bun.argv.slice(2) : typeof Deno < "u" ? Deno.args : process.argv.slice(2));
+    const e = await this.parse(t);
+    if (e.isHelp)
+      return e.command.handleErrors([new L(e.command)]), this;
+    if (e.isVersion)
       return console.log(
-        `${t.command.fullCommandPath()} version ${t.command.$version}`
+        `${e.command.fullCommandPath()} version ${e.command.$version}`
       ), this;
     try {
-      t.errors.length > 0 ? await t.command.handleErrors(t.errors, t.input) : t.command.$fn ? await t.command.$fn(t.input) : await t.command.handleErrors(
-        [new P(t.command), ...t.errors],
-        t.input
-      );
-    } catch (r) {
-      r instanceof Error || console.warn(
+      if (e.errors.length > 0)
+        await e.command.handleErrors(e.errors, e.input);
+      else if (!e.command.$fn)
+        await e.command.handleErrors(
+          [new L(e.command), ...e.errors],
+          e.input
+        );
+      else {
+        const n = oe(e.command);
+        n.length > 0 ? await ie(n)(e.input, async () => {
+          await e.command.$fn?.(e.input);
+        }) : await e.command.$fn(e.input);
+      }
+    } catch (n) {
+      n instanceof Error || console.warn(
         "[convoker] an error that is not instance of `Error` was thrown. this may cause undefined behavior."
-      ), await t.command.handleErrors([r]);
+      ), await e.command.handleErrors([n]);
     }
     return this;
   }
 }
+function oe(r) {
+  const t = [];
+  let e = r;
+  for (; e; )
+    e.$middlewares.length && t.unshift(...e.$middlewares), e = e.$parent;
+  return t;
+}
+function ie(r) {
+  return (t, e) => {
+    let n = -1;
+    const i = (a) => {
+      if (a <= n)
+        return Promise.reject(new Error("next() called multiple times"));
+      n = a;
+      const f = r[a];
+      if (!f)
+        return e ? e() : Promise.resolve();
+      try {
+        return Promise.resolve(f(t, () => i(a + 1)));
+      } catch (s) {
+        return Promise.reject(s);
+      }
+    };
+    return i(0);
+  };
+}
 export {
-  F as Command,
-  ct as l
+  B as Command,
+  de as l
 };

package/dist/error.d.ts

@@ -1,7 +1,7 @@
 /**
  * Command action function.
  */
-declare type ActionFn<T extends Input> = (input: InferInput<T>) => void | Promise<void>;
+declare type ActionFn<T extends Input> = (input: InferInput<T>) => any | Promise<any>;
 
 /**
  * A basic input type.
@@ -62,6 +62,10 @@ declare class Command<T extends Input = Input> {
      * The action function of this command.
      */
     $fn: ActionFn<T> | undefined;
+    /**
+     * The middlewares associated with this command.
+     */
+    $middlewares: MiddlewareFn<T>[];
     /**
      * The error handler of this command.
      */
@@ -97,6 +101,12 @@ declare class Command<T extends Input = Input> {
      * @returns this
      */
     input<TInput extends Input>(input: TInput): Command<TInput>;
+    /**
+     * Adds a chain of middlewares.
+     * @param fns The middlewares to use.
+     * @returns this
+     */
+    use(...fns: MiddlewareFn<T>[]): this;
     /**
      * Sets the action function for this command.
      * @param fn The action.
@@ -140,6 +150,11 @@ declare class Command<T extends Input = Input> {
      */
     parse(argv: string[]): Promise<ParseResult<T>>;
     private buildInputMap;
+    /**
+     * Allows surpassing the amount of arguments specified.
+     * @returns this
+     */
+    allowSurpassArgLimit(): this;
     /**
      * Gets the full command path (name including parents).
      * @returns The full command path.
@@ -283,6 +298,11 @@ declare type Kind = BasicKind | StandardSchemaV1<any, any>;
  */
 declare type Kind_2 = BasicKind_2 | StandardSchemaV1_2<any, any>;
 
+/**
+ * Command middleware function.
+ */
+declare type MiddlewareFn<T extends Input = Input> = (input: InferInput<T>, next: () => Promise<any>) => any | Promise<any>;
+
 export declare class MissingRequiredArgumentError extends ConvokerError {
     /**
      * The argument key.

package/dist/error.js

@@ -1,4 +1,4 @@
-import { C as n, H as s, I as a, a as e, M as i, T as t, U as E } from "./chunks/error-CBR2veuf.js";
+import { C as n, H as s, I as a, M as e, a as i, T as t, U as E } from "./chunks/error-CyKscMUD.js";
 export {
   n as ConvokerError,
   s as HelpAskedError,

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { Theme as Theme_2 } from '../../../../../../../../../../src/color';
 /**
  * Command action function.
  */
-export declare type ActionFn<T extends Input> = (input: InferInput<T>) => void | Promise<void>;
+export declare type ActionFn<T extends Input> = (input: InferInput<T>) => any | Promise<any>;
 
 /**
  * Creates a new positional argument.
@@ -190,6 +190,10 @@ export declare class Command<T extends Input = Input> {
      * The action function of this command.
      */
     $fn: ActionFn<T> | undefined;
+    /**
+     * The middlewares associated with this command.
+     */
+    $middlewares: MiddlewareFn<T>[];
     /**
      * The error handler of this command.
      */
@@ -225,6 +229,12 @@ export declare class Command<T extends Input = Input> {
      * @returns this
      */
     input<TInput extends Input>(input: TInput): Command<TInput>;
+    /**
+     * Adds a chain of middlewares.
+     * @param fns The middlewares to use.
+     * @returns this
+     */
+    use(...fns: MiddlewareFn<T>[]): this;
     /**
      * Sets the action function for this command.
      * @param fn The action.
@@ -268,6 +278,11 @@ export declare class Command<T extends Input = Input> {
      */
     parse(argv: string[]): Promise<ParseResult<T>>;
     private buildInputMap;
+    /**
+     * Allows surpassing the amount of arguments specified.
+     * @returns this
+     */
+    allowSurpassArgLimit(): this;
     /**
      * Gets the full command path (name including parents).
      * @returns The full command path.
@@ -577,6 +592,11 @@ declare const magenta: (input: any) => string;
 
 declare const magentaBright: (input: any) => string;
 
+/**
+ * Command middleware function.
+ */
+export declare type MiddlewareFn<T extends Input = Input> = (input: InferInput<T>, next: () => Promise<any>) => any | Promise<any>;
+
 declare class MissingRequiredArgumentError extends ConvokerError {
     /**
      * The argument key.

package/dist/index.js

@@ -1,8 +1,8 @@
 import { Command as m, l as e } from "./command.js";
-import { e as a } from "./chunks/error-CBR2veuf.js";
-import { i as f } from "./chunks/input-BfYvlWdG.js";
+import { e as a } from "./chunks/error-CyKscMUD.js";
+import { i as f } from "./chunks/input-WNu16aNE.js";
 import { a as s } from "./chunks/color-CiruG_zQ.js";
-import { i } from "./chunks/index-D7JQKzRX.js";
+import { i } from "./chunks/index-BluQjWvw.js";
 export {
   m as Command,
   s as color,

package/dist/input.js

@@ -1,5 +1,5 @@
-import "./chunks/standard-schema-CFxVDMhv.js";
-import { O as t, P as i, a as n, c as p, o as r, p as e } from "./chunks/input-BfYvlWdG.js";
+import "./chunks/standard-schema-BHKzvwIS.js";
+import { O as t, P as i, a as n, c as p, o as r, p as e } from "./chunks/input-WNu16aNE.js";
 export {
   t as Option,
   i as Positional,

package/dist/prompt.js

@@ -1,9 +1,9 @@
 import "./chunks/color-CiruG_zQ.js";
-import "./chunks/standard-schema-CFxVDMhv.js";
-import "./chunks/error-CBR2veuf.js";
+import "./chunks/standard-schema-BHKzvwIS.js";
+import "./chunks/error-CyKscMUD.js";
 import "./chunks/utils-DdmSEjLc.js";
 import { d as m } from "./chunks/__vite-browser-external-DQYBmsno.js";
-import { c as i, e as c, m as d, p as f, b as l, a as x, s as h, t as w } from "./chunks/index-D7JQKzRX.js";
+import { c as i, e as c, m as d, p as f, b as l, a as x, s as h, t as w } from "./chunks/index-BluQjWvw.js";
 export {
   i as confirm,
   c as editor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoker",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A simple, type safe CLI framework for TypeScript.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",