Release 6.3.0 (#196)

* feat: --type-suffix, --type-prefix options (issue #191, thanks @the-ult); feat: onFormatTypeName hook

* bump: up version to 6.3.0

Author: js2me

CHANGELOG.md

@@ -1,5 +1,16 @@
 # next release  
 
+# 6.3.0  
+
+Features:  
+- `--type-suffix` option. Allows to set suffix for data contract name. (issue #191, thanks @the-ult)  
+- `--type-prefix` option. Allows to set prefix for data contract name. (issue #191, thanks @the-ult)  
+  Examples [here](./spec/typeSuffixPrefix/schema.ts)  
+- `onFormatTypeName(usageTypeName, rawTypeName)` hook. Allow to format data contract names as you want.  
+
+Internal:  
+- rename and split `checkAndRenameModelName` -> `formatModelName`, `fixModelName`  
+
 # 6.2.1  
 
 Fixes:  

README.md

@@ -60,6 +60,8 @@ Options:
   --single-http-client          Ability to send HttpClient instance to Api constructor (default: false)
   --silent                      Output only errors to console (default: false)
   --default-response <type>     default type for empty response schema (default: "void")
+  --type-prefix <string>        data contract name prefix (default: "")
+  --type-suffix <string>        data contract name suffix (default: "")
   -h, --help                    display help for command
 ```
 

index.d.ts

@@ -115,6 +115,7 @@ interface GenerateApiParams {
     onCreateRequestParams?: (
       rawType: SchemaComponent["rawTypeData"],
     ) => SchemaComponent["rawTypeData"] | void;
+    onFormatTypeName?: (typeName: string, rawTypeName?: string) => string | void;
   }>;
   /**
    *  extra templates

index.js

@@ -67,6 +67,8 @@ program
   .option("--single-http-client", "Ability to send HttpClient instance to Api constructor", false)
   .option("--silent", "Output only errors to console", false)
   .option("--default-response <type>", "default type for empty response schema", TS_KEYWORDS.VOID)
+  .option("--type-prefix <string>", "data contract name prefix", "")
+  .option("--type-suffix <string>", "data contract name suffix", "")
   .option(
     "--clean-output",
     "clean output folder before generate api. WARNING: May cause data loss",
@@ -97,6 +99,8 @@ const {
   singleHttpClient,
   axios,
   silent,
+  typePrefix,
+  typeSuffix,
 } = program;
 
 generateApi({
@@ -122,4 +126,6 @@ generateApi({
   singleHttpClient: !!singleHttpClient,
   cleanOutput: !!cleanOutput,
   silent: !!silent,
+  typePrefix,
+  typeSuffix,
 });

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger-typescript-api",
-  "version": "6.2.1",
+  "version": "6.3.0",
   "description": "Create typescript api module from swagger schema",
   "scripts": {
     "cli:json": "node index.js -r -d -p ./swagger-test-cli.json -n swagger-test-cli.ts --extract-request-params --enum-names-as-values",
@@ -34,6 +34,7 @@
     "test:--js--axios": "node tests/spec/jsAxios/test.js",
     "test:--axios": "node tests/spec/axios/test.js",
     "test:--axios--single-http-client": "node tests/spec/axiosSingleHttpClient/test.js",
+    "test:--type-suffix--type-prefix": "node tests/spec/typeSuffixPrefix/test.js",
     "test:partialBaseTemplate": "node tests/spec/partialBaseTemplate/test.js",
     "test:partialDefaultTemplate": "node tests/spec/partialDefaultTemplate/test.js"
   },

package.json

@@ -49,6 +49,7 @@ const config = {
     onPrepareConfig: (apiConfig) => apiConfig,
     onCreateRequestParams: (rawType) => {},
     onCreateRouteName: () => {},
+    onFormatTypeName: (typeName, rawTypeName) => {},
   },
   defaultResponseType: TS_KEYWORDS.VOID,
   singleHttpClient: false,
@@ -69,6 +70,8 @@ const config = {
   templatesToRender: {},
   toJS: false,
   silent: false,
+  typePrefix: "",
+  typeSuffix: "",
 };
 
 /** needs to use data everywhere in project */

src/config.js

@@ -47,6 +47,8 @@ module.exports = {
     disableStrictSSL = config.disableStrictSSL,
     cleanOutput,
     silent = config.silent,
+    typePrefix = config.typePrefix,
+    typeSuffix = config.typeSuffix,
   }) =>
     new Promise((resolve, reject) => {
       addToConfig({
@@ -71,6 +73,8 @@ module.exports = {
         constants,
         silent,
         toJS: translateToJavaScript,
+        typePrefix,
+        typeSuffix,
       });
       (spec ? convertSwaggerObject(spec) : getSwaggerObject(input, url, disableStrictSSL))
         .then(({ usageSchema, originalSchema }) => {

src/index.js

@@ -5,21 +5,7 @@ const isValidName = (name) => /^([A-Za-z$_]{1,})$/g.test(name);
 
 const formattedModelNamesMap = new Map();
 
-const checkAndRenameModelName = (name) => {
-  if (typeof name !== "string") {
-    if (!config.silent) console.warn("🔨 wrong name of the model name", name, config.silent);
-
-    return name;
-  }
-
-  if (formattedModelNamesMap.has(name)) {
-    return formattedModelNamesMap.get(name);
-  }
-
-  if (/^([A-Z_]{1,})$/g.test(name)) {
-    return name;
-  }
-
+const fixModelName = (name) => {
   if (!isValidName(name)) {
     if (!/^[a-zA-Z_$]/g.test(name)) {
       name = `Type ${name}`;
@@ -37,14 +23,39 @@ const checkAndRenameModelName = (name) => {
     if (name.includes("-")) name = _.startCase(name).replace(/ /g, "");
   }
 
-  const formattedModelName = _.replace(_.startCase(name), /\s/g, "");
+  return name;
+};
+
+const formatModelName = (name) => {
+  if (typeof name !== "string") {
+    if (!config.silent) console.warn("🔨 wrong name of the model name", name);
+
+    return name;
+  }
+
+  if (/^([A-Z_]{1,})$/g.test(name)) {
+    return name;
+  }
+
+  if (formattedModelNamesMap.has(name)) {
+    return formattedModelNamesMap.get(name);
+  }
+
+  const fixedModelName = fixModelName(name);
+
+  const formattedModelName = _.replace(
+    _.startCase(`${config.typePrefix}_${fixedModelName}_${config.typeSuffix}`),
+    /\s/g,
+    "",
+  );
+  const modelName = config.hooks.onFormatTypeName(formattedModelName, name) || formattedModelName;
 
-  formattedModelNamesMap.set(name, formattedModelName);
+  formattedModelNamesMap.set(name, modelName);
 
-  return formattedModelName;
+  return modelName;
 };
 
 module.exports = {
-  checkAndRenameModelName,
+  formatModelName: formatModelName,
   isValidName,
 };

src/modelNames.js

@@ -1,5 +1,5 @@
 const { formatters } = require("./typeFormatters");
-const { checkAndRenameModelName } = require("./modelNames");
+const { formatModelName } = require("./modelNames");
 const { config } = require("./config");
 const { getTypeData } = require("./components");
 
@@ -12,7 +12,7 @@ const prepareModelType = (typeInfo) => {
   }
 
   const resultContent = formatters[type] ? formatters[type](content) : content;
-  const name = checkAndRenameModelName(originalName);
+  const name = formatModelName(originalName);
 
   return {
     typeIdentifier,