dynim-core 1.0.0

package/README.md

@@ -0,0 +1,290 @@
+# dynim-core
+
+Framework-agnostic TypeScript library for visual page building, AI chat, and code generation.
+
+## Installation
+
+```bash
+npm install dynim-core
+```
+
+## Features
+
+- **Visual Page Builder** - Drag-and-drop editing with undo/redo history
+- **AI Chat Integration** - SSE-based streaming chat with element context awareness
+- **Code Generation** - Flexcode integration for AI-powered code changes
+- **Element Classification** - Semantic, visual, and size analysis of DOM elements
+- **DOM Utilities** - Tree scanning, stable IDs, selector generation
+
+## Quick Start
+
+### Chat Widget
+
+```typescript
+import { createState, createClient, createWidget } from 'dynim-core';
+
+const state = createState();
+const client = createClient({
+  endpoint: '/api/chat',
+  apiKey: 'your-api-key',
+  onMessage: (data) => state.updateMessage(data.id, data.text),
+  onError: (error) => console.error(error),
+});
+
+const widget = createWidget({
+  state,
+  client,
+  position: 'bottom-right', // or 'inline'
+});
+
+widget.mount(document.body);
+```
+
+### Visual Builder
+
+```typescript
+import { createBuilder, createBuilderClient } from 'dynim-core';
+
+const builderClient = createBuilderClient({
+  apiBase: 'https://api.example.com',
+  sessionToken: 'jwt-token',
+  onMessage: (msg) => console.log('AI response:', msg),
+  onError: (err) => console.error(err),
+});
+
+const builder = createBuilder({
+  contentRoot: document.getElementById('app'),
+  client: builderClient,
+});
+
+// Enter edit mode
+builder.enter();
+
+// Save changes
+await builder.save();
+
+// Exit without saving
+builder.exit();
+```
+
+### Code Generation (Flexcode)
+
+```typescript
+import { createCodeClient } from 'dynim-core';
+
+const codeClient = createCodeClient({
+  apiBase: 'https://api.example.com',
+  sessionToken: 'jwt-token',
+  onMessage: (event) => {
+    switch (event.type) {
+      case 'text':
+        console.log('Response:', event.content);
+        break;
+      case 'thinking':
+        console.log('Thinking:', event.content);
+        break;
+      case 'edit':
+        console.log('Code edit:', event.edit);
+        break;
+      case 'done':
+        console.log('Complete');
+        break;
+    }
+  },
+});
+
+// Send code generation request
+await codeClient.sendCode('project-id', 'Add a dark mode toggle');
+
+// Get pending edits
+const edits = codeClient.getEdits();
+
+// Save or abandon
+await codeClient.saveCode('project-id');
+await codeClient.abandonCode('project-id');
+```
+
+## API Reference
+
+### State Management
+
+```typescript
+createState(): StateStore
+
+interface StateStore {
+  getState(): ChatState;
+  setState(state: Partial<ChatState>): void;
+  subscribe(listener: (state: ChatState) => void): () => void;
+  addMessage(message: Message): void;
+  updateMessage(id: string, text: string): void;
+  clearMessages(): void;
+}
+```
+
+### Streaming Client
+
+```typescript
+createClient(config: ClientConfig): StreamClient
+
+interface ClientConfig {
+  endpoint: string;
+  apiKey?: string;
+  onMessage: (data: MessageData) => void;
+  onError?: (error: Error) => void;
+}
+
+interface StreamClient {
+  send(message: string): Promise<void>;
+}
+```
+
+### Builder
+
+```typescript
+createBuilder(config: BuilderConfig): Builder
+
+interface BuilderConfig {
+  contentRoot?: HTMLElement;
+  client: BuilderClient;
+}
+
+interface Builder {
+  enter(): void;
+  exit(): void;
+  save(): Promise<void>;
+  isActive(): boolean;
+  getChanges(): DiffEntry[];
+  getEditorState(): EditorState;
+  getTreeState(): TreeState;
+  destroy(): void;
+}
+```
+
+### Builder Client
+
+```typescript
+createBuilderClient(config: BuilderClientConfig): BuilderClient
+
+interface BuilderClientConfig {
+  apiBase?: string;
+  sessionToken?: string;
+  refreshToken?: string;
+  getSession?: () => Promise<{ token: string }>;
+  onMessage?: (data: BuilderMessage) => void;
+  onError?: (error: Error) => void;
+}
+
+interface BuilderClient {
+  sendChat(message: string): Promise<void>;
+  sendElementChat(message: string, element: HTMLElement): Promise<void>;
+  saveDiffs(diffs: DiffEntry[]): Promise<void>;
+  setSessionToken(token: string): void;
+  isAuthenticated(): boolean;
+}
+```
+
+### Code Client
+
+```typescript
+createCodeClient(config: CodeClientConfig): CodeClient
+
+interface CodeClientConfig {
+  apiBase?: string;
+  sessionToken?: string;
+  getSession?: () => Promise<{ token: string }>;
+  onMessage?: (event: CodeEvent) => void;
+}
+
+interface CodeClient {
+  sendCode(projectId: string, prompt: string): Promise<void>;
+  saveCode(projectId: string): Promise<void>;
+  abandonCode(projectId: string): Promise<void>;
+  getEdits(): CodeEdit[];
+}
+
+type CodeEvent =
+  | { type: 'text'; content: string }
+  | { type: 'thinking'; content: string }
+  | { type: 'edit'; edit: CodeEdit }
+  | { type: 'question'; content: string }
+  | { type: 'done' }
+  | { type: 'error'; content: string };
+```
+
+### DOM Utilities
+
+```typescript
+// Scan DOM tree
+scanDOM(root: HTMLElement): DOMNode[]
+
+// Create debounced scanner
+createDebouncedScanner(callback: (nodes: DOMNode[]) => void): Scanner
+
+// Element queries
+getElementAtPath(root: HTMLElement, path: number[]): HTMLElement | null
+queryElements(root: HTMLElement, selector: string): HTMLElement[]
+generateSelector(element: HTMLElement): string
+
+// Stable IDs for tracking elements across changes
+getStableId(element: HTMLElement): string
+findByStableId(root: HTMLElement, id: string): HTMLElement | null
+
+// Build element context for AI
+buildElementIdentifier(element: HTMLElement): ElementIdentifier
+```
+
+### Element Classifier
+
+```typescript
+createClassifier(): Classifier
+
+interface Classifier {
+  classify(element: HTMLElement): Classification;
+}
+
+interface Classification {
+  semantic: SemanticInfo;   // HTML tag, ARIA roles, attributes
+  classes: ClassInfo;       // CSS class patterns
+  visual: VisualInfo;       // Colors, fonts, spacing
+  size: SizeInfo;           // Dimensions, viewport relation
+}
+```
+
+## Styling
+
+Import base styles for the chat widget and builder UI:
+
+```typescript
+import 'dynim-core/styles/base.css';
+import 'dynim-core/styles/builder.css';
+import 'dynim-core/styles/editor.css';
+
+// Themes
+import 'dynim-core/styles/themes/light.css';
+import 'dynim-core/styles/themes/dark.css';
+```
+
+## Browser Global API
+
+For non-module usage, `dynim-core` exposes global helpers:
+
+```html
+<script src="dynim-core/dist/index.js"></script>
+<script>
+  // Quick chatbot setup
+  window.Chatbot.init({
+    endpoint: '/api/chat',
+    position: 'bottom-right',
+  });
+
+  // Quick builder setup
+  window.Builder.create({
+    apiBase: 'https://api.example.com',
+    sessionToken: 'jwt-token',
+  });
+</script>
+```
+
+## License
+
+MIT

