@mokup/server 1.0.1 → 1.0.3

package/dist/index.cjs

@@ -189,6 +189,18 @@ function applyRouteOverrides(response, route) {
   }
   return new Response(response.body, { status, headers });
 }
+function resolveResponse(value, fallback) {
+  if (value instanceof Response) {
+    return value;
+  }
+  if (value && typeof value === "object" && "res" in value) {
+    const resolved = value.res;
+    if (resolved instanceof Response) {
+      return resolved;
+    }
+  }
+  return fallback;
+}
 function normalizeHandlerValue(c, value) {
   if (value instanceof Response) {
     return value;
@@ -221,30 +233,41 @@ function createRouteHandler(route) {
     return normalizeHandlerValue(c, value);
   };
 }
-function createFinalizeMiddleware(route) {
+function createFinalizeMiddleware(route, onResponse) {
   return async (c, next) => {
     const response = await next();
-    const resolved = response ?? c.res;
+    const resolved = resolveResponse(response, c.res);
     if (route.delay && route.delay > 0) {
       await delay(route.delay);
     }
-    return applyRouteOverrides(resolved, route);
+    const overridden = applyRouteOverrides(resolved, route);
+    c.res = overridden;
+    if (onResponse) {
+      try {
+        const result = onResponse(route, overridden);
+        if (result instanceof Promise) {
+          result.catch(() => void 0);
+        }
+      } catch {
+      }
+    }
+    return overridden;
   };
 }
 function wrapMiddleware(handler) {
   return async (c, next) => {
     const response = await handler(c, next);
-    return response ?? c.res;
+    return resolveResponse(response, c.res);
   };
 }
-function createHonoApp(routes) {
+function createHonoApp(routes, options = {}) {
   const app = new hono.Hono({ router: new hono.PatternRouter(), strict: false });
   for (const route of routes) {
     const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
     app.on(
       route.method,
       toHonoPath(route),
-      createFinalizeMiddleware(route),
+      createFinalizeMiddleware(route, options.onResponse),
       ...middlewares,
       createRouteHandler(route)
     );
@@ -426,7 +449,16 @@ function registerPlaygroundRoutes(params) {
       return new Response("Playground is not available.", { status: 500 });
     }
   };
-  params.app.get(playgroundPath, (c) => c.redirect(`${playgroundPath}/`));
+  params.app.get(playgroundPath, (c) => {
+    try {
+      const pathname = new URL(c.req.raw.url, "http://localhost").pathname;
+      if (pathname.endsWith("/")) {
+        return serveIndex();
+      }
+    } catch {
+    }
+    return c.redirect(`${playgroundPath}/`);
+  });
   params.app.get(`${playgroundPath}/`, () => serveIndex());
   params.app.get(`${playgroundPath}/index.html`, () => serveIndex());
   params.app.get(`${playgroundPath}/routes`, (c) => {
@@ -972,8 +1004,11 @@ function buildApp(params) {
     config: params.playground,
     root: params.root
   });
+  if (params.wsHandler && params.playground.enabled) {
+    app.get(`${params.playground.path}/ws`, params.wsHandler);
+  }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes);
+    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
     app.route("/", mockApp);
   }
   return app;
@@ -1060,13 +1095,81 @@ async function createFetchServer(options = {}) {
   const logger = createLogger(logEnabled);
   const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
   const dirs = resolveAllDirs(optionList, root);
+  const routeCounts = {};
+  const wsClients = /* @__PURE__ */ new Set();
+  let totalCount = 0;
+  let wsHandler;
+  let injectWebSocket;
+  function getRouteKey(route) {
+    return `${route.method} ${route.template}`;
+  }
+  function buildSnapshot() {
+    return {
+      type: "snapshot",
+      total: totalCount,
+      perRoute: { ...routeCounts }
+    };
+  }
+  function broadcast(payload) {
+    if (wsClients.size === 0) {
+      return;
+    }
+    const message = JSON.stringify(payload);
+    for (const client of wsClients) {
+      try {
+        client.send(message);
+      } catch {
+        wsClients.delete(client);
+      }
+    }
+  }
+  function registerWsClient(client) {
+    wsClients.add(client);
+    try {
+      client.send(JSON.stringify(buildSnapshot()));
+    } catch {
+      wsClients.delete(client);
+    }
+  }
+  function handleRouteResponse(route) {
+    const routeKey = getRouteKey(route);
+    routeCounts[routeKey] = (routeCounts[routeKey] ?? 0) + 1;
+    totalCount += 1;
+    broadcast({ type: "increment", routeKey, total: totalCount });
+  }
+  async function setupPlaygroundWebSocket(app2) {
+    if (!playgroundConfig.enabled) {
+      return;
+    }
+    try {
+      const mod = await import('@hono/node-ws');
+      const { createNodeWebSocket } = mod;
+      const { upgradeWebSocket, injectWebSocket: inject } = createNodeWebSocket({ app: app2 });
+      wsHandler = upgradeWebSocket(() => ({
+        onOpen: (_event, ws) => {
+          registerWsClient(ws);
+        },
+        onClose: (_event, ws) => {
+          wsClients.delete(ws);
+        },
+        onMessage: () => {
+        }
+      }));
+      injectWebSocket = (server2) => {
+        inject(server2);
+      };
+    } catch {
+    }
+  }
   let routes = [];
   let app = buildApp({
     routes,
     dirs,
     playground: playgroundConfig,
     root,
-    logger
+    logger,
+    onResponse: handleRouteResponse,
+    wsHandler
   });
   const refreshRoutes = async () => {
     try {
@@ -1093,7 +1196,9 @@ async function createFetchServer(options = {}) {
         dirs,
         playground: playgroundConfig,
         root,
-        logger
+        logger,
+        onResponse: handleRouteResponse,
+        wsHandler
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1101,6 +1206,10 @@ async function createFetchServer(options = {}) {
     }
   };
   await refreshRoutes();
+  await setupPlaygroundWebSocket(app);
+  if (wsHandler && playgroundConfig.enabled) {
+    app.get(`${playgroundConfig.path}/ws`, wsHandler);
+  }
   const scheduleRefresh = createDebouncer(80, () => {
     void refreshRoutes();
   });
@@ -1114,7 +1223,8 @@ async function createFetchServer(options = {}) {
   const server = {
     fetch,
     refresh: refreshRoutes,
-    getRoutes: () => routes
+    getRoutes: () => routes,
+    injectWebSocket
   };
   if (watcher) {
     server.close = async () => {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MokupServerOptions, F as FetchHandler, a as MokupWorkerInput } from './shared/server.C0FGI34s.cjs';
-export { b as MokupWorkerBundle } from './shared/server.C0FGI34s.cjs';
+import { S as ServerOptions, F as FetchHandler, W as WorkerInput } from './shared/server.DNITwCtQ.cjs';
+export { a as WorkerBundle } from './shared/server.DNITwCtQ.cjs';
 import { RouteToken } from '@mokup/runtime';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
 import { Context, MiddlewareHandler } from '@mokup/shared/hono';
@@ -21,9 +21,9 @@ interface NodeResponseLike {
 }
 
 type NextFunction = (error?: unknown) => void;
-declare function createConnectMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
+declare function createConnectMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
 
-declare function createExpressMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
+declare function createExpressMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
 
 interface FastifyRequestLike extends NodeRequestLike {
     raw?: NodeRequestLike;
@@ -36,16 +36,15 @@ interface FastifyReplyLike {
 interface FastifyInstanceLike {
     addHook: (name: 'onRequest' | 'preHandler', handler: (request: FastifyRequestLike, reply: FastifyReplyLike) => Promise<void> | void) => void;
 }
-declare function createFastifyPlugin(options: MokupServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
+declare function createFastifyPlugin(options: ServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
 
-declare function createFetchHandler(options: MokupServerOptions): FetchHandler;
+declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
-type MockResponse = unknown | MockResponseHandler;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
 interface ResolvedMiddleware {
-    handle: MockMiddleware;
+    handle: MiddlewareHandler;
     source: string;
     index: number;
 }
@@ -55,7 +54,7 @@ interface ResolvedRoute {
     method: HttpMethod;
     tokens: RouteToken[];
     score: number[];
-    handler: MockResponse;
+    handler: RouteResponse;
     middlewares?: ResolvedMiddleware[];
     status?: number;
     headers?: Record<string, string>;
@@ -66,7 +65,7 @@ type RouteTable = ResolvedRoute[];
 
 type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
 
-interface MokupFetchServerOptions {
+interface FetchServerOptions {
     dir?: DirInput;
     prefix?: string;
     include?: RegExp | RegExp[];
@@ -81,15 +80,19 @@ interface MokupFetchServerOptions {
     port?: number;
     root?: string;
 }
-type MokupFetchServerOptionsInput = MokupFetchServerOptions | MokupFetchServerOptions[];
+type FetchServerOptionsInput = FetchServerOptions | FetchServerOptions[];
 
-interface MokupFetchServer {
+interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
-declare function createFetchServer(options?: MokupFetchServerOptionsInput): Promise<MokupFetchServer>;
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {
     req: {
@@ -104,7 +107,7 @@ interface HonoRouteLike {
     method: string;
     handler: HonoMiddleware;
 }
-declare function createHonoMiddleware(options: MokupServerOptions): HonoMiddleware & {
+declare function createHonoMiddleware(options: ServerOptions): HonoMiddleware & {
     routes: HonoRouteLike[];
 };
 
@@ -119,13 +122,13 @@ interface KoaContextLike {
     set: (header: Record<string, string>) => void;
 }
 type KoaNext = () => Promise<unknown>;
-declare function createKoaMiddleware(options: MokupServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: string): Promise<MokupWorker>;
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: string): Promise<FetchWorker>;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
-export { FetchHandler, MokupServerOptions, MokupWorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
-export type { MokupFetchServer, MokupFetchServerOptions, MokupFetchServerOptionsInput };
+export { FetchHandler, ServerOptions, WorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
+export type { FetchServer, FetchServerOptions, FetchServerOptionsInput };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { M as MokupServerOptions, F as FetchHandler, a as MokupWorkerInput } from './shared/server.C0FGI34s.mjs';
-export { b as MokupWorkerBundle } from './shared/server.C0FGI34s.mjs';
+import { S as ServerOptions, F as FetchHandler, W as WorkerInput } from './shared/server.DNITwCtQ.mjs';
+export { a as WorkerBundle } from './shared/server.DNITwCtQ.mjs';
 import { RouteToken } from '@mokup/runtime';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
 import { Context, MiddlewareHandler } from '@mokup/shared/hono';
@@ -21,9 +21,9 @@ interface NodeResponseLike {
 }
 
 type NextFunction = (error?: unknown) => void;
-declare function createConnectMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
+declare function createConnectMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
 
-declare function createExpressMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
+declare function createExpressMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
 
 interface FastifyRequestLike extends NodeRequestLike {
     raw?: NodeRequestLike;
@@ -36,16 +36,15 @@ interface FastifyReplyLike {
 interface FastifyInstanceLike {
     addHook: (name: 'onRequest' | 'preHandler', handler: (request: FastifyRequestLike, reply: FastifyReplyLike) => Promise<void> | void) => void;
 }
-declare function createFastifyPlugin(options: MokupServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
+declare function createFastifyPlugin(options: ServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
 
-declare function createFetchHandler(options: MokupServerOptions): FetchHandler;
+declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
-type MockResponse = unknown | MockResponseHandler;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
 interface ResolvedMiddleware {
-    handle: MockMiddleware;
+    handle: MiddlewareHandler;
     source: string;
     index: number;
 }
@@ -55,7 +54,7 @@ interface ResolvedRoute {
     method: HttpMethod;
     tokens: RouteToken[];
     score: number[];
-    handler: MockResponse;
+    handler: RouteResponse;
     middlewares?: ResolvedMiddleware[];
     status?: number;
     headers?: Record<string, string>;
@@ -66,7 +65,7 @@ type RouteTable = ResolvedRoute[];
 
 type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
 
-interface MokupFetchServerOptions {
+interface FetchServerOptions {
     dir?: DirInput;
     prefix?: string;
     include?: RegExp | RegExp[];
@@ -81,15 +80,19 @@ interface MokupFetchServerOptions {
     port?: number;
     root?: string;
 }
-type MokupFetchServerOptionsInput = MokupFetchServerOptions | MokupFetchServerOptions[];
+type FetchServerOptionsInput = FetchServerOptions | FetchServerOptions[];
 
-interface MokupFetchServer {
+interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
-declare function createFetchServer(options?: MokupFetchServerOptionsInput): Promise<MokupFetchServer>;
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {
     req: {
@@ -104,7 +107,7 @@ interface HonoRouteLike {
     method: string;
     handler: HonoMiddleware;
 }
-declare function createHonoMiddleware(options: MokupServerOptions): HonoMiddleware & {
+declare function createHonoMiddleware(options: ServerOptions): HonoMiddleware & {
     routes: HonoRouteLike[];
 };
 
@@ -119,13 +122,13 @@ interface KoaContextLike {
     set: (header: Record<string, string>) => void;
 }
 type KoaNext = () => Promise<unknown>;
-declare function createKoaMiddleware(options: MokupServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: string): Promise<MokupWorker>;
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: string): Promise<FetchWorker>;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
-export { FetchHandler, MokupServerOptions, MokupWorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
-export type { MokupFetchServer, MokupFetchServerOptions, MokupFetchServerOptionsInput };
+export { FetchHandler, ServerOptions, WorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
+export type { FetchServer, FetchServerOptions, FetchServerOptionsInput };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MokupServerOptions, F as FetchHandler, a as MokupWorkerInput } from './shared/server.C0FGI34s.js';
-export { b as MokupWorkerBundle } from './shared/server.C0FGI34s.js';
+import { S as ServerOptions, F as FetchHandler, W as WorkerInput } from './shared/server.DNITwCtQ.js';
+export { a as WorkerBundle } from './shared/server.DNITwCtQ.js';
 import { RouteToken } from '@mokup/runtime';
 export { Manifest, ManifestRoute, ModuleMap, RuntimeOptions } from '@mokup/runtime';
 import { Context, MiddlewareHandler } from '@mokup/shared/hono';
@@ -21,9 +21,9 @@ interface NodeResponseLike {
 }
 
 type NextFunction = (error?: unknown) => void;
-declare function createConnectMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
+declare function createConnectMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: NextFunction) => Promise<void>;
 
-declare function createExpressMiddleware(options: MokupServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
+declare function createExpressMiddleware(options: ServerOptions): (req: NodeRequestLike, res: NodeResponseLike, next: (error?: unknown) => void) => Promise<void>;
 
 interface FastifyRequestLike extends NodeRequestLike {
     raw?: NodeRequestLike;
@@ -36,16 +36,15 @@ interface FastifyReplyLike {
 interface FastifyInstanceLike {
     addHook: (name: 'onRequest' | 'preHandler', handler: (request: FastifyRequestLike, reply: FastifyReplyLike) => Promise<void> | void) => void;
 }
-declare function createFastifyPlugin(options: MokupServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
+declare function createFastifyPlugin(options: ServerOptions): (instance: FastifyInstanceLike) => Promise<void>;
 
-declare function createFetchHandler(options: MokupServerOptions): FetchHandler;
+declare function createFetchHandler(options: ServerOptions): FetchHandler;
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
-type MockResponse = unknown | MockResponseHandler;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
 interface ResolvedMiddleware {
-    handle: MockMiddleware;
+    handle: MiddlewareHandler;
     source: string;
     index: number;
 }
@@ -55,7 +54,7 @@ interface ResolvedRoute {
     method: HttpMethod;
     tokens: RouteToken[];
     score: number[];
-    handler: MockResponse;
+    handler: RouteResponse;
     middlewares?: ResolvedMiddleware[];
     status?: number;
     headers?: Record<string, string>;
@@ -66,7 +65,7 @@ type RouteTable = ResolvedRoute[];
 
 type DirInput = string | string[] | ((root: string) => string | string[]) | undefined;
 
-interface MokupFetchServerOptions {
+interface FetchServerOptions {
     dir?: DirInput;
     prefix?: string;
     include?: RegExp | RegExp[];
@@ -81,15 +80,19 @@ interface MokupFetchServerOptions {
     port?: number;
     root?: string;
 }
-type MokupFetchServerOptionsInput = MokupFetchServerOptions | MokupFetchServerOptions[];
+type FetchServerOptionsInput = FetchServerOptions | FetchServerOptions[];
 
-interface MokupFetchServer {
+interface FetchServer {
     fetch: (request: Request) => Promise<Response>;
     refresh: () => Promise<void>;
     getRoutes: () => RouteTable;
+    injectWebSocket?: (server: NodeWebSocketServer) => void;
     close?: () => Promise<void>;
 }
-declare function createFetchServer(options?: MokupFetchServerOptionsInput): Promise<MokupFetchServer>;
+interface NodeWebSocketServer {
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+declare function createFetchServer(options?: FetchServerOptionsInput): Promise<FetchServer>;
 
 interface HonoContextLike {
     req: {
@@ -104,7 +107,7 @@ interface HonoRouteLike {
     method: string;
     handler: HonoMiddleware;
 }
-declare function createHonoMiddleware(options: MokupServerOptions): HonoMiddleware & {
+declare function createHonoMiddleware(options: ServerOptions): HonoMiddleware & {
     routes: HonoRouteLike[];
 };
 
@@ -119,13 +122,13 @@ interface KoaContextLike {
     set: (header: Record<string, string>) => void;
 }
 type KoaNext = () => Promise<unknown>;
-declare function createKoaMiddleware(options: MokupServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
+declare function createKoaMiddleware(options: ServerOptions): (ctx: KoaContextLike, next: KoaNext) => Promise<void>;
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: string): Promise<MokupWorker>;
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: string): Promise<FetchWorker>;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
-export { FetchHandler, MokupServerOptions, MokupWorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
-export type { MokupFetchServer, MokupFetchServerOptions, MokupFetchServerOptionsInput };
+export { FetchHandler, ServerOptions, WorkerInput, createConnectMiddleware, createExpressMiddleware, createFastifyPlugin, createFetchHandler, createFetchServer, createHonoMiddleware, createKoaMiddleware, createMokupWorker };
+export type { FetchServer, FetchServerOptions, FetchServerOptionsInput };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { createRuntime, compareRouteScore, parseRouteTemplate } from '@mokup/runtime';
-import { t as toRuntimeOptions, a as toRuntimeRequestFromNode, b as applyRuntimeResultToNode, c as toBinaryBody, d as createFetchHandler } from './shared/server.HVB7OYyI.mjs';
+import { t as toRuntimeOptions, a as toRuntimeRequestFromNode, b as applyRuntimeResultToNode, d as toBinaryBody, c as createFetchHandler } from './shared/server.Dje1y79O.mjs';
 import { cwd } from 'node:process';
 import { Hono, PatternRouter } from '@mokup/shared/hono';
 import { resolve, isAbsolute, join, normalize, extname, dirname, relative, basename } from '@mokup/shared/pathe';
@@ -186,6 +186,18 @@ function applyRouteOverrides(response, route) {
   }
   return new Response(response.body, { status, headers });
 }
+function resolveResponse(value, fallback) {
+  if (value instanceof Response) {
+    return value;
+  }
+  if (value && typeof value === "object" && "res" in value) {
+    const resolved = value.res;
+    if (resolved instanceof Response) {
+      return resolved;
+    }
+  }
+  return fallback;
+}
 function normalizeHandlerValue(c, value) {
   if (value instanceof Response) {
     return value;
@@ -218,30 +230,41 @@ function createRouteHandler(route) {
     return normalizeHandlerValue(c, value);
   };
 }
-function createFinalizeMiddleware(route) {
+function createFinalizeMiddleware(route, onResponse) {
   return async (c, next) => {
     const response = await next();
-    const resolved = response ?? c.res;
+    const resolved = resolveResponse(response, c.res);
     if (route.delay && route.delay > 0) {
       await delay(route.delay);
     }
-    return applyRouteOverrides(resolved, route);
+    const overridden = applyRouteOverrides(resolved, route);
+    c.res = overridden;
+    if (onResponse) {
+      try {
+        const result = onResponse(route, overridden);
+        if (result instanceof Promise) {
+          result.catch(() => void 0);
+        }
+      } catch {
+      }
+    }
+    return overridden;
   };
 }
 function wrapMiddleware(handler) {
   return async (c, next) => {
     const response = await handler(c, next);
-    return response ?? c.res;
+    return resolveResponse(response, c.res);
   };
 }
-function createHonoApp(routes) {
+function createHonoApp(routes, options = {}) {
   const app = new Hono({ router: new PatternRouter(), strict: false });
   for (const route of routes) {
     const middlewares = route.middlewares?.map((entry) => wrapMiddleware(entry.handle)) ?? [];
     app.on(
       route.method,
       toHonoPath(route),
-      createFinalizeMiddleware(route),
+      createFinalizeMiddleware(route, options.onResponse),
       ...middlewares,
       createRouteHandler(route)
     );
@@ -423,7 +446,16 @@ function registerPlaygroundRoutes(params) {
       return new Response("Playground is not available.", { status: 500 });
     }
   };
-  params.app.get(playgroundPath, (c) => c.redirect(`${playgroundPath}/`));
+  params.app.get(playgroundPath, (c) => {
+    try {
+      const pathname = new URL(c.req.raw.url, "http://localhost").pathname;
+      if (pathname.endsWith("/")) {
+        return serveIndex();
+      }
+    } catch {
+    }
+    return c.redirect(`${playgroundPath}/`);
+  });
   params.app.get(`${playgroundPath}/`, () => serveIndex());
   params.app.get(`${playgroundPath}/index.html`, () => serveIndex());
   params.app.get(`${playgroundPath}/routes`, (c) => {
@@ -969,8 +1001,11 @@ function buildApp(params) {
     config: params.playground,
     root: params.root
   });
+  if (params.wsHandler && params.playground.enabled) {
+    app.get(`${params.playground.path}/ws`, params.wsHandler);
+  }
   if (params.routes.length > 0) {
-    const mockApp = createHonoApp(params.routes);
+    const mockApp = createHonoApp(params.routes, { onResponse: params.onResponse });
     app.route("/", mockApp);
   }
   return app;
@@ -1057,13 +1092,81 @@ async function createFetchServer(options = {}) {
   const logger = createLogger(logEnabled);
   const playgroundConfig = resolvePlaygroundOptions(resolvePlaygroundInput(optionList));
   const dirs = resolveAllDirs(optionList, root);
+  const routeCounts = {};
+  const wsClients = /* @__PURE__ */ new Set();
+  let totalCount = 0;
+  let wsHandler;
+  let injectWebSocket;
+  function getRouteKey(route) {
+    return `${route.method} ${route.template}`;
+  }
+  function buildSnapshot() {
+    return {
+      type: "snapshot",
+      total: totalCount,
+      perRoute: { ...routeCounts }
+    };
+  }
+  function broadcast(payload) {
+    if (wsClients.size === 0) {
+      return;
+    }
+    const message = JSON.stringify(payload);
+    for (const client of wsClients) {
+      try {
+        client.send(message);
+      } catch {
+        wsClients.delete(client);
+      }
+    }
+  }
+  function registerWsClient(client) {
+    wsClients.add(client);
+    try {
+      client.send(JSON.stringify(buildSnapshot()));
+    } catch {
+      wsClients.delete(client);
+    }
+  }
+  function handleRouteResponse(route) {
+    const routeKey = getRouteKey(route);
+    routeCounts[routeKey] = (routeCounts[routeKey] ?? 0) + 1;
+    totalCount += 1;
+    broadcast({ type: "increment", routeKey, total: totalCount });
+  }
+  async function setupPlaygroundWebSocket(app2) {
+    if (!playgroundConfig.enabled) {
+      return;
+    }
+    try {
+      const mod = await import('@hono/node-ws');
+      const { createNodeWebSocket } = mod;
+      const { upgradeWebSocket, injectWebSocket: inject } = createNodeWebSocket({ app: app2 });
+      wsHandler = upgradeWebSocket(() => ({
+        onOpen: (_event, ws) => {
+          registerWsClient(ws);
+        },
+        onClose: (_event, ws) => {
+          wsClients.delete(ws);
+        },
+        onMessage: () => {
+        }
+      }));
+      injectWebSocket = (server2) => {
+        inject(server2);
+      };
+    } catch {
+    }
+  }
   let routes = [];
   let app = buildApp({
     routes,
     dirs,
     playground: playgroundConfig,
     root,
-    logger
+    logger,
+    onResponse: handleRouteResponse,
+    wsHandler
   });
   const refreshRoutes = async () => {
     try {
@@ -1090,7 +1193,9 @@ async function createFetchServer(options = {}) {
         dirs,
         playground: playgroundConfig,
         root,
-        logger
+        logger,
+        onResponse: handleRouteResponse,
+        wsHandler
       });
       logger.info(`Loaded ${routes.length} mock routes.`);
     } catch (error) {
@@ -1098,6 +1203,10 @@ async function createFetchServer(options = {}) {
     }
   };
   await refreshRoutes();
+  await setupPlaygroundWebSocket(app);
+  if (wsHandler && playgroundConfig.enabled) {
+    app.get(`${playgroundConfig.path}/ws`, wsHandler);
+  }
   const scheduleRefresh = createDebouncer(80, () => {
     void refreshRoutes();
   });
@@ -1111,7 +1220,8 @@ async function createFetchServer(options = {}) {
   const server = {
     fetch,
     refresh: refreshRoutes,
-    getRoutes: () => routes
+    getRoutes: () => routes,
+    injectWebSocket
   };
   if (watcher) {
     server.close = async () => {

package/dist/node.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+const nodeServer = require('@hono/node-server');
+
+
+
+exports.serve = nodeServer.serve;

package/dist/node.d.cts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.d.mts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.d.ts

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/node.mjs

@@ -0,0 +1 @@
+export { serve } from '@hono/node-server';

package/dist/shared/{server.C0FGI34s.d.cts → server.DNITwCtQ.d.cts}

@@ -1,15 +1,15 @@
 import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
 
-interface MokupServerOptions extends RuntimeOptions {
+interface ServerOptions extends RuntimeOptions {
     onNotFound?: 'next' | 'response';
 }
 type FetchHandler = (request: Request) => Promise<Response | null>;
-interface MokupWorkerBundle {
+interface WorkerBundle {
     manifest: Manifest;
     moduleMap?: ModuleMap;
     moduleBase?: string | URL;
     onNotFound?: 'next' | 'response';
 }
-type MokupWorkerInput = string | Manifest | MokupWorkerBundle;
+type WorkerInput = string | Manifest | WorkerBundle;
 
-export type { FetchHandler as F, MokupServerOptions as M, MokupWorkerInput as a, MokupWorkerBundle as b };
+export type { FetchHandler as F, ServerOptions as S, WorkerInput as W, WorkerBundle as a };

package/dist/shared/{server.C0FGI34s.d.mts → server.DNITwCtQ.d.mts}

@@ -1,15 +1,15 @@
 import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
 
-interface MokupServerOptions extends RuntimeOptions {
+interface ServerOptions extends RuntimeOptions {
     onNotFound?: 'next' | 'response';
 }
 type FetchHandler = (request: Request) => Promise<Response | null>;
-interface MokupWorkerBundle {
+interface WorkerBundle {
     manifest: Manifest;
     moduleMap?: ModuleMap;
     moduleBase?: string | URL;
     onNotFound?: 'next' | 'response';
 }
-type MokupWorkerInput = string | Manifest | MokupWorkerBundle;
+type WorkerInput = string | Manifest | WorkerBundle;
 
-export type { FetchHandler as F, MokupServerOptions as M, MokupWorkerInput as a, MokupWorkerBundle as b };
+export type { FetchHandler as F, ServerOptions as S, WorkerInput as W, WorkerBundle as a };

package/dist/shared/{server.C0FGI34s.d.ts → server.DNITwCtQ.d.ts}

@@ -1,15 +1,15 @@
 import { RuntimeOptions, Manifest, ModuleMap } from '@mokup/runtime';
 
-interface MokupServerOptions extends RuntimeOptions {
+interface ServerOptions extends RuntimeOptions {
     onNotFound?: 'next' | 'response';
 }
 type FetchHandler = (request: Request) => Promise<Response | null>;
-interface MokupWorkerBundle {
+interface WorkerBundle {
     manifest: Manifest;
     moduleMap?: ModuleMap;
     moduleBase?: string | URL;
     onNotFound?: 'next' | 'response';
 }
-type MokupWorkerInput = string | Manifest | MokupWorkerBundle;
+type WorkerInput = string | Manifest | WorkerBundle;
 
-export type { FetchHandler as F, MokupServerOptions as M, MokupWorkerInput as a, MokupWorkerBundle as b };
+export type { FetchHandler as F, ServerOptions as S, WorkerInput as W, WorkerBundle as a };

package/dist/shared/{server.HVB7OYyI.mjs → server.Dje1y79O.mjs}

@@ -255,4 +255,4 @@ function createFetchHandler(options) {
   };
 }
 
-export { toRuntimeRequestFromNode as a, applyRuntimeResultToNode as b, toBinaryBody as c, createFetchHandler as d, toRuntimeOptions as t };
+export { toRuntimeRequestFromNode as a, applyRuntimeResultToNode as b, createFetchHandler as c, toBinaryBody as d, toRuntimeOptions as t };

package/dist/worker.d.cts

@@ -1,10 +1,10 @@
-import { a as MokupWorkerInput } from './shared/server.C0FGI34s.cjs';
+import { W as WorkerInput } from './shared/server.DNITwCtQ.cjs';
 import '@mokup/runtime';
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
 export { createMokupWorker };
-export type { MokupWorker };
+export type { FetchWorker };

package/dist/worker.d.mts

@@ -1,10 +1,10 @@
-import { a as MokupWorkerInput } from './shared/server.C0FGI34s.mjs';
+import { W as WorkerInput } from './shared/server.DNITwCtQ.mjs';
 import '@mokup/runtime';
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
 export { createMokupWorker };
-export type { MokupWorker };
+export type { FetchWorker };

package/dist/worker.d.ts

@@ -1,10 +1,10 @@
-import { a as MokupWorkerInput } from './shared/server.C0FGI34s.js';
+import { W as WorkerInput } from './shared/server.DNITwCtQ.js';
 import '@mokup/runtime';
 
-interface MokupWorker {
+interface FetchWorker {
     fetch: (request: Request) => Promise<Response>;
 }
-declare function createMokupWorker(input: Exclude<MokupWorkerInput, string>): MokupWorker;
+declare function createMokupWorker(input: Exclude<WorkerInput, string>): FetchWorker;
 
 export { createMokupWorker };
-export type { MokupWorker };
+export type { FetchWorker };

package/dist/worker.mjs

@@ -1,4 +1,4 @@
-import { d as createFetchHandler } from './shared/server.HVB7OYyI.mjs';
+import { c as createFetchHandler } from './shared/server.Dje1y79O.mjs';
 import '@mokup/runtime';
 
 function isManifest(value) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/server",
   "type": "module",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Server adapters for @mokup/runtime.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -16,6 +16,11 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.mjs",
+      "require": "./dist/node.cjs"
+    },
     "./worker": {
       "types": "./dist/worker.d.ts",
       "import": "./dist/worker.mjs",
@@ -32,12 +37,13 @@
     "dist"
   ],
   "dependencies": {
-    "@mokup/shared": "0.1.0",
-    "@mokup/runtime": "0.1.1",
-    "@mokup/playground": "0.0.5"
+    "@hono/node-server": "^1.19.9",
+    "@hono/node-ws": "^1.1.1",
+    "@mokup/runtime": "1.0.0",
+    "@mokup/playground": "0.0.7",
+    "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.19.9",
     "@types/node": "^25.0.9",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"