@revealui/sync 0.2.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 RevealUI Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,223 @@
+# @revealui/sync
+
+**Status:** 🟡 Active Development | ⚠️ NOT Production Ready
+
+See [Project Status](../../docs/PROJECT_STATUS.md) for framework readiness.
+
+ElectricSQL sync utilities for RevealUI - real-time data synchronization with local-first architecture.
+
+## Features
+
+- **ElectricSQL Integration**: Real-time sync with ElectricSQL
+- **React Hooks**: Use sync data in React components
+- **Type-safe**: Full TypeScript support with database types
+- **Local-first**: Works offline, syncs when online
+- **React Provider**: Easy setup with `ElectricProvider`
+- **Optimistic Updates**: Instant UI updates with server reconciliation
+
+## Installation
+
+```bash
+pnpm add @revealui/sync
+```
+
+## Usage
+
+### Setup Provider
+
+Wrap your app with `ElectricProvider`:
+
+```typescript
+import { ElectricProvider } from '@revealui/sync/provider'
+
+export default function App() {
+  return (
+    <ElectricProvider>
+      <YourComponents />
+    </ElectricProvider>
+  )
+}
+```
+
+### Use Synced Data
+
+```typescript
+import { useAgentContexts } from '@revealui/sync'
+
+function MyComponent() {
+  const { data: contexts, isLoading } = useAgentContexts()
+
+  if (isLoading) return <div>Loading...</div>
+
+  return (
+    <ul>
+      {contexts.map(context => (
+        <li key={context.id}>{context.name}</li>
+      ))}
+    </ul>
+  )
+}
+```
+
+### Mutations
+
+```typescript
+import { useAgentContexts } from '@revealui/sync'
+
+function CreateContext() {
+  const { create } = useAgentContexts()
+
+  const handleCreate = async () => {
+    await create({
+      name: 'New Context',
+      agent_id: 'agent-123',
+      // ... other fields
+    })
+  }
+
+  return <button onClick={handleCreate}>Create</button>
+}
+```
+
+## Available Hooks
+
+### `useAgentContexts()`
+
+Sync agent contexts (task context, working memory, etc.)
+
+```typescript
+const {
+  data,        // Agent contexts array
+  isLoading,   // Loading state
+  error,       // Error state
+  create,      // Create function
+  update,      // Update function
+  remove       // Delete function
+} = useAgentContexts()
+```
+
+### `useAgentMemory()`
+
+Sync agent memory (episodic, semantic, working)
+
+```typescript
+const {
+  data,        // Memory entries array
+  isLoading,
+  error,
+  create,
+  update,
+  remove
+} = useAgentMemory()
+```
+
+### `useConversations()`
+
+Sync conversation history
+
+```typescript
+const {
+  data,        // Conversations array
+  isLoading,
+  error,
+  create,
+  update,
+  remove
+} = useConversations()
+```
+
+## How It Works
+
+1. **ElectricSQL Service**: Runs as a sync service between Postgres and clients
+2. **Shape Subscriptions**: Subscribe to "shapes" of data (queries)
+3. **Local Cache**: Data cached locally in browser
+4. **Real-time Updates**: Changes propagate instantly to all connected clients
+5. **Conflict Resolution**: CRDT-based conflict resolution for offline edits
+
+## Environment Variables
+
+```env
+# ElectricSQL service URL
+NEXT_PUBLIC_ELECTRIC_SERVICE_URL=http://localhost:5133
+
+# Optional: Server-side Electric URL (if different)
+ELECTRIC_SERVICE_URL=http://localhost:5133
+```
+
+## Development
+
+```bash
+# Build package
+pnpm --filter @revealui/sync build
+
+# Watch mode
+pnpm --filter @revealui/sync dev
+
+# Run tests
+pnpm --filter @revealui/sync test
+
+# Type check
+pnpm --filter @revealui/sync typecheck
+```
+
+## Testing
+
+```bash
+# Run all tests
+pnpm --filter @revealui/sync test
+
+# Watch mode
+pnpm --filter @revealui/sync test:watch
+
+# Coverage
+pnpm --filter @revealui/sync test:coverage
+```
+
+## Architecture
+
+```
+┌─────────────────┐
+│  React Component │
+│  (useAgentContexts) │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  ElectricSQL    │
+│  Shape Hook     │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  Electric Sync  │
+│  Service        │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  PostgreSQL     │
+│  Database       │
+└─────────────────┘
+```
+
+## Limitations
+
+⚠️ **CRITICAL**: ElectricSQL API endpoints need independent verification before production use.
+
+**Status:** ⚠️ NEEDS VERIFICATION
+- ElectricSQL integration exists but requires testing
+- API endpoints based on assumptions
+- No integration tests performed yet
+- Not recommended for production until verified
+
+See [Project Roadmap](../../docs/PROJECT_ROADMAP.md) and [Production Readiness](../../docs/PRODUCTION_READINESS.md) for details.
+
+## Related Documentation
+
+- [ElectricSQL Documentation](https://electric-sql.com/docs) - Official ElectricSQL docs
+- [Architecture](../../docs/ARCHITECTURE.md) - System architecture overview
+- [Database Guide](../../docs/DATABASE.md) - Database setup
+
+## License
+
+MIT

package/dist/collab/agent-client-factory.d.ts

@@ -0,0 +1,16 @@
+import { AgentCollabClient } from './agent-client.js';
+export interface CreateAgentClientOptions {
+    serverUrl: string;
+    documentId: string;
+    name?: string;
+    model?: string;
+    color?: string;
+    authToken?: string;
+    autoReconnect?: boolean;
+    defaultTextName?: string;
+}
+export declare function createAgentClient(options: CreateAgentClientOptions): AgentCollabClient;
+export declare function createAndConnectAgentClient(options: CreateAgentClientOptions & {
+    syncTimeoutMs?: number;
+}): Promise<AgentCollabClient>;
+//# sourceMappingURL=agent-client-factory.d.ts.map

package/dist/collab/agent-client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-factory.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,mBAAmB,CAAA;AAIzE,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAgBtF;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,wBAAwB,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}

