npm - @vc-shell/api-client-generator - Versions diffs - 2.0.7 → 2.0.8 - Mend

@vc-shell/api-client-generator 2.0.7 → 2.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md +10 -7
package/dist/api-client-generator.js +247 -209
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -56,13 +56,13 @@ Add the dependencies to your project's **package.json**:
    The options are listed in the table below:
-   | Options                      | Description                                                                                                                                                                                                                          | Example                                                                  |
-   | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
-   | `--APP_PLATFORM_MODULES`     | Platform modules to generate API client.<br>{==string[]==} <br> Supports spaces in module lists: `[Module1, Module2]` or `[Module1,Module2]`<br>Customize the `--APP_PLATFORM_MODULES` list<br>to match your project's requirements. | `--APP_PLATFORM_MODULES='[VirtoCommerce.Catalog, VirtoCommerce.Orders]'` |
-   | `--APP_API_CLIENT_DIRECTORY` | Output directory for generated API clients. <br>{==string==}                                                                                                                                                                         | `--APP_API_CLIENT_DIRECTORY=./src/api_client/`                           |
-   | `--APP_PLATFORM_URL`         | Platform URL to obtain client API configs. <br>{==string==}                                                                                                                                                                          | `--APP_PLATFORM_URL=https://vcmp-dev.govirto.com/`                       |
-   | `--APP_TYPE_STYLE`           | Sets the type style for generated DTOs. Can be 'Class' or 'Interface'.<br>{==string==}                                                                                                                                               | `--APP_TYPE_STYLE=Interface`                                             |
-   | `--VERBOSE`                  | Enable verbose logging. <br>{==boolean==}                                                                                                                                                                                            | `--VERBOSE=true`                                                         |
+   | Options                      | Description                                                                                                                                                                                                                                                                   | Example                                                                  |
+   | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+   | `--APP_PLATFORM_MODULES`     | Platform modules to generate API client.<br>{==string[]==} <br> **Always quote the value** so the shell does not split it: `'[Module1, Module2]'`. Spaces inside quotes are fine. The generator validates the value and fails fast with a quoting hint if it looks truncated. | `--APP_PLATFORM_MODULES='[VirtoCommerce.Catalog, VirtoCommerce.Orders]'` |
+   | `--APP_API_CLIENT_DIRECTORY` | Output directory for generated API clients. <br>{==string==}                                                                                                                                                                                                                  | `--APP_API_CLIENT_DIRECTORY=./src/api_client/`                           |
+   | `--APP_PLATFORM_URL`         | Platform URL to obtain client API configs. <br>{==string==}                                                                                                                                                                                                                   | `--APP_PLATFORM_URL=https://vcmp-dev.govirto.com/`                       |
+   | `--APP_TYPE_STYLE`           | Sets the type style for generated DTOs. Can be 'Class' or 'Interface'.<br>{==string==}                                                                                                                                                                                        | `--APP_TYPE_STYLE=Interface`                                             |
+   | `--VERBOSE`                  | Enable verbose logging. <br>{==boolean==}                                                                                                                                                                                                                                     | `--VERBOSE=true`                                                         |
    !!! note
    For the `--APP_TYPE_STYLE` parameter, use **exactly** `"Class"` or `"Interface"` (case-sensitive). Any other value will cause an error.
@@ -70,6 +70,9 @@ Add the dependencies to your project's **package.json**:
    !!! tip
    Use `--APP_TYPE_STYLE=Interface` for better TypeScript integration and smaller bundle sizes. Use `--APP_TYPE_STYLE=Class` when you need runtime type checking or class-specific features.
