@automatons/typescript-client-axios 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) tanmen (yt.prog@gmail.com)
+
+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

@@ -0,0 +1,5 @@
+# @automatons/typescript-client-axios
+
+## What @automatons/typescript-client-axios
+This is generator.
+Only use openapi-automatons.

package/extractors/api.d.ts

@@ -0,0 +1,7 @@
+import { Api } from "@automatons/parser";
+export declare const extractApiMeta: (api: Api) => {
+    hasQuery: boolean;
+    hasTemplate: boolean;
+    hasFormData: boolean;
+};
+//# sourceMappingURL=api.d.ts.map

package/extractors/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/extractors/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,GAAG,EAAO,MAAM,oBAAoB,CAAC;AAIzD,eAAO,MAAM,cAAc,QAAS,GAAG;;;;CAQtC,CAAC"}

package/extractors/api.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractApiMeta = void 0;
+const isAffectPath = (path) => ['post', 'patch', 'put'].includes(path.method);
+exports.extractApiMeta = (api) => {
+    const hasTemplate = api.servers.some(server => { var _a; return (_a = server.values) === null || _a === void 0 ? void 0 : _a.length; })
+        || api.paths.some(path => { var _a; return (_a = path.parameters) === null || _a === void 0 ? void 0 : _a.length; })
+        || api.paths.some(path => { var _a; return (_a = path.headers) === null || _a === void 0 ? void 0 : _a.length; });
+    const hasQuery = api.paths.some(path => { var _a; return (_a = path.queries) === null || _a === void 0 ? void 0 : _a.length; })
+        || api.paths.some(path => { var _a; return (_a = path.cookies) === null || _a === void 0 ? void 0 : _a.length; });
+    const hasFormData = api.paths.some(path => { var _a; return isAffectPath(path) ? (_a = path.forms) === null || _a === void 0 ? void 0 : _a.length : false; });
+    return { hasQuery, hasTemplate, hasFormData };
+};
+//# sourceMappingURL=api.js.map

package/extractors/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/extractors/api.ts"],"names":[],"mappings":";;;AAEA,MAAM,YAAY,GAAG,CAAC,IAAU,EAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE3F,QAAA,cAAc,GAAG,CAAC,GAAQ,EAAE,EAAE;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,wBAAC,MAAM,CAAC,MAAM,0CAAE,MAAM,GAAA,CAAC;WAChE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,wBAAC,IAAI,CAAC,UAAU,0CAAE,MAAM,GAAA,CAAC;WAC/C,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,wBAAC,IAAI,CAAC,OAAO,0CAAE,MAAM,GAAA,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,wBAAC,IAAI,CAAC,OAAO,0CAAE,MAAM,GAAA,CAAC;WACxD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,wBAAC,IAAI,CAAC,OAAO,0CAAE,MAAM,GAAA,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,WAAC,OAAA,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,OAAC,IAAI,CAAC,KAAK,0CAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA,EAAA,CAAC,CAAC;IAC5F,OAAO,EAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAC,CAAC;AAC9C,CAAC,CAAC"}

package/generator/generate.d.ts

@@ -0,0 +1,3 @@
+import { AutomatonSettings, Openapi } from "@automatons/tools";
+export declare const generate: (openapi: Openapi, settings: AutomatonSettings) => Promise<void[]>;
+//# sourceMappingURL=generate.d.ts.map

package/generator/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/generator/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,OAAO,EAAC,MAAM,mBAAmB,CAAC;AAO7D,eAAO,MAAM,QAAQ,YAAmB,OAAO,YAAY,iBAAiB,oBAiC3E,CAAC"}

package/generator/generate.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = void 0;
+const parser_1 = require("@automatons/parser");
+const writer_1 = require("./writer");
+const setup_1 = require("./setup");
+const api_1 = require("../extractors/api");
+exports.generate = async (openapi, settings) => {
+    const { outDir } = settings;
+    const promises = [];
+    await setup_1.setup();
+    const { models, apis, securities } = await parser_1.parser(openapi, settings);
+    if (models.length) {
+        promises.push(writer_1.write('models/index.hbs', [outDir, 'models', 'index.ts'], models));
+        const modelPromises = models
+            .map(model => writer_1.write('models/model.hbs', [outDir, 'models', `${model.filename}.ts`], model));
+        promises.push(...modelPromises);
+    }
+    if (apis.length) {
+        promises.push(writer_1.write('apis/index.hbs', [outDir, 'apis', 'index.ts'], apis), writer_1.write('apis/abstractApi.hbs', [outDir, 'apis', 'abstractApi.ts'], { securities }));
+        promises.push(...apis.map(api => writer_1.write('apis/api.hbs', [outDir, 'apis', `${api.filename}.ts`], {
+            api,
+            meta: api_1.extractApiMeta(api)
+        })));
+    }
+    promises.push(writer_1.write('index.hbs', [outDir, 'index.ts'], { api: apis.length, model: models.length }), writer_1.write('config.hbs', [outDir, 'config.ts'], { securities }), writer_1.write('utils/index.hbs', [outDir, 'utils', 'index.ts']), writer_1.write('utils/template.hbs', [outDir, 'utils', 'template.ts']), writer_1.write('utils/query.hbs', [outDir, 'utils', 'query.ts']), writer_1.write('utils/formData.hbs', [outDir, 'utils', 'formData.ts']));
+    return Promise.all(promises);
+};
+//# sourceMappingURL=generate.js.map

