captify 0.1.18 → 1.1.0

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

@@ -0,0 +1,319 @@
+/**
+ * CollaboratorService - Manage document collaborators
+ *
+ * Handles adding, updating, and removing collaborators with
+ * permission level validation. Supports owner detection and
+ * listing documents shared with a user.
+ */
+import { randomUUID } from "crypto";
+import { TABLES } from "../../shared/shared.constants";
+import { collaboratorKeys } from "../../db/schemas";
+import { documentCollaboratorSchema } from "../collaboration.schemas";
+import { CollaboratorNotFoundError, CollaboratorExistsError, CannotRemoveOwnerError, CannotDemoteLastAdminError, CollaborationError, } 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 collaborators.
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaboratorService();
+ *
+ * // Add a collaborator
+ * const collab = await service.add({
+ *   documentId: "doc-123",
+ *   userId: "user-456",
+ *   userName: "Jane Smith",
+ *   userEmail: "jane@example.com",
+ *   permissionLevel: "edit",
+ *   invitedById: "owner-123",
+ *   invitedByName: "John Doe",
+ * });
+ *
+ * // List collaborators
+ * const { collaborators } = await service.list({ documentId: "doc-123" });
+ * ```
+ */
+export class CollaboratorService extends BaseAwsService {
+    constructor(deps = {}) {
+        var _a;
+        super({ logger: deps.logger });
+        this.db =
+            (_a = deps.db) !== null && _a !== void 0 ? _a : DynamoDbInstances.getInstance(TABLES.collabCollaborators);
+    }
+    /**
+     * Add a collaborator to a document.
+     *
+     * @param params - Collaborator details
+     * @returns The created collaborator record
+     * @throws {CollaboratorExistsError} If user is already a collaborator
+     */
+    async add(params) {
+        const { documentId, documentTitle: _documentTitle, // Unused but kept for future notification implementation
+        userId, userName, userEmail, userAvatar, permissionLevel, invitedById, invitedByName, userCredentials, } = params;
+        // Check if collaborator already exists
+        const existing = await this.getOptional({ documentId, userId, userCredentials });
+        if (existing) {
+            throw new CollaboratorExistsError(documentId, userId);
+        }
+        const collaboratorId = randomUUID();
+        const now = Date.now();
+        const collaborator = {
+            id: collaboratorId,
+            documentId,
+            userId,
+            userName,
+            userEmail,
+            userAvatar,
+            permissionLevel,
+            invitedById,
+            invitedByName,
+            createdAt: now,
+            updatedAt: now,
+            createdById: invitedById,
+            modifiedById: invitedById,
+        };
+        // Validate before persisting
+        documentCollaboratorSchema.parse(collaborator);
+        const item = Object.assign({ PK: collaboratorKeys.pk(documentId), SK: collaboratorKeys.sk(userId), GSI1_PK: collaboratorKeys.gsi1Pk(userId), GSI1_SK: collaboratorKeys.gsi1Sk(documentId) }, collaborator);
+        await this.db.putItem(item, { userCredentials });
+        // Note: In-app notifications for sharing can be implemented in the future
+        // using a real-time notification system backed by a database.
+        this.logger.info("Collaborator added", {
+            documentId,
+            userId,
+            permissionLevel,
+            invitedById,
+        });
+        return collaborator;
+    }
+    /**
+     * Get a collaborator by document and user ID.
+     *
+     * @param params - Get parameters
+     * @returns The collaborator record
+     * @throws {CollaboratorNotFoundError} If collaborator doesn't exist
+     */
+    async get(params) {
+        const collaborator = await this.getOptional(params);
+        if (!collaborator) {
+            throw new CollaboratorNotFoundError(params.documentId, params.userId);
+        }
+        return collaborator;
+    }
+    /**
+     * Get a collaborator by document and user ID, returning null if not found.
+     *
+     * @param params - Get parameters
+     * @returns The collaborator record or null
+     */
+    async getOptional(params) {
+        const { documentId, userId, userCredentials } = params;
+        const { Item } = await this.db.getItem({
+            PK: collaboratorKeys.pk(documentId),
+            SK: collaboratorKeys.sk(userId),
+        }, { userCredentials });
+        if (!Item) {
+            return null;
+        }
+        const parseResult = documentCollaboratorSchema.safeParse(Item);
+        if (!parseResult.success) {
+            this.logger.warn("Invalid collaborator in database", {
+                documentId,
+                userId,
+                errors: parseResult.error.issues,
+            });
+            throw new CollaborationError("Collaborator data is corrupted", "COLLABORATOR_CORRUPTED", 500);
+        }
+        return parseResult.data;
+    }
+    /**
+     * List all collaborators for a document.
+     *
+     * @param params - List parameters
+     * @returns List of collaborators
+     */
+    async list(params) {
+        var _a;
+        const { documentId, userCredentials } = params;
+        const result = await this.db.queryItems({
+            KeyConditionExpression: "PK = :pk AND begins_with(SK, :skPrefix)",
+            ExpressionAttributeValues: {
+                ":pk": collaboratorKeys.pk(documentId),
+                ":skPrefix": "COLLABORATOR#",
+            },
+        }, { userCredentials });
+        const items = (_a = result.Items) !== null && _a !== void 0 ? _a : [];
+        const collaborators = items
+            .map((item) => {
+            const parseResult = documentCollaboratorSchema.safeParse(item);
+            return parseResult.success ? parseResult.data : null;
+        })
+            .filter((collab) => collab !== null);
+        return { collaborators };
+    }
+    /**
+     * List document IDs shared with a user.
+     * Uses GSI1 to query by userId.
+     *
+     * @param params - List parameters
+     * @returns List of document IDs
+     */
+    async listSharedDocuments(params) {
+        var _a;
+        const { userId, userCredentials } = params;
+        const result = await this.db.queryItems({
+            IndexName: "GSI1",
+            KeyConditionExpression: "GSI1_PK = :pk",
+            ExpressionAttributeValues: {
+                ":pk": collaboratorKeys.gsi1Pk(userId),
+            },
+        }, { userCredentials });
+        const items = (_a = result.Items) !== null && _a !== void 0 ? _a : [];
+        const documentIds = items
+            .map((item) => {
+            const parseResult = documentCollaboratorSchema.safeParse(item);
+            return parseResult.success ? parseResult.data.documentId : null;
+        })
+            .filter((id) => id !== null);
+        return { documentIds };
+    }
+    /**
+     * Update a collaborator's permission level.
+     *
+     * @param params - Update parameters
+     * @throws {CollaboratorNotFoundError} If collaborator doesn't exist
+     * @throws {CannotDemoteLastAdminError} If demoting the last admin
+     */
+    async update(params) {
+        const { documentId, userId, permissionLevel, updatedById, userCredentials } = params;
+        // First, get the specific collaborator to check their current permission
+        const targetCollab = await this.getOptional({ documentId, userId, userCredentials });
+        if (!targetCollab) {
+            throw new CollaboratorNotFoundError(documentId, userId);
+        }
+        // Only check admin count if demoting from admin (performance optimization)
+        if (targetCollab.permissionLevel === "admin" && permissionLevel !== "admin") {
+            // Only now fetch all collaborators to count admins
+            const { collaborators } = await this.list({ documentId, userCredentials });
+            const adminCount = collaborators.filter((c) => c.permissionLevel === "admin").length;
+            if (adminCount <= 1) {
+                throw new CannotDemoteLastAdminError(documentId, userId);
+            }
+        }
+        const now = Date.now();
+        const expression = this.db
+            .createUpdateBuilder()
+            .set("permissionLevel", permissionLevel)
+            .set("updatedAt", now)
+            .set("modifiedById", updatedById)
+            .build();
+        // Add ConditionExpression to prevent race condition when demoting admin
+        // Only allow demotion if the target is currently an admin
+        const conditionExpression = permissionLevel !== "admin" ? "permissionLevel = :adminLevel" : undefined;
+        const conditionAttributeValues = permissionLevel !== "admin" ? { ":adminLevel": "admin" } : undefined;
+        await this.db.updateItem({
+            PK: collaboratorKeys.pk(documentId),
+            SK: collaboratorKeys.sk(userId),
+        }, expression.UpdateExpression, expression.ExpressionAttributeNames, Object.assign(Object.assign({}, expression.ExpressionAttributeValues), conditionAttributeValues), {
+            userCredentials,
+            conditionExpression,
+        });
+        this.logger.info("Collaborator permission updated", {
+            documentId,
+            userId,
+            permissionLevel,
+            updatedById,
+        });
+    }
+    /**
+     * Remove a collaborator from a document.
+     *
+     * @param params - Remove parameters
+     * @throws {CollaboratorNotFoundError} If collaborator doesn't exist
+     * @throws {CannotRemoveOwnerError} If trying to remove the owner
+     */
+    async remove(params) {
+        const { documentId, userId, removedById, userCredentials } = params;
+        // Get the collaborator to check if they're the owner
+        const collaborator = await this.getOptional({ documentId, userId, userCredentials });
+        if (!collaborator) {
+            throw new CollaboratorNotFoundError(documentId, userId);
+        }
+        // Owner is identified by having same userId and invitedById (self-invited)
+        if (collaborator.userId === collaborator.invitedById) {
+            throw new CannotRemoveOwnerError(documentId, userId);
+        }
+        await this.db.deleteItem({
+            PK: collaboratorKeys.pk(documentId),
+            SK: collaboratorKeys.sk(userId),
+        }, { userCredentials });
+        this.logger.info("Collaborator removed", {
+            documentId,
+            userId,
+            removedById,
+        });
+    }
+    /**
+     * Check if a user is the document owner.
+     *
+     * @param params - Get parameters
+     * @returns True if user is the owner
+     */
+    async isOwner(params) {
+        const collaborator = await this.getOptional(params);
+        if (!collaborator) {
+            return false;
+        }
+        // Owner is identified by having same userId and invitedById (self-invited)
+        return collaborator.userId === collaborator.invitedById;
+    }
+    /**
+     * Get a user's permission level for a document.
+     *
+     * @param params - Get parameters
+     * @returns The permission level or null if not a collaborator
+     */
+    async getPermissionLevel(params) {
+        var _a;
+        const collaborator = await this.getOptional(params);
+        return (_a = collaborator === null || collaborator === void 0 ? void 0 : collaborator.permissionLevel) !== null && _a !== void 0 ? _a : null;
+    }
+}
+/**
+ * Lazy-initialized singleton instance of CollaboratorService.
+ */
+let collaboratorServiceInstance = null;
+/**
+ * Get the singleton CollaboratorService instance.
+ *
+ * @returns CollaboratorService instance
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaboratorService();
+ * await service.add({ ... });
+ * ```
+ */
+export function getCollaboratorService() {
+    if (!collaboratorServiceInstance) {
+        collaboratorServiceInstance = new CollaboratorService({
+            logger: LoggerFactory.createLogger({
+                serviceName: "CollaboratorService",
+                userContext: {
+                    userId: "system",
+                    email: "system@captify.com",
+                    name: "System Service Account",
+                    roles: ["service"],
+                    metadata: {
+                        isSystemUser: true,
+                        note: "Service-level logger - user context should be provided by caller",
+                    },
+                },
+            }),
+        });
+    }
+    return collaboratorServiceInstance;
+}
+//# sourceMappingURL=collaborator.service.js.map

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

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

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