package/dist/collab/agent-client-factory.js

@@ -0,0 +1,24 @@
+import { AgentCollabClient } from './agent-client.js';
+const DEFAULT_AGENT_COLOR = '#8B5CF6';
+export function createAgentClient(options) {
+    const identity = {
+        type: 'agent',
+        name: options.name ?? 'AI Agent',
+        model: options.model ?? 'unknown',
+        color: options.color ?? DEFAULT_AGENT_COLOR,
+    };
+    return new AgentCollabClient({
+        serverUrl: options.serverUrl,
+        documentId: options.documentId,
+        identity,
+        authToken: options.authToken,
+        autoReconnect: options.autoReconnect,
+        defaultTextName: options.defaultTextName,
+    });
+}
+export async function createAndConnectAgentClient(options) {
+    const client = createAgentClient(options);
+    client.connect();
+    await client.waitForSync(options.syncTimeoutMs ?? 5000);
+    return client;
+}

package/dist/collab/agent-client.d.ts

@@ -0,0 +1,55 @@
+import { Observable } from 'lib0/observable';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import * as Y from 'yjs';
+export interface AgentIdentity {
+    type: 'agent';
+    name: string;
+    model: string;
+    color: string;
+}
+export interface AgentCollabClientOptions {
+    serverUrl: string;
+    documentId: string;
+    identity: AgentIdentity;
+    authToken?: string;
+    autoReconnect?: boolean;
+    defaultTextName?: string;
+}
+export declare class AgentCollabClient extends Observable<string> {
+    readonly doc: Y.Doc;
+    readonly awareness: awarenessProtocol.Awareness;
+    private readonly serverUrl;
+    private readonly documentId;
+    private readonly identity;
+    private readonly authToken?;
+    private readonly autoReconnect;
+    private readonly defaultTextName;
+    private ws;
+    private synced;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private updateHandler;
+    private awarenessUpdateHandler;
+    private destroyed;
+    constructor(options: AgentCollabClientOptions);
+    connect(): void;
+    disconnect(): void;
+    getDocument(): Y.Doc;
+    getText(name?: string): Y.Text;
+    getTextContent(name?: string): string;
+    insertText(index: number, content: string, name?: string): void;
+    deleteText(index: number, length: number, name?: string): void;
+    replaceAll(content: string, name?: string): void;
+    onUpdate(callback: (update: Uint8Array) => void): () => void;
+    getConnectedUsers(): Map<number, Record<string, unknown>>;
+    waitForSync(timeoutMs?: number): Promise<void>;
+    destroy(): void;
+    private buildWebSocketUrl;
+    private handleOpen;
+    private handleMessage;
+    private handleClose;
+    private handleError;
+    private scheduleReconnect;
+    private cancelReconnect;
+}
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/collab/agent-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.d.ts","sourceRoot":"","sources":["../../src/collab/agent-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAQxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,MAAM,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAA;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IAExC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,sBAAsB,CAGrB;IACT,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,EAAE,wBAAwB;IA0B7C,OAAO,IAAI,IAAI;IAcf,UAAU,IAAI,IAAI;IAkBlB,WAAW,IAAI,CAAC,CAAC,GAAG;IAIpB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;IAI9B,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAMrC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAU5D,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUzD,WAAW,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5C,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/collab/agent-client.js

