@icib.dev/api-client 1.0.3 → 1.0.5

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 (default empty; when set, included in axios baseURL)
+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/api/client.js

@@ -5,7 +5,7 @@ export function setAuthToken(token) {
     _token = token;
 }
 export const client = axios.create({
-    baseURL: "https://api.example.com",
+    baseURL: "https://api.example.com/api",
     headers: {
         "Content-Type": "application/json",
     },

package/dist/api/contexts/items.js

@@ -3,6 +3,6 @@ import { client } from "../client.js";
 /** API client for items endpoints */
 export const items = {
     async list() {
-        return client.get("/api/items/");
+        return client.get("/items/");
     }
 };

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,12 @@ 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);
@@ -66,10 +71,6 @@ function getOrigin(doc) {
     }
     return "https://api.icib.dev";
 }
-function getBasePath(doc) {
-    const oas2 = doc;
-    return oas2.basePath ?? "/api";
-}
 function getDefinitions(doc) {
     return doc.definitions ?? doc.components?.schemas ?? {};
 }
@@ -168,11 +169,11 @@ function generateTypes(definitions) {
     lines.push("}\n");
     return lines.join("\n");
 }
-function extractOperations(paths, basePath, definitions) {
+function extractOperations(paths, definitions) {
     const ops = [];
     const methods = ["get", "post", "put", "patch", "delete"];
     for (const [path, pathItem] of Object.entries(paths)) {
-        const fullPath = basePath + (path.startsWith("/") ? path : `/${path}`);
+        const fullPath = path.startsWith("/") ? path : `/${path}`;
         for (const method of methods) {
             const op = pathItem[method];
             if (!op?.operationId)
@@ -615,18 +616,24 @@ 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 ?? "";
+        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);
+    const ops = extractOperations(paths, definitions);
     const byTag = groupByTag(ops, paths);
     const cwd = process.cwd();
     const outDir = join(cwd, out);
@@ -634,8 +641,11 @@ async function main() {
     const contextsDir = join(outDir, "contexts");
     mkdirSync(typesDir, { recursive: true });
     mkdirSync(contextsDir, { recursive: true });
+    const clientBaseUrl = basePath
+        ? `${baseUrl.replace(/\/$/, "")}${basePath}`
+        : baseUrl;
     writeFileSync(join(typesDir, "index.ts"), generateTypes(definitions));
-    writeFileSync(join(outDir, "client.ts"), generateClient(baseUrl));
+    writeFileSync(join(outDir, "client.ts"), generateClient(clientBaseUrl));
     const sortedTags = [...byTag.keys()].sort();
     for (const tag of sortedTags) {
         const ctxName = sanitizeContextName(tag);

package/package.json

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