@demokit-ai/next 0.2.0 → 0.4.0

package/dist/server.js

@@ -1,8 +1,12 @@
-import { AsyncLocalStorage } from 'async_hooks';
-import { createDemoInterceptor } from '@demokit-ai/core';
-import { NextResponse } from 'next/server';
+import {
+  createDemoMiddleware,
+  demoMiddleware,
+  getDemoScenario,
+  isDemoRequest
+} from "./chunk-YLBNVWMI.js";
 
 // src/server/context.ts
+import { AsyncLocalStorage } from "async_hooks";
 var demoContextStorage = new AsyncLocalStorage();
 function getServerDemoContext() {
   return demoContextStorage.getStore() ?? null;
@@ -18,6 +22,11 @@ function getServerScenario() {
 function runWithDemoContext(context, fn) {
   return demoContextStorage.run(context, fn);
 }
+
+// src/server/interceptor.ts
+import {
+  createDemoInterceptor
+} from "@demokit-ai/core";
 function createServerInterceptor(config) {
   const { fixtures, scenarios = {}, baseUrl } = config;
   const getActiveFixtures = () => {
@@ -66,106 +75,17 @@ function withDemoCheck(handler, fallback) {
     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"
-  }
+export {
+  createDemoMiddleware,
+  createServerInterceptor,
+  demoContextStorage,
+  demoMiddleware,
+  getDemoScenario,
+  getServerDemoContext,
+  getServerScenario,
+  isDemoRequest,
+  isServerDemoMode,
+  runWithDemoContext,
+  withDemoCheck
 };
-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

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/context.ts","../src/server/interceptor.ts","../src/server/middleware.ts"],"names":["demoMiddleware"],"mappings":"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","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"]}
+{"version":3,"sources":["../src/server/context.ts","../src/server/interceptor.ts"],"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"],"mappings":";;;;;;;;AAAA,SAAS,yBAAyB;AAqB3B,IAAM,qBAAqB,IAAI,kBAAqC;AAMpE,SAAS,uBAAiD;AAC/D,SAAO,mBAAmB,SAAS,KAAK;AAC1C;AAKO,SAAS,mBAA4B;AAC1C,QAAM,UAAU,qBAAqB;AACrC,SAAO,SAAS,WAAW;AAC7B;AAKO,SAAS,oBAAmC;AACjD,QAAM,UAAU,qBAAqB;AACrC,SAAO,SAAS,YAAY;AAC9B;AAKO,SAAS,mBACd,SACA,IACG;AACH,SAAO,mBAAmB,IAAI,SAAS,EAAE;AAC3C;;;ACvDA;AAAA,EACE;AAAA,OAIK;AA6CA,SAAS,wBAAwB,QAAkD;AACxF,QAAM,EAAE,UAAU,YAAY,CAAC,GAAG,QAAQ,IAAI;AAG9C,QAAM,oBAAoB,MAAkB;AAC1C,UAAM,WAAW,kBAAkB;AACnC,QAAI,YAAY,UAAU,QAAQ,GAAG;AACnC,aAAO,EAAE,GAAG,UAAU,GAAG,UAAU,QAAQ,EAAE;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAGA,QAAM,kBAA8B,IAAI,MAAM,UAAU;AAAA,IACtD,IAAI,QAAQ,MAAc;AACxB,YAAM,iBAAiB,kBAAkB;AACzC,aAAO,eAAe,IAAI;AAAA,IAC5B;AAAA,IACA,UAAU;AACR,YAAM,iBAAiB,kBAAkB;AACzC,aAAO,QAAQ,QAAQ,cAAc;AAAA,IACvC;AAAA,IACA,yBAAyB,QAAQ,MAAM;AACrC,YAAM,iBAAiB,kBAAkB;AACzC,UAAI,QAAQ,gBAAgB;AAC1B,eAAO;AAAA,UACL,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,OAAO,eAAe,IAAc;AAAA,QACtC;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AAED,SAAO,sBAAsB;AAAA,IAC3B,UAAU;AAAA,IACV;AAAA;AAAA,IAEA,YAAY;AAAA,EACd,CAAC;AACH;AAKO,SAAS,cACd,SACA,UAC6C;AAC7C,SAAO,OAAO,YAAY;AACxB,QAAI,CAAC,iBAAiB,GAAG;AACvB,UAAI,UAAU;AACZ,eAAO,SAAS;AAAA,MAClB;AACA,YAAM,IAAI,MAAM,oCAAoC;AAAA,IACtD;AACA,WAAO,QAAQ,OAAO;AAAA,EACxB;AACF;","names":[]}

package/dist/{types-Cvq5JUP1.d.cts → types-Brt8EaFz.d.cts}

@@ -48,6 +48,11 @@ interface DemoKitNextProviderProps extends DemoKitNextConfig {
      * If not provided, will read from cookie/localStorage
      */
     initialEnabled?: boolean;
+    /**
+     * Remote source configuration for fetching fixtures from DemoKit Cloud
+     * Create using createRemoteSource()
+     */
+    source?: RemoteSourceConfig;
 }
 /**
  * Configuration for createDemoMiddleware
@@ -125,5 +130,37 @@ type DefineFixtures<T extends Record<string, FixtureHandler>> = T;
  * Helper type for defining scenarios with type safety
  */
 type DefineScenarios<T extends Record<string, FixtureMap>> = T;
+/**
+ * Configuration for remote fixture source (DemoKit Cloud)
+ */
+interface RemoteSourceConfig {
+    /**
+     * DemoKit Cloud API URL (versioned base URL)
+     * The SDK will append `/fixtures` to this URL.
+     * @example 'https://demokit-cloud.kasava.dev/api'
+     * @default 'https://api.demokit.cloud/api'
+     */
+    apiUrl: string;
+    /**
+     * DemoKit Cloud API key
+     * Format: dk_live_xxx
+     */
+    apiKey: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Whether to retry failed requests
+     * @default true
+     */
+    retry?: boolean;
+    /**
+     * Maximum number of retries
+     * @default 3
+     */
+    maxRetries?: number;
+}
 
-export type { DemoScenario as D, MiddlewareResult as M, DemoKitNextConfig as a, DemoKitNextProviderProps as b, DemoMiddlewareConfig as c, DefineFixtures as d, DefineScenarios as e };
+export type { DemoScenario as D, MiddlewareResult as M, RemoteSourceConfig as R, DemoKitNextConfig as a, DemoKitNextProviderProps as b, DemoMiddlewareConfig as c, DefineFixtures as d, DefineScenarios as e };

package/dist/{types-Cvq5JUP1.d.ts → types-Brt8EaFz.d.ts}

@@ -48,6 +48,11 @@ interface DemoKitNextProviderProps extends DemoKitNextConfig {
      * If not provided, will read from cookie/localStorage
      */
     initialEnabled?: boolean;
+    /**
+     * Remote source configuration for fetching fixtures from DemoKit Cloud
+     * Create using createRemoteSource()
+     */
+    source?: RemoteSourceConfig;
 }
 /**
  * Configuration for createDemoMiddleware
@@ -125,5 +130,37 @@ type DefineFixtures<T extends Record<string, FixtureHandler>> = T;
  * Helper type for defining scenarios with type safety
  */
 type DefineScenarios<T extends Record<string, FixtureMap>> = T;
+/**
+ * Configuration for remote fixture source (DemoKit Cloud)
+ */
+interface RemoteSourceConfig {
+    /**
+     * DemoKit Cloud API URL (versioned base URL)
+     * The SDK will append `/fixtures` to this URL.
+     * @example 'https://demokit-cloud.kasava.dev/api'
+     * @default 'https://api.demokit.cloud/api'
+     */
+    apiUrl: string;
+    /**
+     * DemoKit Cloud API key
+     * Format: dk_live_xxx
+     */
+    apiKey: string;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Whether to retry failed requests
+     * @default true
+     */
+    retry?: boolean;
+    /**
+     * Maximum number of retries
+     * @default 3
+     */
+    maxRetries?: number;
+}
 
-export type { DemoScenario as D, MiddlewareResult as M, DemoKitNextConfig as a, DemoKitNextProviderProps as b, DemoMiddlewareConfig as c, DefineFixtures as d, DefineScenarios as e };
+export type { DemoScenario as D, MiddlewareResult as M, RemoteSourceConfig as R, DemoKitNextConfig as a, DemoKitNextProviderProps as b, DemoMiddlewareConfig as c, DefineFixtures as d, DefineScenarios as e };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demokit-ai/next",
-  "version": "0.2.0",
-  "description": "Next.js adapter for DemoKit - App Router, middleware, and API route mocking",
+  "version": "0.4.0",
+  "description": "Next.js adapter for DemoKit - SSR support and middleware",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -51,44 +51,31 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
-    "@demokit-ai/core": "*",
-    "@demokit-ai/react": "*"
+    "@demokit-ai/react": "0.4.0",
+    "@demokit-ai/core": "0.4.0"
   },
   "devDependencies": {
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "next": "^15.1.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2"
   },
   "peerDependencies": {
-    "next": ">=13.0.0",
-    "react": ">=17.0.0",
-    "react-dom": ">=17.0.0"
+    "next": ">=15.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
   },
-  "keywords": [
-    "demo",
-    "mock",
-    "next.js",
-    "app-router",
-    "middleware",
-    "fixtures"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/your-org/demokit",
-    "directory": "packages/next"
+  "engines": {
+    "node": ">=18"
   },
-  "sideEffects": false
-}
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --no-dts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/README.md

@@ -1,193 +0,0 @@
-# @demokit-ai/next
-
-![Tests](https://img.shields.io/badge/tests-130%20passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-7%25-red)
-
-Next.js adapter for DemoKit - App Router, middleware, and API route mocking for demo mode.
-
-## Installation
-
-```bash
-npm install @demokit-ai/next @demokit-ai/core @demokit-ai/react
-```
-
-## Features
-
-- Demo-aware middleware for URL parameter and cookie handling
-- Server-side demo context with AsyncLocalStorage
-- Client-side hooks for demo mode state
-- API route interceptors for fixture responses
-- Scenario-based demo configurations
-- Full TypeScript support
-
-## Usage
-
-### Middleware Setup
-
-Add demo mode detection to your middleware:
-
-```ts
-// middleware.ts
-import { createDemoMiddleware } from '@demokit-ai/next/middleware'
-
-export const middleware = createDemoMiddleware({
-  cookieName: 'demo-mode',
-  paramName: 'demo',
-  scenarios: {
-    default: { users: 'standard' },
-    enterprise: { users: 'enterprise', features: 'all' },
-  },
-})
-
-export const config = {
-  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
-}
-```
-
-### Server Components
-
-Access demo mode in Server Components:
-
-```tsx
-// app/users/page.tsx
-import { getServerDemoContext, isServerDemoMode } from '@demokit-ai/next/server'
-
-export default async function UsersPage() {
-  const isDemo = isServerDemoMode()
-  const context = getServerDemoContext()
-
-  if (isDemo) {
-    return <UserList users={context.fixtures.users} />
-  }
-
-  const users = await fetchRealUsers()
-  return <UserList users={users} />
-}
-```
-
-### Client Components
-
-Use the client-side hook:
-
-```tsx
-'use client'
-import { useNextDemoMode } from '@demokit-ai/next/client'
-
-export function DemoToggle() {
-  const { enabled, toggle, scenario, setScenario } = useNextDemoMode()
-
-  return (
-    <div>
-      <button onClick={toggle}>
-        Demo: {enabled ? 'ON' : 'OFF'}
-      </button>
-      {enabled && (
-        <select value={scenario} onChange={(e) => setScenario(e.target.value)}>
-          <option value="default">Default</option>
-          <option value="enterprise">Enterprise</option>
-        </select>
-      )}
-    </div>
-  )
-}
-```
-
-### API Route Interception
-
-Create demo-aware API routes:
-
-```ts
-// app/api/users/route.ts
-import { createServerInterceptor } from '@demokit-ai/next/server'
-
-const interceptor = createServerInterceptor({
-  fixtures: {
-    GET: [
-      { id: '1', name: 'Demo User' },
-      { id: '2', name: 'Another User' },
-    ],
-    POST: (request) => ({
-      id: '3',
-      name: request.body.name,
-      created: true,
-    }),
-  },
-})
-
-export async function GET(request: Request) {
-  return interceptor(request, async () => {
-    // Real implementation
-    const users = await db.users.findMany()
-    return Response.json(users)
-  })
-}
-```
-
-### Configuration
-
-Define demo scenarios and fixtures:
-
-```ts
-// demo.config.ts
-import { createDemoConfig, defineFixtures, defineScenarios } from '@demokit-ai/next'
-
-export const demoConfig = createDemoConfig({
-  fixtures: defineFixtures({
-    users: [
-      { id: '1', name: 'Demo User', plan: 'free' },
-      { id: '2', name: 'Pro User', plan: 'pro' },
-    ],
-    products: [
-      { id: '1', name: 'Widget', price: 9.99 },
-    ],
-  }),
-  scenarios: defineScenarios({
-    default: {},
-    enterprise: {
-      users: [
-        { id: '1', name: 'Enterprise User', plan: 'enterprise' },
-      ],
-    },
-  }),
-})
-```
-
-## API Reference
-
-### Middleware
-
-#### `createDemoMiddleware(options)`
-
-Options:
-- `cookieName` - Cookie name for demo state (default: 'demo-mode')
-- `paramName` - URL parameter for demo activation (default: 'demo')
-- `scenarios` - Scenario configurations
-- `defaultScenario` - Default scenario name
-
-### Server
-
-#### `isServerDemoMode()`
-
-Returns `true` if demo mode is active in the current request.
-
-#### `getServerDemoContext()`
-
-Returns the demo context including fixtures and scenario.
-
-#### `createServerInterceptor(options)`
-
-Creates an interceptor for API routes.
-
-### Client
-
-#### `useNextDemoMode()`
-
-Returns:
-- `enabled` - Demo mode state
-- `toggle()` - Toggle demo mode
-- `scenario` - Current scenario
-- `setScenario(name)` - Switch scenario
-
-## License
-
-MIT