@adonis-agora/collaboration-client 0.2.0

package/README.md

@@ -0,0 +1,86 @@
+# @adonis-agora/collaboration-client
+
+React client hooks for [`@adonis-agora/collaboration`](https://github.com/DavideCarvalho/adonis-agora-collaboration) — collaborative documents, presence, anchored comments and version control with automatic transport selection (Hocuspocus self-hosted or PartyKit edge).
+
+React 18/19 · zero dependencies beyond `yjs` stack · ESM.
+
+## Install
+
+```sh
+pnpm add @adonis-agora/collaboration-client
+```
+
+Server side: install `@adonis-agora/collaboration` and run `node ace collaboration:init` to publish the REST routes these hooks consume.
+
+## Usage
+
+Wrap your app once:
+
+```tsx
+import { CollaborationProvider } from '@adonis-agora/collaboration-client'
+
+<CollaborationProvider
+  baseUrl="https://api.app"
+  getHeaders={() => ({ cookie: sessionCookie })}
+>
+  <App />
+</CollaborationProvider>
+```
+
+Then per collaborative view:
+
+```tsx
+import {
+  useCollabDoc,
+  useAwareness,
+  useComments,
+  useVersions,
+} from '@adonis-agora/collaboration-client'
+
+function Writing({ docName }: { docName: string }) {
+  // Y.Doc shared per docName (cached across mounts), + connection status
+  const { doc, status, error } = useCollabDoc(docName)
+  const { peers } = useAwareness(docName)          // who's online
+  const { comments, create, resolve, remove } = useComments(docName, 'text')
+  const { versions, create: createVersion, restore } = useVersions(docName)
+
+  if (status === 'error') return <p>{error?.message}</p>
+
+  return (
+    <>
+      {/* feed `doc` into Tiptap / ProseMirror / Monaco… */}
+      {peers.map((peer) => <Avatar key={peer.clientId} name={peer.name} />)}
+    </>
+  )
+}
+```
+
+## How it works
+
+1. `useCollabDoc` fetches an ephemeral token from `GET {baseUrl}/collaboration/token?doc=<name>` (your auth middleware protects this route).
+2. The response's `engine` field picks the transport:
+   - `yjs` → `HocuspocusProvider` against the Adonis server (`wsUrl` path)
+   - `partykit` → `YPartyKitProvider` straight to the Cloudflare room
+3. Comments and versions are **REST**, not CRDT state — they live in your database via the server package's storage.
+4. Sessions survive component unmounts; one `Y.Doc` per document name per provider.
+
+## Custom transport
+
+Bring your own sync engine by injecting a factory:
+
+```tsx
+<CollaborationProvider baseUrl="…" createTransport={(info, doc, docName) => new MyTransport(info, doc)}>
+```
+
+## API
+
+| Hook | Returns |
+|---|---|
+| `useCollabDoc(docName)` | `{ doc: Y.Doc, status: 'connecting'\|'connected'\|'disconnected'\|'error', error }` |
+| `useAwareness(docName)` | `{ peers: CollabPeer[], status }` |
+| `useComments(docName, space?)` | `{ comments, loading, error, refresh, create, resolve, remove }` |
+| `useVersions(docName)` | `{ versions, loading, error, refresh, create, restore }` |
+
+## License
+
+MIT

package/dist/src/context.d.ts

@@ -0,0 +1,28 @@
+import { type ReactNode } from 'react';
+import { DocSession } from './session.js';
+import type { CollaborationClientConfig } from './types.js';
+interface CollaborationContextValue {
+    /** Sempre retorna o config mais recente do render atual. */
+    getConfig(): CollaborationClientConfig;
+    sessions: Map<string, DocSession>;
+}
+export interface CollaborationProviderProps extends CollaborationClientConfig {
+    children: ReactNode;
+}
+/**
+ * Provider raiz. Uma sessão (Y.Doc + transporte) por docName — sobrevive a
+ * unmount de componentes individuais e é destruída junto com o provider.
+ *
+ * ```tsx
+ * <CollaborationProvider baseUrl="https://api.app" getHeaders={() => ({ cookie: ... })}>
+ *   <Editor docName="researches/42/writing" />
+ * </CollaborationProvider>
+ * ```
+ */
+export declare function CollaborationProvider({ children, ...config }: CollaborationProviderProps): import("react/jsx-runtime").JSX.Element;
+/** Contexto interno — lança se usado fora do provider. */
+export declare function useCollaborationContext(): CollaborationContextValue;
+/** Pega ou cria a sessão do documento (1 Y.Doc por docName). */
+export declare function getOrCreateSession(context: CollaborationContextValue, docName: string): DocSession;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,UAAU,yBAAyB;IACjC,4DAA4D;IAC5D,SAAS,IAAI,yBAAyB,CAAC;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACnC;AAID,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,0BAA0B,2CAkBxF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,IAAI,yBAAyB,CAMnE;AAED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,EAClC,OAAO,EAAE,MAAM,GACd,UAAU,CAOZ"}

package/dist/src/context.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo, useRef } from 'react';
+import { DocSession } from './session.js';
+const CollaborationContext = createContext(null);
+/**
+ * Provider raiz. Uma sessão (Y.Doc + transporte) por docName — sobrevive a
+ * unmount de componentes individuais e é destruída junto com o provider.
+ *
+ * ```tsx
+ * <CollaborationProvider baseUrl="https://api.app" getHeaders={() => ({ cookie: ... })}>
+ *   <Editor docName="researches/42/writing" />
+ * </CollaborationProvider>
+ * ```
+ */
+export function CollaborationProvider({ children, ...config }) {
+    const sessionsRef = useRef(null);
+    if (sessionsRef.current === null) {
+        sessionsRef.current = new Map();
+    }
+    const configRef = useRef(config);
+    configRef.current = config;
+    const value = useMemo(() => ({
+        getConfig: () => configRef.current,
+        sessions: sessionsRef.current,
+    }), []);
+    return _jsx(CollaborationContext.Provider, { value: value, children: children });
+}
+/** Contexto interno — lança se usado fora do provider. */
+export function useCollaborationContext() {
+    const context = useContext(CollaborationContext);
+    if (!context) {
+        throw new Error('useCollabDoc/useAwareness exigem <CollaborationProvider> no tree');
+    }
+    return context;
+}
+/** Pega ou cria a sessão do documento (1 Y.Doc por docName). */
+export function getOrCreateSession(context, docName) {
+    let session = context.sessions.get(docName);
+    if (!session) {
+        session = new DocSession(docName, context.getConfig());
+        context.sessions.set(docName, session);
+    }
+    return session;
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAkB,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS1C,MAAM,oBAAoB,GAAG,aAAa,CAAmC,IAAI,CAAC,CAAC;AAMnF;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,EAA8B;IACvF,MAAM,WAAW,GAAG,MAAM,CAAiC,IAAI,CAAC,CAAC;IACjE,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACjC,WAAW,CAAC,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtD,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAA4B,MAAM,CAAC,CAAC;IAC5D,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO;QAClC,QAAQ,EAAE,WAAW,CAAC,OAAkC;KACzD,CAAC,EACF,EAAE,CACH,CAAC;IAEF,OAAO,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAiC,CAAC;AACjG,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAChC,OAAkC,EAClC,OAAe;IAEf,IAAI,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/hooks/use_automerge_doc.d.ts

@@ -0,0 +1,29 @@
+import * as A from '@automerge/automerge';
+import type { CollabStatus } from '../types.js';
+/**
+ * Automerge client — deliberately OUTSIDE the Y.Doc-centric
+ * CollabTransport seam. Tiptap/awareness need a Y.Doc; Automerge documents
+ * are a different data structure, so this ships its own small hook instead
+ * of forcing both worlds behind one interface.
+ *
+ * Wire protocol mirrors the server's AutomergeDriver:
+ *  1. ws `${wsUrl}?doc=<name>&token=<token>` (token via fetchToken)
+ *  2. server sends the full `A.save(doc)` binary on connect
+ *  3. client sends its full saved doc after local changes (debounced)
+ *  4. incoming binaries are merged into the local doc and re-broadcast by
+ *     the server to the other peers
+ */
+export interface UseAutomergeDocResult<T extends Record<string, unknown>> {
+    /** Merged Automerge doc; null until the first server payload arrives. */
+    doc: A.Doc<T> | null;
+    status: CollabStatus;
+    error: Error | null;
+    /** Applies a local change and schedules the debounced send. */
+    change(cb: A.ChangeFn<T>): void;
+}
+interface Options {
+    WebSocketImpl?: typeof WebSocket;
+}
+export declare function useAutomergeDoc<T extends Record<string, unknown> = Record<string, unknown>>(docName: string, options?: Options): UseAutomergeDocResult<T>;
+export {};
+//# sourceMappingURL=use_automerge_doc.d.ts.map

package/dist/src/hooks/use_automerge_doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_automerge_doc.d.ts","sourceRoot":"","sources":["../../../src/hooks/use_automerge_doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,sBAAsB,CAAC;AAI1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtE,yEAAyE;IACzE,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,UAAU,OAAO;IACf,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;CAClC;AAID,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzF,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAY,GACpB,qBAAqB,CAAC,CAAC,CAAC,CAiG1B"}

package/dist/src/hooks/use_automerge_doc.js

@@ -0,0 +1,93 @@
+import * as A from '@automerge/automerge';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getOrCreateSession, useCollaborationContext } from '../context.js';
+import { fetchToken } from '../rest_client.js';
+const SEND_DEBOUNCE_MS = 200;
+export function useAutomergeDoc(docName, options = {}) {
+    const context = useCollaborationContext();
+    const config = context.getConfig();
+    const { WebSocketImpl } = options;
+    // Keeps the shared session lifecycle alive (token endpoint + provider).
+    void getOrCreateSession(context, docName);
+    const [doc, setDoc] = useState(null);
+    const [status, setStatus] = useState('connecting');
+    const [error, setError] = useState(null);
+    const wsRef = useRef(null);
+    const localDocRef = useRef(null);
+    const sendTimerRef = useRef(undefined);
+    const aliveRef = useRef(true);
+    useEffect(() => {
+        aliveRef.current = true;
+        let cancelled = false;
+        (async () => {
+            try {
+                const info = await fetchToken(config, docName);
+                if (cancelled || info.engine !== 'automerge') {
+                    if (!cancelled && info.engine !== 'automerge') {
+                        throw new Error(`useAutomergeDoc requires engine=automerge (got ${info.engine})`);
+                    }
+                    return;
+                }
+                const base = config.baseUrl.replace(/\/$/, '');
+                const wsUrl = info.wsUrl.startsWith('ws')
+                    ? `${info.wsUrl}?doc=${encodeURIComponent(docName)}&token=${encodeURIComponent(info.token)}`
+                    : `${base.replace(/^http/, 'ws')}${info.wsUrl}?doc=${encodeURIComponent(docName)}&token=${encodeURIComponent(info.token)}`;
+                const ws = new (WebSocketImpl ?? globalThis.WebSocket)(wsUrl);
+                ws.binaryType = 'arraybuffer';
+                wsRef.current = ws;
+                ws.onopen = () => {
+                    if (!cancelled)
+                        setStatus('connected');
+                };
+                ws.onmessage = (event) => {
+                    if (cancelled)
+                        return;
+                    const bytes = new Uint8Array(event.data);
+                    const incoming = A.load(bytes);
+                    const next = localDocRef.current ? A.merge(localDocRef.current, incoming) : incoming;
+                    localDocRef.current = next;
+                    setDoc(next);
+                };
+                ws.onerror = () => {
+                    if (!cancelled)
+                        setStatus('error');
+                };
+                ws.onclose = () => {
+                    if (!cancelled)
+                        setStatus('disconnected');
+                };
+            }
+            catch (cause) {
+                if (!cancelled) {
+                    setStatus('error');
+                    setError(cause instanceof Error ? cause : new Error(String(cause)));
+                }
+            }
+        })();
+        return () => {
+            cancelled = true;
+            aliveRef.current = false;
+            if (sendTimerRef.current)
+                clearTimeout(sendTimerRef.current);
+            wsRef.current?.close();
+            wsRef.current = null;
+        };
+    }, [docName, config, WebSocketImpl]);
+    const change = useCallback((cb) => {
+        if (!localDocRef.current)
+            return;
+        localDocRef.current = A.change(localDocRef.current, cb);
+        setDoc(localDocRef.current);
+        if (sendTimerRef.current)
+            clearTimeout(sendTimerRef.current);
+        sendTimerRef.current = setTimeout(() => {
+            const ws = wsRef.current;
+            if (ws?.readyState === (WebSocketImpl ?? globalThis.WebSocket).OPEN &&
+                localDocRef.current) {
+                ws.send(A.save(localDocRef.current));
+            }
+        }, SEND_DEBOUNCE_MS);
+    }, [WebSocketImpl]);
+    return { doc, status, error, change };
+}
+//# sourceMappingURL=use_automerge_doc.js.map

