captify 0.1.17 → 0.1.19

package/dist/collaboration/services/comment.service.js

@@ -0,0 +1,312 @@
+/**
+ * CommentService - Document inline comments operations
+ *
+ * Handles comment creation, retrieval, updates, resolution, and deletion.
+ * Supports threaded comments with anchor positions for text highlighting.
+ */
+import { randomUUID } from "crypto";
+import { TABLES } from "../../shared/shared.constants";
+import { collabCommentKeys } from "../../db/schemas/collab-comments.schema";
+import { DocumentNotFoundError } from "../collaboration.errors";
+import { DynamoDbInstances } from "../../shared/services/dynamodb";
+import { LoggerFactory } from "../../shared/services/logger";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+/**
+ * Service for managing document comments.
+ *
+ * @example
+ * ```typescript
+ * const service = getCommentService();
+ *
+ * // Create a comment
+ * const comment = await service.create({
+ *   documentId: "doc-123",
+ *   anchorStart: startBytes,
+ *   anchorEnd: endBytes,
+ *   anchorText: "selected text",
+ *   content: "This needs revision",
+ *   authorId: "user-123",
+ *   authorName: "John Doe",
+ *   authorEmail: "john@example.com",
+ * });
+ *
+ * // List comments
+ * const { comments } = await service.list({ documentId: "doc-123" });
+ *
+ * // Resolve a comment
+ * await service.resolve({
+ *   documentId: "doc-123",
+ *   commentId: "comment-456",
+ *   resolvedById: "user-789",
+ * });
+ * ```
+ */
+export class CommentService extends BaseAwsService {
+    constructor(deps = {}) {
+        var _a;
+        super({ logger: deps.logger });
+        this.db =
+            (_a = deps.db) !== null && _a !== void 0 ? _a : DynamoDbInstances.getInstance(TABLES.collabComments);
+    }
+    /**
+     * Create a new comment.
+     *
+     * @param params - Comment creation parameters
+     * @returns The created comment
+     */
+    async create(params) {
+        const { documentId, documentTitle: _documentTitle, // Unused but kept for future notification implementation
+        parentId, anchorStart, anchorEnd, anchorText, content, authorId, authorName, authorEmail, authorAvatar, mentions, mentionNames: _mentionNames, // Unused but kept for future notification implementation
+        userCredentials, } = params;
+        const commentId = randomUUID();
+        const now = Date.now();
+        const comment = {
+            id: commentId,
+            documentId,
+            parentId: parentId !== null && parentId !== void 0 ? parentId : null,
+            anchorStart: anchorStart,
+            anchorEnd: anchorEnd,
+            anchorText,
+            content,
+            authorId,
+            authorName,
+            authorEmail,
+            authorAvatar,
+            status: "open",
+            mentions,
+            createdAt: now,
+            updatedAt: now,
+            createdById: authorId,
+        };
+        const document = Object.assign({ PK: collabCommentKeys.pk(documentId), SK: collabCommentKeys.sk(commentId) }, comment);
+        await this.db.putItem(document, { userCredentials });
+        this.logger.info("Comment created", {
+            documentId,
+            commentId,
+            parentId,
+            authorId,
+        });
+        // Note: In-app notifications for mentions and replies can be implemented
+        // in the future using a real-time notification system backed by a database.
+        return comment;
+    }
+    /**
+     * List comments for a document.
+     *
+     * @param params - List parameters
+     * @returns List of comments
+     */
+    async list(params) {
+        var _a;
+        const { documentId, status = "all", limit = 100, userCredentials } = params;
+        const filterExpression = status !== "all"
+            ? "attribute_not_exists(deletedAt) AND #status = :status"
+            : "attribute_not_exists(deletedAt)";
+        const expressionAttributeValues = {
+            ":pk": collabCommentKeys.pk(documentId),
+        };
+        const expressionAttributeNames = {};
+        if (status !== "all") {
+            expressionAttributeValues[":status"] = status;
+            expressionAttributeNames["#status"] = "status";
+        }
+        const result = await this.db.queryItems({
+            KeyConditionExpression: "PK = :pk",
+            FilterExpression: filterExpression,
+            ExpressionAttributeValues: expressionAttributeValues,
+            ExpressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : undefined,
+            ScanIndexForward: true, // Oldest first
+            Limit: limit,
+        }, { userCredentials });
+        const comments = ((_a = result.Items) !== null && _a !== void 0 ? _a : []);
+        return { comments };
+    }
+    /**
+     * Get a single comment by ID.
+     *
+     * @param params - Get parameters
+     * @returns The comment if found
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    async get(params) {
+        const { documentId, commentId, userCredentials } = params;
+        const result = await this.db.getItem({
+            PK: collabCommentKeys.pk(documentId),
+            SK: collabCommentKeys.sk(commentId),
+        }, { userCredentials });
+        if (!result.Item) {
+            throw new DocumentNotFoundError(commentId);
+        }
+        return result.Item;
+    }
+    /**
+     * Update a comment's content.
+     *
+     * @param params - Update parameters
+     * @returns The updated comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    async update(params) {
+        const { documentId, commentId, content, mentions, userCredentials } = params;
+        // Build update expression
+        const updateParts = ["#updatedAt = :updatedAt"];
+        const expressionAttributeNames = {
+            "#updatedAt": "updatedAt",
+        };
+        const expressionAttributeValues = {
+            ":updatedAt": Date.now(),
+        };
+        if (content !== undefined) {
+            updateParts.push("#content = :content");
+            expressionAttributeNames["#content"] = "content";
+            expressionAttributeValues[":content"] = content;
+        }
+        if (mentions !== undefined) {
+            updateParts.push("#mentions = :mentions");
+            expressionAttributeNames["#mentions"] = "mentions";
+            expressionAttributeValues[":mentions"] = mentions;
+        }
+        const result = await this.db.updateItem({
+            PK: collabCommentKeys.pk(documentId),
+            SK: collabCommentKeys.sk(commentId),
+        }, `SET ${updateParts.join(", ")}`, expressionAttributeNames, expressionAttributeValues, { userCredentials, conditionExpression: "attribute_exists(PK)" });
+        if (!result.Attributes) {
+            throw new DocumentNotFoundError(commentId);
+        }
+        const doc = result.Attributes;
+        this.logger.info("Comment updated", {
+            documentId,
+            commentId,
+        });
+        return doc;
+    }
+    /**
+     * Resolve a comment.
+     *
+     * @param params - Resolve parameters
+     * @returns The resolved comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    async resolve(params) {
+        const { documentId, commentId, resolvedById, userCredentials } = params;
+        const now = Date.now();
+        const result = await this.db.updateItem({
+            PK: collabCommentKeys.pk(documentId),
+            SK: collabCommentKeys.sk(commentId),
+        }, "SET #status = :status, #resolvedById = :resolvedById, #resolvedAt = :resolvedAt, #updatedAt = :updatedAt", {
+            "#status": "status",
+            "#resolvedById": "resolvedById",
+            "#resolvedAt": "resolvedAt",
+            "#updatedAt": "updatedAt",
+        }, {
+            ":status": "resolved",
+            ":resolvedById": resolvedById,
+            ":resolvedAt": now,
+            ":updatedAt": now,
+        }, { userCredentials, conditionExpression: "attribute_exists(PK)" });
+        if (!result.Attributes) {
+            throw new DocumentNotFoundError(commentId);
+        }
+        const doc = result.Attributes;
+        this.logger.info("Comment resolved", {
+            documentId,
+            commentId,
+            resolvedById,
+        });
+        return doc;
+    }
+    /**
+     * Reopen a resolved comment.
+     *
+     * @param params - Reopen parameters (same as resolve but clears resolution)
+     * @returns The reopened comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    async reopen(params) {
+        const { documentId, commentId, userCredentials } = params;
+        const result = await this.db.updateItem({
+            PK: collabCommentKeys.pk(documentId),
+            SK: collabCommentKeys.sk(commentId),
+        }, "SET #status = :status, #updatedAt = :updatedAt REMOVE #resolvedById, #resolvedAt", {
+            "#status": "status",
+            "#resolvedById": "resolvedById",
+            "#resolvedAt": "resolvedAt",
+            "#updatedAt": "updatedAt",
+        }, {
+            ":status": "open",
+            ":updatedAt": Date.now(),
+        }, { userCredentials, conditionExpression: "attribute_exists(PK)" });
+        if (!result.Attributes) {
+            throw new DocumentNotFoundError(commentId);
+        }
+        const doc = result.Attributes;
+        this.logger.info("Comment reopened", {
+            documentId,
+            commentId,
+        });
+        return doc;
+    }
+    /**
+     * Delete a comment.
+     *
+     * @param params - Delete parameters
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    async delete(params) {
+        const { documentId, commentId, userCredentials } = params;
+        await this.db.deleteItem({
+            PK: collabCommentKeys.pk(documentId),
+            SK: collabCommentKeys.sk(commentId),
+        }, { userCredentials });
+        this.logger.info("Comment deleted", {
+            documentId,
+            commentId,
+        });
+    }
+    /**
+     * Get replies to a comment.
+     *
+     * @param params - Get parameters (documentId and parentId)
+     * @returns List of reply comments
+     */
+    async getReplies(params) {
+        var _a;
+        const { documentId, commentId: parentId, userCredentials } = params;
+        const result = await this.db.queryItems({
+            KeyConditionExpression: "PK = :pk",
+            FilterExpression: "parentId = :parentId AND attribute_not_exists(deletedAt)",
+            ExpressionAttributeValues: {
+                ":pk": collabCommentKeys.pk(documentId),
+                ":parentId": parentId,
+            },
+            ScanIndexForward: true, // Oldest first
+        }, { userCredentials });
+        const comments = ((_a = result.Items) !== null && _a !== void 0 ? _a : []);
+        return { comments };
+    }
+}
+// ============================================================================
+// Singleton Pattern
+// ============================================================================
+let instance = null;
+/**
+ * Get the CommentService singleton instance.
+ *
+ * @returns CommentService instance
+ */
+export function getCommentService() {
+    if (!instance) {
+        instance = new CommentService({
+            logger: LoggerFactory.createLogger({
+                serviceName: "CommentService",
+                userContext: {
+                    userId: "system",
+                    email: "system@captify.com",
+                    name: "System Service Account",
+                },
+            }),
+        });
+    }
+    return instance;
+}
+//# sourceMappingURL=comment.service.js.map