package/dist/builder/ai-prompt-popover.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Prompt Popover - appears below selected element
+ * Allows user to type commands to modify the selected element
+ */
+export interface AIPromptPopoverConfig {
+    onSubmit?: (prompt: string) => void;
+    onClose?: () => void;
+}
+export interface AIPromptPopover {
+    element: HTMLDivElement;
+    mount: () => void;
+    unmount: () => void;
+    show: (rect: DOMRect | {
+        x?: number;
+        left?: number;
+        y?: number;
+        top?: number;
+        width: number;
+        height: number;
+    } | null) => void;
+    hide: () => void;
+    updatePosition: () => void;
+    isVisible: () => boolean;
+}
+export declare function createAIPromptPopover(config?: AIPromptPopoverConfig): AIPromptPopover;
+//# sourceMappingURL=ai-prompt-popover.d.ts.map

package/dist/builder/ai-prompt-popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-prompt-popover.d.ts","sourceRoot":"","sources":["../../src/builder/ai-prompt-popover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9H,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,qBAA0B,GAAG,eAAe,CAsMzF"}

package/dist/builder/ai-prompt-popover.js

@@ -0,0 +1,180 @@
+/**
+ * AI Prompt Popover - appears below selected element
+ * Allows user to type commands to modify the selected element
+ */
+export function createAIPromptPopover(config = {}) {
+    const { onSubmit, onClose } = config;
+    const popover = document.createElement('div');
+    popover.id = '__ai-prompt-popover__';
+    popover.style.cssText = 'display: none;';
+    popover.innerHTML = `
+    <form class="ai-prompt-form">
+      <div class="ai-prompt-icon">
+        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <path d="M12 3v18M3 12h18M5.5 5.5l13 13M18.5 5.5l-13 13" />
+        </svg>
+      </div>
+      <input
+        type="text"
+        class="ai-prompt-input"
+        placeholder="Ask AI to modify this element..."
+      />
+      <button type="submit" class="ai-prompt-submit" disabled>
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+          <line x1="22" y1="2" x2="11" y2="13" />
+          <polygon points="22 2 15 22 11 13 2 9 22 2" />
+        </svg>
+      </button>
+    </form>
+  `;
+    const style = document.createElement('style');
+    style.id = '__ai-prompt-popover-styles__';
+    style.textContent = `
+    #__ai-prompt-popover__ {
+      position: fixed;
+      z-index: 10003;
+      pointer-events: auto;
+    }
+
+    .ai-prompt-form {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      background: #18181b;
+      border-radius: 10px;
+      padding: 6px 10px;
+      box-shadow: 0 4px 24px rgba(0, 0, 0, 0.24), 0 0 0 1px rgba(255, 255, 255, 0.08);
+      width: 320px;
+    }
+
+    .ai-prompt-icon {
+      color: #a78bfa;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      flex-shrink: 0;
+    }
+
+    .ai-prompt-input {
+      flex: 1;
+      background: transparent;
+      border: none;
+      outline: none;
+      color: #fafafa;
+      font-size: 14px;
+      font-family: inherit;
+      padding: 6px 0;
+    }
+
+    .ai-prompt-input::placeholder {
+      color: #71717a;
+    }
+
+    .ai-prompt-submit {
+      background: #7c3aed;
+      border: none;
+      border-radius: 6px;
+      padding: 6px 8px;
+      cursor: pointer;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      color: white;
+      transition: opacity 0.15s;
+    }
+
+    .ai-prompt-submit:disabled {
+      opacity: 0.5;
+      cursor: not-allowed;
+    }
+
+    .ai-prompt-submit:not(:disabled):hover {
+      background: #6d28d9;
+    }
+  `;
+    const form = popover.querySelector('.ai-prompt-form');
+    const input = popover.querySelector('.ai-prompt-input');
+    const submitBtn = popover.querySelector('.ai-prompt-submit');
+    let currentRect = null;
+    input.addEventListener('input', () => {
+        submitBtn.disabled = !input.value.trim();
+    });
+    function handleSubmit() {
+        const prompt = input.value.trim();
+        if (prompt) {
+            onSubmit?.(prompt);
+            input.value = '';
+            submitBtn.disabled = true;
+        }
+    }
+    form.addEventListener('submit', (e) => {
+        e.preventDefault();
+        handleSubmit();
+    });
+    // Backup: handle click directly on submit button
+    submitBtn.addEventListener('click', (e) => {
+        e.preventDefault();
+        handleSubmit();
+    });
+    input.addEventListener('keydown', (e) => {
+        if (e.key === 'Escape') {
+            hide();
+            onClose?.();
+        }
+    });
+    function mount() {
+        document.head.appendChild(style);
+        document.body.appendChild(popover);
+    }
+    function unmount() {
+        style.remove();
+        popover.remove();
+    }
+    function show(rect) {
+        if (!rect) {
+            hide();
+            return;
+        }
+        currentRect = rect;
+        let left = Math.max(16, (rect.left ?? rect.x ?? 0) + (rect.width / 2) - 160);
+        let top = (rect.top ?? rect.y ?? 0) + rect.height + 8;
+        if (top + 60 > window.innerHeight) {
+            top = (rect.top ?? rect.y ?? 0) - 52;
+        }
+        if (left + 320 > window.innerWidth) {
+            left = window.innerWidth - 336;
+        }
+        popover.style.cssText = `
+      position: fixed;
+      display: block;
+      left: ${left}px;
+      top: ${top}px;
+      z-index: 10003;
+      pointer-events: auto;
+    `;
+        setTimeout(() => input.focus(), 0);
+    }
+    function hide() {
+        popover.style.cssText = 'display: none;';
+        input.value = '';
+        submitBtn.disabled = true;
+        currentRect = null;
+    }
+    function updatePosition() {
+        if (currentRect) {
+            show(currentRect);
+        }
+    }
+    function isVisible() {
+        return popover.style.display !== 'none';
+    }
+    return {
+        element: popover,
+        mount,
+        unmount,
+        show,
+        hide,
+        updatePosition,
+        isVisible
+    };
+}

