convoker 0.1.0 → 0.3.0

package/dist/command.js

@@ -1,88 +1,88 @@
-import { D as L, b, c as v, g as M } from "./chunks/color-CiruG_zQ.js";
-import { s as V } from "./chunks/index-G2nVXKup.js";
-import { m as q, i as O, b as W, a as j } from "./chunks/utils-DdmSEjLc.js";
-import { M as R, a as z, L as N, H as A, U as J } from "./chunks/error-Cj2qDfOl.js";
-import { P as B, c as K, O as H } from "./chunks/input-COjWPD53.js";
-async function G() {
-  if (W && process.stdout?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
-    return n.toWeb(process.stdout);
+import { D as V, b, c as v, g as O } from "./chunks/color-CiruG_zQ.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 (j && process.stdout?.writable) {
+    const { Writable: r } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
+    return r.toWeb(process.stdout);
   }
-  return O && 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 Q() {
-  if (W && process.stderr?.writable) {
-    const { Writable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
-    return n.toWeb(process.stderr);
+async function X() {
+  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 O && 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 X() {
-  if (W && process.stdin?.readable) {
-    const { Readable: n } = await import("./chunks/__vite-browser-external-DQYBmsno.js").then((t) => t._);
-    return n.toWeb(process.stdin);
+async function Y() {
+  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 O && 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 = L, g;
-function I(n) {
-  m = n;
+let m = V, g;
+function H(r) {
+  m = r;
 }
-async function T(n) {
-  g = q(
+async function _(r) {
+  g = z(
     {
       format: "text",
-      stdout: await G(),
-      stderr: await Q(),
-      stdin: await X()
+      stdout: await Q(),
+      stderr: await X(),
+      stdin: await Y()
     },
-    n
+    r
   );
 }
-async function Y() {
-  await T({});
+async function Z() {
+  await _({});
 }
-function S(n, ...t) {
-  const e = (/* @__PURE__ */ new Date()).toISOString(), r = t.map((o) => typeof o == "string" ? o : JSON.stringify(o, 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: e, level: n, message: r }) + `
+      return JSON.stringify({ timestamp: e, level: r, message: n }) + `
 `;
     case "xml":
       return `<log>
   <timestamp>${e}</timestamp>
-  <level>${n}</level>
-  <message>${r}</message>
+  <level>${r}</level>
+  <message>${n}</message>
 </log>
 `;
     case "yaml":
       return `- timestamp: ${e}
-  level: ${n}
-  message: "${r.replace(/"/g, '\\"')}"
+  level: ${r}
+  message: "${n.replace(/"/g, '\\"')}"
 `;
     case "csv":
-      return `"${e}","${n}","${r.replace(/"/g, '""')}"
+      return `"${e}","${r}","${n.replace(/"/g, '""')}"
 `;
     case "text":
     default:
-      return `[${e}] [${n.toUpperCase()}] ${r}
+      return `[${e}] [${r.toUpperCase()}] ${n}
 `;
   }
 }
-function E(n, t) {
-  switch (n) {
+function E(r, t) {
+  switch (r) {
     case "trace":
       return m.secondary ? m.secondary(t) : t;
     case "info":
@@ -97,54 +97,54 @@ function E(n, t) {
       return t;
   }
 }
-async function k(n, t) {
-  const e = n.getWriter();
+async function k(r, t) {
+  const e = r.getWriter();
   try {
     await e.write(t);
   } finally {
     e.releaseLock();
   }
 }
-async function Z(...n) {
-  const t = S("trace", ...n), e = E("trace", t);
+async function ee(...r) {
+  const t = S("trace", ...r), e = E("trace", t);
   await k(g.stdout, e);
 }
-async function x(...n) {
-  const t = S("info", ...n), e = E("info", t);
+async function te(...r) {
+  const t = S("info", ...r), e = E("info", t);
   await k(g.stdout, e);
 }
-async function tt(...n) {
-  const t = S("warn", ...n), e = E("warn", t);
+async function ne(...r) {
+  const t = S("warn", ...r), e = E("warn", t);
   await k(g.stdout, e);
 }
-async function et(...n) {
-  const t = S("error", ...n), e = E("error", t);
+async function re(...r) {
+  const t = S("error", ...r), e = E("error", t);
   await k(g.stderr, e);
 }
-async function nt(...n) {
-  const t = S("fatal", ...n), e = E("fatal", t);
-  await k(g.stderr, e), O ? 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: et,
-  fatal: nt,
-  info: x,
-  setConfig: T,
-  setTheme: I,
-  setup: Y,
-  trace: Z,
-  warn: tt
+  error: re,
+  fatal: se,
+  info: te,
+  setConfig: _,
+  setTheme: H,
+  setup: Z,
+  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(t, e, r) {
-    this.$children = /* @__PURE__ */ new Map(), this.$allowUnknownOptions = !1, this.$input = {}, this.$fn = void 0, this.$errorFn = void 0, this.$names = Array.isArray(t) ? t : [t], this.$description = e, 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.
@@ -178,6 +178,14 @@ class F {
   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.
@@ -202,17 +210,17 @@ class F {
   add(t) {
     t.$parent = this;
     const e = { command: t, alias: t.$names[0] };
-    for (let r = 0; r < t.$names.length; r++)
-      r === 0 && this.$children.set(t.$names[r], { command: t }), this.$children.set(t.$names[r], e);
+    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(t, e, r) {
+  subCommand(t, e, n) {
     if (typeof e == "function") {
-      const c = new F(t);
-      return e(c), this.add(c), this;
+      const a = new B(t);
+      return e(a), this.add(a), this;
     }
-    const o = new F(t, e, r);
-    return this.add(o), o;
+    const i = new B(t, e, n);
+    return this.add(i), i;
   }
   /**
    * Allows unknown options.
@@ -227,81 +235,89 @@ class F {
    * @returns A parse result.
    */
   async parse(t) {
-    let e = this, r = !1;
-    const o = {}, c = [], d = {}, s = [], a = e.buildInputMap();
-    function u(f, i) {
-      const l = a.get(f);
-      return l ? l.value : (!e.$allowUnknownOptions && !i && s.push(new J(e, f)), null);
+    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 p(f, i, l) {
-      i.$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 h = !1, C = !1;
-    for (let f = 0; f < t.length; f++) {
-      const i = t[f];
-      if (i.startsWith("--")) {
-        const [l, w] = i.slice(2).split("=");
+    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" && (h = !0, y = !0);
-        const $ = u(l, y);
-        $ && (w === void 0 ? p(
+        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 : t[++f]
-        ) : p(l, $, w));
-      } else if (i.startsWith("-")) {
-        const [l, w] = i.slice(1).split("="), y = l.split("");
+          $.$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 U = !1;
-          D === "h" ? (C = !0, U = !0) : D === "V" && (h = !0, U = !0);
-          const P = u(D, U);
-          P && (P.$kind !== "boolean" && $ === void 0 && ($ = t[++f]), p(D, P, $), $ = 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
-        e.$children.has(i) && !r ? (e = e.$children.get(i).command, e.$theme && (V(e.$theme), I(e.$theme))) : (r = !0, c.push(i));
+        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 _ = 0;
-    for (const f in e.$input) {
-      const i = e.$input[f];
+    let M = 0;
+    for (const u in e.$input) {
+      const o = e.$input[u];
       let l;
-      if (i instanceof B)
-        l = c[_++];
+      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 i.$names)
-          if (d[w] !== void 0) {
-            l = d[w];
+        for (const w of o.$names)
+          if (f[w] !== void 0) {
+            l = o.$list ? f[w].split(o.$separator ?? ",") : f[w];
             break;
           }
-      l !== void 0 ? o[f] = await K(i.$kind, l) : i.$default !== void 0 ? o[f] = i.$default : i.$required && (i instanceof H ? s.push(new R(e, f, i)) : s.push(new z(e, f, i)));
+      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 {
-      input: o,
+    const I = a.slice(M);
+    return !e.$allowSurpassArgLimit && I.length > 0 && s.push(new N(e)), {
+      input: i,
       command: e,
       errors: s,
-      isVersion: h,
-      isHelp: C
+      isVersion: p,
+      isHelp: W
     };
   }
   buildInputMap(t) {
     const e = /* @__PURE__ */ new Map();
-    let r = 0;
-    for (const o in this.$input) {
-      const c = this.$input[o];
-      if (c instanceof B)
-        e.set(r++, { value: c, key: o });
+    let n = 0;
+    for (const i in this.$input) {
+      const a = this.$input[i];
+      if (a instanceof q)
+        e.set(n++, { value: a, key: i });
       else
-        for (const d of c.$names)
-          e.set(d, { value: c, key: o });
+        for (const f of a.$names)
+          e.set(f, { value: a, key: i });
     }
     if (!t)
-      for (const [o, c] of this.$parent?.buildInputMap() ?? [])
-        e.set(o, c);
-    for (const [, { command: o }] of this.$children)
-      for (const [c, d] of o.buildInputMap(!0))
-        e.set(c, d);
+      for (const [i, a] of this.$parent?.buildInputMap() ?? [])
+        e.set(i, a);
+    for (const [, { command: i }] of this.$children)
+      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.
@@ -319,51 +335,51 @@ class F {
    */
   defaultErrorScreen(t) {
     let e = !1;
-    const r = [];
+    const n = [];
     for (const s of t)
-      s instanceof N ? (s instanceof A || s.print(), e = !0) : r.push(s);
-    if (r.length) throw r[0];
+      s instanceof K ? (s instanceof L || s.print(), e = !0) : n.push(s);
+    if (n.length) throw n[0];
     if (!e) return;
-    const o = (s, a) => s.padEnd(a, " ");
+    const i = (s, c) => s.padEnd(c, " ");
     console.log(
-      `${b("usage:")} ${v(this.fullCommandPath())} ${M("[options] [arguments]")}`
+      `${b("usage:")} ${v(this.fullCommandPath())} ${O("[options] [arguments]")}`
     ), this.$description && console.log(`${this.$description}`), this.$version && console.log(`${b("version")} ${this.$version}`);
-    const c = Object.entries(this.$input).filter(([, s]) => s instanceof H).map(([s, a]) => ({ key: s, entry: a }));
-    if (c.length > 0) {
+    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(
-        ...c.map(({ entry: a }) => a.$names.join(", ").length)
+        ...a.map(({ entry: c }) => c.$names.join(", ").length)
       );
-      for (const { entry: a } of c) {
-        const u = a.$names.map((h) => h.length === 1 ? `-${h}` : `--${h}`).join(", "), p = `  ${v(o(u, s + 4))}${M(a.$description ?? "")}`;
-        console.log(p);
+      for (const { entry: c } of a) {
+        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, a]) => ({
+    const f = Object.entries(this.$input).filter(([, s]) => s instanceof q).map(([s, c]) => ({
       key: s,
-      entry: a
+      entry: c
     }));
-    if (d.length > 0) {
+    if (f.length > 0) {
       console.log(b("arguments:"));
-      const s = Math.max(...d.map(({ key: a }) => a.length));
-      for (const { key: a, entry: u } of d) {
-        const p = u.$required ? `<${a}>` : `[${a}]`, h = `  ${v(o(p, s + 4))}${M(u.$description ?? "")}`;
-        console.log(h);
+      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);
       }
     }
     if (this.$children.size > 0) {
       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()
-      ), a = Math.max(...s.map((u) => u.$names[0].length));
-      for (const u of s) {
-        const p = `  ${v(o(u.$names[0], a + 4))}${M(u.$description) ?? ""}`;
-        console.log(p);
+      ), 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(
         `run '${v(`${this.fullCommandPath()} <command> --help`)}' for more info on a command.`
@@ -377,10 +393,10 @@ class F {
    * @returns this
    */
   async handleErrors(t, e) {
-    let r = this;
-    for (; !r.$errorFn && r.$parent; )
-      r = r.$parent;
-    return r.$errorFn ? await r.$errorFn(r, t, e ?? {}) : this.defaultErrorScreen(t), this;
+    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.
@@ -391,25 +407,60 @@ class F {
     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 A(e.command)]), this;
+      return e.command.handleErrors([new L(e.command)]), this;
     if (e.isVersion)
       return console.log(
         `${e.command.fullCommandPath()} version ${e.command.$version}`
       ), this;
     try {
-      e.errors.length > 0 ? await e.command.handleErrors(e.errors, e.input) : e.command.$fn ? await e.command.$fn(e.input) : await e.command.handleErrors(
-        [new A(e.command), ...e.errors],
-        e.input
-      );
-    } catch (r) {
-      r instanceof Error || console.warn(
-        "[lunarcli] an error that is not instance of `Error` was thrown. this may cause undefined behavior."
-      ), await e.command.handleErrors([r]);
+      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 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
 };