@icib.dev/api-client 1.1.0 → 1.1.2

package/README.md

@@ -25,7 +25,7 @@ setAuthToken(process.env.API_TOKEN);
 const res = await apiClient.allegati.list({ page: 1, size: 10 });
 ```
 
-3. Add verify to your build (fails if docs changed or client was modified):
+3. Add verify to your build (ensures version alignment for production; fails if docs changed or client was modified):
 
 ```json
 {
@@ -90,7 +90,9 @@ api/
 
 ### Hash verification
 
-Add `api-client-verify` before your build to ensure the generated client matches the current OpenAPI docs. When you run your build, it:
+Add `api-client-verify` before your build to ensure the generated client matches the current OpenAPI docs. You can insert it in the build step of your utilization library (the app or library that consumes the API client) to verify version alignment before production builds—if the API docs changed or the client was modified, the build fails and you must regenerate.
+
+When you run your build, it:
 
 1. Reads the manifest (created by `generate`)
 2. Fetches the current docs and compares their hash

package/dist/scripts/generate.js

@@ -92,6 +92,46 @@ function getDefinitions(doc) {
 function getPaths(doc) {
     return doc.paths ?? {};
 }
+/**
+ * Extract response schema. Compatible with:
+ * - OpenAPI 2.0: response.schema
+ * - OpenAPI 3.0: response.content['application/json'].schema
+ */
+function getResponseSchema(response) {
+    if (!response || typeof response !== "object")
+        return undefined;
+    const r = response;
+    // OpenAPI 2.0: schema directly on response
+    if (r.schema && typeof r.schema === "object") {
+        return r.schema;
+    }
+    // OpenAPI 3.0: schema under content['application/json'] or content['*/*']
+    const content = r.content;
+    if (content) {
+        const jsonContent = content["application/json"] ??
+            content["*/*"] ??
+            Object.values(content)[0];
+        return jsonContent?.schema;
+    }
+    return undefined;
+}
+/**
+ * Extract request body schema from OpenAPI 3.0 requestBody.content.
+ * OpenAPI 2.0 uses parameters with in: "body" (handled separately in extractOperations).
+ */
+function getRequestBodySchema(requestBody) {
+    if (!requestBody || typeof requestBody !== "object")
+        return undefined;
+    const rb = requestBody;
+    const content = rb.content;
+    if (content) {
+        const jsonContent = content["application/json"] ??
+            content["*/*"] ??
+            Object.values(content)[0];
+        return jsonContent?.schema;
+    }
+    return undefined;
+}
 function schemaToTsType(schema, definitions, refsSeen = new Set()) {
     if (!schema)
         return "unknown";
@@ -250,8 +290,31 @@ function extractOperations(paths, definitions) {
                     };
                 }
             }
+            // OpenAPI 3.0: body in requestBody (OAS 2.0 uses parameters in: "body" above)
+            if (!bodyParam && op.requestBody) {
+                const bodySchema = getRequestBodySchema(op.requestBody);
+                if (bodySchema) {
+                    const propertyDescriptions = {};
+                    if (bodySchema.properties) {
+                        for (const [propName, propSchema] of Object.entries(bodySchema.properties)) {
+                            const desc = propSchema
+                                .description ??
+                                propSchema.title;
+                            if (desc)
+                                propertyDescriptions[propName] = desc;
+                        }
+                    }
+                    bodyParam = {
+                        name: "data",
+                        schema: bodySchema,
+                        propertyDescriptions: Object.keys(propertyDescriptions).length > 0
+                            ? propertyDescriptions
+                            : undefined,
+                    };
+                }
+            }
             const successResponse = op.responses?.["200"] ?? op.responses?.["201"];
-            const respSchema = successResponse?.schema;
+            const respSchema = getResponseSchema(successResponse);
             const respDesc = successResponse?.description ?? "";
             const xResponseType = successResponse?.["x-response-type"];
             let responseType = "unknown";
@@ -536,12 +599,23 @@ function generateContextFile(tag, operations, definitions, tagDescription) {
 }
 function generateClient(baseUrl) {
     return `// Auto-generated Axios client
-import axios, { type AxiosInstance } from "axios";
+import axios, { type AxiosInstance, AxiosError } from "axios";
 
 let _token: string | null = null;
 
-export function setAuthToken(token: string | null): void {
+export function setAuthToken(token: string | null, callback?: (token: string | null) => void): void {
   _token = token;
+  if (callback) callback(token);
+  // insert your own logic here, e.g. save to localStorage, sessionStorage, etc.
+}
+
+export function getAuthToken(): string | null {
+  return _token;
+}
+
+export function clearAuthToken(): void {
+  _token = null;
+  // insert your own logic here
 }
 
 export const client: AxiosInstance = axios.create({
@@ -558,6 +632,21 @@ client.interceptors.request.use((config) => {
   return config;
 });
 
+client.interceptors.response.use(
+  (response) => {
+    if (response.status === 401) {
+      clearAuthToken();
+    }
+    return response.data;
+  },
+  (error) => {
+    if (error.response.status === 401) {
+      clearAuthToken();
+    }
+    return AxiosError.from(error);
+  },
+);
+
 /** Options for blob/download endpoints */
 export interface BlobDownloadOptions {
   /** When true, triggers a file download in the browser */
@@ -631,7 +720,7 @@ function generateIndex(contextTags) {
     return exports.join("\n");
 }
 async function main() {
-    const { url, out, basePath: basePathOverride, baseUrl: baseUrlOverride } = parseArgs();
+    const { url, out, basePath: basePathOverride, baseUrl: baseUrlOverride, } = parseArgs();
     console.log(`Fetching spec from ${url}...`);
     const rawSpec = await loadRawSpec(url);
     const doc = await parseSpec(rawSpec);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icib.dev/api-client",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Generator for strictly-typed TypeScript API clients from OpenAPI specs",
   "type": "module",
   "bin": {