@paulpugovkin/api-docs-axios-ts-generator 1.0.6 → 1.0.8

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@paulpugovkin/api-docs-axios-ts-generator",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Generate TypeScript interfaces and axios classes from OpenAPI documentation",
-  "main": "src/index.min.js",
+  "main": "src/index.js",
   "bin": {
-    "api-docs-generator": "./src/index.min.js"
+    "api-docs-generator": "./bin/cli.js"
   },
   "types": "src/types/index.d.ts",
   "scripts": {

package/src/index.js

@@ -0,0 +1,166 @@
+const {program} = require("commander");
+const path = require("path");
+const fs = require("fs");
+
+// Модули генератора
+const {
+    cleanGeneratedFolder,
+} = require("./clean-generated-folder/cleanGeneratedFolder");
+const {
+    updateApiDocsJson,
+} = require("./update-api-docs-json/updateApiDocsJson");
+const {parseAndGenerate} = require("./parse-and-generate/parseAndGenerate");
+const {
+    generateIndexFileWithOpenApi,
+} = require("./generate-index-file-with-public-api/generateIndexFileWithPublicApi");
+const {
+    generateMainIndexFile,
+} = require("./generate-main-index-file/generateMainIndexFile");
+const {generateAxiosConfig} = require("./generators/axiosConfigGenerator");
+
+// Simple configuration loader
+const fs = require('fs');
+const path = require('path');
+
+async function loadConfig(configPath, cliOptions = {}) {
+  const resolvedPath = path.resolve(configPath);
+
+  if (!fs.existsSync(resolvedPath)) {
+    throw new Error(`Configuration file not found: ${resolvedPath}`);
+  }
+
+  const ext = path.extname(resolvedPath);
+  let config;
+
+  try {
+    if (ext === '.js') {
+      const modulePath = resolvedPath;
+      config = require(modulePath);
+    } else if (ext === '.json') {
+      const content = fs.readFileSync(resolvedPath, 'utf8');
+      config = JSON.parse(content);
+    } else if (ext === '.ts') {
+      const ts = require('typescript');
+      const result = ts.transpileModule(content, {
+        compilerOptions: {
+          module: 1, // CommonJS
+          target: 99, // ESNext
+          esModuleInterop: true,
+        },
+      });
+      const modulePath = resolvedPath.replace('.ts', '.js');
+      fs.writeFileSync(modulePath, result.outputText);
+      config = require(modulePath);
+    } else {
+      throw new Error(`Unsupported configuration file format. Use .js, .json, or .ts`);
+    }
+  } catch (error) {
+    throw new Error(`Failed to load configuration: ${error.message}`);
+  }
+
+  // Merge CLI options with config
+  return {
+    ...config,
+    ...cliOptions,
+  };
+}
+
+// Основной инструмент CLI
+program
+    .version("1.0.0")
+    .description("Generate TypeScript API client from OpenAPI documentation")
+    .option("-c, --config <path>", "Path to configuration file")
+    .option("--api-docs-url <url>", "URL to fetch the OpenAPI documentation")
+    .option("--api-docs-path <path>", "Local path to OpenAPI documentation file")
+    .option("--output-dir <dir>", "Output directory for generated files")
+    .option("--clean", "Clean output directory before generation")
+    .parse(process.argv);
+
+// Основной вызов
+async function main() {
+    const options = program.opts();
+    const configPath = options.config;
+
+    let config = null;
+
+    // Загрузка конфигурации из файла или использование CLI аргументов
+    if (configPath) {
+        try {
+            config = await loadConfig(configPath, {
+                apiDocsUrl: options.apiDocsUrl,
+                apiDocsPath: options.apiDocsPath,
+                outputDir: options.outputDir,
+            });
+        } catch (error) {
+            console.error(`Failed to load configuration: ${error.message}`);
+            process.exit(1);
+        }
+    } else {
+        // Режим обратной совместимости - использование CLI аргументов
+        const apiDocsUrl = options.apiDocsUrl;
+        const outputDir = options.outputDir || path.resolve(__dirname, "../generated");
+
+        // Проверяем, указан ли URL для API документации
+        if (!apiDocsUrl) {
+            console.error('Error: API documentation URL is required.');
+            console.error('Please specify --api-docs-url or --api-docs-path, or create a configuration file.');
+            console.error('Run "api-docs-generator --help" for more information.');
+            process.exit(1);
+        }
+
+        config = {
+            apiDocsUrl: apiDocsUrl,
+            outputDir: outputDir,
+            interfacesDir: path.join(outputDir, "interfaces"),
+            classesDir: path.join(outputDir, "classes"),
+            groupBy: "tag",
+            classMode: "multiple",
+            options: {
+                cleanOutputDir: options.clean !== undefined ? options.clean : true,
+                generateAxiosConfig: false,
+                generateIndexFiles: true,
+            },
+        };
+    }
+
+    console.log(`Using API Docs URL: ${config.apiDocsUrl}`);
+    console.log(`Output directory: ${config.outputDir}`);
+
+    // Определяем пути
+    const outputDir = config.outputDir;
+    const interfacesDir = config.interfacesDir || path.join(outputDir, "interfaces");
+    const classesDir = config.classesDir || path.join(outputDir, "classes");
+    const interfacesOpenApi = path.join(interfacesDir, "index.ts");
+    const classesOpenApi = path.join(classesDir, "index.ts");
+
+    // Очищаем папку, если нужно
+    if (config.options?.cleanOutputDir !== false) {
+        cleanGeneratedFolder(outputDir);
+    }
+
+    // Обновляем API-документацию
+    if (config.apiDocsUrl) {
+        await updateApiDocsJson(config.apiDocsUrl, "api-docs.json");
+    }
+
+    // Генерация кода на основе спецификаций OpenAPI
+    const apiDocsPath = config.apiDocsPath || "api-docs.json";
+    await parseAndGenerate(apiDocsPath, config);
+
+    // Генерация конфигурации axios, если нужно
+    if (config.options?.generateAxiosConfig) {
+        generateAxiosConfig(config, outputDir);
+    }
+
+    // Генерация файлов index.ts для интерфейсов
+    if (config.options?.generateIndexFiles !== false) {
+        await generateIndexFileWithOpenApi(interfacesDir, interfacesOpenApi);
+        await generateIndexFileWithOpenApi(classesDir, classesOpenApi);
+        await generateMainIndexFile(outputDir);
+    }
+
+    console.log("Generation completed successfully.");
+}
+
+// Вызов
+main().catch((err) => console.error("Error during generation:", err));

package/src/index.min.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-const fs=require('fs'),path=require('path'),{program}=require('commander'),{parseAndGenerate}=require('./parse-and-generate/parseAndGenerate'),{cleanGeneratedFolder}=require('./clean-generated-folder/cleanGeneratedFolder'),{collectGeneratedFiles}=require('./collect-genereted-files/collectGeneratedFiles'),{generateInterface}=require('./generate-interface/generateInterface'),{generateClass}=require('./generate-class/generateClass'),{generateMethod}=require('./generate-method/generateMethod'),{generateJSDoc}=require('./generate-js-doc/generateJSDoc'),{generateIndexFileWithPublicApi}=require('./generate-index-file-with-public-api/generateIndexFileWithPublicApi'),{generateMainIndexFile}=require('./generate-main-index-file/generateMainIndexFile'),{generateAxiosConfig}=require('./generators/axiosConfigGenerator'),{mapType}=require('./map-type/mapType'),{resolveType}=require('./resolve-type/resolveType'),{updateApiDocsJson}=require('./update-api-docs-json/updateApiDocsJson');program.name('api-docs-generator').description('Generate TypeScript interfaces and axios classes from OpenAPI documentation').version('1.0.5').option('-c, --config <path>','Path to configuration file').option('--api-docs-url <url>','URL to fetch OpenAPI documentation').option('--api-docs-path <path>','Local path to OpenAPI documentation file').option('--output-dir <dir>','Output directory for generated files').option('--clean','Clean output directory before generation');program.parse(process.argv);async function main(){let config;const options=program.opts();if(options.config){try{const configPath=path.resolve(options.config);if(!fs.existsSync(configPath)){console.error(`Configuration file not found: ${configPath}`);process.exit(1);}const configContent=fs.readFileSync(configPath,'utf8');const ext=path.extname(configPath);if(ext==='.js'){const modulePath=path.resolve(configPath);config=eval(`require('${modulePath.replace(/\\/g,'\\\\')}')`);}else if(ext==='.json'){config=JSON.parse(configContent);}else if(ext==='.ts'){const ts=require('typescript');const result=ts.transpileModule(configContent,{compilerOptions:{module:1,target:99,esModuleInterop:!0}});const modulePath=path.resolve(configPath.replace('.ts','.js'));fs.writeFileSync(modulePath,result);config=eval(`require('${modulePath.replace(/\\/g,'\\\\')}')`);}else{console.error('Unsupported configuration file format. Use .js, .json, or .ts');process.exit(1);}}catch(error){console.error(`Failed to load configuration: ${error.message}`);process.exit(1);}}else{const apiDocsUrl=options.apiDocsUrl;if(!apiDocsUrl){console.error('Error: API documentation URL is required.');console.error('Please specify --api-docs-url or --api-docs-path, or create a configuration file.');console.error('Run "api-docs-generator --help" for more information.');process.exit(1);}const outputDir=options.outputDir||path.resolve(__dirname,"../generated");config={apiDocsUrl:apiDocsUrl,outputDir:outputDir,interfacesDir:path.join(outputDir,"interfaces"),classesDir:path.join(outputDir,"classes"),groupBy:"tag",classMode:"multiple",options:{cleanOutputDir:options.clean!==undefined?options.clean:!0,generateAxiosConfig:!1,allowAxiosConfigSpread:!0}};}await cleanGeneratedFolder(config);const apiDocs=await updateApiDocsJson(config);const schemaData=apiDocs.paths?apiDocs.paths:apiDocs.components?.schemas||{};const generatedFiles=await collectGeneratedFiles(config);const interfaces=generatedFiles.filter(f=>f.endsWith('.ts')&&!f.includes('index'));const classes=generatedFiles.filter(f=>f.endsWith('.ts')&&!f.includes('index'));await generateInterface(schemaData,interfaces,config);await generateClass(schemaData,classes,config);await generateJSDoc(schemaData,classes,config);await generateMethod(schemaData,classes,config);await generateIndexFileWithPublicApi(config);await generateMainIndexFile(config);await generateAxiosConfig(config);console.log('✓ API client generated successfully!');console.log(`  Output directory: ${config.outputDir}`);}main().catch(error=>{console.error('Error:',error.message);process.exit(1);});