captify 0.1.18 → 1.1.0

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

@@ -0,0 +1,441 @@
+/**
+ * CollaborationService - Document CRUD operations
+ *
+ * Handles document creation, retrieval, updates, and deletion with
+ * dual-layer permission model (system-level Casbin + document-level).
+ */
+import { randomUUID } from "crypto";
+import * as Y from "yjs";
+import { TABLES } from "../../shared/shared.constants";
+import { collabDocumentKeys } from "../../db/schemas";
+import { collabDocumentSchema } from "../collaboration.schemas";
+import { AccessDeniedError, CollaborationError, DocumentNotFoundError, } from "../collaboration.errors";
+import { COLLABORATION_DEFAULTS, COLLABORATION_LIMITS, } from "../collaboration.constants";
+import { generatePreviewSnippet, countWords, extractPlainText, } from "../collaboration.utilities";
+import { getCollaboratorService } from "./collaborator.service";
+import { DynamoDbInstances } from "../../shared/services/dynamodb";
+import { LoggerFactory } from "../../shared/services/logger";
+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 class CollaborationService extends BaseAwsService {
+    constructor(deps = {}) {
+        var _a;
+        super({ logger: deps.logger });
+        this.db =
+            (_a = deps.db) !== null && _a !== void 0 ? _a : DynamoDbInstances.getInstance(TABLES.collabDocuments);
+    }
+    /**
+     * Create a new collaborative document.
+     *
+     * @param params - Document creation parameters
+     * @returns The created document
+     */
+    async create(params) {
+        const { tenantId, title, ownerId, ownerName, ownerEmail, content, userCredentials } = params;
+        const documentId = randomUUID();
+        const now = Date.now();
+        // Initialize empty yjs document if no content provided
+        let documentContent;
+        let wordCount = 0;
+        let previewSnippet;
+        if (content) {
+            // Cast to ArrayBuffer type - Uint8Array from yjs uses regular ArrayBuffer
+            documentContent = content;
+            const plainText = extractPlainText(content);
+            wordCount = countWords(plainText);
+            previewSnippet = generatePreviewSnippet(plainText, COLLABORATION_LIMITS.MAX_PREVIEW_SNIPPET_LENGTH);
+        }
+        else {
+            // Create empty yjs document
+            const ydoc = new Y.Doc();
+            // Cast to ArrayBuffer type - yjs always uses regular ArrayBuffer internally
+            documentContent = Y.encodeStateAsUpdate(ydoc);
+        }
+        const document = {
+            id: documentId,
+            tenantId,
+            title,
+            content: documentContent,
+            wordCount,
+            previewSnippet,
+            ownerId,
+            ownerName,
+            ownerEmail,
+            status: COLLABORATION_DEFAULTS.STATUS,
+            createdAt: now,
+            updatedAt: now,
+            createdById: ownerId,
+            modifiedById: ownerId,
+        };
+        // Validate before persisting
+        collabDocumentSchema.parse(document);
+        const item = Object.assign({ PK: collabDocumentKeys.pk(tenantId), SK: collabDocumentKeys.sk(documentId), GSI1_PK: collabDocumentKeys.gsi1Pk(ownerId), GSI1_SK: collabDocumentKeys.gsi1Sk(documentId) }, document);
+        await this.db.putItem(item, { userCredentials });
+        this.logger.info("Document created", {
+            tenantId,
+            documentId,
+            ownerId,
+            title,
+        });
+        return document;
+    }
+    /**
+     * Get a document by ID.
+     *
+     * @param params - Get document parameters
+     * @returns The document
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     */
+    async get(params) {
+        const { tenantId, documentId, userCredentials } = params;
+        const { Item } = await this.db.getItem({
+            PK: collabDocumentKeys.pk(tenantId),
+            SK: collabDocumentKeys.sk(documentId),
+        }, { userCredentials });
+        if (!Item) {
+            throw new DocumentNotFoundError(documentId);
+        }
+        const parseResult = collabDocumentSchema.safeParse(Item);
+        if (!parseResult.success) {
+            this.logger.warn("Invalid document in database", {
+                tenantId,
+                documentId,
+                errors: parseResult.error.issues,
+            });
+            throw new CollaborationError("Document data is corrupted", "DOCUMENT_CORRUPTED", 500);
+        }
+        return parseResult.data;
+    }
+    /**
+     * List documents for a user.
+     * Returns documents where user is owner or collaborator.
+     *
+     * @param params - List parameters
+     * @returns List of documents with pagination
+     */
+    async list(params) {
+        var _a;
+        const { tenantId, userId, filter = "all", search, limit = COLLABORATION_LIMITS.DEFAULT_PAGE_SIZE, nextToken, userCredentials, } = params;
+        // Execute queries in parallel for better performance
+        const collaboratorService = getCollaboratorService();
+        const [result, { documentIds: sharedDocumentIds }] = await Promise.all([
+            // Query all documents in tenant
+            this.db.queryItems({
+                KeyConditionExpression: "PK = :pk AND begins_with(SK, :skPrefix)",
+                ExpressionAttributeValues: {
+                    ":pk": collabDocumentKeys.pk(tenantId),
+                    ":skPrefix": "COLLAB_DOC#",
+                },
+                ExclusiveStartKey: nextToken
+                    ? JSON.parse(Buffer.from(nextToken, "base64").toString())
+                    : undefined,
+            }, { userCredentials }),
+            // Get document IDs where user is a collaborator (parallel)
+            collaboratorService.listSharedDocuments({
+                userId,
+                userCredentials,
+            }),
+        ]);
+        const items = (_a = result.Items) !== null && _a !== void 0 ? _a : [];
+        // Parse all tenant documents
+        const allTenantDocuments = items
+            .map((item) => {
+            const parseResult = collabDocumentSchema.safeParse(item);
+            return parseResult.success ? parseResult.data : null;
+        })
+            .filter((doc) => doc !== null);
+        // Optimization: Filter shared documents from already-fetched tenant documents
+        // This avoids additional queries since we already have all tenant documents
+        const sharedDocumentIdsSet = new Set(sharedDocumentIds);
+        const sharedDocuments = allTenantDocuments.filter((doc) => sharedDocumentIdsSet.has(doc.id) && doc.ownerId !== userId);
+        // Get owned documents from tenant query
+        const ownedDocuments = allTenantDocuments.filter((d) => d.ownerId === userId);
+        // Apply filter
+        let documents;
+        switch (filter) {
+            case "my-documents":
+                // Only documents owned by user
+                documents = ownedDocuments.filter((d) => d.status === "active");
+                break;
+            case "shared-with-me":
+                // Only documents shared with user (not owned)
+                documents = sharedDocuments.filter((d) => d.status === "active");
+                break;
+            case "trashed":
+                // Only trashed documents owned by user
+                documents = ownedDocuments.filter((d) => d.status === "trashed");
+                break;
+            case "recent": {
+                // Recent documents (owned + shared) - last 7 days
+                const oneWeekAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
+                documents = [...ownedDocuments, ...sharedDocuments].filter((d) => d.status === "active" && d.updatedAt >= oneWeekAgo);
+                break;
+            }
+            case "all":
+            default:
+                // All active documents (owned + shared)
+                documents = [...ownedDocuments, ...sharedDocuments].filter((d) => d.status === "active");
+                break;
+        }
+        // Apply search filter
+        if (search) {
+            const searchLower = search.toLowerCase();
+            documents = documents.filter((d) => {
+                var _a;
+                return d.title.toLowerCase().includes(searchLower) ||
+                    ((_a = d.previewSnippet) === null || _a === void 0 ? void 0 : _a.toLowerCase().includes(searchLower));
+            });
+        }
+        // Sort by updatedAt descending
+        documents.sort((a, b) => b.updatedAt - a.updatedAt);
+        // Apply limit
+        const limitedDocs = documents.slice(0, limit);
+        // Generate next token only if:
+        // 1. DynamoDB has more results (LastEvaluatedKey exists), AND
+        // 2. We have more filtered documents than the limit (indicates there's more to fetch)
+        const hasMoreFilteredResults = documents.length > limit;
+        const resultNextToken = result.LastEvaluatedKey && hasMoreFilteredResults
+            ? Buffer.from(JSON.stringify(result.LastEvaluatedKey)).toString("base64")
+            : undefined;
+        return {
+            documents: limitedDocs,
+            nextToken: resultNextToken,
+            total: documents.length,
+        };
+    }
+    /**
+     * 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
+     */
+    async update(params) {
+        var _a, _b, _c, _d;
+        const { tenantId, documentId, userId, updates, userCredentials } = params;
+        // Parallel execution: Get document and check permissions simultaneously
+        const collaboratorService = getCollaboratorService();
+        const [existing, permission] = await Promise.all([
+            this.get({ tenantId, documentId, userId, userCredentials }),
+            // Only check collaborator permission if needed (avoid query if user is owner)
+            // We'll validate permission after we know if they're the owner
+            collaboratorService.getPermissionLevel({ documentId, userId, userCredentials }),
+        ]);
+        // Check permission - owner or collaborator with edit/admin permission
+        if (existing.ownerId !== userId) {
+            // User is not owner, check collaborator permission
+            if (!permission || permission === "view") {
+                throw new AccessDeniedError(userId, documentId, "update");
+            }
+        }
+        // If user is owner, they always have permission (permission query was unnecessary but parallel)
+        const now = Date.now();
+        // Build update expression
+        const updateBuilder = this.db.createUpdateBuilder();
+        updateBuilder.set("updatedAt", now);
+        updateBuilder.set("modifiedById", userId);
+        if (updates.title !== undefined) {
+            updateBuilder.set("title", updates.title);
+        }
+        if (updates.content !== undefined) {
+            updateBuilder.set("content", new Uint8Array(updates.content));
+            // Update derived fields
+            const plainText = extractPlainText(updates.content);
+            updateBuilder.set("wordCount", (_a = updates.wordCount) !== null && _a !== void 0 ? _a : countWords(plainText));
+            updateBuilder.set("previewSnippet", (_b = updates.previewSnippet) !== null && _b !== void 0 ? _b : generatePreviewSnippet(plainText, COLLABORATION_LIMITS.MAX_PREVIEW_SNIPPET_LENGTH));
+        }
+        if (updates.contentVector !== undefined) {
+            updateBuilder.set("contentVector", new Uint8Array(updates.contentVector));
+        }
+        const expression = updateBuilder.build();
+        await this.db.updateItem({
+            PK: collabDocumentKeys.pk(tenantId),
+            SK: collabDocumentKeys.sk(documentId),
+        }, expression.UpdateExpression, expression.ExpressionAttributeNames, expression.ExpressionAttributeValues, { userCredentials });
+        this.logger.info("Document updated", {
+            tenantId,
+            documentId,
+            userId,
+            updatedFields: Object.keys(updates),
+        });
+        // Construct and return the updated document without an additional fetch
+        // This avoids a redundant DynamoDB query since we know all the changes
+        const updatedDocument = Object.assign(Object.assign({}, existing), { updatedAt: now, modifiedById: userId });
+        if (updates.title !== undefined) {
+            updatedDocument.title = updates.title;
+        }
+        if (updates.content !== undefined) {
+            updatedDocument.content = new Uint8Array(updates.content);
+            const plainText = extractPlainText(updates.content);
+            updatedDocument.wordCount = (_c = updates.wordCount) !== null && _c !== void 0 ? _c : countWords(plainText);
+            updatedDocument.previewSnippet =
+                (_d = updates.previewSnippet) !== null && _d !== void 0 ? _d : generatePreviewSnippet(plainText, COLLABORATION_LIMITS.MAX_PREVIEW_SNIPPET_LENGTH);
+        }
+        if (updates.contentVector !== undefined) {
+            updatedDocument.contentVector = new Uint8Array(updates.contentVector);
+        }
+        return updatedDocument;
+    }
+    /**
+     * 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
+     */
+    async delete(params) {
+        const { tenantId, documentId, userId, userCredentials } = params;
+        // Get existing document
+        const existing = await this.get({ tenantId, documentId, userId, userCredentials });
+        // Check ownership
+        if (existing.ownerId !== userId) {
+            throw new AccessDeniedError(userId, documentId, "delete");
+        }
+        const now = Date.now();
+        const expression = this.db
+            .createUpdateBuilder()
+            .set("status", "trashed")
+            .set("trashedAt", now)
+            .set("updatedAt", now)
+            .set("modifiedById", userId)
+            .build();
+        // Add condition to prevent concurrent deletes (only trash if currently active)
+        await this.db.updateItem({
+            PK: collabDocumentKeys.pk(tenantId),
+            SK: collabDocumentKeys.sk(documentId),
+        }, expression.UpdateExpression, expression.ExpressionAttributeNames, Object.assign(Object.assign({}, expression.ExpressionAttributeValues), { ":activeStatus": "active" }), {
+            userCredentials,
+            conditionExpression: "#status = :activeStatus",
+        });
+        this.logger.info("Document trashed", {
+            tenantId,
+            documentId,
+            userId,
+        });
+    }
+    /**
+     * Restore a trashed document.
+     *
+     * @param params - Restore parameters
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have permission
+     */
+    async restore(params) {
+        const { tenantId, documentId, userId, userCredentials } = params;
+        // Get existing document
+        const existing = await this.get({ tenantId, documentId, userId, userCredentials });
+        // Check ownership
+        if (existing.ownerId !== userId) {
+            throw new AccessDeniedError(userId, documentId, "restore");
+        }
+        if (existing.status !== "trashed") {
+            throw new CollaborationError("Document is not in trash", "DOCUMENT_NOT_TRASHED", 400);
+        }
+        const now = Date.now();
+        const expression = this.db
+            .createUpdateBuilder()
+            .set("status", "active")
+            .set("updatedAt", now)
+            .set("modifiedById", userId)
+            .remove("trashedAt")
+            .build();
+        // Add condition to prevent concurrent restores (only restore if currently trashed)
+        await this.db.updateItem({
+            PK: collabDocumentKeys.pk(tenantId),
+            SK: collabDocumentKeys.sk(documentId),
+        }, expression.UpdateExpression, expression.ExpressionAttributeNames, Object.assign(Object.assign({}, expression.ExpressionAttributeValues), { ":trashedStatus": "trashed" }), {
+            userCredentials,
+            conditionExpression: "#status = :trashedStatus",
+        });
+        this.logger.info("Document restored", {
+            tenantId,
+            documentId,
+            userId,
+        });
+    }
+    /**
+     * Permanently delete a document.
+     *
+     * @param params - Delete parameters
+     * @throws {DocumentNotFoundError} If document doesn't exist
+     * @throws {AccessDeniedError} If user doesn't have permission
+     */
+    async permanentDelete(params) {
+        const { tenantId, documentId, userId, userCredentials } = params;
+        // Get existing document
+        const existing = await this.get({ tenantId, documentId, userId, userCredentials });
+        // Check ownership
+        if (existing.ownerId !== userId) {
+            throw new AccessDeniedError(userId, documentId, "delete");
+        }
+        // Can only permanently delete trashed documents
+        if (existing.status !== "trashed") {
+            throw new CollaborationError("Document must be trashed before permanent deletion", "DOCUMENT_NOT_TRASHED", 400);
+        }
+        await this.db.deleteItem({
+            PK: collabDocumentKeys.pk(tenantId),
+            SK: collabDocumentKeys.sk(documentId),
+        }, { userCredentials });
+        this.logger.info("Document permanently deleted", {
+            tenantId,
+            documentId,
+            userId,
+        });
+    }
+}
+/**
+ * Lazy-initialized singleton instance of CollaborationService.
+ */
+let collaborationServiceInstance = null;
+/**
+ * Get the singleton CollaborationService instance.
+ *
+ * @returns CollaborationService instance
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaborationService();
+ * await service.create({ ... });
+ * ```
+ */
+export function getCollaborationService() {
+    if (!collaborationServiceInstance) {
+        collaborationServiceInstance = new CollaborationService({
+            logger: LoggerFactory.createLogger({
+                serviceName: "CollaborationService",
+                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 collaborationServiceInstance;
+}
+//# sourceMappingURL=collaboration.service.js.map

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

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

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

@@ -0,0 +1,118 @@
+/**
+ * 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 type { AddCollaboratorParams, CollaboratorServiceDeps, GetCollaboratorParams, ListCollaboratorsParams, ListCollaboratorsResponse, ListSharedDocumentsParams, ListSharedDocumentsResponse, RemoveCollaboratorParams, UpdateCollaboratorParams } from "../collaboration.interfaces";
+import type { DocumentCollaborator } from "../collaboration.schemas";
+import type { PermissionLevel } from "../collaboration.constants";
+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 declare class CollaboratorService extends BaseAwsService {
+    private db;
+    constructor(deps?: CollaboratorServiceDeps);
+    /**
+     * Add a collaborator to a document.
+     *
+     * @param params - Collaborator details
+     * @returns The created collaborator record
+     * @throws {CollaboratorExistsError} If user is already a collaborator
+     */
+    add(params: AddCollaboratorParams): Promise<DocumentCollaborator>;
+    /**
+     * Get a collaborator by document and user ID.
+     *
+     * @param params - Get parameters
+     * @returns The collaborator record
+     * @throws {CollaboratorNotFoundError} If collaborator doesn't exist
+     */
+    get(params: GetCollaboratorParams): Promise<DocumentCollaborator>;
+    /**
+     * Get a collaborator by document and user ID, returning null if not found.
+     *
+     * @param params - Get parameters
+     * @returns The collaborator record or null
+     */
+    private getOptional;
+    /**
+     * List all collaborators for a document.
+     *
+     * @param params - List parameters
+     * @returns List of collaborators
+     */
+    list(params: ListCollaboratorsParams): Promise<ListCollaboratorsResponse>;
+    /**
+     * List document IDs shared with a user.
+     * Uses GSI1 to query by userId.
+     *
+     * @param params - List parameters
+     * @returns List of document IDs
+     */
+    listSharedDocuments(params: ListSharedDocumentsParams): Promise<ListSharedDocumentsResponse>;
+    /**
+     * Update a collaborator's permission level.
+     *
+     * @param params - Update parameters
+     * @throws {CollaboratorNotFoundError} If collaborator doesn't exist
+     * @throws {CannotDemoteLastAdminError} If demoting the last admin
+     */
+    update(params: UpdateCollaboratorParams): Promise<void>;
+    /**
+     * 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
+     */
+    remove(params: RemoveCollaboratorParams): Promise<void>;
+    /**
+     * Check if a user is the document owner.
+     *
+     * @param params - Get parameters
+     * @returns True if user is the owner
+     */
+    isOwner(params: GetCollaboratorParams): Promise<boolean>;
+    /**
+     * Get a user's permission level for a document.
+     *
+     * @param params - Get parameters
+     * @returns The permission level or null if not a collaborator
+     */
+    getPermissionLevel(params: GetCollaboratorParams): Promise<PermissionLevel | null>;
+}
+/**
+ * Get the singleton CollaboratorService instance.
+ *
+ * @returns CollaboratorService instance
+ *
+ * @example
+ * ```typescript
+ * const service = getCollaboratorService();
+ * await service.add({ ... });
+ * ```
+ */
+export declare function getCollaboratorService(): CollaboratorService;
+//# sourceMappingURL=collaborator.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collaborator.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/collaborator.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAWnF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,OAAO,CAAC,EAAE,CAAkD;gBAEhD,IAAI,GAAE,uBAA4B;IAO9C;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiEvE;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQvE;;;;;OAKG;YACW,WAAW;IA4BzB;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA0B/E;;;;;;OAMG;IACG,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,2BAA2B,CAAC;IA0BvC;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D7D;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7D;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9D;;;;;OAKG;IACG,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAIzF;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAmB5D"}