package/generator/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/generator/generate.ts"],"names":[],"mappings":";;;AACA,+CAA0C;AAC1C,qCAA+B;AAC/B,mCAA8B;AAC9B,2CAAiD;AAGpC,QAAA,QAAQ,GAAG,KAAK,EAAE,OAAgB,EAAE,QAA2B,EAAE,EAAE;IAC9E,MAAM,EAAC,MAAM,EAAC,GAAG,QAAQ,CAAC;IAC1B,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,aAAK,EAAE,CAAC;IAEd,MAAM,EAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAC,GAAG,MAAM,eAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,MAAM,EAAE;QACjB,QAAQ,CAAC,IAAI,CAAC,cAAK,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;QAChF,MAAM,aAAa,GAAG,MAAM;aACzB,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,cAAK,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9F,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAA;KAChC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,CACX,cAAK,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,EAC3D,cAAK,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,EAAC,UAAU,EAAC,CAAC,CAChF,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,cAAK,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE;YAC7F,GAAG;YACH,IAAI,EAAE,oBAAc,CAAC,GAAG,CAAC;SAC1B,CAAC,CAAC,CAAC,CAAC;KACN;IAED,QAAQ,CAAC,IAAI,CACX,cAAK,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAC,CAAC,EAClF,cAAK,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAC,UAAU,EAAC,CAAC,EACxD,cAAK,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EACvD,cAAK,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,EAC7D,cAAK,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EACvD,cAAK,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAC9D,CAAC;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;AAC9B,CAAC,CAAC"}

package/generator/index.d.ts

@@ -0,0 +1,2 @@
+export * from './generate';
+//# sourceMappingURL=index.d.ts.map

