@demokit-ai/core 0.3.0 → 0.5.0

package/dist/index.cjs

@@ -332,6 +332,26 @@ function extractUrl(input, baseUrl) {
   }
   return baseUrl;
 }
+function detectDemoMode(detection) {
+  if (!detection || typeof window === "undefined") {
+    return { detected: false, isPublicDemo: false };
+  }
+  if (detection.subdomains?.length) {
+    const hostname = window.location.hostname;
+    if (detection.subdomains.some((sub) => hostname === sub)) {
+      return { detected: true, isPublicDemo: true };
+    }
+  }
+  const queryParams = detection.queryParams ?? ["demo"];
+  const searchParams = new URLSearchParams(window.location.search);
+  for (const param of queryParams) {
+    const value = searchParams.get(param);
+    if (value !== null && value !== "false") {
+      return { detected: true, isPublicDemo: false };
+    }
+  }
+  return { detected: false, isPublicDemo: false };
+}
 function createDemoInterceptor(config) {
   const {
     fixtures: initialFixtures,
@@ -339,9 +359,15 @@ function createDemoInterceptor(config) {
     onEnable,
     onDisable,
     initialEnabled,
-    baseUrl = "http://localhost"
+    baseUrl = "http://localhost",
+    detection,
+    canDisable,
+    onMutationIntercepted,
+    pathAliases,
+    warnOnCatchAll = typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
   } = config;
-  let enabled = initialEnabled ?? loadDemoState(storageKey);
+  const detectionResult = detectDemoMode(detection);
+  let enabled = detectionResult.detected || (initialEnabled ?? loadDemoState(storageKey));
   let currentFixtures = { ...initialFixtures };
   let sessionState = createSessionState();
   let originalFetch = null;
@@ -357,11 +383,25 @@ function createDemoInterceptor(config) {
       }
       const method = init?.method?.toUpperCase() || "GET";
       const pathname = extractPathname(input, baseUrl);
-      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) {
         return originalFetch(input, init);
       }
       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);
@@ -381,6 +421,14 @@ function createDemoInterceptor(config) {
         headers,
         session: sessionState
       };
+      if (method !== "GET" && onMutationIntercepted) {
+        onMutationIntercepted({
+          url,
+          method,
+          params: matchResult.params,
+          pattern
+        });
+      }
       let result;
       try {
         if (typeof handler === "function") {
@@ -416,14 +464,24 @@ function createDemoInterceptor(config) {
       onEnable?.();
     },
     disable() {
-      if (!enabled) return;
+      if (!enabled) return true;
+      if (canDisable) {
+        const result = canDisable();
+        if (result !== true) {
+          return result;
+        }
+      }
       enabled = false;
       saveDemoState(storageKey, false);
       onDisable?.();
+      return true;
     },
     isEnabled() {
       return enabled;
     },
+    isPublicDemo() {
+      return detectionResult.isPublicDemo;
+    },
     toggle() {
       if (enabled) {
         this.disable();
@@ -526,7 +584,8 @@ function createDemoStateStore(options = {}) {
 }
 
 // src/remote.ts
-var DEFAULT_CLOUD_URL = "https://api.demokit.cloud";
+var DEFAULT_API_URL = "https://api.demokit.cloud/api";
+var DEFAULT_CLOUD_URL = DEFAULT_API_URL;
 var DEFAULT_TIMEOUT = 1e4;
 var DEFAULT_MAX_RETRIES = 3;
 function isValidApiKey(apiKey) {
@@ -549,13 +608,16 @@ function getBackoffDelay(attempt, baseDelay = 1e3) {
 async function fetchCloudFixtures(config) {
   const {
     apiKey,
-    cloudUrl = DEFAULT_CLOUD_URL,
+    apiUrl,
+    cloudUrl,
+    // deprecated, for backwards compatibility
     onError,
     onLoad,
     timeout = DEFAULT_TIMEOUT,
     retry = true,
     maxRetries = DEFAULT_MAX_RETRIES
   } = config;
+  const baseUrl = apiUrl || cloudUrl || DEFAULT_API_URL;
   if (!isValidApiKey(apiKey)) {
     const error = new RemoteFetchError(
       "Invalid API key format. Expected format: dk_live_xxx",
@@ -565,7 +627,7 @@ async function fetchCloudFixtures(config) {
     onError?.(error);
     throw error;
   }
-  const url = `${cloudUrl.replace(/\/$/, "")}/api/v1/fixtures`;
+  const url = `${baseUrl.replace(/\/$/, "")}/fixtures`;
   let lastError = null;
   const maxAttempts = retry ? maxRetries : 1;
   for (let attempt = 0; attempt < maxAttempts; attempt++) {
@@ -6849,6 +6911,7 @@ function getRequiredFieldRules(rules) {
   return rules.filter((rule) => rule.required);
 }
 
+exports.DEFAULT_API_URL = DEFAULT_API_URL;
 exports.DEFAULT_CLOUD_URL = DEFAULT_CLOUD_URL;
 exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES;
 exports.DEFAULT_STORAGE_KEY = DEFAULT_STORAGE_KEY;