@@ -0,0 +1,110 @@
+/**
+ * CommentService - Document inline comments operations
+ *
+ * Handles comment creation, retrieval, updates, resolution, and deletion.
+ * Supports threaded comments with anchor positions for text highlighting.
+ */
+import type { CommentServiceDeps, CreateCommentParams, ListCommentsParams, GetCommentParams, UpdateCommentParams, ResolveCommentParams, DeleteCommentParams, ListCommentsResponse } from "../collaboration.interfaces";
+import type { DocumentComment } from "../collaboration.schemas";
+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 declare class CommentService extends BaseAwsService {
+    private db;
+    constructor(deps?: CommentServiceDeps);
+    /**
+     * Create a new comment.
+     *
+     * @param params - Comment creation parameters
+     * @returns The created comment
+     */
+    create(params: CreateCommentParams): Promise<DocumentComment>;
+    /**
+     * List comments for a document.
+     *
+     * @param params - List parameters
+     * @returns List of comments
+     */
+    list(params: ListCommentsParams): Promise<ListCommentsResponse>;
+    /**
+     * Get a single comment by ID.
+     *
+     * @param params - Get parameters
+     * @returns The comment if found
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    get(params: GetCommentParams): Promise<DocumentComment>;
+    /**
+     * Update a comment's content.
+     *
+     * @param params - Update parameters
+     * @returns The updated comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    update(params: UpdateCommentParams): Promise<DocumentComment>;
+    /**
+     * Resolve a comment.
+     *
+     * @param params - Resolve parameters
+     * @returns The resolved comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    resolve(params: ResolveCommentParams): Promise<DocumentComment>;
+    /**
+     * Reopen a resolved comment.
+     *
+     * @param params - Reopen parameters (same as resolve but clears resolution)
+     * @returns The reopened comment
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    reopen(params: GetCommentParams): Promise<DocumentComment>;
+    /**
+     * Delete a comment.
+     *
+     * @param params - Delete parameters
+     * @throws {DocumentNotFoundError} If comment not found
+     */
+    delete(params: DeleteCommentParams): Promise<void>;
+    /**
+     * Get replies to a comment.
+     *
+     * @param params - Get parameters (documentId and parentId)
+     * @returns List of reply comments
+     */
+    getReplies(params: GetCommentParams): Promise<ListCommentsResponse>;
+}
+/**
+ * Get the CommentService singleton instance.
+ *
+ * @returns CommentService instance
+ */
+export declare function getCommentService(): CommentService;
+//# sourceMappingURL=comment.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comment.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/comment.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAKjF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,OAAO,CAAC,EAAE,CAA6C;gBAE3C,IAAI,GAAE,kBAAuB;IAMzC;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6DnE;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqCrE;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkB7D;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDnE;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyCrE;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoChE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAoB1E;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAclD"}