feat: ability to send custom ts code translator;

fix: problem with dot in query params

Author: js2me

CHANGELOG.md

@@ -1,5 +1,31 @@
 # next release  
 
+fix: problems with dot in query params (hard fix) (#460)   
+feature: ability to send custom Ts output code translator to js. Example:  
+```ts
+ const { Translator } = require("swagger-typescript-api/src/translators/translator");
+ const { JavascriptTranslator } = require("swagger-typescript-api/src/translators/javascript");
+
+ class MyTranslator extends Translator { // or use extends JavascriptTranslator
+     translate({ fileName, fileExtension, fileContent }) {
+         // format ts\js code with using this codeFormatter (prettier + ts import fixer)
+         this.codeFormatter.format(fileContent)
+         // config of the code gen process
+         this.config.
+         // logger
+         this.logger.
+
+         return [
+             {
+                 fileName,
+                 fileExtension,
+                 fileContent,
+             }
+         ]
+     }
+ }
+```
+
 ## 12.0.2
 
 fix: missing option `--extract-enums` (#344)  

index.d.ts

@@ -168,6 +168,37 @@ interface GenerateApiParamsBase {
 
   /** configuration for fetching swagger schema requests */
   requestOptions?: null | Partial<import("node-fetch").RequestInit>;
+
+  /** ts compiler configuration object (for --to-js option) */
+  compilerTsConfig?: Record<string, any>;
+
+  /**
+   * custom ts->* translator
+   * do not use constructor args, it can break functionality of this property, just send class reference
+   *
+   * @example
+   * ```ts
+   * const { Translator } = require("swagger-typescript-api/src/translators/translator");
+   *
+   * class MyTranslator extends Translator {
+   *
+   *     translate({ fileName, fileExtension, fileContent }) {
+   *         this.codeFormatter.format()
+   *         this.config.
+   *         this.logger.
+   *
+   *         return [
+   *             {
+   *                 fileName,
+   *                 fileExtension,
+   *                 fileContent,
+   *             }
+   *         ]
+   *     }
+   * }
+   * ```
+   */
+  customTranslator?: new () => typeof import("./src/translators/translator").Translator;
 }
 
 type CodeGenConstruct = {
@@ -505,6 +536,9 @@ export interface GenerateApiConfiguration {
     hooks: Hooks;
     enumNamesAsValues: boolean;
     version: string;
+    compilerTsConfig: Record<string, any>;
+    /** do not use constructor args, it can break functionality of this property, just send class reference */
+    customTranslator?: new (...args: never[]) => typeof import("./src/translators/translator").Translator;
     internalTemplateOptions: {
       addUtilRequiredKeysType: boolean;
     };
@@ -569,9 +603,18 @@ export interface GenerateApiConfiguration {
   };
 }
 
+type FileInfo = {
+  /** @example myFilename */
+  fileName: string;
+  /** @example .d.ts */
+  fileExtension: string;
+  /** content of the file */
+  fileContent: string;
+};
+
 export interface GenerateApiOutput {
   configuration: GenerateApiConfiguration;
-  files: { name: string; content: string; declaration: { name: string; content: string } | null }[];
+  files: FileInfo[];
   createFile: (params: { path: string; fileName: string; content: string; withPrefix?: boolean }) => void;
   renderTemplate: (
     templateContent: string,