acacode
diff --git a/‎.gitignore
Lines changed: 2 additions & 0 deletions b/‎.gitignore
Lines changed: 2 additions & 0 deletions
diff --git a/‎.travis.yml
Lines changed: 1 addition & 9 deletions b/‎.travis.yml
Lines changed: 1 addition & 9 deletions
diff --git a/‎.vscode/launch.json
Lines changed: 8 additions & 0 deletions b/‎.vscode/launch.json
Lines changed: 8 additions & 0 deletions
diff --git a/‎CHANGELOG.md
Lines changed: 70 additions & 0 deletions b/‎CHANGELOG.md
Lines changed: 70 additions & 0 deletions
diff --git a/‎README.md
Lines changed: 42 additions & 13 deletions b/‎README.md
Lines changed: 42 additions & 13 deletions
diff --git a/‎assets/changelog_assets/extractRequestParams.jpg
59.1 KB b/‎assets/changelog_assets/extractRequestParams.jpg
59.1 KB
@@ -1,4 +1,6 @@
 node_modules
 .vscode
+.idea
 swagger-test-cli.*
+swagger-test-cli
 dist
@@ -6,16 +6,8 @@ cache:
   directories:
     - "node_modules"
 
-before_install:
-  - export PACKAGE_VERSION=$(node -p "require('./package.json').version")
-  - export PACKAGE_NAME=$(node -p "require('./package.json').name")
-  - export NPM_REMOTE_VERSION=$(npm view swagger-typescript-api version)
-  - export BRANCH_IS_TAG=$(node -p "/^([0-9].[0-9].[0-9]+((-(alpha|beta))|))$/.test('${TRAVIS_BRANCH}')")
-  - export GIT_LOG="$(git log --pretty=format:"* %s (%h)")"
-  - export PROJECT_NAME="acacode/swagger-typescript-api"
-
 install:
-  - npm ci
+  - npm i
 
 jobs:
   include:
 
@@ -27,6 +27,14 @@
       "cwd": "${workspaceFolder}",
       "runtimeExecutable": "npm",
       "runtimeArgs": ["run-script", "cli:debug:yaml"]
+    },
+    {
+      "name": "Debug Node",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "npm",
+      "runtimeArgs": ["run-script", "node:debug"]
     }
   ]
 }
@@ -1,5 +1,75 @@
 # next release  
 