package/dist/src/hooks/use_automerge_doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_automerge_doc.js","sourceRoot":"","sources":["../../../src/hooks/use_automerge_doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAmB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA8BhE,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,UAAmB,EAAE;IAErB,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAClC,wEAAwE;IACxE,KAAK,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE1C,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAkB,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAe,YAAY,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,KAAK,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,MAAM,CAA4C,SAAS,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE9B,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QACxB,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC/C,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAC7C,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;wBAC9C,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;oBACpF,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;oBACvC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,QAAQ,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;oBAC5F,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,QAAQ,kBAAkB,CAAC,OAAO,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAE7H,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC9D,EAAE,CAAC,UAAU,GAAG,aAAa,CAAC;gBAC9B,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;gBAEnB,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;oBACf,IAAI,CAAC,SAAS;wBAAE,SAAS,CAAC,WAAW,CAAC,CAAC;gBACzC,CAAC,CAAC;gBAEF,EAAE,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;oBACvB,IAAI,SAAS;wBAAE,OAAO;oBACtB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,IAAmB,CAAC,CAAC;oBACxD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAI,KAAK,CAAC,CAAC;oBAClC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;oBACrF,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;oBAC3B,MAAM,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC,CAAC;gBAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;oBAChB,IAAI,CAAC,SAAS;wBAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC,CAAC;gBAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;oBAChB,IAAI,CAAC,SAAS;wBAAE,SAAS,CAAC,cAAc,CAAC,CAAC;gBAC5C,CAAC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,CAAC,OAAO,CAAC,CAAC;oBACnB,QAAQ,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;YACzB,IAAI,YAAY,CAAC,OAAO;gBAAE,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC7D,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACvB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,EAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,WAAW,CAAC,OAAO;YAAE,OAAO;QACjC,WAAW,CAAC,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE5B,IAAI,YAAY,CAAC,OAAO;YAAE,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7D,YAAY,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACrC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;YACzB,IACE,EAAE,EAAE,UAAU,KAAK,CAAC,aAAa,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI;gBAC/D,WAAW,CAAC,OAAO,EACnB,CAAC;gBACD,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAA2B,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACvB,CAAC,EACD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/src/hooks/use_awareness.d.ts

