@moccona/apicodegen 0.0.1 → 0.0.3

package/npm/index.js

@@ -205,10 +205,10 @@ var Base = class _Base {
    * @param [operationId] - Unique identifier for the operation.
    * @returns - The generated function name.
    */
-  static pathToFnName(path, method, operationId) {
-    const name = this.camelCase(this.normalize(path));
+  static pathToFnName(path, method, _operationId = "") {
+    const name = this.normalize(this.camelCase(this.normalize(path)));
     const suffix = method ? this.capitalize(this.upperCamelCase(`using_${method}`)) : "";
-    return (operationId ? this.camelCase(this.normalize(operationId)) : name) + suffix;
+    return name + suffix;
   }
   /**
    * Normalizes a string by replacing special characters and avoiding TypeScript keywords.
@@ -219,7 +219,7 @@ var Base = class _Base {
     if (typescriptKeywords.has(text)) {
       text += "_";
     }
-    return text.replace(/[/\-_{}():\s`,*<>$]/gm, "_").replaceAll("...", "");
+    return text.replace(/[/\-_{}():\s`,*<>$#.]/gm, "_").replace(/^\d./gm, "").replaceAll("...", "");
   }
   /**
    * Capitalizes the first character of a string.
@@ -255,19 +255,24 @@ var Base = class _Base {
    */
   static async fetchDoc(url, requestInit = {}) {
     const agent = new Agent({
-      connect: {
-        rejectUnauthorized: false
-      }
+      connect: { rejectUnauthorized: false }
+    });
+    const { body, statusCode } = await request(url, {
+      method: "GET",
+      dispatcher: agent,
+      ...requestInit
     });
+    if (statusCode >= 400) {
+      throw new Error(
+        `Failed to fetch OpenAPI documentation from ${url}: HTTP ${statusCode}`
+      );
+    }
     try {
-      const { body } = await request(url, {
-        method: "GET",
-        dispatcher: agent,
-        ...requestInit
-      });
       return body.json();
     } catch (error) {
-      throw error;
+      throw new Error(
+        `Failed to parse JSON response from ${url}: ${error instanceof Error ? error.message : String(error)}`
+      );
     }
   }
   /**
@@ -276,12 +281,11 @@ var Base = class _Base {
    * @returns - The matched MediaTypes or null.
    */
   static getMediaType(mediaType) {
-    for (const type in Object.values(MediaTypes)) {
-      if (new RegExp(type).test(mediaType)) {
-        return type;
-      }
-    }
-    return;
+    const mediaTypeValues = Object.values(MediaTypes);
+    const found = mediaTypeValues.find(
+      (type) => mediaType.includes(type)
+    );
+    return found;
   }
   /**
    * Checks if a schema is a valid enum type that isn't boolean.
@@ -316,17 +320,21 @@ var Base = class _Base {
    * @returns - Array of unique enum schemas.
    */
   static uniqueEnums(enums) {
-    const uniqueEnums_ = [];
-    for (const enumObject of enums) {
-      if (uniqueEnums_.length === 0) {
-        uniqueEnums_.push(enumObject);
-      } else {
-        if (!uniqueEnums_.some((a) => this.isSameEnum(a, enumObject))) {
-          uniqueEnums_.push(enumObject);
+    const enumMap = /* @__PURE__ */ new Map();
+    for (const e of enums) {
+      const existing = enumMap.get(e.name);
+      if (existing) {
+        for (const value of e.enum) {
+          existing.add(value);
         }
+      } else {
+        enumMap.set(e.name, new Set(e.enum));
       }
     }
-    return uniqueEnums_;
+    return Array.from(enumMap.entries()).map(([name, values]) => ({
+      name,
+      enum: Array.from(values)
+    }));
   }
   /**
    * Finds the first occurrence of a matching enum schema in an array.
@@ -343,7 +351,7 @@ var Base = class _Base {
    * @returns - True if the object is a reference.
    */
   static isRef(schema) {
-    return "$ref" in schema && typeof schema.$ref === "string";
+    return typeof schema === "object" && schema !== null && "$ref" in schema && typeof schema.$ref === "string";
   }
 };
 
@@ -435,7 +443,7 @@ var Generator = class _Generator {
    * @param path - The base path string containing placeholders.
    * @param parameters - Array of parameter objects defining the parameters.
    * @param basePath - Optional base path to prepend (default: "").
-   * @returns A TypeScript template expression node.
+   * @returns A TypeScript template expressi
    */
   static toUrlTemplate(path, parameters, basePath = "") {
     const queryParameters = parameters.filter(
@@ -443,7 +451,7 @@ var Generator = class _Generator {
     );
     if (queryParameters.length > 0) {
       const queryString = queryParameters.map(
-        (qp, index) => `${index === 0 ? "?" : "&"}${encodeURIComponent(qp.name)}={${qp.name}}`
+        (qp, index) => `${index === 0 ? "?" : "&"}${encodeURIComponent(qp.name)}={${Base.camelCase(Base.normalize(qp.name))}}`
       ).join("");
       path += queryString;
     }
@@ -558,7 +566,7 @@ var Generator = class _Generator {
       case "boolean" /* boolean */:
         return t.createToken(SyntaxKind.BooleanKeyword);
       case "file" /* file */:
-        return t.createTypeReferenceNode(t.createIdentifier("File"));
+        return t.createTypeReferenceNode(t.createIdentifier("Blob"));
       default:
         const {
           format: format2,
@@ -577,7 +585,7 @@ var Generator = class _Generator {
             return t.createToken(SyntaxKind.BooleanKeyword);
           case "blob" /* blob */:
           case "binary" /* binary */:
-            return t.createTypeReferenceNode(t.createIdentifier("File"));
+            return t.createTypeReferenceNode(t.createIdentifier("Blob"));
           default:
         }
         if (enum_) {
@@ -601,36 +609,36 @@ var Generator = class _Generator {
           );
         }
         if (allOf) {
-          return t.createUnionTypeNode(
+          return t.createIntersectionTypeNode(
             allOf.map((schema2) => this.toTypeNode(schema2))
           );
         }
         if (type2 && typeof type2 === "string") {
           return t.createTypeReferenceNode(
-            type2 !== "unknown" ? t.createIdentifier(Base.upperCamelCase(type2)) : type2
+            type2 !== "unknown" && type2 !== "null" ? t.createIdentifier(Base.upperCamelCase(type2)) : type2
           );
         }
     }
     return t.createToken(SyntaxKind.UnknownKeyword);
   }
-  static toDeclarationNode(parameters) {
+  static toDeclarationNodes(parameters) {
     const objectElements = [];
     const typeObjectElements = [];
+    const refParameters = [];
     for (const parameter of parameters) {
       if (parameter.ref) {
-        t.createParameterDeclaration(
-          void 0,
-          void 0,
-          t.createIdentifier(
-            Base.camelCase(Base.normalize(Base.ref2name(parameter.ref)))
-          ),
-          void 0,
-          t.createTypeReferenceNode(
-            t.createIdentifier(
-              Base.upperCamelCase(Base.normalize(Base.ref2name(parameter.ref)))
-            )
-          ),
-          void 0
+        const refName = Base.ref2name(parameter.ref);
+        refParameters.push(
+          t.createParameterDeclaration(
+            void 0,
+            void 0,
+            t.createIdentifier(Base.camelCase(Base.normalize(refName))),
+            void 0,
+            t.createTypeReferenceNode(
+              t.createIdentifier(Base.upperCamelCase(Base.normalize(refName)))
+            ),
+            void 0
+          )
         );
       } else {
         const { name, schema, required } = parameter;
@@ -651,14 +659,18 @@ var Generator = class _Generator {
         );
       }
     }
-    return t.createParameterDeclaration(
-      void 0,
-      void 0,
-      t.createObjectBindingPattern(objectElements),
-      void 0,
-      t.createTypeLiteralNode(typeObjectElements),
-      void 0
-    );
+    if (objectElements.length > 0) {
+      const objectParam = t.createParameterDeclaration(
+        void 0,
+        void 0,
+        t.createObjectBindingPattern(objectElements),
+        void 0,
+        t.createTypeLiteralNode(typeObjectElements),
+        void 0
+      );
+      return [objectParam, ...refParameters];
+    }
+    return refParameters;
   }
   static toFormDataStatement(parameters, requestBody) {
     const statements = [];
@@ -681,16 +693,11 @@ var Generator = class _Generator {
       )
     );
     statements.push(fdDeclaration);
-    parameters.filter(
-      (parameter) => parameter.ref !== void 0 && (parameter.in === "formData" /* formData */ || parameter.schema && this.isBinarySchema(parameter.schema))
-    ).forEach((parameter) => {
+    parameters.forEach((parameter) => {
       statements.push(
         t.createExpressionStatement(
           t.createBinaryExpression(
-            t.createElementAccessExpression(
-              t.createIdentifier("req"),
-              t.createStringLiteral(parameter.name)
-            ),
+            t.createIdentifier(parameter.name),
             t.createToken(SyntaxKind.AmpersandAmpersandToken),
             t.createCallExpression(
               t.createPropertyAccessExpression(
@@ -734,7 +741,13 @@ var Generator = class _Generator {
                       t.createStringLiteral(key),
                       t.createIdentifier("file"),
                       t.createPropertyAccessExpression(
-                        t.createIdentifier("file"),
+                        t.createAsExpression(
+                          t.createIdentifier("file"),
+                          t.createTypeReferenceNode(
+                            t.createIdentifier("File"),
+                            void 0
+                          )
+                        ),
                         t.createIdentifier("name")
                       )
                     ]
@@ -819,25 +832,28 @@ var Generator = class _Generator {
     );
     const shouldParseResponseToJSON = "application/json" === response?.type;
     const isRequestBodyBinary = requestBody?.schema && requestBody.schema.type === "array" /* array */ && this.isBinarySchema(requestBody.schema);
-    const inFormDataParameters = parameters.filter(
-      (p) => p.in === "formData" /* formData */
+    const parametersShouldPutInFormData = parameters.filter(
+      (p) => p.in === "formData" /* formData */ || p.schema && this.isBinarySchema(p.schema)
     );
-    const notInFormDataParameters = parameters.filter(
-      (p) => p.in !== "formData" /* formData */
+    const parametersShouldNotPutInFormData = parameters.filter(
+      (p) => !parametersShouldPutInFormData.includes(p)
     );
-    const isRequestBodyContainsBinary = requestBody?.schema && "properties" in requestBody.schema && Object.values(requestBody.schema.properties).some(
+    const isRequestBodyContainsBinary = requestBody?.schema && "properties" in requestBody.schema && Object.values(requestBody.schema?.properties ?? {}).some(
       (p) => this.isBinarySchema(p)
     );
     const hasBinaryInParameters = parameters.some(
       (p) => p?.schema && this.isBinarySchema(p.schema)
     );
-    const shouldPutParametersOrBodyInFormData = isFormDataRequest || isRequestBodyBinary || hasBinaryInParameters || isRequestBodyContainsBinary || inFormDataParameters.length > 0;
+    const shouldPutParametersOrBodyInFormData = isFormDataRequest || isRequestBodyBinary || hasBinaryInParameters || isRequestBodyContainsBinary || parametersShouldPutInFormData.length > 0;
     return t.createBlock([
-      ...shouldPutParametersOrBodyInFormData ? this.toFormDataStatement(inFormDataParameters, requestBody?.schema) : [],
+      ...shouldPutParametersOrBodyInFormData ? this.toFormDataStatement(
+        parametersShouldPutInFormData,
+        requestBody?.schema
+      ) : [],
       ...adapter.client(
         uri,
         method,
-        notInFormDataParameters,
+        parametersShouldNotPutInFormData,
         requestBody,
         response,
         adapter,
@@ -908,8 +924,8 @@ var Generator = class _Generator {
             Base.pathToFnName(uri, method, operationId) + (shouldAddExtraMethodNameSuffix ? Base.capitalize(req.type.split("/")[1]) : ""),
             void 0,
             [
-              parameters.length > 0 ? _Generator.toDeclarationNode(parameters) : void 0,
-              req?.schema ? _Generator.toRequestBodyTypeNode(req.schema) : void 0
+              ...parameters.length > 0 ? _Generator.toDeclarationNodes(parameters) : [],
+              ...req?.schema ? [_Generator.toRequestBodyTypeNode(req.schema)] : []
             ].filter(Boolean),
             void 0,
             this.bodyBlock(
@@ -1029,7 +1045,6 @@ var AxiosAdapter = class extends Adapter {
             )
           ) : []
         ).concat(
-          // Add body if needed
           shouldUseFormData || inBody.length > 0 || requestBody?.schema ? t2.createPropertyAssignment(
             t2.createIdentifier(adapter.bodyFieldName),
             shouldUseFormData ? t2.createIdentifier("fd") : inBody.length > 0 || requestBody?.schema && !Generator.isBinarySchema(requestBody.schema) ? t2.createIdentifier("req") : t2.createIdentifier("req")
@@ -1115,7 +1130,6 @@ var FetchAdapter = class extends Adapter {
             )
           ) : []
         ).concat(
-          // Add body if needed
           shouldUseFormData || inBody.length > 0 || requestBody?.schema ? t3.createPropertyAssignment(
             t3.createIdentifier(adapter.bodyFieldName),
             shouldUseFormData ? t3.createIdentifier("fd") : inBody.length > 0 || requestBody?.schema && !Generator.isBinarySchema(requestBody.schema) ? t3.createCallExpression(
@@ -1173,7 +1187,7 @@ var FetchAdapter = class extends Adapter {
                 ],
                 void 0,
                 t3.createToken(SyntaxKind2.EqualsGreaterThanToken),
-                t3.createAsExpression(
+                response?.schema ? t3.createAsExpression(
                   t3.createParenthesizedExpression(
                     t3.createAwaitExpression(
                       t3.createCallExpression(
@@ -1187,6 +1201,17 @@ var FetchAdapter = class extends Adapter {
                     )
                   ),
                   response?.schema ? Generator.toTypeNode(response.schema) : t3.createToken(SyntaxKind2.UnknownKeyword)
+                ) : t3.createParenthesizedExpression(
+                  t3.createAwaitExpression(
+                    t3.createCallExpression(
+                      t3.createPropertyAccessExpression(
+                        t3.createIdentifier("response"),
+                        t3.createIdentifier("json")
+                      ),
+                      void 0,
+                      []
+                    )
+                  )
                 )
               )
             ]
@@ -1297,13 +1322,25 @@ var V2 = class {
         enum: enum_,
         format: format2,
         allOf: allOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         anyOf: anyOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         oneOf: oneOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         properties: Object.keys(properties).reduce((acc, p) => {
           const propSchema = properties[p];
@@ -1333,7 +1370,8 @@ var V2 = class {
       type,
       items,
       enum: enum_,
-      properties
+      properties,
+      schema
     } = parameter;
     if (enum_) {
       const type2 = Base.upperCamelCase(upLevelSchemaKey) + Base.upperCamelCase(name);
@@ -1355,17 +1393,36 @@ var V2 = class {
         }
       };
     }
+    if (items) {
+      return {
+        name,
+        required,
+        description,
+        in: parameter.in,
+        schema: {
+          type,
+          items
+        }
+      };
+    }
+    if (schema && Base.isRef(schema)) {
+      return {
+        name,
+        required,
+        description,
+        in: parameter.in,
+        schema: {
+          type: Base.upperCamelCase(Base.ref2name(schema.$ref))
+        }
+      };
+    }
     return {
       name,
       required,
       description,
       in: parameter.in,
-      schema: items ? {
-        type,
-        items
-      } : {
+      schema: {
         type,
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
         properties
       }
     };
@@ -1444,6 +1501,7 @@ var V2 = class {
               if (code in responses2) {
                 const response = responses2[code];
                 const responseSchema = this.getResponseByRef(response);
+                const inBodyOnlyHasBody = inBody && inBody.length === 1 && inBody[0].in === "body" && inBody[0].name === "body";
                 methodApis.push({
                   method,
                   operationId,
@@ -1452,7 +1510,12 @@ var V2 = class {
                   description: description_,
                   parameters: uniqueParameterName.map((name) => notInBody.find((p) => p.name === name)).filter(Boolean),
                   responses: responseSchema,
-                  requestBody: inBody.length > 0 ? [
+                  requestBody: inBody.length > 0 ? inBodyOnlyHasBody ? [
+                    {
+                      type: "application/json" /* JSON */,
+                      schema: inBody[0].schema
+                    }
+                  ] : [
                     {
                       type: "application/json" /* JSON */,
                       schema: {
@@ -1520,7 +1583,11 @@ var V3 = class {
           type: upLevelSchemaKey + refName
         };
       }
-      schema = this.doc.components?.schemas?.[Base.ref2name(schema.$ref, this.doc)];
+      const resolvedSchema = this.doc.components?.schemas?.[Base.ref2name(schema.$ref, this.doc)];
+      if (!resolvedSchema) {
+        return { type: "unknown" };
+      }
+      schema = resolvedSchema;
     }
     return this.toBaseSchema(schema, enums, "", upLevelSchemaKey + refName);
   }
@@ -1529,7 +1596,14 @@ var V3 = class {
    */
   getParameterByRef(schema, enums = [], upLevelSchemaKey = "") {
     if (Base.isRef(schema)) {
-      schema = this.doc.components?.parameters?.[Base.ref2name(schema.$ref, this.doc)];
+      const resolvedSchema = this.doc.components?.parameters?.[Base.ref2name(schema.$ref, this.doc)];
+      if (!resolvedSchema) {
+        return {
+          name: "unknown",
+          in: "query"
+        };
+      }
+      schema = resolvedSchema;
     }
     const {
       name,
@@ -1578,7 +1652,11 @@ var V3 = class {
    */
   getResponseByRef(schema) {
     if (Base.isRef(schema)) {
-      schema = this.doc.components?.responses?.[Base.ref2name(schema.$ref, this.doc)];
+      const resolvedSchema = this.doc.components?.responses?.[Base.ref2name(schema.$ref, this.doc)];
+      if (!resolvedSchema) {
+        return [];
+      }
+      schema = resolvedSchema;
     }
     const { content = {} } = schema;
     return Object.keys(content).map((c) => ({
@@ -1591,7 +1669,11 @@ var V3 = class {
    */
   getRequestBodyByRef(schema, enums = []) {
     if (Base.isRef(schema)) {
-      schema = this.doc.components?.requestBodies?.[Base.ref2name(schema.$ref, this.doc)];
+      const resolvedSchema = this.doc.components?.requestBodies?.[Base.ref2name(schema.$ref, this.doc)];
+      if (!resolvedSchema) {
+        return [];
+      }
+      schema = resolvedSchema;
     }
     const { content = {} } = schema;
     return Object.keys(content).map((c) => ({
@@ -1660,13 +1742,25 @@ var V3 = class {
         enum: enum_,
         format: format2,
         allOf: allOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.capitalize(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         anyOf: anyOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.capitalize(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         oneOf: oneOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.capitalize(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.capitalize(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         properties: Object.keys(properties).reduce((acc, p) => {
           const propSchema = properties[p];
@@ -1963,13 +2057,25 @@ var V3_1 = class {
         enum: enum_,
         format: format2,
         allOf: allOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         anyOf: anyOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         oneOf: oneOf?.map(
-          (s) => Base.isRef(s) ? { type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc)) } : this.toBaseSchema(s, enums)
+          (s) => Base.isRef(s) ? {
+            ...s,
+            ref: s.$ref,
+            type: Base.upperCamelCase(Base.ref2name(s.$ref, this.doc))
+          } : this.toBaseSchema(s, enums)
         ),
         properties: Object.keys(properties).reduce((acc, p) => {
           const propSchema = properties[p];
@@ -2191,8 +2297,8 @@ import { execaCommand } from "execa";
 import fs from "fs-extra";
 var PLUGIN_NAME = "apiCodeGen";
 var logger2 = createScopedLogger2("api-codegen-vite-plugin");
-var tsc = async () => {
-  await execaCommand("npx tsc -b");
+var tsc = async (path) => {
+  await execaCommand(`npx tsc ${path} --noEmit`);
 };
 function apiCodeGenPlugin(options) {
   let firstRun = true;
@@ -2210,9 +2316,13 @@ function apiCodeGenPlugin(options) {
             const code = await codeGen(codeGenInitOptions);
             await fs.createFile(codeGenInitOptions.output);
             await fs.writeFile(codeGenInitOptions.output, code);
+            try {
+              await tsc(codeGenInitOptions.output);
+            } catch (error) {
+              logger2.error(error);
+            }
           } catch (error) {
-            logger2.error(`Failed to generate api ${name}`);
-            console.error(error);
+            logger2.error(`Failed to generate api ${name}: ${error}`);
           }
           return {
             ...proxies_,
@@ -2222,17 +2332,11 @@ function apiCodeGenPlugin(options) {
         Promise.resolve({})
       );
       logger2.info("-------> api codegen finished <--------");
-      try {
-        await tsc();
-      } catch (error) {
-        logger2.error(error);
-        process.exit(1);
-      }
       return {
         ...config,
         server: {
           ...config.server ?? {},
-          proxy: proxies
+          proxy: Object.assign({}, config.server?.proxy ?? {}, proxies)
         }
       };
     }