@@ -0,0 +1,253 @@
+import * as decoding from 'lib0/decoding';
+import * as encoding from 'lib0/encoding';
+import { Observable } from 'lib0/observable';
+import WebSocket from 'ws';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import * as syncProtocol from 'y-protocols/sync';
+import * as Y from 'yjs';
+const MESSAGE_SYNC = 0;
+const MESSAGE_AWARENESS = 1;
+const MAX_RECONNECT_ATTEMPTS = 5;
+const BASE_RECONNECT_DELAY = 1000;
+const RECONNECT_MULTIPLIER = 2;
+export class AgentCollabClient extends Observable {
+    doc;
+    awareness;
+    serverUrl;
+    documentId;
+    identity;
+    authToken;
+    autoReconnect;
+    defaultTextName;
+    ws = null;
+    synced = false;
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    updateHandler = null;
+    awarenessUpdateHandler;
+    destroyed = false;
+    constructor(options) {
+        super();
+        this.serverUrl = options.serverUrl;
+        this.documentId = options.documentId;
+        this.identity = options.identity;
+        this.authToken = options.authToken;
+        this.autoReconnect = options.autoReconnect ?? true;
+        this.defaultTextName = options.defaultTextName ?? 'content';
+        this.doc = new Y.Doc();
+        this.awareness = new awarenessProtocol.Awareness(this.doc);
+        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);
+    }
+    connect() {
+        if (this.ws || this.destroyed)
+            return;
+        const url = this.buildWebSocketUrl();
+        this.ws = new WebSocket(url);
+        this.emit('status', [{ status: 'connecting' }]);
+        this.ws.on('open', () => this.handleOpen());
+        this.ws.on('message', (data) => this.handleMessage(data));
+        this.ws.on('close', () => this.handleClose());
+        this.ws.on('error', (err) => this.handleError(err));
+    }
+    disconnect() {
+        this.cancelReconnect();
+        if (this.updateHandler) {
+            this.doc.off('update', this.updateHandler);
+            this.updateHandler = null;
+        }
+        awarenessProtocol.removeAwarenessStates(this.awareness, [this.doc.clientID], 'local');
+        if (this.ws) {
+            this.ws.removeAllListeners();
+            this.ws.close();
+            this.ws = null;
+        }
+        this.synced = false;
+        this.emit('status', [{ status: 'disconnected' }]);
+    }
+    getDocument() {
+        return this.doc;
+    }
+    getText(name) {
+        return this.doc.getText(name ?? this.defaultTextName);
+    }
+    getTextContent(name) {
+        // Y.Text.toString() returns the text content — ESLint doesn't recognize this
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        return this.getText(name).toString();
+    }
+    insertText(index, content, name) {
+        this.getText(name).insert(index, content);
+    }
+    deleteText(index, length, name) {
+        this.getText(name).delete(index, length);
+    }
+    replaceAll(content, name) {
+        const text = this.getText(name);
+        this.doc.transact(() => {
+            text.delete(0, text.length);
+            text.insert(0, content);
+        });
+    }
+    onUpdate(callback) {
+        const handler = (update, origin) => {
+            if (origin !== this) {
+                callback(update);
+            }
+        };
+        this.doc.on('update', handler);
+        return () => this.doc.off('update', handler);
+    }
+    getConnectedUsers() {
+        const users = new Map();
+        for (const [clientId, state] of this.awareness.getStates()) {
+            if (state && typeof state === 'object') {
+                users.set(clientId, state);
+            }
+        }
+        return users;
+    }
+    waitForSync(timeoutMs = 5000) {
+        if (this.synced)
+            return Promise.resolve();
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.off('sync', handler);
+                reject(new Error(`Sync timeout after ${timeoutMs}ms`));
+            }, timeoutMs);
+            const handler = (isSynced) => {
+                if (isSynced) {
+                    clearTimeout(timeout);
+                    this.off('sync', handler);
+                    resolve();
+                }
+            };
+            this.on('sync', handler);
+        });
+    }
+    destroy() {
+        this.destroyed = true;
+        this.awareness.off('update', this.awarenessUpdateHandler);
+        this.disconnect();
+        this.awareness.destroy();
+        this.doc.destroy();
+        super.destroy();
+    }
+    buildWebSocketUrl() {
+        const params = new URLSearchParams({
+            name: this.identity.name,
+            color: this.identity.color,
+            type: 'agent',
+            agentModel: this.identity.model,
+        });
+        if (this.authToken) {
+            params.set('token', this.authToken);
+        }
+        return `${this.serverUrl}/ws/collab/${this.documentId}?${params.toString()}`;
+    }
+    handleOpen() {
+        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));
+        this.awareness.setLocalState({
+            name: this.identity.name,
+            color: this.identity.color,
+            type: 'agent',
+            agentModel: this.identity.model,
+        });
+        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);
+    }
+    handleMessage(data) {
+        const uint8 = data instanceof ArrayBuffer
+            ? new Uint8Array(data)
+            : Array.isArray(data)
+                ? new Uint8Array(Buffer.concat(data))
+                : new Uint8Array(data);
+        const decoder = decoding.createDecoder(uint8);
+        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()]);
+        }
+    }
+    handleClose() {
+        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' }]);
+        if (this.autoReconnect && !this.destroyed) {
+            this.scheduleReconnect();
+        }
+    }
+    handleError(err) {
+        this.emit('error', [err]);
+        this.ws?.close();
+    }
+    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;
+    }
+}