@@ -0,0 +1,12 @@
+import type { CollabPeer, CollabStatus } from '../types.js';
+export interface UseAwarenessResult {
+    /** Peers conectados (sem o usuário local). */
+    peers: CollabPeer[];
+    status: CollabStatus;
+}
+/**
+ * Presença via awareness: quem está online no documento agora.
+ * Atualiza em mudança de awareness (entrar/sair/atualizar cursor).
+ */
+export declare function useAwareness(docName: string): UseAwarenessResult;
+//# sourceMappingURL=use_awareness.d.ts.map

package/dist/src/hooks/use_awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_awareness.d.ts","sourceRoot":"","sources":["../../../src/hooks/use_awareness.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAmBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CA2BhE"}

package/dist/src/hooks/use_awareness.js

@@ -0,0 +1,47 @@
+import { useEffect, useState } from 'react';
+import { getOrCreateSession, useCollaborationContext } from '../context.js';
+function snapshotPeers(awareness) {
+    const localId = awareness.clientID;
+    const peers = [];
+    for (const [clientId, state] of awareness.getStates()) {
+        if (clientId === localId)
+            continue;
+        const user = state
+            .user;
+        peers.push({
+            clientId,
+            userId: user?.userId,
+            name: user?.name,
+            avatarUrl: user?.avatarUrl ?? null,
+        });
+    }
+    return peers;
+}
+/**
+ * Presença via awareness: quem está online no documento agora.
+ * Atualiza em mudança de awareness (entrar/sair/atualizar cursor).
+ */
+export function useAwareness(docName) {
+    const context = useCollaborationContext();
+    const session = getOrCreateSession(context, docName);
+    const [peers, setPeers] = useState([]);
+    const [status, setStatus] = useState(session.getStatus());
+    useEffect(() => {
+        const update = () => {
+            setStatus(session.getStatus());
+            if (session.transport?.awareness) {
+                setPeers(snapshotPeers(session.transport.awareness));
+            }
+        };
+        update();
+        const unsubscribe = session.subscribe(update);
+        const awareness = session.transport?.awareness;
+        awareness?.on('change', update);
+        return () => {
+            awareness?.off('change', update);
+            unsubscribe();
+        };
+    }, [session]);
+    return { peers, status };
+}
+//# sourceMappingURL=use_awareness.js.map

