@adonis-agora/collaboration 0.1.1

package/dist/src/drivers/yjs/yjs_driver.d.ts

@@ -0,0 +1,30 @@
+import type { CollaborationDriver } from '../../driver.js';
+import type { CollabComment, CollabDiffSummary, CollabVersion, CollaborationConfig } from '../../types.js';
+export declare class YjsDriver implements CollaborationDriver {
+    #private;
+    readonly engine = "yjs";
+    private hocuspocus;
+    private wss?;
+    private config;
+    private commentsService;
+    constructor(config: CollaborationConfig);
+    private liveDoc;
+    private hydrate;
+    private ensureDoc;
+    attach(server: import('node:http').Server): Promise<void>;
+    getDocumentState(docName: string): Promise<Uint8Array>;
+    getDocumentText(docName: string): Promise<string>;
+    createVersion(docName: string, createdBy: string | null, label: string | null): Promise<CollabVersion>;
+    listVersions(docName: string): Promise<CollabVersion[]>;
+    restoreVersion(docName: string, versionId: string, restoredBy: string | null): Promise<void>;
+    diffVersions(docName: string, aId: string, bId: string): Promise<CollabDiffSummary>;
+    private versionState;
+    listComments(docName: string, space?: string): Promise<CollabComment[]>;
+    createComment(docName: string, comment: Omit<CollabComment, 'id' | 'createdAt' | 'updatedAt' | 'resolvedAt'>): Promise<CollabComment>;
+    resolveComment(docName: string, commentId: string, resolved: boolean): Promise<CollabComment | null>;
+    deleteComment(docName: string, commentId: string): Promise<boolean>;
+    close(): Promise<void>;
+}
+/** Converte o JSON Tiptap em texto plano (\n\n entre blocos). */
+export declare function tiptapJsonToText(node: Record<string, unknown> | null): string;
+//# sourceMappingURL=yjs_driver.d.ts.map

package/dist/src/drivers/yjs/yjs_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs_driver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/yjs/yjs_driver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAEjB,aAAa,EACb,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAkBxB,qBAAa,SAAU,YAAW,mBAAmB;;IACnD,QAAQ,CAAC,MAAM,SAAS;IAExB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,eAAe,CAAiB;gBAY5B,MAAM,EAAE,mBAAmB;IA6BvC,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,OAAO;YAQD,SAAS;IAQjB,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzD,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAStD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAajD,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,OAAO,CAAC,aAAa,CAAC;IASnB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvD,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,IAAI,CAAC;IAgBV,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAY3E,YAAY;IAQpB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvE,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC,GAC5E,OAAO,CAAC,aAAa,CAAC;IAInB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI1B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B;AAYD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,CAuB7E"}

package/dist/src/drivers/yjs/yjs_driver.js

