apigen-ts 1.0.1 → 1.2.0

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var main$1 = require('./main-Cic4LkJH.cjs');
+var main$1 = require('./main-C0qK6dZX.cjs');
 require('fs/promises');
 require('path');
 require('url');

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as apigen, g as getCliConfig } from './main-CRZklgfk.js';
+import { a as apigen, g as getCliConfig } from './main-l0LIDQ3K.js';
 import 'fs/promises';
 import 'path';
 import 'url';

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { a as apigen, g as getCliConfig } from './main-CRZklgfk.mjs';
+import { a as apigen, g as getCliConfig } from './main-l0LIDQ3K.mjs';
 import 'fs/promises';
 import 'path';
 import 'url';

package/dist/{main-Cic4LkJH.cjs → main-C0qK6dZX.cjs}

@@ -13,20 +13,30 @@ var path = require('node:path');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 var name = "apigen-ts";
-var version = "1.0.1";
+var version = "1.2.0";
 
 const initCtx = (config) => {
   return {
     source: "",
     output: "",
     name: "ApiClient",
-    parseDates: false,
     doc: { openapi: "3.1.0" },
+    parseDates: false,
+    inlineEnums: false,
+    headers: {},
     ...config,
     logTag: "",
     usedNames: /* @__PURE__ */ new Set()
   };
 };
+const parseHeaders = (items) => {
+  const headers = {};
+  for (const item of items) {
+    const [key, val] = item.split(":");
+    if (key && val) headers[key.trim()] = val.trim();
+  }
+  return headers;
+};
 const getCliConfig = () => {
   const argv = cleye.cli({
     name,
@@ -35,13 +45,24 @@ const getCliConfig = () => {
     flags: {
       name: {
         type: String,
-        description: "api class name to export",
+        description: "API class name to export",
         default: "ApiClient"
       },
       parseDates: {
         type: Boolean,
-        description: "parse dates as Date objects",
+        description: "Parse dates as Date objects",
+        default: false
+      },
+      inlineEnums: {
+        type: Boolean,
+        description: "Use inline enums instead of enum types",
         default: false
+      },
+      header: {
+        type: [String],
+        alias: "H",
+        description: 'HTTP header as key=value (e.g., -H "x-api-key: your-key"). Used only when generating code.',
+        default: []
       }
     }
   });
@@ -49,7 +70,9 @@ const getCliConfig = () => {
     source: argv._.source,
     output: argv._.output ?? null,
     name: argv.flags.name,
-    parseDates: argv.flags.parseDates
+    parseDates: argv.flags.parseDates,
+    inlineEnums: argv.flags.inlineEnums,
+    headers: parseHeaders(argv.flags.header)
   };
   return config;
 };
@@ -207,6 +230,12 @@ const makeObject = (ctx, s) => {
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.ObjectKeyword);
 };
+const makeLiteralUnion = (ctx, types) => {
+  const tokens = types.map((x) => makeType(ctx, { type: x }));
+  const hasUnknown = tokens.some((x) => x.kind === ts.SyntaxKind.UnknownKeyword);
+  if (hasUnknown) return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
+  return f$2.createUnionTypeNode(tokens);
+};
 const makeType = (ctx, s) => {
   const mk = makeType.bind(null, ctx);
   if (s === void 0) return f$2.createKeywordTypeNode(ts.SyntaxKind.VoidKeyword);
@@ -239,22 +268,14 @@ const makeType = (ctx, s) => {
     );
   }
   if ("type" in s) {
-    if (Array.isArray(s.type)) {
-      const types = [];
-      for (const type of s.type) {
-        if (type === "null") types.push({ type: "null" });
-        else types.push({ ...s, type });
-      }
-      return mk({ oneOf: types });
-    }
     let t;
     if (s.type === "object") t = makeObject(ctx, s);
     else if (s.type === "boolean") t = f$2.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword);
     else if (s.type === "number") t = f$2.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword);
     else if (s.type === "string") t = f$2.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
