mobx-tanstack-query-api 0.36.0 → 0.37.0

package/cli.cjs

@@ -56,38 +56,72 @@ ${contract2.content}}`;
   const contractType = `${"export "}${templateFn(contract)}`;
   return result + contractType;
 };
+function getResponseContentTypes(raw) {
+  const out = [];
+  if (Array.isArray(raw.produces)) out.push(...raw.produces);
+  const status = raw.responses && Object.keys(raw.responses).find((s) => {
+    const code = Number.parseInt(s, 10);
+    return code >= 200 && code < 300;
+  });
+  const content = status && raw.responses[status]?.content;
+  if (content && typeof content === "object") out.push(...Object.keys(content));
+  return [...new Set(out)];
+}
+function getRequestContentTypes(raw) {
+  const out = [];
+  if (Array.isArray(raw.consumes)) out.push(...raw.consumes);
+  const body = raw.requestBody?.content;
+  if (body && typeof body === "object") out.push(...Object.keys(body));
+  return [...new Set(out)];
+}
+function getSecuritySchemeNames(security) {
+  if (!Array.isArray(security)) return [];
+  return security.flatMap(
+    (s) => typeof s === "object" && s !== null ? Object.keys(s) : []
+  ).filter(Boolean);
+}
+function getExternalDocsLine(externalDocs, formatDescription) {
+  if (!externalDocs || typeof externalDocs !== "object" || !("url" in externalDocs))
+    return null;
+  const url = externalDocs.url;
+  if (!url) return null;
+  const desc = externalDocs.description;
+  const extDesc = desc ? ` ${formatDescription(String(desc).slice(0, 60), true)}` : "";
+  return { name: "see", content: `${url}${extDesc}`.trim() };
+}
+function getSummaryAndDescriptionLines(rawRoute, formatDescription) {
+  const out = [];
+  if (rawRoute.summary) {
+    const summaryLines = text.splitTextByLines(rawRoute.summary, 60).filter(Boolean).map((line) => ({ content: `**${formatDescription(line, true)}**` }));
+    if (summaryLines.length > 0) out.push(...summaryLines, { content: "" });
+  }
+  if (rawRoute.description) {
+    const descriptionLines = text.splitTextByLines(rawRoute.description, 60).filter(Boolean).map((line) => ({ content: formatDescription(line, true) }));
+    if (descriptionLines.length > 0)
+      out.push(...descriptionLines, { content: "" });
+  } else if (!rawRoute.summary) {
+    out.push({ content: "No description" });
+  }
+  return out;
+}
 const endpointJSDocTmpl = (params) => {
   const { route, configuration, offset = 0 } = params;
   const { routeName } = route;
   const rawRoute = route.raw;
   const routeRequest = route.request;
+  const path2 = routeRequest?.path;
+  const method = routeRequest?.method;
   const { utils } = configuration;
   const { _, formatDescription } = utils;
+  const schema = configuration.config?.swaggerSchema ?? configuration.swaggerSchema;
+  const pathKey = path2?.startsWith("/") ? path2 : `/${path2 || ""}`;
+  const methodKey = method?.toLowerCase?.() ?? method;
+  const schemaOp = pathKey && methodKey ? schema?.paths?.[pathKey]?.[methodKey] : null;
+  const rawWithSpec = schemaOp && typeof schemaOp === "object" ? { ...schemaOp, ...rawRoute } : rawRoute;
   const jsDocLines = [];
-  if (rawRoute.summary) {
-    const summaryLines = text.splitTextByLines(rawRoute.summary, 60).filter(Boolean).map((line) => ({
-      content: `**${formatDescription(line, true)}**`
-    }));
-    if (summaryLines.length > 0) {
-      jsDocLines.push(...summaryLines, { content: "" });
-    }
-  }
-  if (rawRoute.description) {
-    const descriptionLines = text.splitTextByLines(rawRoute.description, 60).filter(Boolean).map((line) => ({
-      content: formatDescription(line, true)
-    }));
-    if (descriptionLines.length > 0) {
-      jsDocLines.push(...descriptionLines, { content: "" });
-    } else {
-      jsDocLines.push({
-        content: "No description"
-      });
-    }
-  } else {
-    jsDocLines.push({
-      content: "No description"
-    });
-  }
+  jsDocLines.push(
+    ...getSummaryAndDescriptionLines(rawRoute, formatDescription)
+  );
   if (rawRoute.operationId) {
     jsDocLines.push({
       name: "operationId",
@@ -104,6 +138,20 @@ const endpointJSDocTmpl = (params) => {
     name: "request",
     content: `**${_.upperCase(routeRequest.method)}:${rawRoute.route}**`
   });
+  const responseTypes = getResponseContentTypes(rawWithSpec);
+  if (responseTypes.length > 0) {
+    jsDocLines.push({
+      name: "produces",
+      content: responseTypes.join(", ")
+    });
+  }
+  const requestTypes = getRequestContentTypes(rawWithSpec);
+  if (requestTypes.length > 0) {
+    jsDocLines.push({
+      name: "consumes",
+      content: requestTypes.join(", ")
+    });
+  }
   if (rawRoute.deprecated) {
     jsDocLines.push({
       name: "deprecated"
@@ -121,10 +169,17 @@ const endpointJSDocTmpl = (params) => {
     );
   }
   if (routeRequest.security) {
-    jsDocLines.push({
-      name: "secure"
-    });
+    jsDocLines.push({ name: "secure" });
+    const schemeNames = getSecuritySchemeNames(rawWithSpec.security);
+    if (schemeNames.length > 0) {
+      jsDocLines.push({ name: "security", content: schemeNames.join(", ") });
+    }
   }
+  const externalDocsLine = getExternalDocsLine(
+    rawWithSpec.externalDocs,
+    formatDescription
+  );
+  if (externalDocsLine) jsDocLines.push(externalDocsLine);
   if (rawRoute.responsesTypes.length > 0) {
     jsDocLines.push({
       name: "responses"
@@ -219,6 +274,94 @@ const responseContentKind = {
   FORM_DATA: '"formData"',
   BYTES: '"bytes"'
 };
+function inferResponseFormatFromRaw(raw) {
+  const contentTypes = [];
+  if (Array.isArray(raw.produces)) {
+    contentTypes.push(...raw.produces);
+  }
+  const successStatus = raw.responses && Object.keys(raw.responses).find((s) => {
+    const code = Number.parseInt(s, 10);
+    return code >= 200 && code < 300;
+  });
+  const content = successStatus && raw.responses[successStatus]?.content;
+  if (content && typeof content === "object") {
+    contentTypes.push(...Object.keys(content));
+  }
+  if (contentTypes.length === 0) return null;
+  const mimeToFormat = (mime) => {
+    if (mime.includes("application/json") || mime.includes("+json"))
+      return '"json"';
+    if (mime.startsWith("text/")) return '"text"';
+    if (mime.includes("form-data") || mime.includes("multipart"))
+      return '"formData"';
+    if (mime.includes("octet-stream") || mime.includes("spreadsheet") || mime.includes("vnd.") || mime.startsWith("application/") || mime.startsWith("image/") || mime.startsWith("audio/") || mime.startsWith("video/") || mime.startsWith("font/") || mime.startsWith("model/") || mime.startsWith("message/") || mime.startsWith("haptics/"))
+      return '"blob"';
+    return null;
+  };
+  const preferredOrder = ['"json"', '"text"', '"formData"', '"blob"'];
+  for (const fmt of preferredOrder) {
+    const found = contentTypes.map(mimeToFormat).find((f) => f === fmt);
+    if (found) return found;
+  }
+  return null;
+}
+function getResponseFormat(responseBodyInfo, raw, configuration, path2, method) {
+  const fromContentKind = responseContentKind[responseBodyInfo.success?.schema?.contentKind];
+  if (fromContentKind) return fromContentKind;
+  const swaggerSchema = configuration.config?.swaggerSchema ?? configuration.swaggerSchema;
+  const schemaPaths = swaggerSchema?.paths;
+  const pathKey = path2?.startsWith("/") ? path2 : `/${path2 || ""}`;
+  const methodKey = method?.toLowerCase?.() ?? method;
+  const schemaOperation = pathKey && methodKey ? schemaPaths?.[pathKey]?.[methodKey] : null;
+  const rawWithProduces = schemaOperation && typeof schemaOperation === "object" ? { ...schemaOperation, ...raw } : raw;
+  return inferResponseFormatFromRaw(rawWithProduces);
+}
+function inferRequestBodyContentTypeFromRaw(raw) {
+  const contentTypes = [];
+  if (Array.isArray(raw.consumes)) {
+    contentTypes.push(...raw.consumes);
+  }
+  const requestBody = raw.requestBody;
+  if (requestBody?.content && typeof requestBody.content === "object") {
+    contentTypes.push(...Object.keys(requestBody.content));
+  }
+  if (contentTypes.length === 0) return null;
+  const mimeToContentType = (mime) => {
+    if (mime.includes("application/json") || mime.includes("+json"))
+      return '"application/json"';
+    if (mime.includes("application/x-www-form-urlencoded"))
+      return '"application/x-www-form-urlencoded"';
+    if (mime.includes("multipart/form-data") || mime.includes("multipart/"))
+      return '"multipart/form-data"';
+    if (mime.startsWith("text/")) return '"text/plain"';
+    if (mime.includes("octet-stream") || mime.startsWith("application/") || mime.startsWith("image/") || mime.startsWith("audio/") || mime.startsWith("video/") || mime.startsWith("font/") || mime.startsWith("model/") || mime.includes("vnd."))
+      return '"application/octet-stream"';
+    return null;
+  };
+  const preferredOrder = [
+    '"application/json"',
+    '"application/x-www-form-urlencoded"',
+    '"multipart/form-data"',
+    '"text/plain"',
+    '"application/octet-stream"'
+  ];
+  for (const ct of preferredOrder) {
+    const found = contentTypes.map(mimeToContentType).find((c) => c === ct);
+    if (found) return found;
+  }
+  return null;
+}
+function getRequestBodyContentType(requestBodyInfo, raw, configuration, path2, method) {
+  const fromContentKind = requestContentKind[requestBodyInfo?.contentKind];
+  if (fromContentKind) return fromContentKind;
+  const swaggerSchema = configuration.config?.swaggerSchema ?? configuration.swaggerSchema;
+  const schemaPaths = swaggerSchema?.paths;
+  const pathKey = path2?.startsWith("/") ? path2 : `/${path2 || ""}`;
+  const methodKey = method?.toLowerCase?.() ?? method;
+  const schemaOperation = pathKey && methodKey ? schemaPaths?.[pathKey]?.[methodKey] : null;
+  const rawWithConsumes = schemaOperation && typeof schemaOperation === "object" ? { ...schemaOperation, ...raw } : raw;
+  return inferRequestBodyContentTypeFromRaw(rawWithConsumes);
+}
 const newEndpointTmpl = ({
   route,
   codegenParams,
@@ -285,8 +428,20 @@ const newEndpointTmpl = ({
   const requestInfoMeta = codegenParams.getEndpointMeta?.(route, utils);
   const requestMeta = codegenParams.getRequestMeta?.(route, utils);
   const resultPath = (codegenParams.requestPathPrefix ?? "") + path2 + (codegenParams.requestPathSuffix ?? "");
-  const bodyContentType = requestContentKind[requestBodyInfo.contentKind] || null;
-  const responseFormat = responseContentKind[responseBodyInfo.success?.schema?.contentKind] || null;
+  const bodyContentType = getRequestBodyContentType(
+    requestBodyInfo,
+    raw,
+    configuration,
+    path2,
+    method
+  ) || null;
+  const responseFormat = getResponseFormat(
+    responseBodyInfo,
+    raw,
+    configuration,
+    path2,
+    method
+  ) || null;
   const reservedDataContractNames = _.uniq([
     ...requestOutputDataTypes,
     requestOutputErrorType || "any",
@@ -385,17 +540,17 @@ const allEndpointPerFileTmpl = async (params) => {
   } = params;
   const { _ } = utils;
   const dataContractNamesInThisFile = [];
+  const dataContactNames = new Set(
+    Object.keys(
+      configuration.config.swaggerSchema?.components?.schemas
+    ).map((schemaName) => utils.formatModelName(schemaName))
+  );
   const newEndpointTemplates = routes.map((route) => {
     const newEndpointTemplateData = newEndpointTmpl({
       ...params,
       route
     });
     const { reservedDataContractNames } = newEndpointTemplateData;
-    const dataContactNames = new Set(
-      Object.keys(
-        configuration.config.swaggerSchema?.components?.schemas
-      ).map((schemaName) => utils.formatModelName(schemaName))
-    );
     reservedDataContractNames.forEach((reservedDataContractName) => {
       if (!dataContactNames.has(reservedDataContractName)) {
         dataContractNamesInThisFile.push(reservedDataContractName);
@@ -438,14 +593,14 @@ const allEndpointPerFileTmpl = async (params) => {
       }
     )
   );
+  const endpointTemplatesContent = endpointTemplates.filter(Boolean).join("\n\n");
   if (metaInfo) {
     extraImportLines.push(
       `import { ${[groupName && "Group", metaInfo?.namespace && "namespace", "Tag"].filter(Boolean).join(",")} } from "${groupName ? "../" : "./"}meta-info";`
     );
   }
-  return {
-    reservedDataContractNames: dataContractNamesInThisFile,
-    content: await formatTSContent(`${LINTERS_IGNORE}
+  const dataContractImportToken = "/*__DATA_CONTRACT_IMPORTS__*/";
+  const contentWithImportToken = await formatTSContent(`${LINTERS_IGNORE}
       import {
         RequestParams,
         HttpResponse,
@@ -455,32 +610,40 @@ const allEndpointPerFileTmpl = async (params) => {
       import { ${importFileParams.httpClient.exportName} } from "${importFileParams.httpClient.path}";
       import { ${importFileParams.queryClient.exportName} } from "${importFileParams.queryClient.path}";
       ${extraImportLines.join("\n")}
-
-      ${configuration.modelTypes.length > 0 ? `
-      import { ${configuration.modelTypes.map((it) => it.name).filter(
-      (it) => !dataContractNamesInThisFile.includes(it)
-    )} } from "${relativePathDataContracts}";
-      ` : ""}
+      ${dataContractImportToken}
 
       ${(await Promise.all(
-      dataContractNamesInThisFile.map(async (dataContractName) => {
-        const modelType = configuration.modelTypes.find(
-          (modelType2) => modelType2.name === dataContractName
-        );
-        if (!modelType) {
-          return "";
-        }
-        const contractType = await dataContractTmpl({
-          ...params,
-          contract: modelType,
-          addExportKeyword: true
-        });
-        return contractType;
-      })
-    )).filter(Boolean).join("\n\n")}
+    dataContractNamesInThisFile.map(async (dataContractName) => {
+      const modelType = configuration.modelTypes.find(
+        (modelType2) => modelType2.name === dataContractName
+      );
+      if (!modelType) {
+        return "";
+      }
+      const contractType = await dataContractTmpl({
+        ...params,
+        contract: modelType,
+        addExportKeyword: true
+      });
+      return contractType;
+    })
+  )).filter(Boolean).join("\n\n")}
 
-      ${endpointTemplates.filter(Boolean).join("\n\n")}
-      `)
+      ${endpointTemplatesContent}
+      `);
+  const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const usedDataContractNames = configuration.modelTypes.map((modelType) => modelType.name).filter(
+    (modelTypeName) => !dataContractNamesInThisFile.includes(modelTypeName) && dataContactNames.has(modelTypeName) && new RegExp(`\\b${escapeRegExp(modelTypeName)}\\b`).test(
+      contentWithImportToken
+    )
+  );
+  const dataContractImportLine = usedDataContractNames.length > 0 ? `import { ${usedDataContractNames.join(", ")} } from "${relativePathDataContracts}";` : "";
+  return {
+    reservedDataContractNames: dataContractNamesInThisFile,
+    content: contentWithImportToken.replace(
+      dataContractImportToken,
+      dataContractImportLine
+    )
   };
 };
 const allExportsTmpl = async ({
@@ -565,9 +728,8 @@ const endpointPerFileTmpl = async (params) => {
       `import { ${requestInfoMeta.typeName} } from "${requestInfoMeta.typeNameImportPath}";`
     );
   }
-  return {
-    reservedDataContractNames: dataContractNamesInThisFile,
-    content: await formatTSContent(`${LINTERS_IGNORE}
+  const dataContractImportToken = "/*__DATA_CONTRACT_IMPORTS__*/";
+  const contentWithImportToken = await formatTSContent(`${LINTERS_IGNORE}
       import {
         RequestParams,
         HttpResponse,
@@ -577,47 +739,55 @@ const endpointPerFileTmpl = async (params) => {
       import { ${importFileParams.httpClient.exportName} } from "${importFileParams.httpClient.path}";
       import { ${importFileParams.queryClient.exportName} } from "${importFileParams.queryClient.path}";
       ${extraImportLines.join("\n")}
-
-      ${configuration.modelTypes.length > 0 ? `
-      import { ${configuration.modelTypes.map((it) => it.name).filter(
-      (it) => !dataContractNamesInThisFile.includes(it)
-    )} } from "${relativePathDataContracts}";
-      ` : ""}
+      ${dataContractImportToken}
 
       ${(await Promise.all(
-      dataContractNamesInThisFile.map(async (dataContractName) => {
-        const modelType = configuration.modelTypes.find(
-          (modelType2) => modelType2.name === dataContractName
-        );
-        if (!modelType) {
-          return "";
-        }
-        const contractType = await dataContractTmpl({
-          ...params,
-          contract: modelType,
-          addExportKeyword: true
-        });
-        return contractType;
-      })
-    )).filter(Boolean).join("\n\n")}
+    dataContractNamesInThisFile.map(async (dataContractName) => {
+      const modelType = configuration.modelTypes.find(
+        (modelType2) => modelType2.name === dataContractName
+      );
+      if (!modelType) {
+        return "";
+      }
+      const contractType = await dataContractTmpl({
+        ...params,
+        contract: modelType,
+        addExportKeyword: true
+      });
+      return contractType;
+    })
+  )).filter(Boolean).join("\n\n")}
 
       ${(await Promise.all(
-      localModelTypes.map(async (modelType) => {
-        const contractType = await dataContractTmpl({
-          ...params,
-          contract: modelType,
-          addExportKeyword: true
-        });
-        return contractType;
-      })
-    )).filter(Boolean).join("\n\n")}
+    localModelTypes.map(async (modelType) => {
+      const contractType = await dataContractTmpl({
+        ...params,
+        contract: modelType,
+        addExportKeyword: true
+      });
+      return contractType;
+    })
+  )).filter(Boolean).join("\n\n")}
       
       ${endpointJSDocTmpl({
-      ...params,
-      route
-    })}
+    ...params,
+    route
+  })}
       export const ${_.camelCase(route.routeName.usage)} = ${requestInfoInstanceContent}
-      `)
+      `);
+  const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const usedDataContractNames = configuration.modelTypes.map((modelType) => modelType.name).filter(
+    (modelTypeName) => !dataContractNamesInThisFile.includes(modelTypeName) && dataContactNames.has(modelTypeName) && new RegExp(`\\b${escapeRegExp(modelTypeName)}\\b`).test(
+      contentWithImportToken
+    )
+  );
+  const dataContractImportLine = usedDataContractNames.length > 0 ? `import { ${usedDataContractNames.join(", ")} } from "${relativePathDataContracts}";` : "";
+  return {
+    reservedDataContractNames: dataContractNamesInThisFile,
+    content: contentWithImportToken.replace(
+      dataContractImportToken,
+      dataContractImportLine
+    )
   };
 };
 const indexTsForEndpointPerFileTmpl = async ({
@@ -731,15 +901,11 @@ const removeUnusedTypesItteration = async ({
     }
   }
   let removedCount = 0;
-  const isNeedToRemoveType = unpackFilterOption(
-    keepTypes,
-    (name) => name,
-    false
-  );
+  const isKeepType = unpackFilterOption(keepTypes, (name) => name, false);
   for (const [name, declarations] of candidateTypes) {
     if (usedTypes.has(name)) continue;
     for (const decl of declarations) {
-      if ("remove" in decl && isNeedToRemoveType(name)) {
+      if ("remove" in decl && !isKeepType(name)) {
         decl.remove();
         removedCount++;
       }
@@ -930,6 +1096,7 @@ const generateApi = async (params) => {
   });
   const utils = codegenProcess.getRenderTemplateData().utils;
   const { _ } = utils;
+  const outputType = params.outputType ?? "one-endpoint-per-file";
   const shouldGenerateBarrelFiles = !params.noBarrelFiles;
   let namespace = null;
   if (params.namespace) {
@@ -940,8 +1107,8 @@ const generateApi = async (params) => {
     }
   }
   const codegenFs = codegenProcess.fileSystem;
-  codegenFs.cleanDir(params.output);
-  codegenFs.createDir(params.output);
+  codegenFs.cleanDir(paths.outputDir);
+  codegenFs.createDir(paths.outputDir);
   const filterTypes = unpackFilterOption(
     params.filterTypes,
     (modelType) => modelType.name
@@ -973,7 +1140,7 @@ const generateApi = async (params) => {
   const tagsSet = /* @__PURE__ */ new Set();
   if (params.groupBy == null) {
     collectedExportFilesFromIndexFile.push("endpoints");
-    if (params.outputType === "one-endpoint-per-file") {
+    if (outputType === "one-endpoint-per-file") {
       codegenFs.createDir(path.resolve(params.output, "endpoints"));
       const fileNamesWithRequestInfo = [];
       for await (const route of allRoutes) {
@@ -1053,7 +1220,7 @@ const generateApi = async (params) => {
         const fileName = "endpoints.ts";
         collectedExportFilesFromIndexFile.push("endpoints");
         codegenFs.createFile({
-          path: params.output,
+          path: paths.outputDir,
           fileName,
           withPrefix: false,
           content: requestInfoPerFileContent
@@ -1095,7 +1262,7 @@ const generateApi = async (params) => {
       );
       codegenFs.createDir(groupDirectory);
       let hasFilteredRoutes = false;
-      if (params.outputType === "one-endpoint-per-file") {
+      if (outputType === "one-endpoint-per-file") {
         codegenFs.createDir(path.resolve(groupDirectory, "endpoints"));
         for await (const route of routes) {
           const {
@@ -1192,7 +1359,7 @@ export * as ${exportGroupName} from './endpoints';
 `
           });
         }
-        if (shouldGenerateBarrelFiles && params.outputType === "one-endpoint-per-file") {
+        if (shouldGenerateBarrelFiles && outputType === "one-endpoint-per-file") {
           codegenFs.createFile({
             path: path.resolve(groupDirectory, "endpoints"),
             fileName: "index.ts",
@@ -1276,7 +1443,7 @@ export * as ${namespace} from './__exports';
   }
   if (params.removeUnusedTypes) {
     await removeUnusedTypes({
-      directory: params.output,
+      directory: paths.outputDir,
       keepTypes: params.removeUnusedTypes === true ? void 0 : params.removeUnusedTypes.keepTypes
     });
   }