package/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/generator/index.js

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !exports.hasOwnProperty(p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./generate"), exports);
+//# sourceMappingURL=index.js.map

package/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA2B"}

package/generator/register.d.ts

@@ -0,0 +1,2 @@
+export declare const register: () => Promise<void[]>;
+//# sourceMappingURL=register.d.ts.map

package/generator/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/generator/register.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,QAAQ,uBAUhB,CAAC"}

package/generator/register.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = void 0;
+const fs_extra_1 = require("fs-extra");
+const glob_1 = require("glob");
+const handlebars_1 = require("handlebars");
+const paths_1 = __importDefault(require("../paths"));
+const convertName = (match) => match.replace(`${paths_1.default.templates}/`, '')
+    .replace('partials/', '')
+    .replace('.hbs', '');
+exports.register = () => new Promise((resolve, reject) => glob_1.glob('/**/partials/**/*.hbs', { root: paths_1.default.templates }, (err, matches) => err ? reject(err) : resolve(matches)))
+    .then(matches => matches.map(match => ({ name: convertName(match), path: match })))
+    .then(files => Promise.all(files.map(({ name, path }) => fs_extra_1.readFile(path, { encoding: 'utf-8' })
+    .then(data => handlebars_1.registerPartial(name, data)))));
+//# sourceMappingURL=register.js.map

package/generator/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/generator/register.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAkC;AAClC,+BAA0B;AAC1B,2CAA2C;AAC3C,qDAA6B;AAE7B,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,GAAG,eAAK,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC;KACrC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;KACxB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEZ,QAAA,QAAQ,GAAG,GAAG,EAAE,CAC3B,IAAI,OAAO,CAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACxC,WAAI,CAAC,uBAAuB,EAC1B,EAAC,IAAI,EAAE,eAAK,CAAC,SAAS,EAAC,EACvB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;KACzD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAiC,KAAK,CAAC,EAAE,CACnE,CAAC,EAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC,CAAC;KAC5C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CACxB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,EAAC,EAAE,EAAE,CAAC,mBAAQ,CAAC,IAAI,EAAE,EAAC,QAAQ,EAAE,OAAO,EAAC,CAAC;KAC5D,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,4BAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAC"}

package/generator/setup.d.ts

@@ -0,0 +1,2 @@
+export declare const setup: () => Promise<void[]>;
+//# sourceMappingURL=setup.d.ts.map

package/generator/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/generator/setup.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,KAAK,uBAAmB,CAAC"}

package/generator/setup.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setup = void 0;
+const handlebars_helpers_1 = __importDefault(require("handlebars-helpers"));
+const handlebars_1 = __importDefault(require("handlebars"));
+const register_1 = require("./register");
+handlebars_1.default.registerHelper('every', function (value, key, text) {
+    return value.every(item => (item[key] == undefined ? false : item[key]) === text);
+});
+handlebars_1.default.registerHelper('have', function (value, checkers) {
+    return value.some(item => checkers.every(({ key, text }) => item[key] === text));
+});
+handlebars_helpers_1.default({ handlebars: handlebars_1.default });
+exports.setup = () => register_1.register();
+//# sourceMappingURL=setup.js.map

package/generator/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/generator/setup.ts"],"names":[],"mappings":";;;;;;AAAA,4EAAyC;AACzC,4DAA4B;AAC5B,yCAAoC;AAEpC,oBAAE,CAAC,cAAc,CAAC,OAAO,EAAE,UAA4B,KAAU,EAAE,GAAY,EAAE,IAAgB;IAC/F,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;AACnF,CAAC,CAAC,CAAC;AAEH,oBAAE,CAAC,cAAc,CAAC,MAAM,EAAE,UAA4B,KAAU,EAAE,QAAmD;IACnH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAC,GAAG,EAAE,IAAI,EAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;AACjF,CAAC,CAAC,CAAC;AAEH,4BAAO,CAAC,EAAC,UAAU,EAAE,oBAAE,EAAC,CAAC,CAAC;AACb,QAAA,KAAK,GAAG,GAAG,EAAE,CAAC,mBAAQ,EAAE,CAAC"}

package/generator/writer.d.ts

@@ -0,0 +1,2 @@
+export declare function write(template: string, outDir: string | string[], context?: any): Promise<void>;
+//# sourceMappingURL=writer.d.ts.map

package/generator/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/generator/writer.ts"],"names":[],"mappings":"AAMA,wBAAsB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,GAAG,iBAKrF"}

package/generator/writer.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.write = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = require("fs-extra");
+const prettier_1 = require("prettier");
+const paths_1 = __importDefault(require("../paths"));
+const handlebars_1 = require("handlebars");
+async function write(template, outDir, context) {
+    const outputPath = Array.isArray(outDir) ? path_1.default.resolve(...outDir) : outDir;
+    await fs_extra_1.ensureDir(path_1.default.dirname(outputPath));
+    const data = await fs_extra_1.readFile(path_1.default.resolve(paths_1.default.templates, template), { encoding: 'utf-8' });
+    return fs_extra_1.writeFile(outputPath, prettier_1.format(handlebars_1.compile(data)(context), { parser: 'typescript' }));
+}
+exports.write = write;
+//# sourceMappingURL=writer.js.map

package/generator/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/generator/writer.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,uCAAwD;AACxD,uCAAgC;AAChC,qDAA6B;AAC7B,2CAAmC;AAE5B,KAAK,UAAU,KAAK,CAAC,QAAgB,EAAE,MAAyB,EAAE,OAAa;IACpF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5E,MAAM,oBAAS,CAAC,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,mBAAQ,CAAC,cAAI,CAAC,OAAO,CAAC,eAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAC,QAAQ,EAAE,OAAO,EAAC,CAAC,CAAC;IAC1F,OAAO,oBAAS,CAAC,UAAU,EAAE,iBAAM,CAAC,oBAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAC,MAAM,EAAE,YAAY,EAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AALD,sBAKC"}

package/index.d.ts

@@ -0,0 +1,4 @@
+import { Automaton } from "@automatons/tools";
+declare const generatorTypescriptAxiosClient: Automaton;
+export default generatorTypescriptAxiosClient;
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAG5C,QAAA,MAAM,8BAA8B,EAAE,SACT,CAAC;AAE9B,eAAe,8BAA8B,CAAC"}

package/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const generator_1 = require("./generator");
+const generatorTypescriptAxiosClient = (openapi, settings) => generator_1.generate(openapi, settings);
+exports.default = generatorTypescriptAxiosClient;
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AACA,2CAAqC;AAErC,MAAM,8BAA8B,GAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CACtE,oBAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE9B,kBAAe,8BAA8B,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@automatons/typescript-client-axios",
+  "version": "1.0.0",
+  "repository": "git@github.com:openapi-automatons/typescript-client-axios.git",
+  "author": "tanmen <yt.prog@gmail.com>",
+  "license": "MIT",
+  "keywords": [
+    "openapi",
+    "openapi-automatons",
+    "automatons",
+    "axios"
+  ],
+  "main": "index.js",
+  "scripts": {
+    "prebuild": "depcheck && node scripts/prebuild.js",
+    "build": "tsc && cp -R package.json README.md LICENSE src/templates dist",
+    "lint": "eslint src --ext .ts,.tsx",
+    "test": "jest",
+    "postinstall": "husky install && typesync && yarn check --integrity || yarn install --ignore-scripts && yarn-deduplicate",
+    "postversion": "cp package.json ../package.json"
+  },
+  "dependencies": {
+    "@automatons/parser": "^0.0.63",
+    "@automatons/tools": "^1.0.8",
+    "eslint": "^8.7.0",
+    "fs-extra": "^9.0.0",
+    "glob": "^7.2.0",
+    "handlebars": "^4.7.6",
+    "handlebars-helpers": "^0.10.0",
+    "prettier": "^2.5.1"
+  },
+  "peerDependencies": {
+    "axios": "^0",
+    "object-to-formdata": "^4",
+    "openapi-automatons": "^1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^16.1.0",
+    "@commitlint/config-conventional": "^16.0.0",
+    "@semantic-release/changelog": "^6.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^9.0.0",
+    "@types/eslint": "^8.4.1",
+    "@types/fs-extra": "^9.0.13",
+    "@types/glob": "^7.1.2",
+    "@types/handlebars": "^4.1.0",
+    "@types/handlebars-helpers": "^0.5.2",
+    "@types/jest": "^27.4.0",
+    "@types/js-yaml": "^4.0.5",
+    "@types/node": "^17.0.12",
+    "@types/prettier": "^2.0.0",
+    "@types/semantic-release": "^17.2.3",
+    "@typescript-eslint/eslint-plugin": "^5.10.1",
+    "@typescript-eslint/parser": "^5.10.1",
+    "depcheck": "^1.4.3",
+    "eslint": "^8.7.0",
+    "eslint-config-google": "^0.14.0",
+    "eslint-config-prettier": "^8.3.0",
+    "husky": "^7.0.4",
+    "jest": "^26.0.1",
+    "lint-staged": "^12.3.2",
+    "object-to-formdata": "^4.4.1",
+    "semantic-release": "^19.0.2",
+    "ts-jest": "^26.0.0",
+    "typescript": "^3.9.3",
+    "typesync": "^0.8.0",
+    "yarn-deduplicate": "^3.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/paths.d.ts

@@ -0,0 +1,7 @@
+declare const paths: {
+    src: string;
+    templates: string;
+    tmp: string;
+};
+export default paths;
+//# sourceMappingURL=paths.d.ts.map

package/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,KAAK;;;;CAIV,CAAC;AACF,eAAe,KAAK,CAAC"}

package/paths.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const paths = {
+    src: path_1.default.resolve(__dirname),
+    templates: path_1.default.resolve(__dirname, 'templates'),
+    tmp: path_1.default.resolve(__dirname, '../tmp')
+};
+exports.default = paths;
+//# sourceMappingURL=paths.js.map

package/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;AAAA,gDAAwB;AAExB,MAAM,KAAK,GAAG;IACZ,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5B,SAAS,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;IAC/C,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC;CACvC,CAAC;AACF,kBAAe,KAAK,CAAC"}

package/templates/apis/abstractApi.hbs

@@ -0,0 +1,59 @@
+import Axios, { AxiosInstance } from "axios";
+import { Config{{#if securities.length}}, Security{{/if}} } from "../config";
+
+const DateFormat = /^\d{4}-\d{2}-\d{2}([tT]\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:\d{2})|Z)?$/;
+const reviver = (_key: string, value: any) =>
+  typeof value === 'string' && DateFormat.test(value) ? new Date(value) : value;
+
+const BASE_AXIOS = Axios.create({
+  transformResponse: (data) => JSON.parse(data, reviver)
+});
+
+/**
+ * AbstractConfig
+ */
+export class AbstractConfig {
+	{{#if securities.length}}
+	readonly #security?: Security;
+
+	/**
+   * constructor
+   */
+	constructor(security?: Security) {
+		this.#security = security;
+	}
+
+	{{#each securities}}
+	{{#and (eq type 'http') (eq scheme 'basic')}}
+	protected async security(key: "{{name}}"): Promise<{username: string; password: string;}>;
+	{{else or (eq type 'oauth2') (eq type 'openIdConnect')}}
+	protected async security(key: "{{name}}", scopes: string[]): Promise<string>;
+	{{else}}
+	protected async security(key: "{{name}}"): Promise<string>;
+	{{/and}}
+	{{/each}}
+	protected async security(key: keyof Security, scopes?: string[]): Promise<string | {username: string; password: string;}> {
+		const security = this.#security?.[key];
+		if (!security) {
+			throw new Error("Unauthorized user request.");
+		} else if (security instanceof Function) {
+			return scopes ? security(scopes) : security();
+		}
+		return security;
+	}
+	{{/if}}
+}
+
+/**
+ * AbstractApi
+ */
+export class AbstractApi {
+  protected axios: AxiosInstance = BASE_AXIOS;
+
+  /**
+   * constructor
+   */
+  constructor({axios}: Config) {
+    if (axios) this.axios = axios;
+  }
+}

package/templates/apis/api.hbs

@@ -0,0 +1,19 @@
+import { AxiosResponse, AxiosRequestConfig } from "axios";
+import { AbstractApi, AbstractConfig } from "./abstractApi";
+import { Config{{#if securities.length}}, Security{{/if}} } from "../config";
+{{#with meta}}
+	{{#or hasTemplate hasQuery hasFormData ~}}
+		import { {{#if hasTemplate}}template{{#or hasQuery hasFormData}},{{/or}}{{/if}} {{#if hasQuery}}query{{#if hasFormData}},{{/if}}{{/if}} {{#if hasFormData}}formData{{/if}}  } from "../utils";
+	{{/or}}
+{{/with}}
+{{#each api/imports~}}
+  import { {{title}} } from "../models";
+{{/each}}
+
+{{#each api/servers}}
+type {{name}}Server = { name: "{{name}}"{{#if values}}; values: { {{#each values}}{{name}}: {{#if enums}}{{#each enums}}'{{this}}'{{#unless @last}} | {{/unless}}{{/each}}{{else}}string{{/if}} {{/each}} }; {{/if}} }
+{{/each}}
+
+{{> apis/class api }}
+
+{{> apis/config api }}

package/templates/apis/index.hbs

@@ -0,0 +1,3 @@
+{{#each this ~}}
+	export * from "./{{filename}}";
+{{/each}}

package/templates/apis/partials/arguments/server.hbs

@@ -0,0 +1,3 @@
+{{#if this~}}
+	server: {{#each this}}{{name}}Server{{#unless @last}} | {{/unless}}{{/each}}{{#lengthEqual this 1}} =  { name: '{{this/0/name}}'{{#if this/0/values}}, values: { {{#each this/0/values}}{{name}}: '{{defaultValue}}',{{/each}} } {{/if}} }{{/lengthEqual}},
+{{~/if}}

package/templates/apis/partials/arguments/server_interface.hbs

@@ -0,0 +1,3 @@
+{{#if this~}}
+	server?: {{#each this}}{{name}}Server{{#unless @last}} | {{/unless}}{{/each}},
+{{~/if}}

package/templates/apis/partials/class/arguments.hbs

@@ -0,0 +1,21 @@
+{{~#each parameters}}{{name}}: {{> models/type schema}},{{/each}}
+{{~#if forms}}form: {{#each forms}}{{#unless @first}} | {{/unless}}{{> models/type schema}}{{/each}},{{/if}}
+{{~#if queries}}queries: {
+{{~#each queries}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+}{{#if (every queries 'required' false)}} = {}{{/if}},
+{{/if}}
+headers: {
+	'Content-Type': {{#if forms}}{{#each forms}}{{#unless @first}} | {{/unless}}{{#each types}}{{#unless @first}} | {{/unless}}'{{this}}'{{/each}}{{/each}}{{else}}'application/json'{{/if}},
+	{{#each headers}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+	{{/each}}
+}{{#if (every headers 'required' false)}} = { 'Content-Type': 'application/json' }{{/if}},
+{{~#if cookies}}cookies: {
+{{~#each cookies}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+}{{#if (every cookies 'required' false)}} = {}{{/if}},
+{{/if}}
+{{~> apis/arguments/server servers}} config?: AxiosRequestConfig

package/templates/apis/partials/class/arguments_interface.hbs

@@ -0,0 +1,21 @@
+{{~#each parameters}}{{name}}: {{> models/type schema}},{{/each}}
+form: {{> models/type form/schema}},
+{{~#if queries}}queries: {
+{{~#each queries}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+},
+{{/if}}
+headers{{#filter form/types 'application/json'}}?{{/filter}}: {
+	'Content-Type': {{#each form/types}}{{#unless @first}} | {{/unless}}'{{this}}'{{/each}},
+	{{#each headers}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+	{{/each}}
+},
+{{~#if cookies}}cookies: {
+{{~#each cookies}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+},
+{{/if}}
+{{~> apis/arguments/server_interface servers}} config?: AxiosRequestConfig

package/templates/apis/partials/class/path.hbs

@@ -0,0 +1,4 @@
+"{{path}}"
+{{#each parameters}}
+  .replace("{ {{~name~}} }", template('{{name}}', {{name}}, '{{#unless style}}simple{{else}}{{style}}{{/unless}}', {{#unless explode}}false{{else}}{{explode}}{{/unless}}))
+{{~/each}}

package/templates/apis/partials/class/request.hbs

@@ -0,0 +1,14 @@
+{{> comment title=name async=true}}
+{{#gt (length forms) 1 }}
+{{#each forms}}
+public async {{../name}}({{> apis/class/arguments_interface .. form=this}}): Promise<AxiosResponse{{#if ../schema}}<{{> models/type ../schema}}>{{/if}}>;
+{{/each}}
+{{/gt}}
+public async {{name}}({{> apis/class/arguments}}): Promise<AxiosResponse{{#if schema}}<{{> models/type schema}}>{{/if}}> {
+	const path = {{> apis/class/path}};
+	const requestConfig = await this.#config.{{name}}({{> apis/class/variables }});
+	{{#if forms}}
+	const _form = formData(headers['Content-Type'], form);
+	{{/if}}
+	return this.axios.{{method}}(path, {{#if forms}}_form, {{/if}}requestConfig)
+}

package/templates/apis/partials/class/variables.hbs

@@ -0,0 +1,4 @@
+{{~#if queries}}queries,{{/if}}
+headers,
+{{~#if cookies}}cookies,{{/if}}
+{{~#if servers}}server,{{/if}} config

package/templates/apis/partials/class.hbs

@@ -0,0 +1,17 @@
+{{> comment}}
+export class {{title}} extends AbstractApi {
+	readonly #config: {{title}}Config;
+
+  /**
+   * constructor
+   * @param {Config} config
+   */
+	constructor(config: Config) {
+		super(config);
+		this.#config = new {{title}}Config({{#if securities.length}}config.security{{/if}});
+	}
+	{{#each paths}}
+
+	{{> apis/class/request }}
+	{{/each}}
+}

package/templates/apis/partials/config/arguments.hbs

@@ -0,0 +1,19 @@
+{{~#if queries}}queries: {
+{{~#each queries}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+}{{#if (every queries 'required' false)}} = {}{{/if}},
+{{/if}}
+headers: {
+'Content-Type': {{#if forms}}{{#each forms}}{{#unless @first}} | {{/unless}}{{#each types}}{{#unless @first}} | {{/unless}}'{{this}}'{{/each}}{{/each}}{{else}}'application/json'{{/if}},
+{{#each headers}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+}{{#if (every headers 'required' false)}} = { 'Content-Type': 'application/json' }{{/if}},
+{{~#if cookies}}cookies: {
+{{~#each cookies}}
+	{{name}}{{#unless required}}?{{/unless}}: {{> models/type schema}},
+{{/each}}
+}{{#if (every cookies 'required' false)}} = {}{{/if}},
+{{/if}}
+{{~> apis/arguments/server servers}} config?: AxiosRequestConfig

package/templates/apis/partials/config/request/baseURL.hbs

@@ -0,0 +1 @@
+config?.baseURL ? config.baseURL : {{title}}Config.server(server)

package/templates/apis/partials/config/request/cookies.hbs

@@ -0,0 +1,10 @@
+{{~#each cookies}}
+	if (cookies.{{name}}) {
+	_cookies['{{name}}'] =  query('{{name}}', cookies.{{name}}, 'form', {{#if explode}}true{{else}}false{{/if}});
+	}
+{{/each}}
+{{~#each securities}}
+	{{#and (eq type 'apiKey') (eq in 'cookie')~}}
+		_cookies['{{key}}'] = await this.security("{{name}}");
+	{{/and}}
+{{/each}}

package/templates/apis/partials/config/request/headers.hbs

@@ -0,0 +1,14 @@
+{{~#each headers}}
+if (headers.{{name}}) {
+	_headers['{{name}}'] =  template('{{name}}', headers.{{name}}, 'simple', {{#if explode}}true{{else}}false{{/if}});
+}
+{{/each}}
+{{~#each securities}}
+	{{#and (eq type 'apiKey') (eq in 'header')~}}
+		_headers['{{key}}'] = await this.security("{{name}}");
+	{{else and (eq type 'http') (eq schema 'bearer')}}
+		_headers['Authorization'] = `Bearer ${await this.security("{{name}}")}`;
+	{{else or (eq type 'oauth2') (eq type 'openIdConnect')}}
+		_headers['Authorization'] = `Bearer ${await this.security("{{name}}", [{{#each scopes}}"{{this}}"{{#unless @last}}, {{/unless}}{{/each}}])}`;
+	{{/and}}
+{{/each}}

package/templates/apis/partials/config/request/queries.hbs

@@ -0,0 +1,11 @@
+{
+	...config?.params,
+{{#each queries}}
+	...query("{{name}}", queries.{{name}}, '{{#unless style}}form{{else}}{{style}}{{/unless}}', {{#unless explode}}false{{else}}{{explode}}{{/unless}}),
+{{/each}}
+{{#each securities}}
+	{{#and (eq type 'apiKey') (eq in 'query')}}
+	{{key}}: await this.security("{{name}}"),
+	{{/and}}
+{{/each}}
+}

package/templates/apis/partials/config/request.hbs

@@ -0,0 +1,19 @@
+public async {{name}}({{> apis/config/arguments}}): Promise<AxiosRequestConfig> {
+	const params = {{> apis/config/request/queries }};
+
+	const _cookies = { ...config?.headers?.Cookie };
+	{{> apis/config/request/cookies }}
+
+	const _headers = { ...config?.headers, 'Content-Type': headers['Content-Type'], Cookie: _cookies };
+	{{> apis/config/request/headers }}
+
+	return {
+		...config,
+		{{#each securities}}
+		{{#and (eq type 'http') (eq scheme 'basic') }}auth: await this.security("{{name}}"),{{/and}}
+		{{~/each}}
+		baseURL: {{> apis/config/request/baseURL title=title }},
+		params,
+		headers: _headers
+	};
+}

package/templates/apis/partials/config/server.hbs

@@ -0,0 +1,11 @@
+private static server(server: {{#each servers}}{{name}}Server{{#unless @last}} | {{/unless}}{{/each}}) {
+	{{#each servers}}
+	if ('{{name}}' === server.name) {
+		return '{{url}}'
+		{{#each values}}
+			.replace('{ {{~name~}} }', template('{{name}}', server.values.{{name}}, 'simple', false))
+		{{~/each}};
+	}
+	{{/each}}
+	throw new Error('Undefined server. please define server.');
+}

package/templates/apis/partials/config.hbs

@@ -0,0 +1,14 @@
+class {{title}}Config extends AbstractConfig {
+	{{#if securities.length}}
+	constructor(security?: Security) {
+		super(security);
+	}
+	{{/if}}
+
+	{{> apis/config/server }}
+
+{{#each paths}}
+
+	{{> apis/config/request title=../title }}
+{{/each}}
+}

package/templates/config.hbs

@@ -0,0 +1,19 @@
+import { AxiosInstance } from "axios";
+
+export type Security = {
+{{#each securities}}
+	{{#and (eq type 'http') (eq scheme 'basic')}}
+	{{name}}: {username: string; password: string;} | Promise<{username: string; password: string;}> | (() => {username: string; password: string;} | Promise<{username: string; password: string;}>);
+	{{else or (eq type 'oauth2') (eq type 'openIdConnect')}}
+	{{name}}: string | Promise<string> | ((scopes?: string[]) => string | Promise<string>);
+	{{else}}
+	{{name}}: string | Promise<string> | (() => string | Promise<string>);
+	{{/and}}
+{{/each}}
+};
+
+export type Config = {
+  axios?: AxiosInstance;
+  token?: string | Promise<string> | (() => string | Promise<string>);
+	security?: Security;
+}

package/templates/index.hbs

@@ -0,0 +1,3 @@
+{{#if model}}export * from './models';{{/if}}
+{{#if api}}export * from './apis';{{/if}}
+export * from './config';

package/templates/models/index.hbs

@@ -0,0 +1,3 @@
+{{#each this ~}}
+	export * from "./{{filename}}";
+{{/each}}

package/templates/models/model.hbs

@@ -0,0 +1,6 @@
+{{#each imports~}}
+	import { {{title}} } from "./{{filename}}";
+{{/each}}
+
+{{> comment}}
+export type {{title}} = {{> models/type schema}};

package/templates/models/partials/allOf.hbs

@@ -0,0 +1,7 @@
+{{#noop~}}
+	(
+	{{~#each schemas}}
+		{{~#if @first}}{{> models/type}}{{else}} & {{> models/type}}{{/if~}}
+	{{/each~}}
+	)
+{{~/noop}}

package/templates/models/partials/array.hbs

@@ -0,0 +1,6 @@
+{{#if items ~}}
+	Array<{{#with items}}{{> models/type}}{{/with}}>
+{{~ else ~}}
+	any[]
+{{~/if}}
+{{~> models/nullable}}

package/templates/models/partials/boolean.hbs

@@ -0,0 +1 @@
+boolean{{> models/nullable}}

package/templates/models/partials/nullable.hbs

@@ -0,0 +1 @@
+{{#if nullable}} | null{{/if}}

package/templates/models/partials/number.hbs

@@ -0,0 +1,6 @@
+{{#if enum}}
+	{{~#each enum}}{{#if @first}}{{this}}{{else}} | {{this}}{{/if}}{{/each ~}}
+{{~ else ~}}
+	number
+{{~/if}}
+{{> models/nullable}}

package/templates/models/partials/object.hbs

@@ -0,0 +1,13 @@
+{{#noop}}
+{{#if properties ~}}
+{
+{{#each properties}}
+  {{> comment title=name}}
+  {{#inArray name "-"}}"{{name}}"{{else}}{{name}}{{/inArray}}{{#unless required}}?{{/unless}}: {{> models/type schema}};
+{{/each}}
+}
+{{~ else ~}}
+object
+{{~/if}}
+{{> models/nullable}}
+{{~/noop}}

package/templates/models/partials/oneOf.hbs

@@ -0,0 +1,7 @@
+{{#noop~}}
+	(
+	{{~#each schemas}}
+		{{~#if @first}}{{> models/type}}{{else}} | {{> models/type}}{{/if~}}
+	{{/each~}}
+	)
+{{~/noop}}

package/templates/models/partials/string.hbs

@@ -0,0 +1,10 @@
+{{~#if enum}}
+	{{~#each enum}}{{~#if @first}}"{{this}}"{{~else}} | "{{this}}"{{~/if}}{{~/each}}
+{{~else or (eq format 'date') (eq format 'date-time')~}}
+	Date
+{{~else eq format 'url'~}}
+	URL
+	{{~else~}}
+	string
+{{~/if}}
+{{> models/nullable}}

package/templates/models/partials/type.hbs

@@ -0,0 +1,19 @@
+{{#eq type 'model'}}
+	{{~ name ~}}
+{{else eq type 'object'}}
+	{{~> models/object}}
+{{else eq type 'allOf'}}
+	{{~> models/allOf}}
+{{else eq type 'oneOf'}}
+	{{~> models/oneOf}}
+{{else eq type 'array'}}
+	{{~> models/array}}
+{{else eq type 'boolean'}}
+	{{~> models/boolean}}
+{{else eq type 'string'}}
+	{{~> models/string}}
+{{else eq type 'number'}}
+	{{~> models/number}}
+{{else}}
+	{{~ type}}
+{{/eq}}

package/templates/partials/comment.hbs

@@ -0,0 +1,24 @@
+/**
+ * {{title}}
+{{#if async}}
+ * @async
+{{/if}}
+{{#if description}}
+ * @description {{description}}
+{{/if}}
+{{#if deprecated}}
+ * @deprecated
+{{/if}}
+{{#if readOnly}}
+ * @readonly
+{{/if}}
+{{#if defaultValue}}
+ * @default {{defaultValue}}
+{{/if}}
+{{#each params}}
+	* @params { {{type}} } {{name}}
+{{/each}}
+{{#if example}}
+ * @example
+{{/if}}
+ */

package/templates/utils/formData.hbs

@@ -0,0 +1,10 @@
+import { serialize } from 'object-to-formdata';
+
+export const formData = <T = unknown>(type: string, form: T): T | FormData => {
+	switch(type) {
+		case 'multipart/form-data':
+			return serialize(form);
+		default:
+			return form;
+	}
+}

package/templates/utils/index.hbs

@@ -0,0 +1,3 @@
+export * from './template';
+export * from './query';
+export * from './formData';

package/templates/utils/query.hbs

@@ -0,0 +1,74 @@
+import {ParsedUrlQueryInput} from 'querystring';
+
+const queryForm =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number },
+   explode: boolean): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      if (explode) {
+        return {[name]: value.map(String)}
+      } else {
+        return {[name]: value.join(',')}
+      }
+    } else if (value instanceof Object) {
+      if (explode) {
+        return value;
+      } else {
+        return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join(',')).join(',')}
+      }
+    } else {
+      return {[name]: value};
+    }
+  }
+
+const querySpaceDelimited =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      return {[name]: value.join(' ')}
+    } else if (value instanceof Object) {
+      return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join(' ')).join(' ')}
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+const queryPipeDelimited =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (Array.isArray(value)) {
+      return {[name]: value.join('|')}
+    } else if (value instanceof Object) {
+      return {[name]: Object.entries(value).map((prop: [string, string | number]) => prop.join('|')).join('|')}
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+const queryDeepObject =
+  (name: string,
+   value: string | number | Array<string | number> | { [key: string]: string | number }): ParsedUrlQueryInput => {
+    if (!Array.isArray(value) && value instanceof Object) {
+      return Object.keys(value).reduce((pre, cur) => ({...pre, [`${name}[${cur}]`]: value[cur]}), {});
+    }
+    throw new Error(`Unsupported value: ${name}`);
+  }
+
+export const query =
+  (
+    name: string,
+    value: undefined | string | number | Array<string | number> | { [key: string]: string | number },
+    style: 'form' | 'spaceDelimited' | 'pipeDelimited' | 'deepObject',
+    explode: boolean): ParsedUrlQueryInput => {
+    if (value === undefined) return {};
+    switch (style) {
+      case 'form':
+        return queryForm(name, value, explode);
+      case 'spaceDelimited':
+        return querySpaceDelimited(name, value);
+      case 'pipeDelimited':
+        return queryPipeDelimited(name, value);
+      case 'deepObject':
+        return queryDeepObject(name, value);
+      default:
+        throw new Error(`Unsupported style: ${style}`);
+    }
+  }

package/templates/utils/template.hbs

@@ -0,0 +1,55 @@
+const templateSimple = (explode: boolean, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value);
+  }
+  return value instanceof Object
+    ? Array.isArray(value)
+      ? value.join(',') : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(',')
+    : String(value);
+}
+
+const templateLabel = (explode: boolean, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return `.${value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value)}`;
+  }
+  return value instanceof Object
+    ? Array.isArray(value)
+      ? value.join(',') : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(',')
+    : String(value);
+}
+
+const templateMatrix = (explode: boolean, name: string, value: string | number | Array<string | number> | { [p: string]: string | number }): string => {
+  if (!explode) {
+    return `;${name}=${value instanceof Object
+      ? Array.isArray(value)
+        ? value.join(',') : Object.entries(value).map(prop => prop.join(',')).flat().join(',')
+      : String(value)}`;
+  }
+  return `;${value instanceof Object
+    ? Array.isArray(value)
+      ? value.map(item => `${name}=${item}`).join(';')
+      : Object.entries(value).map(([key, value]) => `${key}=${value}`).flat().join(';')
+    : `${name}=${String(value)}`}`;
+}
+
+export const template =
+  (
+    name: string,
+    value: string | number | Array<string | number> | { [key: string]: string | number },
+    style: 'simple' | 'label' | 'matrix',
+    explode: boolean): string => {
+    if (style === 'simple') {
+      return templateSimple(explode, value);
+    } else if (style === 'label') {
+      return templateLabel(explode, value);
+    } else if (style === 'matrix') {
+      return templateMatrix(explode, name, value);
+    }
+    throw new Error(`Unsupported style: ${style}`)
+  }