package/dist/builder/builder-client.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Builder Client - Handles visual builder operations
+ *
+ * NOTE: For AI chat/code operations, use code-client.ts instead.
+ * This client handles visual builder-specific operations:
+ * - saveDiffs: Save visual DOM changes
+ * - preview: Generate preview URL
+ * - exit: Notify server of builder exit
+ *
+ * Authentication uses JWT session tokens.
+ */
+import type { DiffEntry } from './diff-state';
+export interface BuilderClientConfig {
+    apiBase?: string;
+    /** JWT session token for authentication */
+    sessionToken?: string;
+    /** Refresh token for getting new session tokens */
+    refreshToken?: string;
+    /** Function to fetch a new session when current one expires */
+    getSession?: () => Promise<{
+        token: string;
+        refreshToken?: string;
+    }>;
+    onError?: (error: Error) => void;
+    /** Called when session is refreshed */
+    onSessionRefresh?: (token: string) => void;
+    /** Called when authentication fails */
+    onAuthError?: (error: Error) => void;
+}
+export interface BuilderClient {
+    /** Save visual DOM diffs to backend */
+    saveDiffs: (pageId: string, diffs: DiffEntry[]) => Promise<unknown>;
+    /** Generate preview URL for current changes */
+    preview: (pageId: string, diffs?: DiffEntry[]) => Promise<{
+        success: boolean;
+        previewUrl?: string;
+        message?: string;
+    }>;
+    /** Notify server of builder exit */
+    exit: (pageId: string, discard?: boolean) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    setSessionToken: (token: string, refreshToken?: string) => void;
+    isAuthenticated: () => boolean;
+}
+export declare function createBuilderClient(config?: BuilderClientConfig): BuilderClient;
+//# sourceMappingURL=builder-client.d.ts.map

