@demokit-ai/core 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -163,6 +163,21 @@ interface DemoKitConfig {
      * or when specific query parameters are present
      */
     detection?: DetectionConfig;
+    /**
+     * Path aliases for matching fixtures across equivalent URL prefixes.
+     * Common in Next.js apps where `/api/*` rewrites to `/v1/*`.
+     * A fixture defined for `/v1/users` will also match `/api/users`.
+     *
+     * @example
+     * pathAliases: { '/api/': '/v1/' }
+     */
+    pathAliases?: Record<string, string>;
+    /**
+     * Log a warning when a catch-all pattern (containing `*`) matches a request.
+     * Helps identify fixtures that need specific patterns.
+     * @default true in development, false in production
+     */
+    warnOnCatchAll?: boolean;
     /**
      * Guard callback that controls whether demo mode can be disabled.
      * Return `true` to allow disabling, `false` to prevent it,

package/dist/index.d.ts

@@ -163,6 +163,21 @@ interface DemoKitConfig {
      * or when specific query parameters are present
      */
     detection?: DetectionConfig;
+    /**
+     * Path aliases for matching fixtures across equivalent URL prefixes.
+     * Common in Next.js apps where `/api/*` rewrites to `/v1/*`.
+     * A fixture defined for `/v1/users` will also match `/api/users`.
+     *
+     * @example
+     * pathAliases: { '/api/': '/v1/' }
+     */
+    pathAliases?: Record<string, string>;
+    /**
+     * Log a warning when a catch-all pattern (containing `*`) matches a request.
+     * Helps identify fixtures that need specific patterns.
+     * @default true in development, false in production
+     */
+    warnOnCatchAll?: boolean;
     /**
      * Guard callback that controls whether demo mode can be disabled.
      * Return `true` to allow disabling, `false` to prevent it,

package/dist/index.js

@@ -360,7 +360,9 @@ function createDemoInterceptor(config) {
     baseUrl = "http://localhost",
     detection,
     canDisable,
-    onMutationIntercepted
+    onMutationIntercepted,
+    pathAliases,
+    warnOnCatchAll = typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
   } = config;
   const detectionResult = detectDemoMode(detection);
   let enabled = detectionResult.detected || (initialEnabled ?? loadDemoState(storageKey));
@@ -375,20 +377,29 @@ function createDemoInterceptor(config) {
     originalFetch = globalThis.fetch;
     globalThis.fetch = async function interceptedFetch(input, init) {
       if (!enabled) {
-        console.log("[DemoKit] Demo mode disabled, passing through");
         return originalFetch(input, init);
       }
       const method = init?.method?.toUpperCase() || "GET";
       const pathname = extractPathname(input, baseUrl);
-      console.log("[DemoKit] Intercepting request:", { method, pathname, enabled });
-      console.log("[DemoKit] Available fixtures:", Object.keys(currentFixtures));
-      const match = findMatchingPattern(currentFixtures, method, pathname);
+      let match = findMatchingPattern(currentFixtures, method, pathname);
+      if (!match && pathAliases) {
+        for (const [from, to] of Object.entries(pathAliases)) {
+          if (pathname.startsWith(from)) {
+            const aliasedPath = to + pathname.slice(from.length);
+            match = findMatchingPattern(currentFixtures, method, aliasedPath);
+            if (match) break;
+          }
+        }
+      }
       if (!match) {
-        console.log("[DemoKit] No matching fixture for:", `${method} ${pathname}`);
         return originalFetch(input, init);
       }
-      console.log("[DemoKit] Found matching fixture:", match[0]);
       const [pattern, matchResult] = match;
+      if (warnOnCatchAll && pattern.includes("*")) {
+        console.warn(
+          `[DemoKit] Catch-all fixture matched: ${method} ${pathname} \u2192 "${pattern}". Consider adding a specific fixture.`
+        );
+      }
       const handler = currentFixtures[pattern];
       const url = extractUrl(input, baseUrl);
       const headers = new Headers(init?.headers);