shokupan 0.6.0 → 0.7.0

package/dist/plugins/{validation.d.ts → middleware/validation.d.ts}

@@ -1,4 +1,4 @@
-import { Middleware } from '../types';
+import { Middleware } from '../../util/types';
 export interface ValidationConfig {
     body?: any;
     query?: any;
@@ -15,4 +15,9 @@ export declare const valibot: (schema: any, parser: Function) => {
     schema: any;
     parser: Function;
 };
+/**
+ * Validation middleware.
+ * @param config Validation configuration
+ * @returns Middleware function
+ */
 export declare function validate(config: ValidationConfig): Middleware;

package/dist/router.d.ts

@@ -1,10 +1,68 @@
 import { ShokupanContext } from './context';
 import { Shokupan } from './shokupan';
-import { $appRoot, $childControllers, $childRouters, $isApplication, $isMounted, $isRouter, $mountPath, $parent, $routes } from './symbol';
-import { GuardAPISpec, JSXRenderer, Method, MethodAPISpec, Middleware, OpenAPIOptions, ProcessResult, RequestOptions, RouteMetadata, ShokupanController, ShokupanHandler, ShokupanHooks, ShokupanRoute, ShokupanRouteConfig, StaticServeOptions } from './types';
-type HeadersInit = Headers | Record<string, string> | [string, string][];
+import { $appRoot, $childControllers, $childRouters, $isApplication, $isMounted, $isRouter, $mountPath, $parent, $routes } from './util/symbol';
+import { GuardAPISpec, HeadersInit, JSXRenderer, Method, MethodAPISpec, Middleware, OpenAPIOptions, ProcessResult, RequestOptions, RouteMetadata, RouteParams, ShokupanController, ShokupanHandler, ShokupanHooks, ShokupanRoute, ShokupanRouteConfig, StaticServeOptions } from './util/types';
 export declare const RouterRegistry: Map<string, ShokupanRouter<any>>;
 export declare const ShokupanApplicationTree: {};
+/**
+ * Shokupan Router
+ *
+ * A router for organizing and grouping routes with shared middleware and configuration.
+ *
+ * @template State - The shape of `ctx.state` for all routes in this router.
+ * Provides type safety for state management within the router's middleware and handlers.
+ *
+ * @example Basic Router
+ * ```typescript
+ * const router = new ShokupanRouter();
+ * router.get('/users', (ctx) => ctx.json({ users: [] }));
+ *
+ * app.mount('/api', router);
+ * // Routes: GET /api/users
+ * ```
+ *
+ * @example Typed State Router
+ * ```typescript
+ * interface AuthState {
+ *   userId: string;
+ *   isAuthenticated: boolean;
+ * }
+ *
+ * class AuthRouter extends ShokupanRouter<AuthState> {
+ *   constructor() {
+ *     super();
+ *
+ *     // Router middleware has typed state
+ *     this.use((ctx, next) => {
+ *       ctx.state.userId = 'user-123';
+ *       ctx.state.isAuthenticated = true;
+ *       return next();
+ *     });
+ *
+ *     this.get('/me', (ctx) => {
+ *       // State is fully typed
+ *       return ctx.json({ userId: ctx.state.userId });
+ *     });
+ *   }
+ * }
+ *
+ * app.mount('/auth', new AuthRouter());
+ * ```
+ *
+ * @example Router with Middleware
+ * ```typescript
+ * const apiRouter = new ShokupanRouter();
+ *
+ * // Router-level middleware
+ * apiRouter.use(async (ctx, next) => {
+ *   console.log(`API request: ${ctx.method} ${ctx.path}`);
+ *   return next();
+ * });
+ *
+ * apiRouter.get('/status', (ctx) => ctx.json({ status: 'ok' }));
+ * app.mount('/api', apiRouter);
+ * ```
+ */
 export declare class ShokupanRouter<T extends Record<string, any> = Record<string, any>> {
     readonly config?: ShokupanRouteConfig;
     private [$isApplication];
@@ -34,7 +92,7 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
         enableMiddlewareTracking?: boolean;
         middlewareTrackingMaxCapacity?: number;
         middlewareTrackingTTL?: number;
-        httpLogger?: (ctx: ShokupanContext<Record<string, any>>) => void;
+        httpLogger?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void;
         logger?: {
             verbose?: boolean;
             info?: (msg: string, props: Record<string, any>) => void;
@@ -47,29 +105,29 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
         requestTimeout?: number;
         writeTimeout?: number;
         renderer?: JSXRenderer;
-        serverFactory?: import('./types').ServerFactory;
+        serverFactory?: import('.').ServerFactory;
         hooks?: {
-            onError?: (ctx: ShokupanContext<Record<string, any>>, error: unknown) => void | Promise<void>;
-            onRequestStart?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onRequestEnd?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onResponseStart?: (ctx: ShokupanContext<Record<string, any>>, response: Response) => void | Promise<void>;
-            onResponseEnd?: (ctx: ShokupanContext<Record<string, any>>, response: Response) => void | Promise<void>;
-            beforeValidate?: (ctx: ShokupanContext<Record<string, any>>, data: any) => void | Promise<void>;
-            afterValidate?: (ctx: ShokupanContext<Record<string, any>>, data: any) => void | Promise<void>;
-            onReadTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onWriteTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onRequestTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
+            onError?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, error: unknown) => void | Promise<void>;
+            onRequestStart?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onRequestEnd?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onResponseStart?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, response: Response) => void | Promise<void>;
+            onResponseEnd?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, response: Response) => void | Promise<void>;
+            beforeValidate?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, data: any) => void | Promise<void>;
+            afterValidate?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, data: any) => void | Promise<void>;
+            onReadTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onWriteTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onRequestTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
         } | {
-            onError?: (ctx: ShokupanContext<Record<string, any>>, error: unknown) => void | Promise<void>;
-            onRequestStart?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onRequestEnd?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onResponseStart?: (ctx: ShokupanContext<Record<string, any>>, response: Response) => void | Promise<void>;
-            onResponseEnd?: (ctx: ShokupanContext<Record<string, any>>, response: Response) => void | Promise<void>;
-            beforeValidate?: (ctx: ShokupanContext<Record<string, any>>, data: any) => void | Promise<void>;
-            afterValidate?: (ctx: ShokupanContext<Record<string, any>>, data: any) => void | Promise<void>;
-            onReadTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onWriteTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
-            onRequestTimeout?: (ctx: ShokupanContext<Record<string, any>>) => void | Promise<void>;
+            onError?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, error: unknown) => void | Promise<void>;
+            onRequestStart?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onRequestEnd?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onResponseStart?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, response: Response) => void | Promise<void>;
+            onResponseEnd?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, response: Response) => void | Promise<void>;
+            beforeValidate?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, data: any) => void | Promise<void>;
+            afterValidate?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>, data: any) => void | Promise<void>;
+            onReadTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onWriteTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
+            onRequestTimeout?: (ctx: ShokupanContext<Record<string, any>, Record<string, string>>) => void | Promise<void>;
         }[];
         validateStatusCodes?: boolean;
     };
