captify 0.1.17 → 0.1.19

package/dist/collaboration/providers/yjs-provider.js

@@ -0,0 +1,438 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * YJS Provider for collaborative document editing.
+ *
+ * Provides a yjs document and awareness for real-time collaboration
+ * with Tiptap editor. Handles WebSocket connection, localStorage persistence,
+ * and auto-save to database.
+ */
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import * as Y from "yjs";
+import { WebsocketProvider } from "y-websocket";
+import { COLLABORATION_ERROR_MESSAGES, PERSISTENCE_CONFIG, YJS_TEXT_KEY, } from "../collaboration.constants";
+import { updateDocumentApi } from "../api/collaboration.client";
+import { encodeToBase64 } from "../collaboration.utilities";
+// ============================================================================
+// LocalStorage Persistence Utilities
+// ============================================================================
+/**
+ * Get the localStorage key for a document
+ */
+function getStorageKey(documentId) {
+    return `${PERSISTENCE_CONFIG.OFFLINE.STORAGE_KEY_PREFIX}${documentId}`;
+}
+/**
+ * Save yjs document state to localStorage
+ */
+function saveToLocalStorage(documentId, ydoc) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        const state = Y.encodeStateAsUpdate(ydoc);
+        const base64 = encodeToBase64(state);
+        localStorage.setItem(getStorageKey(documentId), base64);
+    }
+    catch (_a) {
+        // localStorage might be full or disabled - fail silently
+    }
+}
+/**
+ * Load yjs document state from localStorage
+ */
+function loadFromLocalStorage(documentId, ydoc) {
+    if (typeof window === "undefined")
+        return false;
+    try {
+        const stored = localStorage.getItem(getStorageKey(documentId));
+        if (!stored)
+            return false;
+        const binary = Uint8Array.from(atob(stored), (c) => c.charCodeAt(0));
+        Y.applyUpdate(ydoc, binary);
+        return true;
+    }
+    catch (_a) {
+        // Invalid data or parsing error - fail silently
+        return false;
+    }
+}
+// ============================================================================
+// Auto-save Utilities
+// ============================================================================
+/**
+ * Encode yjs document state to base64 for API transport
+ */
+function encodeDocumentState(ydoc) {
+    const state = Y.encodeStateAsUpdate(ydoc);
+    return encodeToBase64(state);
+}
+/**
+ * Get word count from yjs document
+ */
+function getWordCount(ydoc) {
+    const ytext = ydoc.getText(YJS_TEXT_KEY);
+    const textContent = ytext.toString();
+    return textContent.trim().split(/\s+/).filter(Boolean).length;
+}
+/**
+ * Get preview snippet from yjs document (first 200 characters)
+ */
+function getPreviewSnippet(ydoc) {
+    const ytext = ydoc.getText(YJS_TEXT_KEY);
+    const textContent = ytext.toString();
+    return textContent.slice(0, 200).trim();
+}
+// ============================================================================
+// Context
+// ============================================================================
+const YjsContext = createContext(null);
+/**
+ * Hook to access the yjs context.
+ * Must be used within a YjsProvider.
+ *
+ * @throws Error if used outside of YjsProvider
+ */
+export function useYjs() {
+    const context = useContext(YjsContext);
+    if (!context) {
+        throw new Error(COLLABORATION_ERROR_MESSAGES.YJS_PROVIDER_REQUIRED);
+    }
+    return context;
+}
+// ============================================================================
+// Provider Component
+// ============================================================================
+/**
+ * Provider component for yjs document collaboration.
+ *
+ * Creates a yjs document with WebSocket sync, localStorage persistence,
+ * and auto-save to database.
+ *
+ * Features:
+ * - Real-time collaboration via WebSocket
+ * - Offline persistence via localStorage
+ * - Auto-save to database (debounced with max interval)
+ * - Automatic reconnection
+ * - Presence awareness for remote cursors
+ *
+ * @example
+ * ```tsx
+ * <YjsProvider
+ *   documentId="doc-123"
+ *   wsUrl="wss://collab.example.com"
+ *   user={{ id: "user-1", name: "John", color: "#ff0000" }}
+ *   enableOffline={true}
+ *   enableAutoSave={true}
+ * >
+ *   <DocumentEditor />
+ * </YjsProvider>
+ * ```
+ */
+export function YjsProvider({ documentId, wsUrl, user, enableOffline = true, enableAutoSave = true, children, }) {
+    // State
+    const [status, setStatus] = useState(wsUrl ? "connecting" : "disconnected");
+    const [isSynced, setIsSynced] = useState(!wsUrl);
+    const [isOfflineSynced, setIsOfflineSynced] = useState(false);
+    const [awareness, setAwareness] = useState(null);
+    // Auto-save state
+    const [autoSaveStatus, setAutoSaveStatus] = useState("idle");
+    const [lastSavedAt, setLastSavedAt] = useState(null);
+    // Refs for timers and tracking
+    const wsProviderRef = useRef(null);
+    const localSaveTimeoutRef = useRef(null);
+    const autoSaveTimeoutRef = useRef(null);
+    const maxIntervalTimeoutRef = useRef(null);
+    const lastSaveAttemptRef = useRef(0);
+    const hasUnsavedChangesRef = useRef(false);
+    const isSavingRef = useRef(false);
+    // Create stable yjs document
+    const ydoc = useMemo(() => new Y.Doc(), []);
+    // Cleanup yjs document on unmount
+    useEffect(() => {
+        return () => {
+            ydoc.destroy();
+        };
+    }, [ydoc]);
+    // Track if initial load from localStorage has been attempted
+    const hasLoadedRef = useRef(false);
+    // ============================================================================
+    // Auto-save to Database
+    // ============================================================================
+    /**
+     * Save the current document state to the database
+     */
+    const saveToDatabase = useCallback(async () => {
+        // Prevent concurrent saves
+        if (isSavingRef.current) {
+            return;
+        }
+        // Check minimum interval between saves
+        const now = Date.now();
+        const timeSinceLastSave = now - lastSaveAttemptRef.current;
+        if (timeSinceLastSave < PERSISTENCE_CONFIG.AUTO_SAVE.MIN_INTERVAL_MS &&
+            lastSaveAttemptRef.current > 0) {
+            // Schedule a save after the minimum interval
+            if (!autoSaveTimeoutRef.current) {
+                const delay = PERSISTENCE_CONFIG.AUTO_SAVE.MIN_INTERVAL_MS - timeSinceLastSave;
+                autoSaveTimeoutRef.current = setTimeout(() => {
+                    autoSaveTimeoutRef.current = null;
+                    if (hasUnsavedChangesRef.current) {
+                        void saveToDatabase();
+                    }
+                }, delay);
+            }
+            return;
+        }
+        isSavingRef.current = true;
+        lastSaveAttemptRef.current = now;
+        setAutoSaveStatus("saving");
+        try {
+            const content = encodeDocumentState(ydoc);
+            const wordCount = getWordCount(ydoc);
+            const previewSnippet = getPreviewSnippet(ydoc);
+            await updateDocumentApi(documentId, {
+                content,
+                wordCount,
+                previewSnippet,
+            });
+            hasUnsavedChangesRef.current = false;
+            setLastSavedAt(Date.now());
+            setAutoSaveStatus("saved");
+            // Reset to idle after a brief moment
+            setTimeout(() => {
+                setAutoSaveStatus("idle");
+            }, 2000);
+        }
+        catch (error) {
+            // eslint-disable-next-line no-console
+            console.error("Auto-save failed:", error);
+            setAutoSaveStatus("error");
+            // Reset to pending so we try again on next change
+            setTimeout(() => {
+                if (hasUnsavedChangesRef.current) {
+                    setAutoSaveStatus("pending");
+                }
+                else {
+                    setAutoSaveStatus("idle");
+                }
+            }, 3000);
+        }
+        finally {
+            isSavingRef.current = false;
+        }
+    }, [documentId, ydoc]);
+    /**
+     * Manually trigger a save (exposed via context)
+     */
+    const saveNow = useCallback(async () => {
+        // Clear any pending auto-save
+        if (autoSaveTimeoutRef.current) {
+            clearTimeout(autoSaveTimeoutRef.current);
+            autoSaveTimeoutRef.current = null;
+        }
+        if (maxIntervalTimeoutRef.current) {
+            clearTimeout(maxIntervalTimeoutRef.current);
+            maxIntervalTimeoutRef.current = null;
+        }
+        // Force save regardless of minimum interval
+        lastSaveAttemptRef.current = 0;
+        await saveToDatabase();
+    }, [saveToDatabase]);
+    /**
+     * Schedule a debounced auto-save
+     */
+    const scheduleAutoSave = useCallback(() => {
+        if (!enableAutoSave)
+            return;
+        hasUnsavedChangesRef.current = true;
+        setAutoSaveStatus("pending");
+        // Clear existing debounce timer
+        if (autoSaveTimeoutRef.current) {
+            clearTimeout(autoSaveTimeoutRef.current);
+        }
+        // Schedule debounced save
+        autoSaveTimeoutRef.current = setTimeout(() => {
+            autoSaveTimeoutRef.current = null;
+            void saveToDatabase();
+        }, PERSISTENCE_CONFIG.AUTO_SAVE.DEBOUNCE_MS);
+        // Setup max interval timer if not already set
+        if (!maxIntervalTimeoutRef.current) {
+            maxIntervalTimeoutRef.current = setTimeout(() => {
+                maxIntervalTimeoutRef.current = null;
+                if (hasUnsavedChangesRef.current && !isSavingRef.current) {
+                    // Clear debounce timer and save immediately
+                    if (autoSaveTimeoutRef.current) {
+                        clearTimeout(autoSaveTimeoutRef.current);
+                        autoSaveTimeoutRef.current = null;
+                    }
+                    void saveToDatabase();
+                }
+            }, PERSISTENCE_CONFIG.AUTO_SAVE.MAX_INTERVAL_MS);
+        }
+    }, [enableAutoSave, saveToDatabase]);
+    // ============================================================================
+    // Setup localStorage persistence for offline support
+    // ============================================================================
+    useEffect(() => {
+        // Skip if offline persistence is disabled or not in browser
+        if (!enableOffline || typeof window === "undefined") {
+            return;
+        }
+        // Load existing state from localStorage (only on first mount)
+        if (!hasLoadedRef.current) {
+            hasLoadedRef.current = true;
+            const loaded = loadFromLocalStorage(documentId, ydoc);
+            // Schedule state update via microtask to avoid synchronous setState in effect
+            if (loaded) {
+                Promise.resolve().then(() => setIsOfflineSynced(true));
+            }
+        }
+        // Save to localStorage on document changes (debounced)
+        const handleUpdate = () => {
+            // Clear any pending save
+            if (localSaveTimeoutRef.current) {
+                clearTimeout(localSaveTimeoutRef.current);
+            }
+            // Schedule a new save
+            localSaveTimeoutRef.current = setTimeout(() => {
+                saveToLocalStorage(documentId, ydoc);
+                setIsOfflineSynced(true);
+            }, PERSISTENCE_CONFIG.OFFLINE.SAVE_DEBOUNCE_MS);
+        };
+        ydoc.on("update", handleUpdate);
+        return () => {
+            ydoc.off("update", handleUpdate);
+            if (localSaveTimeoutRef.current) {
+                clearTimeout(localSaveTimeoutRef.current);
+                // Save immediately on cleanup
+                saveToLocalStorage(documentId, ydoc);
+            }
+        };
+    }, [documentId, ydoc, enableOffline]);
+    // ============================================================================
+    // Setup auto-save to database
+    // ============================================================================
+    useEffect(() => {
+        if (!enableAutoSave || typeof window === "undefined") {
+            return;
+        }
+        // Listen for document changes and schedule auto-save
+        const handleUpdate = (_update, origin) => {
+            // Only save for local changes (not remote sync updates)
+            // Remote updates have origin === wsProvider
+            if (origin !== wsProviderRef.current) {
+                scheduleAutoSave();
+            }
+        };
+        ydoc.on("update", handleUpdate);
+        return () => {
+            ydoc.off("update", handleUpdate);
+            // Clear timers
+            if (autoSaveTimeoutRef.current) {
+                clearTimeout(autoSaveTimeoutRef.current);
+            }
+            if (maxIntervalTimeoutRef.current) {
+                clearTimeout(maxIntervalTimeoutRef.current);
+            }
+            // Save on cleanup if there are unsaved changes
+            if (hasUnsavedChangesRef.current && !isSavingRef.current) {
+                // Use sendBeacon for reliable save on page unload
+                const content = encodeDocumentState(ydoc);
+                const wordCount = getWordCount(ydoc);
+                const previewSnippet = getPreviewSnippet(ydoc);
+                // Try to save synchronously via beacon (best effort)
+                try {
+                    const url = `/api/collaborations/documents/${documentId}`;
+                    const body = JSON.stringify({ content, wordCount, previewSnippet });
+                    navigator.sendBeacon(url, new Blob([body], { type: "application/json" }));
+                }
+                catch (_a) {
+                    // Best effort - may fail on cleanup
+                }
+            }
+        };
+    }, [documentId, ydoc, enableAutoSave, scheduleAutoSave]);
+    // ============================================================================
+    // Setup WebSocket provider for real-time sync
+    // ============================================================================
+    useEffect(() => {
+        // Early return for offline mode - state is already set via initial values
+        if (!wsUrl) {
+            return;
+        }
+        const provider = new WebsocketProvider(wsUrl, documentId, ydoc, {
+            connect: true,
+        });
+        // Store in ref for reconnect functionality
+        wsProviderRef.current = provider;
+        // Set user awareness if provided
+        if (user) {
+            provider.awareness.setLocalStateField("user", {
+                id: user.id,
+                name: user.name,
+                color: user.color,
+                avatarUrl: user.avatarUrl,
+            });
+        }
+        // Handle connection status changes - this is called asynchronously by the provider
+        provider.on("status", ({ status: providerStatus }) => {
+            if (providerStatus === "connected") {
+                setStatus("connected");
+                // Set awareness when connection is established (async callback, not synchronous)
+                setAwareness(provider.awareness);
+            }
+            else if (providerStatus === "disconnected") {
+                setStatus("disconnected");
+            }
+            else {
+                setStatus("connecting");
+            }
+        });
+        provider.on("sync", (synced) => {
+            setIsSynced(synced);
+        });
+        // If already connected (reconnect scenario), set awareness immediately via microtask
+        if (provider.wsconnected) {
+            Promise.resolve().then(() => {
+                setAwareness(provider.awareness);
+            });
+        }
+        return () => {
+            provider.destroy();
+            wsProviderRef.current = null;
+            setAwareness(null);
+        };
+    }, [documentId, wsUrl, ydoc, user]);
+    // Reconnect function - uses ref to avoid dependency on state
+    const reconnect = useCallback(() => {
+        const provider = wsProviderRef.current;
+        if (provider) {
+            provider.disconnect();
+            provider.connect();
+        }
+    }, []);
+    // Context value
+    const contextValue = useMemo(() => ({
+        ydoc,
+        awareness,
+        status,
+        isSynced,
+        isOfflineSynced,
+        reconnect,
+        autoSaveStatus,
+        lastSavedAt,
+        saveNow,
+    }), [
+        ydoc,
+        awareness,
+        status,
+        isSynced,
+        isOfflineSynced,
+        reconnect,
+        autoSaveStatus,
+        lastSavedAt,
+        saveNow,
+    ]);
+    return _jsx(YjsContext.Provider, { value: contextValue, children: children });
+}
+//# sourceMappingURL=yjs-provider.js.map