package/dist/src/hooks/use_awareness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_awareness.js","sourceRoot":"","sources":["../../../src/hooks/use_awareness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAS5E,SAAS,aAAa,CAAC,SAAsC;IAC3D,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC;IACnC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC;QACtD,IAAI,QAAQ,KAAK,OAAO;YAAE,SAAS;QACnC,MAAM,IAAI,GAAI,KAAkF;aAC7F,IAAI,CAAC;QACR,KAAK,CAAC,IAAI,CAAC;YACT,QAAQ;YACR,MAAM,EAAE,IAAI,EAAE,MAAM;YACpB,IAAI,EAAE,IAAI,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;SACnC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAExE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/B,IAAI,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QACT,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/C,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,OAAO,GAAG,EAAE;YACV,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjC,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/hooks/use_collab_doc.d.ts

@@ -0,0 +1,17 @@
+import * as Y from 'yjs';
+import type { CollabStatus } from '../types.js';
+export interface UseCollabDocResult {
+    /** Y.Doc compartilhado (estável enquanto o provider viver). */
+    doc: Y.Doc;
+    status: CollabStatus;
+    error: Error | null;
+}
+/**
+ * Conecta ao documento colaborativo e devolve o Y.Doc + status.
+ *
+ * ```tsx
+ * const { doc, status } = useCollabDoc('researches/42/writing')
+ * ```
+ */
+export declare function useCollabDoc(docName: string): UseCollabDocResult;
+//# sourceMappingURL=use_collab_doc.d.ts.map

