@mokup/server 1.0.3 → 1.0.4

package/dist/index.cjs

@@ -141,6 +141,20 @@ function matchesFilter(file, include, exclude) {
   }
   return true;
 }
+function normalizeIgnorePrefix(value, fallback = ["."]) {
+  const list = typeof value === "undefined" ? fallback : Array.isArray(value) ? value : [value];
+  return list.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function hasIgnoredPrefix(file, rootDir, prefixes) {
+  if (prefixes.length === 0) {
+    return false;
+  }
+  const relativePath = toPosix(pathe.relative(rootDir, file));
+  const segments = relativePath.split("/");
+  return segments.some(
+    (segment) => prefixes.some((prefix) => segment.startsWith(prefix))
+  );
+}
 function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
@@ -372,6 +386,20 @@ function resolveGroupRoot(dirs, serverRoot) {
   }
   return common;
 }
+const disabledReasonSet = /* @__PURE__ */ new Set([
+  "disabled",
+  "disabled-dir",
+  "exclude",
+  "ignore-prefix",
+  "include",
+  "unknown"
+]);
+function normalizeDisabledReason(reason) {
+  if (reason && disabledReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -432,6 +460,17 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  return {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeDisabledReason(route.reason),
+    method: route.method,
+    url: route.url,
+    groupKey: matchedGroup?.key,
+    group: matchedGroup?.label
+  };
+}
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -469,7 +508,8 @@ function registerPlaygroundRoutes(params) {
       root: baseRoot,
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
-      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups))
+      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -736,6 +776,15 @@ async function resolveDirectoryConfig(params) {
     if (typeof config.enabled === "boolean") {
       merged.enabled = config.enabled;
     }
+    if (typeof config.ignorePrefix !== "undefined") {
+      merged.ignorePrefix = config.ignorePrefix;
+    }
+    if (typeof config.include !== "undefined") {
+      merged.include = config.include;
+    }
+    if (typeof config.exclude !== "undefined") {
+      merged.exclude = config.exclude;
+    }
     const normalized = normalizeMiddlewares(config.middleware, configPath, logger);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -867,19 +916,44 @@ async function loadRules(file, logger) {
   return [value];
 }
 
+const silentLogger = {
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+function resolveSkipRoute(params) {
+  const derived = params.derived ?? deriveRouteFromFile(params.file, params.rootDir, silentLogger);
+  if (!derived?.method) {
+    return null;
+  }
+  const resolved = resolveRule({
+    rule: { handler: null },
+    derivedTemplate: derived.template,
+    derivedMethod: derived.method,
+    prefix: params.prefix,
+    file: params.file,
+    logger: silentLogger
+  });
+  if (!resolved) {
+    return null;
+  }
+  return {
+    method: resolved.method,
+    url: resolved.template
+  };
+}
 async function scanRoutes(params) {
   const routes = [];
   const seen = /* @__PURE__ */ new Set();
   const files = await collectFiles(params.dirs);
+  const globalIgnorePrefix = normalizeIgnorePrefix(params.ignorePrefix);
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
+  const shouldCollectSkip = typeof params.onSkip === "function";
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, params.include, params.exclude)) {
-      continue;
-    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -888,6 +962,58 @@ async function scanRoutes(params) {
       fileCache
     });
     if (config.enabled === false) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason: "disabled-dir",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      continue;
+    }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason: "ignore-prefix",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : params.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      if (shouldCollectSkip) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason,
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -899,6 +1025,23 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        if (shouldCollectSkip) {
+          const resolved2 = resolveSkipRoute({
+            file: fileInfo.file,
+            rootDir: fileInfo.rootDir,
+            prefix: params.prefix,
+            derived
+          });
+          params.onSkip?.({
+            file: fileInfo.file,
+            reason: "disabled",
+            method: resolved2?.method,
+            url: resolved2?.url
+          });
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -999,6 +1142,7 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1162,8 +1306,10 @@ async function createFetchServer(options = {}) {
     }
   }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
