fix(cli): move cli script to typescript

.changeset/short-phones-count.md

···
+---
+'@hey-api/openapi-ts': patch
+---
+
+fix(cli): move cli script to typescript

.gitignore

···
 .turbo
 
 # test files
+.gen/
 test/generated
 
 # debug files

.vscode/launch.json

···
       "name": "openapi-ts",
       "skipFiles": ["<node_internals>/**"],
       "runtimeExecutable": "node",
-      "runtimeArgs": [],
-      "program": "${workspaceFolder}/packages/openapi-ts/bin/index.cjs",
-      "args": [
-        "-f",
-        "${workspaceFolder}/packages/openapi-ts-tests/main/test/openapi-ts.config.ts"
-      ]
+      "runtimeArgs": ["-r", "ts-node/register/transpile-only"],
+      "program": "${workspaceFolder}/packages/openapi-ts/src/cli.ts",
+      "args": ["-f", "${workspaceFolder}/dev/openapi-ts.config.ts"]
     }
   ]
 }

package.json

···
     "@config/vite-base": "workspace:*",
     "@eslint/js": "9.32.0",
     "@hey-api/custom-client": "workspace:*",
+    "@hey-api/openapi-ts": "workspace:*",
     "@types/node": "22.10.5",
     "@typescript-eslint/eslint-plugin": "8.29.1",
     "@vitest/coverage-v8": "3.1.1",
···
     "prettier": "3.4.2",
     "rollup": "4.31.0",
     "rollup-plugin-dts": "6.1.1",
+    "ts-node": "10.9.2",
     "tsdown": "0.15.8",
     "turbo": "2.5.8",
     "typescript": "5.9.3",

packages/openapi-ts-tests/main/.gitignore

···
 .env
 
 # test files
+.gen/
 test/generated
 generated/

packages/openapi-ts-tests/main/test/openapi-ts.config.ts dev/openapi-ts.config.ts

···
 // @ts-ignore
 import { defineConfig, utils } from '@hey-api/openapi-ts';
 
-import { getSpecsPath } from '../../utils';
 // @ts-ignore
-import { myClientPlugin } from './custom/client/plugin';
+import { myClientPlugin } from '../packages/openapi-ts-tests/main/test/custom/client/plugin';
+import { getSpecsPath } from '../packages/openapi-ts-tests/utils';
 
 // @ts-ignore
 // eslint-disable-next-line arrow-body-style
···
         //   importFileExtension: '.ts',
         //   // indexFile: false,
         //   // lint: 'eslint',
-        //   path: path.resolve(__dirname, 'generated', 'sample'),
+        //   path: path.resolve(__dirname, '.gen'),
         //   tsConfigPath: path.resolve(
         //     __dirname,
         //     'tsconfig',
         //     'tsconfig.nodenext.json',
         //   ),
         // },
-        path.resolve(__dirname, 'generated', 'sample'),
+        path.resolve(__dirname, '.gen'),
       ],
       parser: {
         filters: {
···
     //     // level: 'debug',
     //     path: './logs',
     //   },
-    //   output: path.resolve(__dirname, 'generated', 'sample'),
+    //   output: path.resolve(__dirname, '.gen'),
     // },
   ];
 });

packages/openapi-ts/bin/index.cjs