package/dist/src/hooks/use_collab_doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_collab_doc.d.ts","sourceRoot":"","sources":["../../../src/hooks/use_collab_doc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAoBhE"}

package/dist/src/hooks/use_collab_doc.js

@@ -0,0 +1,24 @@
+import { useEffect, useSyncExternalStore } from 'react';
+import { getOrCreateSession, useCollaborationContext } from '../context.js';
+/**
+ * Conecta ao documento colaborativo e devolve o Y.Doc + status.
+ *
+ * ```tsx
+ * const { doc, status } = useCollabDoc('researches/42/writing')
+ * ```
+ */
+export function useCollabDoc(docName) {
+    const context = useCollaborationContext();
+    const session = getOrCreateSession(context, docName);
+    const status = useSyncExternalStore((onStoreChange) => session.subscribe(onStoreChange), () => session.getStatus(), () => 'connecting');
+    // Garante start mesmo sem re-render subsequente; sessão é cacheada no
+    // provider, então este efeito é barato em re-montagens.
+    useEffect(() => {
+        void session.start();
+        return () => {
+            // Sem destroy aqui: a sessão sobrevive ao unmount do componente.
+        };
+    }, [session]);
+    return { doc: session.doc, status, error: session.error };
+}
+//# sourceMappingURL=use_collab_doc.js.map