+   !!! warning
+   When passing `--APP_PLATFORM_MODULES` on the command line, wrap the value in quotes. Without quotes, the shell splits `[A, B]` on the space and only the first module is seen — the generator now detects this and exits with an error instead of silently generating a partial client.
 3. Configure Platform URL and other settings in your project's **.env** file:
    ```title="vc-app-extend/.env"

package/dist/api-client-generator.js CHANGED Viewed

@@ -1,74 +1,74 @@
 import e from "chalk";
-import { sync as v } from "cross-spawn";
-import { resolveConfig as j } from "vite";
-import { existsSync as w, mkdirSync as I, writeFileSync as T, readdirSync as O, readFileSync as x } from "node:fs";
-import m, { dirname as N, resolve as B, join as b, relative as S } from "node:path";
-import { fileURLToPath as L } from "node:url";
-import { cwd as M } from "node:process";
-import U from "mri";
-const $ = L(import.meta.url), F = N($);
-class V {
+import { sync as M } from "cross-spawn";
+import { resolveConfig as N } from "vite";
+import { existsSync as w, mkdirSync as R, writeFileSync as O, readdirSync as U, readFileSync as k } from "node:fs";
+import h, { dirname as F, resolve as I, join as E, relative as x } from "node:path";
+import { fileURLToPath as $ } from "node:url";
+import { cwd as V } from "node:process";
+import G from "mri";
+const K = $(import.meta.url), Y = F(K);
+class W {
   workingDirectory;
   generatorDirectory;
   assetsDirectory;
   apiClientDirectory;
   nswagPaths;
   constructor(r) {
-    this.workingDirectory = M(), this.generatorDirectory = B(F, ".."), this.assetsDirectory = b(this.generatorDirectory, "public", "assets"), this.apiClientDirectory = B(this.workingDirectory, r), this.nswagPaths = {
-      configuration: b(S(this.workingDirectory, this.assetsDirectory), "config.nswag"),
+    this.workingDirectory = V(), this.generatorDirectory = I(Y, ".."), this.assetsDirectory = E(this.generatorDirectory, "public", "assets"), this.apiClientDirectory = I(this.workingDirectory, r), this.nswagPaths = {
+      configuration: E(x(this.workingDirectory, this.assetsDirectory), "config.nswag"),
       authApiBase: "authApiBase.ts",
       templates: "templates"
     };
   }
   resolveApiClientPaths(r) {
-    const n = `${r.toLowerCase()}.ts`;
+    const i = `${r.toLowerCase()}.ts`;
     return {
-      fileName: n,
-      nswag: b(S(this.assetsDirectory, this.apiClientDirectory), n),
-      console: b(S(this.workingDirectory, this.apiClientDirectory), n)
+      fileName: i,
+      nswag: E(x(this.assetsDirectory, this.apiClientDirectory), i),
+      console: E(x(this.workingDirectory, this.apiClientDirectory), i)
     };
   }
 }
-function D(o, r, n = []) {
+function L(o, r, i = []) {
   const t = { ...o };
-  for (const i of n)
-    i in r && (t[i] = r[i]);
-  for (const [i, s] of Object.entries(r)) {
-    const a = i;
-    i in t && typeof t[a] == "object" && !Array.isArray(t[a]) && typeof s == "object" && !Array.isArray(s) && s !== null ? t[a] = { ...t[a], ...s } : n.includes(i) || (t[a] = s);
+  for (const n of i)
+    n in r && (t[n] = r[n]);
+  for (const [n, s] of Object.entries(r)) {
+    const a = n;
+    n in t && typeof t[a] == "object" && !Array.isArray(t[a]) && typeof s == "object" && !Array.isArray(s) && s !== null ? t[a] = { ...t[a], ...s } : i.includes(n) || (t[a] = s);
   }
   return t;
 }
-function G(o, r, n, t) {
-  const i = {
+function q(o, r, i, t) {
+  const n = {
     extends: "@vc-shell/ts-config/tsconfig.json",
     compilerOptions: {
       baseUrl: ".",
-      declarationDir: m.join(n, "types"),
+      declarationDir: h.join(i, "types"),
       outDir: t,
       rootDir: "./"
     },
     files: [],
     include: ["*.ts"]
   };
-  let s = { ...i };
+  let s = { ...n };
   if (w(o))
     try {
-      const a = x(o, "utf-8");
+      const a = k(o, "utf-8");
       try {
         const l = JSON.parse(a);
-        s = D(i, l), l.compilerOptions && typeof l.compilerOptions == "object" && (s.compilerOptions = {
-          ...i.compilerOptions,
+        s = L(n, l), l.compilerOptions && typeof l.compilerOptions == "object" && (s.compilerOptions = {
+          ...n.compilerOptions,
           ...l.compilerOptions
-        }, s.compilerOptions.outDir = t, s.compilerOptions.declarationDir = m.join(t, "types"));
-        const p = Array.isArray(l.files) ? l.files : [];
-        s.files = Array.from(/* @__PURE__ */ new Set([...r, ...p])), console.log("api-client-generator %s Updated existing tsconfig.json", e.greenBright("success"));
+        }, s.compilerOptions.outDir = t, s.compilerOptions.declarationDir = h.join(t, "types"));
+        const c = Array.isArray(l.files) ? l.files : [];
+        s.files = Array.from(/* @__PURE__ */ new Set([...r, ...c])), console.log("api-client-generator %s Updated existing tsconfig.json", e.greenBright("success"));
       } catch (l) {
         console.error(
           "api-client-generator %s Failed to parse existing tsconfig.json, creating new one",
           e.yellow("warning"),
           l
-        ), s = { ...i }, s.files = r;
+        ), s = { ...n }, s.files = r;
       }
     } catch (a) {
       console.error("api-client-generator %s Failed to read existing tsconfig.json", e.red("error"), a);
@@ -77,158 +77,158 @@ function G(o, r, n, t) {
     s.files = r, console.log("api-client-generator %s Created new tsconfig.json", e.greenBright("success"));
   return s;
 }
-function E(o) {
+function b(o) {
   let r = o;
-  const n = [".d.ts", ".ts", ".js"];
+  const i = [".d.ts", ".ts", ".js"];
   let t;
   do {
     t = !1;
-    for (const i of n)
-      if (r.toLowerCase().endsWith(i.toLowerCase())) {
-        r = r.substring(0, r.length - i.length), t = !0;
+    for (const n of i)
+      if (r.toLowerCase().endsWith(n.toLowerCase())) {
+        r = r.substring(0, r.length - n.length), t = !0;
         break;
       }
   } while (t);
-  return r = r.replace(/\/\.\//g, "/"), r = r.replace(/\/+/g, "/"), r = r.replace(/\.\.\//g, ""), r !== "." && !r.startsWith("./") && !r.startsWith("/") && !m.isAbsolute(r) && (r = "./" + r), r.startsWith("//") && (r = "./" + r.substring(2)), r !== "." && r.startsWith("/") && !r.startsWith("./") && !m.isAbsolute(r) && (r = "." + r), r !== "." && r.startsWith("././") && (r = "./" + r.substring(3)), r;
+  return r = r.replace(/\/\.\//g, "/"), r = r.replace(/\/+/g, "/"), r = r.replace(/\.\.\//g, ""), r !== "." && !r.startsWith("./") && !r.startsWith("/") && !h.isAbsolute(r) && (r = "./" + r), r.startsWith("//") && (r = "./" + r.substring(2)), r !== "." && r.startsWith("/") && !r.startsWith("./") && !h.isAbsolute(r) && (r = "." + r), r !== "." && r.startsWith("././") && (r = "./" + r.substring(3)), r;
 }
-function _(o) {
-  let r = E(o);
-  r = m.basename(r);
-  const n = r.toLowerCase(), t = n.indexOf(".");
+function S(o) {
+  let r = b(o);
+  r = h.basename(r);
+  const i = r.toLowerCase(), t = i.indexOf(".");
   if (t > 0) {
-    const i = n.substring(0, t), s = n.substring(t + 1);
+    const n = i.substring(0, t), s = i.substring(t + 1);
     return {
-      prefix: i,
+      prefix: n,
       coreName: s,
-      fullName: n
+      fullName: i
     };
   }
   return {
     prefix: void 0,
-    coreName: n,
-    fullName: n
+    coreName: i,
+    fullName: i
   };
 }
-function R(o) {
-  return _(o).coreName;
+function j(o) {
+  return S(o).coreName;
 }
-function K(o, r) {
+function J(o, r) {
   if (!o)
     return [];
-  const n = [`./${o}`];
-  return r && n.push(`./${r}.${o}`), n;
+  const i = [`./${o}`];
+  return r && i.push(`./${r}.${o}`), i;
 }
 function P(o) {
   return o.replace(/\\/g, "/");
 }
-function Y(o, r, n, t) {
-  const i = {}, s = /* @__PURE__ */ new Set();
-  for (const d of o) {
-    const g = _(d);
-    if (!g.coreName) continue;
-    const y = g.fullName, c = P(`./${m.join(r, `${y}.js`)}`), h = P(`./${m.join(r, "types", `${y}.d.ts`)}`), u = { import: c, types: h }, f = K(g.coreName, g.prefix);
-    for (const A of f)
-      i[A] = u, t && console.log(
+function z(o, r, i, t) {
+  const n = {}, s = /* @__PURE__ */ new Set();
+  for (const u of o) {
+    const d = S(u);
+    if (!d.coreName) continue;
+    const m = d.fullName, f = P(`./${h.join(r, `${m}.js`)}`), y = P(`./${h.join(r, "types", `${m}.d.ts`)}`), g = { import: f, types: y }, p = J(d.coreName, d.prefix);
+    for (const A of p)
+      n[A] = g, t && console.log(
         "api-client-generator %s Generated standard export: %s -> { import: %s, types: %s }",
         e.blue("debug"),
         e.whiteBright(A),
-        e.whiteBright(c),
-        e.whiteBright(h)
+        e.whiteBright(f),
+        e.whiteBright(y)
       );
-    s.add(g.coreName);
+    s.add(d.coreName);
   }
-  const a = { ...i };
-  if (n)
-    for (const [d, g] of Object.entries(n)) {
-      if (d === ".")
+  const a = { ...n };
+  if (i)
+    for (const [u, d] of Object.entries(i)) {
+      if (u === ".")
         continue;
-      if (typeof g != "object" || g === null) {
+      if (typeof d != "object" || d === null) {
         t && console.log(
           "api-client-generator %s Skipping malformed existing export value for key: %s",
           e.yellow("warning"),
-          d
+          u
         );
         continue;
       }
-      const y = g;
-      if (!y.import || !y.types) {
+      const m = d;
+      if (!m.import || !m.types) {
         t && console.log(
           "api-client-generator %s Skipping existing export with missing import/types for key: %s",
           e.yellow("warning"),
-          d
+          u
         );
         continue;
       }
-      const c = E(d);
-      if (!(!c || c === "."))
-        if (R(c), c in i)
+      const f = b(u);
+      if (!(!f || f === "."))
+        if (j(f), f in n)
           t && console.log(
             "api-client-generator %s Existing export key '%s' was handled by new generation.",
             e.blue("debug"),
-            e.whiteBright(c)
+            e.whiteBright(f)
           );
         else {
-          const h = E(y.import), u = E(y.types);
-          a[c] = {
-            import: P(`${h}.js`),
-            types: P(`${u}.d.ts`)
+          const y = b(m.import), g = b(m.types);
+          a[f] = {
+            import: P(`${y}.js`),
+            types: P(`${g}.d.ts`)
           }, t && console.log(
             "api-client-generator %s Preserved existing export: %s -> { import: %s, types: %s }",
             e.blue("debug"),
-            e.whiteBright(c),
-            e.whiteBright(`${h}.js`),
-            e.whiteBright(`${u}.d.ts`)
+            e.whiteBright(f),
+            e.whiteBright(`${y}.js`),
+            e.whiteBright(`${g}.d.ts`)
           );
         }
     }
   const l = /* @__PURE__ */ new Map();
-  for (const d in a) {
-    if (d === ".") continue;
-    const g = _(d);
-    g.coreName && l.set(g.coreName, g.fullName);
+  for (const u in a) {
+    if (u === ".") continue;
+    const d = S(u);
+    d.coreName && l.set(d.coreName, d.fullName);
   }
-  const p = Array.from(l.keys());
-  if (p.length === 1) {
-    const d = p[0], g = l.get(d), y = P(`./${m.join(r, `${g}.js`)}`), c = P(`./${m.join(r, "types", `${g}.d.ts`)}`);
+  const c = Array.from(l.keys());
+  if (c.length === 1) {
+    const u = c[0], d = l.get(u), m = P(`./${h.join(r, `${d}.js`)}`), f = P(`./${h.join(r, "types", `${d}.d.ts`)}`);
     a["."] = {
-      import: y,
-      types: c
+      import: m,
+      types: f
     }, t && console.log(
       "api-client-generator %s Set root export for single module '%s': { import: %s, types: %s }",
       e.blue("debug"),
-      e.whiteBright(g),
-      e.whiteBright(y),
-      e.whiteBright(c)
+      e.whiteBright(d),
+      e.whiteBright(m),
+      e.whiteBright(f)
     );
-  } else if (n && "." in n) {
-    const d = n["."];
-    if (typeof d == "object" && d !== null) {
-      const g = d;
-      if (g.import && g.types) {
-        const c = _(g.import).coreName;
-        if (c && p.includes(c)) {
-          const h = l.get(c), u = P(`./${m.join(r, `${h}.js`)}`), f = P(`./${m.join(r, "types", `${h}.d.ts`)}`);
-          a["."] = { import: u, types: f }, t && console.log(
+  } else if (i && "." in i) {
+    const u = i["."];
+    if (typeof u == "object" && u !== null) {
+      const d = u;
+      if (d.import && d.types) {
+        const f = S(d.import).coreName;
+        if (f && c.includes(f)) {
+          const y = l.get(f), g = P(`./${h.join(r, `${y}.js`)}`), p = P(`./${h.join(r, "types", `${y}.d.ts`)}`);
+          a["."] = { import: g, types: p }, t && console.log(
             "api-client-generator %s Preserved and standardized existing root export pointing to module '%s'",
             e.blue("debug"),
-            e.whiteBright(h)
+            e.whiteBright(y)
           );
         } else t && console.log(
           "api-client-generator %s Removed existing root export as it pointed to an unknown or unhandled module '%s'",
           e.yellow("warning"),
-          c || "unknown"
+          f || "unknown"
         );
       } else t && console.log("api-client-generator %s Removed malformed existing root export.", e.yellow("warning"));
     }
   }
   return a;
 }
-function J(o, r, n) {
-  const t = n.VERBOSE ?? !1, i = n.APP_BUILD_DIR ?? "dist", s = [];
-  i && s.push(i), s.push("package.json");
+function H(o, r, i) {
+  const t = i.VERBOSE ?? !1, n = i.APP_BUILD_DIR ?? "dist", s = [];
+  n && s.push(n), s.push("package.json");
   const a = {
-    name: n.APP_PACKAGE_NAME || "api-client",
-    version: n.APP_PACKAGE_VERSION || "1.0.0",
+    name: i.APP_PACKAGE_NAME || "api-client",
+    version: i.APP_PACKAGE_VERSION || "1.0.0",
     files: s,
     exports: {},
     // Add metadata to track generated content
@@ -237,13 +237,13 @@ function J(o, r, n) {
       generatedAt: (/* @__PURE__ */ new Date()).toISOString()
     }
   };
-  let l = { ...a }, p, d, g;
+  let l = { ...a }, c, u, d;
   if (w(o))
     try {
-      const u = x(o, "utf-8");
+      const g = k(o, "utf-8");
       try {
-        const f = JSON.parse(u);
-        typeof f.module == "string" && (d = f.module), typeof f.types == "string" && (g = f.types), l = D(a, f, [
+        const p = JSON.parse(g);
+        typeof p.module == "string" && (u = p.module), typeof p.types == "string" && (d = p.types), l = L(a, p, [
           "name",
           "version",
           "description",
@@ -254,56 +254,56 @@ function J(o, r, n) {
           "scripts",
           "devDependencies",
           "dependencies"
-        ]), l.apiClientGenerator = a.apiClientGenerator, f.files && Array.isArray(f.files) && (l.files = Array.from(/* @__PURE__ */ new Set([...s, ...f.files]))), p = f.exports, console.log("api-client-generator %s Updated existing package.json", e.greenBright("success"));
-      } catch (f) {
+        ]), l.apiClientGenerator = a.apiClientGenerator, p.files && Array.isArray(p.files) && (l.files = Array.from(/* @__PURE__ */ new Set([...s, ...p.files]))), c = p.exports, console.log("api-client-generator %s Updated existing package.json", e.greenBright("success"));
+      } catch (p) {
         console.error(
           "api-client-generator %s Failed to parse existing package.json, creating new one",
           e.yellow("warning"),
-          f
+          p
         );
       }
-    } catch (u) {
-      console.error("api-client-generator %s Failed to read existing package.json", e.red("error"), u);
+    } catch (g) {
+      console.error("api-client-generator %s Failed to read existing package.json", e.red("error"), g);
     }
   else
     console.log("api-client-generator %s Creating new package.json", e.greenBright("success"));
-  l.exports = Y(r, i, p, t);
-  const y = Object.keys(l.exports), c = /* @__PURE__ */ new Set();
-  for (const u of y) {
-    if (u === ".") continue;
-    const f = R(u);
-    f && c.add(f);
+  l.exports = z(r, n, c, t);
+  const m = Object.keys(l.exports), f = /* @__PURE__ */ new Set();
+  for (const g of m) {
+    if (g === ".") continue;
+    const p = j(g);
+    p && f.add(p);
   }
-  if (Array.from(c).length, l.exports && "." in l.exports) {
-    const u = l.exports["."];
-    u && u.import && (l.module = u.import, t && console.log(
+  if (Array.from(f).length, l.exports && "." in l.exports) {
+    const g = l.exports["."];
+    g && g.import && (l.module = g.import, t && console.log(
       "api-client-generator %s Set 'module' field from root export: %s",
       e.blue("debug"),
-      e.whiteBright(u.import)
-    )), u && u.types && (l.types = u.types, t && console.log(
+      e.whiteBright(g.import)
+    )), g && g.types && (l.types = g.types, t && console.log(
       "api-client-generator %s Set 'types' field from root export: %s",
       e.blue("debug"),
-      e.whiteBright(u.types)
+      e.whiteBright(g.types)
     ));
   } else
     "module" in l && (delete l.module, t && console.log("api-client-generator %s Removed 'module' field (no clear root export).", e.blue("debug"))), "types" in l && (delete l.types, t && console.log("api-client-generator %s Removed 'types' field (no clear root export).", e.blue("debug")));
   return l;
 }
-function W(o) {
-  const r = m.resolve(process.cwd(), o);
+function Q(o) {
+  const r = h.resolve(process.cwd(), o);
   if (!w(r))
     return;
-  let n;
+  let i;
   try {
-    n = O(r).filter((t) => t.endsWith(".ts") && t !== "index.ts");
+    i = U(r).filter((t) => t.endsWith(".ts") && t !== "index.ts");
   } catch {
     return;
   }
-  if (n.length !== 0) {
-    for (const t of n.slice(0, 5)) {
-      const i = m.join(r, t);
+  if (i.length !== 0) {
+    for (const t of i.slice(0, 5)) {
+      const n = h.join(r, t);
       try {
-        const s = x(i, "utf-8");
+        const s = k(n, "utf-8");
         if (/export class \w+ implements I\w+/.test(s))
           return "Class";
       } catch {
@@ -313,94 +313,132 @@ function W(o) {
     return "Interface";
   }
 }
-function q() {
-  const o = U(process.argv.slice(2)), r = process.env.APP_PLATFORM_URL ?? o.APP_PLATFORM_URL, n = r?.endsWith("/") ? r : r && `${r}/`, t = process.env.APP_PLATFORM_MODULES ?? o.APP_PLATFORM_MODULES, i = process.env.APP_API_CLIENT_DIRECTORY ?? o.APP_API_CLIENT_DIRECTORY, s = process.env.APP_PACKAGE_NAME ?? o.APP_PACKAGE_NAME, a = process.env.APP_PACKAGE_VERSION ?? o.APP_PACKAGE_VERSION, l = process.env.APP_OUT_DIR ?? o.APP_OUT_DIR ?? "./", p = process.env.APP_BUILD_DIR ?? o.APP_BUILD_DIR ?? "dist", d = process.env.RUNTIME ?? o.RUNTIME ?? "Net80", g = process.env.SKIP_BUILD === "true" || o.SKIP_BUILD === !0, y = process.env.VERBOSE === "true" || o.VERBOSE === !0, c = process.env.APP_TYPE_STYLE ?? o.APP_TYPE_STYLE;
-  let h;
-  c ? h = c : i ? h = W(i) ?? "Interface" : h = "Interface", c || console.log(
+function X(o, r, i) {
+  const t = Array.isArray(o) ? o.join(",") : o ?? "", n = (t.match(/\[/g) ?? []).length, s = (t.match(/\]/g) ?? []).length, a = n !== s, l = a || t.trim().endsWith(",");
+  if (!i && r.length > 0 && l) {
+    const u = [t, ...r].join(" ");
+    return {
+      ok: !1,
+      message: `APP_PLATFORM_MODULES looks truncated — unexpected extra arguments were received: ${r.join(
+        ", "
+      )}`,
+      hint: `This usually means the value was not quoted and the shell split it on spaces.
+Wrap the whole value in quotes, e.g.
+  --APP_PLATFORM_MODULES='${u}'`
+    };
+  }
+  if (a)
+    return {
+      ok: !1,
+      message: `APP_PLATFORM_MODULES has unbalanced brackets: ${t}`,
+      hint: `The value appears truncated. Wrap it in quotes, e.g.
+  --APP_PLATFORM_MODULES='[VirtoCommerce.Catalog, VirtoCommerce.Orders]'`
+    };
+  const c = t.replace(/[[\]]/g, "").split(",").map((u) => u.trim()).filter((u) => u.length > 0);
+  return c.length === 0 ? {
+    ok: !1,
+    message: `APP_PLATFORM_MODULES did not contain any module names: ${t}`,
+    hint: `Provide at least one module, e.g.
+  --APP_PLATFORM_MODULES='[VirtoCommerce.Catalog]'`
+  } : { ok: !0, modules: c };
+}
+function Z() {
+  const o = G(process.argv.slice(2)), r = process.env.APP_PLATFORM_URL ?? o.APP_PLATFORM_URL, i = r?.endsWith("/") ? r : r && `${r}/`, t = process.env.APP_PLATFORM_MODULES !== void 0, n = t ? process.env.APP_PLATFORM_MODULES : o.APP_PLATFORM_MODULES, s = (o._ ?? []).map(String), a = process.env.APP_API_CLIENT_DIRECTORY ?? o.APP_API_CLIENT_DIRECTORY, l = process.env.APP_PACKAGE_NAME ?? o.APP_PACKAGE_NAME, c = process.env.APP_PACKAGE_VERSION ?? o.APP_PACKAGE_VERSION, u = process.env.APP_OUT_DIR ?? o.APP_OUT_DIR ?? "./", d = process.env.APP_BUILD_DIR ?? o.APP_BUILD_DIR ?? "dist", m = process.env.RUNTIME ?? o.RUNTIME ?? "Net80", f = process.env.SKIP_BUILD === "true" || o.SKIP_BUILD === !0, y = process.env.VERBOSE === "true" || o.VERBOSE === !0, g = process.env.APP_TYPE_STYLE ?? o.APP_TYPE_STYLE;
+  let p;
+  g ? p = g : a ? p = Q(a) ?? "Interface" : p = "Interface", g || console.log(
     "api-client-generator %s APP_TYPE_STYLE not specified, using %s (set APP_TYPE_STYLE=Class to generate class-based DTOs)",
     e.blue("info"),
-    e.whiteBright(h)
+    e.whiteBright(p)
   );
-  const u = process.env.APP_PACKAGE_MODE === "true" || o.PACKAGE === !0, f = ["Net80", "Net90", "Net100"];
-  if (f.includes(d) || console.warn(
+  const A = process.env.APP_PACKAGE_MODE === "true" || o.PACKAGE === !0, T = ["Net80", "Net90", "Net100"];
+  if (T.includes(m) || console.warn(
     "api-client-generator %s Unknown RUNTIME value: %s. Known values: %s. Proceeding anyway — NSwag will report an error if the runtime is unsupported.",
     e.yellow("warning"),
-    e.whiteBright(d),
-    e.whiteBright(f.join(", "))
-  ), h !== "Class" && h !== "Interface" && (console.error(
+    e.whiteBright(m),
+    e.whiteBright(T.join(", "))
+  ), p !== "Class" && p !== "Interface" && (console.error(
     "api-client-generator %s Invalid APP_TYPE_STYLE value: %s. Must be either 'Class' or 'Interface'",
     e.red("error"),
-    e.whiteBright(h)
+    e.whiteBright(p)
   ), process.exit(1)), y) {
-    const k = c ? "explicit" : i ? "auto-detected" : "default";
+    const D = g ? "explicit" : a ? "auto-detected" : "default";
     console.log(
       "api-client-generator %s Using APP_TYPE_STYLE: %s (%s)",
       e.blue("debug"),
-      e.whiteBright(h),
-      e.gray(k)
+      e.whiteBright(p),
+      e.gray(D)
     );
   }
-  n || (console.error(
+  i || (console.error(
     "api-client-generator %s APP_PLATFORM_URL is required in .env config or as api-client-generator argument",
     e.red("error")
-  ), process.exit(1)), t || (console.error(
+  ), process.exit(1)), (n === void 0 || n === "") && (console.error(
     "api-client-generator %s APP_PLATFORM_MODULES is required in .env config or as api-client-generator argument",
     e.red("error")
-  ), process.exit(1)), i || (console.error(
+  ), process.exit(1));
+  const _ = X(n, s, t);
+  _.ok || (console.error("api-client-generator %s %s", e.red("error"), _.message), _.hint && console.error(e.blue(_.hint)), process.exit(1));
+  const C = _.modules;
+  console.log(
+    "api-client-generator %s Parsed %d module(s): %s",
+    e.blue("info"),
+    C.length,
+    e.whiteBright(C.join(", "))
+  ), a || (console.error(
     "api-client-generator %s APP_API_CLIENT_DIRECTORY is required in .env config or as api-client-generator argument",
     e.red("error")
   ), process.exit(1));
-  const A = m.join(m.resolve(process.cwd(), i), "package.json"), C = u || w(A);
+  const v = h.join(h.resolve(process.cwd(), a), "package.json"), B = A || w(v);
   return y && console.log(
     "api-client-generator %s Package mode: %s (explicit flag: %s, existing package.json: %s)",
     e.blue("debug"),
-    e.whiteBright(String(C)),
-    e.whiteBright(String(u)),
-    e.whiteBright(String(w(A)))
+    e.whiteBright(String(B)),
+    e.whiteBright(String(A)),
+    e.whiteBright(String(w(v)))
   ), {
-    platformUrl: n,
-    platformModules: t,
-    apiClientDirectory: i,
-    packageName: s,
-    packageVersion: a,
-    outDir: l,
-    buildDir: p,
-    runtime: d,
-    skipBuild: g,
+    platformUrl: i,
+    platformModulesList: C,
+    apiClientDirectory: a,
+    packageName: l,
+    packageVersion: c,
+    outDir: u,
+    buildDir: d,
+    runtime: m,
+    skipBuild: f,
     verbose: y,
-    typeStyle: h,
-    packageMode: C,
+    typeStyle: p,
+    packageMode: B,
     parsedArgs: o
   };
 }
-function z(o) {
-  const r = new V(o.apiClientDirectory);
+function ee(o) {
+  const r = new W(o.apiClientDirectory);
   if (!w(o.apiClientDirectory))
     try {
-      I(o.apiClientDirectory, { recursive: !0 }), console.log(
+      R(o.apiClientDirectory, { recursive: !0 }), console.log(
         "api-client-generator %s Created directory %s",
         e.greenBright("success"),
         e.whiteBright(o.apiClientDirectory)
       );
-    } catch (i) {
+    } catch (n) {
       console.error(
         "api-client-generator %s Failed to create directory %s",
         e.red("error"),
         e.whiteBright(o.apiClientDirectory)
-      ), console.error(e.red("Error details:"), i), console.error("api-client-generator %s Directory creation troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the parent directory")), console.error(e.blue("  - Ensure the path is valid and not too long")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
+      ), console.error(e.red("Error details:"), n), console.error("api-client-generator %s Directory creation troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the parent directory")), console.error(e.blue("  - Ensure the path is valid and not too long")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
     }
-  const n = o.platformModules.replace(/[[\]]/g, "").split(",").map((i) => i.trim()).filter((i) => i.length > 0), t = [];
-  for (const i of n) {
-    const s = r.resolveApiClientPaths(i);
+  const i = o.platformModulesList, t = [];
+  for (const n of i) {
+    const s = r.resolveApiClientPaths(n);
     console.log(
       "api-client-generator %s Generating API client for %s module on %s environment",
       e.green("info"),
-      e.whiteBright(i),
+      e.whiteBright(n),
       e.whiteBright(o.platformUrl)
     );
     const a = [
       `APP_PLATFORM_URL=${o.platformUrl}`,
-      `APP_PLATFORM_MODULE=${i}`,
+      `APP_PLATFORM_MODULE=${n}`,
       `APP_AUTH_API_BASE_PATH=${r.nswagPaths.authApiBase}`,
       `APP_TEMPLATE_DIRECTORY=${r.nswagPaths.templates}`,
       `APP_API_CLIENT_PATH=${s.nswag}`,
@@ -408,55 +446,55 @@ function z(o) {
       `RUNTIME=${o.runtime}`
     ].join(","), l = ["run", r.nswagPaths.configuration, `/variables:${a}`];
     o.verbose && (console.log("api-client-generator %s Running command: npx nswag %s", e.blue("debug"), l.join(" ")), console.log("api-client-generator %s Variables: %s", e.blue("debug"), a));
-    const p = v("npx nswag", l, {
+    const c = M("npx nswag", l, {
       stdio: ["ignore", o.verbose ? "inherit" : "pipe", "inherit"],
       shell: !0
     });
-    p.status === 0 ? (console.log(
+    c.status === 0 ? (console.log(
       "api-client-generator %s Successfully generated %s",
       e.greenBright("success"),
       e.whiteBright(s.console)
-    ), t.push(`${i.toLowerCase()}.ts`)) : (console.error(
+    ), t.push(`${n.toLowerCase()}.ts`)) : (console.error(
       "api-client-generator %s Failed to generate %s",
       e.red("error"),
       e.whiteBright(s.console)
     ), console.error(
       "api-client-generator %s NSwag command failed with exit code: %s",
       e.red("error"),
-      p.status
-    ), p.stderr && p.stderr.toString().trim() && (console.error("api-client-generator %s NSwag error output:", e.red("error")), console.error(e.red(p.stderr.toString()))), p.stdout && p.stdout.toString().trim() && (console.error("api-client-generator %s NSwag output:", e.yellow("warning")), console.error(e.yellow(p.stdout.toString()))), console.error("api-client-generator %s Troubleshooting tips:", e.blue("info")), console.error(e.blue("  - Check if the platform URL is accessible: %s"), o.platformUrl), console.error(e.blue("  - Verify the module name '%s' exists on the platform"), i), console.error(e.blue(`  - Ensure .NET Core ${o.runtime} is installed`)), console.error(e.blue("  - Try running with --VERBOSE=true for more details")), process.exit(1));
+      c.status
+    ), c.stderr && c.stderr.toString().trim() && (console.error("api-client-generator %s NSwag error output:", e.red("error")), console.error(e.red(c.stderr.toString()))), c.stdout && c.stdout.toString().trim() && (console.error("api-client-generator %s NSwag output:", e.yellow("warning")), console.error(e.yellow(c.stdout.toString()))), console.error("api-client-generator %s Troubleshooting tips:", e.blue("info")), console.error(e.blue("  - Check if the platform URL is accessible: %s"), o.platformUrl), console.error(e.blue("  - Verify the module name '%s' exists on the platform"), n), console.error(e.blue(`  - Ensure .NET Core ${o.runtime} is installed`)), console.error(e.blue("  - Try running with --VERBOSE=true for more details")), process.exit(1));
   }
   return t;
 }
-function H(o, r) {
-  const n = m.join(o.apiClientDirectory, o.buildDir);
-  if (!w(n))
+function re(o, r) {
+  const i = h.join(o.apiClientDirectory, o.buildDir);
+  if (!w(i))
     try {
-      I(n, { recursive: !0 }), console.log(
+      R(i, { recursive: !0 }), console.log(
         "api-client-generator %s Created build directory %s",
         e.greenBright("success"),
-        e.whiteBright(n)
+        e.whiteBright(i)
       );
-    } catch (p) {
+    } catch (c) {
       console.error(
         "api-client-generator %s Failed to create build directory %s",
         e.red("error"),
-        e.whiteBright(n)
-      ), console.error(e.red("Error details:"), p), console.error("api-client-generator %s Build directory creation troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the build directory path is valid")), console.error(e.blue("  - The TypeScript compiler will attempt to create the directory during compilation"));
+        e.whiteBright(i)
+      ), console.error(e.red("Error details:"), c), console.error("api-client-generator %s Build directory creation troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the build directory path is valid")), console.error(e.blue("  - The TypeScript compiler will attempt to create the directory during compilation"));
     }
-  const t = m.join(o.apiClientDirectory, "tsconfig.json"), i = G(t, r, o.outDir, o.buildDir);
+  const t = h.join(o.apiClientDirectory, "tsconfig.json"), n = q(t, r, o.outDir, o.buildDir);
   try {
-    T(t, JSON.stringify(i, null, 2)), o.verbose && console.log("api-client-generator %s Updated tsconfig.json", e.greenBright("success"));
-  } catch (p) {
-    console.error("api-client-generator %s Failed to write tsconfig.json", e.red("error")), console.error(e.red("Error details:"), p), console.error("api-client-generator %s File writing troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the file path is valid and not locked by another process")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
+    O(t, JSON.stringify(n, null, 2)), o.verbose && console.log("api-client-generator %s Updated tsconfig.json", e.greenBright("success"));
+  } catch (c) {
+    console.error("api-client-generator %s Failed to write tsconfig.json", e.red("error")), console.error(e.red("Error details:"), c), console.error("api-client-generator %s File writing troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the file path is valid and not locked by another process")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
   }
   console.log("api-client-generator %s Compiling TypeScript files to JavaScript", e.green("info"));
-  const s = v("npx tsc", ["--project", t], {
+  const s = M("npx tsc", ["--project", t], {
     stdio: ["ignore", "pipe", "pipe"],
     shell: !0
   });
   s.status === 0 ? console.log("api-client-generator %s Successfully compiled TypeScript files", e.greenBright("success")) : (console.error("api-client-generator %s Failed to compile TypeScript files", e.red("error")), s.stderr && s.stderr.toString().trim() && (console.error("api-client-generator %s TypeScript compilation errors:", e.red("error")), console.error(e.red(s.stderr.toString()))), s.stdout && s.stdout.toString().trim() && (console.error("api-client-generator %s TypeScript output:", e.yellow("warning")), console.error(e.yellow(s.stdout.toString()))), console.error("api-client-generator %s TypeScript compilation troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if all required dependencies are installed")), console.error(e.blue("  - Verify TypeScript configuration in tsconfig.json")), console.error(e.blue("  - Ensure generated API files are valid TypeScript")), console.error(e.blue("  - Try running with --VERBOSE=true for more details")), process.exit(1));
-  const a = m.join(o.apiClientDirectory, "package.json"), l = J(a, r, {
+  const a = h.join(o.apiClientDirectory, "package.json"), l = H(a, r, {
     ...o.parsedArgs,
     APP_PACKAGE_NAME: o.packageName,
     APP_PACKAGE_VERSION: o.packageVersion,
@@ -464,16 +502,16 @@ function H(o, r) {
     VERBOSE: o.verbose
   });
   try {
-    T(a, JSON.stringify(l, null, 2)), console.log("api-client-generator %s Generated package.json", e.greenBright("success"));
-  } catch (p) {
-    console.error("api-client-generator %s Failed to write package.json", e.red("error")), console.error(e.red("Error details:"), p), console.error("api-client-generator %s Package.json writing troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the file path is valid and not locked by another process")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
+    O(a, JSON.stringify(l, null, 2)), console.log("api-client-generator %s Generated package.json", e.greenBright("success"));
+  } catch (c) {
+    console.error("api-client-generator %s Failed to write package.json", e.red("error")), console.error(e.red("Error details:"), c), console.error("api-client-generator %s Package.json writing troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if you have write permissions in the API client directory")), console.error(e.blue("  - Ensure the file path is valid and not locked by another process")), console.error(e.blue("  - Try running with elevated permissions if needed")), process.exit(1);
   }
 }
-async function Q() {
+async function oe() {
   try {
-    await j({}, "build");
-    const o = q(), r = z(o);
-    o.packageMode && !o.skipBuild && r.length > 0 ? H(o, r) : o.packageMode || console.log(
+    await N({}, "build");
+    const o = Z(), r = ee(o);
+    o.packageMode && !o.skipBuild && r.length > 0 ? re(o, r) : o.packageMode || console.log(
       "api-client-generator %s Generated %d API client file(s) in simple mode (no package build)",
       e.greenBright("success"),
       r.length
@@ -482,4 +520,4 @@ async function Q() {
     console.error("api-client-generator %s Unexpected error occurred during API client generation", e.red("error")), console.error(e.red("Error details:"), o), console.error("api-client-generator %s General troubleshooting:", e.blue("info")), console.error(e.blue("  - Check if all required dependencies are installed")), console.error(e.blue("  - Ensure you have proper permissions")), console.error(e.blue("  - Try running with --VERBOSE=true for more details")), console.error(e.blue("  - Check the platform URL and module names")), process.exit(1);
   }
 }
-Q();
+oe();

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@vc-shell/api-client-generator",
   "description": "Tool for API clients generation",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "type": "module",
   "bin": "./dist/api-client-generator.js",
   "files": [
@@ -13,7 +13,7 @@
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@vc-shell/ts-config": "2.0.7",
+    "@vc-shell/ts-config": "2.0.8",
     "typescript": "^5.8.3"
   },
   "dependencies": {