package/dist/collaboration/providers/yjs-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-provider.js","sourceRoot":"","sources":["../../../lib/collaboration/providers/yjs-provider.tsx"],"names":[],"mappings":"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"}

package/dist/collaboration/services/collaboration.service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * CollaborationService - Document CRUD operations
+ *
+ * Handles document creation, retrieval, updates, and deletion with
+ * dual-layer permission model (system-level Casbin + document-level).
+ */
+import type { CollaborationServiceDeps, CreateDocumentParams, DeleteDocumentParams, GetDocumentParams, ListDocumentsParams, ListDocumentsResponse, PermanentDeleteDocumentParams, RestoreDocumentParams, UpdateDocumentParams } from "../collaboration.interfaces";
+import type { CollabDocument } from "../collaboration.schemas";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+/**
+ * Service for managing collaborative documents.
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaborationService();
+ *
+ * // Create a document
+ * const doc = await service.create({
+ *   tenantId: "acme",
+ *   title: "Project Proposal",
+ *   ownerId: "user-123",
+ *   ownerName: "John Doe",
+ *   ownerEmail: "john@example.com",
+ * });
+ *
+ * // Get a document
+ * const doc = await service.get({ tenantId, documentId, userId });
+ * ```
+ */
+export declare class CollaborationService extends BaseAwsService {
+    private db;
+    constructor(deps?: CollaborationServiceDeps);
+    /**
+     * Create a new collaborative document.
+     *
+     * @param params - Document creation parameters
+     * @returns The created document
+     */
+    create(params: CreateDocumentParams): Promise<CollabDocument>;
+    /**
+     * Get a document by ID.
+     *
+     * @param params - Get document parameters
+     * @returns The document
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     */
+    get(params: GetDocumentParams): Promise<CollabDocument>;
+    /**
+     * List documents for a user.
+     * Returns documents where user is owner or collaborator.
+     *
+     * @param params - List parameters
+     * @returns List of documents with pagination
+     */
+    list(params: ListDocumentsParams): Promise<ListDocumentsResponse>;
+    /**
+     * Update a document.
+     *
+     * @param params - Update parameters
+     * @returns The updated document
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have edit permission
+     */
+    update(params: UpdateDocumentParams): Promise<CollabDocument>;
+    /**
+     * Soft delete a document (move to trash).
+     *
+     * @param params - Delete parameters
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have delete permission
+     */
+    delete(params: DeleteDocumentParams): Promise<void>;
+    /**
+     * Restore a trashed document.
+     *
+     * @param params - Restore parameters
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have permission
+     */
+    restore(params: RestoreDocumentParams): Promise<void>;
+    /**
+     * Permanently delete a document.
+     *
+     * @param params - Delete parameters
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have permission
+     */
+    permanentDelete(params: PermanentDeleteDocumentParams): Promise<void>;
+}
+/**
+ * Get the singleton CollaborationService instance.
+ *
+ * @returns CollaborationService instance
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaborationService();
+ * await service.create({ ... });
+ * ```
+ */
+export declare function getCollaborationService(): CollaborationService;
+//# sourceMappingURL=collaboration.service.d.ts.map

package/dist/collaboration/services/collaboration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/collaboration.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAoBhF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,OAAO,CAAC,EAAE,CAA8C;gBAE5C,IAAI,GAAE,wBAA6B;IAM/C;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmEnE;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA4B7D;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAqHvE;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAiGnE;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD3D;;;;;;OAMG;IACG,eAAe,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;CAkC5E;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAmB9D"}