@ps-aux/api-client-gen 0.1.0-rc1 → 0.1.2-rc1

package/dist/bin.esm.js

@@ -1,5 +1,5 @@
 #!/bin/env node
-import { g as generateApiClient } from './generateApiClient-PeRLjZk9.js';
+import { g as generateApiClient } from './generateApiClient-QyDbHHKj.js';
 import { cosmiconfigSync } from 'cosmiconfig';
 import 'path';
 import 'fs';

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/bin/env node
 'use strict';
 
-var generateApiClient = require('./generateApiClient-d_X--WFl.js');
+var generateApiClient = require('./generateApiClient-C11lxAxn.js');
 var cosmiconfig = require('cosmiconfig');
 require('path');
 require('fs');

package/dist/generateApiClient-C11lxAxn.js

@@ -0,0 +1,201 @@
+'use strict';
+
+var Path = require('path');
+var fs$1 = require('fs');
+var axios = require('axios');
+var fs = require('fs/promises');
+var swaggerTypescriptApi = require('swagger-typescript-api');
+var tsToZod = require('ts-to-zod');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs$1);
+
+const downloadSpec = async (path, url) => {
+    const res = await axios({
+        url,
+        method: 'GET',
+        responseType: 'arraybuffer',
+    }).catch(err => {
+        throw err.toString();
+    });
+    const content = res.data.toString();
+    await fs.writeFile(path, format(content));
+};
+const format = (content) => JSON.stringify(JSON.parse(content), null, 4);
+
+const generateOpenApiModel = async ({ input, isNode, responseWrapper, name, outputDir, ignoreOperationsWithTags }, log) => {
+    log(`Will generate API client name=${name} to ${outputDir}, node=${isNode}`);
+    const specialMapping = isNode
+        ? {
+            File: '{file: Buffer | stream.Readable, name: string}'
+        }
+        : {};
+    const fileName = 'index';
+    const dstFile = Path.join(outputDir, `${fileName}.ts`);
+    const ignoreTags = ignoreOperationsWithTags && new Set(ignoreOperationsWithTags);
+    await swaggerTypescriptApi.generateApi({
+        name: 'index',
+        output: outputDir,
+        input: input,
+        // modular: true,
+        httpClientType: 'axios',
+        templates: Path.resolve(getThisScriptDirname(), '../templates'),
+        defaultResponseAsSuccess: true,
+        sortTypes: true,
+        // generateRouteTypes: true,
+        singleHttpClient: true,
+        // extractRequestBody: true,
+        cleanOutput: true,
+        moduleNameFirstTag: true,
+        apiClassName: capitalize(name) + 'Api',
+        hooks: {
+            onCreateRoute: (routeData) => {
+                if (ignoreTags) {
+                    const ignore = routeData.raw.tags?.find(t => ignoreTags.has(t));
+                    if (ignore)
+                        return false;
+                }
+                return routeData;
+            }
+        },
+        // @ts-ignore
+        codeGenConstructs: (struct) => ({
+            // @ts-ignore
+            Keyword: specialMapping
+        })
+        // extractRequestParams: true,
+    });
+    const addImports = [];
+    const replaces = [];
+    if (isNode) {
+        addImports.push('import stream from \'node:stream\'');
+    }
+    if (responseWrapper) {
+        log(`Will use response wrapper '${JSON.stringify(responseWrapper)}'`);
+        if (responseWrapper.import)
+            addImports.push(responseWrapper.import);
+        replaces.push(['Promise', responseWrapper.symbol]);
+    }
+    // Remove unnecessary generics
+    // replaces.push(['<SecurityDataType extends unknown>', ''])
+    // replaces.push(['<SecurityDataType>', ''])
+    // replaces.push(['request: <Data, A = any>', 'request: <Data>'])
+    log(`Will modify the outputs ${JSON.stringify({
+        addImports,
+        replaces
+    })}`);
+    await modifyOutput(dstFile, {
+        addImports,
+        replaces
+    });
+    return dstFile;
+};
+const modifyOutput = async (path, cmd) => {
+    let content = await fs.readFile(path).then((r) => r.toString());
+    if (cmd.addImports.length) {
+        content = cmd.addImports.join('\n') + '\n' + content;
+    }
+    cmd.replaces.forEach(([from, to]) => {
+        content = content.replaceAll(from, to);
+    });
+    await fs.writeFile(path, content);
+};
+const getThisScriptDirname = () => {
+    // Might be problem in ESM mode
+    return __dirname;
+};
+const capitalize = (str) => {
+    return str[0].toUpperCase() + str.substring(1);
+};
+
+// TODO needed?
+const removeGenericTypes = (code) => {
+    const regex = /export (interface|enum|type) [^<]* \{\n(.*\n)*?}/mg;
+    const matches = code.matchAll(regex);
+    const types = Array.from(matches).map(m => m[0]);
+    return types.join('\n');
+};
+const generateSchemas = (inputFile, outputFile, opts = {}) => {
+    const code = fs$1.readFileSync(inputFile).toString();
+    const { getZodSchemasFile } = tsToZod.generate({
+        sourceText: removeGenericTypes(code),
+        // inputOutputMappings: {
+        //
+        // },
+        customJSDocFormatTypes: {
+        // Custom mapping
+        // 'date-time': 'blablaj' - regex
+        }
+    });
+    const fileName = Path.basename(inputFile);
+    let f = getZodSchemasFile(`./${fileName.replace('.ts', '')}`);
+    // Add import from the api model - TODO find a way how to define on generate
+    f = f.replaceAll('"./index";', '"./client"');
+    // Backend sends nulls not undefined - should be properly set in the OpenAPI TS types generation!
+    f = f.replaceAll('.optional()', '.nullable()');
+    if (opts.localDateTimes) {
+        f = f.replaceAll('z.string().datetime()', 'z.string().datetime({local: true})');
+    }
+    fs$1.writeFileSync(outputFile, f);
+};
+
+const generateApiClient = async ({ dstDir, apiName, env, srcSpec, responseWrapper, ignoreOperationsWithTags, zodSchemas }, log = console.log) => {
+    if (!srcSpec)
+        throw new Error(`Url or path ('srcSpec' not specified`);
+    if (!apiName)
+        throw new Error('apiName not specified');
+    if (!dstDir)
+        throw new Error('dstDir not specified');
+    if (!env)
+        throw new Error('env not specified');
+    const dir = Path.resolve(dstDir, apiName);
+    if (!fs__namespace.existsSync(dir)) {
+        log(`Creating dir ${dir}`);
+        fs__namespace.mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    const clientDir = Path.resolve(dir, 'client');
+    const specPath = await getSpecPath(srcSpec, dir, log);
+    const clientFile = await generateOpenApiModel({
+        name: apiName,
+        input: specPath,
+        outputDir: clientDir,
+        ignoreOperationsWithTags,
+        isNode: env === 'node',
+        responseWrapper
+    }, log);
+    if (zodSchemas?.enabled === false)
+        return;
+    log('Generating Zod schemas');
+    generateSchemas(Path.resolve(dir, clientFile), Path.resolve(dir, './zod.ts'), zodSchemas);
+};
+const getSpecPath = async (urlOrPath, dir, log) => {
+    if (!urlOrPath.startsWith('http')) {
+        if (!fs__namespace.existsSync(urlOrPath))
+            throw new Error(`Spec file ${urlOrPath} does not exists`);
+        return urlOrPath;
+    }
+    const specPath = Path.resolve(dir, `spec.json`);
+    log(`Will download the API spec from ${urlOrPath} to ${specPath}`);
+    await downloadSpec(specPath, urlOrPath);
+    return specPath;
+};
+
+exports.generateApiClient = generateApiClient;

package/dist/generateApiClient-QyDbHHKj.js

@@ -0,0 +1,181 @@
+import Path from 'path';
+import * as fs from 'fs';
+import fs__default from 'fs';
+import axios from 'axios';
+import fs$1 from 'fs/promises';
+import { generateApi } from 'swagger-typescript-api';
+import { generate } from 'ts-to-zod';
+
+const downloadSpec = async (path, url) => {
+    const res = await axios({
+        url,
+        method: 'GET',
+        responseType: 'arraybuffer',
+    }).catch(err => {
+        throw err.toString();
+    });
+    const content = res.data.toString();
+    await fs$1.writeFile(path, format(content));
+};
+const format = (content) => JSON.stringify(JSON.parse(content), null, 4);
+
+const generateOpenApiModel = async ({ input, isNode, responseWrapper, name, outputDir, ignoreOperationsWithTags }, log) => {
+    log(`Will generate API client name=${name} to ${outputDir}, node=${isNode}`);
+    const specialMapping = isNode
+        ? {
+            File: '{file: Buffer | stream.Readable, name: string}'
+        }
+        : {};
+    const fileName = 'index';
+    const dstFile = Path.join(outputDir, `${fileName}.ts`);
+    const ignoreTags = ignoreOperationsWithTags && new Set(ignoreOperationsWithTags);
+    await generateApi({
+        name: 'index',
+        output: outputDir,
+        input: input,
+        // modular: true,
+        httpClientType: 'axios',
+        templates: Path.resolve(getThisScriptDirname(), '../templates'),
+        defaultResponseAsSuccess: true,
+        sortTypes: true,
+        // generateRouteTypes: true,
+        singleHttpClient: true,
+        // extractRequestBody: true,
+        cleanOutput: true,
+        moduleNameFirstTag: true,
+        apiClassName: capitalize(name) + 'Api',
+        hooks: {
+            onCreateRoute: (routeData) => {
+                if (ignoreTags) {
+                    const ignore = routeData.raw.tags?.find(t => ignoreTags.has(t));
+                    if (ignore)
+                        return false;
+                }
+                return routeData;
+            }
+        },
+        // @ts-ignore
+        codeGenConstructs: (struct) => ({
+            // @ts-ignore
+            Keyword: specialMapping
+        })
+        // extractRequestParams: true,
+    });
+    const addImports = [];
+    const replaces = [];
+    if (isNode) {
+        addImports.push('import stream from \'node:stream\'');
+    }
+    if (responseWrapper) {
+        log(`Will use response wrapper '${JSON.stringify(responseWrapper)}'`);
+        if (responseWrapper.import)
+            addImports.push(responseWrapper.import);
+        replaces.push(['Promise', responseWrapper.symbol]);
+    }
+    // Remove unnecessary generics
+    // replaces.push(['<SecurityDataType extends unknown>', ''])
+    // replaces.push(['<SecurityDataType>', ''])
+    // replaces.push(['request: <Data, A = any>', 'request: <Data>'])
+    log(`Will modify the outputs ${JSON.stringify({
+        addImports,
+        replaces
+    })}`);
+    await modifyOutput(dstFile, {
+        addImports,
+        replaces
+    });
+    return dstFile;
+};
+const modifyOutput = async (path, cmd) => {
+    let content = await fs$1.readFile(path).then((r) => r.toString());
+    if (cmd.addImports.length) {
+        content = cmd.addImports.join('\n') + '\n' + content;
+    }
+    cmd.replaces.forEach(([from, to]) => {
+        content = content.replaceAll(from, to);
+    });
+    await fs$1.writeFile(path, content);
+};
+const getThisScriptDirname = () => {
+    // Might be problem in ESM mode
+    return __dirname;
+};
+const capitalize = (str) => {
+    return str[0].toUpperCase() + str.substring(1);
+};
+
+// TODO needed?
+const removeGenericTypes = (code) => {
+    const regex = /export (interface|enum|type) [^<]* \{\n(.*\n)*?}/mg;
+    const matches = code.matchAll(regex);
+    const types = Array.from(matches).map(m => m[0]);
+    return types.join('\n');
+};
+const generateSchemas = (inputFile, outputFile, opts = {}) => {
+    const code = fs__default.readFileSync(inputFile).toString();
+    const { getZodSchemasFile } = generate({
+        sourceText: removeGenericTypes(code),
+        // inputOutputMappings: {
+        //
+        // },
+        customJSDocFormatTypes: {
+        // Custom mapping
+        // 'date-time': 'blablaj' - regex
+        }
+    });
+    const fileName = Path.basename(inputFile);
+    let f = getZodSchemasFile(`./${fileName.replace('.ts', '')}`);
+    // Add import from the api model - TODO find a way how to define on generate
+    f = f.replaceAll('"./index";', '"./client"');
+    // Backend sends nulls not undefined - should be properly set in the OpenAPI TS types generation!
+    f = f.replaceAll('.optional()', '.nullable()');
+    if (opts.localDateTimes) {
+        f = f.replaceAll('z.string().datetime()', 'z.string().datetime({local: true})');
+    }
+    fs__default.writeFileSync(outputFile, f);
+};
+
+const generateApiClient = async ({ dstDir, apiName, env, srcSpec, responseWrapper, ignoreOperationsWithTags, zodSchemas }, log = console.log) => {
+    if (!srcSpec)
+        throw new Error(`Url or path ('srcSpec' not specified`);
+    if (!apiName)
+        throw new Error('apiName not specified');
+    if (!dstDir)
+        throw new Error('dstDir not specified');
+    if (!env)
+        throw new Error('env not specified');
+    const dir = Path.resolve(dstDir, apiName);
+    if (!fs.existsSync(dir)) {
+        log(`Creating dir ${dir}`);
+        fs.mkdirSync(dir, {
+            recursive: true
+        });
+    }
+    const clientDir = Path.resolve(dir, 'client');
+    const specPath = await getSpecPath(srcSpec, dir, log);
+    const clientFile = await generateOpenApiModel({
+        name: apiName,
+        input: specPath,
+        outputDir: clientDir,
+        ignoreOperationsWithTags,
+        isNode: env === 'node',
+        responseWrapper
+    }, log);
+    if (zodSchemas?.enabled === false)
+        return;
+    log('Generating Zod schemas');
+    generateSchemas(Path.resolve(dir, clientFile), Path.resolve(dir, './zod.ts'), zodSchemas);
+};
+const getSpecPath = async (urlOrPath, dir, log) => {
+    if (!urlOrPath.startsWith('http')) {
+        if (!fs.existsSync(urlOrPath))
+            throw new Error(`Spec file ${urlOrPath} does not exists`);
+        return urlOrPath;
+    }
+    const specPath = Path.resolve(dir, `spec.json`);
+    log(`Will download the API spec from ${urlOrPath} to ${specPath}`);
+    await downloadSpec(specPath, urlOrPath);
+    return specPath;
+};
+
+export { generateApiClient as g };

package/dist/generateApiClient.d.ts

@@ -8,8 +8,9 @@ export type Params = {
         symbol: string;
         import?: string;
     };
+    ignoreOperationsWithTags?: string[];
     zodSchemas?: GenerateSchemasOptions & {
         enabled?: boolean;
     };
 };
