@nextsparkjs/core 0.1.0-beta.177 → 0.1.0-beta.178

package/dist/components/devtools/MarkdownViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownViewer.d.ts","sourceRoot":"","sources":["../../../src/components/devtools/MarkdownViewer.tsx"],"names":[],"mappings":"AAQA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,mBAAmB,2CA2CzE"}
+{"version":3,"file":"MarkdownViewer.d.ts","sourceRoot":"","sources":["../../../src/components/devtools/MarkdownViewer.tsx"],"names":[],"mappings":"AASA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,mBAAmB,2CAgDzE"}

package/dist/components/devtools/MarkdownViewer.js

@@ -5,6 +5,7 @@ import remarkGfm from "remark-gfm";
 import { useEffect, useState, memo } from "react";
 import { codeToHtml } from "shiki";
 import { cn } from "../../lib/utils/index.js";
+import { MermaidDiagram } from "../docs/mermaid-diagram.js";
 const ShikiCodeBlock = memo(function ShikiCodeBlock2({
   code,
   language
@@ -72,6 +73,10 @@ function MarkdownViewer({ content, className }) {
               const match = /language-(\w+)/.exec(className2 || "");
               const language = match ? match[1] : "";
               const isInline = !match;
+              if (!isInline && language === "mermaid") {
+                const chart = String(children).replace(/\n$/, "");
+                return /* @__PURE__ */ jsx(MermaidDiagram, { chart });
+              }
               if (!isInline && language) {
                 const code = String(children).replace(/\n$/, "");
                 return /* @__PURE__ */ jsx(ShikiCodeBlock, { code, language });

package/dist/components/devtools/api-explorer/ApiDocsModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiDocsModal.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiDocsModal.tsx"],"names":[],"mappings":"AAeA,UAAU,iBAAiB;IACzB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,2CAwEjE"}
+{"version":3,"file":"ApiDocsModal.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiDocsModal.tsx"],"names":[],"mappings":"AAgBA,UAAU,iBAAiB;IACzB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,2CAwEjE"}

package/dist/components/devtools/api-explorer/ApiEndpointsSidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiEndpointsSidebar.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiEndpointsSidebar.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AA4CrD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;CACnB;AAED,UAAU,wBAAwB;IAChC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAA;IAC9C,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACzC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAClF,WAAW,EAAE,OAAO,CAAA;IACpB,gBAAgB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,EAAE,wBAAwB,2CAoP1B"}
+{"version":3,"file":"ApiEndpointsSidebar.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiEndpointsSidebar.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AA4CrD,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;CACnB;AAED,UAAU,wBAAwB;IAChC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAA;IAC9C,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACzC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAClF,WAAW,EAAE,OAAO,CAAA;IACpB,gBAAgB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,EAAE,wBAAwB,2CAkQ1B"}

package/dist/components/devtools/api-explorer/ApiEndpointsSidebar.js

@@ -1,7 +1,8 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { useState, useMemo } from "react";
+import { useState, useMemo, useEffect } from "react";
 import { Search, ChevronRight, ChevronDown, Code, Database, Layers, Puzzle, PanelLeftClose, PanelLeft, Folder, FolderOpen } from "lucide-react";
+import { loadState, saveState } from "./explorer-storage.js";
 import { Input } from "../../ui/input.js";
 import { Badge } from "../../ui/badge.js";
 import { Button } from "../../ui/button.js";
@@ -43,10 +44,20 @@ function ApiEndpointsSidebar({
   onToggleCollapse
 }) {
   const [searchQuery, setSearchQuery] = useState("");
-  const [expandedCategories, setExpandedCategories] = useState(
-    /* @__PURE__ */ new Set(["core", "entity", "theme", "plugin"])
-  );
-  const [expandedPrefixes, setExpandedPrefixes] = useState(/* @__PURE__ */ new Set());
+  const [expandedCategories, setExpandedCategories] = useState(() => {
+    const saved = loadState("sidebar:expandedCategories");
+    return new Set(saved ?? ["core", "entity", "theme", "plugin"]);
+  });
+  const [expandedPrefixes, setExpandedPrefixes] = useState(() => {
+    const saved = loadState("sidebar:expandedPrefixes");
+    return new Set(saved ?? []);
+  });
+  useEffect(() => {
+    saveState("sidebar:expandedCategories", Array.from(expandedCategories));
+  }, [expandedCategories]);
+  useEffect(() => {
+    saveState("sidebar:expandedPrefixes", Array.from(expandedPrefixes));
+  }, [expandedPrefixes]);
   const filteredRoutes = useMemo(() => {
     if (!searchQuery.trim()) return routes;
     const query = searchQuery.toLowerCase();

package/dist/components/devtools/api-explorer/ApiExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiExplorer.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiExplorer.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAY5F,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAA;IAC9C,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC1D;AAwBD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,gBAAgB,2CAwXxE"}
+{"version":3,"file":"ApiExplorer.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiExplorer.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAqB5F,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAA;IAC9C,eAAe,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC1D;AAwBD,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,gBAAgB,2CAibxE"}

package/dist/components/devtools/api-explorer/ApiExplorer.js

@@ -13,6 +13,7 @@ import { useApiExplorerNavigation } from "../../../hooks/useApiExplorerNavigatio
 import { extractPathParams, buildUrl } from "../api-tester/utils/url-builder.js";
 import { ApiPresetsService } from "../../../lib/services/api-presets.service.js";
 import { ApiDocsService } from "../../../lib/services/api-docs.service.js";
+import { loadState, saveState, draftKey } from "./explorer-storage.js";
 function findRouteByPath(routes, path) {
   for (const category of Object.keys(routes)) {
     const found = routes[category].find((r) => r.path === path);
@@ -29,23 +30,26 @@ function createEmptyRows(count = 2) {
   }));
 }
 function ApiExplorer({ routes, initialEndpoint }) {
-  const [isCollapsed, setIsCollapsed] = useState(false);
+  const [isCollapsed, setIsCollapsed] = useState(() => loadState("sidebarCollapsed") ?? false);
   const [mobileOpen, setMobileOpen] = useState(false);
   const [selectedEndpoint, setSelectedEndpoint] = useState(null);
   const [method, setMethod] = useState("GET");
   const [pathParams, setPathParams] = useState([]);
   const [queryParams, setQueryParams] = useState(() => createEmptyRows());
   const [headers, setHeaders] = useState(() => createEmptyRows());
-  const [authType, setAuthType] = useState("session");
-  const [apiKey, setApiKey] = useState("");
-  const [bypassMode, setBypassMode] = useState(false);
+  const [authType, setAuthType] = useState(() => loadState("authType") ?? "session");
+  const [apiKey, setApiKey] = useState(() => loadState("apiKey") ?? "");
+  const [bypassMode, setBypassMode] = useState(() => loadState("bypassMode") ?? false);
   const [selectedTeamId, setSelectedTeamId] = useState(() => {
+    const saved = loadState("selectedTeamId");
+    if (saved) return saved;
     if (typeof window !== "undefined") {
       return localStorage.getItem("activeTeamId");
     }
     return null;
   });
   const [body, setBody] = useState("");
+  const [actAsUserId, setActAsUserId] = useState(() => loadState("actAsUserId") ?? "");
   const [tabsModifiedByPreset, setTabsModifiedByPreset] = useState(
     () => /* @__PURE__ */ new Set()
   );
@@ -60,20 +64,35 @@ function ApiExplorer({ routes, initialEndpoint }) {
   const hasInitialized = useRef(false);
   const { status, response, error, execute, cancel, reset } = useApiRequest();
   const { selectedMethod: urlMethod, selectedPath: urlPath, navigateToEndpoint } = useApiExplorerNavigation({ basePath: "/devtools/api" });
+  const applyEndpointState = useCallback((endpointMethod, path) => {
+    const draft = loadState(draftKey(endpointMethod, path));
+    setPathParams((draft == null ? void 0 : draft.pathParams) ?? extractPathParams(path));
+    setQueryParams((draft == null ? void 0 : draft.queryParams) ?? createEmptyRows());
+    setHeaders((draft == null ? void 0 : draft.headers) ?? createEmptyRows());
+    setBody((draft == null ? void 0 : draft.body) ?? "");
+    setTabsModifiedByPreset(/* @__PURE__ */ new Set());
+  }, []);
+  useEffect(() => {
+    saveState("authType", authType);
+    saveState("apiKey", apiKey);
+    saveState("bypassMode", bypassMode);
+    saveState("selectedTeamId", selectedTeamId);
+    saveState("actAsUserId", actAsUserId);
+  }, [authType, apiKey, bypassMode, selectedTeamId, actAsUserId]);
+  useEffect(() => {
+    saveState("sidebarCollapsed", isCollapsed);
+  }, [isCollapsed]);
   const handleSelectEndpoint = useCallback(
     (path, selectedMethod, route) => {
       reset();
       navigateToEndpoint(selectedMethod, path);
       setSelectedEndpoint({ path, method: selectedMethod, route });
       setMethod(selectedMethod);
-      setPathParams(extractPathParams(path));
-      setQueryParams(createEmptyRows());
-      setHeaders(createEmptyRows());
-      setBody("");
-      setTabsModifiedByPreset(/* @__PURE__ */ new Set());
+      applyEndpointState(selectedMethod, path);
+      saveState("lastEndpoint", { method: selectedMethod, path });
       setMobileOpen(false);
     },
-    [reset, navigateToEndpoint]
+    [reset, navigateToEndpoint, applyEndpointState]
   );
   const handleSend = useCallback(async () => {
     if (!selectedEndpoint) return;
@@ -90,6 +109,9 @@ function ApiExplorer({ routes, initialEndpoint }) {
         customHeaders["x-team-id"] = selectedTeamId;
       }
     }
+    if (actAsUserId.trim()) {
+      customHeaders["x-act-as-user"] = actAsUserId.trim();
+    }
     for (const h of headers) {
       if (h.enabled && h.key) {
         customHeaders[h.key] = h.value;
@@ -103,7 +125,7 @@ function ApiExplorer({ routes, initialEndpoint }) {
       authType,
       apiKey: authType === "apiKey" ? apiKey : void 0
     });
-  }, [selectedEndpoint, pathParams, queryParams, headers, method, body, authType, apiKey, bypassMode, selectedTeamId, execute]);
+  }, [selectedEndpoint, pathParams, queryParams, headers, method, body, authType, apiKey, bypassMode, selectedTeamId, actAsUserId, execute]);
   const handleApplyPreset = useCallback((preset) => {
     const modifiedTabs = /* @__PURE__ */ new Set();
     if (preset.method) {
@@ -168,14 +190,19 @@ function ApiExplorer({ routes, initialEndpoint }) {
       if (route && ((selectedEndpoint == null ? void 0 : selectedEndpoint.path) !== urlPath || (selectedEndpoint == null ? void 0 : selectedEndpoint.method) !== urlMethod)) {
         setSelectedEndpoint({ path: urlPath, method: urlMethod, route });
         setMethod(urlMethod);
-        setPathParams(extractPathParams(urlPath));
-        setQueryParams(createEmptyRows());
-        setHeaders(createEmptyRows());
-        setBody("");
-        setTabsModifiedByPreset(/* @__PURE__ */ new Set());
+        applyEndpointState(urlMethod, urlPath);
       }
     }
-  }, [urlPath, urlMethod, routes, selectedEndpoint]);
+  }, [urlPath, urlMethod, routes, selectedEndpoint, applyEndpointState]);
+  useEffect(() => {
+    if (!selectedEndpoint) return;
+    saveState(draftKey(selectedEndpoint.method, selectedEndpoint.path), {
+      pathParams,
+      queryParams,
+      headers,
+      body
+    });
+  }, [selectedEndpoint, pathParams, queryParams, headers, body]);
   useEffect(() => {
     if (hasInitialized.current) return;
     if (urlPath && urlMethod) {
@@ -184,7 +211,7 @@ function ApiExplorer({ routes, initialEndpoint }) {
         hasInitialized.current = true;
         setSelectedEndpoint({ path: urlPath, method: urlMethod, route });
         setMethod(urlMethod);
-        setPathParams(extractPathParams(urlPath));
+        applyEndpointState(urlMethod, urlPath);
         return;
       }
     }
@@ -195,13 +222,26 @@ function ApiExplorer({ routes, initialEndpoint }) {
         const endpointMethod = initialEndpoint.method;
         setSelectedEndpoint({ path: initialEndpoint.path, method: endpointMethod, route });
         setMethod(endpointMethod);
-        setPathParams(extractPathParams(initialEndpoint.path));
+        applyEndpointState(endpointMethod, initialEndpoint.path);
         if (!urlPath) {
           navigateToEndpoint(endpointMethod, initialEndpoint.path);
         }
         return;
       }
     }
+    const last = loadState("lastEndpoint");
+    if (last) {
+      const route = findRouteByPath(routes, last.path);
+      if (route) {
+        hasInitialized.current = true;
+        const lastMethod = last.method;
+        setSelectedEndpoint({ path: last.path, method: lastMethod, route });
+        setMethod(lastMethod);
+        applyEndpointState(lastMethod, last.path);
+        navigateToEndpoint(lastMethod, last.path);
+        return;
+      }
+    }
     const categories = ["core", "entity", "theme", "plugin"];
     for (const category of categories) {
       const categoryRoutes = routes[category];
@@ -211,12 +251,12 @@ function ApiExplorer({ routes, initialEndpoint }) {
         const firstMethod = firstRoute.methods[0] || "GET";
         setSelectedEndpoint({ path: firstRoute.path, method: firstMethod, route: firstRoute });
         setMethod(firstMethod);
-        setPathParams(extractPathParams(firstRoute.path));
+        applyEndpointState(firstMethod, firstRoute.path);
         navigateToEndpoint(firstMethod, firstRoute.path);
         break;
       }
     }
-  }, [routes, initialEndpoint, urlPath, urlMethod, navigateToEndpoint]);
+  }, [routes, initialEndpoint, urlPath, urlMethod, navigateToEndpoint, applyEndpointState]);
   const totalRoutes = Object.values(routes).reduce((sum, arr) => sum + arr.length, 0);
   return /* @__PURE__ */ jsxs("div", { className: "flex h-[calc(100vh-4rem)] w-full overflow-hidden", "data-cy": sel("devtools.apiExplorer.container"), children: [
     /* @__PURE__ */ jsxs("div", { className: "lg:hidden fixed top-0 left-0 right-0 z-50 h-14 bg-background border-b flex items-center px-4 gap-3", children: [
@@ -281,6 +321,7 @@ function ApiExplorer({ routes, initialEndpoint }) {
           apiKey,
           bypassMode,
           selectedTeamId,
+          actAsUserId,
           body,
           status,
           onMethodChange: setMethod,
@@ -291,6 +332,7 @@ function ApiExplorer({ routes, initialEndpoint }) {
           onApiKeyChange: setApiKey,
           onBypassModeChange: setBypassMode,
           onTeamChange: setSelectedTeamId,
+          onActAsUserChange: setActAsUserId,
           onBodyChange: setBody,
           onSend: handleSend,
           onCancel: cancel,

package/dist/components/devtools/api-explorer/ApiRequestPanel.d.ts

@@ -12,6 +12,7 @@ interface ApiRequestPanelProps {
     apiKey: string;
     bypassMode: boolean;
     selectedTeamId: string | null;
+    actAsUserId: string;
     body: string;
     status: RequestStatus;
     onMethodChange: (method: HttpMethod) => void;
@@ -22,6 +23,7 @@ interface ApiRequestPanelProps {
     onApiKeyChange: (key: string) => void;
     onBypassModeChange: (enabled: boolean) => void;
     onTeamChange: (teamId: string | null) => void;
+    onActAsUserChange: (userId: string) => void;
     onBodyChange: (body: string) => void;
     onSend: () => void;
     onCancel: () => void;
@@ -34,6 +36,6 @@ interface ApiRequestPanelProps {
     tabsModifiedByPreset?: Set<'params' | 'headers' | 'body'>;
     onClearPresetIndicator?: (tab: 'params' | 'headers' | 'body') => void;
 }
-export declare function ApiRequestPanel({ route, basePath, method, pathParams, queryParams, headers, authType, apiKey, bypassMode, selectedTeamId, body, status, onMethodChange, onPathParamsChange, onQueryParamsChange, onHeadersChange, onAuthTypeChange, onApiKeyChange, onBypassModeChange, onTeamChange, onBodyChange, onSend, onCancel, endpointPresets, endpointDoc, onApplyPreset, tabsModifiedByPreset, onClearPresetIndicator, }: ApiRequestPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function ApiRequestPanel({ route, basePath, method, pathParams, queryParams, headers, authType, apiKey, bypassMode, selectedTeamId, actAsUserId, body, status, onMethodChange, onPathParamsChange, onQueryParamsChange, onHeadersChange, onAuthTypeChange, onApiKeyChange, onBypassModeChange, onTeamChange, onActAsUserChange, onBodyChange, onSend, onCancel, endpointPresets, endpointDoc, onApplyPreset, tabsModifiedByPreset, onClearPresetIndicator, }: ApiRequestPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=ApiRequestPanel.d.ts.map

package/dist/components/devtools/api-explorer/ApiRequestPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiRequestPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiRequestPanel.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAa/E,UAAU,oBAAoB;IAC5B,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC5C,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAA;IACjD,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IACrD,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IAClD,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1C,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;IAEpB,eAAe,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC3C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;IAE3C,oBAAoB,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAA;IACzD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,KAAK,IAAI,CAAA;CACtE;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,OAAO,EACP,QAAQ,EACR,MAAM,EACN,UAAU,EACV,cAAc,EACd,IAAI,EACJ,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,EAAE,oBAAoB,2CA8NtB"}
+{"version":3,"file":"ApiRequestPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/ApiRequestPanel.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACvG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAa/E,UAAU,oBAAoB;IAC5B,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,UAAU,CAAA;IAClB,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,WAAW,EAAE,YAAY,EAAE,CAAA;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC5C,kBAAkB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAA;IACjD,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IACrD,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IAClD,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1C,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;IAEpB,eAAe,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC3C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACpD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;IAE3C,oBAAoB,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAA;IACzD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,KAAK,IAAI,CAAA;CACtE;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,OAAO,EACP,QAAQ,EACR,MAAM,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,IAAI,EACJ,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,EAAE,oBAAoB,2CAgOtB"}

package/dist/components/devtools/api-explorer/ApiRequestPanel.js

@@ -36,6 +36,7 @@ function ApiRequestPanel({
   apiKey,
   bypassMode,
   selectedTeamId,
+  actAsUserId,
   body,
   status,
   onMethodChange,
@@ -46,6 +47,7 @@ function ApiRequestPanel({
   onApiKeyChange,
   onBypassModeChange,
   onTeamChange,
+  onActAsUserChange,
   onBodyChange,
   onSend,
   onCancel,
@@ -132,10 +134,12 @@ function ApiRequestPanel({
           apiKey,
           bypassMode,
           selectedTeamId,
+          actAsUserId,
           onAuthTypeChange,
           onApiKeyChange,
           onBypassModeChange,
-          onTeamChange
+          onTeamChange,
+          onActAsUserChange
         }
       )
     ] }),

package/dist/components/devtools/api-explorer/explorer-storage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Small localStorage helper for the API Explorer.
+ *
+ * Persists the Explorer's working state — session/auth config and per-endpoint
+ * request drafts — across reloads and endpoint switches. All access is SSR-safe
+ * and swallows quota/parse errors.
+ */
+export declare function loadState<T>(key: string): T | null;
+export declare function saveState(key: string, value: unknown): void;
+/** localStorage key for a specific endpoint's saved request draft. */
+export declare function draftKey(method: string, path: string): string;
+//# sourceMappingURL=explorer-storage.d.ts.map

package/dist/components/devtools/api-explorer/explorer-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorer-storage.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-explorer/explorer-storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAQlD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAO3D;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/components/devtools/api-explorer/explorer-storage.js

@@ -0,0 +1,25 @@
+const PREFIX = "nextspark:apiExplorer:";
+function loadState(key) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(PREFIX + key);
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+function saveState(key, value) {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.setItem(PREFIX + key, JSON.stringify(value));
+  } catch {
+  }
+}
+function draftKey(method, path) {
+  return `draft:${method}:${path}`;
+}
+export {
+  draftKey,
+  loadState,
+  saveState
+};

package/dist/components/devtools/api-tester/AuthSelector.d.ts

@@ -4,11 +4,14 @@ interface AuthSelectorProps {
     apiKey: string;
     bypassMode: boolean;
     selectedTeamId: string | null;
+    /** Optional. The act-as input renders only when onActAsUserChange is provided. */
+    actAsUserId?: string;
     onAuthTypeChange: (type: AuthType) => void;
     onApiKeyChange: (key: string) => void;
     onBypassModeChange: (enabled: boolean) => void;
     onTeamChange: (teamId: string | null) => void;
+    onActAsUserChange?: (userId: string) => void;
 }
-export declare function AuthSelector({ authType, apiKey, bypassMode, selectedTeamId, onAuthTypeChange, onApiKeyChange, onBypassModeChange, onTeamChange, }: AuthSelectorProps): import("react/jsx-runtime").JSX.Element;
+export declare function AuthSelector({ authType, apiKey, bypassMode, selectedTeamId, actAsUserId, onAuthTypeChange, onApiKeyChange, onBypassModeChange, onTeamChange, onActAsUserChange, }: AuthSelectorProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=AuthSelector.d.ts.map

package/dist/components/devtools/api-tester/AuthSelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthSelector.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-tester/AuthSelector.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGvC,UAAU,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1C,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC9C;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,YAAY,GACb,EAAE,iBAAiB,2CAmEnB"}
+{"version":3,"file":"AuthSelector.d.ts","sourceRoot":"","sources":["../../../../src/components/devtools/api-tester/AuthSelector.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGvC,UAAU,iBAAiB;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1C,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7C,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,GAClB,EAAE,iBAAiB,2CAoGnB"}

package/dist/components/devtools/api-tester/AuthSelector.js

@@ -19,10 +19,12 @@ function AuthSelector({
   apiKey,
   bypassMode,
   selectedTeamId,
+  actAsUserId,
   onAuthTypeChange,
   onApiKeyChange,
   onBypassModeChange,
-  onTeamChange
+  onTeamChange,
+  onActAsUserChange
 }) {
   const t = useTranslations("devtools.apiTester.auth");
   return /* @__PURE__ */ jsxs("div", { className: "space-y-3", "data-cy": sel("devtools.apiExplorer.auth.container"), children: [
@@ -79,7 +81,27 @@ function AuthSelector({
         onTeamChange,
         bypassMode
       }
-    )
+    ),
+    onActAsUserChange && /* @__PURE__ */ jsxs("div", { className: "space-y-1.5 pt-2 border-t", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
+        /* @__PURE__ */ jsx(Label, { htmlFor: "act-as-user", className: "text-sm cursor-pointer", children: "Act as user" }),
+        /* @__PURE__ */ jsx(TooltipProvider, { children: /* @__PURE__ */ jsxs(Tooltip, { children: [
+          /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsx(Info, { className: "h-4 w-4 text-muted-foreground cursor-help" }) }),
+          /* @__PURE__ */ jsx(TooltipContent, { className: "max-w-xs", children: "Developer-only. Resolves session-scoped endpoints (e.g. /me/*) as the given user without switching your session. Requires the developer role, a non-production environment, and ALLOW_ACT_AS_USER=true. Leave empty to use your own session." })
+        ] }) })
+      ] }),
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          id: "act-as-user",
+          placeholder: "user id (empty = your own session)",
+          value: actAsUserId ?? "",
+          onChange: (e) => onActAsUserChange(e.target.value),
+          className: "font-mono text-sm",
+          "data-cy": "devtools-api-auth-act-as-user"
+        }
+      )
+    ] })
   ] });
 }
 export {

package/dist/components/docs/docs-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-content.d.ts","sourceRoot":"","sources":["../../../src/components/docs/docs-content.tsx"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,2CAQrD"}
+{"version":3,"file":"docs-content.d.ts","sourceRoot":"","sources":["../../../src/components/docs/docs-content.tsx"],"names":[],"mappings":"AAKA,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,2CA4BrD"}

package/dist/components/docs/docs-content.js

@@ -1,9 +1,26 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { renderMermaid } from "../../lib/docs/mermaid.js";
 function DocsContent({ html }) {
+  const containerRef = useRef(null);
+  useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    const nodes = Array.from(
+      container.querySelectorAll(
+        'pre.mermaid:not([data-processed="true"])'
+      )
+    );
+    if (nodes.length === 0) return;
+    renderMermaid(nodes).catch((error) => {
+      console.error("[DocsContent] Failed to render mermaid diagrams:", error);
+    });
+  }, [html]);
   return /* @__PURE__ */ jsx(
     "div",
     {
+      ref: containerRef,
       className: "docs-content",
       dangerouslySetInnerHTML: { __html: html },
       "data-cy": "docs-content"

package/dist/components/docs/mermaid-diagram.d.ts

@@ -0,0 +1,11 @@
+interface MermaidDiagramProps {
+    chart: string;
+}
+/**
+ * Renders a single mermaid diagram from its source. Used by React-based
+ * markdown renderers (e.g. MarkdownViewer) where a ```mermaid fence maps to a
+ * React element rather than to an HTML marker string.
+ */
+export declare function MermaidDiagram({ chart }: MermaidDiagramProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=mermaid-diagram.d.ts.map

package/dist/components/docs/mermaid-diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-diagram.d.ts","sourceRoot":"","sources":["../../../src/components/docs/mermaid-diagram.tsx"],"names":[],"mappings":"AAKA,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,mBAAmB,2CAgB5D"}

package/dist/components/docs/mermaid-diagram.js

@@ -0,0 +1,20 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+import { renderMermaid } from "../../lib/docs/mermaid.js";
+function MermaidDiagram({ chart }) {
+  const ref = useRef(null);
+  useEffect(() => {
+    const node = ref.current;
+    if (!node) return;
+    node.removeAttribute("data-processed");
+    node.textContent = chart;
+    renderMermaid([node]).catch((error) => {
+      console.error("[MermaidDiagram] Failed to render diagram:", error);
+    });
+  }, [chart]);
+  return /* @__PURE__ */ jsx("pre", { ref, className: "mermaid" });
+}
+export {
+  MermaidDiagram
+};

package/dist/hooks/useApiExplorerNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useApiExplorerNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useApiExplorerNavigation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAEzE,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC5E;AAED,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D,yCAAyC;IACzC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAwDhC"}
+{"version":3,"file":"useApiExplorerNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useApiExplorerNavigation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAA;AAEzE,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;CAC5E;AAED,MAAM,WAAW,8BAA8B;IAC7C,qCAAqC;IACrC,cAAc,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,8DAA8D;IAC9D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9D,yCAAyC;IACzC,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CAiEhC"}

package/dist/hooks/useApiExplorerNavigation.js

@@ -29,7 +29,11 @@ function useApiExplorerNavigation(options) {
     (method, path) => {
       const pathSegments = path.replace(/^\//, "");
       const newUrl = `${basePath}/${method}/${pathSegments}`;
-      router.push(newUrl);
+      if (typeof window !== "undefined") {
+        window.history.pushState(null, "", newUrl);
+      } else {
+        router.push(newUrl);
+      }
     },
     [basePath, router]
   );

package/dist/lib/api/auth/dual-auth.d.ts

@@ -15,6 +15,15 @@ export declare const SYSTEM_ADMIN_TEAM_ID = "team-nextspark-001";
  */
 export declare const ADMIN_BYPASS_HEADER = "x-admin-bypass";
 export declare const ADMIN_BYPASS_VALUE = "confirm-cross-team-access";
+/**
+ * Development-only override header: a developer caller can resolve the request
+ * AS a different user by sending `x-act-as-user: <userId>`. Useful for
+ * exercising session-scoped ("me"/personal) endpoints as any user without
+ * switching sessions. Strictly non-production and developer-role gated (see
+ * applyActAsOverride). Core-level and theme-agnostic — every endpoint that
+ * authenticates via authenticateRequest honors it.
+ */
+export declare const ACT_AS_USER_HEADER = "x-act-as-user";
 export interface DualAuthUser {
     id: string;
     email: string;
@@ -28,6 +37,11 @@ export interface DualAuthResult {
     user: DualAuthUser | null;
     scopes?: string[];
     rateLimitResponse?: Response;
+    /** Set when a dev-only x-act-as-user override replaced the real caller. */
+    actingAs?: {
+        originalUserId: string;
+        originalRole: string;
+    };
 }
 /**
  * Try to authenticate request using either API Key or Session

package/dist/lib/api/auth/dual-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dual-auth.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/auth/dual-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AASvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AACnD,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAO7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IACpC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,iBAAiB,CAAC,EAAE,QAAQ,CAAA;CAC7B;AAqBD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBvF;AAqFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAY3F;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAqBhC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAkC,EAAE,MAAM,GAAE,MAAY;;;;GAShG"}
+{"version":3,"file":"dual-auth.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/auth/dual-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AASvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AAExD;;GAEG;AACH,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AACnD,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AAOjD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IACpC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,iBAAiB,CAAC,EAAE,QAAQ,CAAA;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5D;AAqBD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBvF;AAqKD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAY3F;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAqBhC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAkC,EAAE,MAAM,GAAE,MAAY;;;;GAShG"}

package/dist/lib/api/auth/dual-auth.js

@@ -6,6 +6,7 @@ import { TeamMemberService } from "../../services/team-member.service.js";
 const SYSTEM_ADMIN_TEAM_ID = "team-nextspark-001";
 const ADMIN_BYPASS_HEADER = "x-admin-bypass";
 const ADMIN_BYPASS_VALUE = "confirm-cross-team-access";
+const ACT_AS_USER_HEADER = "x-act-as-user";
 const ELEVATED_ROLES = ["superadmin", "developer"];
 async function getUserDefaultTeamId(userId) {
   try {
@@ -25,11 +26,11 @@ async function getUserDefaultTeamId(userId) {
 async function authenticateRequest(request) {
   const apiKeyResult = await tryApiKeyAuth(request);
   if (apiKeyResult.success) {
-    return apiKeyResult;
+    return applyActAsOverride(request, apiKeyResult);
   }
   const sessionResult = await trySessionAuth(request);
   if (sessionResult.success) {
-    return sessionResult;
+    return applyActAsOverride(request, sessionResult);
   }
   return {
     success: false,
@@ -37,6 +38,45 @@ async function authenticateRequest(request) {
     user: null
   };
 }
+function isProductionRuntime() {
+  if (process.env.VERCEL_ENV) return process.env.VERCEL_ENV === "production";
+  return process.env.NODE_ENV === "production";
+}
+async function applyActAsOverride(request, authResult) {
+  if (isProductionRuntime()) return authResult;
+  if (process.env.ALLOW_ACT_AS_USER !== "true") return authResult;
+  const targetUserId = request.headers.get(ACT_AS_USER_HEADER);
+  if (!targetUserId) return authResult;
+  if (!authResult.user || authResult.user.role !== "developer") return authResult;
+  try {
+    const target = await queryOne(
+      'SELECT email, role, name FROM "users" WHERE id = $1',
+      [targetUserId]
+    );
+    if (!target) return authResult;
+    const defaultTeamId = await getUserDefaultTeamId(targetUserId);
+    console.warn(
+      `[dual-auth] ACT-AS (dev only): ${authResult.user.email} (${authResult.user.role}) -> acting as user ${targetUserId}`
+    );
+    return {
+      ...authResult,
+      user: {
+        id: targetUserId,
+        email: target.email || "",
+        role: target.role || "user",
+        name: target.name,
+        defaultTeamId
+      },
+      actingAs: {
+        originalUserId: authResult.user.id,
+        originalRole: authResult.user.role
+      }
+    };
+  } catch (error) {
+    console.error("[dual-auth] act-as override failed; ignoring:", error);
+    return authResult;
+  }
+}
 async function tryApiKeyAuth(request) {
   try {
     const authHeader = request.headers.get("authorization");
@@ -163,6 +203,7 @@ function createAuthError(message = "Authentication required", status = 401) {
   );
 }
 export {
+  ACT_AS_USER_HEADER,
   ADMIN_BYPASS_HEADER,
   ADMIN_BYPASS_VALUE,
   SYSTEM_ADMIN_TEAM_ID,

package/dist/lib/docs/mermaid.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared client-side Mermaid rendering.
+ *
+ * Turns <pre class="mermaid"> markers (which carry the raw diagram source as
+ * their text content) into inline SVG, and enforces responsive sizing so
+ * diagrams never overflow. Used by every Core markdown surface — the docs HTML
+ * pipeline (DocsContent), the React-based MarkdownViewer, and the API docs
+ * modal — so they all render mermaid identically.
+ */
+/**
+ * Render the given <pre class="mermaid"> nodes to SVG. Nodes mermaid has already
+ * processed are skipped, so this is safe to call repeatedly.
+ */
+export declare function renderMermaid(nodes: HTMLElement[]): Promise<void>;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/lib/docs/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgCH;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvE"}

package/dist/lib/docs/mermaid.js

@@ -0,0 +1,42 @@
+let mermaidPromise = null;
+function getMermaid() {
+  if (!mermaidPromise) {
+    mermaidPromise = import("mermaid").then((mod) => mod.default);
+  }
+  return mermaidPromise;
+}
+function resolveTheme() {
+  if (typeof document !== "undefined") {
+    const el = document.documentElement;
+    if (el.classList.contains("dark")) return "dark";
+    if (el.classList.contains("light")) return "default";
+    const attr = el.getAttribute("data-theme");
+    if (attr === "dark") return "dark";
+    if (attr === "light") return "default";
+  }
+  if (typeof window !== "undefined" && typeof window.matchMedia === "function") {
+    return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "default";
+  }
+  return "default";
+}
+async function renderMermaid(nodes) {
+  const pending = nodes.filter((node) => node.getAttribute("data-processed") !== "true");
+  if (pending.length === 0) return;
+  const mermaid = await getMermaid();
+  mermaid.initialize({
+    startOnLoad: false,
+    securityLevel: "strict",
+    theme: resolveTheme()
+  });
+  await mermaid.run({ nodes: pending, suppressErrors: true });
+  for (const node of pending) {
+    const svg = node.querySelector("svg");
+    if (svg) {
+      svg.style.maxWidth = "100%";
+      svg.style.height = "auto";
+    }
+  }
+}
+export {
+  renderMermaid
+};

package/dist/lib/docs/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,QAAQ,EAAE,WAAW,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAgBD"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,QAAQ,EAAE,WAAW,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CAiBD"}

package/dist/lib/docs/parser.js

@@ -5,6 +5,7 @@ import remarkGfm from "remark-gfm";
 import remarkRehype from "remark-rehype";
 import rehypeShiki from "@shikijs/rehype";
 import rehypeStringify from "rehype-stringify";
+import { remarkMermaid } from "./remark-mermaid.js";
 import {
   extractOrderFromFilename,
   cleanFilename,
@@ -13,7 +14,7 @@ import {
 async function parseMarkdownFile(filePath) {
   const fileContent = fs.readFileSync(filePath, "utf-8");
   const { data, content } = matter(fileContent);
-  const processedContent = await remark().use(remarkGfm).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeShiki, { theme: "github-dark" }).use(rehypeStringify, { allowDangerousHtml: true }).process(content);
+  const processedContent = await remark().use(remarkGfm).use(remarkMermaid).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeShiki, { theme: "github-dark" }).use(rehypeStringify, { allowDangerousHtml: true }).process(content);
   return {
     metadata: data,
     content,

package/dist/lib/docs/remark-mermaid.d.ts

@@ -0,0 +1,15 @@
+/**
+ * remark plugin: rewrite ```mermaid fenced code blocks into a neutral
+ * <pre class="mermaid"> marker that carries the raw diagram source, instead of
+ * letting the syntax highlighter render them as source code.
+ *
+ * The marker is platform-neutral: the diagram source is preserved verbatim so
+ * each surface can render it its own way. On web it is picked up and rendered
+ * to SVG client-side after mount (see DocsContent).
+ */
+/**
+ * Unified/remark plugin. Runs on the mdast tree before it is converted to
+ * rehype, so the mermaid fence never reaches the syntax highlighter.
+ */
+export declare function remarkMermaid(): (tree: unknown) => void;
+//# sourceMappingURL=remark-mermaid.d.ts.map

package/dist/lib/docs/remark-mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-mermaid.d.ts","sourceRoot":"","sources":["../../../src/lib/docs/remark-mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuCH;;;GAGG;AACH,wBAAgB,aAAa,KACnB,MAAM,OAAO,KAAG,IAAI,CAG7B"}

package/dist/lib/docs/remark-mermaid.js

@@ -0,0 +1,26 @@
+function escapeHtml(source) {
+  return source.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function transformMermaidFences(node) {
+  var _a;
+  if (!node.children) return;
+  for (let index = 0; index < node.children.length; index++) {
+    const child = node.children[index];
+    if (child.type === "code" && ((_a = child.lang) == null ? void 0 : _a.toLowerCase()) === "mermaid") {
+      node.children[index] = {
+        type: "html",
+        value: `<pre class="mermaid">${escapeHtml(child.value ?? "")}</pre>`
+      };
+    } else {
+      transformMermaidFences(child);
+    }
+  }
+}
+function remarkMermaid() {
+  return (tree) => {
+    transformMermaidFences(tree);
+  };
+}
+export {
+  remarkMermaid
+};

package/dist/styles/classes.json

@@ -1,6 +1,6 @@
 {
-  "generated": "2026-06-30T17:54:54.134Z",
-  "totalClasses": 1081,
+  "generated": "2026-07-01T20:08:31.259Z",
+  "totalClasses": 1082,
   "classes": [
     "!text-2xl",
     "''",
@@ -644,6 +644,7 @@
     "md:text-left",
     "md:w-auto",
     "medium",
+    "mermaid",
     "min-h-0",
     "min-h-10",
     "min-h-[100px]",

package/dist/templates/app/(auth)/login/page.tsx

@@ -2,6 +2,8 @@ import type { Metadata } from 'next'
 import { LoginForm } from '@nextsparkjs/core/components/auth/forms/LoginForm'
 import { getTemplateOrDefault, getMetadataOrDefault } from '@nextsparkjs/core/lib/template-resolver'
 
+export const dynamic = 'force-dynamic'
+
 const defaultMetadata: Metadata = {
   title: 'Sign In',
   description: 'Sign in to your account to access the platform',

package/dist/templates/app/(auth)/signup/page.tsx

@@ -6,6 +6,10 @@ import { getTemplateOrDefault, getMetadataOrDefault } from '@nextsparkjs/core/li
 import { AUTH_CONFIG } from '@nextsparkjs/core/lib/config'
 import { TeamService } from '@nextsparkjs/core/lib/services'
 
+// This page reads DB state (TeamService.hasGlobal) and redirect()s during render,
+// so it must render per-request and never be statically prerendered at build time.
+export const dynamic = 'force-dynamic'
+
 const defaultMetadata: Metadata = {
   title: 'Create Account',
   description: 'Create your account to start using our platform',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.177",
+  "version": "0.1.0-beta.178",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -449,6 +449,7 @@
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
     "lucide-react": "^0.539.0",
+    "mermaid": "^11.0.0",
     "next-intl": "^4.9.1",
     "next-themes": "^0.4.6",
     "ora": "^8.1.1",
@@ -469,7 +470,7 @@
     "tailwind-merge": "^3.3.1",
     "uuid": "^13.0.0",
     "zod": "^4.1.5",
-    "@nextsparkjs/testing": "0.1.0-beta.177"
+    "@nextsparkjs/testing": "0.1.0-beta.178"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.mjs || true",

package/styles/docs.css

@@ -80,3 +80,18 @@
 .docs-content hr {
   @apply my-8 border-border;
 }
+
+/* Mermaid diagrams: rendered client-side from a <pre class="mermaid"> marker */
+.docs-content pre.mermaid {
+  @apply my-6 p-0 bg-transparent border-0 text-center overflow-x-auto;
+  line-height: normal;
+}
+
+.docs-content pre.mermaid svg {
+  @apply max-w-full h-auto;
+}
+
+/* Raw source shown briefly before the client render replaces it */
+.docs-content pre.mermaid:not([data-processed="true"]) {
+  @apply text-sm text-muted-foreground;
+}

package/templates/app/(auth)/login/page.tsx

@@ -2,6 +2,8 @@ import type { Metadata } from 'next'
 import { LoginForm } from '@nextsparkjs/core/components/auth/forms/LoginForm'
 import { getTemplateOrDefault, getMetadataOrDefault } from '@nextsparkjs/core/lib/template-resolver'
 
+export const dynamic = 'force-dynamic'
+
 const defaultMetadata: Metadata = {
   title: 'Sign In',
   description: 'Sign in to your account to access the platform',

package/templates/app/(auth)/signup/page.tsx

@@ -6,6 +6,10 @@ import { getTemplateOrDefault, getMetadataOrDefault } from '@nextsparkjs/core/li
 import { AUTH_CONFIG } from '@nextsparkjs/core/lib/config'
 import { TeamService } from '@nextsparkjs/core/lib/services'
 
+// This page reads DB state (TeamService.hasGlobal) and redirect()s during render,
+// so it must render per-request and never be statically prerendered at build time.
+export const dynamic = 'force-dynamic'
+
 const defaultMetadata: Metadata = {
   title: 'Create Account',
   description: 'Create your account to start using our platform',