@ps-aux/api-client-gen 0.0.7-rc1 → 0.0.7-rc2

package/dist/bin.esm.js

@@ -1,5 +1,5 @@
 #!/bin/env node
-import { g as generateApiClient } from './generateApiClient-f8NyPBtp.js';
+import { g as generateApiClient } from './generateApiClient-DUCQclNI.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-CJ2UZFXk.js');
+var generateApiClient = require('./generateApiClient-BHDOH9mh.js');
 var cosmiconfig = require('cosmiconfig');
 require('path');
 require('fs');

package/dist/generateApiClient-BHDOH9mh.js

@@ -0,0 +1,188 @@
+'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 }, 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`);
+    await swaggerTypescriptApi.generateApi({
+        name: 'index',
+        output: outputDir,
+        input: input,
+        // modular: true,
+        httpClientType: 'axios',
+        templates: Path.resolve(getThisScriptDirname(), '../templates'),
+        defaultResponseAsSuccess: true,
+        // generateRouteTypes: true,
+        singleHttpClient: true,
+        // extractRequestBody: true,
+        cleanOutput: true,
+        moduleNameFirstTag: true,
+        apiClassName: capitalize(name) + 'Api',
+        // @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>', '']);
+    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, 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,
+        isNode: env === 'node',
+        responseWrapper,
+    }, log);
+    console.log('client file', clientFile);
+    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-DUCQclNI.js

@@ -0,0 +1,168 @@
+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 }, 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`);
+    await generateApi({
+        name: 'index',
+        output: outputDir,
+        input: input,
+        // modular: true,
+        httpClientType: 'axios',
+        templates: Path.resolve(getThisScriptDirname(), '../templates'),
+        defaultResponseAsSuccess: true,
+        // generateRouteTypes: true,
+        singleHttpClient: true,
+        // extractRequestBody: true,
+        cleanOutput: true,
+        moduleNameFirstTag: true,
+        apiClassName: capitalize(name) + 'Api',
+        // @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>', '']);
+    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, 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,
+        isNode: env === 'node',
+        responseWrapper,
+    }, log);
+    console.log('client file', clientFile);
+    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/index.esm.js

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

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ps-aux/api-client-gen",
-  "version": "0.0.7-rc1",
+  "version": "0.0.7-rc2",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -18,10 +18,10 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "axios": "^1.5.0",
-    "cosmiconfig": "^8.3.6",
-    "swagger-typescript-api": "^13.0.23",
-    "ts-to-zod": "^3.15.0"
+    "axios": "1.5.0",
+    "cosmiconfig": "8.3.6",
+    "swagger-typescript-api": "13.0.23",
+    "ts-to-zod": "3.15.0"
   },
   "devDependencies": {
     "vitest": "^3.1.1"