+# 4.0.0  
+
+BREAKING_CHANGES:  
+- Migrate from [mustache](https://mustache.github.io/) template engine to [ETA](https://eta.js.org/) template engine. (Thanks @Fl0pZz)  
+- Critical change in `HttpResponse` type (Remove `D | null`, `E | null` unions)  
+```diff
+interface HttpResponse<D extends unknown, E extends unknown = unknown> extends Response {
+-  data: D | null;
++  data: D;
+-  error: E | null;
++  error: E;
+}
+```
+
+Features:  
+- `--modular` option. Allows to generate api class per module name.   
+  Example: [here](./tests/spec/modular)   
+- new templates on [ETA](https://eta.js.org/) (enhanced EJS) which can improve your templates! (Thanks @Fl0pZz)   
+  [ETA extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=shadowtime2000.eta-vscode) (thanks @shadowtime2000)  
+  Also moved out to templates:
+    - `procedure-call.eta` (request api method template)  
+    - `route-name.eta` (api method name template)  
+    - `route-docs.eta` (api method docs template)  
+
+  No worry about strange syntax it is very simple in usage :)  
+- Optional templates feature (Except templates using in `includeFile` `ETA` directive)  
+  Now you can store only the `ETA` templates which you need to change for yourself.  
+- `--extract-request-params` option. Generate path and query request params data contract and modify request payload args   
+  Example:  
+  ![extract-request-params](./assets/changelog_assets/extractRequestParams.jpg)  
+- Improve `data-contracts.eta` template. Added more power :)  
+- Add `extraTemplates` property for `generateApi()`. Allows to generate extra files via this tool.  
+- Add `hooks` property for `generateApi()`  
+  ```ts
+  hooks?: Partial<{
+    onCreateComponent: (component: SchemaComponent) => SchemaComponent | void;
+    onParseSchema: (originalSchema: any, parsedSchema: any) => any | void;
+    onCreateRoute: (routeData: ParsedRoute) => ParsedRoute | void;
+    /** Start point of work this tool (after fetching schema) */
+    onInit?: <C extends GenerateApiConfiguration["config"]>(configuration: C) => C | void;
+    /** Allows to customize configuration object before sending it to templates. */
+    onPrepareConfig?: <C extends GenerateApiConfiguration>(currentConfiguration: C) => C | void;
+  }>;
+  ```
+  ```ts
+    generateApi({
+      input: "./schema.json",
+      output: "./__generated__",
+      hooks: {
+        onCreateComponent(component) {
+          // do something
+          return component;
+        },
+        // ...
+      }
+    })
+  ```
+
+Internal:  
+- Update all dependencies to latest  
+
+Fixes:  
+- `x-enumNames` support for enums  
+- Problem of complex types (`oneOf`, `allOf`) with `properties` field  
+- `additionalProperties: true` should make `[key: string]: any` for object types (Thanks @brookjordan for issue #103)  
+
+Common:  
+- `HttpClient` is exportable by default  
+- Improve typings when use `swagger-typescript-api` with NodeJS (`index.d.ts`)  
+
 # 3.1.2  
 Fixes:  
 - axios vulnerability (#101 issue, thanks @Mvbraathen)  
 
@@ -2,6 +2,7 @@
 
 [![Greenkeeper badge](https://badges.greenkeeper.io/acacode/swagger-typescript-api.svg)](https://greenkeeper.io/)
 [![NPM badge](https://img.shields.io/npm/v/swagger-typescript-api.svg)](https://www.npmjs.com/package/swagger-typescript-api)
+[![Build Status](https://travis-ci.org/acacode/swagger-typescript-api.svg?branch=master)](https://travis-ci.org/acacode/swagger-typescript-api)
 
 <img src="https://raw.githubusercontent.com/acacode/swagger-typescript-api/master/assets/swagger-typescript-api-logo.png" align="left"
      title="swagger-typescript-api logo by js2me" width="93" height="180">
@@ -23,9 +24,8 @@ Any questions you can ask [**here**](https://github.com/acacode/swagger-typescri
 
 All examples you can find [**here**](https://github.com/acacode/swagger-typescript-api/tree/master/tests)  
 
-## 🛑 It is the latest version on mustache templates   
-Next versions 4.0.0+ will use the [ETA](https://eta.js.org/docs/syntax) templates.  
-If you want to create fork with `mustache` templates use `mustache-latest` branch  
+## 🛑 It is new version with [ETA](https://eta.js.org/docs/syntax) templates  
+Version with `mustache` templates is `>4.0.0`  
 
 ## 📄 Usage  
 
@@ -47,9 +47,13 @@ Options:
   --union-enums                 generate all "enum" types as union types (T1 | T2 | TN) (default: false)
   --route-types                 generate type definitions for API routes (default: false)
   --no-client                   do not generate an API class
+  --enum-names-as-values        use values in 'x-enumNames' as enum values (not only as keys) (default: false)
   --js                          generate js api module with declaration file (default: false)
+  --extract-request-params      extract request params to data contract (default: false)
+                                Also combine path params and query params into one object
   --module-name-index <number>  determines which path index should be used for routes separation (default: 0)
                                 (example: GET:/fruites/getFruit -> index:0 -> moduleName -> fruites)
+  --modular                     generate separated files for http client, data contracts, and routes (default: false)
   -h, --help                    display help for command
 ```
 
@@ -67,15 +71,23 @@ generateApi({
   name: "MySuperbApi.ts", // name of output typescript file
   url: 'http://api.com/swagger.json', // url where located swagger schema
 })
-  .then(sourceFile => fs.writeFile(path, sourceFile))
+  .then(({ files, configuration }) => {
+    files.forEach(({ content, name }) => {
+      fs.writeFile(path, content);
+    });
+  })
   .catch(e => console.error(e))
 
 // example with local file  
 generateApi({
   name: "ApiModule.ts", // name of output typescript file
   input: resolve(process.cwd(), './foo/swagger.json') // path to swagger schema
 })
-  .then(sourceFile => fs.writeFile(path, sourceFile))
+  .then(({ files, configuration }) => {
+    files.forEach(({ content, name }) => {
+      fs.writeFile(path, content);
+    });
+  })
   .catch(e => console.error(e))
 
 // example with parsed schema  
@@ -98,19 +110,36 @@ generateApi({
     // ...
   }
 })
-  .then(sourceFile => fs.writeFile(path, sourceFile))
+  .then(({ files, configuration }) => {
+    files.forEach(({ content, name }) => {
+      fs.writeFile(path, content);
+    });
+  })
   .catch(e => console.error(e))
 
 ```
 
 
 ## 💎 options   
 ### **`--templates`**  
-This option should be used in cases when you don't want to use default `swagger-typescript-api` output structure  
+This option needed for cases when you don't want to use default `swagger-typescript-api` output structure  
+
+Templates:  
+- `api.eta` - Api class module  
+- `data-contracts.eta` - all types (data contracts) from swagger schema  
+- `http-client.eta` - HttpClient class module  
+- `procedure-call.eta` - route in Api class  
+- `route-docs.eta` - documentation for route in Api class  
+- `route-name.eta` - route name for route in Api class  
+- `route-type.eta` - *(`--route-types` option)*  
+- `route-types.eta` - *(`--route-types` option)*  
+
 How to use it:  
-1. copy [**swagger-typescript-api templates**](https://github.com/acacode/swagger-typescript-api/tree/mustache-latest/src/templates/defaults) into your place in project  
+1. copy swagger-typescript-api templates into your place in project
+    - from [/templates/default](https://github.com/acacode/swagger-typescript-api/tree/next/templates/default) for single api file  
+    - from [/templates/modular](https://github.com/acacode/swagger-typescript-api/tree/next/templates/modular) for multiple api files (with `--modular` option)  
 1. add `--templates PATH_TO_YOUR_TEMPLATES` option  
-2. modify [Mustache](https://mustache.github.io/) templates as you like  
+2. modify [ETA](https://eta.js.org/docs/syntax) templates as you like  
 
 ### **`--module-name-index`**  
 This option should be used in cases when you have api with one global prefix like `/api`   
@@ -139,10 +168,10 @@ When we change it to `--module-name-index 1` then Api class have two properties
 
 ## 🛠️ Contribution  
 
-You can manually check your changes at schemas in `tests` folder before create a PR.  
-To do that have scripts:  
-    - `npm run generate` - generate API modules from schemas in `tests` folder  
-    - `npm run validate` - validate generated API modules via TypeScript  
+
+❗❗❗ Please use the `next` branch :)   
+
+If you need to check your changes at schemas in `tests` folder before create a PR just run command `npm run test:all`  
 
 ## 📝 License  
 Licensed under the [MIT License](https://github.com/acacode/swagger-typescript-api/blob/master/LICENSE).
Original file line number	Diff line number	Diff line change
`@@ -27,6 +27,14 @@`
`27`	`27`	`"cwd": "${workspaceFolder}",`
`28`	`28`	`"runtimeExecutable": "npm",`
`29`	`29`	`"runtimeArgs": ["run-script", "cli:debug:yaml"]`
	`30`	`+ },`
	`31`	`+ {`
	`32`	`+ "name": "Debug Node",`
	`33`	`+ "type": "node",`
	`34`	`+ "request": "launch",`
	`35`	`+ "cwd": "${workspaceFolder}",`
	`36`	`+ "runtimeExecutable": "npm",`
	`37`	`+ "runtimeArgs": ["run-script", "node:debug"]`
`30`	`38`	`}`
`31`	`39`	`]`
`32`	`40`	`}`