···
-#!/usr/bin/env node
-
-'use strict';
-
-const path = require('path');
-
-const { program } = require('commander');
-const pkg = require('../package.json');
-
-const params = program
-  .name(Object.keys(pkg.bin)[0])
-  .usage('[options]')
-  .version(pkg.version)
-  .option(
-    '-c, --client <value>',
-    'HTTP client to generate [@hey-api/client-axios, @hey-api/client-fetch, @hey-api/client-next, @hey-api/client-nuxt, legacy/angular, legacy/axios, legacy/fetch, legacy/node, legacy/xhr]',
-  )
-  .option('-d, --debug', 'Set log level to debug')
-  .option('--dry-run [value]', 'Skip writing files to disk?')
-  .option(
-    '-e, --experimental-parser [value]',
-    'Opt-in to the experimental parser?',
-  )
-  .option('-f, --file [value]', 'Path to the config file')
-  .option(
-    '-i, --input <value>',
-    'OpenAPI specification (path, url, or string content)',
-  )
-  .option('-l, --logs [value]', 'Logs folder')
-  .option('-o, --output <value>', 'Output folder')
-  .option('-p, --plugins [value...]', "List of plugins you'd like to use")
-  .option(
-    '--base [value]',
-    'DEPRECATED. Manually set base in OpenAPI config instead of inferring from server value',
-  )
-  .option('-s, --silent', 'Set log level to silent')
-  .option(
-    '--no-log-file',
-    'Disable writing a log file. Works like --silent but without suppressing console output',
-  )
-  .option(
-    '-w, --watch [value]',
-    'Regenerate the client when the input file changes?',
-  )
-  .option('--exportCore [value]', 'DEPRECATED. Write core files to disk')
-  .option('--name <value>', 'DEPRECATED. Custom client class name')
-  .option('--request <value>', 'DEPRECATED. Path to custom request file')
-  .option(
-    '--useOptions [value]',
-    'DEPRECATED. Use options instead of arguments?',
-  )
-  .parse(process.argv)
-  .opts();
-
-const stringToBoolean = (value) => {
-  if (value === 'true') {
-    return true;
-  }
-  if (value === 'false') {
-    return false;
-  }
-  return value;
-};
-
-const processParams = (obj, booleanKeys) => {
-  for (const key of booleanKeys) {
-    const value = obj[key];
-    if (typeof value === 'string') {
-      const parsedValue = stringToBoolean(value);
-      delete obj[key];
-      obj[key] = parsedValue;
-    }
-  }
-  if (obj.file) {
-    obj.configFile = obj.file;
-  }
-  return obj;
-};
-
-async function start() {
-  let userConfig;
-
-  try {
-    const { createClient } = require(
-      path.resolve(__dirname, '../dist/index.cjs'),
-    );
-
-    userConfig = processParams(params, [
-      'dryRun',
-      'logFile',
-      'experimentalParser',
-      'exportCore',
-      'useOptions',
-    ]);
-
-    if (params.plugins === true) {
-      userConfig.plugins = [];
-    } else if (params.plugins) {
-      userConfig.plugins = params.plugins;
-    } else if (userConfig.client) {
-      userConfig.plugins = ['@hey-api/typescript', '@hey-api/sdk'];
-    }
-
-    if (userConfig.client) {
-      userConfig.plugins.push(userConfig.client);
-      delete userConfig.client;
-    }
-
-    userConfig.logs = userConfig.logs
-      ? {
-          path: userConfig.logs,
-        }
-      : {};
-
-    if (userConfig.debug || stringToBoolean(process.env.DEBUG)) {
-      userConfig.logs.level = 'debug';
-    } else if (userConfig.silent) {
-      userConfig.logs.level = 'silent';
-    }
-
-    userConfig.logs.file = userConfig.logFile;
-    delete userConfig.logFile;
-
-    if (typeof params.watch === 'string') {
-      userConfig.watch = Number.parseInt(params.watch, 10);
-    }
-
-    if (!Object.keys(userConfig.logs).length) {
-      delete userConfig.logs;
-    }
-
-    const context = await createClient(userConfig);
-    if (
-      !context[0] ||
-      !context[0].config ||
-      !context[0].config.input ||
-      !context[0].config.input.some(
-        (input) => input.watch && input.watch.enabled,
-      )
-    ) {
-      process.exit(0);
-    }
-  } catch {
-    process.exit(1);
-  }
-}
-
-start();

packages/openapi-ts/package.json