-    else if (s.type === "array") t = f$2.createArrayTypeNode(mk(s.items));
     else if (s.type === "null") t = f$2.createLiteralTypeNode(f$2.createNull());
-    else if (lodashEs.isArray(s.type)) t = f$2.createUnionTypeNode(s.type.map((x) => mk({ type: x })));
+    else if (lodashEs.isArray(s.type)) t = makeLiteralUnion(ctx, s.type);
+    else if (s.type === "array" && !lodashEs.isBoolean(s.items)) t = f$2.createArrayTypeNode(mk(s.items));
     else {
       console.warn(`makeType: unknown type "${s.type}"`);
       return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
@@ -263,7 +284,10 @@ const makeType = (ctx, s) => {
       if (s.format === "binary") t = f$2.createTypeReferenceNode("File");
       if (s.format === "date-time" && ctx.parseDates) t = f$2.createTypeReferenceNode("Date");
     }
-    return s.nullable ? f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]) : t;
+    if ("nullable" in s && s.nullable) {
+      return f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]);
+    }
+    return t;
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
 };
@@ -274,7 +298,7 @@ const isStringEnum = (s) => {
   return false;
 };
 const makeTypeAlias = (ctx, name, s) => {
-  if (isStringEnum(s)) {
+  if (isStringEnum(s) && !ctx.inlineEnums) {
     const tokens1 = lodashEs.uniq(s.enum);
     const tokens2 = arrayUtilsTs.filterEmpty(tokens1);
     if (tokens1.length !== tokens2.length) {
@@ -469,12 +493,23 @@ const generateAst = async (ctx) => {
   }
   return { modules, types };
 };
-const loadSchema = async (url, upgrade = true) => {
+const loadSchema = async ({
+  url,
+  upgrade = true,
+  headers = {}
+}) => {
   if (url.startsWith("file://")) url = url.substring(7);
   const { bundle } = await redocly.bundle({
     ref: url,
     config: await redocly.createConfig({}),
-    removeUnusedComponents: false
+    removeUnusedComponents: false,
+    externalRefResolver: new redocly.BaseResolver({
+      http: {
+        headers: Object.entries(headers).map(([name, value]) => {
+          return { name, value, matches: "**" };
+        })
+      }
+    })
   });
   if (bundle.parsed.swagger && upgrade) {
     const { openapi } = await swagger2openapi.convertObj(bundle.parsed, { patch: true });
@@ -512,10 +547,10 @@ const formatCode = async (code) => {
 };
 
 const apigen = async (config) => {
-  const doc = await loadSchema(config.source);
+  const doc = await loadSchema({ url: config.source, headers: config.headers });
   const ctx = initCtx({ ...config, doc });
   const { modules, types } = await generateAst(ctx);
-  const filepath = path$1.join(path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.src || new URL('main-Cic4LkJH.cjs', document.baseURI).href)))), "_template.ts");
+  const filepath = path$1.join(path$1.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('main-C0qK6dZX.cjs', document.baseURI).href)))), "_template.ts");
   const file = await fs.readFile(filepath, "utf-8");
   let code = [
     `// Auto-generated by https://github.com/vladkens/apigen-ts`,

package/dist/{main-CRZklgfk.js → main-l0LIDQ3K.js}

@@ -2,28 +2,38 @@ import fs from 'fs/promises';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { cli } from 'cleye';
-import redocly from '@redocly/openapi-core';
+import redocly, { BaseResolver } from '@redocly/openapi-core';
 import { filterEmpty, filterNullable } from 'array-utils-ts';
-import { get, uniq, upperFirst, isArray, isBoolean, isObject, sortBy, lowerFirst, uniqBy } from 'lodash-es';
+import { get, uniq, upperFirst, isArray, isBoolean, sortBy, isObject, lowerFirst, uniqBy } from 'lodash-es';
 import { convertObj } from 'swagger2openapi';
 import ts from 'typescript';
 import path from 'node:path';
 
 var name = "apigen-ts";
-var version = "1.0.1";
+var version = "1.2.0";
 
 const initCtx = (config) => {
   return {
     source: "",
     output: "",
     name: "ApiClient",
-    parseDates: false,
     doc: { openapi: "3.1.0" },
+    parseDates: false,
+    inlineEnums: false,
+    headers: {},
     ...config,
     logTag: "",
     usedNames: /* @__PURE__ */ new Set()
   };
 };
+const parseHeaders = (items) => {
+  const headers = {};
+  for (const item of items) {
+    const [key, val] = item.split(":");
+    if (key && val) headers[key.trim()] = val.trim();
+  }
+  return headers;
+};
 const getCliConfig = () => {
   const argv = cli({
     name,
@@ -32,13 +42,24 @@ const getCliConfig = () => {
     flags: {
       name: {
         type: String,
-        description: "api class name to export",
+        description: "API class name to export",
         default: "ApiClient"
       },
       parseDates: {
         type: Boolean,
-        description: "parse dates as Date objects",
+        description: "Parse dates as Date objects",
+        default: false
+      },
+      inlineEnums: {
+        type: Boolean,
+        description: "Use inline enums instead of enum types",
         default: false
+      },
+      header: {
+        type: [String],
+        alias: "H",
+        description: 'HTTP header as key=value (e.g., -H "x-api-key: your-key"). Used only when generating code.',
+        default: []
       }
     }
   });
@@ -46,7 +67,9 @@ const getCliConfig = () => {
     source: argv._.source,
     output: argv._.output ?? null,
     name: argv.flags.name,
-    parseDates: argv.flags.parseDates
+    parseDates: argv.flags.parseDates,
+    inlineEnums: argv.flags.inlineEnums,
+    headers: parseHeaders(argv.flags.header)
   };
   return config;
 };
@@ -204,6 +227,12 @@ const makeObject = (ctx, s) => {
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.ObjectKeyword);
 };
+const makeLiteralUnion = (ctx, types) => {
+  const tokens = types.map((x) => makeType(ctx, { type: x }));
+  const hasUnknown = tokens.some((x) => x.kind === ts.SyntaxKind.UnknownKeyword);
+  if (hasUnknown) return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
+  return f$2.createUnionTypeNode(tokens);
+};
 const makeType = (ctx, s) => {
   const mk = makeType.bind(null, ctx);
   if (s === void 0) return f$2.createKeywordTypeNode(ts.SyntaxKind.VoidKeyword);
@@ -236,22 +265,14 @@ const makeType = (ctx, s) => {
     );
   }
   if ("type" in s) {
-    if (Array.isArray(s.type)) {
-      const types = [];
-      for (const type of s.type) {
-        if (type === "null") types.push({ type: "null" });
-        else types.push({ ...s, type });
-      }
-      return mk({ oneOf: types });
-    }
     let t;
     if (s.type === "object") t = makeObject(ctx, s);
     else if (s.type === "boolean") t = f$2.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword);
     else if (s.type === "number") t = f$2.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword);
     else if (s.type === "string") t = f$2.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