package/dist/collaboration/services/comment.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.service.js","sourceRoot":"","sources":["../../../lib/collaboration/services/comment.service.ts"],"names":[],"mappings":"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"}

package/dist/collaboration/services/document-generation-client.service.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentGenerationStreamParams } from "../collaboration.interfaces";
+export declare function streamDocumentGeneration({ documentId, prompt, files, ydoc, onTitleChange, onChunk, signal, }: DocumentGenerationStreamParams): Promise<void>;
+//# sourceMappingURL=document-generation-client.service.d.ts.map

package/dist/collaboration/services/document-generation-client.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-generation-client.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/document-generation-client.service.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAEnG,wBAAsB,wBAAwB,CAAC,EAC7C,UAAU,EACV,MAAM,EACN,KAAK,EACL,IAAI,EACJ,aAAa,EACb,OAAO,EACP,MAAM,GACP,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmHhD"}

package/dist/collaboration/services/document-generation-client.service.js

@@ -0,0 +1,106 @@
+import { AI_CONTEXT_MODE, COLLABORATION_API_ROUTES, COLLABORATION_GENERATION_STREAM, COLLABORATION_HTTP_HEADERS, COLLABORATION_HTTP_METHODS, COLLABORATION_HTTP_VALUES, COLLABORATION_LIMITS, COLLABORATION_UI_TEXT, YJS_TEXT_KEY, } from "../collaboration.constants";
+import { DocumentGenerationError } from "../collaboration.errors";
+import { parseGeneratedDocument } from "../collaboration.utilities";
+export async function streamDocumentGeneration({ documentId, prompt, files, ydoc, onTitleChange, onChunk, signal, }) {
+    const trimmedPrompt = prompt.trim();
+    if (!trimmedPrompt) {
+        throw new DocumentGenerationError(COLLABORATION_GENERATION_STREAM.ERROR_GENERIC, {
+            documentId,
+        });
+    }
+    const initialTitle = trimmedPrompt.slice(0, COLLABORATION_LIMITS.MAX_TITLE_LENGTH).trim();
+    if (initialTitle) {
+        onTitleChange(initialTitle);
+    }
+    const ytext = ydoc.getText(YJS_TEXT_KEY);
+    ytext.delete(0, ytext.length);
+    const timeoutController = new AbortController();
+    const timeoutId = setTimeout(() => {
+        timeoutController.abort();
+    }, COLLABORATION_GENERATION_STREAM.TIMEOUT_MS);
+    const handleAbort = () => {
+        timeoutController.abort();
+    };
+    signal.addEventListener("abort", handleAbort, { once: true });
+    let response;
+    try {
+        response = await fetch(COLLABORATION_API_ROUTES.GENERATE_STREAM, {
+            method: COLLABORATION_HTTP_METHODS.POST,
+            headers: {
+                [COLLABORATION_HTTP_HEADERS.CONTENT_TYPE]: COLLABORATION_HTTP_VALUES.APPLICATION_JSON,
+            },
+            body: JSON.stringify({
+                documentId,
+                messages: [
+                    {
+                        id: crypto.randomUUID(),
+                        role: "user",
+                        parts: [{ type: "text", text: trimmedPrompt }],
+                    },
+                ],
+                contextMode: AI_CONTEXT_MODE.FULL_DOCUMENT,
+                files,
+            }),
+            signal: timeoutController.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeoutId);
+        signal.removeEventListener("abort", handleAbort);
+    }
+    if (!response.ok) {
+        const errorData = await response
+            .json()
+            .catch(() => ({ error: COLLABORATION_GENERATION_STREAM.ERROR_GENERIC }));
+        throw new DocumentGenerationError(errorData.error || COLLABORATION_GENERATION_STREAM.ERROR_GENERIC, {
+            documentId,
+        });
+    }
+    if (!response.body) {
+        throw new DocumentGenerationError(COLLABORATION_GENERATION_STREAM.ERROR_NO_RESPONSE_BODY, {
+            documentId,
+        });
+    }
+    const reader = response.body.getReader();
+    const decoder = new globalThis.TextDecoder();
+    let fullContent = "";
+    let lastTitle = initialTitle;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        const chunk = decoder.decode(value, { stream: true });
+        const lines = chunk.split(COLLABORATION_GENERATION_STREAM.NEWLINE);
+        for (const line of lines) {
+            if (!line.startsWith(COLLABORATION_GENERATION_STREAM.SSE_PREFIX))
+                continue;
+            try {
+                const data = JSON.parse(line.slice(COLLABORATION_GENERATION_STREAM.SSE_PREFIX.length));
+                // Handle AI SDK streaming format
+                if (data.type === "text-delta" && data.delta) {
+                    fullContent += data.delta;
+                    ytext.insert(ytext.length, data.delta);
+                    onChunk === null || onChunk === void 0 ? void 0 : onChunk();
+                    const parsed = parseGeneratedDocument(fullContent);
+                    const nextTitle = parsed.title.trim();
+                    if (nextTitle && nextTitle !== lastTitle) {
+                        lastTitle = nextTitle;
+                        onTitleChange(nextTitle.slice(0, COLLABORATION_LIMITS.MAX_TITLE_LENGTH));
+                    }
+                }
+                else if (data.type === "error" && data.errorText) {
+                    throw new DocumentGenerationError(data.errorText, { documentId });
+                }
+            }
+            catch (error) {
+                if (error instanceof DocumentGenerationError) {
+                    throw error;
+                }
+            }
+        }
+    }
+    if (!lastTitle) {
+        onTitleChange(COLLABORATION_UI_TEXT.UNTITLED_DOCUMENT);
+    }
+}
+//# sourceMappingURL=document-generation-client.service.js.map

