swagger-typescript-api 13.0.0-experimental-1 → 13.0.1

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2019-present acacode
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+MIT License
+
+Copyright (c) 2019-present acacode
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 [![NPM badge](https://img.shields.io/npm/v/swagger-typescript-api.svg)](https://www.npmjs.com/package/swagger-typescript-api) 
 [![CI](https://github.com/acacode/swagger-typescript-api/actions/workflows/main.yml/badge.svg?branch=next)](https://github.com/acacode/swagger-typescript-api/actions/workflows/main.yml) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-32-orange.svg)](#contributors)
+[![All Contributors](https://img.shields.io/badge/all_contributors-33-orange.svg)](#contributors)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <img src="https://raw.githubusercontent.com/acacode/swagger-typescript-api/master/assets/swagger-typescript-api-logo.png" align="left"
@@ -21,9 +21,15 @@ Any questions you can ask [**here**](https://github.com/acacode/swagger-typescri
 
 ![](https://raw.githubusercontent.com/acacode/swagger-typescript-api/master/assets/components-converter-example.jpg)    
 
-👀 This project is looking for a code maintainer 👀    
 P.S. If you are creating the PR, please check your changes with using command `npm run prepare`  
-P.S. If you want to contribute please use branch `next`. All PRs which will have target `master` will be declined  
+P.S. If you want to contribute please use the `next` branch. All PRs that has target `master` will be declined!  
+
+
+Thanks to [Jetbrains](https://www.jetbrains.com/?from=swaggertypescriptapi) for providing a free license for their excellent Webstorm IDE.  
+<a href="https://www.jetbrains.com/?from=swaggertypescriptapi">
+  <img src="https://upload.wikimedia.org/wikipedia/commons/1/1a/JetBrains_Logo_2016.svg" alt="Jetbrains">
+</a>
+
 
 ## 👀 Examples  
 
@@ -75,6 +81,8 @@ Options:
   --debug                       additional information about processes inside this tool (default: false)
   --another-array-type          generate array types as Array<Type> (by default Type[]) (default: false)
   --sort-types                  sort fields and types (default: false)
+  --sort-routes                 sort routes in alphabetical order (default: false)
+  --custom-config <string>      custom config: primitiveTypeConstructs, hooks, ...  (default: "")
   --extract-enums               extract all enums from inline interface\type content to typescript enum construction (default: false)
   -h, --help                    display help for command
 
@@ -100,7 +108,7 @@ const { generateApi, generateTemplates } = require('swagger-typescript-api');
 const path = require("path");
 const fs = require("fs");
 
-/* NOTE: all fields are optional expect one of `output`, `url`, `spec` */
+/* NOTE: all fields are optional expect one of `input`, `url`, `spec` */
 generateApi({
   name: "MySuperbApi.ts",
   // set to `false` to prevent the tool from writing to disk
@@ -124,6 +132,7 @@ generateApi({
   toJS: false,
   extractRequestParams: false,
   extractRequestBody: false,
+  extractEnums: false,
   unwrapResponseData: false,
   prettier: { // By default prettier config is load from your project
     printWidth: 120,
@@ -142,6 +151,8 @@ generateApi({
   enumKeyPrefix: '',
   enumKeySuffix: '',
   addReadonly: false,
+  sortTypes: false,
+  sortRouters: false,
   extractingOptions: {
     requestBodySuffix: ["Payload", "Body", "Input"],
     requestParamsSuffix: ["Params"],
@@ -399,15 +410,16 @@ generateApi({
 ### `primitiveTypeConstructs`  
 
 It is type mapper or translator swagger schema objects. `primitiveTypeConstructs` translates `type`/`format` schema fields to typescript structs.  
-This option has type
-
+This option has type  
 ```ts
 type PrimitiveTypeStructValue =
-    | string
-    | ((schema: Record<string, any>, parser: import("./schema-parser-engine").SchemaProcessor) => string);
+  | string
+  | ((schema: Record<string, any>, parser: import("./src/schema-parser/schema-parser").SchemaParser) => string);
 
-type PrimitiveTypeStruct = Record<"integer" | "number" | "boolean" | "object" | "file" | "string" | "array",
-    string | ({ $default: PrimitiveTypeStructValue } & Record<string, PrimitiveTypeStructValue>)>
+type PrimitiveTypeStruct = Record<
+  "integer" | "number" | "boolean" | "object" | "file" | "string" | "array",
+  string | ({ $default: PrimitiveTypeStructValue } & Record<string, PrimitiveTypeStructValue>)
+>
 
 declare const primitiveTypeConstructs: (struct: PrimitiveTypeStruct) => Partial<PrimitiveTypeStruct>
 
@@ -442,8 +454,8 @@ generateApi({
             "relative-json-pointer": () => "string",
             regex: () => "string",
         },
-        array: async (schema, parser) => {
-            const content = await parser.getInlineParseContent(schema.items);
+        array: (schema, parser) => {
+            const content = parser.getInlineParseContent(schema.items);
             return parser.safeAddNullToType(schema, `(${content})[]`);
         },
     })
@@ -528,6 +540,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center"><a href="https://github.com/ApacheEx"><img src="https://avatars.githubusercontent.com/u/1918108?v=4?s=100" width="100px;" alt="Oleg Kuzava"/><br /><sub><b>Oleg Kuzava</b></sub></a><br /><a href="https://github.com/acacode/swagger-typescript-api/commits?author=ApacheEx" title="Code">💻</a> <a href="https://github.com/acacode/swagger-typescript-api/issues?q=author%3AApacheEx" title="Bug reports">🐛</a></td>
       <td align="center"><a href="http://nikz.se"><img src="https://avatars.githubusercontent.com/u/7352072?v=4?s=100" width="100px;" alt="Niklas Frank"/><br /><sub><b>Niklas Frank</b></sub></a><br /><a href="https://github.com/acacode/swagger-typescript-api/commits?author=nksfrank" title="Code">💻</a> <a href="https://github.com/acacode/swagger-typescript-api/issues?q=author%3Anksfrank" title="Bug reports">🐛</a></td>
       <td align="center"><a href="https://quentinbrunet.com"><img src="https://avatars.githubusercontent.com/u/20137632?v=4?s=100" width="100px;" alt="Quentin Brunet"/><br /><sub><b>Quentin Brunet</b></sub></a><br /><a href="https://github.com/acacode/swagger-typescript-api/commits?author=qboot" title="Code">💻</a></td>
+      <td align="center"><a href="https://github.com/Soarc"><img src="https://avatars.githubusercontent.com/u/3385495?v=4?s=100" width="100px;" alt="Gor Rustamyan"/><br /><sub><b>Gor Rustamyan</b></sub></a><br /><a href="https://github.com/acacode/swagger-typescript-api/commits?author=Soarc" title="Code">💻</a> <a href="https://github.com/acacode/swagger-typescript-api/issues?q=author%3ASoarc" title="Bug reports">🐛</a></td>
+      <td align="center"><a href="https://github.com/JochenDiekenbrock"><img src="https://avatars.githubusercontent.com/u/1625222?v=4?s=100" width="100px;" alt="Jochen Diekenbrock"/><br /><sub><b>Jochen Diekenbrock</b></sub></a><br /><a href="https://github.com/acacode/swagger-typescript-api/commits?author=JochenDiekenbrock" title="Code">💻</a> <a href="https://github.com/acacode/swagger-typescript-api/issues?q=author%3AJochenDiekenbrock" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>
 </table>

package/cli/constants.js

@@ -1,7 +1,7 @@
-const root_command = Symbol("root");
-const skip_command = Symbol("skip");
+const root_command = Symbol('root');
+const skip_command = Symbol('skip');
 
-const reservedOptions = ["version", "help"];
+const reservedOptions = ['version', 'help'];
 
 module.exports = {
   root_command,

package/cli/execute.js

@@ -1,10 +1,11 @@
-const _ = require("lodash");
-const { root_command, skip_command } = require("./constants");
-const { parseArgs } = require("./parse-args");
-const didYouMean = require("didyoumean");
+const _ = require('lodash');
+const { root_command, skip_command } = require('./constants');
+const { parseArgs } = require('./parse-args');
+const didYouMean = require('didyoumean');
 
 didYouMean.threshold = 0.5;
 
+// eslint-disable-next-line no-unused-vars
 const execute = (params, commands, instance) => {
   const args = parseArgs(params.args, params.from);
 
@@ -17,7 +18,9 @@ const execute = (params, commands, instance) => {
     }
 
     if (!usageOptions.length && command.name === root_command) {
-      usageOptions.push(command.options.find((option) => option.flags.name === "help"));
+      usageOptions.push(
+        command.options.find((option) => option.flags.name === 'help'),
+      );
     }
 
     const operationOptions = usageOptions.filter((option) => option.operation);
@@ -29,20 +32,23 @@ const execute = (params, commands, instance) => {
       });
       return;
     } else {
-      let error = "";
+      let error = '';
 
-      const processUserOptionData = (data, option) => {
-        if (!data.length && !option.flags.value) {
-          return !option.flags.isNoFlag;
-        }
-        if (option.flags.value) {
-          if (option.flags.value.variadic) {
-            return data.reduce((acc, d) => {
-              acc.push(...d.split(",").map(option.flags.value.formatter));
-              return acc;
-            }, []);
-          } else {
-            return option.flags.value.formatter(data[0] || option.default);
+      const processUserOptionData = (userOption, option) => {
+        if (userOption) {
+          const data = userOption.$data;
+          if (!data.length && !option.flags.value) {
+            return !option.flags.isNoFlag;
+          }
+          if (option.flags.value) {
+            if (option.flags.value.variadic) {
+              return data.reduce((acc, d) => {
+                acc.push(...d.split(',').map(option.flags.value.formatter));
+                return acc;
+              }, []);
+            } else {
+              return option.flags.value.formatter(data[0] || option.default);
+            }
           }
         }
 
@@ -52,17 +58,21 @@ const execute = (params, commands, instance) => {
       const parsedOptionsObject = command.options.reduce((acc, option) => {
         if (error) return acc;
 
-        const userOption = usageOptions.find((o) => o.flags.name === option.flags.name);
+        const userOption = usageOptions.find(
+          (o) => o.flags.name === option.flags.name,
+        );
 
         if (!userOption && option.required) {
           error = `required option '${option.flags.raw}' not specified`;
           return acc;
         }
 
-        if (userOption) {
-          acc[option.flags.name] = processUserOptionData(userOption.$data, option);
-        } else {
-          acc[option.flags.name] = option.default;
+        const flagValue = processUserOptionData(userOption, option);
+        if (!option.operation) {
+          const internal = option.internal || {};
+          acc[internal.name || option.flags.name] = internal.formatter
+            ? internal.formatter(flagValue)
+            : flagValue;
         }
 
         return acc;
@@ -84,7 +94,7 @@ const processArgs = (commands, args) => {
   let command = null;
   let usageOptions = [];
   let walkingOption = null;
-  let error = "";
+  let error = '';
 
   let allFlagKeys = [];
 
@@ -94,33 +104,44 @@ const processArgs = (commands, args) => {
     if (i === 0) {
       command = commands[arg];
 
-      if (!command && !arg.startsWith("-")) {
+      if (!command && !arg.startsWith('-')) {
         const tip = didYouMean(arg, _.keys(commands));
-        error = `unknown command ${arg}${tip ? `\n(Did you mean ${tip} ?)` : ""}`;
+        error = `unknown command ${arg}${
+          tip ? `\n(Did you mean ${tip} ?)` : ''
+        }`;
       } else if (!command) {
         command = commands[root_command];
       }
 
       if (command) {
-        allFlagKeys = command.options.reduce((acc, option) => [...acc, ...option.flags.keys], []);
+        allFlagKeys = command.options.reduce(
+          (acc, option) => [...acc, ...option.flags.keys],
+          [],
+        );
       }
     }
 
     if (error) return;
 
-    if (arg.startsWith("-")) {
-      const option = command.options.find((option) => option.flags.keys.includes(arg));
+    if (arg.startsWith('-')) {
+      const option = command.options.find((option) =>
+        option.flags.keys.includes(arg),
+      );
 
       if (!option) {
         const tip = didYouMean(arg, allFlagKeys);
-        error = `unknown option ${arg}${tip ? `\n(Did you mean ${tip} ?)` : ""}`;
+        error = `unknown option ${arg}${
+          tip ? `\n(Did you mean ${tip} ?)` : ''
+        }`;
       }
 
       if (option) {
         if (walkingOption && walkingOption.flags.name === option.flags.name) {
           return;
         }
-        const existedOption = usageOptions.find((o) => o.flags.name === option.flags.name);
+        const existedOption = usageOptions.find(
+          (o) => o.flags.name === option.flags.name,
+        );
         if (existedOption) {
           walkingOption = existedOption;
         } else {

package/cli/index.d.ts

@@ -1,9 +1,8 @@
-import { skip_command } from "./constants";
-
 type CliStructOption = {
   flags?: string;
   description?: string;
   default?: unknown;
+  internal?: { name?: string; formatter?: (value: any) => any };
 };
 
 type CliStruct = {

package/cli/index.js

@@ -1,9 +1,9 @@
-const _ = require("lodash");
-const { reservedOptions, root_command } = require("./constants");
-const { processOption } = require("./process-option");
-const { execute } = require("./execute");
-const { displayHelp } = require("./operations/display-help");
-const { displayVersion } = require("./operations/display-version");
+const _ = require('lodash');
+const { reservedOptions, root_command } = require('./constants');
+const { processOption } = require('./process-option');
+const { execute } = require('./execute');
+const { displayHelp } = require('./operations/display-help');
+const { displayVersion } = require('./operations/display-version');
 
 const cli = (input) => {
   const commands = {};
@@ -11,15 +11,15 @@ const cli = (input) => {
   const addCommand = (command, { addVersion = false, addHelp = true } = {}) => {
     commands[command.name] = {
       name: command.name,
-      description: `${command.description || ""}`,
+      description: `${command.description || ''}`,
       options: _.compact(_.map(command.options, processOption)),
     };
 
     if (addVersion) {
       commands[command.name].options.unshift(
         processOption({
-          flags: "-v, --version",
-          description: "output the current version",
+          flags: '-v, --version',
+          description: 'output the current version',
           operation: () => displayVersion(instance),
         }),
       );
@@ -28,9 +28,10 @@ const cli = (input) => {
     if (addHelp) {
       commands[command.name].options.push(
         processOption({
-          flags: "-h, --help",
-          description: "display help for command",
-          operation: () => displayHelp(commands, instance, commands[command.name]),
+          flags: '-h, --help',
+          description: 'display help for command',
+          operation: () =>
+            displayHelp(commands, instance, commands[command.name]),
         }),
       );
     }
@@ -62,7 +63,7 @@ const cli = (input) => {
     if (!processed) return;
 
     if (reservedOptions.includes(processed.name)) {
-      console.warn("reserved option", processed.name);
+      console.warn('reserved option', processed.name);
       return;
     }
 
@@ -71,16 +72,16 @@ const cli = (input) => {
 
   commands[root_command].options.unshift(
     processOption({
-      flags: "-v, --version",
-      description: "output the current version",
+      flags: '-v, --version',
+      description: 'output the current version',
       operation: () => displayVersion(instance),
     }),
   );
 
   commands[root_command].options.push(
     processOption({
-      flags: "-h, --help",
-      description: "display help for command",
+      flags: '-h, --help',
+      description: 'display help for command',
       operation: () => displayHelp(commands, instance, commands[root_command]),
     }),
   );

package/cli/operations/display-help.js

@@ -1,14 +1,21 @@
-const _ = require("lodash");
-const { root_command } = require("../constants");
+const _ = require('lodash');
+const { root_command } = require('../constants');
 
 const generateOptionsOutput = (options) =>
   options.reduce(
     (acc, option) => {
-      const flags = `${option.flags.keys.join(", ")}${option.flags.value?.raw ? ` ${option.flags.value?.raw}` : ""}`;
-      const description = `${option.description || ""}${
-        option.default === undefined || (option.flags.isNoFlag && option.default === true)
-          ? ""
-          : ` (default: ${typeof option.default === "string" ? `"${option.default}"` : option.default})`
+      const flags = `${option.flags.keys.join(', ')}${
+        option.flags.value?.raw ? ` ${option.flags.value?.raw}` : ''
+      }`;
+      const description = `${option.description || ''}${
+        option.default === undefined ||
+        (option.flags.isNoFlag && option.default === true)
+          ? ''
+          : ` (default: ${
+              typeof option.default === 'string'
+                ? `"${option.default}"`
+                : option.default
+            })`
       }`;
 
       if (flags.length > acc.maxLength) {
@@ -30,10 +37,10 @@ const generateOptionsOutput = (options) =>
 const generateOptionsTextOutput = (options, maxLength, spaces) =>
   options
     .map((option) => {
-      const spacesText = Array(spaces).fill(" ").join("");
-      const leftStr = `${spacesText}${option.flags.padEnd(maxLength, " ")}  `;
-      const leftStrFiller = Array(leftStr.length).fill(" ").join("");
-      const descriptionLines = option.description.split("\n");
+      const spacesText = Array(spaces).fill(' ').join('');
+      const leftStr = `${spacesText}${option.flags.padEnd(maxLength, ' ')}  `;
+      const leftStrFiller = Array(leftStr.length).fill(' ').join('');
+      const descriptionLines = option.description.split('\n');
 
       return (
         leftStr +
@@ -45,13 +52,15 @@ const generateOptionsTextOutput = (options, maxLength, spaces) =>
 
             return `\n${leftStrFiller}${line}`;
           })
-          .join("")
+          .join('')
       );
     })
-    .join("\n");
+    .join('\n');
 
 const displayAllHelp = (commands, instance) => {
-  const { options, maxLength: maxOptionLength } = generateOptionsOutput(commands[root_command].options);
+  const { options, maxLength: maxOptionLength } = generateOptionsOutput(
+    commands[root_command].options,
+  );
 
   const { commands: commandLabels, maxLength: maxCommandLength } = _.filter(
     commands,
@@ -59,7 +68,7 @@ const displayAllHelp = (commands, instance) => {
   ).reduce(
     (acc, command) => {
       const options = generateOptionsOutput(command.options);
-      const name = `${command.name}${options.length ? " [options]" : ""}`;
+      const name = `${command.name}${options.length ? ' [options]' : ''}`;
       const description = command.description;
 
       const maxLength = Math.max(name.length, options.maxLength);
@@ -84,10 +93,17 @@ const displayAllHelp = (commands, instance) => {
 
   const commandsOutput = commandLabels
     .map((commandLabel) => {
-      const leftStr = `  ${commandLabel.name.padEnd(maxCommandLength, " ")}    `;
-      const leftStrFiller = Array(leftStr.length).fill(" ").join("");
-      const descriptionLines = commandLabel.description.split("\n");
-      const optionsTextOutput = generateOptionsTextOutput(commandLabel.options.options, maxCommandLength, 4);
+      const leftStr = `  ${commandLabel.name.padEnd(
+        maxCommandLength,
+        ' ',
+      )}    `;
+      const leftStrFiller = Array(leftStr.length).fill(' ').join('');
+      const descriptionLines = commandLabel.description.split('\n');
+      const optionsTextOutput = generateOptionsTextOutput(
+        commandLabel.options.options,
+        maxCommandLength,
+        4,
+      );
 
       return (
         leftStr +
@@ -99,11 +115,11 @@ const displayAllHelp = (commands, instance) => {
 
             return `\n${leftStrFiller}${line}`;
           })
-          .join("") +
-        (optionsTextOutput.length ? `\n${optionsTextOutput}` : "")
+          .join('') +
+        (optionsTextOutput.length ? `\n${optionsTextOutput}` : '')
       );
     })
-    .join("\n");
+    .join('\n');
 
   const outputTest = [
     optionsOutput &&
@@ -114,11 +130,13 @@ ${optionsOutput}`,
 ${commandsOutput}`,
   ]
     .filter(Boolean)
-    .join("\n\n");
+    .join('\n\n');
 
-  console.log(`Usage: ${[instance.input.name, instance.input.alias].filter(Boolean).join("|")}${
-    optionsOutput ? " [options]" : ""
-  }${commandsOutput ? " [command]" : ""}
+  console.log(`Usage: ${[instance.input.name, instance.input.alias]
+    .filter(Boolean)
+    .join('|')}${optionsOutput ? ' [options]' : ''}${
+    commandsOutput ? ' [command]' : ''
+  }
 ${
   instance.input.description &&
   `
@@ -131,7 +149,9 @@ ${outputTest}`);
 const displayHelp = (commands, instance, command) => {
   if (command.name === root_command) return displayAllHelp(commands, instance);
 
-  const { options, maxLength: maxOptionLength } = generateOptionsOutput(command.options);
+  const { options, maxLength: maxOptionLength } = generateOptionsOutput(
+    command.options,
+  );
   const optionsOutput = generateOptionsTextOutput(options, maxOptionLength, 2);
 
   const outputTest = [
@@ -140,9 +160,11 @@ const displayHelp = (commands, instance, command) => {
 ${optionsOutput}`,
   ]
     .filter(Boolean)
-    .join("\n\n");
+    .join('\n\n');
 
-  console.log(`Usage: ${instance.input.name} ${command.name}${optionsOutput ? " [options]" : ""}
+  console.log(`Usage: ${instance.input.name} ${command.name}${
+    optionsOutput ? ' [options]' : ''
+  }
 ${
   command.description &&
   `

package/cli/parse-args.js

@@ -1,18 +1,18 @@
 const parseArgs = (args, type) => {
   if (args == null || !Array.isArray(args)) {
-    throw "args should be array";
+    throw 'args should be array';
   }
   const argsCopy = args.slice();
 
   switch (type) {
-    case "electron": {
+    case 'electron': {
       if (process.defaultApp) {
         return argsCopy.slice(2);
       }
 
       return argsCopy.slice(1);
     }
-    case "user": {
+    case 'user': {
       return argsCopy;
     }
     default: {

package/cli/process-option.js

@@ -1,4 +1,4 @@
-const _ = require("lodash");
+const _ = require('lodash');
 
 const optionFormatters = {
   number: (str) => +str,
@@ -13,29 +13,36 @@ const processFlags = (flags) => {
   let name = null;
   const keys = [];
   let value = null;
-  const isNoFlag = flags.includes("--no-");
+  const isNoFlag = flags.includes('--no-');
 
-  _.compact(_.split(flags, " ").map((str) => str.replace(/\,/g, ""))).forEach((str) => {
-    if (str.startsWith("-")) {
-      keys.push(str);
-    } else if (value === null) {
-      if (str.startsWith("{") || str.startsWith("[") || str.startsWith("<")) {
-        const rawValue = str.replace(/[\{\[\<\>\}\]\.]/g, "");
-        const variadic = str.includes("...");
-        value = {
-          raw: str,
-          variadic,
-          name: rawValue,
-          formatter: optionFormatters[rawValue] || optionFormatters.string,
-        };
+  _.compact(_.split(flags, ' ').map((str) => str.replace(/,/g, ''))).forEach(
+    (str) => {
+      if (str.startsWith('-')) {
+        keys.push(str);
+      } else if (value === null) {
+        if (str.startsWith('{') || str.startsWith('[') || str.startsWith('<')) {
+          const rawValue = str.replace(/[{[<>}\].]/g, '');
+          const variadic = str.includes('...');
+          value = {
+            raw: str,
+            variadic,
+            name: rawValue,
+            formatter: optionFormatters[rawValue] || optionFormatters.string,
+          };
+        }
       }
-    }
-  });
+    },
+  );
 
   const longestKey = keys.slice().sort((a, b) => b.length - a.length)[0];
 
   if (!_.isEmpty(longestKey)) {
-    name = _.camelCase((isNoFlag ? longestKey.replace("--no-", "") : longestKey).replace(/(--?)/, ""));
+    name = _.camelCase(
+      (isNoFlag ? longestKey.replace('--no-', '') : longestKey).replace(
+        /(--?)/,
+        '',
+      ),
+    );
   }
 
   return {
@@ -51,16 +58,17 @@ const processOption = (option) => {
   const processedFlags = processFlags(option.flags);
 
   if (!processedFlags.name) {
-    console.warn("invalid option", option);
+    console.warn('invalid option', option);
     return null;
   }
 
   return {
     required: !!option.required,
-    description: `${option.description || ""}`,
+    description: `${option.description || ''}`,
     default: option.default,
     flags: processedFlags,
     operation: option.operation,
+    internal: option.internal,
   };
 };