-    else if (s.type === "array") t = f$2.createArrayTypeNode(mk(s.items));
     else if (s.type === "null") t = f$2.createLiteralTypeNode(f$2.createNull());
-    else if (isArray(s.type)) t = f$2.createUnionTypeNode(s.type.map((x) => mk({ type: x })));
+    else if (isArray(s.type)) t = makeLiteralUnion(ctx, s.type);
+    else if (s.type === "array" && !isBoolean(s.items)) t = f$2.createArrayTypeNode(mk(s.items));
     else {
       console.warn(`makeType: unknown type "${s.type}"`);
       return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
@@ -260,7 +281,10 @@ const makeType = (ctx, s) => {
       if (s.format === "binary") t = f$2.createTypeReferenceNode("File");
       if (s.format === "date-time" && ctx.parseDates) t = f$2.createTypeReferenceNode("Date");
     }
-    return s.nullable ? f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]) : t;
+    if ("nullable" in s && s.nullable) {
+      return f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]);
+    }
+    return t;
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
 };
@@ -271,7 +295,7 @@ const isStringEnum = (s) => {
   return false;
 };
 const makeTypeAlias = (ctx, name, s) => {
-  if (isStringEnum(s)) {
+  if (isStringEnum(s) && !ctx.inlineEnums) {
     const tokens1 = uniq(s.enum);
     const tokens2 = filterEmpty(tokens1);
     if (tokens1.length !== tokens2.length) {
@@ -466,12 +490,23 @@ const generateAst = async (ctx) => {
   }
   return { modules, types };
 };
-const loadSchema = async (url, upgrade = true) => {
+const loadSchema = async ({
+  url,
+  upgrade = true,
+  headers = {}
+}) => {
   if (url.startsWith("file://")) url = url.substring(7);
   const { bundle } = await redocly.bundle({
     ref: url,
     config: await redocly.createConfig({}),
-    removeUnusedComponents: false
+    removeUnusedComponents: false,
+    externalRefResolver: new BaseResolver({
+      http: {
+        headers: Object.entries(headers).map(([name, value]) => {
+          return { name, value, matches: "**" };
+        })
+      }
+    })
   });
   if (bundle.parsed.swagger && upgrade) {
     const { openapi } = await convertObj(bundle.parsed, { patch: true });
@@ -509,7 +544,7 @@ const formatCode = async (code) => {
 };
 
 const apigen = async (config) => {
-  const doc = await loadSchema(config.source);
+  const doc = await loadSchema({ url: config.source, headers: config.headers });
   const ctx = initCtx({ ...config, doc });
   const { modules, types } = await generateAst(ctx);
   const filepath = join(dirname(fileURLToPath(import.meta.url)), "_template.ts");

package/dist/{main-CRZklgfk.mjs → main-l0LIDQ3K.mjs}

@@ -2,28 +2,38 @@ import fs from 'fs/promises';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { cli } from 'cleye';
-import redocly from '@redocly/openapi-core';
+import redocly, { BaseResolver } from '@redocly/openapi-core';
 import { filterEmpty, filterNullable } from 'array-utils-ts';
-import { get, uniq, upperFirst, isArray, isBoolean, isObject, sortBy, lowerFirst, uniqBy } from 'lodash-es';
+import { get, uniq, upperFirst, isArray, isBoolean, sortBy, isObject, lowerFirst, uniqBy } from 'lodash-es';
 import { convertObj } from 'swagger2openapi';
 import ts from 'typescript';
 import path from 'node:path';
 
 var name = "apigen-ts";
-var version = "1.0.1";
+var version = "1.2.0";
 
 const initCtx = (config) => {
   return {
     source: "",
     output: "",
     name: "ApiClient",
-    parseDates: false,
     doc: { openapi: "3.1.0" },
+    parseDates: false,
+    inlineEnums: false,
+    headers: {},
     ...config,
     logTag: "",
     usedNames: /* @__PURE__ */ new Set()
   };
 };
+const parseHeaders = (items) => {
+  const headers = {};
+  for (const item of items) {
+    const [key, val] = item.split(":");
+    if (key && val) headers[key.trim()] = val.trim();
+  }
+  return headers;
+};
 const getCliConfig = () => {
   const argv = cli({
     name,
@@ -32,13 +42,24 @@ const getCliConfig = () => {
     flags: {
       name: {
         type: String,
-        description: "api class name to export",
+        description: "API class name to export",
         default: "ApiClient"
       },
       parseDates: {
         type: Boolean,
-        description: "parse dates as Date objects",
+        description: "Parse dates as Date objects",
+        default: false
+      },
+      inlineEnums: {
+        type: Boolean,
+        description: "Use inline enums instead of enum types",
         default: false
+      },
+      header: {
+        type: [String],
+        alias: "H",
+        description: 'HTTP header as key=value (e.g., -H "x-api-key: your-key"). Used only when generating code.',
+        default: []
       }
     }
   });
@@ -46,7 +67,9 @@ const getCliConfig = () => {
     source: argv._.source,
     output: argv._.output ?? null,
     name: argv.flags.name,
-    parseDates: argv.flags.parseDates
+    parseDates: argv.flags.parseDates,
+    inlineEnums: argv.flags.inlineEnums,
+    headers: parseHeaders(argv.flags.header)
   };
   return config;
 };
@@ -204,6 +227,12 @@ const makeObject = (ctx, s) => {
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.ObjectKeyword);
 };
+const makeLiteralUnion = (ctx, types) => {
+  const tokens = types.map((x) => makeType(ctx, { type: x }));
+  const hasUnknown = tokens.some((x) => x.kind === ts.SyntaxKind.UnknownKeyword);
+  if (hasUnknown) return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
+  return f$2.createUnionTypeNode(tokens);
+};
 const makeType = (ctx, s) => {
   const mk = makeType.bind(null, ctx);
   if (s === void 0) return f$2.createKeywordTypeNode(ts.SyntaxKind.VoidKeyword);
@@ -236,22 +265,14 @@ const makeType = (ctx, s) => {
     );
   }
   if ("type" in s) {
-    if (Array.isArray(s.type)) {
-      const types = [];
-      for (const type of s.type) {
-        if (type === "null") types.push({ type: "null" });
-        else types.push({ ...s, type });
-      }
-      return mk({ oneOf: types });
-    }
     let t;
     if (s.type === "object") t = makeObject(ctx, s);
     else if (s.type === "boolean") t = f$2.createKeywordTypeNode(ts.SyntaxKind.BooleanKeyword);
     else if (s.type === "number") t = f$2.createKeywordTypeNode(ts.SyntaxKind.NumberKeyword);
     else if (s.type === "string") t = f$2.createKeywordTypeNode(ts.SyntaxKind.StringKeyword);
-    else if (s.type === "array") t = f$2.createArrayTypeNode(mk(s.items));
     else if (s.type === "null") t = f$2.createLiteralTypeNode(f$2.createNull());
-    else if (isArray(s.type)) t = f$2.createUnionTypeNode(s.type.map((x) => mk({ type: x })));
+    else if (isArray(s.type)) t = makeLiteralUnion(ctx, s.type);
+    else if (s.type === "array" && !isBoolean(s.items)) t = f$2.createArrayTypeNode(mk(s.items));
     else {
       console.warn(`makeType: unknown type "${s.type}"`);
       return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
@@ -260,7 +281,10 @@ const makeType = (ctx, s) => {
       if (s.format === "binary") t = f$2.createTypeReferenceNode("File");
       if (s.format === "date-time" && ctx.parseDates) t = f$2.createTypeReferenceNode("Date");
     }
-    return s.nullable ? f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]) : t;
+    if ("nullable" in s && s.nullable) {
+      return f$2.createUnionTypeNode([t, f$2.createLiteralTypeNode(f$2.createNull())]);
+    }
+    return t;
   }
   return f$2.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword);
 };
@@ -271,7 +295,7 @@ const isStringEnum = (s) => {
   return false;
 };
 const makeTypeAlias = (ctx, name, s) => {
-  if (isStringEnum(s)) {
+  if (isStringEnum(s) && !ctx.inlineEnums) {
     const tokens1 = uniq(s.enum);
     const tokens2 = filterEmpty(tokens1);
     if (tokens1.length !== tokens2.length) {
@@ -466,12 +490,23 @@ const generateAst = async (ctx) => {
   }
   return { modules, types };
 };
-const loadSchema = async (url, upgrade = true) => {
+const loadSchema = async ({
+  url,
+  upgrade = true,
+  headers = {}
+}) => {
   if (url.startsWith("file://")) url = url.substring(7);
   const { bundle } = await redocly.bundle({
     ref: url,
     config: await redocly.createConfig({}),
-    removeUnusedComponents: false
+    removeUnusedComponents: false,
+    externalRefResolver: new BaseResolver({
+      http: {
+        headers: Object.entries(headers).map(([name, value]) => {
+          return { name, value, matches: "**" };
+        })
+      }
+    })
   });
   if (bundle.parsed.swagger && upgrade) {
     const { openapi } = await convertObj(bundle.parsed, { patch: true });
@@ -509,7 +544,7 @@ const formatCode = async (code) => {
 };
 
 const apigen = async (config) => {
-  const doc = await loadSchema(config.source);
+  const doc = await loadSchema({ url: config.source, headers: config.headers });
   const ctx = initCtx({ ...config, doc });
   const { modules, types } = await generateAst(ctx);
   const filepath = join(dirname(fileURLToPath(import.meta.url)), "_template.ts");

package/dist/main.cjs

@@ -3,7 +3,7 @@
 require('fs/promises');
 require('path');
 require('url');
-var main = require('./main-Cic4LkJH.cjs');
+var main = require('./main-C0qK6dZX.cjs');
 require('cleye');
 require('@redocly/openapi-core');
 require('array-utils-ts');

package/dist/main.d.cts

@@ -11,7 +11,9 @@ type Config = {
     output: string | null;
     name: string;
     parseDates: boolean;
+    inlineEnums: boolean;
     resolveName?: (ctx: Context, op: OpConfig, proposal: OpName) => OpName | undefined;
+    headers: Record<string, string>;
 };
 type Context = Config & {
     doc: Oas3Definition;

package/dist/main.d.mts

@@ -11,7 +11,9 @@ type Config = {
     output: string | null;
     name: string;
     parseDates: boolean;
+    inlineEnums: boolean;
     resolveName?: (ctx: Context, op: OpConfig, proposal: OpName) => OpName | undefined;
+    headers: Record<string, string>;
 };
 type Context = Config & {
     doc: Oas3Definition;

package/dist/main.js

@@ -1,7 +1,7 @@
 import 'fs/promises';
 import 'path';
 import 'url';
-export { a as apigen } from './main-CRZklgfk.js';
+export { a as apigen } from './main-l0LIDQ3K.js';
 import 'cleye';
 import '@redocly/openapi-core';
 import 'array-utils-ts';

package/dist/main.mjs

@@ -1,7 +1,7 @@
 import 'fs/promises';
 import 'path';
 import 'url';
-export { a as apigen } from './main-CRZklgfk.mjs';
+export { a as apigen } from './main-l0LIDQ3K.mjs';
 import 'cleye';
 import '@redocly/openapi-core';
 import 'array-utils-ts';

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "apigen-ts",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "license": "MIT",
   "author": "vladkens <v.pronsky@gmail.com>",
   "repository": "vladkens/apigen-ts",
@@ -22,23 +22,23 @@
     "ci": "tsc --noEmit && yarn test-cov && yarn build"
   },
   "dependencies": {
-    "@redocly/openapi-core": "1.25.5",
+    "@redocly/openapi-core": "1.34.1",
     "@types/lodash-es": "4.17.12",
     "@types/swagger2openapi": "7.0.4",
-    "array-utils-ts": "0.1.2",
-    "cleye": "1.3.2",
+    "array-utils-ts": "1.0.2",
+    "cleye": "1.3.4",
     "lodash-es": "4.17.21",
     "swagger2openapi": "7.0.8"
   },
   "devDependencies": {
-    "@types/node": "22.7.5",
-    "c8": "10.1.2",
-    "fetch-mock": "11.1.5",
-    "pkgroll": "2.5.0",
-    "prettier": "3.3.3",
+    "@types/node": "22.14.0",
+    "c8": "10.1.3",
+    "fetch-mock": "12.5.2",
+    "pkgroll": "2.12.1",
+    "prettier": "3.5.3",
     "prettier-plugin-organize-imports": "4.1.0",
     "tsm": "2.3.0",
-    "typescript": "5.6.3",
+    "typescript": "5.8.3",
     "uvu": "0.5.6"
   },
   "peerDependencies": {

package/readme.md

@@ -2,17 +2,16 @@
 
 <div align="center">
 
-[<img src="https://badgen.net/npm/v/apigen-ts" alt="version" />](https://npmjs.org/package/apigen-ts)
-[<img src="https://badgen.net/packagephobia/publish/apigen-ts" alt="size" />](https://packagephobia.now.sh/result?p=apigen-ts)
-[<img src="https://badgen.net/npm/dm/apigen-ts" alt="downloads" />](https://npmjs.org/package/apigen-ts)
-[<img src="https://badgen.net/github/license/vladkens/apigen-ts" alt="license" />](https://github.com/vladkens/apigen-ts/blob/main/LICENSE)
-[<img src="https://badgen.net/static/-/buy%20me%20a%20coffee/ff813f?icon=buymeacoffee&label" alt="donate" />](https://buymeacoffee.com/vladkens)
+[<img src="https://badges.ws/npm/v/apigen-ts" alt="version" />](https://npmjs.org/package/apigen-ts)
+[<img src="https://badges.ws/packagephobia/publish/apigen-ts" alt="size" />](https://packagephobia.now.sh/result?p=apigen-ts)
+[<img src="https://badges.ws/npm/dm/apigen-ts" alt="downloads" />](https://npmjs.org/package/apigen-ts)
+[<img src="https://badges.ws/github/license/vladkens/apigen-ts" alt="license" />](https://github.com/vladkens/apigen-ts/blob/main/LICENSE)
+[<img src="https://badges.ws/badge/-/buy%20me%20a%20coffee/ff813f?icon=buymeacoffee&label" alt="donate" />](https://buymeacoffee.com/vladkens)
 
 </div>
 
 <div align="center">
   <img src="./logo.svg" alt="apigen-ts logo" height="80" />
-  <div>Simple typed OpenAPI client generator</div>
 </div>
 
 ## Features
@@ -29,7 +28,11 @@
 ## Install
 
 ```sh
-yarn install -D apigen-ts
+npm install apigen-ts --save-dev
+```
+
+```sh
+yarn add -D apigen-ts
 ```
 
 ## Usage
@@ -37,11 +40,14 @@ yarn install -D apigen-ts
 ### 1. Generate
 
 ```sh
+# From file
+yarn apigen-ts ./openapi.json ./api-client.ts
+
 # From url
 yarn apigen-ts https://petstore3.swagger.io/api/v3/openapi.json ./api-client.ts
 
-# From file
-yarn apigen-ts ./openapi.json ./api-client.ts
+# From protected url
+yarn apigen-ts https://secret-api.example.com ./api-client.ts -H "x-api-key: secret-key"
 ```
 
 Run `yarn apigen-ts --help` for more options. Examples of generated clients [here](./examples/).
@@ -92,6 +98,26 @@ const pet = await api.pet.getPetById(1)
 const createdAt: Date = pet.createdAt // date parsed from string with format=date-time
 ```
 
+### String union as enums
+
+You can generate string literal union instead of native enums in case you want to run in Node.js environment with [type-stripping](https://nodejs.org/api/typescript.html#type-stripping). To achive this pass `--inline-enums` command line argument or use `inlineEnums: true` in Node.js API.
+
+```sh
+yarn apigen-ts ./openapi.json ./api-client.ts --inline-enums
+```
+
+This will generate:
+
+```ts
+type MyEnum = "OptionA" | "OptionB"
+
+// instead of
+enum MyEnum = {
+  OptionA = "OptionA",
+  OptionB = "OptionB"
+}
+```
+
 ### Errors handling
 
 An exception will be thrown for all unsuccessful return codes.
@@ -156,6 +182,8 @@ await apigen({
   // everything below is optional
   name: "MyApiClient", // default "ApiClient"
   parseDates: true, // default false
+  inlineEnums: false, // default false, use string literal union instead of enum
+  headers: { "x-api-key": "secret-key" }, // Custom HTTP headers to use when fetching schema
   resolveName(ctx, op, proposal) {
     // proposal is [string, string] which represents module.funcName
     if (proposal[0] === "users") return // will use default proposal