package/dist/src/hooks/use_collab_doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_collab_doc.js","sourceRoot":"","sources":["../../../src/hooks/use_collab_doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAU5E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,MAAM,GAAG,oBAAoB,CACjC,CAAC,aAAa,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EACnD,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EACzB,GAAG,EAAE,CAAC,YAA4B,CACnC,CAAC;IAEF,sEAAsE;IACtE,wDAAwD;IACxD,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,iEAAiE;QACnE,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;AAC5D,CAAC"}

package/dist/src/hooks/use_comments.d.ts

@@ -0,0 +1,21 @@
+import type { CollabComment } from '../types.js';
+export interface UseCommentsResult {
+    comments: CollabComment[];
+    loading: boolean;
+    error: Error | null;
+    refresh(): Promise<void>;
+    create(input: Pick<CollabComment, 'space' | 'anchor' | 'body' | 'userId'> & {
+        authorName?: string | null;
+    }): Promise<CollabComment>;
+    resolve(commentId: string, resolved?: boolean): Promise<void>;
+    remove(commentId: string): Promise<void>;
+}
+/**
+ * Comentários ancorados de um documento (REST — dados relacionais no Adonis).
+ *
+ * ```tsx
+ * const { comments, create, resolve } = useComments('researches/42/writing', 'text')
+ * ```
+ */
+export declare function useComments(docName: string, space?: string): UseCommentsResult;
+//# sourceMappingURL=use_comments.d.ts.map

package/dist/src/hooks/use_comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_comments.d.ts","sourceRoot":"","sources":["../../../src/hooks/use_comments.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CACJ,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG;QACnE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,GACA,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAyE9E"}

package/dist/src/hooks/use_comments.js

@@ -0,0 +1,66 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getOrCreateSession, useCollaborationContext } from '../context.js';
+import { createComment as apiCreateComment, deleteComment as apiDeleteComment, listComments, resolveComment, } from '../rest_client.js';
+/**
+ * Comentários ancorados de um documento (REST — dados relacionais no Adonis).
+ *
+ * ```tsx
+ * const { comments, create, resolve } = useComments('researches/42/writing', 'text')
+ * ```
+ */
+export function useComments(docName, space) {
+    const context = useCollaborationContext();
+    const config = context.getConfig();
+    // Mantém a sessão viva (compartilha o ciclo do doc) sem exigir o WS pra
+    // comentários — REST funciona mesmo com engine offline.
+    void getOrCreateSession(context, docName);
+    const [comments, setComments] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        try {
+            const data = await listComments(config, docName, space);
+            if (mountedRef.current) {
+                setComments(data);
+                setError(null);
+            }
+        }
+        catch (cause) {
+            if (mountedRef.current) {
+                setError(cause instanceof Error ? cause : new Error(String(cause)));
+            }
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+    }, [config, docName, space]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const create = useCallback(async (input) => {
+        const comment = await apiCreateComment(config, { ...input, documentName: docName });
+        await refresh();
+        return comment;
+    }, [config, docName, refresh]);
+    const resolve = useCallback(async (commentId, resolved = true) => {
+        await resolveComment(config, docName, commentId, resolved);
+        setComments((current) => current.map((comment) => comment.id === commentId
+            ? { ...comment, resolvedAt: resolved ? new Date().toISOString() : null }
+            : comment));
+    }, [config, docName]);
+    const remove = useCallback(async (commentId) => {
+        await apiDeleteComment(config, docName, commentId);
+        setComments((current) => current.filter((comment) => comment.id !== commentId));
+    }, [config, docName]);
+    return { comments, loading, error, refresh, create, resolve, remove };
+}
+//# sourceMappingURL=use_comments.js.map

package/dist/src/hooks/use_comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_comments.js","sourceRoot":"","sources":["../../../src/hooks/use_comments.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/use_versions.d.ts