package/dist/collaboration/services/document-generation-client.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-generation-client.service.js","sourceRoot":"","sources":["../../../lib/collaboration/services/document-generation-client.service.ts"],"names":[],"mappings":"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"}

package/dist/collaboration/services/document-generation.service.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DocumentGenerationService - AI generation for collaborative documents
+ */
+import type { GenerateDocumentParams, StreamContentGenerationParams } from "../collaboration.interfaces";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+export declare class DocumentGenerationService extends BaseAwsService {
+    constructor();
+    /**
+     * Stream content generation with model/agent routing.
+     * Returns a Response object using the AI SDK streaming protocol.
+     */
+    streamContentGeneration(params: StreamContentGenerationParams): Promise<Response>;
+    /**
+     * Route through AgentsService for agent-based generation.
+     * Enriches the last user message with document context before forwarding.
+     */
+    private streamAgentContent;
+    /**
+     * Stream using a direct model (user-selected or system default).
+     * Uses streamText + toUIMessageStreamResponse for AI SDK protocol.
+     */
+    private streamDirectModelContent;
+    /**
+     * Resolve an AI SDK LanguageModel from either a specific modelId (UUID)
+     * or the system default.
+     */
+    private resolveModel;
+    generateDocumentFromPrompt(params: GenerateDocumentParams): Promise<{
+        id: string;
+        createdAt: number;
+        updatedAt: number;
+        createdById: string;
+        tenantId: string;
+        title: string;
+        content: Uint8Array<ArrayBufferLike>;
+        wordCount: number;
+        ownerId: string;
+        ownerName: string;
+        ownerEmail: string;
+        status: "active" | "trashed" | "deleted";
+        modifiedById?: string | undefined;
+        contentVector?: Uint8Array<ArrayBufferLike> | undefined;
+        contentS3Key?: string | undefined;
+        previewSnippet?: string | undefined;
+        trashedAt?: number | undefined;
+        deletedAt?: number | undefined;
+    }>;
+    private getModel;
+    private assertGenerationAccess;
+}
+export declare function getDocumentGenerationService(): DocumentGenerationService;
+//# sourceMappingURL=document-generation.service.d.ts.map

package/dist/collaboration/services/document-generation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-generation.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/document-generation.service.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,OAAO,KAAK,EAGV,sBAAsB,EACtB,6BAA6B,EAC9B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE,qBAAa,yBAA0B,SAAQ,cAAc;;IAK3D;;;OAGG;IACG,uBAAuB,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,QAAQ,CAAC;IAavF;;;OAGG;YACW,kBAAkB;IAwChC;;;OAGG;YACW,wBAAwB;IA0BtC;;;OAGG;YACW,YAAY;IA0CpB,0BAA0B,CAAC,MAAM,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;YA4CjD,QAAQ;YAyBR,sBAAsB;CAyBrC;AAID,wBAAgB,4BAA4B,8BAK3C"}