@revealui/sync 0.0.0-canary-20260409021642

package/dist/collab/use-collab-document.js

@@ -0,0 +1,49 @@
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useElectricConfig } from '../provider/index.js';
+// UUID v4 pattern — only format accepted as a yjs_documents PK
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function useCollabDocument(documentId) {
+    const { proxyBaseUrl } = useElectricConfig();
+    // Validate before interpolating into the WHERE clause. yjs_documents PKs are
+    // always UUIDs — reject anything else so no untrusted string enters the query.
+    const isValidId = UUID_RE.test(documentId);
+    // Hook must always be called (Rules of Hooks). Pass an impossible WHERE when
+    // the ID is invalid so the shape returns no rows but the hook still runs.
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/yjs-documents`,
+        params: {
+            document_id: isValidId ? documentId : '__invalid__',
+        },
+        fetchClient: fetchWithTimeout,
+    });
+    if (!isValidId) {
+        return {
+            initialState: null,
+            connectedClients: 0,
+            isLoading: false,
+            error: new Error('Invalid documentId: must be a UUID'),
+        };
+    }
+    let initialState = null;
+    let connectedClients = 0;
+    if (data && data.length > 0) {
+        const row = data[0];
+        const state = row.state;
+        if (state) {
+            const binary = atob(state);
+            const bytes = new Uint8Array(binary.length);
+            for (let i = 0; i < binary.length; i++) {
+                bytes[i] = binary.charCodeAt(i);
+            }
+            initialState = bytes;
+        }
+        connectedClients = row.connected_clients ?? 0;
+    }
+    return {
+        initialState,
+        connectedClients,
+        isLoading,
+        error: error ? new Error(String(error)) : null,
+    };
+}

package/dist/collab/use-collaboration.d.ts

@@ -0,0 +1,26 @@
+import * as Y from 'yjs';
+import type { UserPresence } from './yjs-websocket-provider.js';
+import { CollabProvider } from './yjs-websocket-provider.js';
+export interface CollaborationIdentity {
+    name: string;
+    color: string;
+    type?: 'human' | 'agent';
+    agentModel?: string;
+}
+export interface UseCollaborationOptions {
+    documentId: string;
+    serverUrl: string;
+    enabled?: boolean;
+    initialState?: Uint8Array | null;
+    identity?: CollaborationIdentity;
+}
+export interface UseCollaborationResult {
+    doc: Y.Doc | null;
+    provider: CollabProvider | null;
+    synced: boolean;
+    status: string;
+    error: Error | null;
+    connectedUsers: Map<number, UserPresence>;
+}
+export declare function useCollaboration({ documentId, serverUrl, enabled, initialState, identity, }: UseCollaborationOptions): UseCollaborationResult;
+//# sourceMappingURL=use-collaboration.d.ts.map

package/dist/collab/use-collaboration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collaboration.d.ts","sourceRoot":"","sources":["../../src/collab/use-collaboration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,SAAS,EACT,OAAc,EACd,YAAmB,EACnB,QAAQ,GACT,EAAE,uBAAuB,GAAG,sBAAsB,CAqElD"}

package/dist/collab/use-collaboration.js

@@ -0,0 +1,65 @@
+import { useEffect, useRef, useState } from 'react';
+import * as Y from 'yjs';
+import { CollabProvider } from './yjs-websocket-provider.js';
+export function useCollaboration({ documentId, serverUrl, enabled = true, initialState = null, identity, }) {
+    const [synced, setSynced] = useState(false);
+    const [status, setStatus] = useState('disconnected');
+    const [error, setError] = useState(null);
+    const [connectedUsers, setConnectedUsers] = useState(new Map());
+    const docRef = useRef(null);
+    const providerRef = useRef(null);
+    useEffect(() => {
+        if (!(enabled && documentId))
+            return;
+        const doc = new Y.Doc();
+        docRef.current = doc;
+        try {
+            const provider = new CollabProvider(serverUrl, documentId, doc, { initialState });
+            providerRef.current = provider;
+            // Set local identity for awareness
+            if (identity) {
+                provider.setLocalIdentity({
+                    name: identity.name,
+                    color: identity.color,
+                    type: identity.type ?? 'human',
+                    ...(identity.agentModel ? { agentModel: identity.agentModel } : {}),
+                });
+            }
+            provider.on('sync', (isSynced) => {
+                setSynced(isSynced);
+            });
+            provider.on('status', (event) => {
+                const statusEvent = event;
+                setStatus(statusEvent.status);
+            });
+            provider.on('awareness', (users) => {
+                setConnectedUsers(new Map(users));
+            });
+            provider.connect();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        return () => {
+            if (providerRef.current) {
+                providerRef.current.destroy();
+                providerRef.current = null;
+            }
+            if (docRef.current) {
+                docRef.current.destroy();
+                docRef.current = null;
+            }
+            setSynced(false);
+            setStatus('disconnected');
+            setConnectedUsers(new Map());
+        };
+    }, [documentId, serverUrl, enabled, initialState, identity]);
+    return {
+        doc: docRef.current,
+        provider: providerRef.current,
+        synced,
+        status,
+        error,
+        connectedUsers,
+    };
+}

package/dist/collab/yjs-websocket-provider.d.ts

@@ -0,0 +1,36 @@
+import { Observable } from 'lib0/observable';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import * as Y from 'yjs';
+export interface UserPresence {
+    name: string;
+    color: string;
+    type: 'human' | 'agent';
+    agentModel?: string;
+    cursor?: {
+        index: number;
+        length: number;
+    };
+}
+export declare class CollabProvider extends Observable<string> {
+    doc: Y.Doc;
+    awareness: awarenessProtocol.Awareness;
+    private serverUrl;
+    private documentId;
+    private ws;
+    private synced;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private updateHandler;
+    private awarenessUpdateHandler;
+    constructor(serverUrl: string, documentId: string, doc: Y.Doc, options?: {
+        initialState?: Uint8Array | null;
+    });
+    setLocalIdentity(identity: UserPresence): void;
+    getConnectedUsers(): Map<number, UserPresence>;
+    connect(): void;
+    disconnect(): void;
+    private scheduleReconnect;
+    private cancelReconnect;
+    destroy(): void;
+}
+//# sourceMappingURL=yjs-websocket-provider.d.ts.map

package/dist/collab/yjs-websocket-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-websocket-provider.d.ts","sourceRoot":"","sources":["../../src/collab/yjs-websocket-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,qBAAa,cAAe,SAAQ,UAAU,CAAC,MAAM,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,aAAa,CAAgE;IACrF,OAAO,CAAC,sBAAsB,CAGpB;gBAGR,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,CAAC,CAAC,GAAG,EACV,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE;IA2BhD,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAI9C,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAU9C,OAAO,IAAI,IAAI;IAuFf,UAAU,IAAI,IAAI;IAmBlB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;IAQvB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/collab/yjs-websocket-provider.js

@@ -0,0 +1,172 @@
+import * as decoding from 'lib0/decoding';
+import * as encoding from 'lib0/encoding';
+import { Observable } from 'lib0/observable';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import * as syncProtocol from 'y-protocols/sync';
+import * as Y from 'yjs';
+import { MESSAGE_AWARENESS, MESSAGE_SYNC } from './protocol-constants.js';
+const MAX_RECONNECT_ATTEMPTS = 10;
+const BASE_RECONNECT_DELAY = 1000;
+const RECONNECT_MULTIPLIER = 1.5;
+export class CollabProvider extends Observable {
+    doc;
+    awareness;
+    serverUrl;
+    documentId;
+    ws = null;
+    synced = false;
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    updateHandler = null;
+    awarenessUpdateHandler;
+    constructor(serverUrl, documentId, doc, options) {
+        super();
+        this.serverUrl = serverUrl;
+        this.documentId = documentId;
+        this.doc = doc;
+        this.awareness = new awarenessProtocol.Awareness(doc);
+        if (options?.initialState) {
+            Y.applyUpdate(doc, options.initialState);
+        }
+        // Send awareness updates over WebSocket
+        this.awarenessUpdateHandler = ({ added, updated, removed }, origin) => {
+            if (origin === 'remote')
+                return;
+            const changedClients = added.concat(updated, removed);
+            const update = awarenessProtocol.encodeAwarenessUpdate(this.awareness, changedClients);
+            const encoder = encoding.createEncoder();
+            encoding.writeVarUint(encoder, MESSAGE_AWARENESS);
+            encoding.writeVarUint8Array(encoder, update);
+            if (this.ws?.readyState === WebSocket.OPEN) {
+                this.ws.send(encoding.toUint8Array(encoder));
+            }
+        };
+        this.awareness.on('update', this.awarenessUpdateHandler);
+    }
+    setLocalIdentity(identity) {
+        this.awareness.setLocalState(identity);
+    }
+    getConnectedUsers() {
+        const users = new Map();
+        for (const [clientId, state] of this.awareness.getStates()) {
+            if (state && typeof state === 'object') {
+                users.set(clientId, state);
+            }
+        }
+        return users;
+    }
+    connect() {
+        if (this.ws)
+            return;
+        const url = `${this.serverUrl}/ws/collab/${this.documentId}`;
+        this.ws = new WebSocket(url);
+        this.ws.binaryType = 'arraybuffer';
+        this.emit('status', [{ status: 'connecting' }]);
+        this.ws.onopen = () => {
+            this.reconnectAttempts = 0;
+            this.emit('status', [{ status: 'connected' }]);
+            const encoder = encoding.createEncoder();
+            encoding.writeVarUint(encoder, MESSAGE_SYNC);
+            syncProtocol.writeSyncStep1(encoder, this.doc);
+            this.ws?.send(encoding.toUint8Array(encoder));
+            // Send local awareness state to server
+            const localState = this.awareness.getLocalState();
+            if (localState) {
+                const awarenessUpdate = awarenessProtocol.encodeAwarenessUpdate(this.awareness, [
+                    this.doc.clientID,
+                ]);
+                const awarenessEncoder = encoding.createEncoder();
+                encoding.writeVarUint(awarenessEncoder, MESSAGE_AWARENESS);
+                encoding.writeVarUint8Array(awarenessEncoder, awarenessUpdate);
+                this.ws?.send(encoding.toUint8Array(awarenessEncoder));
+            }
+            this.updateHandler = (update, origin) => {
+                if (origin === this)
+                    return;
+                const updateEncoder = encoding.createEncoder();
+                encoding.writeVarUint(updateEncoder, MESSAGE_SYNC);
+                syncProtocol.writeUpdate(updateEncoder, update);
+                if (this.ws?.readyState === WebSocket.OPEN) {
+                    this.ws.send(encoding.toUint8Array(updateEncoder));
+                }
+            };
+            this.doc.on('update', this.updateHandler);
+        };
+        this.ws.onmessage = (event) => {
+            const data = new Uint8Array(event.data);
+            const decoder = decoding.createDecoder(data);
+            const messageType = decoding.readVarUint(decoder);
+            if (messageType === MESSAGE_SYNC) {
+                const responseEncoder = encoding.createEncoder();
+                encoding.writeVarUint(responseEncoder, MESSAGE_SYNC);
+                const syncMessageType = syncProtocol.readSyncMessage(decoder, responseEncoder, this.doc, this);
+                if (encoding.length(responseEncoder) > 1) {
+                    this.ws?.send(encoding.toUint8Array(responseEncoder));
+                }
+                if (syncMessageType === 1 && !this.synced)
+                    this.synced = true;
+                this.emit('sync', [true]);
+            }
+            else if (messageType === MESSAGE_AWARENESS) {
+                const update = decoding.readVarUint8Array(decoder);
+                awarenessProtocol.applyAwarenessUpdate(this.awareness, update, 'remote');
+                this.emit('awareness', [this.getConnectedUsers()]);
+            }
+        };
+        this.ws.onclose = () => {
+            if (this.updateHandler) {
+                this.doc.off('update', this.updateHandler);
+                this.updateHandler = null;
+            }
+            this.ws = null;
+            this.synced = false;
+            this.emit('sync', [false]);
+            this.emit('status', [{ status: 'disconnected' }]);
+            this.scheduleReconnect();
+        };
+        this.ws.onerror = () => {
+            this.ws?.close();
+        };
+    }
+    disconnect() {
+        this.cancelReconnect();
+        if (this.updateHandler) {
+            this.doc.off('update', this.updateHandler);
+            this.updateHandler = null;
+        }
+        // Broadcast awareness removal before disconnecting
+        awarenessProtocol.removeAwarenessStates(this.awareness, [this.doc.clientID], 'local');
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.synced = false;
+        this.emit('status', [{ status: 'disconnected' }]);
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+            this.emit('status', [{ status: 'failed' }]);
+            return;
+        }
+        const delay = BASE_RECONNECT_DELAY * RECONNECT_MULTIPLIER ** this.reconnectAttempts;
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+    cancelReconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.reconnectAttempts = 0;
+    }
+    destroy() {
+        this.awareness.off('update', this.awarenessUpdateHandler);
+        this.disconnect();
+        this.awareness.destroy();
+        super.destroy();
+    }
+}

package/dist/components/SyncStatusIndicator.d.ts

@@ -0,0 +1,17 @@
+interface SyncStatusIndicatorProps {
+    /** Optional CSS class name for positioning or layout overrides. */
+    className?: string;
+    /** Whether data is currently being synced. */
+    isSyncing?: boolean;
+}
+/**
+ * Visual indicator for sync / connectivity status.
+ *
+ * - **Online + synced**: green dot
+ * - **Online + syncing**: pulsing yellow dot
+ * - **Offline**: red dot with "Offline" label
+ * - **Recently reconnected**: green dot with "Synced" label (fades after 3 s)
+ */
+export declare function SyncStatusIndicator(props: SyncStatusIndicatorProps): React.ReactNode;
+export {};
+//# sourceMappingURL=SyncStatusIndicator.d.ts.map

package/dist/components/SyncStatusIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncStatusIndicator.d.ts","sourceRoot":"","sources":["../../src/components/SyncStatusIndicator.tsx"],"names":[],"mappings":"AAQA,UAAU,wBAAwB;IAChC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,KAAK,CAAC,SAAS,CAgEpF"}

package/dist/components/SyncStatusIndicator.js

@@ -0,0 +1,65 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { useOnlineStatus } from '../hooks/useOnlineStatus.js';
+/** Duration in ms before the "Synced" label fades away. */
+const SYNCED_LABEL_DURATION_MS = 3_000;
+/**
+ * Visual indicator for sync / connectivity status.
+ *
+ * - **Online + synced**: green dot
+ * - **Online + syncing**: pulsing yellow dot
+ * - **Offline**: red dot with "Offline" label
+ * - **Recently reconnected**: green dot with "Synced" label (fades after 3 s)
+ */
+export function SyncStatusIndicator(props) {
+    const { className, isSyncing = false } = props;
+    const { isOnline, wasOffline } = useOnlineStatus();
+    // Show "Synced" label for 3 s after reconnection.
+    const [showSyncedLabel, setShowSyncedLabel] = useState(false);
+    useEffect(() => {
+        if (!wasOffline) {
+            return;
+        }
+        setShowSyncedLabel(true);
+        const timer = setTimeout(() => {
+            setShowSyncedLabel(false);
+        }, SYNCED_LABEL_DURATION_MS);
+        return () => clearTimeout(timer);
+    }, [wasOffline]);
+    // Determine dot color and label.
+    let dotColor;
+    let label = null;
+    let pulse = false;
+    if (!isOnline) {
+        dotColor = '#ef4444'; // red-500
+        label = 'Offline';
+    }
+    else if (isSyncing) {
+        dotColor = '#eab308'; // yellow-500
+        pulse = true;
+    }
+    else if (showSyncedLabel) {
+        dotColor = '#22c55e'; // green-500
+        label = 'Synced';
+    }
+    else {
+        dotColor = '#22c55e'; // green-500
+    }
+    const dotStyle = {
+        display: 'inline-block',
+        width: '8px',
+        height: '8px',
+        borderRadius: '50%',
+        backgroundColor: dotColor,
+        animation: pulse ? 'revealui-pulse 1.5s ease-in-out infinite' : undefined,
+    };
+    const containerStyle = {
+        display: 'inline-flex',
+        alignItems: 'center',
+        gap: '6px',
+        fontSize: '12px',
+        lineHeight: '1',
+    };
+    return (_jsxs("span", { className: className, style: containerStyle, role: "status", "aria-label": label ?? 'Online', children: [_jsx("span", { style: dotStyle }), label !== null ? _jsx("span", { children: label }) : null, pulse ? (_jsx("style", { children: '@keyframes revealui-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.4; } }' })) : null] }));
+}

package/dist/fetch-with-timeout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A fetch wrapper that aborts requests after {@link SHAPE_FETCH_TIMEOUT_MS} (10 s).
+ * Passed as `fetchClient` to ElectricSQL `useShape` so that shape subscription
+ * requests to the CMS proxy do not hang indefinitely.
+ */
+export declare function fetchWithTimeout(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+//# sourceMappingURL=fetch-with-timeout.d.ts.map

package/dist/fetch-with-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-timeout.d.ts","sourceRoot":"","sources":["../src/fetch-with-timeout.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBhG"}

package/dist/fetch-with-timeout.js

@@ -0,0 +1,27 @@
+/** Default timeout for Electric shape proxy fetch requests (milliseconds). */
+const SHAPE_FETCH_TIMEOUT_MS = 10_000;
+/**
+ * A fetch wrapper that aborts requests after {@link SHAPE_FETCH_TIMEOUT_MS} (10 s).
+ * Passed as `fetchClient` to ElectricSQL `useShape` so that shape subscription
+ * requests to the CMS proxy do not hang indefinitely.
+ */
+export function fetchWithTimeout(input, init) {
+    // If the caller already provides a signal, respect it and compose with our timeout.
+    const externalSignal = init?.signal;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), SHAPE_FETCH_TIMEOUT_MS);
+    // If the external signal aborts, forward to our controller.
+    if (externalSignal) {
+        if (externalSignal.aborted) {
+            controller.abort(externalSignal.reason);
+        }
+        else {
+            externalSignal.addEventListener('abort', () => controller.abort(externalSignal.reason), {
+                once: true,
+            });
+        }
+    }
+    return fetch(input, { ...init, signal: controller.signal }).finally(() => {
+        clearTimeout(timeout);
+    });
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useOfflineCache } from './useOfflineCache.js';
+export type { OnlineStatusResult } from './useOnlineStatus.js';
+export { useOnlineStatus } from './useOnlineStatus.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,2 @@
+export { useOfflineCache } from './useOfflineCache.js';
+export { useOnlineStatus } from './useOnlineStatus.js';

package/dist/hooks/useAgentContexts.d.ts

@@ -0,0 +1,29 @@
+import type { MutationResult } from '../mutations.js';
+export interface AgentContextRecord {
+    id: string;
+    session_id: string;
+    agent_id: string;
+    context: Record<string, unknown>;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateAgentContextInput {
+    agent_id: string;
+    context?: Record<string, unknown>;
+    priority?: number;
+}
+export interface UpdateAgentContextInput {
+    context?: Record<string, unknown>;
+    priority?: number;
+}
+export interface UseAgentContextsResult {
+    contexts: AgentContextRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateAgentContextInput) => Promise<MutationResult<AgentContextRecord>>;
+    update: (id: string, data: UpdateAgentContextInput) => Promise<MutationResult<AgentContextRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useAgentContexts(): UseAgentContextsResult;
+//# sourceMappingURL=useAgentContexts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentContexts.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgentContexts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACvF,MAAM,EAAE,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,uBAAuB,KAC1B,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,gBAAgB,IAAI,sBAAsB,CAqBzD"}

package/dist/hooks/useAgentContexts.js

@@ -0,0 +1,22 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+export function useAgentContexts() {
+    const { proxyBaseUrl } = useElectricConfig();
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/agent-contexts`,
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('agent-contexts');
+    return {
+        contexts: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}

package/dist/hooks/useAgentMemory.d.ts

@@ -0,0 +1,34 @@
+import type { MutationResult } from '../mutations.js';
+export interface AgentMemoryRecord {
+    id: string;
+    agent_id: string;
+    content: string;
+    type: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    expires_at: string | null;
+}
+export interface CreateAgentMemoryInput {
+    agent_id: string;
+    content: string;
+    type: string;
+    source: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    expires_at?: string | null;
+}
+export interface UpdateAgentMemoryInput {
+    content?: string;
+    type?: string;
+    metadata?: Record<string, unknown>;
+    expires_at?: string | null;
+}
+export interface UseAgentMemoryResult {
+    memories: AgentMemoryRecord[];
+    isLoading: boolean;
+    error: Error | null;
+    create: (data: CreateAgentMemoryInput) => Promise<MutationResult<AgentMemoryRecord>>;
+    update: (id: string, data: UpdateAgentMemoryInput) => Promise<MutationResult<AgentMemoryRecord>>;
+    remove: (id: string) => Promise<MutationResult<void>>;
+}
+export declare function useAgentMemory(agentId: string): UseAgentMemoryResult;
+//# sourceMappingURL=useAgentMemory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentMemory.d.ts","sourceRoot":"","sources":["../../src/hooks/useAgentMemory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAOtD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjG,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAuCpE"}

package/dist/hooks/useAgentMemory.js

@@ -0,0 +1,37 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+import { fetchWithTimeout } from '../fetch-with-timeout.js';
+import { useSyncMutations } from '../mutations.js';
+import { useElectricConfig } from '../provider/index.js';
+import { toRecords } from '../shape-utils.js';
+const AGENT_ID_RE = /^[a-zA-Z0-9_-]+$/;
+export function useAgentMemory(agentId) {
+    const { proxyBaseUrl } = useElectricConfig();
+    const isValid = agentId.length > 0 && AGENT_ID_RE.test(agentId);
+    // Hook must always be called (Rules of Hooks). Pass an impossible WHERE when
+    // the ID is invalid so the shape returns no rows but the hook still runs.
+    const { data, isLoading, error } = useShape({
+        url: `${proxyBaseUrl}/api/shapes/agent-memories`,
+        params: { agent_id: isValid ? agentId : '00000000-0000-0000-0000-000000000000' },
+        fetchClient: fetchWithTimeout,
+    });
+    const { create, update, remove } = useSyncMutations('agent-memories');
+    if (!isValid) {
+        return {
+            memories: [],
+            isLoading: false,
+            error: new Error('Invalid agentId: must be non-empty alphanumeric, hyphens, underscores only'),
+            create,
+            update,
+            remove,
+        };
+    }
+    return {
+        memories: toRecords(data),
+        isLoading,
+        error: error || null,
+        create,
+        update,
+        remove,
+    };
+}