@@ -0,0 +1,232 @@
+import { Hocuspocus } from '@hocuspocus/server';
+import { TiptapTransformer } from '@hocuspocus/transformer';
+import { WebSocketServer } from 'ws';
+import * as Y from 'yjs';
+import { CommentService } from '../../services/comment_service.js';
+import { InMemoryCollaborationStorage } from '../../storage/in_memory_storage.js';
+import { createVersionMetadata, seqVersions } from '../../versioning.js';
+/**
+ * Driver Yjs: Hocuspocus como engine de sync (protocolo y-protocols sobre
+ * WebSocket), com version control implementado em cima de updates binários
+ * completos — o que o Automerge tem nativo (history) a gente provê aqui:
+ *
+ *  - `createVersion`: guarda o update binário completo + metadados;
+ *  - `restoreVersion`: aplica o conteúdo da versão no doc vivo via transação
+ *    — clientes conectados recebem em tempo real pelo protocolo de sync;
+ *  - `diffVersions`: materializa as duas versões e compara por linha.
+ *  - Comentários ancorados: delegam pro CommentService (anchor genérica).
+ */
+/** Permissões por conexão (userId:docName), preenchidas no authenticate. */
+const permissions = new Map();
+export class YjsDriver {
+    engine = 'yjs';
+    hocuspocus;
+    wss;
+    config;
+    commentsService;
+    #memoryStorage;
+    /** Storage configurado ou in-memory (dev). */
+    #storage() {
+        if (this.config.storage) {
+            return this.config.storage;
+        }
+        this.#memoryStorage ??= new InMemoryCollaborationStorage();
+        return this.#memoryStorage;
+    }
+    constructor(config) {
+        this.config = config;
+        this.commentsService = new CommentService(config.storage ?? new InMemoryCollaborationStorage());
+        // Capturados fora do callback: o `this` dentro dos hooks do Hocuspocus
+        // não é a instância do driver.
+        const storage = () => this.#storage();
+        this.hocuspocus = new Hocuspocus({
+            async onAuthenticate({ documentName, token }) {
+                const ctx = JSON.parse(Buffer.from(token, 'base64').toString());
+                const permission = await config.authorize(ctx, documentName);
+                if (!permission.canRead) {
+                    throw new Error('Sem acesso a este documento');
+                }
+                permissions.set(`${ctx.userId}:${documentName}`, permission);
+            },
+            async onStoreDocument({ documentName, document }) {
+                await storage().saveDocument(documentName, Y.encodeStateAsUpdate(document));
+            },
+            debounce: config.debounce ?? 2000,
+        });
+    }
+    liveDoc(name) {
+        // Document do Hocuspocus estende Y.Doc diretamente.
+        return this.hocuspocus.documents.get(name);
+    }
+    hydrate(state) {
+        const doc = new Y.Doc();
+        if (state.byteLength > 0) {
+            Y.applyUpdate(doc, state);
+        }
+        return doc;
+    }
+    async ensureDoc(name) {
+        const existing = this.liveDoc(name);
+        if (existing)
+            return existing;
+        const stored = await this.#storage().loadDocument(name);
+        return this.hydrate(stored?.state ?? new Uint8Array());
+    }
+    async attach(server) {
+        const path = this.config.path ?? '/collaboration';
+        const wss = new WebSocketServer({ noServer: true });
+        this.wss = wss;
+        server.on('upgrade', (request, socket, head) => {
+            const parsed = new URL(request.url ?? '/', 'http://localhost');
+            if (parsed.pathname !== path)
+                return;
+            wss.handleUpgrade(request, socket, head, (ws) => {
+                // O Hocuspocus espera um Request da Fetch API; convertemos o
+                // IncomingMessage do node pra um Request mínimo com a URL real.
+                const fetchRequest = new Request(parsed, {
+                    headers: request.headers,
+                });
+                this.hocuspocus.handleConnection(ws, fetchRequest);
+            });
+        });
+    }
+    async getDocumentState(docName) {
+        const live = this.liveDoc(docName);
+        if (live) {
+            return Y.encodeStateAsUpdate(live);
+        }
+        const stored = await this.#storage().loadDocument(docName);
+        return stored?.state ?? new Uint8Array();
+    }
+    async getDocumentText(docName) {
+        const doc = await this.ensureDoc(docName);
+        try {
+            const json = TiptapTransformer.fromYdoc(doc);
+            const defaultDoc = json.default ?? json;
+            return tiptapJsonToText(defaultDoc);
+        }
+        catch {
+            // Doc vazio ou fora do layout Tiptap.
+            return '';
+        }
+    }
+    async createVersion(docName, createdBy, label) {
+        const doc = await this.ensureDoc(docName);
+        const existing = await this.#storage().listVersions(docName);
+        const version = createVersionMetadata(createdBy, label, seqVersions(existing));
+        await this.#storage().saveVersion(docName, version, Y.encodeStateAsUpdate(doc));
+        return version;
+    }
+    async listVersions(docName) {
+        return this.#storage().listVersions(docName);
+    }
+    async restoreVersion(docName, versionId, restoredBy) {
+        void restoredBy;
+        const state = await this.versionState(docName, versionId);
+        const restoredDoc = this.hydrate(state);
+        // Aplica o conteúdo restaurado no doc vivo — clientes conectados recebem
+        // a mudança em tempo real via protocolo de sync do Hocuspocus.
+        const live = await this.ensureDoc(docName);
+        live.transact(() => {
+            applyRestoredContent(live, restoredDoc);
+        });
+        await this.#storage().saveDocument(docName, Y.encodeStateAsUpdate(live));
+    }
+    async diffVersions(docName, aId, bId) {
+        const [aState, bState] = await Promise.all([
+            this.versionState(docName, aId),
+            this.versionState(docName, bId),
+        ]);
+        const textA = tiptapJsonToText(safeTiptapFromYdoc(this.hydrate(aState)));
+        const textB = tiptapJsonToText(safeTiptapFromYdoc(this.hydrate(bState)));
+        return simpleLineDiff(textA, textB);
+    }
+    async versionState(docName, versionId) {
+        const persisted = await this.#storage().loadVersionSnapshot(docName, versionId);
+        if (!persisted)
+            throw new Error(`Versão ${versionId} não encontrada`);
+        return persisted;
+    }
+    /* ───────────────────────── comentários ancorados ───────────────────────── */
+    async listComments(docName, space) {
+        return this.commentsService.list(docName, space);
+    }
+    async createComment(docName, comment) {
+        return this.commentsService.create(docName, comment);
+    }
+    async resolveComment(docName, commentId, resolved) {
+        return this.commentsService.resolve(docName, commentId, resolved);
+    }
+    async deleteComment(docName, commentId) {
+        return this.commentsService.remove(docName, commentId);
+    }
+    async close() {
+        // Persiste docs pendentes e fecha conexões (a classe Hocuspocus não tem
+        // destroy — o Server embutido é que tem).
+        this.hocuspocus.flushPendingStores();
+        this.hocuspocus.closeConnections();
+        return new Promise((resolve) => {
+            this.wss?.close(() => resolve());
+        });
+    }
+}
+/* ───────────────────────── helpers locais ───────────────────────── */
+function safeTiptapFromYdoc(doc) {
+    try {
+        return TiptapTransformer.fromYdoc(doc);
+    }
+    catch {
+        return {};
+    }
+}
+/** Converte o JSON Tiptap em texto plano (\n\n entre blocos). */
+export function tiptapJsonToText(node) {
+    if (!node || !Array.isArray(node.content))
+        return '';
+    let text = '';
+    const walk = (current) => {
+        if (current.type === 'text' && typeof current.text === 'string') {
+            text += current.text;
+            return;
+        }
+        if (Array.isArray(current.content)) {
+            for (const child of current.content) {
+                walk(child);
+            }
+        }
+        if (typeof current.type === 'string' &&
+            ['paragraph', 'heading', 'blockquote', 'codeBlock', 'listItem'].includes(current.type)) {
+            text += '\n\n';
+        }
+    };
+    walk(node);
+    return text.trimEnd();
+}
+/** Diff por linha simples o suficiente pra resumo (+adicionadas / -removidas). */
+function simpleLineDiff(a, b) {
+    const linesA = new Set(a.split('\n'));
+    const linesB = new Set(b.split('\n'));
+    let added = 0;
+    for (const line of linesB) {
+        if (!linesA.has(line))
+            added++;
+    }
+    let removed = 0;
+    for (const line of linesA) {
+        if (!linesB.has(line))
+            removed++;
+    }
+    return { added, removed };
+}
+/**
+ * Substitui o conteúdo do doc vivo aplicando o update completo do doc
+ * restaurado (merge CRDT é idempotente; o delete anterior remove o estado
+ * divergente e o update traz o conteúdo antigo de volta).
+ */
+function applyRestoredContent(live, restored) {
+    const liveFragment = live.getXmlFragment('default');
+    liveFragment.delete(0, liveFragment.length);
+    const update = Y.encodeStateAsUpdate(restored);
+    Y.applyUpdate(live, update);
+}
+//# sourceMappingURL=yjs_driver.js.map