@@ -0,0 +1,18 @@
+import type { CollabVersion } from '../types.js';
+export interface UseVersionsResult {
+    versions: CollabVersion[];
+    loading: boolean;
+    error: Error | null;
+    refresh(): Promise<void>;
+    create(label?: string | null): Promise<CollabVersion>;
+    restore(versionId: string): Promise<void>;
+}
+/**
+ * Version control de um documento (REST — snapshots ficam no Adonis).
+ *
+ * ```tsx
+ * const { versions, create, restore } = useVersions('researches/42/writing')
+ * ```
+ */
+export declare function useVersions(docName: string): UseVersionsResult;
+//# sourceMappingURL=use_versions.d.ts.map

package/dist/src/hooks/use_versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_versions.d.ts","sourceRoot":"","sources":["../../../src/hooks/use_versions.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAwD9D"}

package/dist/src/hooks/use_versions.js

@@ -0,0 +1,58 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getOrCreateSession, useCollaborationContext } from '../context.js';
+import { createVersion as apiCreateVersion, restoreVersion as apiRestoreVersion, listVersions, } from '../rest_client.js';
+/**
+ * Version control de um documento (REST — snapshots ficam no Adonis).
+ *
+ * ```tsx
+ * const { versions, create, restore } = useVersions('researches/42/writing')
+ * ```
+ */
+export function useVersions(docName) {
+    const context = useCollaborationContext();
+    const config = context.getConfig();
+    void getOrCreateSession(context, docName);
+    const [versions, setVersions] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        try {
+            const data = await listVersions(config, docName);
+            if (mountedRef.current) {
+                setVersions(data);
+                setError(null);
+            }
+        }
+        catch (cause) {
+            if (mountedRef.current) {
+                setError(cause instanceof Error ? cause : new Error(String(cause)));
+            }
+        }
+        finally {
+            if (mountedRef.current)
+                setLoading(false);
+        }
+    }, [config, docName]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const create = useCallback(async (label = null) => {
+        const version = await apiCreateVersion(config, docName, label);
+        await refresh();
+        return version;
+    }, [config, docName, refresh]);
+    const restore = useCallback(async (versionId) => {
+        await apiRestoreVersion(config, docName, versionId);
+        await refresh();
+    }, [config, docName, refresh]);
+    return { versions, loading, error, refresh, create, restore };
+}
+//# sourceMappingURL=use_versions.js.map

package/dist/src/hooks/use_versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_versions.js","sourceRoot":"","sources":["../../../src/hooks/use_versions.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,20 @@
+export { CollaborationProvider, useCollaborationContext } from './context.js';
+export type { CollaborationProviderProps } from './context.js';
+export { DocSession } from './session.js';
+export { CollabRestError, collabFetch, createComment, createVersion, deleteComment, fetchToken, listComments, listVersions, resolveComment, restoreVersion, } from './rest_client.js';
+export { defaultTransportFactory } from './transports/index.js';
+export { HocuspocusCollabTransport } from './transports/hocuspocus.js';
+export { PartyKitCollabTransport } from './transports/partykit.js';
+export { PartyServerCollabTransport } from './transports/partyserver.js';
+export { useCollabDoc } from './hooks/use_collab_doc.js';
+export type { UseCollabDocResult } from './hooks/use_collab_doc.js';
+export { useAwareness } from './hooks/use_awareness.js';
+export type { UseAwarenessResult } from './hooks/use_awareness.js';
+export { useComments } from './hooks/use_comments.js';
+export type { UseCommentsResult } from './hooks/use_comments.js';
+export { useVersions } from './hooks/use_versions.js';
+export type { UseVersionsResult } from './hooks/use_versions.js';
+export type { CollabComment, CollabPeer, CollabStatus, CollabTokenInfo, CollabTransport, CollabVersion, CollaborationClientConfig, TransportFactory, } from './types.js';
+export { useAutomergeDoc } from './hooks/use_automerge_doc.js';
+export type { UseAutomergeDocResult } from './hooks/use_automerge_doc.js';
+//# sourceMappingURL=index.d.ts.map