package/dist/builder/builder-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-client.d.ts","sourceRoot":"","sources":["../../src/builder/builder-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,uCAAuC;IACvC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAGD,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,+CAA+C;IAC/C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvH,oCAAoC;IACpC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,GAAG,aAAa,CAyKnF"}

package/dist/builder/builder-client.js

@@ -0,0 +1,157 @@
+/**
+ * Builder Client - Handles visual builder operations
+ *
+ * NOTE: For AI chat/code operations, use code-client.ts instead.
+ * This client handles visual builder-specific operations:
+ * - saveDiffs: Save visual DOM changes
+ * - preview: Generate preview URL
+ * - exit: Notify server of builder exit
+ *
+ * Authentication uses JWT session tokens.
+ */
+const DEFAULT_API_BASE = 'http://localhost:8080';
+export function createBuilderClient(config = {}) {
+    const { apiBase = DEFAULT_API_BASE, sessionToken: initialSessionToken, refreshToken: initialRefreshToken, getSession, onError, onSessionRefresh, onAuthError } = config;
+    let currentSessionToken = initialSessionToken;
+    let currentRefreshToken = initialRefreshToken;
+    let isRefreshing = false;
+    /**
+     * Get a valid session token, refreshing if necessary
+     */
+    async function getValidToken() {
+        if (currentSessionToken) {
+            // Check if token is expired (JWT decode)
+            try {
+                const payload = JSON.parse(atob(currentSessionToken.split('.')[1]));
+                const exp = payload.exp * 1000; // Convert to ms
+                if (Date.now() < exp - 60000) { // 1 minute buffer
+                    return currentSessionToken;
+                }
+            }
+            catch {
+                // Token parse failed, try to refresh
+            }
+        }
+        // Try to refresh
+        if (currentRefreshToken && !isRefreshing) {
+            isRefreshing = true;
+            try {
+                const response = await fetch(`${apiBase}/api/sessions/refresh`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ refresh_token: currentRefreshToken })
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    currentSessionToken = data.token;
+                    onSessionRefresh?.(data.token);
+                    isRefreshing = false;
+                    return currentSessionToken ?? null;
+                }
+            }
+            catch (err) {
+                console.error('[BuilderClient] Failed to refresh session:', err);
+            }
+            isRefreshing = false;
+        }
+        // Try to get new session from callback
+        if (getSession) {
+            try {
+                const session = await getSession();
+                currentSessionToken = session.token;
+                if (session.refreshToken) {
+                    currentRefreshToken = session.refreshToken;
+                }
+                return currentSessionToken;
+            }
+            catch (err) {
+                console.error('[BuilderClient] Failed to get session:', err);
+                onAuthError?.(err);
+            }
+        }
+        onAuthError?.(new Error('No valid session token available'));
+        return null;
+    }
+    /**
+     * Make an authenticated request
+     */
+    async function authenticatedFetch(url, options = {}) {
+        const token = await getValidToken();
+        if (!token) {
+            throw new Error('Not authenticated');
+        }
+        const headers = new Headers(options.headers);
+        headers.set('Authorization', `Bearer ${token}`);
+        return fetch(url, { ...options, headers });
+    }
+    async function saveDiffs(pageId, diffs) {
+        try {
+            const response = await authenticatedFetch(`${apiBase}/api/builder/save`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ pageId, diffs })
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return response.json();
+        }
+        catch (error) {
+            console.error('[BuilderClient] Save error:', error);
+            onError?.(error);
+            throw error;
+        }
+    }
+    async function preview(pageId, diffs) {
+        try {
+            const response = await authenticatedFetch(`${apiBase}/api/builder/preview`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ pageId, diffs: diffs || [] })
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return response.json();
+        }
+        catch (error) {
+            console.error('[BuilderClient] Preview error:', error);
+            onError?.(error);
+            throw error;
+        }
+    }
+    async function exit(pageId, discard) {
+        try {
+            const response = await authenticatedFetch(`${apiBase}/api/builder/exit`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ pageId, discard: discard || false })
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return response.json();
+        }
+        catch (error) {
+            console.error('[BuilderClient] Exit error:', error);
+            onError?.(error);
+            throw error;
+        }
+    }
+    /**
+     * Set/update the session token
+     */
+    function setSessionToken(token, refreshToken) {
+        currentSessionToken = token;
+        if (refreshToken) {
+            currentRefreshToken = refreshToken;
+        }
+    }
+    return {
+        saveDiffs,
+        preview,
+        exit,
+        setSessionToken,
+        isAuthenticated: () => !!currentSessionToken,
+    };
+}