@icib.dev/api-client 1.0.3 → 1.0.4

package/README.md

@@ -41,6 +41,10 @@ npx api-client-generate --url https://api.example.com/docs/openapi --out api
 
 # Using BASE_URL env (default: $BASE_URL/docs/openapi)
 BASE_URL=https://api.example.com npx api-client-generate --out api
+
+# Custom base path (overrides spec; default from spec or empty)
+npx api-client-generate --base-path /v1/api
+BASE_PATH=/v2 npx api-client-generate
 ```
 
 The client is generated in your project directory (e.g. `./api/`).

package/dist/scripts/generate.js

@@ -3,14 +3,14 @@ import { readFileSync, mkdirSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import SwaggerParser from "@apidevtools/swagger-parser";
-import { normalizedJsonHash, computeClientHash, } from "./hash.js";
+import { normalizedJsonHash, computeClientHash } from "./hash.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const DEFAULT_OUT = "api";
 function getDefaultUrl() {
     const base = process.env.BASE_URL;
     if (base) {
         const normalized = base.replace(/\/$/, "");
-        return `${normalized}/docs/openapi`;
+        return `${normalized}/docs/json`;
     }
     return "https://api.icib.dev/docs/?format=openapi";
 }
@@ -18,6 +18,7 @@ function parseArgs() {
     const args = process.argv.slice(2);
     let url = getDefaultUrl();
     let out = DEFAULT_OUT;
+    let basePath = process.env.BASE_PATH;
     for (let i = 0; i < args.length; i++) {
         if (args[i] === "--url" && args[i + 1]) {
             url = args[++i];
@@ -25,8 +26,11 @@ function parseArgs() {
         else if (args[i] === "--out" && args[i + 1]) {
             out = args[++i];
         }
+        else if ((args[i] === "--base-path" || args[i] === "--basePath") && args[i + 1]) {
+            basePath = args[++i];
+        }
     }
-    return { url, out };
+    return { url, out, basePath };
 }
 async function fetchSpec(url) {
     const res = await fetch(url);
@@ -68,7 +72,7 @@ function getOrigin(doc) {
 }
 function getBasePath(doc) {
     const oas2 = doc;
-    return oas2.basePath ?? "/api";
+    return oas2.basePath ?? "";
 }
 function getDefinitions(doc) {
     return doc.definitions ?? doc.components?.schemas ?? {};
@@ -615,15 +619,21 @@ function generateIndex(contextTags) {
     return exports.join("\n");
 }
 async function main() {
-    const { url, out } = parseArgs();
+    const { url, out, basePath: basePathOverride } = parseArgs();
     console.log(`Fetching spec from ${url}...`);
     const rawSpec = await loadRawSpec(url);
     const doc = await parseSpec(rawSpec);
     const baseUrl = getOrigin(doc);
-    const basePath = getBasePath(doc);
+    const basePath = (() => {
+        const raw = basePathOverride ?? getBasePath(doc);
+        if (raw === "")
+            return "";
+        return raw.startsWith("/") ? raw : `/${raw}`;
+    })();
     const definitions = getDefinitions(doc);
     const paths = getPaths(doc);
     console.log(`Base URL: ${baseUrl}`);
+    console.log(`Base path: ${basePath}`);
     console.log(`Paths: ${Object.keys(paths).length}`);
     console.log(`Definitions: ${Object.keys(definitions).length}`);
     const ops = extractOperations(paths, basePath, definitions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icib.dev/api-client",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Strictly-typed TypeScript API client for ICIB API",
   "type": "module",
   "main": "./dist/api/index.js",