@@ -1174,11 +1320,13 @@ async function createFetchServer(options = {}) {
   const refreshRoutes = async () => {
     try {
       const collected = [];
+      const collectedDisabled = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
-          logger
+          logger,
+          onSkip: (info) => collectedDisabled.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1186,13 +1334,18 @@ async function createFetchServer(options = {}) {
         if (entry.exclude) {
           scanParams.exclude = entry.exclude;
         }
+        if (typeof entry.ignorePrefix !== "undefined") {
+          scanParams.ignorePrefix = entry.ignorePrefix;
+        }
         const scanned = await scanRoutes(scanParams);
         collected.push(...scanned);
       }
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
+      disabledRoutes = collectedDisabled;
       app = buildApp({
         routes,
+        disabledRoutes,
         dirs,
         playground: playgroundConfig,
         root,

package/dist/index.d.cts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.d.mts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.d.ts

@@ -70,6 +70,7 @@ interface FetchServerOptions {
     prefix?: string;
     include?: RegExp | RegExp[];
     exclude?: RegExp | RegExp[];
+    ignorePrefix?: string | string[];
     watch?: boolean;
     log?: boolean;
     playground?: boolean | {

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { createRuntime, compareRouteScore, parseRouteTemplate } from '@mokup/run
 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';
+import { resolve, isAbsolute, relative, join, normalize, extname, dirname, basename } from '@mokup/shared/pathe';
 import { promises } from 'node:fs';
 import { createRequire } from 'node:module';
 import { Buffer } from 'node:buffer';
@@ -138,6 +138,20 @@ function matchesFilter(file, include, exclude) {
   }
   return true;
 }
+function normalizeIgnorePrefix(value, fallback = ["."]) {
+  const list = typeof value === "undefined" ? fallback : Array.isArray(value) ? value : [value];
+  return list.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function hasIgnoredPrefix(file, rootDir, prefixes) {
+  if (prefixes.length === 0) {
+    return false;
+  }
+  const relativePath = toPosix(relative(rootDir, file));
+  const segments = relativePath.split("/");
+  return segments.some(
+    (segment) => prefixes.some((prefix) => segment.startsWith(prefix))
+  );
+}
 function delay(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
@@ -369,6 +383,20 @@ function resolveGroupRoot(dirs, serverRoot) {
   }
   return common;
 }
+const disabledReasonSet = /* @__PURE__ */ new Set([
+  "disabled",
+  "disabled-dir",
+  "exclude",
+  "ignore-prefix",
+  "include",
+  "unknown"
+]);
+function normalizeDisabledReason(reason) {
+  if (reason && disabledReasonSet.has(reason)) {
+    return reason;
+  }
+  return "unknown";
+}
 function formatRouteFile(file, root) {
   if (!root) {
     return toPosixPath(file);
@@ -429,6 +457,17 @@ function toPlaygroundRoute(route, root, groups) {
     group: matchedGroup?.label
   };
 }
+function toPlaygroundDisabledRoute(route, root, groups) {
+  const matchedGroup = resolveRouteGroup(route.file, groups);
+  return {
+    file: formatRouteFile(route.file, root),
+    reason: normalizeDisabledReason(route.reason),
+    method: route.method,
+    url: route.url,
+    groupKey: matchedGroup?.key,
+    group: matchedGroup?.label
+  };
+}
 function registerPlaygroundRoutes(params) {
   if (!params.config.enabled) {
     return;
@@ -466,7 +505,8 @@ function registerPlaygroundRoutes(params) {
       root: baseRoot,
       count: params.routes.length,
       groups: groups.map((group) => ({ key: group.key, label: group.label })),
-      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups))
+      routes: params.routes.map((route) => toPlaygroundRoute(route, baseRoot, groups)),
+      disabled: (params.disabledRoutes ?? []).map((route) => toPlaygroundDisabledRoute(route, baseRoot, groups))
     });
   });
   params.app.get(`${playgroundPath}/*`, async (c) => {
@@ -733,6 +773,15 @@ async function resolveDirectoryConfig(params) {
     if (typeof config.enabled === "boolean") {
       merged.enabled = config.enabled;
     }
+    if (typeof config.ignorePrefix !== "undefined") {
+      merged.ignorePrefix = config.ignorePrefix;
+    }
+    if (typeof config.include !== "undefined") {
+      merged.include = config.include;
+    }
+    if (typeof config.exclude !== "undefined") {
+      merged.exclude = config.exclude;
+    }
     const normalized = normalizeMiddlewares(config.middleware, configPath, logger);
     if (normalized.length > 0) {
       merged.middlewares.push(...normalized);
@@ -864,19 +913,44 @@ async function loadRules(file, logger) {
   return [value];
 }
 
+const silentLogger = {
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+function resolveSkipRoute(params) {
+  const derived = params.derived ?? deriveRouteFromFile(params.file, params.rootDir, silentLogger);
+  if (!derived?.method) {
+    return null;
+  }
+  const resolved = resolveRule({
+    rule: { handler: null },
+    derivedTemplate: derived.template,
+    derivedMethod: derived.method,
+    prefix: params.prefix,
+    file: params.file,
+    logger: silentLogger
+  });
+  if (!resolved) {
+    return null;
+  }
+  return {
+    method: resolved.method,
+    url: resolved.template
+  };
+}
 async function scanRoutes(params) {
   const routes = [];
   const seen = /* @__PURE__ */ new Set();
   const files = await collectFiles(params.dirs);
+  const globalIgnorePrefix = normalizeIgnorePrefix(params.ignorePrefix);
   const configCache = /* @__PURE__ */ new Map();
   const fileCache = /* @__PURE__ */ new Map();
+  const shouldCollectSkip = typeof params.onSkip === "function";
   for (const fileInfo of files) {
-    if (!isSupportedFile(fileInfo.file)) {
-      continue;
-    }
-    if (!matchesFilter(fileInfo.file, params.include, params.exclude)) {
-      continue;
-    }
     const config = await resolveDirectoryConfig({
       file: fileInfo.file,
       rootDir: fileInfo.rootDir,
@@ -885,6 +959,58 @@ async function scanRoutes(params) {
       fileCache
     });
     if (config.enabled === false) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason: "disabled-dir",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      continue;
+    }
+    const effectiveIgnorePrefix = typeof config.ignorePrefix !== "undefined" ? normalizeIgnorePrefix(config.ignorePrefix, []) : globalIgnorePrefix;
+    if (hasIgnoredPrefix(fileInfo.file, fileInfo.rootDir, effectiveIgnorePrefix)) {
+      if (shouldCollectSkip && isSupportedFile(fileInfo.file)) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason: "ignore-prefix",
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
+      continue;
+    }
+    if (!isSupportedFile(fileInfo.file)) {
+      continue;
+    }
+    const effectiveInclude = typeof config.include !== "undefined" ? config.include : params.include;
+    const effectiveExclude = typeof config.exclude !== "undefined" ? config.exclude : params.exclude;
+    if (!matchesFilter(fileInfo.file, effectiveInclude, effectiveExclude)) {
+      if (shouldCollectSkip) {
+        const resolved = resolveSkipRoute({
+          file: fileInfo.file,
+          rootDir: fileInfo.rootDir,
+          prefix: params.prefix
+        });
+        const reason = effectiveExclude && matchesFilter(fileInfo.file, void 0, effectiveExclude) ? "exclude" : "include";
+        params.onSkip?.({
+          file: fileInfo.file,
+          reason,
+          method: resolved?.method,
+          url: resolved?.url
+        });
+      }
       continue;
     }
     const derived = deriveRouteFromFile(fileInfo.file, fileInfo.rootDir, params.logger);
@@ -896,6 +1022,23 @@ async function scanRoutes(params) {
       if (!rule || typeof rule !== "object") {
         continue;
       }
+      if (rule.enabled === false) {
+        if (shouldCollectSkip) {
+          const resolved2 = resolveSkipRoute({
+            file: fileInfo.file,
+            rootDir: fileInfo.rootDir,
+            prefix: params.prefix,
+            derived
+          });
+          params.onSkip?.({
+            file: fileInfo.file,
+            reason: "disabled",
+            method: resolved2?.method,
+            url: resolved2?.url
+          });
+        }
+        continue;
+      }
       const ruleValue = rule;
       const unsupportedKeys = ["response", "url", "method"].filter(
         (key2) => key2 in ruleValue
@@ -996,6 +1139,7 @@ function buildApp(params) {
   registerPlaygroundRoutes({
     app,
     routes: params.routes,
+    disabledRoutes: params.disabledRoutes,
     dirs: params.dirs,
     logger: params.logger,
     config: params.playground,
@@ -1159,8 +1303,10 @@ async function createFetchServer(options = {}) {
     }
   }
   let routes = [];
+  let disabledRoutes = [];
   let app = buildApp({
     routes,
+    disabledRoutes,
     dirs,
     playground: playgroundConfig,
     root,
@@ -1171,11 +1317,13 @@ async function createFetchServer(options = {}) {
   const refreshRoutes = async () => {
     try {
       const collected = [];
+      const collectedDisabled = [];
       for (const entry of optionList) {
         const scanParams = {
           dirs: resolveDirs(entry.dir, root),
           prefix: entry.prefix ?? "",
-          logger
+          logger,
+          onSkip: (info) => collectedDisabled.push(info)
         };
         if (entry.include) {
           scanParams.include = entry.include;
@@ -1183,13 +1331,18 @@ async function createFetchServer(options = {}) {
         if (entry.exclude) {
           scanParams.exclude = entry.exclude;
         }
+        if (typeof entry.ignorePrefix !== "undefined") {
+          scanParams.ignorePrefix = entry.ignorePrefix;
+        }
         const scanned = await scanRoutes(scanParams);
         collected.push(...scanned);
       }
       const resolvedRoutes = sortRoutes(collected);
       routes = resolvedRoutes;
+      disabledRoutes = collectedDisabled;
       app = buildApp({
         routes,
+        disabledRoutes,
         dirs,
         playground: playgroundConfig,
         root,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mokup/server",
   "type": "module",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Server adapters for @mokup/runtime.",
   "license": "MIT",
   "homepage": "https://mokup.icebreaker.top",
@@ -39,12 +39,12 @@
   "dependencies": {
     "@hono/node-server": "^1.19.9",
     "@hono/node-ws": "^1.1.1",
+    "@mokup/playground": "0.0.8",
     "@mokup/runtime": "1.0.0",
-    "@mokup/playground": "0.0.7",
     "@mokup/shared": "1.0.0"
   },
   "devDependencies": {
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.0.10",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1"
   },