@@ -153,6 +211,8 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      */
     testRequest(options: RequestOptions): Promise<ProcessResult>;
     private wrapWithHooks;
+    private mountRouter;
+    private scanControllerRoutes;
     /**
      * Find a route matching the given method and path.
      * @param method HTTP method
@@ -196,7 +256,7 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    get(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    get<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a GET route to the router.
      *
@@ -204,14 +264,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    get(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    get<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a POST route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    post(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    post<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a POST route to the router.
      *
@@ -219,14 +279,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    post(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    post<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a PUT route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    put(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    put<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a PUT route to the router.
      *
@@ -234,14 +294,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    put(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    put<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a DELETE route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    delete(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    delete<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a DELETE route to the router.
      *
@@ -249,14 +309,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    delete(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    delete<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a PATCH route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    patch(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    patch<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a PATCH route to the router.
      *
@@ -264,14 +324,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    patch(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    patch<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a OPTIONS route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    options(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    options<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a OPTIONS route to the router.
      *
@@ -279,14 +339,14 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    options(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    options<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a HEAD route to the router.
      *
      * @param path - URL path
      * @param handlers - Route handler functions
      */
-    head(path: string, ...handlers: ShokupanHandler<T>[]): any;
+    head<Path extends string>(path: Path, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a HEAD route to the router.
      *
@@ -294,7 +354,7 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
      * @param spec - OpenAPI specification for the route
      * @param handlers - Route handler functions
      */
-    head(path: string, spec: MethodAPISpec, ...handlers: ShokupanHandler<T>[]): any;
+    head<Path extends string>(path: Path, spec: MethodAPISpec, ...handlers: ShokupanHandler<T, RouteParams<Path>>[]): any;
     /**
      * Adds a guard to the router that applies to all routes added **after** this point.
      * Guards must return true or call `ctx.next()` to allow the request to continue.
@@ -329,4 +389,3 @@ export declare class ShokupanRouter<T extends Record<string, any> = Record<strin
     private ensureHooksInitialized;
     runHooks(name: keyof ShokupanHooks, ...args: any[]): Promise<void>;
 }
-export {};

package/dist/shokupan.d.ts

@@ -1,8 +1,72 @@
-import { ShokupanRequest } from './request';
-import { ShokupanRouter } from './router';
-import { $dispatch } from './symbol';
-import { Middleware, ProcessResult, RequestOptions, ShokupanConfig } from './types';
+import { $dispatch } from './util/symbol';
+import { Middleware, ProcessResult, RequestOptions, ShokupanConfig, ShokupanPlugin } from './util/types';
 import { Server } from 'bun';
+import { ShokupanRouter } from './router';
+import { ShokupanRequest } from './util/request';
+/**
+ * Shokupan Application
+ *
+ * The main application class for creating a Shokupan web server.
+ *
+ * @template State - The shape of `ctx.state` for all routes in the application.
+ * Use this to provide type safety for state management across middleware and handlers.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const app = new Shokupan();
+ * app.get('/hello', (ctx) => ctx.json({ message: 'Hello' }));
+ * await app.listen(3000);
+ * ```
+ *
+ * @example Typed State
+ * ```typescript
+ * interface AppState {
+ *   userId: string;
+ *   tenant: string;
+ *   requestId: string;
+ * }
+ *
+ * const app = new Shokupan<AppState>();
+ *
+ * // Middleware has typed state access
+ * app.use((ctx, next) => {
+ *   ctx.state.userId = 'user-123';    // ✓ Type-safe
+ *   ctx.state.requestId = crypto.randomUUID();
+ *   return next();
+ * });
+ *
+ * // Handlers have typed state access
+ * app.get('/profile', (ctx) => {
+ *   const { userId, tenant } = ctx.state; // ✓ TypeScript knows these exist
+ *   return ctx.json({ userId, tenant });
+ * });
+ * ```
+ *
+ * @example Empty State (No State Management)
+ * ```typescript
+ * import { EmptyState } from 'shokupan';
+ *
+ * const app = new Shokupan<EmptyState>();
+ * // ctx.state will be an empty object with no properties
+ * ```
+ *
+ * @example Combining Path Params and State
+ * ```typescript
+ * interface RequestState {
+ *   userId: string;
+ *   permissions: string[];
+ * }
+ *
+ * const app = new Shokupan<RequestState>();
+ *
+ * app.get('/users/:userId/posts/:postId', (ctx) => {
+ *   // Both params and state are fully typed!
+ *   const { userId, postId } = ctx.params;  // ✓ Path params typed
+ *   const { permissions } = ctx.state;       // ✓ State typed
+ *   return ctx.json({ userId, postId, permissions });
+ * });
+ * ```
+ */
 export declare class Shokupan<T = any> extends ShokupanRouter<T> {
     readonly applicationConfig: ShokupanConfig;
     openApiSpec?: any;
@@ -21,6 +85,12 @@ export declare class Shokupan<T = any> extends ShokupanRouter<T> {
      * Adds middleware to the application.
      */
     use(middleware: Middleware): this;
+    /**
+     * Registers a plugin.
+     */
+    register(plugin: ShokupanPlugin, options?: {
+        path?: string;
+    }): this;
     private startupHooks;
     /**
      * Registers a callback to be executed before the server starts listening.

package/dist/util/async-hooks.d.ts

@@ -1,3 +1,9 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
-export declare const asyncContext: AsyncLocalStorage<Map<string, any>>;
-export declare function runInContext<T>(callback: () => T, initialStore?: Map<string, any>): T;
+import { Span } from '@opentelemetry/api';
+export declare class RequestContextStore {
+    request?: Request;
+    span?: Span;
+    [key: string]: any;
+}
+export declare const asyncContext: AsyncLocalStorage<RequestContextStore>;
+export declare function runInContext<T>(callback: () => T, initialStore?: RequestContextStore): T;

package/dist/{decorators.d.ts → util/decorators.d.ts}

@@ -1,4 +1,4 @@
-import { RateLimitOptions } from './plugins/rate-limit';
+import { RateLimitOptions } from '../plugins/middleware/rate-limit';
 import { GuardAPISpec, MethodAPISpec, Middleware } from './types';
 /**
  * Class Decorator: Defines the base path for a controller.

package/dist/util/http-status.d.ts

@@ -0,0 +1,2 @@
+export declare const VALID_HTTP_STATUSES: Set<number>;
+export declare const VALID_REDIRECT_STATUSES: Set<number>;

package/dist/util/instrumentation.d.ts

@@ -1,4 +1,4 @@
-import { Middleware, ShokupanHandler } from '../types';
+import { Middleware, ShokupanHandler } from './types';
 /**
  * Wraps a middleware function with an OpenTelemetry span.
  */

package/dist/{router → util}/trie.d.ts

@@ -1,4 +1,4 @@
-import { Method, ShokupanHandler } from '../types';
+import { Method, ShokupanHandler } from './types';
 export interface RouteMatch<T = any> {
     handler: ShokupanHandler<T>;
     params: Record<string, string>;

package/dist/{types.d.ts → util/types.d.ts}

@@ -1,11 +1,45 @@
 import { OpenAPI } from '@scalar/openapi-types';
 import { Server } from 'bun';
 import { Server as NodeServer } from 'node:http';
-import { ShokupanContext } from './context';
+import { ShokupanContext } from '../context';
 import { $isRouter } from './symbol';
+export type HeadersInit = Headers | Record<string, string> | [string, string][];
+export interface ShokupanPluginOptions {
+    path?: string;
+}
+export interface ShokupanPlugin {
+    onInit: (app: any, options?: ShokupanPluginOptions) => void | Promise<void>;
+}
 export type DeepPartial<T> = T extends Function ? T : T extends object ? {
     [P in keyof T]?: DeepPartial<T[P]>;
 } : T;
+/**
+ * Helper type for applications that don't use ctx.state.
+ * Prevents accidental property access on state.
+ *
+ * @example
+ * ```typescript
+ * const app = new Shokupan<EmptyState>();
+ * ```
+ */
+export type EmptyState = Record<string, never>;
+/**
+ * Default state type that allows any properties.
+ * This is the default if no state type is specified.
+ *
+ * @example
+ * ```typescript
+ * const app = new Shokupan<DefaultState>();
+ * // Equivalent to: new Shokupan();
+ * ```
+ */
+export type DefaultState = Record<string, any>;
+type ParsePathParams<Path extends string> = Path extends `${infer _Start}:${infer Param}/${infer Rest}` ? {
+    [K in Param | keyof ParsePathParams<`/${Rest}`>]: string;
+} : Path extends `${infer _Start}:${infer Param}` ? {
+    [K in Param]: string;
+} : {};
+export type RouteParams<Path extends string> = string extends Path ? Record<string, string> : ParsePathParams<Path> extends Record<string, never> ? Record<string, string> : ParsePathParams<Path>;
 export interface RouteMetadata {
     file: string;
     line: number;
@@ -49,7 +83,7 @@ export interface CookieOptions {
     sameSite?: boolean | 'lax' | 'strict' | 'none' | 'Lax' | 'Strict' | 'None';
     priority?: 'low' | 'medium' | 'high' | 'Low' | 'Medium' | 'High';
 }
-export type ShokupanHandler<T extends Record<string, any> = Record<string, any>> = (ctx: ShokupanContext<T>, next?: NextFn) => Promise<any> | any;
+export type ShokupanHandler<State extends Record<string, any> = Record<string, any>, Params extends Record<string, string> = Record<string, string>> = (ctx: ShokupanContext<State, Params>, next?: NextFn) => Promise<any> | any;
 export declare const HTTPMethods: string[];
 export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD" | "ALL";
 export declare enum RouteParamType {
@@ -350,6 +384,10 @@ export interface StaticServeOptions<T extends Record<string, any>> {
     root?: string;
     /**
      * Whether to list directory contents if no index file is found.
+     *
+     * Security Note: Directory listing is disabled by default to prevent information disclosure.
+     * Enable this only if you specifically need it and understand the security implications.
+     *
      * @default false
      */
     listDirectory?: boolean;
@@ -384,3 +422,4 @@ export interface StaticServeOptions<T extends Record<string, any>> {
      */
     openapi?: MethodAPISpec;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "shokupan",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "description": "Shokupan is a low-lift modern web framework for Bun.",
     "author": "Andrew G. Knackstedt",
     "publishConfig": {
@@ -22,12 +22,12 @@
     ],
     "type": "module",
     "scripts": {
-        "dev": "bun --watch --inspect src/example/main.ts",
+        "dev": "bun --watch --inspect examples/full/main.ts",
         "debug:otel": "sh scripts/debug-otel.sh",
         "docs": "cd docs && bun run dev",
         "build": "vite build",
-        "bench": "cd src/benchmarking && bun runner.ts",
-        "bench:advanced": "cd src/benchmarking && bun advanced-runner.ts",
+        "bench": "cd benchmarking && bun runner.ts",
+        "bench:advanced": "cd benchmarking && bun advanced-runner.ts",
         "retag": "git push origin :refs/tags/v$(node -p \"require('./package.json').version\") 2>/dev/null || true && git tag -d v$(node -p \"require('./package.json').version\") 2>/dev/null || true && git tag v$(node -p \"require('./package.json').version\") && git push origin v$(node -p \"require('./package.json').version\") --force"
     },
     "bin": {
@@ -152,4 +152,4 @@
         "vite-plugin-dts": "^4.5.4",
         "zod": "^4.2.1"
     }
-}
+}