···
     "./package.json": "./package.json"
   },
   "bin": {
-    "openapi-ts": "bin/index.cjs"
+    "openapi-ts": "./dist/cli.cjs"
   },
   "files": [
     "bin",

packages/openapi-ts/src/cli.ts

···
+#!/usr/bin/env node
+
+'use strict';
+
+import { program } from 'commander';
+
+import { createClient } from '~/index';
+
+import pkg from '../package.json' assert { type: 'json' };
+
+const params = program
+  .name(Object.keys(pkg.bin)[0]!)
+  .usage('[options]')
+  .version(pkg.version)
+  .option(
+    '-c, --client <value>',
+    'HTTP client to generate [@hey-api/client-axios, @hey-api/client-fetch, @hey-api/client-next, @hey-api/client-nuxt, legacy/angular, legacy/axios, legacy/fetch, legacy/node, legacy/xhr]',
+  )
+  .option('-d, --debug', 'Set log level to debug')
+  .option('--dry-run [value]', 'Skip writing files to disk?')
+  .option(
+    '-e, --experimental-parser [value]',
+    'Opt-in to the experimental parser?',
+  )
+  .option('-f, --file [value]', 'Path to the config file')
+  .option(
+    '-i, --input <value>',
+    'OpenAPI specification (path, url, or string content)',
+  )
+  .option('-l, --logs [value]', 'Logs folder')
+  .option('-o, --output <value>', 'Output folder')
+  .option('-p, --plugins [value...]', "List of plugins you'd like to use")
+  .option(
+    '--base [value]',
+    'DEPRECATED. Manually set base in OpenAPI config instead of inferring from server value',
+  )
+  .option('-s, --silent', 'Set log level to silent')
+  .option(
+    '--no-log-file',
+    'Disable writing a log file. Works like --silent but without suppressing console output',
+  )
+  .option(
+    '-w, --watch [value]',
+    'Regenerate the client when the input file changes?',
+  )
+  .option('--exportCore [value]', 'DEPRECATED. Write core files to disk')
+  .option('--name <value>', 'DEPRECATED. Custom client class name')
+  .option('--request <value>', 'DEPRECATED. Path to custom request file')
+  .option(
+    '--useOptions [value]',
+    'DEPRECATED. Use options instead of arguments?',
+  )
+  .parse(process.argv)
+  .opts();
+
+const stringToBoolean = (value: any) => {
+  if (value === 'true') {
+    return true;
+  }
+  if (value === 'false') {
+    return false;
+  }
+  return value;
+};
+
+const processParams = (obj: any, booleanKeys: any) => {
+  for (const key of booleanKeys) {
+    const value = obj[key];
+    if (typeof value === 'string') {
+      const parsedValue = stringToBoolean(value);
+      delete obj[key];
+      obj[key] = parsedValue;
+    }
+  }
+  if (obj.file) {
+    obj.configFile = obj.file;
+  }
+  return obj;
+};
+
+async function start() {
+  let userConfig;
+
+  try {
+    userConfig = processParams(params, [
+      'dryRun',
+      'logFile',
+      'experimentalParser',
+      'exportCore',
+      'useOptions',
+    ]);
+
+    if (params.plugins === true) {
+      userConfig.plugins = [];
+    } else if (params.plugins) {
+      userConfig.plugins = params.plugins;
+    } else if (userConfig.client) {
+      userConfig.plugins = ['@hey-api/typescript', '@hey-api/sdk'];
+    }
+
+    if (userConfig.client) {
+      userConfig.plugins.push(userConfig.client);
+      delete userConfig.client;
+    }
+
+    userConfig.logs = userConfig.logs
+      ? {
+          path: userConfig.logs,
+        }
+      : {};
+
+    if (userConfig.debug || stringToBoolean(process.env.DEBUG)) {
+      userConfig.logs.level = 'debug';
+    } else if (userConfig.silent) {
+      userConfig.logs.level = 'silent';
+    }
+
+    userConfig.logs.file = userConfig.logFile;
+    delete userConfig.logFile;
+
+    if (typeof params.watch === 'string') {
+      userConfig.watch = Number.parseInt(params.watch, 10);
+    }
+
+    if (!Object.keys(userConfig.logs).length) {
+      delete userConfig.logs;
+    }
+
+    const context = await createClient(userConfig);
+    if (
+      !context[0]?.config.input.some(
+        (input) => input.watch && input.watch.enabled,
+      )
+    ) {
+      process.exit(0);
+    }
+  } catch {
+    process.exit(1);
+  }
+}
+
+start();

packages/openapi-ts/src/ir/context.ts

···
 
 import type { IR } from './types';
 
-export class IRContext<Spec extends Record<string, any> = any> {
+export class Context<Spec extends Record<string, any> = any> {
   /**
    * Configuration for parsing and generating the output. This
    * is a mix of user-provided and default values.

packages/openapi-ts/src/ir/types.d.ts

···
   ServerObject,
 } from '~/openApi/3.1.x/types/spec';
 
-import type { IRContext } from './context';
+import type { Context as IRContext } from './context';
 import type { IRMediaType } from './mediaType';
 
 interface IRBodyObject {

packages/openapi-ts/src/openApi/index.ts

···
 import { satisfies } from '~/config/utils/package';
-import { IRContext } from '~/ir/context';
+import { Context } from '~/ir/context';
 import type { IR } from '~/ir/types';
 import { parseV2_0_X } from '~/openApi/2.0.x';
 import { parseV3_0_X } from '~/openApi/3.0.x';
···
   logger: Logger;
   spec: unknown;
 }): IR.Context | undefined => {
-  const context = new IRContext({
+  const context = new Context({
     config,
     dependencies,
     logger,

packages/openapi-ts/src/openApi/shared/utils/graph.ts

···
 
   eventBuildGraph.timeEnd();
 
-  // functions creating data for debug scripts located in `debug-helpers/`
+  // functions creating data for debug scripts located in `dev/`
   // const { maxChildren, maxDepth, totalNodes } = debugTools.graph.analyzeStructure(graph);
   // const nodesForViz = debugTools.graph.exportForVisualization(graph);
-  // fs.writeFileSync('debug-helpers/graph.json', JSON.stringify(nodesForViz, null, 2));
+  // fs.writeFileSync('dev/graph.json', JSON.stringify(nodesForViz, null, 2));
 
   return { graph };
 };

packages/openapi-ts/tsdown.config.ts

···
   },
   clean: true,
   dts: true,
-  entry: ['src/index.ts', 'src/internal.ts'],
+  entry: ['./src/{index,internal,cli}.ts'],
   format: ['cjs', 'esm'],
   minify: !options.watch,
   onSuccess: async () => {

pnpm-lock.yaml

···
       '@hey-api/custom-client':
         specifier: workspace:*
         version: link:packages/custom-client
+      '@hey-api/openapi-ts':
+        specifier: workspace:*
+        version: link:packages/openapi-ts
       '@types/node':
         specifier: 22.10.5
         version: 22.10.5
···
       rollup-plugin-dts:
         specifier: 6.1.1
         version: 6.1.1(rollup@4.31.0)(typescript@5.9.3)
+      ts-node:
+        specifier: 10.9.2
+        version: 10.9.2(@types/node@22.10.5)(typescript@5.9.3)
       tsdown:
         specifier: 0.15.8
         version: 0.15.8(@arethetypeswrong/core@0.18.2)(typescript@5.9.3)
···
     devDependencies:
       '@angular-devkit/build-angular':
         specifier: 19.2.0
-        version: 19.2.0(3d70bfaaf57777265a4e229c41aeb4c6)
+        version: 19.2.0(a969acb6c0970aa981df1cb7672d7c2e)
       '@angular/cli':
         specifier: 19.2.0
         version: 19.2.0(@types/node@22.10.5)(chokidar@4.0.3)
···
     devDependencies:
       '@angular-devkit/build-angular':
         specifier: 19.2.0
-        version: 19.2.0(a969acb6c0970aa981df1cb7672d7c2e)
+        version: 19.2.0(3d70bfaaf57777265a4e229c41aeb4c6)
       '@angular/cli':
         specifier: 19.2.0
         version: 19.2.0(@types/node@22.10.5)(chokidar@4.0.3)
···
       eslint: 9.17.0(jiti@2.6.1)
       eslint-import-resolver-node: 0.3.9
       eslint-import-resolver-typescript: 3.10.1(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1))
-      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1)(eslint@9.17.0(jiti@2.6.1))
+      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1))
       eslint-plugin-jsx-a11y: 6.10.2(eslint@9.17.0(jiti@2.6.1))
       eslint-plugin-react: 7.37.5(eslint@9.17.0(jiti@2.6.1))
       eslint-plugin-react-hooks: 5.2.0(eslint@9.17.0(jiti@2.6.1))
···
       tinyglobby: 0.2.14
       unrs-resolver: 1.11.1
     optionalDependencies:
-      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1)(eslint@9.17.0(jiti@2.6.1))
+      eslint-plugin-import: 2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1))
     transitivePeerDependencies:
       - supports-color
 
···
     transitivePeerDependencies:
       - supports-color
 
-  eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1)(eslint@9.17.0(jiti@2.6.1)):
+  eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint-import-resolver-typescript@3.10.1(eslint-plugin-import@2.32.0(@typescript-eslint/parser@8.29.1(eslint@9.17.0(jiti@2.6.1))(typescript@5.8.3))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1)))(eslint@9.17.0(jiti@2.6.1)):
     dependencies:
       '@rtsao/scc': 1.1.0
       array-includes: 3.1.9

pnpm-workspace.yaml

···
   - examples/**/*
   - packages/**/*
 
-onlyBuiltDependencies:
-  - esbuild
-  - lmdb
-  - msgpackr-extract
-  - sharp
-  - unrs-resolver
-
 patchedDependencies:
   vitepress: patches/vitepress.patch