package/dist/collab/index.d.ts

@@ -0,0 +1,7 @@
+export type { CollabDocumentState } from './use-collab-document.js';
+export { useCollabDocument } from './use-collab-document.js';
+export type { CollaborationIdentity, UseCollaborationOptions, UseCollaborationResult, } from './use-collaboration.js';
+export { useCollaboration } from './use-collaboration.js';
+export type { UserPresence } from './yjs-websocket-provider.js';
+export { CollabProvider } from './yjs-websocket-provider.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/collab/index.js

@@ -0,0 +1,3 @@
+export { useCollabDocument } from './use-collab-document.js';
+export { useCollaboration } from './use-collaboration.js';
+export { CollabProvider } from './yjs-websocket-provider.js';

package/dist/collab/server-index.d.ts

@@ -0,0 +1,5 @@
+export type { AgentCollabClientOptions, AgentIdentity } from './agent-client.js';
+export { AgentCollabClient } from './agent-client.js';
+export type { CreateAgentClientOptions } from './agent-client-factory.js';
+export { createAgentClient, createAndConnectAgentClient } from './agent-client-factory.js';
+//# sourceMappingURL=server-index.d.ts.map

package/dist/collab/server-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-index.d.ts","sourceRoot":"","sources":["../../src/collab/server-index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/collab/server-index.js

@@ -0,0 +1,2 @@
+export { AgentCollabClient } from './agent-client.js';
+export { createAgentClient, createAndConnectAgentClient } from './agent-client-factory.js';

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

@@ -0,0 +1,8 @@
+export interface CollabDocumentState {
+    initialState: Uint8Array | null;
+    connectedClients: number;
+    isLoading: boolean;
+    error: Error | null;
+}
+export declare function useCollabDocument(documentId: string, electricUrl: string): CollabDocumentState;
+//# sourceMappingURL=use-collab-document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-collab-document.d.ts","sourceRoot":"","sources":["../../src/collab/use-collab-document.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAA;IAC/B,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAKD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA+C9F"}

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

