@mokup/runtime 0.1.0 → 0.1.1

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 = /^\[([^\]/]+)\]$/;
@@ -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,7 +468,7 @@ 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;
   }
@@ -513,7 +539,7 @@ function createFinalizeMiddleware(route) {
 }
 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 +570,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 +617,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 +632,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 +684,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, MiddlewareHandler, Hono } from '@mokup/shared/hono';
+export { handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -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 { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
 export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { Context, MiddlewareHandler } from 'hono';
+import { Context, MiddlewareHandler, Hono } from '@mokup/shared/hono';
+export { handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -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 { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
 export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, RouteToken, RuntimeOptions, RuntimeRequest, RuntimeResult };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Context, MiddlewareHandler } from 'hono';
+import { Context, MiddlewareHandler, Hono } from '@mokup/shared/hono';
+export { handle } from '@mokup/shared/hono';
 
 type RouteToken = {
     type: 'static';
@@ -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 { compareRouteScore, createRuntime, createRuntimeApp, matchRouteTokens, normalizePathname, parseRouteTemplate, scoreRouteTokens };
 export type { HttpMethod, Manifest, ManifestModuleRef, ManifestResponse, ManifestRoute, MockContext, MockMiddleware, MockResponseHandler, ModuleMap, ParsedRouteTemplate, 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 = /^\[([^\]/]+)\]$/;
@@ -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,7 +467,7 @@ 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;
   }
@@ -542,6 +569,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 +616,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 +631,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 +683,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": "0.1.1",
   "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": "0.1.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3",