-export declare const generateApiClient: ({ dstDir, apiName, env, srcSpec, responseWrapper, zodSchemas }: Params, log?: (msg: string) => void) => Promise<void>;
+export declare const generateApiClient: ({ dstDir, apiName, env, srcSpec, responseWrapper, ignoreOperationsWithTags, zodSchemas }: Params, log?: (msg: string) => void) => Promise<void>;

package/dist/generateOpenApiModel.d.ts

@@ -3,9 +3,10 @@ export type GenerateOpenApiModelCmd = {
     input: string;
     outputDir: string;
     isNode?: boolean;
+    ignoreOperationsWithTags?: string[];
     responseWrapper?: {
         symbol: string;
         import?: string;
     };
 };
-export declare const generateOpenApiModel: ({ input, isNode, responseWrapper, name, outputDir }: GenerateOpenApiModelCmd, log: (msg: string) => void) => Promise<string>;
+export declare const generateOpenApiModel: ({ input, isNode, responseWrapper, name, outputDir, ignoreOperationsWithTags }: GenerateOpenApiModelCmd, log: (msg: string) => void) => Promise<string>;

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-export { g as generateApiClient } from './generateApiClient-PeRLjZk9.js';
+export { g as generateApiClient } from './generateApiClient-QyDbHHKj.js';
 import 'path';
 import 'fs';
 import 'axios';

package/dist/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var generateApiClient = require('./generateApiClient-d_X--WFl.js');
+var generateApiClient = require('./generateApiClient-C11lxAxn.js');
 require('path');
 require('fs');
 require('axios');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ps-aux/api-client-gen",
-  "version": "0.1.0-rc1",
+  "version": "0.1.2-rc1",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -12,8 +12,7 @@
     "dev": "rollup -c --watch",
     "pub": "npm test && npm run build && npm publish",
     "test": "vitest",
-    "tc": "tsc",
-    "eh": "foo"
+    "tc": "tsc"
   },
   "author": "",
   "license": "ISC",

package/templates/http-client.eta

@@ -12,6 +12,7 @@ export type Request = {
     query?: any
     body?: any
     type?: string
+    secure?: boolean
 }
 
 export type HttpClient<RequestParams> = {