@kubb/agent 5.0.0-beta.5 → 5.0.0-beta.7

package/.output/server/node_modules/jiti/lib/types.d.ts

@@ -0,0 +1,420 @@
+/**
+ * Creates a new {@linkcode Jiti} instance with custom options.
+ *
+ * @param id - Instance id, usually the current filename.
+ * @param userOptions - Custom options to override the default options.
+ * @returns A {@linkcode Jiti} instance.
+ *
+ * @example
+ * <caption>ESM Usage</caption>
+ *
+ * ```ts
+ * import { createJiti } from "jiti";
+ *
+ * const jiti = createJiti(import.meta.url, { debug: true });
+ * ```
+ *
+ * @example
+ * <caption>CommonJS Usage **(deprecated)**</caption>
+ *
+ * ```ts
+ * const { createJiti } = require("jiti");
+ *
+ * const jiti = createJiti(__filename, { debug: true });
+ * ```
+ *
+ * @since 2.0.0
+ */
+export declare function createJiti(id: string, userOptions?: JitiOptions): Jiti;
+
+/**
+ * Jiti instance
+ *
+ * Calling `jiti()` is similar to CommonJS {@linkcode require()} but adds
+ * extra features such as TypeScript and ESM compatibility.
+ *
+ * **Note:** It is recommended to use
+ * {@linkcode Jiti.import | await jiti.import()} instead.
+ */
+export interface Jiti extends NodeRequire {
+  /**
+   * Resolved options
+   */
+  options: JitiOptions;
+
+  /**
+   * ESM import a module with additional TypeScript and ESM compatibility.
+   *
+   * If you need the default export of module, you can use
+   * `jiti.import(id, { default: true })` as shortcut to `mod?.default ?? mod`.
+   */
+  import<T = unknown>(
+    id: string,
+    opts?: JitiResolveOptions & { default?: true },
+  ): Promise<T>;
+
+  /**
+   * Resolve with ESM import conditions.
+   */
+  esmResolve(id: string, parentURL?: string): string;
+  esmResolve<T extends JitiResolveOptions = JitiResolveOptions>(
+    id: string,
+    opts?: T,
+  ): T["try"] extends true ? string | undefined : string;
+
+  /**
+   * Transform source code
+   */
+  transform: (opts: TransformOptions) => string;
+
+  /**
+   * Evaluate transformed code as a module
+   */
+  evalModule: (source: string, options?: EvalModuleOptions) => unknown;
+}
+
+/**
+ * Jiti instance options
+ */
+export interface JitiOptions {
+  /**
+   * Filesystem source cache
+   *
+   * An string can be passed to set the custom cache directory.
+   *
+   * By default (when set to `true`), jiti uses
+   * `node_modules/.cache/jiti` (if exists) or `{TMP_DIR}/jiti`.
+   *
+   * This option can also be disabled using
+   * `JITI_FS_CACHE=false` environment variable.
+   *
+   * **Note:** It is recommended to keep this option
+   * enabled for better performance.
+   *
+   * @default true
+   */
+  fsCache?: boolean | string;
+
+  /**
+   * Rebuild the filesystem source cache
+   *
+   * This option can also be enabled using
+   * `JITI_REBUILD_FS_CACHE=true` environment variable.
+   *
+   * @default false
+   */
+  rebuildFsCache?: boolean;
+
+  /**
+   * @deprecated Use the {@linkcode fsCache} option.
+   *
+   * @default true
+   */
+  cache?: boolean | string;
+
+  /**
+   * Runtime module cache
+   *
+   * Disabling allows editing code and importing same module multiple times.
+   *
+   * When enabled, jiti integrates with Node.js native CommonJS cache store.
+   *
+   * This option can also be disabled using
+   * `JITI_MODULE_CACHE=false` environment variable.
+   *
+   * @default true
+   */
+  moduleCache?: boolean;
+
+  /**
+   * @deprecated Use the {@linkcode moduleCache} option.
+   *
+   * @default true
+   */
+  requireCache?: boolean;
+
+  /**
+   * Custom transform function
+   */
+  transform?: (opts: TransformOptions) => TransformResult;
+
+  /**
+   * Enable verbose debugging.
+   *
+   * Can also be enabled using `JITI_DEBUG=1` environment variable.
+   *
+   * @default false
+   */
+  debug?: boolean;
+
+  /**
+   * Enable sourcemaps for transformed code.
+   *
+   * Can also be disabled using `JITI_SOURCE_MAPS=0` environment variable.
+   *
+   * @default false
+   */
+  sourceMaps?: boolean;
+
+  /**
+   * Jiti combines module exports with the `default` export using an
+   * internal Proxy to improve compatibility with mixed CJS/ESM usage.
+   * You can check the current implementation
+   * {@link https://github.com/unjs/jiti/blob/main/src/utils.ts#L105 here}.
+   *
+   * Can be disabled using `JITI_INTEROP_DEFAULT=0` environment variable.
+   *
+   * @default true
+   */
+  interopDefault?: boolean;
+
+  /**
+   * Jiti hard source cache version.
+   *
+   * @internal
+   */
+  cacheVersion?: string;
+
+  /**
+   * Supported extensions to resolve.
+   *
+   * @default [".js", ".mjs", ".cjs", ".ts", ".tsx", ".mts", ".cts", ".mtsx", ".ctsx", ".json"]
+   */
+  extensions?: string[];
+
+  /**
+   * Transform options
+   */
+  transformOptions?: Omit<TransformOptions, "source">;
+
+  /**
+   * Resolve aliases
+   *
+   * You can use `JITI_ALIAS` environment variable to set aliases as
+   * a JSON string.
+   *
+   * @default {}
+   */
+  alias?: Record<string, string>;
+
+  /**
+   * List of modules (within `node_modules`) to always use native
+   * require/import for them.
+   *
+   * You can use `JITI_NATIVE_MODULES` environment variable to set
+   * native modules as a JSON string.
+   *
+   * @default []
+   */
+  nativeModules?: string[];
+
+  /**
+   * List of modules (within `node_modules`) to transform them
+   * regardless of syntax.
+   *
+   * You can use `JITI_TRANSFORM_MODULES` environment variable to set
+   * transform modules as a JSON string.
+   *
+   * @default []
+   */
+  transformModules?: string[];
+
+  /**
+   * Parent module's {@linkcode ImportMeta | import.meta} context to use
+   * for ESM resolution.
+   *
+   * (Only used for `jiti/native` import)
+   */
+  importMeta?: ImportMeta;
+
+  /**
+   * Try to use native require and import without jiti transformations first.
+   *
+   * Enabled if Bun is detected.
+   *
+   * @default false
+   */
+  tryNative?: boolean;
+
+  /**
+   * Always use a temp file (instead of a `data:` URL) for the ESM
+   * evaluation fallback path.
+   *
+   * jiti automatically falls back to a temp file when the `data:` URL
+   * import fails with `ENAMETOOLONG` — which happens on filesystems with
+   * a strict `NAME_MAX` limit (e.g. ecryptfs-encrypted home directories
+   * on Linux, some macOS configurations) once the base64-encoded source
+   * exceeds the limit. Setting this to `true` forces the temp-file path
+   * up front, skipping the `data:` URL attempt.
+   *
+   * The temp file is written to `{TMP_DIR}/jiti-esm/` and cleaned up
+   * after import.
+   *
+   * Can also be enabled using the `JITI_ESM_EVAL_TEMP_FILE=true`
+   * environment variable.
+   *
+   * @default false
+   */
+  esmEvalTempFile?: boolean;
+
+  /**
+   * Enable JSX support Enable JSX support using
+   * {@link https://babeljs.io/docs/babel-plugin-transform-react-jsx | `@babel/plugin-transform-react-jsx`}.
+   *
+   * You can also use `JITI_JSX=1` environment variable to enable JSX support.
+   *
+   * @default false
+   */
+  jsx?: boolean | JSXOptions;
+
+  /**
+   * Virtual modules - pre-loaded module objects that bypass filesystem resolution.
+   * Useful for bundled modules in compiled binaries (e.g., Bun).
+   *
+   * When a module ID matches a key in this map, the corresponding value is
+   * returned directly without any filesystem resolution or transformation.
+   *
+   * @example
+   * ```ts
+   * import * as typebox from "@sinclair/typebox";
+   *
+   * const jiti = createJiti(import.meta.url, {
+   *   virtualModules: {
+   *     "@sinclair/typebox": typebox,
+   *   },
+   * });
+   * ```
+   */
+  virtualModules?: Record<string, unknown>;
+
+  /**
+   * Enable tsconfig paths resolution.
+   *
+   * - `true`: auto-discover `tsconfig.json` by walking up from the
+   *   jiti instance's parent path
+   * - `string`: explicit path to a `tsconfig.json` file
+   * - `false` (default): disabled
+   *
+   * When enabled, jiti uses
+   * {@link https://github.com/privatenumber/get-tsconfig | get-tsconfig}
+   * to resolve TypeScript path aliases defined in `compilerOptions.paths`.
+   *
+   * @default false
+   */
+  tsconfigPaths?: boolean | string;
+}
+
+interface NodeRequire {
+  /**
+   * Module cache
+   */
+  cache: ModuleCache;
+
+  /**
+   * @deprecated Prefer {@linkcode Jiti.import | await jiti.import()}
+   * for better compatibility.
+   */
+  (id: string): any;
+
+  /**
+   * @deprecated Prefer {@linkcode Jiti.esmResolve | jiti.esmResolve}
+   * for better compatibility.
+   */
+  resolve: {
+    /** @deprecated */
+    (id: string, options?: { paths?: string[] | undefined }): string;
+    /** @deprecated */
+    paths(request: string): string[] | null;
+  };
+
+  /** @deprecated CommonJS API */
+  extensions: Record<
+    ".js" | ".json" | ".node",
+    (m: NodeModule, filename: string) => any | undefined
+  >;
+
+  /** @deprecated CommonJS API */
+  main: NodeModule | undefined;
+}
+
+export interface NodeModule {
+  /**
+   * `true` if the module is running during the Node.js preload.
+   */
+  isPreloading: boolean;
+  exports: any;
+  require: NodeRequire;
+  id: string;
+  filename: string;
+  loaded: boolean;
+  /**
+   * @deprecated since Node.js **v14.6.0** Please use
+   * {@linkcode NodeRequire.main | require.main} and
+   * {@linkcode NodeModule.children | module.children} instead.
+   */
+  parent: NodeModule | null | undefined;
+  children: NodeModule[];
+  /**
+   * The directory name of the module.
+   * This is usually the same as the `path.dirname()` of the `module.id`.
+   *
+   * @since Node.js **v11.14.0**
+   */
+  path: string;
+  paths: string[];
+}
+
+export type ModuleCache = Record<string, NodeModule>;
+
+export type EvalModuleOptions = Partial<{
+  id: string;
+  filename: string;
+  ext: string;
+  cache: ModuleCache;
+  /**
+   * @default true
+   */
+  async: boolean;
+  forceTranspile: boolean;
+}>;
+
+export interface TransformOptions {
+  source: string;
+  filename?: string;
+  ts?: boolean;
+  retainLines?: boolean;
+  interopDefault?: boolean;
+  /**
+   * @default false
+   */
+  async?: boolean;
+  /**
+   * @default false
+   */
+  jsx?: boolean | JSXOptions;
+  babel?: Record<string, any>;
+}
+
+export interface TransformResult {
+  code: string;
+  error?: any;
+}
+
+export interface JitiResolveOptions {
+  conditions?: string[];
+  parentURL?: string | URL;
+  try?: boolean;
+}
+
+/**
+ * @see {@link https://babeljs.io/docs/babel-plugin-transform-react-jsx#options | Reference}
+ */
+export interface JSXOptions {
+  throwIfNamespace?: boolean;
+  runtime?: "classic" | "automatic";
+  importSource?: string;
+  pragma?: string;
+  pragmaFrag?: string;
+  useBuiltIns?: boolean;
+  useSpread?: boolean;
+}

