@mokup/runtime 0.1.0 → 1.0.0

package/dist/index.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
-const hono = require('hono');
-const patternRouter = require('hono/router/pattern-router');
+const hono = require('@mokup/shared/hono');
 
 const paramNamePattern = /^[\w-]+$/;
 const paramPattern = /^\[([^\]/]+)\]$/;
@@ -217,7 +216,7 @@ function normalizeRules(value) {
   if (typeof value === "function") {
     return [
       {
-        response: value
+        handler: value
       }
     ];
   }
@@ -226,7 +225,7 @@ function normalizeRules(value) {
   }
   return [
     {
-      response: value
+      handler: value
     }
   ];
 }
@@ -234,7 +233,7 @@ async function executeRule(rule, context) {
   if (!rule) {
     return void 0;
   }
-  const value = rule.response;
+  const value = rule.handler;
   if (typeof value === "function") {
     const handler = value;
     return handler(context);
@@ -265,7 +264,10 @@ async function loadModuleExport(modulePath, exportName, moduleBase, moduleMap) {
   const resolvedUrl = directMapValue ? void 0 : resolveModuleUrl(modulePath, moduleBase);
   const resolvedMapValue = resolvedUrl ? moduleMap?.[resolvedUrl] : void 0;
   const moduleValue = directMapValue ?? resolvedMapValue;
-  const module = moduleValue ?? await import(resolvedUrl ?? modulePath);
+  const module = moduleValue ?? await import(
+    /* @vite-ignore */
+    resolvedUrl ?? modulePath
+  );
   return module[exportName] ?? module.default ?? module;
 }
 function resolveModuleCacheKey(modulePath, exportName, moduleBase, moduleMap) {
@@ -405,7 +407,19 @@ function compileRoutes(manifest) {
 }
 function shouldTreatAsText(contentType) {
   const normalized = contentType.toLowerCase();
-  return normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript");
+  if (!normalized) {
+    return true;
+  }
+  if (normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript")) {
+    return true;
+  }
+  if (normalized.startsWith("image/") || normalized.startsWith("audio/") || normalized.startsWith("video/") || normalized.includes("octet-stream")) {
+    return false;
+  }
+  if (normalized.startsWith("application/") && (normalized.includes("pdf") || normalized.includes("zip") || normalized.includes("gzip"))) {
+    return false;
+  }
+  return true;
 }
 async function toRuntimeResult(response) {
   const headers = {};
@@ -434,6 +448,18 @@ async function toRuntimeResult(response) {
     body: buffer
   };
 }
+function isValidStatus(status) {
+  return typeof status === "number" && Number.isFinite(status) && status >= 200 && status <= 599;
+}
+function resolveStatus(routeStatus, responseStatus) {
+  if (isValidStatus(routeStatus)) {
+    return routeStatus;
+  }
+  if (isValidStatus(responseStatus)) {
+    return responseStatus;
+  }
+  return 200;
+}
 function applyRouteOverrides(response, route) {
   const headers = new Headers(response.headers);
   const hasHeaders = !!route.headers && Object.keys(route.headers).length > 0;
@@ -442,12 +468,24 @@ function applyRouteOverrides(response, route) {
       headers.set(key, value);
     }
   }
-  const status = route.status ?? response.status;
+  const status = resolveStatus(route.status, response.status);
   if (status === response.status && !hasHeaders) {
     return response;
   }
   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;
@@ -504,16 +542,18 @@ function createRouteHandler(params) {
 function createFinalizeMiddleware(route) {
   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;
+    return overridden;
   };
 }
 async function buildApp(params) {
   const { manifest, moduleCache, middlewareCache, moduleBase, moduleMap } = params;
-  const app = new hono.Hono({ router: new patternRouter.PatternRouter(), strict: false });
+  const app = new hono.Hono({ router: new hono.PatternRouter(), strict: false });
   const compiled = compileRoutes(manifest);
   for (const entry of compiled) {
     const middlewares = [];
@@ -544,6 +584,18 @@ async function buildApp(params) {
   }
   return app;
 }
+async function createRuntimeApp(options) {
+  const manifest = typeof options.manifest === "function" ? await options.manifest() : options.manifest;
+  const moduleCache = /* @__PURE__ */ new Map();
+  const middlewareCache = /* @__PURE__ */ new Map();
+  return await buildApp({
+    manifest,
+    moduleCache,
+    middlewareCache,
+    ...typeof options.moduleBase !== "undefined" ? { moduleBase: options.moduleBase } : {},
+    ...typeof options.moduleMap !== "undefined" ? { moduleMap: options.moduleMap } : {}
+  });
+}
 function appendQueryParams(url, query) {
   for (const [key, value] of Object.entries(query)) {
     if (Array.isArray(value)) {
@@ -579,7 +631,7 @@ function resolveRequestBody(req, contentType) {
   return String(body);
 }
 function toFetchRequest(req) {
-  const url = new URL(req.path, "http://mokup.local");
+  const url = new URL(normalizePathname(req.path), "http://mokup.local");
   appendQueryParams(url, req.query);
   const headers = new Headers();
   for (const [key, value] of Object.entries(req.headers)) {
@@ -594,9 +646,35 @@ function toFetchRequest(req) {
   }
   return new Request(url.toString(), init);
 }
+function isRelativeModulePath(modulePath) {
+  return !/^(?:data|http|https|file):/.test(modulePath);
+}
+function requiresModuleBase(modulePath, moduleMap) {
+  if (!isRelativeModulePath(modulePath)) {
+    return false;
+  }
+  if (moduleMap && Object.prototype.hasOwnProperty.call(moduleMap, modulePath)) {
+    return false;
+  }
+  return true;
+}
+function routeNeedsModuleBase(route, moduleMap) {
+  if (route.response.type === "module" && requiresModuleBase(route.response.module, moduleMap)) {
+    return true;
+  }
+  if (route.middleware) {
+    for (const middleware of route.middleware) {
+      if (requiresModuleBase(middleware.module, moduleMap)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
 function createRuntime(options) {
   let manifestCache = null;
   let appPromise = null;
+  let compiledCache = null;
   const moduleCache = /* @__PURE__ */ new Map();
   const middlewareCache = /* @__PURE__ */ new Map();
   const getManifest = async () => {
@@ -620,24 +698,47 @@ function createRuntime(options) {
     }
     return appPromise;
   };
+  const getCompiled = async () => {
+    if (!compiledCache) {
+      compiledCache = compileRoutes(await getManifest());
+    }
+    return compiledCache;
+  };
   const handle = async (req) => {
-    const app = await getApp();
     const method = normalizeMethod(req.method) ?? "GET";
     const matchMethod = method === "HEAD" ? "GET" : method;
-    const match = app.router.match(matchMethod, req.path);
-    if (!match || match[0].length === 0) {
+    const pathname = normalizePathname(req.path);
+    const compiled = await getCompiled();
+    let matchedRoute = null;
+    for (const entry of compiled) {
+      if (entry.method !== matchMethod) {
+        continue;
+      }
+      if (matchRouteTokens(entry.tokens, pathname)) {
+        matchedRoute = entry.route;
+        break;
+      }
+    }
+    if (!matchedRoute) {
       return null;
     }
+    if (typeof options.moduleBase === "undefined" && routeNeedsModuleBase(matchedRoute, options.moduleMap)) {
+      throw new Error("moduleBase is required for relative module paths.");
+    }
+    const app = await getApp();
     const response = await app.fetch(toFetchRequest(req));
-    return await toRuntimeResult(response);
+    const resolvedResponse = applyRouteOverrides(response, matchedRoute);
+    return await toRuntimeResult(resolvedResponse);
   };
   return {
     handle
   };
 }
 
+exports.handle = hono.handle;
 exports.compareRouteScore = compareRouteScore;
 exports.createRuntime = createRuntime;
+exports.createRuntimeApp = createRuntimeApp;
 exports.matchRouteTokens = matchRouteTokens;
 exports.normalizePathname = normalizePathname;
 exports.parseRouteTemplate = parseRouteTemplate;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { Context, MiddlewareHandler } from 'hono';
+import { Context, Hono } from '@mokup/shared/hono';
+export { Context, MiddlewareHandler, handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -77,9 +78,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-type MockContext = Context;
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
+
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -87,9 +88,10 @@ interface RuntimeOptions {
 }
 type ModuleMap = Record<string, Record<string, unknown>>;
 
+declare function createRuntimeApp(options: RuntimeOptions): Promise<Hono>;
 declare function createRuntime(options: RuntimeOptions): {
     handle: (req: RuntimeRequest) => Promise<RuntimeResult | null>;
 };
 
-export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, ModuleMap, ParsedRouteTemplate, RequestHandler, RouteResponse, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { Context, MiddlewareHandler } from 'hono';
+import { Context, Hono } from '@mokup/shared/hono';
+export { Context, MiddlewareHandler, handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -77,9 +78,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-type MockContext = Context;
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
+
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -87,9 +88,10 @@ interface RuntimeOptions {
 }
 type ModuleMap = Record<string, Record<string, unknown>>;
 
+declare function createRuntimeApp(options: RuntimeOptions): Promise<Hono>;
 declare function createRuntime(options: RuntimeOptions): {
     handle: (req: RuntimeRequest) => Promise<RuntimeResult | null>;
 };
 
-export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, ModuleMap, ParsedRouteTemplate, RequestHandler, RouteResponse, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Context, MiddlewareHandler } from 'hono';
+import { Context, Hono } from '@mokup/shared/hono';
+export { Context, MiddlewareHandler, handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -77,9 +78,9 @@ interface RuntimeResult {
     headers: Record<string, string>;
     body: string | Uint8Array | null;
 }
-type MockContext = Context;
-type MockMiddleware = MiddlewareHandler;
-type MockResponseHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RequestHandler = (context: Context) => Response | Promise<Response> | unknown;
+type RouteResponse = unknown | RequestHandler;
+
 interface RuntimeOptions {
     manifest: Manifest | (() => Promise<Manifest>);
     moduleBase?: string | URL;
@@ -87,9 +88,10 @@ interface RuntimeOptions {
 }
 type ModuleMap = Record<string, Record<string, unknown>>;
 
+declare function createRuntimeApp(options: RuntimeOptions): Promise<Hono>;
 declare function createRuntime(options: RuntimeOptions): {
     handle: (req: RuntimeRequest) => Promise<RuntimeResult | null>;
 };
 
-export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
-export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };
+export { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
+export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, ModuleMap, ParsedRouteTemplate, RequestHandler, RouteResponse, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { Hono } from 'hono';
-import { PatternRouter } from 'hono/router/pattern-router';
+import { Hono, PatternRouter } from '@mokup/shared/hono';
+export { handle } from '@mokup/shared/hono';
 
 const paramNamePattern = /^[\w-]+$/;
 const paramPattern = /^\[([^\]/]+)\]$/;
@@ -215,7 +215,7 @@ function normalizeRules(value) {
   if (typeof value === "function") {
     return [
       {
-        response: value
+        handler: value
       }
     ];
   }
@@ -224,7 +224,7 @@ function normalizeRules(value) {
   }
   return [
     {
-      response: value
+      handler: value
     }
   ];
 }
@@ -232,7 +232,7 @@ async function executeRule(rule, context) {
   if (!rule) {
     return void 0;
   }
-  const value = rule.response;
+  const value = rule.handler;
   if (typeof value === "function") {
     const handler = value;
     return handler(context);
@@ -263,7 +263,10 @@ async function loadModuleExport(modulePath, exportName, moduleBase, moduleMap) {
   const resolvedUrl = directMapValue ? void 0 : resolveModuleUrl(modulePath, moduleBase);
   const resolvedMapValue = resolvedUrl ? moduleMap?.[resolvedUrl] : void 0;
   const moduleValue = directMapValue ?? resolvedMapValue;
-  const module = moduleValue ?? await import(resolvedUrl ?? modulePath);
+  const module = moduleValue ?? await import(
+    /* @vite-ignore */
+    resolvedUrl ?? modulePath
+  );
   return module[exportName] ?? module.default ?? module;
 }
 function resolveModuleCacheKey(modulePath, exportName, moduleBase, moduleMap) {
@@ -403,7 +406,19 @@ function compileRoutes(manifest) {
 }
 function shouldTreatAsText(contentType) {
   const normalized = contentType.toLowerCase();
-  return normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript");
+  if (!normalized) {
+    return true;
+  }
+  if (normalized.startsWith("text/") || normalized.includes("json") || normalized.includes("xml") || normalized.includes("javascript")) {
+    return true;
+  }
+  if (normalized.startsWith("image/") || normalized.startsWith("audio/") || normalized.startsWith("video/") || normalized.includes("octet-stream")) {
+    return false;
+  }
+  if (normalized.startsWith("application/") && (normalized.includes("pdf") || normalized.includes("zip") || normalized.includes("gzip"))) {
+    return false;
+  }
+  return true;
 }
 async function toRuntimeResult(response) {
   const headers = {};
@@ -432,6 +447,18 @@ async function toRuntimeResult(response) {
     body: buffer
   };
 }
+function isValidStatus(status) {
+  return typeof status === "number" && Number.isFinite(status) && status >= 200 && status <= 599;
+}
+function resolveStatus(routeStatus, responseStatus) {
+  if (isValidStatus(routeStatus)) {
+    return routeStatus;
+  }
+  if (isValidStatus(responseStatus)) {
+    return responseStatus;
+  }
+  return 200;
+}
 function applyRouteOverrides(response, route) {
   const headers = new Headers(response.headers);
   const hasHeaders = !!route.headers && Object.keys(route.headers).length > 0;
@@ -440,12 +467,24 @@ function applyRouteOverrides(response, route) {
       headers.set(key, value);
     }
   }
-  const status = route.status ?? response.status;
+  const status = resolveStatus(route.status, response.status);
   if (status === response.status && !hasHeaders) {
     return response;
   }
   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;
@@ -502,11 +541,13 @@ function createRouteHandler(params) {
 function createFinalizeMiddleware(route) {
   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;
+    return overridden;
   };
 }
 async function buildApp(params) {
@@ -542,6 +583,18 @@ async function buildApp(params) {
   }
   return app;
 }
+async function createRuntimeApp(options) {
+  const manifest = typeof options.manifest === "function" ? await options.manifest() : options.manifest;
+  const moduleCache = /* @__PURE__ */ new Map();
+  const middlewareCache = /* @__PURE__ */ new Map();
+  return await buildApp({
+    manifest,
+    moduleCache,
+    middlewareCache,
+    ...typeof options.moduleBase !== "undefined" ? { moduleBase: options.moduleBase } : {},
+    ...typeof options.moduleMap !== "undefined" ? { moduleMap: options.moduleMap } : {}
+  });
+}
 function appendQueryParams(url, query) {
   for (const [key, value] of Object.entries(query)) {
     if (Array.isArray(value)) {
@@ -577,7 +630,7 @@ function resolveRequestBody(req, contentType) {
   return String(body);
 }
 function toFetchRequest(req) {
-  const url = new URL(req.path, "http://mokup.local");
+  const url = new URL(normalizePathname(req.path), "http://mokup.local");
   appendQueryParams(url, req.query);
   const headers = new Headers();
   for (const [key, value] of Object.entries(req.headers)) {
@@ -592,9 +645,35 @@ function toFetchRequest(req) {
   }
   return new Request(url.toString(), init);
 }
+function isRelativeModulePath(modulePath) {
+  return !/^(?:data|http|https|file):/.test(modulePath);
+}
+function requiresModuleBase(modulePath, moduleMap) {
+  if (!isRelativeModulePath(modulePath)) {
+    return false;
+  }
+  if (moduleMap && Object.prototype.hasOwnProperty.call(moduleMap, modulePath)) {
+    return false;
+  }
+  return true;
+}
+function routeNeedsModuleBase(route, moduleMap) {
+  if (route.response.type === "module" && requiresModuleBase(route.response.module, moduleMap)) {
+    return true;
+  }
+  if (route.middleware) {
+    for (const middleware of route.middleware) {
+      if (requiresModuleBase(middleware.module, moduleMap)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
 function createRuntime(options) {
   let manifestCache = null;
   let appPromise = null;
+  let compiledCache = null;
   const moduleCache = /* @__PURE__ */ new Map();
   const middlewareCache = /* @__PURE__ */ new Map();
   const getManifest = async () => {
@@ -618,20 +697,41 @@ function createRuntime(options) {
     }
     return appPromise;
   };
+  const getCompiled = async () => {
+    if (!compiledCache) {
+      compiledCache = compileRoutes(await getManifest());
+    }
+    return compiledCache;
+  };
   const handle = async (req) => {
-    const app = await getApp();
     const method = normalizeMethod(req.method) ?? "GET";
     const matchMethod = method === "HEAD" ? "GET" : method;
-    const match = app.router.match(matchMethod, req.path);
-    if (!match || match[0].length === 0) {
+    const pathname = normalizePathname(req.path);
+    const compiled = await getCompiled();
+    let matchedRoute = null;
+    for (const entry of compiled) {
+      if (entry.method !== matchMethod) {
+        continue;
+      }
+      if (matchRouteTokens(entry.tokens, pathname)) {
+        matchedRoute = entry.route;
+        break;
+      }
+    }
+    if (!matchedRoute) {
       return null;
     }
+    if (typeof options.moduleBase === "undefined" && routeNeedsModuleBase(matchedRoute, options.moduleMap)) {
+      throw new Error("moduleBase is required for relative module paths.");
+    }
+    const app = await getApp();
     const response = await app.fetch(toFetchRequest(req));
-    return await toRuntimeResult(response);
+    const resolvedResponse = applyRouteOverrides(response, matchedRoute);
+    return await toRuntimeResult(resolvedResponse);
   };
   return {
     handle
   };
 }
 
-export { compareRouteScore, createRuntime, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
+export { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/runtime",
   "type": "module",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Cross-runtime mock matching and response handling for mokup.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -27,7 +27,7 @@
     "dist"
   ],
   "dependencies": {
-    "hono": "^4.11.4"
+    "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3",