package/dist/src/drivers/yjs/yjs_driver.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+export { CollaborationManager } from './collaboration_manager.js';
+export { YjsDriver } from './drivers/yjs/yjs_driver.js';
+export { AutomergeDriver } from './drivers/automerge/automerge_driver.js';
+export { CommentService } from './services/comment_service.js';
+export { PresenceService, type PresenceMember } from './services/presence_service.js';
+export { LucidStorage } from './storage/lucid_storage.js';
+export { defineConfig, type CollaborationAppConfig, } from './define_config.js';
+export type { CollabComment, CommentAnchor, CollaborationEngine, CollaborationConfig, CollaborationStorage, CollabConnectionContext, CollabPermission, CollabVersion, CollabDiffSummary, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,8 @@
+export { CollaborationManager } from './collaboration_manager.js';
+export { YjsDriver } from './drivers/yjs/yjs_driver.js';
+export { AutomergeDriver } from './drivers/automerge/automerge_driver.js';
+export { CommentService } from './services/comment_service.js';
+export { PresenceService } from './services/presence_service.js';
+export { LucidStorage } from './storage/lucid_storage.js';
+export { defineConfig, } from './define_config.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAuB,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,YAAY,GAEb,MAAM,oBAAoB,CAAC"}

package/dist/src/services/booted_app.d.ts

@@ -0,0 +1,10 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/** Record the booted app. Called once by the provider during `register()`. */
+export declare function setBootedApp(app: ApplicationService): void;
+/**
+ * Resolves with the provider-captured booted app. `services/main` awaits this (instead of importing
+ * `@adonisjs/core/services/app`) before reading the container, so its eager population is driven by
+ * the SAME app copy `bin/server` booted.
+ */
+export declare function whenBootedApp(timeoutMs?: number): Promise<ApplicationService>;
+//# sourceMappingURL=booted_app.d.ts.map

package/dist/src/services/booted_app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booted_app.d.ts","sourceRoot":"","sources":["../../../src/services/booted_app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAkB/D,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAI1D;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,SAAS,SAAgC,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

package/dist/src/services/booted_app.js

@@ -0,0 +1,42 @@
+/**
+ * The booted {@link ApplicationService}, captured by `CollaborationProvider.register()` — which the
+ * application instantiates with its OWN booted app instance.
+ *
+ * Why capture it here instead of `import app from '@adonisjs/core/services/app'`: in a pnpm
+ * (workspace / hoisted) install this package can resolve a DIFFERENT physical copy of
+ * `@adonisjs/core` than the one `bin/server` booted. The instance the provider RECEIVES is always
+ * the booted one, so reading it here is immune to a core copy / peer-variant split.
+ * Mirrors `@adonis-agora/durable`'s `booted_app`.
+ */
+let bootedApp;
+let resolveBootedApp;
+const bootedAppPromise = new Promise((resolve) => {
+    resolveBootedApp = resolve;
+});
+/** Record the booted app. Called once by the provider during `register()`. */
+export function setBootedApp(app) {
+    if (bootedApp)
+        return;
+    bootedApp = app;
+    resolveBootedApp(app);
+}
+/** Default window `whenBootedApp` waits for the provider before rejecting. */
+const DEFAULT_BOOTED_APP_TIMEOUT_MS = 5_000;
+/**
+ * Resolves with the provider-captured booted app. `services/main` awaits this (instead of importing
+ * `@adonisjs/core/services/app`) before reading the container, so its eager population is driven by
+ * the SAME app copy `bin/server` booted.
+ */
+export function whenBootedApp(timeoutMs = DEFAULT_BOOTED_APP_TIMEOUT_MS) {
+    if (bootedApp)
+        return Promise.resolve(bootedApp);
+    setTimeout(() => {
+        resolveBootedApp({
+            get booted() {
+                throw new Error('@adonis-agora/collaboration: services/main aguardando boot — instale o provider com `node ace configure @adonis-agora/collaboration`');
+            },
+        });
+    }, timeoutMs);
+    return bootedAppPromise;
+}
+//# sourceMappingURL=booted_app.js.map

package/dist/src/services/booted_app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booted_app.js","sourceRoot":"","sources":["../../../src/services/booted_app.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,IAAI,SAAyC,CAAC;AAC9C,IAAI,gBAAmD,CAAC;AACxD,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;IACnE,gBAAgB,GAAG,OAAO,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,GAAuB;IAClD,IAAI,SAAS;QAAE,OAAO;IACtB,SAAS,GAAG,GAAG,CAAC;IAChB,gBAAgB,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAS,GAAG,6BAA6B;IAEzC,IAAI,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD,UAAU,CAAC,GAAG,EAAE;QACd,gBAAgB,CAAC;YACf,IAAI,MAAM;gBACR,MAAM,IAAI,KAAK,CACb,sIAAsI,CACvI,CAAC;YACJ,CAAC;SAC+B,CAAC,CAAC;IACtC,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/src/services/comment_service.d.ts

@@ -0,0 +1,17 @@
+import type { CollabComment, CollaborationStorage } from '../types.js';
+/**
+ * Serviço de comentários ancorados — genérico por tipo de conteúdo.
+ *
+ * A lib é dona do lifecycle (criar, resolver/reabrir, remover) e da âncora
+ * (CommentAnchor). Quem interpreta a âncora é o resolver do app — a lib não
+ * sabe o que é um canvas tldraw nem offsets de texto; só persiste e ordena.
+ */
+export declare class CommentService {
+    private storage;
+    constructor(storage: CollaborationStorage);
+    list(docName: string, space?: string): Promise<CollabComment[]>;
+    create(docName: string, comment: Omit<CollabComment, 'id' | 'createdAt' | 'updatedAt' | 'resolvedAt'>): Promise<CollabComment>;
+    resolve(docName: string, commentId: string, resolved: boolean): Promise<CollabComment | null>;
+    remove(docName: string, commentId: string): Promise<boolean>;
+}
+//# sourceMappingURL=comment_service.d.ts.map

package/dist/src/services/comment_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment_service.d.ts","sourceRoot":"","sources":["../../../src/services/comment_service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAE3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK/D,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC,GAC5E,OAAO,CAAC,aAAa,CAAC;IAcnB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc7F,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAOnE"}

package/dist/src/services/comment_service.js

@@ -0,0 +1,53 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Serviço de comentários ancorados — genérico por tipo de conteúdo.
+ *
+ * A lib é dona do lifecycle (criar, resolver/reabrir, remover) e da âncora
+ * (CommentAnchor). Quem interpreta a âncora é o resolver do app — a lib não
+ * sabe o que é um canvas tldraw nem offsets de texto; só persiste e ordena.
+ */
+export class CommentService {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async list(docName, space) {
+        const comments = await this.storage.listComments(docName, space);
+        return comments.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async create(docName, comment) {
+        const now = new Date().toISOString();
+        const created = {
+            ...comment,
+            documentName: docName,
+            id: randomUUID(),
+            resolvedAt: null,
+            createdAt: now,
+            updatedAt: null,
+        };
+        await this.storage.saveComment(docName, created);
+        return created;
+    }
+    async resolve(docName, commentId, resolved) {
+        const comments = await this.storage.listComments(docName);
+        const target = comments.find((comment) => comment.id === commentId);
+        if (!target)
+            return null;
+        const updated = {
+            ...target,
+            resolvedAt: resolved ? new Date().toISOString() : null,
+            updatedAt: new Date().toISOString(),
+        };
+        await this.storage.saveComment(docName, updated);
+        return updated;
+    }
+    async remove(docName, commentId) {
+        const comments = await this.storage.listComments(docName);
+        const exists = comments.some((comment) => comment.id === commentId);
+        if (!exists)
+            return false;
+        await this.storage.deleteComment(docName, commentId);
+        return true;
+    }
+}
+//# sourceMappingURL=comment_service.js.map

package/dist/src/services/comment_service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment_service.js","sourceRoot":"","sources":["../../../src/services/comment_service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;IAAG,CAAC;IAErD,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,KAAc;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAA6E;QAE7E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,OAAO,GAAkB;YAC7B,GAAG,OAAO;YACV,YAAY,EAAE,OAAO;YACrB,EAAE,EAAE,UAAU,EAAE;YAChB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAiB;QACjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,OAAO,GAAkB;YAC7B,GAAG,MAAM;YACT,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YACtD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,SAAiB;QAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/src/services/main.d.ts

@@ -0,0 +1,6 @@
+import { CollaborationManager } from '../collaboration_manager.js';
+declare const _default: {
+    readonly current: CollaborationManager;
+};
+export default _default;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;;sBAyBlD,oBAAoB;;AADrC,wBASE"}

package/dist/src/services/main.js

@@ -0,0 +1,29 @@
+import { CollaborationManager } from '../collaboration_manager.js';
+import { whenBootedApp } from './booted_app.js';
+/**
+ * The singleton {@link CollaborationManager} — populated by
+ * `CollaborationProvider` from `config/collaboration.ts`.
+ *
+ * ```ts
+ * import collaboration from '@adonis-agora/collaboration/services/main'
+ *
+ * const text = await collaboration.getDocumentText('researches/<id>/writing')
+ * const version = await collaboration.createVersion(docName, userId, 'antes da revisão')
+ * ```
+ */
+let manager;
+const app = await whenBootedApp();
+await app.booted(async () => {
+    const config = app.config.get('collaboration', {});
+    manager = await app.container.make(CollaborationManager);
+    void config;
+});
+export default {
+    get current() {
+        if (!manager) {
+            throw new Error('CollaborationManager ainda não inicializou — aguarde o boot do app ou instale o provider');
+        }
+        return manager;
+    },
+};
+//# sourceMappingURL=main.js.map

package/dist/src/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,IAAI,OAA6B,CAAC;AAElC,MAAM,GAAG,GAAG,MAAM,aAAa,EAAE,CAAC;AAClC,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAyB,eAAe,EAAE,EAAW,CAAC,CAAC;IACpF,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACzD,KAAK,MAAM,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,eAAe;IACb,IAAI,OAAO;QACT,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC"}

package/dist/src/services/presence_service.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Presença cross-instance da colaboração.
+ *
+ * Mesma filosofia do @adonisjs/transmit: cada instância conhece as conexões
+ * LOCAIS (em memória) e propaga eventos via Redis pub/sub pra que qualquer
+ * instância enxergue quem está online no documento inteiro — não só na
+ * instância que recebeu a conexão.
+ *
+ * Canal: `collab:presence` (payload identifica o docName).
+ *  - heartbeat local → publish de join/leave;
+ *  - subscriber atualiza o mapa agregado e notifica os callbacks.
+ */
+export interface PresenceMember {
+    userId: string;
+    name?: string;
+    avatarUrl?: string | null;
+    /** Instância que segura a conexão (id do processo). */
+    instanceId: string;
+}
+type PresenceListener = (docName: string, members: PresenceMember[]) => void;
+export declare class PresenceService {
+    private publisher?;
+    private subscriber?;
+    private localMembers;
+    private remoteMembers;
+    private listeners;
+    private instanceId;
+    private heartbeatTimer?;
+    constructor(redisUrl?: string);
+    /** Registra uma conexão local num documento. */
+    join(docName: string, member: Omit<PresenceMember, 'instanceId'>): Promise<void>;
+    leave(docName: string, userId: string): Promise<void>;
+    /** Membros conhecidos de um documento (locais + remotos via pub/sub). */
+    list(docName: string): PresenceMember[];
+    onPresenceChange(listener: PresenceListener): () => void;
+    close(): Promise<void>;
+    private localMap;
+    private publish;
+    private publishLocalHeartbeats;
+    private handleRemoteMessage;
+    private notify;
+}
+export {};
+//# sourceMappingURL=presence_service.d.ts.map

package/dist/src/services/presence_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence_service.d.ts","sourceRoot":"","sources":["../../../src/services/presence_service.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;AAU7E,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAQ;IAC3B,OAAO,CAAC,YAAY,CAAkD;IACtE,OAAO,CAAC,aAAa,CAAkD;IACvE,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,cAAc,CAAC,CAAiC;gBAE5C,QAAQ,CAAC,EAAE,MAAM;IAY7B,gDAAgD;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhF,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D,yEAAyE;IACzE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAYvC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAKlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,OAAO,CAAC,QAAQ;YAIF,OAAO;YAKP,sBAAsB;IAQpC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,MAAM;CAKf"}