package/.output/server/node_modules/jiti/package.json

@@ -143,4 +143,4 @@
     "zod": "^4.4.3"
   },
   "packageManager": "pnpm@10.30.3"
-}
+}

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/agent-prod",
-  "version": "5.0.0-beta.5",
+  "version": "5.0.0-beta.7",
   "type": "module",
   "private": true,
   "dependencies": {

package/README.md

@@ -1,33 +1,41 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo" width="200" />
-</p>
-
-# @kubb/agent
-
-Kubb Agent Server — HTTP server for code generation powered by [Nitro](https://nitro.build) with WebSocket integration for real-time Studio communication.
-
-## Features
-
-- 🚀 Fast HTTP server built with [Nitro](https://nitro.build)
-- 📡 RESTful API endpoints for code generation
-- 🔧 Easy integration with Kubb configuration
-- 📊 Health and info endpoints
-- 🔗 Bidirectional WebSocket with Kubb Studio
-- 🖥️ Machine binding — token locked to the registered machine via stable `machineToken`
-- 💾 Automatic session caching for faster reconnects
-- ⚡ Production-ready
+<div align="center">
+  <h1>@kubb/agent</h1>
+  <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
+    <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
+  </a>
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Coverage][coverage-src]][coverage-href]
+[![License][license-src]][license-href]
+[![Sponsors][sponsors-src]][sponsors-href]
+
+<h4>
+<a href="https://kubb.dev/" target="_blank">Documentation</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
+<span> · </span>
+<a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Request Feature</a>
+</h4>
+</div>
+
+HTTP agent server for Kubb, built on [Nitro](https://nitro.build). It exposes REST endpoints for triggering code generation, a health check, and a bidirectional WebSocket connection to Kubb Studio. Machine tokens are derived from the machine's network identity so they survive restarts. Sessions are cached locally to speed up reconnects.
 
 ## Installation
 
 The agent server is installed as part of `@kubb/cli`:
 
 ```bash
+bun add -D @kubb/cli
+# or
 pnpm add -D @kubb/cli
+# or
+npm install -D @kubb/cli
 ```
 
 ## Usage
 
-### Via CLI (Recommended)
+### Via CLI
 
 Start the agent server using the Kubb CLI:
 
@@ -112,7 +120,7 @@ The `agent_kv` named volume persists the KV store (session cache, machine token)
 | `KUBB_AGENT_ROOT`          | `/kubb/agent` (Docker) / `cwd` | Root directory for resolving relative paths.                                                                        |
 | `PORT`                     | `3000`                         | Server port.                                                                                                        |
 | `HOST`                     | `0.0.0.0`                      | Server host.                                                                                                        |
-| `KUBB_STUDIO_URL`          | `https://kubb.studio`      | Kubb Studio WebSocket URL.                                                                                          |
+| `KUBB_STUDIO_URL`          | `https://kubb.studio`          | Kubb Studio WebSocket URL.                                                                                          |
 | `KUBB_AGENT_TOKEN`         | _(empty)_                      | Authentication token for Studio. Required to connect.                                                               |
 | `KUBB_AGENT_ALLOW_WRITE`   | `false`                        | Set to `true` to allow writing generated files to disk.                                                             |
 | `KUBB_AGENT_ALLOW_ALL`     | `false`                        | Set to `true` to grant all permissions (implies `KUBB_AGENT_ALLOW_WRITE=true`).                                     |
@@ -159,13 +167,15 @@ On startup the agent performs these steps before opening a WebSocket:
 2. **Create session** — calls `POST /api/agent/session/create` (includes `machineToken` for verification) and receives a WebSocket URL.
 3. **Connect** — opens a WebSocket to the returned URL using the `Authorization` header for authentication.
 
-### Connection Features
+### Connection features
 
-- **Automatic reconnection**: Caches session tokens to speed up reconnects
-- **Real-time events**: Streams generation progress and events
-- **Command handling**: Receives `generate` and `connect` commands from Studio
-- **Graceful shutdown**: Notifies Studio when disconnecting
-- **Session management**: 24-hour session expiration with auto-refresh; Studio re-validates session validity on every incoming agent message and disconnects immediately if revoked or expired
+| Feature                | Description                                                                                                                                   |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| Automatic reconnection | Caches session tokens to speed up reconnects                                                                                                  |
+| Real-time events       | Streams generation progress and events                                                                                                        |
+| Command handling       | Receives `generate` and `connect` commands from Studio                                                                                        |
+| Graceful shutdown      | Notifies Studio when disconnecting                                                                                                            |
+| Session management     | 24-hour session expiration with auto-refresh; Studio re-validates every incoming message and disconnects if the session is revoked or expired |
 
 ### Session Caching
 
@@ -324,3 +334,28 @@ npx kubb agent start
 ```
 
 You'll receive a stream of events as the code generation progresses.
+
+## Supporting Kubb
+
+Kubb is an open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+
+- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
+
+<p align="center">
+  <a href="https://github.com/sponsors/stijnvanhulle">
+    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
+  </a>
+</p>
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@kubb/agent?flat&colorA=18181B&colorB=f58517
+[npm-version-href]: https://npmjs.com/package/@kubb/agent
+[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/agent?flat&colorA=18181B&colorB=f58517
+[npm-downloads-href]: https://npmjs.com/package/@kubb/agent
+[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
+[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
+[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
+[coverage-href]: https://www.npmjs.com/package/@kubb/agent
+[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
+[sponsors-href]: https://github.com/sponsors/stijnvanhulle/

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@kubb/agent",
-  "version": "5.0.0-beta.5",
-  "description": "Agent server for Kubb, enabling HTTP-based access to code generation capabilities.",
+  "version": "5.0.0-beta.7",
+  "description": "HTTP agent server for Kubb. Exposes code generation via REST API and WebSocket with real-time Kubb Studio integration, machine binding, and Docker support.",
   "keywords": [
     "agent",
-    "code-generation",
     "codegen",
+    "docker",
     "http",
     "kubb",
     "openapi",
     "server",
-    "swagger",
-    "typescript"
+    "typescript",
+    "websocket"
   ],
   "license": "AGPL-3.0-or-later",
   "author": "stijnvanhulle",
@@ -43,18 +43,18 @@
     "tinyexec": "^1.1.2",
     "unstorage": "^1.17.5",
     "ws": "^8.20.0",
-    "@kubb/ast": "5.0.0-beta.5",
-    "@kubb/core": "5.0.0-beta.5"
+    "@kubb/ast": "5.0.0-beta.7",
+    "@kubb/core": "5.0.0-beta.7"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "msw": "^2.14.3",
+    "msw": "^2.14.6",
     "nitropack": "^2.13.4",
-    "vite": "^8.0.10",
+    "vite": "^8.0.12",
     "@internals/utils": "0.0.0",
-    "@kubb/parser-ts": "5.0.0-beta.5",
-    "@kubb/adapter-oas": "5.0.0-beta.5",
-    "@kubb/renderer-jsx": "5.0.0-beta.5"
+    "@kubb/adapter-oas": "5.0.0-beta.7",
+    "@kubb/parser-ts": "5.0.0-beta.7",
+    "@kubb/renderer-jsx": "5.0.0-beta.7"
   },
   "engines": {
     "node": ">=22"