@adonis-agora/collaboration 0.1.4 → 0.2.1

package/dist/providers/collaboration_provider.js

@@ -1,16 +1,21 @@
 import { CollaborationManager } from '../src/collaboration_manager.js';
+import { collaborationRoutes } from '../src/routes.js';
 import { setBootedApp } from '../src/services/booted_app.js';
 /**
  * Wires `@adonis-agora/collaboration` into the AdonisJS application:
  *
  * - `register()` hands the booted app to `services/main` and binds the
  *   `CollaborationManager` singleton from `config/collaboration.ts`;
- * - `boot()` attaches the collaboration WebSocket upgrade to the Adonis HTTP
- *   server (path from config, default `/collaboration`);
+ * - `boot()`/`ready()` attaches the collaboration WebSocket upgrade to the
+ *   Adonis HTTP server (path from config, default `/collaboration`);
+ * - `ready()` registers the built-in REST endpoints automatically unless
+ *   `routes.enabled: false` — then call `collaborationRoutes(router)` in
+ *   `start/routes.ts` with your own middleware;
  * - `shutdown()` flushes pending stores and closes all connections.
  */
 export default class CollaborationServiceProvider {
     app;
+    config;
     constructor(app) {
         this.app = app;
     }
@@ -19,32 +24,28 @@ export default class CollaborationServiceProvider {
         // copy bin/server booted, never a pnpm-split non-booted one (see services/booted_app.ts).
         setBootedApp(this.app);
         const config = this.app.config.get('collaboration');
+        this.config = config;
         this.app.container.singleton(CollaborationManager, () => {
             if (!config?.authorize) {
-                throw new Error('Configure authorize() em config/collaboration.ts — a lib nunca autoriza por padrão');
+                throw new Error('Configure authorize() in config/collaboration.ts — the library never authorizes by default');
             }
             const managerConfig = {
                 engine: config.engine ?? 'yjs',
-                authorize: (ctx, docName) => config.authorize(ctx, docName),
+                authorize: config.authorize,
                 path: config.path ?? '/collaboration',
                 debounce: config.debounce ?? 2000,
+                ...(config.storage ? { storage: config.storage } : {}),
+                ...(config.redisUrl ? { redis: { url: config.redisUrl } } : {}),
+                ...(config.partykit ? { partykit: config.partykit } : {}),
             };
-            if (config.storage) {
-                managerConfig.storage = config.storage;
-            }
-            if (config.redisUrl) {
-                managerConfig.redis = { url: config.redisUrl };
-            }
             return new CollaborationManager(managerConfig);
         });
     }
     async ready() {
-        // O attach fica no `ready` (fase 4 do ciclo de vida): o Ignitor já criou
-        // o node HTTP server em `start()` (fase 3), então getNodeServer() existe.
-        // Em comandos ace não há HTTP server — a colaboração simplesmente não
-        // sobe (o manager segue disponível pra uso programático).
-        // Sem HTTP server fora do processo web (ace/console, test, repl) — a
-        // colaboração não sobe; o manager segue disponível pra uso programático.
+        // Attach happens in `ready()` (lifecycle phase 4): Ignitor created the
+        // node HTTP server during `start()` (phase 3), so getNodeServer() exists.
+        // Outside the web process (ace/console/test/repl) there is no HTTP
+        // server — collaboration does not start; the manager stays available.
         const env = this.app.getEnvironment();
         if (env !== 'web') {
             return;
@@ -53,9 +54,27 @@ export default class CollaborationServiceProvider {
         const adonisServer = (await this.app.container.make('server'));
         const nodeServer = adonisServer.getNodeServer?.();
         if (!nodeServer) {
-            throw new Error('[@adonis-agora/collaboration] getNodeServer() indisponível no ready() — verifique a versão do @adonisjs/http-server');
+            throw new Error('[@adonis-agora/collaboration] getNodeServer() unavailable in ready() — check @adonisjs/http-server version');
         }
         await manager.attach(nodeServer);
+        // Auto-register built-in REST endpoints unless explicitly disabled.
+        const routes = this.config?.routes;
+        if (routes?.enabled === false) {
+            return;
+        }
+        const router = (await this.app.container.make('router'));
+        const runtimeOptions = {
+            managerFallback: () => this.app.container.make(CollaborationManager),
+        };
+        if (routes?.prefix !== undefined)
+            runtimeOptions.prefix = routes.prefix;
+        if (routes?.middleware !== undefined)
+            runtimeOptions.middleware = routes.middleware;
+        if (routes?.resolveUser !== undefined)
+            runtimeOptions.resolveUser = routes.resolveUser;
+        if (this.config?.authorize !== undefined)
+            runtimeOptions.authorize = this.config.authorize;
+        await collaborationRoutes(router, runtimeOptions);
     }
     async shutdown() {
         const manager = await this.app.container.make(CollaborationManager);

package/dist/providers/collaboration_provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"collaboration_provider.js","sourceRoot":"","sources":["../../providers/collaboration_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAO7D;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,4BAA4B;IACzB;IAAtB,YAAsB,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAEjD,QAAQ;QACN,+FAA+F;QAC/F,0FAA0F;QAC1F,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAyB,eAAe,CAAC,CAAC;QAE5E,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,oBAAoB,EAAE,GAAG,EAAE;YACtD,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAwB;gBACzC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;gBAC9B,SAAS,EAAE,CAAC,GAA4B,EAAE,OAAe,EAA6B,EAAE,CACtF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC;gBAChC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,gBAAgB;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;aAClC,CAAC;YAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACzC,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,aAAa,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjD,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,yEAAyE;QACzE,0EAA0E;QAC1E,sEAAsE;QACtE,0DAA0D;QAC1D,qEAAqE;QACrE,yEAAyE;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAY,CAAC;QAChD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAEpE,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAE5D,CAAC;QAEF,MAAM,UAAU,GAAG,YAAY,CAAC,aAAa,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,qHAAqH,CACtH,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"collaboration_provider.js","sourceRoot":"","sources":["../../providers/collaboration_provider.ts"],"names":[],"mappings":"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"}

package/dist/src/auth/token.d.ts

@@ -0,0 +1,59 @@
+import type { CollabConnectionContext, CollabPermission, PartyKitConfig } from '../types.js';
+/**
+ * The token/auth module — the single seam for issuing and verifying
+ * collaboration credentials.
+ *
+ * Two wire formats, chosen by engine:
+ *  - `partykit` → HS256 JWT (verified by the edge worker via WebCrypto)
+ *  - self-hosted (`yjs`/`automerge`) → legacy base64 JSON payload accepted
+ *    by the driver handshake
+ *
+ * `issueToken` also enforces `config.authorize` on the REST path — the
+ * permission seam must hold outside the WebSocket handshake too.
+ */
+export interface TokenIssuerConfig {
+    engine: string;
+    /** WS path of the embedded Hocuspocus server (self-hosted engines). */
+    path?: string;
+    partykit?: Partial<Pick<PartyKitConfig, 'roomHost' | 'jwtSecret' | 'party'>>;
+}
+/** Minimal authorize contract — mirrors CollaborationConfig.authorize. */
+export type AuthorizeFn = (ctx: CollabConnectionContext, docName: string) => Promise<CollabPermission>;
+/** Signs a minimal HS256 JWT — no external dependency. */
+export declare function signPartyKitToken(payload: {
+    userId: string;
+    docName: string;
+    user?: {
+        name?: string;
+        avatarUrl?: string | null;
+    };
+}, secret: string, expiresInSeconds?: number): string;
+/** Verifies signature + expiry of a token issued by {@link signPartyKitToken}. */
+export declare function verifyPartyKitToken(token: string, secret: string): {
+    userId: string;
+    docName: string;
+    exp: number;
+} | null;
+/** Parses the legacy base64 payload used by self-hosted driver handshakes. */
+export declare function parseLegacyToken(token: string): CollabConnectionContext | null;
+/** Builds the browser-facing WebSocket URL for an engine. */
+export declare function buildWsUrl(config: TokenIssuerConfig, docName: string): string;
+/** Result of a successful token issue. */
+export interface IssuedToken {
+    token: string;
+    wsUrl: string;
+    engine: string;
+}
+/** Thrown when authorize() denies read access for the document. */
+export declare class CollabForbiddenError extends Error {
+    constructor(docName: string);
+}
+/**
+ * Issues an ephemeral credential for `docName`, enforcing the permission
+ * seam via `authorize` when one is provided.
+ */
+export declare function issueToken(config: TokenIssuerConfig, user: {
+    id: string;
+    name?: string | null;
+}, docName: string, authorize?: AuthorizeFn): Promise<IssuedToken>;
+//# sourceMappingURL=token.d.ts.map

package/dist/src/auth/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/auth/token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7F;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAC9E;AAED,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,EACjG,MAAM,EAAE,MAAM,EACd,gBAAgB,SAAM,GACrB,MAAM,CAQR;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoBzD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAO9E;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC1C,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,WAAW,CAAC,CA4BtB"}

package/dist/src/auth/token.js

@@ -0,0 +1,91 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+/** Signs a minimal HS256 JWT — no external dependency. */
+export function signPartyKitToken(payload, secret, expiresInSeconds = 300) {
+    const header = { alg: 'HS256', typ: 'JWT' };
+    const now = Math.floor(Date.now() / 1000);
+    const body = { ...payload, iat: now, exp: now + expiresInSeconds };
+    const encode = (value) => Buffer.from(JSON.stringify(value)).toString('base64url');
+    const unsigned = `${encode(header)}.${encode(body)}`;
+    const signature = createHmac('sha256', secret).update(unsigned).digest('base64url');
+    return `${unsigned}.${signature}`;
+}
+/** Verifies signature + expiry of a token issued by {@link signPartyKitToken}. */
+export function verifyPartyKitToken(token, secret) {
+    const parts = token.split('.');
+    if (parts.length !== 3)
+        return null;
+    const [header, body, signature] = parts;
+    const expected = createHmac('sha256', secret).update(`${header}.${body}`).digest();
+    const received = Buffer.from(signature, 'base64url');
+    if (received.length !== expected.length || !timingSafeEqual(received, expected)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(Buffer.from(body, 'base64url').toString());
+        if (!parsed.userId || !parsed.docName || parsed.exp * 1000 < Date.now())
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** Parses the legacy base64 payload used by self-hosted driver handshakes. */
+export function parseLegacyToken(token) {
+    try {
+        const parsed = JSON.parse(Buffer.from(token, 'base64').toString());
+        return parsed.userId ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Builds the browser-facing WebSocket URL for an engine. */
+export function buildWsUrl(config, docName) {
+    if (config.engine === 'partykit') {
+        const { roomHost, party } = config.partykit ?? {};
+        const scheme = roomHost?.startsWith('localhost') || roomHost?.startsWith('127.0.0.1') ? 'ws' : 'wss';
+        const host = roomHost?.replace(/^https?:\/\//, '') ?? '';
+        return `${scheme}://${host}/parties/${party ?? 'main'}/${encodeURIComponent(docName)}`;
+    }
+    return config.path ?? '/collaboration';
+}
+/** Thrown when authorize() denies read access for the document. */
+export class CollabForbiddenError extends Error {
+    constructor(docName) {
+        super(`no access to document "${docName}"`);
+        this.name = 'CollabForbiddenError';
+    }
+}
+/**
+ * Issues an ephemeral credential for `docName`, enforcing the permission
+ * seam via `authorize` when one is provided.
+ */
+export async function issueToken(config, user, docName, authorize) {
+    const ctx = {
+        userId: user.id,
+        ...(user.name ? { user: { name: user.name } } : {}),
+    };
+    let permission;
+    if (authorize) {
+        permission = await authorize(ctx, docName);
+        if (!permission.canRead)
+            throw new CollabForbiddenError(docName);
+    }
+    if (config.engine === 'partykit') {
+        if (!config.partykit?.jwtSecret) {
+            throw new Error('config.partykit.jwtSecret is required when engine=partykit');
+        }
+        return {
+            token: signPartyKitToken({ userId: user.id, docName }, config.partykit.jwtSecret),
+            wsUrl: buildWsUrl(config, docName),
+            engine: config.engine,
+        };
+    }
+    return {
+        token: Buffer.from(JSON.stringify(ctx)).toString('base64'),
+        wsUrl: buildWsUrl(config, docName),
+        engine: config.engine,
+    };
+}
+//# sourceMappingURL=token.js.map

package/dist/src/auth/token.js.map

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

package/dist/src/codegen/documents_registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Renderer for the collaborative-documents registry generated at
+ * `.adonisjs/collaboration/documents.ts` by the Assembler `init` hook.
+ *
+ * Pure function so it is trivially testable — the hook only adapts
+ * vfs/buffer and delegates here.
+ */
+/** File discovered by the IndexGenerator. */
+export interface RegistryFile {
+    /** Extension-less relative key from the vfs (e.g. 'researches/writing_types'). */
+    vfsKey: string;
+    /** Import path already resolved via helpers.toImportPath. */
+    importPath: string;
+}
+/**
+ * Converts a vfs key into a document name — same convention as
+ * `make:collab-document`: the '_types' suffix is stripped.
+ *
+ *   'researches/writing_types' -> 'researches/writing'
+ */
+export declare function documentKeyFromVfsKey(vfsKey: string): string;
+/**
+ * Renders the typed registry lines. The map is type-only (`typeof import`),
+ * so the file produces no runtime code — consumed by tsc and re-exportable
+ * to the frontend through manifest/config types.
+ */
+export declare function renderDocumentsRegistry(files: RegistryFile[]): string[];
+//# sourceMappingURL=documents_registry.d.ts.map

package/dist/src/codegen/documents_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents_registry.d.ts","sourceRoot":"","sources":["../../../src/codegen/documents_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAiDvE"}

package/dist/src/codegen/documents_registry.js

@@ -0,0 +1,50 @@
+/**
+ * Renderer for the collaborative-documents registry generated at
+ * `.adonisjs/collaboration/documents.ts` by the Assembler `init` hook.
+ *
+ * Pure function so it is trivially testable — the hook only adapts
+ * vfs/buffer and delegates here.
+ */
+/**
+ * Converts a vfs key into a document name — same convention as
+ * `make:collab-document`: the '_types' suffix is stripped.
+ *
+ *   'researches/writing_types' -> 'researches/writing'
+ */
+export function documentKeyFromVfsKey(vfsKey) {
+    return vfsKey.replace(/_types$/, '');
+}
+/**
+ * Renders the typed registry lines. The map is type-only (`typeof import`),
+ * so the file produces no runtime code — consumed by tsc and re-exportable
+ * to the frontend through manifest/config types.
+ */
+export function renderDocumentsRegistry(files) {
+    const seen = new Set();
+    const unique = files.filter((file) => {
+        const key = documentKeyFromVfsKey(file.vfsKey);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    const lines = [
+        '/**',
+        ' * Generated by @adonis-agora/collaboration — do not edit.',
+        ' * Refresh with `node ace codegen`.',
+        ' */',
+    ];
+    if (unique.length === 0) {
+        lines.push('', '/** No collaborative documents declared yet. Use `node ace make:collab-document`. */', 'export type CollabDocumentName = never;', '', 'export type CollabDocumentDefinition<Name extends CollabDocumentName> = Name extends never', '  ? never', '  : unknown;');
+        return lines;
+    }
+    lines.push('', 'type CollabDocumentModules = {');
+    for (const file of unique) {
+        const key = documentKeyFromVfsKey(file.vfsKey);
+        // Always quote — doc names may contain slashes/hyphens.
+        lines.push(`  '${key}': typeof import('${file.importPath}');`);
+    }
+    lines.push('};', '', '/** Valid collaborative document names in this app. */', 'export type CollabDocumentName = keyof CollabDocumentModules;', '', '/** Document definition module (the *_types default export). */', 'export type CollabDocumentDefinition<Name extends CollabDocumentName> =', '  CollabDocumentModules[Name][', "'default'", '];');
+    return lines;
+}
+//# sourceMappingURL=documents_registry.js.map

package/dist/src/codegen/documents_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents_registry.js","sourceRoot":"","sources":["../../../src/codegen/documents_registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAqB;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,4DAA4D;QAC5D,qCAAqC;QACrC,KAAK;KACN,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,sFAAsF,EACtF,yCAAyC,EACzC,EAAE,EACF,4FAA4F,EAC5F,WAAW,EACX,cAAc,CACf,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gCAAgC,CAAC,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,wDAAwD;QACxD,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,qBAAqB,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,CAAC,IAAI,CACR,IAAI,EACJ,EAAE,EACF,wDAAwD,EACxD,+DAA+D,EAC/D,EAAE,EACF,iEAAiE,EACjE,yEAAyE,EACzE,gCAAgC,EAChC,WAAW,EACX,IAAI,CACL,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/codegen_init.d.ts

@@ -0,0 +1,3 @@
+declare const _default: (...args: unknown[]) => unknown;
+export default _default;
+//# sourceMappingURL=codegen_init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codegen_init.d.ts","sourceRoot":"","sources":["../../src/codegen_init.ts"],"names":[],"mappings":"wBA6D2B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO;AAA1D,wBAA2D"}

package/dist/src/codegen_init.js

@@ -0,0 +1,45 @@
+import { existsSync } from 'node:fs';
+import { hooks } from '@adonisjs/core/app';
+import { renderDocumentsRegistry } from './codegen/documents_registry.js';
+/**
+ * Assembler `init` hook (AdonisJS v7 codegen).
+ *
+ * Registers an IndexGenerator source that scans `app/collaboration/documents`
+ * and generates `.adonisjs/collaboration/documents.ts` — the typed registry
+ * of collaborative documents (`CollabDocumentName`,
+ * `CollabDocumentDefinition`), refreshed by `node ace codegen`, the dev
+ * server, test runner and production build.
+ *
+ * Registered in adonisrc.ts by `node ace configure`:
+ *
+ * ```
+ * hooks: {
+ *   init: [() => import('@adonis-agora/collaboration/codegen_init')]
+ * }
+ * ```
+ */
+// The wrapper's inferred return type references non-portable @poppinss
+// internals — annotate explicitly so the declaration emit stays portable.
+const initHook = hooks.init((_parent, _hooksManager, indexGenerator) => {
+    const source = './app/collaboration/documents';
+    // Directory not created yet: nothing to index (make:collab-document creates it).
+    if (!existsSync(source)) {
+        return;
+    }
+    indexGenerator.add('collabDocuments', {
+        source,
+        glob: ['**/*.ts'],
+        output: './.adonisjs/collaboration/documents.ts',
+        as: (vfs, buffer, _config, helpers) => {
+            const files = Object.entries(vfs.asList()).map(([vfsKey, absolutePath]) => ({
+                vfsKey,
+                importPath: helpers.toImportPath(absolutePath),
+            }));
+            for (const line of renderDocumentsRegistry(files)) {
+                buffer.writeLine(line);
+            }
+        },
+    });
+});
+export default initHook;
+//# sourceMappingURL=codegen_init.js.map

package/dist/src/codegen_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen_init.js","sourceRoot":"","sources":["../../src/codegen_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAyB,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAEjG;;;;;;;;;;;;;;;;GAgBG;AACH,uEAAuE;AACvE,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,CACE,OAAgB,EAChB,aAAsB,EACtB,cAEC,EACD,EAAE;IACF,MAAM,MAAM,GAAG,+BAA+B,CAAC;IAE/C,iFAAiF;IACjF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,cAAc,CAAC,GAAG,CAAC,iBAAiB,EAAE;QACpC,MAAM;QACN,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,MAAM,EAAE,wCAAwC;QAChD,EAAE,EAAE,CACF,GAAyC,EACzC,MAA4C,EAC5C,OAAgB,EAChB,OAAmD,EACnD,EAAE;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1E,MAAM;gBACN,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC;aAC/C,CAAC,CAAC,CAAC;YAEJ,KAAK,MAAM,IAAI,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CACF,CAAC;AAEF,eAAe,QAA2C,CAAC"}

package/dist/src/collaboration_manager.d.ts

@@ -1,34 +1,43 @@
 import type { CollaborationDriver } from './driver.js';
 import { AutomergeDriver } from './drivers/automerge/automerge_driver.js';
+import { PartyKitDriver } from './drivers/partykit/partykit_driver.js';
 import { YjsDriver } from './drivers/yjs/yjs_driver.js';
 import { CommentService } from './services/comment_service.js';
-import { type PresenceMember, PresenceService } from './services/presence_service.js';
 import type { CollabDiffSummary, CollabVersion, CollaborationConfig } from './types.js';
 /**
- * Fachada da lib: escolhe o driver pela config e expõe a API unificada
- * (documento + versões + presença + comentários) pro app hospedeiro.
+ * Library facade: picks the driver for the configured engine and exposes the
+ * unified API (documents + versions + comments) to the host app.
+ *
+ * Seams:
+ *  - drivers connect only through the registry below;
+ *  - comments live exclusively here (`manager.comments`) — drivers never
+ *    touch them;
+ *  - presence is owned by each engine at runtime (edge worker awareness or
+ *    client-side), not by this process.
  */
 export declare class CollaborationManager {
     private config;
     private driver;
-    presence: PresenceService;
     comments: CommentService;
     constructor(config: CollaborationConfig);
     get engine(): string;
-    /** Anexa o WebSocket do driver no server HTTP do Adonis. */
+    /** Attaches the driver's WebSocket to the Adonis HTTP server. No-op on edge. */
     attach(server: import('node:http').Server): Promise<void>;
-    /** Estado binário atual (pra push externo — Google Drive, export…). */
+    /** Current binary state (for external push — Google Drive, export...). */
     getDocumentState(docName: string): Promise<Uint8Array>;
-    /** Texto plano (LanguageTool, RAG, índices de comentários). */
+    /** Plain text (LanguageTool, RAG, comment indexes). */
     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>;
-    /** Membros online num documento (todas as instâncias). */
-    listPresence(docName: string): PresenceMember[];
+    /**
+     * Persists an external snapshot (e.g. PartyKit worker post-debounce).
+     * Requires a configured storage backend.
+     */
+    persistDocument(docName: string, state: Uint8Array): Promise<void>;
     close(): Promise<void>;
 }
-export { YjsDriver, AutomergeDriver };
-export type { CollaborationDriver, CollaborationConfig, PresenceMember };
+export { YjsDriver, AutomergeDriver, PartyKitDriver };
+export type { CollaborationConfig, CollaborationDriver };
 //# sourceMappingURL=collaboration_manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"collaboration_manager.d.ts","sourceRoot":"","sources":["../../src/collaboration_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,KAAK,cAAc,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtF,OAAO,KAAK,EAAiB,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEvG;;;GAGG;AACH,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,MAAM,CAAsB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;gBAEL,MAAM,EAAE,mBAAmB;IAQ/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,4DAA4D;IACtD,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,uEAAuE;IACvE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAItD,+DAA+D;IAC/D,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,aAAa,CACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,aAAa,CAAC;IAIzB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInF,0DAA0D;IAC1D,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IAIzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B;AAED,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"collaboration_manager.d.ts","sourceRoot":"","sources":["../../src/collaboration_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExF;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAInB,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,MAAM,CAAsB;IACpC,QAAQ,EAAE,cAAc,CAAC;gBAEL,MAAM,EAAE,mBAAmB;IA0B/C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,gFAAgF;IAC1E,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,0EAA0E;IAC1E,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAItD,uDAAuD;IACvD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,aAAa,CACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,aAAa,CAAC;IAIzB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInF;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/collaboration_manager.js

@@ -1,36 +1,60 @@
 import { AutomergeDriver } from './drivers/automerge/automerge_driver.js';
+import { PartyKitDriver } from './drivers/partykit/partykit_driver.js';
+import { resolveStorage } from './drivers/shared.js';
 import { YjsDriver } from './drivers/yjs/yjs_driver.js';
 import { CommentService } from './services/comment_service.js';
-import { PresenceService } from './services/presence_service.js';
-import { InMemoryCollaborationStorage } from './storage/in_memory_storage.js';
 /**
- * Fachada da lib: escolhe o driver pela config e expõe a API unificada
- * (documento + versões + presença + comentários) pro app hospedeiro.
+ * Library facade: picks the driver for the configured engine and exposes the
+ * unified API (documents + versions + comments) to the host app.
+ *
+ * Seams:
+ *  - drivers connect only through the registry below;
+ *  - comments live exclusively here (`manager.comments`) — drivers never
+ *    touch them;
+ *  - presence is owned by each engine at runtime (edge worker awareness or
+ *    client-side), not by this process.
  */
 export class CollaborationManager {
     config;
     driver;
-    presence;
     comments;
     constructor(config) {
         this.config = config;
-        this.driver =
-            config.engine === 'automerge' ? new AutomergeDriver(config) : new YjsDriver(config);
-        this.presence = new PresenceService(config.redis?.url);
-        this.comments = new CommentService(config.storage ?? new InMemoryCollaborationStorage());
+        const engine = config.engine ?? 'yjs';
+        const storage = config.storage;
+        if (engine === 'partykit') {
+            this.driver = new PartyKitDriver({
+                ...(storage ? { storage } : {}),
+                partykit: config.partykit,
+            });
+        }
+        else {
+            const shared = {
+                authorize: config.authorize,
+            };
+            const opts = {
+                ...shared,
+                ...(storage ? { storage } : {}),
+                ...(config.path !== undefined ? { path: config.path } : {}),
+                ...(config.debounce !== undefined ? { debounce: config.debounce } : {}),
+            };
+            this.driver = engine === 'automerge' ? new AutomergeDriver(opts) : new YjsDriver(opts);
+        }
+        // Single comments seam — one service, one storage instance.
+        this.comments = new CommentService(resolveStorage(storage));
     }
     get engine() {
         return this.driver.engine;
     }
-    /** Anexa o WebSocket do driver no server HTTP do Adonis. */
+    /** Attaches the driver's WebSocket to the Adonis HTTP server. No-op on edge. */
     async attach(server) {
         await this.driver.attach(server);
     }
-    /** Estado binário atual (pra push externo — Google Drive, export…). */
+    /** Current binary state (for external push — Google Drive, export...). */
     getDocumentState(docName) {
         return this.driver.getDocumentState(docName);
     }
-    /** Texto plano (LanguageTool, RAG, índices de comentários). */
+    /** Plain text (LanguageTool, RAG, comment indexes). */
     getDocumentText(docName) {
         return this.driver.getDocumentText(docName);
     }
@@ -46,14 +70,19 @@ export class CollaborationManager {
     diffVersions(docName, aId, bId) {
         return this.driver.diffVersions(docName, aId, bId);
     }
-    /** Membros online num documento (todas as instâncias). */
-    listPresence(docName) {
-        return this.presence.list(docName);
+    /**
+     * Persists an external snapshot (e.g. PartyKit worker post-debounce).
+     * Requires a configured storage backend.
+     */
+    async persistDocument(docName, state) {
+        if (!this.config.storage) {
+            throw new Error('persistDocument requires a storage backend — configure storage in config/collaboration.ts');
+        }
+        await this.config.storage.saveDocument(docName, state);
     }
     async close() {
         await this.driver.close();
-        await this.presence.close();
     }
 }
-export { YjsDriver, AutomergeDriver };
+export { YjsDriver, AutomergeDriver, PartyKitDriver };
 //# sourceMappingURL=collaboration_manager.js.map

package/dist/src/collaboration_manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"collaboration_manager.js","sourceRoot":"","sources":["../../src/collaboration_manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAuB,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAKX;IAJZ,MAAM,CAAsB;IACpC,QAAQ,CAAkB;IAC1B,QAAQ,CAAiB;IAEzB,YAAoB,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;QAC7C,IAAI,CAAC,MAAM;YACT,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QAEtF,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,4BAA4B,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,MAAM,CAAC,MAAkC;QAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,uEAAuE;IACvE,gBAAgB,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,+DAA+D;IAC/D,eAAe,CAAC,OAAe;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,aAAa,CACX,OAAe,EACf,SAAwB,EACxB,KAAqB;QAErB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,SAAiB,EAAE,UAAyB;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,YAAY,CAAC,OAAe,EAAE,GAAW,EAAE,GAAW;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,0DAA0D;IAC1D,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"collaboration_manager.js","sourceRoot":"","sources":["../../src/collaboration_manager.ts"],"names":[],"mappings":"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"}