@demokit-ai/next 0.0.1

package/dist/server.cjs

@@ -0,0 +1,183 @@
+'use strict';
+
+var async_hooks = require('async_hooks');
+var core = require('@demokit-ai/core');
+var server = require('next/server');
+
+// src/server/context.ts
+var demoContextStorage = new async_hooks.AsyncLocalStorage();
+function getServerDemoContext() {
+  return demoContextStorage.getStore() ?? null;
+}
+function isServerDemoMode() {
+  const context = getServerDemoContext();
+  return context?.enabled ?? false;
+}
+function getServerScenario() {
+  const context = getServerDemoContext();
+  return context?.scenario ?? null;
+}
+function runWithDemoContext(context, fn) {
+  return demoContextStorage.run(context, fn);
+}
+function createServerInterceptor(config) {
+  const { fixtures, scenarios = {}, baseUrl } = config;
+  const getActiveFixtures = () => {
+    const scenario = getServerScenario();
+    if (scenario && scenarios[scenario]) {
+      return { ...fixtures, ...scenarios[scenario] };
+    }
+    return fixtures;
+  };
+  const wrappedFixtures = new Proxy(fixtures, {
+    get(target, prop) {
+      const activeFixtures = getActiveFixtures();
+      return activeFixtures[prop];
+    },
+    ownKeys() {
+      const activeFixtures = getActiveFixtures();
+      return Reflect.ownKeys(activeFixtures);
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      const activeFixtures = getActiveFixtures();
+      if (prop in activeFixtures) {
+        return {
+          configurable: true,
+          enumerable: true,
+          value: activeFixtures[prop]
+        };
+      }
+      return void 0;
+    }
+  });
+  return core.createDemoInterceptor({
+    fixtures: wrappedFixtures,
+    baseUrl,
+    // Server-side storage is not used (we use cookies/headers)
+    storageKey: void 0
+  });
+}
+function withDemoCheck(handler, fallback) {
+  return async (context) => {
+    if (!isServerDemoMode()) {
+      if (fallback) {
+        return fallback();
+      }
+      throw new Error("[DemoKit] Demo mode is not enabled");
+    }
+    return handler(context);
+  };
+}
+var DEFAULT_CONFIG = {
+  cookieName: "demokit-mode",
+  urlParam: "demo",
+  headerName: "x-demokit-mode",
+  apiPaths: ["/api/"],
+  cookieOptions: {
+    maxAge: 60 * 60 * 24 * 7,
+    // 1 week
+    path: "/",
+    sameSite: "lax",
+    secure: process.env.NODE_ENV === "production"
+  }
+};
+function createDemoMiddleware(config = {}) {
+  const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+  const { cookieName, urlParam, headerName, apiPaths, cookieOptions } = mergedConfig;
+  return function demoMiddleware2(request) {
+    const demoParam = request.nextUrl.searchParams.get(urlParam);
+    const demoCookie = request.cookies.get(cookieName);
+    let response = server.NextResponse.next();
+    let isDemoMode = false;
+    let scenario = null;
+    if (demoParam !== null) {
+      if (demoParam === "false" || demoParam === "0" || demoParam === "") {
+        response = server.NextResponse.next();
+        response.cookies.delete(cookieName);
+        isDemoMode = false;
+      } else if (demoParam === "true" || demoParam === "1") {
+        response = server.NextResponse.next();
+        response.cookies.set(cookieName, "true", cookieOptions);
+        isDemoMode = true;
+      } else {
+        response = server.NextResponse.next();
+        response.cookies.set(cookieName, demoParam, cookieOptions);
+        isDemoMode = true;
+        scenario = demoParam;
+      }
+    } else if (demoCookie) {
+      isDemoMode = true;
+      scenario = demoCookie.value !== "true" ? demoCookie.value : null;
+    }
+    if (isDemoMode) {
+      const isApiRoute = apiPaths.some(
+        (path) => request.nextUrl.pathname.startsWith(path)
+      );
+      if (isApiRoute) {
+        const requestHeaders = new Headers(request.headers);
+        requestHeaders.set(headerName, scenario ?? "true");
+        response = server.NextResponse.next({
+          request: {
+            headers: requestHeaders
+          }
+        });
+        if (demoParam !== null) {
+          if (demoParam === "false" || demoParam === "0" || demoParam === "") {
+            response.cookies.delete(cookieName);
+          } else {
+            response.cookies.set(
+              cookieName,
+              demoParam === "true" || demoParam === "1" ? "true" : demoParam,
+              cookieOptions
+            );
+          }
+        }
+      }
+    }
+    return {
+      isDemoMode,
+      scenario,
+      response
+    };
+  };
+}
+function demoMiddleware(config = {}) {
+  const handler = createDemoMiddleware(config);
+  return function middleware(request) {
+    return handler(request).response;
+  };
+}
+function isDemoRequest(request, config = {}) {
+  const { cookieName = "demokit-mode", headerName = "x-demokit-mode" } = config;
+  if (request.headers.get(headerName)) {
+    return true;
+  }
+  const cookie = request.cookies.get(cookieName);
+  return cookie !== void 0 && cookie.value !== "";
+}
+function getDemoScenario(request, config = {}) {
+  const { cookieName = "demokit-mode", headerName = "x-demokit-mode" } = config;
+  const headerValue = request.headers.get(headerName);
+  if (headerValue && headerValue !== "true") {
+    return headerValue;
+  }
+  const cookie = request.cookies.get(cookieName);
+  if (cookie && cookie.value !== "true") {
+    return cookie.value;
+  }
+  return null;
+}
+
+exports.createDemoMiddleware = createDemoMiddleware;
+exports.createServerInterceptor = createServerInterceptor;
+exports.demoContextStorage = demoContextStorage;
+exports.demoMiddleware = demoMiddleware;
+exports.getDemoScenario = getDemoScenario;
+exports.getServerDemoContext = getServerDemoContext;
+exports.getServerScenario = getServerScenario;
+exports.isDemoRequest = isDemoRequest;
+exports.isServerDemoMode = isServerDemoMode;
+exports.runWithDemoContext = runWithDemoContext;
+exports.withDemoCheck = withDemoCheck;
+//# sourceMappingURL=server.cjs.map
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/context.ts","../src/server/interceptor.ts","../src/server/middleware.ts"],"names":["AsyncLocalStorage","createDemoInterceptor","demoMiddleware","NextResponse"],"mappings":"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","file":"server.cjs","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\n/**\n * Server-side demo mode context\n */\nexport interface ServerDemoContext {\n  /**\n   * Whether demo mode is enabled\n   */\n  enabled: boolean\n\n  /**\n   * The current scenario name\n   */\n  scenario: string | null\n}\n\n/**\n * AsyncLocalStorage for server-side demo mode context\n * This allows Server Components to access demo mode state\n */\nexport const demoContextStorage = new AsyncLocalStorage<ServerDemoContext>()\n\n/**\n * Get the current server-side demo context\n * Returns null if not in a demo context\n */\nexport function getServerDemoContext(): ServerDemoContext | null {\n  return demoContextStorage.getStore() ?? null\n}\n\n/**\n * Check if demo mode is enabled on the server\n */\nexport function isServerDemoMode(): boolean {\n  const context = getServerDemoContext()\n  return context?.enabled ?? false\n}\n\n/**\n * Get the current scenario on the server\n */\nexport function getServerScenario(): string | null {\n  const context = getServerDemoContext()\n  return context?.scenario ?? null\n}\n\n/**\n * Run a function within a demo context\n */\nexport function runWithDemoContext<T>(\n  context: ServerDemoContext,\n  fn: () => T\n): T {\n  return demoContextStorage.run(context, fn)\n}\n","import {\n  createDemoInterceptor,\n  type FixtureMap,\n  type DemoInterceptor,\n  type RequestContext,\n} from '@demokit-ai/core'\nimport { isServerDemoMode, getServerScenario } from './context'\n\n/**\n * Configuration for server-side demo interceptor\n */\nexport interface ServerInterceptorConfig {\n  /**\n   * Base fixtures (always available)\n   */\n  fixtures: FixtureMap\n\n  /**\n   * Scenario-specific fixtures\n   */\n  scenarios?: Record<string, FixtureMap>\n\n  /**\n   * Base URL for relative URL parsing\n   */\n  baseUrl?: string\n}\n\n/**\n * Create a server-side demo interceptor\n *\n * This interceptor works with Server Components and API routes.\n * It uses AsyncLocalStorage to check demo mode state.\n *\n * @example\n * // lib/demo-interceptor.ts\n * import { createServerInterceptor } from '@demokit-ai/next/server'\n *\n * export const demoInterceptor = createServerInterceptor({\n *   fixtures: {\n *     'GET /api/users': () => [{ id: '1', name: 'Demo User' }],\n *   },\n *   scenarios: {\n *     'empty': { 'GET /api/users': () => [] },\n *   },\n * })\n *\n * // Enable in your app\n * demoInterceptor.enable()\n */\nexport function createServerInterceptor(config: ServerInterceptorConfig): DemoInterceptor {\n  const { fixtures, scenarios = {}, baseUrl } = config\n\n  // Merge fixtures based on current scenario\n  const getActiveFixtures = (): FixtureMap => {\n    const scenario = getServerScenario()\n    if (scenario && scenarios[scenario]) {\n      return { ...fixtures, ...scenarios[scenario] }\n    }\n    return fixtures\n  }\n\n  // Wrapper that checks server context before each request\n  const wrappedFixtures: FixtureMap = new Proxy(fixtures, {\n    get(target, prop: string) {\n      const activeFixtures = getActiveFixtures()\n      return activeFixtures[prop]\n    },\n    ownKeys() {\n      const activeFixtures = getActiveFixtures()\n      return Reflect.ownKeys(activeFixtures)\n    },\n    getOwnPropertyDescriptor(target, prop) {\n      const activeFixtures = getActiveFixtures()\n      if (prop in activeFixtures) {\n        return {\n          configurable: true,\n          enumerable: true,\n          value: activeFixtures[prop as string],\n        }\n      }\n      return undefined\n    },\n  })\n\n  return createDemoInterceptor({\n    fixtures: wrappedFixtures,\n    baseUrl,\n    // Server-side storage is not used (we use cookies/headers)\n    storageKey: undefined,\n  })\n}\n\n/**\n * Helper to wrap a fixture handler with demo mode check\n */\nexport function withDemoCheck<T>(\n  handler: (context: RequestContext) => T | Promise<T>,\n  fallback?: () => T | Promise<T>\n): (context: RequestContext) => T | Promise<T> {\n  return async (context) => {\n    if (!isServerDemoMode()) {\n      if (fallback) {\n        return fallback()\n      }\n      throw new Error('[DemoKit] Demo mode is not enabled')\n    }\n    return handler(context)\n  }\n}\n","import { NextRequest, NextResponse } from 'next/server'\nimport type { DemoMiddlewareConfig, MiddlewareResult } from '../types'\n\nconst DEFAULT_CONFIG: Required<DemoMiddlewareConfig> = {\n  cookieName: 'demokit-mode',\n  urlParam: 'demo',\n  headerName: 'x-demokit-mode',\n  apiPaths: ['/api/'],\n  cookieOptions: {\n    maxAge: 60 * 60 * 24 * 7, // 1 week\n    path: '/',\n    sameSite: 'lax',\n    secure: process.env.NODE_ENV === 'production',\n  },\n}\n\n/**\n * Create a demo-aware middleware\n *\n * This middleware:\n * 1. Checks for demo mode URL parameter (?demo=true or ?demo=false)\n * 2. Sets/clears demo mode cookie\n * 3. Adds demo mode header to API requests\n * 4. Supports scenario switching via ?demo=scenario-name\n *\n * @example\n * // middleware.ts\n * import { createDemoMiddleware } from '@demokit-ai/next/middleware'\n *\n * const demoMiddleware = createDemoMiddleware()\n *\n * export function middleware(request: NextRequest) {\n *   return demoMiddleware(request)\n * }\n *\n * export const config = {\n *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],\n * }\n */\nexport function createDemoMiddleware(config: DemoMiddlewareConfig = {}) {\n  const mergedConfig = { ...DEFAULT_CONFIG, ...config }\n  const { cookieName, urlParam, headerName, apiPaths, cookieOptions } = mergedConfig\n\n  return function demoMiddleware(request: NextRequest): MiddlewareResult {\n    // Check for demo mode in URL param\n    const demoParam = request.nextUrl.searchParams.get(urlParam)\n\n    // Check for existing cookie\n    const demoCookie = request.cookies.get(cookieName)\n\n    let response = NextResponse.next()\n    let isDemoMode = false\n    let scenario: string | null = null\n\n    // Handle URL param toggle\n    if (demoParam !== null) {\n      if (demoParam === 'false' || demoParam === '0' || demoParam === '') {\n        // Disable demo mode\n        response = NextResponse.next()\n        response.cookies.delete(cookieName)\n        isDemoMode = false\n      } else if (demoParam === 'true' || demoParam === '1') {\n        // Enable demo mode (no scenario)\n        response = NextResponse.next()\n        response.cookies.set(cookieName, 'true', cookieOptions)\n        isDemoMode = true\n      } else {\n        // Enable with specific scenario\n        response = NextResponse.next()\n        response.cookies.set(cookieName, demoParam, cookieOptions)\n        isDemoMode = true\n        scenario = demoParam\n      }\n    } else if (demoCookie) {\n      // Use existing cookie\n      isDemoMode = true\n      scenario = demoCookie.value !== 'true' ? demoCookie.value : null\n    }\n\n    // Add header for API routes\n    if (isDemoMode) {\n      const isApiRoute = apiPaths.some((path) =>\n        request.nextUrl.pathname.startsWith(path)\n      )\n\n      if (isApiRoute) {\n        const requestHeaders = new Headers(request.headers)\n        requestHeaders.set(headerName, scenario ?? 'true')\n\n        response = NextResponse.next({\n          request: {\n            headers: requestHeaders,\n          },\n        })\n\n        // Re-set cookie if we created new response\n        if (demoParam !== null) {\n          if (demoParam === 'false' || demoParam === '0' || demoParam === '') {\n            response.cookies.delete(cookieName)\n          } else {\n            response.cookies.set(\n              cookieName,\n              demoParam === 'true' || demoParam === '1' ? 'true' : demoParam,\n              cookieOptions\n            )\n          }\n        }\n      }\n    }\n\n    return {\n      isDemoMode,\n      scenario,\n      response,\n    }\n  }\n}\n\n/**\n * Simple middleware wrapper that just returns the response\n *\n * @example\n * import { demoMiddleware } from '@demokit-ai/next/middleware'\n * export const middleware = demoMiddleware()\n */\nexport function demoMiddleware(config: DemoMiddlewareConfig = {}) {\n  const handler = createDemoMiddleware(config)\n\n  return function middleware(request: NextRequest): NextResponse {\n    return handler(request).response\n  }\n}\n\n/**\n * Check if a request is in demo mode (from middleware or direct header check)\n */\nexport function isDemoRequest(request: NextRequest, config: DemoMiddlewareConfig = {}): boolean {\n  const { cookieName = 'demokit-mode', headerName = 'x-demokit-mode' } = config\n\n  // Check header first (set by middleware)\n  if (request.headers.get(headerName)) {\n    return true\n  }\n\n  // Check cookie\n  const cookie = request.cookies.get(cookieName)\n  return cookie !== undefined && cookie.value !== ''\n}\n\n/**\n * Get the demo scenario from a request\n */\nexport function getDemoScenario(request: NextRequest, config: DemoMiddlewareConfig = {}): string | null {\n  const { cookieName = 'demokit-mode', headerName = 'x-demokit-mode' } = config\n\n  // Check header first\n  const headerValue = request.headers.get(headerName)\n  if (headerValue && headerValue !== 'true') {\n    return headerValue\n  }\n\n  // Check cookie\n  const cookie = request.cookies.get(cookieName)\n  if (cookie && cookie.value !== 'true') {\n    return cookie.value\n  }\n\n  return null\n}\n"]}

package/dist/server.d.cts

@@ -0,0 +1,89 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { FixtureMap, DemoInterceptor, RequestContext } from '@demokit-ai/core';
+export { createDemoMiddleware, demoMiddleware, getDemoScenario, isDemoRequest } from './middleware.cjs';
+import 'next/server';
+import './types-Cvq5JUP1.cjs';
+import 'react';
+
+/**
+ * Server-side demo mode context
+ */
+interface ServerDemoContext {
+    /**
+     * Whether demo mode is enabled
+     */
+    enabled: boolean;
+    /**
+     * The current scenario name
+     */
+    scenario: string | null;
+}
+/**
+ * AsyncLocalStorage for server-side demo mode context
+ * This allows Server Components to access demo mode state
+ */
+declare const demoContextStorage: AsyncLocalStorage<ServerDemoContext>;
+/**
+ * Get the current server-side demo context
+ * Returns null if not in a demo context
+ */
+declare function getServerDemoContext(): ServerDemoContext | null;
+/**
+ * Check if demo mode is enabled on the server
+ */
+declare function isServerDemoMode(): boolean;
+/**
+ * Get the current scenario on the server
+ */
+declare function getServerScenario(): string | null;
+/**
+ * Run a function within a demo context
+ */
+declare function runWithDemoContext<T>(context: ServerDemoContext, fn: () => T): T;
+
+/**
+ * Configuration for server-side demo interceptor
+ */
+interface ServerInterceptorConfig {
+    /**
+     * Base fixtures (always available)
+     */
+    fixtures: FixtureMap;
+    /**
+     * Scenario-specific fixtures
+     */
+    scenarios?: Record<string, FixtureMap>;
+    /**
+     * Base URL for relative URL parsing
+     */
+    baseUrl?: string;
+}
+/**
+ * Create a server-side demo interceptor
+ *
+ * This interceptor works with Server Components and API routes.
+ * It uses AsyncLocalStorage to check demo mode state.
+ *
+ * @example
+ * // lib/demo-interceptor.ts
+ * import { createServerInterceptor } from '@demokit-ai/next/server'
+ *
+ * export const demoInterceptor = createServerInterceptor({
+ *   fixtures: {
+ *     'GET /api/users': () => [{ id: '1', name: 'Demo User' }],
+ *   },
+ *   scenarios: {
+ *     'empty': { 'GET /api/users': () => [] },
+ *   },
+ * })
+ *
+ * // Enable in your app
+ * demoInterceptor.enable()
+ */
+declare function createServerInterceptor(config: ServerInterceptorConfig): DemoInterceptor;
+/**
+ * Helper to wrap a fixture handler with demo mode check
+ */
+declare function withDemoCheck<T>(handler: (context: RequestContext) => T | Promise<T>, fallback?: () => T | Promise<T>): (context: RequestContext) => T | Promise<T>;
+
+export { type ServerDemoContext, type ServerInterceptorConfig, createServerInterceptor, demoContextStorage, getServerDemoContext, getServerScenario, isServerDemoMode, runWithDemoContext, withDemoCheck };

package/dist/server.d.ts

@@ -0,0 +1,89 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { FixtureMap, DemoInterceptor, RequestContext } from '@demokit-ai/core';
+export { createDemoMiddleware, demoMiddleware, getDemoScenario, isDemoRequest } from './middleware.js';
+import 'next/server';
+import './types-Cvq5JUP1.js';
+import 'react';
+
+/**
+ * Server-side demo mode context
+ */
+interface ServerDemoContext {
+    /**
+     * Whether demo mode is enabled
+     */
+    enabled: boolean;
+    /**
+     * The current scenario name
+     */
+    scenario: string | null;
+}
+/**
+ * AsyncLocalStorage for server-side demo mode context
+ * This allows Server Components to access demo mode state
+ */
+declare const demoContextStorage: AsyncLocalStorage<ServerDemoContext>;
+/**
+ * Get the current server-side demo context
+ * Returns null if not in a demo context
+ */
+declare function getServerDemoContext(): ServerDemoContext | null;
+/**
+ * Check if demo mode is enabled on the server
+ */
+declare function isServerDemoMode(): boolean;
+/**
+ * Get the current scenario on the server
+ */
+declare function getServerScenario(): string | null;
+/**
+ * Run a function within a demo context
+ */
+declare function runWithDemoContext<T>(context: ServerDemoContext, fn: () => T): T;
+
+/**
+ * Configuration for server-side demo interceptor
+ */
+interface ServerInterceptorConfig {
+    /**
+     * Base fixtures (always available)
+     */
+    fixtures: FixtureMap;
+    /**
+     * Scenario-specific fixtures
+     */
+    scenarios?: Record<string, FixtureMap>;
+    /**
+     * Base URL for relative URL parsing
+     */
+    baseUrl?: string;
+}
+/**
+ * Create a server-side demo interceptor
+ *
+ * This interceptor works with Server Components and API routes.
+ * It uses AsyncLocalStorage to check demo mode state.
+ *
+ * @example
+ * // lib/demo-interceptor.ts
+ * import { createServerInterceptor } from '@demokit-ai/next/server'
+ *
+ * export const demoInterceptor = createServerInterceptor({
+ *   fixtures: {
+ *     'GET /api/users': () => [{ id: '1', name: 'Demo User' }],
+ *   },
+ *   scenarios: {
+ *     'empty': { 'GET /api/users': () => [] },
+ *   },
+ * })
+ *
+ * // Enable in your app
+ * demoInterceptor.enable()
+ */
+declare function createServerInterceptor(config: ServerInterceptorConfig): DemoInterceptor;
+/**
+ * Helper to wrap a fixture handler with demo mode check
+ */
+declare function withDemoCheck<T>(handler: (context: RequestContext) => T | Promise<T>, fallback?: () => T | Promise<T>): (context: RequestContext) => T | Promise<T>;
+
+export { type ServerDemoContext, type ServerInterceptorConfig, createServerInterceptor, demoContextStorage, getServerDemoContext, getServerScenario, isServerDemoMode, runWithDemoContext, withDemoCheck };

package/dist/server.js

@@ -0,0 +1,171 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import { createDemoInterceptor } from '@demokit-ai/core';
+import { NextResponse } from 'next/server';
+
+// src/server/context.ts
+var demoContextStorage = new AsyncLocalStorage();
+function getServerDemoContext() {
+  return demoContextStorage.getStore() ?? null;
+}
+function isServerDemoMode() {
+  const context = getServerDemoContext();
+  return context?.enabled ?? false;
+}
+function getServerScenario() {
+  const context = getServerDemoContext();
+  return context?.scenario ?? null;
+}
+function runWithDemoContext(context, fn) {
+  return demoContextStorage.run(context, fn);
+}
+function createServerInterceptor(config) {
+  const { fixtures, scenarios = {}, baseUrl } = config;
+  const getActiveFixtures = () => {
+    const scenario = getServerScenario();
+    if (scenario && scenarios[scenario]) {
+      return { ...fixtures, ...scenarios[scenario] };
+    }
+    return fixtures;
+  };
+  const wrappedFixtures = new Proxy(fixtures, {
+    get(target, prop) {
+      const activeFixtures = getActiveFixtures();
+      return activeFixtures[prop];
+    },
+    ownKeys() {
+      const activeFixtures = getActiveFixtures();
+      return Reflect.ownKeys(activeFixtures);
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      const activeFixtures = getActiveFixtures();
+      if (prop in activeFixtures) {
+        return {
+          configurable: true,
+          enumerable: true,
+          value: activeFixtures[prop]
+        };
+      }
+      return void 0;
+    }
+  });
+  return createDemoInterceptor({
+    fixtures: wrappedFixtures,
+    baseUrl,
+    // Server-side storage is not used (we use cookies/headers)
+    storageKey: void 0
+  });
+}
+function withDemoCheck(handler, fallback) {
+  return async (context) => {
+    if (!isServerDemoMode()) {
+      if (fallback) {
+        return fallback();
+      }
+      throw new Error("[DemoKit] Demo mode is not enabled");
+    }
+    return handler(context);
+  };
+}
+var DEFAULT_CONFIG = {
+  cookieName: "demokit-mode",
+  urlParam: "demo",
+  headerName: "x-demokit-mode",
+  apiPaths: ["/api/"],
+  cookieOptions: {
+    maxAge: 60 * 60 * 24 * 7,
+    // 1 week
+    path: "/",
+    sameSite: "lax",
+    secure: process.env.NODE_ENV === "production"
+  }
+};
+function createDemoMiddleware(config = {}) {
+  const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+  const { cookieName, urlParam, headerName, apiPaths, cookieOptions } = mergedConfig;
+  return function demoMiddleware2(request) {
+    const demoParam = request.nextUrl.searchParams.get(urlParam);
+    const demoCookie = request.cookies.get(cookieName);
+    let response = NextResponse.next();
+    let isDemoMode = false;
+    let scenario = null;
+    if (demoParam !== null) {
+      if (demoParam === "false" || demoParam === "0" || demoParam === "") {
+        response = NextResponse.next();
+        response.cookies.delete(cookieName);
+        isDemoMode = false;
+      } else if (demoParam === "true" || demoParam === "1") {
+        response = NextResponse.next();
+        response.cookies.set(cookieName, "true", cookieOptions);
+        isDemoMode = true;
+      } else {
+        response = NextResponse.next();
+        response.cookies.set(cookieName, demoParam, cookieOptions);
+        isDemoMode = true;
+        scenario = demoParam;
+      }
+    } else if (demoCookie) {
+      isDemoMode = true;
+      scenario = demoCookie.value !== "true" ? demoCookie.value : null;
+    }
+    if (isDemoMode) {
+      const isApiRoute = apiPaths.some(
+        (path) => request.nextUrl.pathname.startsWith(path)
+      );
+      if (isApiRoute) {
+        const requestHeaders = new Headers(request.headers);
+        requestHeaders.set(headerName, scenario ?? "true");
+        response = NextResponse.next({
+          request: {
+            headers: requestHeaders
+          }
+        });
+        if (demoParam !== null) {
+          if (demoParam === "false" || demoParam === "0" || demoParam === "") {
+            response.cookies.delete(cookieName);
+          } else {
+            response.cookies.set(
+              cookieName,
+              demoParam === "true" || demoParam === "1" ? "true" : demoParam,
+              cookieOptions
+            );
+          }
+        }
+      }
+    }
+    return {
+      isDemoMode,
+      scenario,
+      response
+    };
+  };
+}
+function demoMiddleware(config = {}) {
+  const handler = createDemoMiddleware(config);
+  return function middleware(request) {
+    return handler(request).response;
+  };
+}
+function isDemoRequest(request, config = {}) {
+  const { cookieName = "demokit-mode", headerName = "x-demokit-mode" } = config;
+  if (request.headers.get(headerName)) {
+    return true;
+  }
+  const cookie = request.cookies.get(cookieName);
+  return cookie !== void 0 && cookie.value !== "";
+}
+function getDemoScenario(request, config = {}) {
+  const { cookieName = "demokit-mode", headerName = "x-demokit-mode" } = config;
+  const headerValue = request.headers.get(headerName);
+  if (headerValue && headerValue !== "true") {
+    return headerValue;
+  }
+  const cookie = request.cookies.get(cookieName);
+  if (cookie && cookie.value !== "true") {
+    return cookie.value;
+  }
+  return null;
+}
+
+export { createDemoMiddleware, createServerInterceptor, demoContextStorage, demoMiddleware, getDemoScenario, getServerDemoContext, getServerScenario, isDemoRequest, isServerDemoMode, runWithDemoContext, withDemoCheck };
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/context.ts","../src/server/interceptor.ts","../src/server/middleware.ts"],"names":["demoMiddleware"],"mappings":";;;;;AAqBO,IAAM,kBAAA,GAAqB,IAAI,iBAAA;AAM/B,SAAS,oBAAA,GAAiD;AAC/D,EAAA,OAAO,kBAAA,CAAmB,UAAS,IAAK,IAAA;AAC1C;AAKO,SAAS,gBAAA,GAA4B;AAC1C,EAAA,MAAM,UAAU,oBAAA,EAAqB;AACrC,EAAA,OAAO,SAAS,OAAA,IAAW,KAAA;AAC7B;AAKO,SAAS,iBAAA,GAAmC;AACjD,EAAA,MAAM,UAAU,oBAAA,EAAqB;AACrC,EAAA,OAAO,SAAS,QAAA,IAAY,IAAA;AAC9B;AAKO,SAAS,kBAAA,CACd,SACA,EAAA,EACG;AACH,EAAA,OAAO,kBAAA,CAAmB,GAAA,CAAI,OAAA,EAAS,EAAE,CAAA;AAC3C;ACLO,SAAS,wBAAwB,MAAA,EAAkD;AACxF,EAAA,MAAM,EAAE,QAAA,EAAU,SAAA,GAAY,EAAC,EAAG,SAAQ,GAAI,MAAA;AAG9C,EAAA,MAAM,oBAAoB,MAAkB;AAC1C,IAAA,MAAM,WAAW,iBAAA,EAAkB;AACnC,IAAA,IAAI,QAAA,IAAY,SAAA,CAAU,QAAQ,CAAA,EAAG;AACnC,MAAA,OAAO,EAAE,GAAG,QAAA,EAAU,GAAG,SAAA,CAAU,QAAQ,CAAA,EAAE;AAAA,IAC/C;AACA,IAAA,OAAO,QAAA;AAAA,EACT,CAAA;AAGA,EAAA,MAAM,eAAA,GAA8B,IAAI,KAAA,CAAM,QAAA,EAAU;AAAA,IACtD,GAAA,CAAI,QAAQ,IAAA,EAAc;AACxB,MAAA,MAAM,iBAAiB,iBAAA,EAAkB;AACzC,MAAA,OAAO,eAAe,IAAI,CAAA;AAAA,IAC5B,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,MAAM,iBAAiB,iBAAA,EAAkB;AACzC,MAAA,OAAO,OAAA,CAAQ,QAAQ,cAAc,CAAA;AAAA,IACvC,CAAA;AAAA,IACA,wBAAA,CAAyB,QAAQ,IAAA,EAAM;AACrC,MAAA,MAAM,iBAAiB,iBAAA,EAAkB;AACzC,MAAA,IAAI,QAAQ,cAAA,EAAgB;AAC1B,QAAA,OAAO;AAAA,UACL,YAAA,EAAc,IAAA;AAAA,UACd,UAAA,EAAY,IAAA;AAAA,UACZ,KAAA,EAAO,eAAe,IAAc;AAAA,SACtC;AAAA,MACF;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACD,CAAA;AAED,EAAA,OAAO,qBAAA,CAAsB;AAAA,IAC3B,QAAA,EAAU,eAAA;AAAA,IACV,OAAA;AAAA;AAAA,IAEA,UAAA,EAAY;AAAA,GACb,CAAA;AACH;AAKO,SAAS,aAAA,CACd,SACA,QAAA,EAC6C;AAC7C,EAAA,OAAO,OAAO,OAAA,KAAY;AACxB,IAAA,IAAI,CAAC,kBAAiB,EAAG;AACvB,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,OAAO,QAAA,EAAS;AAAA,MAClB;AACA,MAAA,MAAM,IAAI,MAAM,oCAAoC,CAAA;AAAA,IACtD;AACA,IAAA,OAAO,QAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AACF;AC1GA,IAAM,cAAA,GAAiD;AAAA,EACrD,UAAA,EAAY,cAAA;AAAA,EACZ,QAAA,EAAU,MAAA;AAAA,EACV,UAAA,EAAY,gBAAA;AAAA,EACZ,QAAA,EAAU,CAAC,OAAO,CAAA;AAAA,EAClB,aAAA,EAAe;AAAA,IACb,MAAA,EAAQ,EAAA,GAAK,EAAA,GAAK,EAAA,GAAK,CAAA;AAAA;AAAA,IACvB,IAAA,EAAM,GAAA;AAAA,IACN,QAAA,EAAU,KAAA;AAAA,IACV,MAAA,EAAQ,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa;AAAA;AAErC,CAAA;AAyBO,SAAS,oBAAA,CAAqB,MAAA,GAA+B,EAAC,EAAG;AACtE,EAAA,MAAM,YAAA,GAAe,EAAE,GAAG,cAAA,EAAgB,GAAG,MAAA,EAAO;AACpD,EAAA,MAAM,EAAE,UAAA,EAAY,QAAA,EAAU,UAAA,EAAY,QAAA,EAAU,eAAc,GAAI,YAAA;AAEtE,EAAA,OAAO,SAASA,gBAAe,OAAA,EAAwC;AAErE,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,OAAA,CAAQ,YAAA,CAAa,IAAI,QAAQ,CAAA;AAG3D,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA;AAEjD,IAAA,IAAI,QAAA,GAAW,aAAa,IAAA,EAAK;AACjC,IAAA,IAAI,UAAA,GAAa,KAAA;AACjB,IAAA,IAAI,QAAA,GAA0B,IAAA;AAG9B,IAAA,IAAI,cAAc,IAAA,EAAM;AACtB,MAAA,IAAI,SAAA,KAAc,OAAA,IAAW,SAAA,KAAc,GAAA,IAAO,cAAc,EAAA,EAAI;AAElE,QAAA,QAAA,GAAW,aAAa,IAAA,EAAK;AAC7B,QAAA,QAAA,CAAS,OAAA,CAAQ,OAAO,UAAU,CAAA;AAClC,QAAA,UAAA,GAAa,KAAA;AAAA,MACf,CAAA,MAAA,IAAW,SAAA,KAAc,MAAA,IAAU,SAAA,KAAc,GAAA,EAAK;AAEpD,QAAA,QAAA,GAAW,aAAa,IAAA,EAAK;AAC7B,QAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,UAAA,EAAY,MAAA,EAAQ,aAAa,CAAA;AACtD,QAAA,UAAA,GAAa,IAAA;AAAA,MACf,CAAA,MAAO;AAEL,QAAA,QAAA,GAAW,aAAa,IAAA,EAAK;AAC7B,QAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,UAAA,EAAY,SAAA,EAAW,aAAa,CAAA;AACzD,QAAA,UAAA,GAAa,IAAA;AACb,QAAA,QAAA,GAAW,SAAA;AAAA,MACb;AAAA,IACF,WAAW,UAAA,EAAY;AAErB,MAAA,UAAA,GAAa,IAAA;AACb,MAAA,QAAA,GAAW,UAAA,CAAW,KAAA,KAAU,MAAA,GAAS,UAAA,CAAW,KAAA,GAAQ,IAAA;AAAA,IAC9D;AAGA,IAAA,IAAI,UAAA,EAAY;AACd,MAAA,MAAM,aAAa,QAAA,CAAS,IAAA;AAAA,QAAK,CAAC,IAAA,KAChC,OAAA,CAAQ,OAAA,CAAQ,QAAA,CAAS,WAAW,IAAI;AAAA,OAC1C;AAEA,MAAA,IAAI,UAAA,EAAY;AACd,QAAA,MAAM,cAAA,GAAiB,IAAI,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA;AAClD,QAAA,cAAA,CAAe,GAAA,CAAI,UAAA,EAAY,QAAA,IAAY,MAAM,CAAA;AAEjD,QAAA,QAAA,GAAW,aAAa,IAAA,CAAK;AAAA,UAC3B,OAAA,EAAS;AAAA,YACP,OAAA,EAAS;AAAA;AACX,SACD,CAAA;AAGD,QAAA,IAAI,cAAc,IAAA,EAAM;AACtB,UAAA,IAAI,SAAA,KAAc,OAAA,IAAW,SAAA,KAAc,GAAA,IAAO,cAAc,EAAA,EAAI;AAClE,YAAA,QAAA,CAAS,OAAA,CAAQ,OAAO,UAAU,CAAA;AAAA,UACpC,CAAA,MAAO;AACL,YAAA,QAAA,CAAS,OAAA,CAAQ,GAAA;AAAA,cACf,UAAA;AAAA,cACA,SAAA,KAAc,MAAA,IAAU,SAAA,KAAc,GAAA,GAAM,MAAA,GAAS,SAAA;AAAA,cACrD;AAAA,aACF;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO;AAAA,MACL,UAAA;AAAA,MACA,QAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF,CAAA;AACF;AASO,SAAS,cAAA,CAAe,MAAA,GAA+B,EAAC,EAAG;AAChE,EAAA,MAAM,OAAA,GAAU,qBAAqB,MAAM,CAAA;AAE3C,EAAA,OAAO,SAAS,WAAW,OAAA,EAAoC;AAC7D,IAAA,OAAO,OAAA,CAAQ,OAAO,CAAA,CAAE,QAAA;AAAA,EAC1B,CAAA;AACF;AAKO,SAAS,aAAA,CAAc,OAAA,EAAsB,MAAA,GAA+B,EAAC,EAAY;AAC9F,EAAA,MAAM,EAAE,UAAA,GAAa,cAAA,EAAgB,UAAA,GAAa,kBAAiB,GAAI,MAAA;AAGvE,EAAA,IAAI,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA,EAAG;AACnC,IAAA,OAAO,IAAA;AAAA,EACT;AAGA,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA;AAC7C,EAAA,OAAO,MAAA,KAAW,MAAA,IAAa,MAAA,CAAO,KAAA,KAAU,EAAA;AAClD;AAKO,SAAS,eAAA,CAAgB,OAAA,EAAsB,MAAA,GAA+B,EAAC,EAAkB;AACtG,EAAA,MAAM,EAAE,UAAA,GAAa,cAAA,EAAgB,UAAA,GAAa,kBAAiB,GAAI,MAAA;AAGvE,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA;AAClD,EAAA,IAAI,WAAA,IAAe,gBAAgB,MAAA,EAAQ;AACzC,IAAA,OAAO,WAAA;AAAA,EACT;AAGA,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,UAAU,CAAA;AAC7C,EAAA,IAAI,MAAA,IAAU,MAAA,CAAO,KAAA,KAAU,MAAA,EAAQ;AACrC,IAAA,OAAO,MAAA,CAAO,KAAA;AAAA,EAChB;AAEA,EAAA,OAAO,IAAA;AACT","file":"server.js","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\n/**\n * Server-side demo mode context\n */\nexport interface ServerDemoContext {\n  /**\n   * Whether demo mode is enabled\n   */\n  enabled: boolean\n\n  /**\n   * The current scenario name\n   */\n  scenario: string | null\n}\n\n/**\n * AsyncLocalStorage for server-side demo mode context\n * This allows Server Components to access demo mode state\n */\nexport const demoContextStorage = new AsyncLocalStorage<ServerDemoContext>()\n\n/**\n * Get the current server-side demo context\n * Returns null if not in a demo context\n */\nexport function getServerDemoContext(): ServerDemoContext | null {\n  return demoContextStorage.getStore() ?? null\n}\n\n/**\n * Check if demo mode is enabled on the server\n */\nexport function isServerDemoMode(): boolean {\n  const context = getServerDemoContext()\n  return context?.enabled ?? false\n}\n\n/**\n * Get the current scenario on the server\n */\nexport function getServerScenario(): string | null {\n  const context = getServerDemoContext()\n  return context?.scenario ?? null\n}\n\n/**\n * Run a function within a demo context\n */\nexport function runWithDemoContext<T>(\n  context: ServerDemoContext,\n  fn: () => T\n): T {\n  return demoContextStorage.run(context, fn)\n}\n","import {\n  createDemoInterceptor,\n  type FixtureMap,\n  type DemoInterceptor,\n  type RequestContext,\n} from '@demokit-ai/core'\nimport { isServerDemoMode, getServerScenario } from './context'\n\n/**\n * Configuration for server-side demo interceptor\n */\nexport interface ServerInterceptorConfig {\n  /**\n   * Base fixtures (always available)\n   */\n  fixtures: FixtureMap\n\n  /**\n   * Scenario-specific fixtures\n   */\n  scenarios?: Record<string, FixtureMap>\n\n  /**\n   * Base URL for relative URL parsing\n   */\n  baseUrl?: string\n}\n\n/**\n * Create a server-side demo interceptor\n *\n * This interceptor works with Server Components and API routes.\n * It uses AsyncLocalStorage to check demo mode state.\n *\n * @example\n * // lib/demo-interceptor.ts\n * import { createServerInterceptor } from '@demokit-ai/next/server'\n *\n * export const demoInterceptor = createServerInterceptor({\n *   fixtures: {\n *     'GET /api/users': () => [{ id: '1', name: 'Demo User' }],\n *   },\n *   scenarios: {\n *     'empty': { 'GET /api/users': () => [] },\n *   },\n * })\n *\n * // Enable in your app\n * demoInterceptor.enable()\n */\nexport function createServerInterceptor(config: ServerInterceptorConfig): DemoInterceptor {\n  const { fixtures, scenarios = {}, baseUrl } = config\n\n  // Merge fixtures based on current scenario\n  const getActiveFixtures = (): FixtureMap => {\n    const scenario = getServerScenario()\n    if (scenario && scenarios[scenario]) {\n      return { ...fixtures, ...scenarios[scenario] }\n    }\n    return fixtures\n  }\n\n  // Wrapper that checks server context before each request\n  const wrappedFixtures: FixtureMap = new Proxy(fixtures, {\n    get(target, prop: string) {\n      const activeFixtures = getActiveFixtures()\n      return activeFixtures[prop]\n    },\n    ownKeys() {\n      const activeFixtures = getActiveFixtures()\n      return Reflect.ownKeys(activeFixtures)\n    },\n    getOwnPropertyDescriptor(target, prop) {\n      const activeFixtures = getActiveFixtures()\n      if (prop in activeFixtures) {\n        return {\n          configurable: true,\n          enumerable: true,\n          value: activeFixtures[prop as string],\n        }\n      }\n      return undefined\n    },\n  })\n\n  return createDemoInterceptor({\n    fixtures: wrappedFixtures,\n    baseUrl,\n    // Server-side storage is not used (we use cookies/headers)\n    storageKey: undefined,\n  })\n}\n\n/**\n * Helper to wrap a fixture handler with demo mode check\n */\nexport function withDemoCheck<T>(\n  handler: (context: RequestContext) => T | Promise<T>,\n  fallback?: () => T | Promise<T>\n): (context: RequestContext) => T | Promise<T> {\n  return async (context) => {\n    if (!isServerDemoMode()) {\n      if (fallback) {\n        return fallback()\n      }\n      throw new Error('[DemoKit] Demo mode is not enabled')\n    }\n    return handler(context)\n  }\n}\n","import { NextRequest, NextResponse } from 'next/server'\nimport type { DemoMiddlewareConfig, MiddlewareResult } from '../types'\n\nconst DEFAULT_CONFIG: Required<DemoMiddlewareConfig> = {\n  cookieName: 'demokit-mode',\n  urlParam: 'demo',\n  headerName: 'x-demokit-mode',\n  apiPaths: ['/api/'],\n  cookieOptions: {\n    maxAge: 60 * 60 * 24 * 7, // 1 week\n    path: '/',\n    sameSite: 'lax',\n    secure: process.env.NODE_ENV === 'production',\n  },\n}\n\n/**\n * Create a demo-aware middleware\n *\n * This middleware:\n * 1. Checks for demo mode URL parameter (?demo=true or ?demo=false)\n * 2. Sets/clears demo mode cookie\n * 3. Adds demo mode header to API requests\n * 4. Supports scenario switching via ?demo=scenario-name\n *\n * @example\n * // middleware.ts\n * import { createDemoMiddleware } from '@demokit-ai/next/middleware'\n *\n * const demoMiddleware = createDemoMiddleware()\n *\n * export function middleware(request: NextRequest) {\n *   return demoMiddleware(request)\n * }\n *\n * export const config = {\n *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],\n * }\n */\nexport function createDemoMiddleware(config: DemoMiddlewareConfig = {}) {\n  const mergedConfig = { ...DEFAULT_CONFIG, ...config }\n  const { cookieName, urlParam, headerName, apiPaths, cookieOptions } = mergedConfig\n\n  return function demoMiddleware(request: NextRequest): MiddlewareResult {\n    // Check for demo mode in URL param\n    const demoParam = request.nextUrl.searchParams.get(urlParam)\n\n    // Check for existing cookie\n    const demoCookie = request.cookies.get(cookieName)\n\n    let response = NextResponse.next()\n    let isDemoMode = false\n    let scenario: string | null = null\n\n    // Handle URL param toggle\n    if (demoParam !== null) {\n      if (demoParam === 'false' || demoParam === '0' || demoParam === '') {\n        // Disable demo mode\n        response = NextResponse.next()\n        response.cookies.delete(cookieName)\n        isDemoMode = false\n      } else if (demoParam === 'true' || demoParam === '1') {\n        // Enable demo mode (no scenario)\n        response = NextResponse.next()\n        response.cookies.set(cookieName, 'true', cookieOptions)\n        isDemoMode = true\n      } else {\n        // Enable with specific scenario\n        response = NextResponse.next()\n        response.cookies.set(cookieName, demoParam, cookieOptions)\n        isDemoMode = true\n        scenario = demoParam\n      }\n    } else if (demoCookie) {\n      // Use existing cookie\n      isDemoMode = true\n      scenario = demoCookie.value !== 'true' ? demoCookie.value : null\n    }\n\n    // Add header for API routes\n    if (isDemoMode) {\n      const isApiRoute = apiPaths.some((path) =>\n        request.nextUrl.pathname.startsWith(path)\n      )\n\n      if (isApiRoute) {\n        const requestHeaders = new Headers(request.headers)\n        requestHeaders.set(headerName, scenario ?? 'true')\n\n        response = NextResponse.next({\n          request: {\n            headers: requestHeaders,\n          },\n        })\n\n        // Re-set cookie if we created new response\n        if (demoParam !== null) {\n          if (demoParam === 'false' || demoParam === '0' || demoParam === '') {\n            response.cookies.delete(cookieName)\n          } else {\n            response.cookies.set(\n              cookieName,\n              demoParam === 'true' || demoParam === '1' ? 'true' : demoParam,\n              cookieOptions\n            )\n          }\n        }\n      }\n    }\n\n    return {\n      isDemoMode,\n      scenario,\n      response,\n    }\n  }\n}\n\n/**\n * Simple middleware wrapper that just returns the response\n *\n * @example\n * import { demoMiddleware } from '@demokit-ai/next/middleware'\n * export const middleware = demoMiddleware()\n */\nexport function demoMiddleware(config: DemoMiddlewareConfig = {}) {\n  const handler = createDemoMiddleware(config)\n\n  return function middleware(request: NextRequest): NextResponse {\n    return handler(request).response\n  }\n}\n\n/**\n * Check if a request is in demo mode (from middleware or direct header check)\n */\nexport function isDemoRequest(request: NextRequest, config: DemoMiddlewareConfig = {}): boolean {\n  const { cookieName = 'demokit-mode', headerName = 'x-demokit-mode' } = config\n\n  // Check header first (set by middleware)\n  if (request.headers.get(headerName)) {\n    return true\n  }\n\n  // Check cookie\n  const cookie = request.cookies.get(cookieName)\n  return cookie !== undefined && cookie.value !== ''\n}\n\n/**\n * Get the demo scenario from a request\n */\nexport function getDemoScenario(request: NextRequest, config: DemoMiddlewareConfig = {}): string | null {\n  const { cookieName = 'demokit-mode', headerName = 'x-demokit-mode' } = config\n\n  // Check header first\n  const headerValue = request.headers.get(headerName)\n  if (headerValue && headerValue !== 'true') {\n    return headerValue\n  }\n\n  // Check cookie\n  const cookie = request.cookies.get(cookieName)\n  if (cookie && cookie.value !== 'true') {\n    return cookie.value\n  }\n\n  return null\n}\n"]}