@@ -0,0 +1,46 @@
+import { useShape } from '@electric-sql/react';
+// 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, electricUrl) {
+    // 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: `${electricUrl}/v1/shape`,
+        params: {
+            table: 'yjs_documents',
+            where: isValidId ? `id = '${documentId}'` : `id = 'invalid'`,
+        },
+    });
+    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,CAAA;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAA;IACjB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC1C;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,CAAA;AAC5C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAQxB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,qBAAa,cAAe,SAAQ,UAAU,CAAC,MAAM,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAA;IACtC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,sBAAsB,CAGrB;gBAGP,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,173 @@
+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';
+const MESSAGE_SYNC = 0;
+const MESSAGE_AWARENESS = 1;
+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/hooks/useConversations.d.ts

@@ -0,0 +1,11 @@
+type ConversationRecord = {
+    id: string | number;
+    title?: string | null;
+};
+export declare function useConversations(_userId: string): {
+    conversations: ConversationRecord[];
+    isLoading: boolean;
+    error: Error | null;
+};
+export {};
+//# sourceMappingURL=useConversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useConversations.d.ts","sourceRoot":"","sources":["../../src/hooks/useConversations.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB,CAAA;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM;;;WAU5B,KAAK,GAAG,IAAI;EAE/B"}

package/dist/hooks/useConversations.js

@@ -0,0 +1,16 @@
+'use client';
+import { useShape } from '@electric-sql/react';
+// _userId kept for API compatibility — filtering is enforced by the server-side
+// proxy at /api/shapes/conversations, which reads the session cookie directly.
+export function useConversations(_userId) {
+    // The proxy validates the session and enforces row-level filtering server-side.
+    // Client-provided params are not forwarded — the proxy overrides them.
+    const { data, isLoading, error } = useShape({
+        url: `/api/shapes/conversations`,
+    });
+    return {
+        conversations: Array.isArray(data) ? data : [],
+        isLoading,
+        error: error,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { CollabDocumentState, UseCollaborationOptions, UseCollaborationResult, } from './collab/index.js';
+export { CollabProvider, useCollabDocument, useCollaboration, } from './collab/index.js';
+export { useConversations } from './hooks/useConversations.js';
+export { ElectricProvider } from './provider/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CollabProvider, useCollabDocument, useCollaboration, } from './collab/index.js';
+export { useConversations } from './hooks/useConversations.js';
+export { ElectricProvider } from './provider/index.js';

package/dist/provider/index.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+export declare function ElectricProvider({ children, }: {
+    children: ReactNode;
+    serviceUrl?: string;
+    debug?: boolean;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,SAAS,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,2CAIA"}

package/dist/provider/index.js

@@ -0,0 +1,8 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+// ElectricProvider placeholder - useShape works with proxy API
+export function ElectricProvider({ children, }) {
+    // For now, just pass through children
+    // useShape hooks work directly with proxy API endpoints
+    return _jsx(_Fragment, { children: children });
+}

package/dist/test-setup.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAA"}

package/dist/test-setup.js

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@revealui/sync",
+  "version": "0.2.0",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "description": "ElectricSQL sync utilities for RevealUI",
+  "dependencies": {
+    "@electric-sql/react": "^1.0.27",
+    "lib0": "^0.2.117",
+    "ws": "^8.18.0",
+    "y-protocols": "^1.0.7",
+    "yjs": "^13.6.29",
+    "@revealui/contracts": "1.0.0",
+    "@revealui/db": "0.2.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.4",
+    "@types/ws": "^8.5.14",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/react-hooks": "^8.0.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "jsdom": "^27.4.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18",
+    "dev": "0.0.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider/index.d.ts",
+      "import": "./dist/provider/index.js"
+    },
+    "./collab": {
+      "types": "./dist/collab/index.d.ts",
+      "import": "./dist/collab/index.js"
+    },
+    "./collab/server": {
+      "types": "./dist/collab/server-index.d.ts",
+      "import": "./dist/collab/server-index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "lint": "biome check .",
+    "lint:eslint": "eslint .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}