captify 0.1.18 → 1.1.0

package/dist/comments/api/comments-ai.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments-ai.handlers.d.ts","sourceRoot":"","sources":["../../../lib/comments/api/comments-ai.handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAM5C;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,uBAA4B;;;;;;;;;;;;;;;EA2D5E"}

package/dist/comments/api/comments-ai.handlers.js

@@ -0,0 +1,65 @@
+import { NextResponse } from "next/server";
+import { aiReplyBodySchema, summaryBodySchema } from "../comments.schemas";
+import { getCommentsAiService } from "../services";
+import { ServiceError } from "../../shared/services";
+import { getUserAwsCredentials, withAuth } from "../../shared/utilities/api";
+/**
+ * Creates AI reply handlers with optional server-side entity context fetcher.
+ *
+ * @security Entity context is fetched server-side to prevent prompt injection attacks.
+ * @security All business logic is in CommentsAiService - handler only validates and delegates.
+ *
+ * @param config - Configuration including optional entity context fetcher
+ * @returns Handler functions for AI reply endpoints
+ */
+export function createCommentsAiHandlers(config = {}) {
+    /**
+     * POST /api/comments/ai-reply - Streams AI response to a comment mentioning @askcaptify.
+     */
+    const streamAiReply = withAuth(async (request, { idToken, tenantId }) => {
+        try {
+            const userCredentials = await getUserAwsCredentials(idToken);
+            const body = aiReplyBodySchema.parse(await request.json());
+            const response = await getCommentsAiService().handleAiReply({
+                tenantId,
+                entityId: body.entityId,
+                entityType: body.entityType,
+                triggerCommentId: body.triggerCommentId,
+            }, { userCredentials, entityContextFetcher: config.entityContextFetcher });
+            return new NextResponse(response.body, {
+                status: response.status,
+                headers: response.headers,
+            });
+        }
+        catch (err) {
+            const status = err instanceof ServiceError ? err.statusCode : 500;
+            const message = err instanceof Error ? err.message : "Failed to generate AI response";
+            return NextResponse.json({ error: message }, { status });
+        }
+    });
+    /**
+     * POST /api/comments/summary - Streams AI-generated summary of all comments.
+     */
+    const streamSummary = withAuth(async (request, { idToken, tenantId }) => {
+        try {
+            const userCredentials = await getUserAwsCredentials(idToken);
+            const body = summaryBodySchema.parse(await request.json());
+            const response = await getCommentsAiService().handleSummarize({
+                tenantId,
+                entityId: body.entityId,
+                entityType: body.entityType,
+            }, { userCredentials, entityContextFetcher: config.entityContextFetcher });
+            return new NextResponse(response.body, {
+                status: response.status,
+                headers: response.headers,
+            });
+        }
+        catch (err) {
+            const status = err instanceof ServiceError ? err.statusCode : 500;
+            const message = err instanceof Error ? err.message : "Failed to generate summary";
+            return NextResponse.json({ error: message }, { status });
+        }
+    });
+    return { streamAiReply, streamSummary };
+}
+//# sourceMappingURL=comments-ai.handlers.js.map

package/dist/comments/api/comments-ai.handlers.js.map

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

package/dist/comments/api/comments.client.d.ts

@@ -0,0 +1,106 @@
+import { Comment, CommentThread, CreateCommentRequest, ListCommentsRequest, ListRepliesRequest, UpdateCommentRequest } from "../comments.interfaces";
+/**
+ * Fetch threaded comments for an entity
+ *
+ * @param params - Query parameters for listing comments
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to comments and page count
+ *
+ * @example
+ * const { comments, count } = await fetchComments({
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   limit: 20,
+ * });
+ */
+export declare function fetchComments(params: ListCommentsRequest, endpoint?: string): Promise<{
+    comments: CommentThread[];
+    count: number;
+}>;
+/**
+ * Fetch replies to a specific comment
+ *
+ * @param parentId - ID of the parent comment
+ * @param params - Query parameters for listing replies
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to replies and pagination info
+ *
+ * @example
+ * const { comments, hasMore, nextCursor } = await fetchReplies('comment-123', {
+ *   limit: 10,
+ * });
+ */
+export declare function fetchReplies(parentId: string, params?: ListRepliesRequest, endpoint?: string): Promise<{
+    comments: Comment[];
+    nextCursor?: string;
+    hasMore: boolean;
+}>;
+/**
+ * Create a new comment
+ *
+ * @param data - Comment data to create
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the created comment
+ *
+ * @example
+ * const comment = await createCommentRequest({
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   content: 'This is a comment',
+ * });
+ */
+export declare function createCommentRequest(data: CreateCommentRequest, endpoint?: string): Promise<Comment>;
+/**
+ * Update an existing comment
+ *
+ * @param commentId - ID of the comment to update
+ * @param data - Updated comment data
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the updated comment
+ *
+ * @example
+ * const comment = await updateCommentRequest('comment-123', {
+ *   content: 'Updated content',
+ * });
+ */
+export declare function updateCommentRequest(commentId: string, data: UpdateCommentRequest, endpoint?: string): Promise<Comment>;
+/**
+ * Delete a comment
+ *
+ * @param commentId - ID of the comment to delete
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise that resolves when deletion is complete
+ *
+ * @example
+ * await deleteCommentRequest('comment-123');
+ */
+export declare function deleteCommentRequest(commentId: string, endpoint?: string): Promise<void>;
+/**
+ * Create a reply to an existing comment
+ *
+ * @param parentId - ID of the parent comment
+ * @param data - Reply data (entityId and entityType are still required)
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the created reply
+ *
+ * @example
+ * const reply = await createReplyRequest('parent-123', {
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   content: 'This is a reply',
+ * });
+ */
+export declare function createReplyRequest(parentId: string, data: Omit<CreateCommentRequest, "parentId">, endpoint?: string): Promise<Comment>;
+/**
+ * Delete an attachment from a comment
+ *
+ * @param commentId - ID of the comment containing the attachment
+ * @param attachmentId - ID of the attachment to delete
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the updated comment
+ *
+ * @example
+ * const updatedComment = await deleteAttachmentRequest('comment-123', 'attachment-456');
+ */
+export declare function deleteAttachmentRequest(commentId: string, attachmentId: string, endpoint?: string): Promise<Comment>;
+//# sourceMappingURL=comments.client.d.ts.map

package/dist/comments/api/comments.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.client.d.ts","sourceRoot":"","sources":["../../../lib/comments/api/comments.client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oCAAoC,CAAC;AAO5C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,SAAwB,GAC/B,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,kBAAuB,EAC/B,QAAQ,SAAwB,GAC/B,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAazE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,SAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,SAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,EAC5C,QAAQ,SAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/comments/api/comments.client.js

@@ -0,0 +1,151 @@
+import { COMMENTS_API_ENDPOINT } from "../comments.constants";
+import { fetchJson, fetchVoid } from "../../shared/utilities/fetch";
+/* ====================================================== */
+/* Client Functions                                       */
+/* ====================================================== */
+/**
+ * Fetch threaded comments for an entity
+ *
+ * @param params - Query parameters for listing comments
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to comments and page count
+ *
+ * @example
+ * const { comments, count } = await fetchComments({
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   limit: 20,
+ * });
+ */
+export async function fetchComments(params, endpoint = COMMENTS_API_ENDPOINT) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("entityId", params.entityId);
+    if (params.entityType)
+        searchParams.set("entityType", params.entityType);
+    if (params.limit)
+        searchParams.set("limit", params.limit.toString());
+    if (params.sortOrder)
+        searchParams.set("sortOrder", params.sortOrder);
+    if (params.cursor)
+        searchParams.set("cursor", params.cursor);
+    if (params.rootOnly !== undefined)
+        searchParams.set("rootOnly", params.rootOnly.toString());
+    return fetchJson(`${endpoint}?${searchParams}`);
+}
+/**
+ * Fetch replies to a specific comment
+ *
+ * @param parentId - ID of the parent comment
+ * @param params - Query parameters for listing replies
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to replies and pagination info
+ *
+ * @example
+ * const { comments, hasMore, nextCursor } = await fetchReplies('comment-123', {
+ *   limit: 10,
+ * });
+ */
+export async function fetchReplies(parentId, params = {}, endpoint = COMMENTS_API_ENDPOINT) {
+    const searchParams = new URLSearchParams();
+    if (params.limit)
+        searchParams.set("limit", params.limit.toString());
+    if (params.sortOrder)
+        searchParams.set("sortOrder", params.sortOrder);
+    if (params.cursor)
+        searchParams.set("cursor", params.cursor);
+    const url = searchParams.toString().length > 0
+        ? `${endpoint}/${parentId}/replies?${searchParams}`
+        : `${endpoint}/${parentId}/replies`;
+    return fetchJson(url);
+}
+/**
+ * Create a new comment
+ *
+ * @param data - Comment data to create
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the created comment
+ *
+ * @example
+ * const comment = await createCommentRequest({
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   content: 'This is a comment',
+ * });
+ */
+export async function createCommentRequest(data, endpoint = COMMENTS_API_ENDPOINT) {
+    return fetchJson(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(data),
+    });
+}
+/**
+ * Update an existing comment
+ *
+ * @param commentId - ID of the comment to update
+ * @param data - Updated comment data
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the updated comment
+ *
+ * @example
+ * const comment = await updateCommentRequest('comment-123', {
+ *   content: 'Updated content',
+ * });
+ */
+export async function updateCommentRequest(commentId, data, endpoint = COMMENTS_API_ENDPOINT) {
+    return fetchJson(`${endpoint}/${commentId}`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(data),
+    });
+}
+/**
+ * Delete a comment
+ *
+ * @param commentId - ID of the comment to delete
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise that resolves when deletion is complete
+ *
+ * @example
+ * await deleteCommentRequest('comment-123');
+ */
+export async function deleteCommentRequest(commentId, endpoint = COMMENTS_API_ENDPOINT) {
+    await fetchVoid(`${endpoint}/${commentId}`, {
+        method: "DELETE",
+    });
+}
+/**
+ * Create a reply to an existing comment
+ *
+ * @param parentId - ID of the parent comment
+ * @param data - Reply data (entityId and entityType are still required)
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the created reply
+ *
+ * @example
+ * const reply = await createReplyRequest('parent-123', {
+ *   entityId: 'doc-123',
+ *   entityType: 'document',
+ *   content: 'This is a reply',
+ * });
+ */
+export async function createReplyRequest(parentId, data, endpoint = COMMENTS_API_ENDPOINT) {
+    return createCommentRequest(Object.assign(Object.assign({}, data), { parentId }), endpoint);
+}
+/**
+ * Delete an attachment from a comment
+ *
+ * @param commentId - ID of the comment containing the attachment
+ * @param attachmentId - ID of the attachment to delete
+ * @param endpoint - API endpoint (defaults to /api/comments)
+ * @returns Promise resolving to the updated comment
+ *
+ * @example
+ * const updatedComment = await deleteAttachmentRequest('comment-123', 'attachment-456');
+ */
+export async function deleteAttachmentRequest(commentId, attachmentId, endpoint = COMMENTS_API_ENDPOINT) {
+    return fetchJson(`${endpoint}/${commentId}/attachments/${attachmentId}`, {
+        method: "DELETE",
+    });
+}
+//# sourceMappingURL=comments.client.js.map

package/dist/comments/api/comments.client.js.map

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

package/dist/comments/api/comments.handlers.d.ts

@@ -0,0 +1,207 @@
+import type { ListCommentsResponse, PaginatedCommentsResponse } from "../comments.interfaces";
+/**
+ * GET /api/comments
+ *
+ * Lists threaded comments for an entity from DynamoDB with pagination support.
+ *
+ * Query parameters:
+ * - entityId: ID of the entity (required)
+ * - entityType: Type of entity (optional, defaults to "document")
+ * - limit: Number of comments to return (optional, defaults to 20)
+ * - sortOrder: Sort order "asc" or "desc" (optional, defaults to "desc")
+ * - cursor: Pagination cursor for next page (optional)
+ * - rootOnly: Only return root comments (optional)
+ *
+ * @returns Object containing:
+ *   - comments: Array of CommentThread objects with nested replies
+ *   - count: Number of comments on current page
+ *   - nextCursor: Pagination cursor for next page
+ *   - hasMore: Whether there are more comments
+ *
+ * @example
+ * GET /api/comments?entityId=doc-123&entityType=document&limit=20
+ */
+export declare const listComments: (request: import("next/server").NextRequest, context: {
+    params: Promise<Record<string, unknown>>;
+}) => Promise<import("next/server").NextResponse<ListCommentsResponse | {
+    error: string;
+}>>;
+/**
+ * POST /api/comments
+ *
+ * Creates a new comment for an entity.
+ *
+ * Request body:
+ * - entityId: ID of the entity to comment on (required)
+ * - entityType: Type of entity (required)
+ * - content: Comment text content (required)
+ * - parentId: Parent comment ID for replies (optional)
+ * - mentions: Array of user IDs mentioned (optional)
+ *
+ * @returns The created comment object
+ *
+ * @example
+ * POST /api/comments
+ * Body: {
+ *   "entityId": "doc-123",
+ *   "entityType": "document",
+ *   "content": "This is a comment"
+ * }
+ */
+export declare const createComment: (request: import("next/server").NextRequest, context: {
+    params: Promise<Record<string, unknown>>;
+}) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+    error: string;
+}>>;
+/**
+ * GET /api/comments/:id/replies
+ *
+ * Lists replies to a specific comment.
+ *
+ * URL parameters:
+ * - id: Parent comment ID (required)
+ *
+ * Query parameters:
+ * - limit: Number of replies to return (optional, defaults to 10)
+ * - sortOrder: Sort order "asc" or "desc" (optional, defaults to "asc")
+ * - cursor: Pagination cursor (optional)
+ *
+ * @returns Object containing:
+ *   - comments: Array of reply comments
+ *   - nextCursor: Pagination token for next page
+ *   - hasMore: Whether there are more replies
+ *
+ * @example
+ * GET /api/comments/comment-123/replies?limit=10
+ */
+export declare const listReplies: (request: import("next/server").NextRequest, context: {
+    params: Promise<{
+        id: string;
+    }>;
+}) => Promise<import("next/server").NextResponse<PaginatedCommentsResponse | {
+    error: string;
+}>>;
+/**
+ * PUT/PATCH /api/comments/:id
+ *
+ * Updates an existing comment's content.
+ * Only the comment author can update it.
+ *
+ * URL parameters:
+ * - id: Comment ID (required)
+ *
+ * Request body:
+ * - content: New comment content (required)
+ * - mentions: Updated list of mentioned user IDs (optional)
+ *
+ * @returns The updated comment object
+ *
+ * @throws 404 if comment doesn't exist
+ * @throws 403 if user is not the comment author
+ *
+ * @example
+ * PUT /api/comments/comment-123
+ * Body: { "content": "Updated comment text" }
+ */
+export declare const updateComment: (request: import("next/server").NextRequest, context: {
+    params: Promise<{
+        id: string;
+    }>;
+}) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+    error: string;
+}>>;
+/**
+ * DELETE /api/comments/:id
+ *
+ * Deletes a comment (soft delete).
+ * Only the comment author or admins can delete it.
+ *
+ * URL parameters:
+ * - id: Comment ID (required)
+ *
+ * @returns null on successful deletion (204 No Content)
+ *
+ * @throws 404 if comment doesn't exist
+ * @throws 403 if user is not authorized to delete
+ *
+ * @example
+ * DELETE /api/comments/comment-123
+ */
+export declare const deleteComment: (request: import("next/server").NextRequest, context: {
+    params: Promise<{
+        id: string;
+    }>;
+}) => Promise<import("next/server").NextResponse<{
+    error: string;
+} | null>>;
+/**
+ * DELETE /api/comments/:id/attachments/:attachmentId
+ *
+ * Deletes an attachment from a comment.
+ * Only the comment author can delete attachments.
+ *
+ * URL parameters:
+ * - id: Comment ID (required)
+ * - attachmentId: Attachment ID (required)
+ *
+ * @returns The updated comment object
+ *
+ * @throws 404 if comment or attachment doesn't exist
+ * @throws 403 if user is not the comment author
+ *
+ * @example
+ * DELETE /api/comments/comment-123/attachments/attachment-456
+ */
+export declare const deleteAttachment: (request: import("next/server").NextRequest, context: {
+    params: Promise<{
+        id: string;
+        attachmentId: string;
+    }>;
+}) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+    error: string;
+}>>;
+/**
+ * Semantic grouped handlers for comments
+ */
+export declare const commentHandlers: {
+    list: (request: import("next/server").NextRequest, context: {
+        params: Promise<Record<string, unknown>>;
+    }) => Promise<import("next/server").NextResponse<ListCommentsResponse | {
+        error: string;
+    }>>;
+    create: (request: import("next/server").NextRequest, context: {
+        params: Promise<Record<string, unknown>>;
+    }) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+        error: string;
+    }>>;
+    listReplies: (request: import("next/server").NextRequest, context: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<import("next/server").NextResponse<PaginatedCommentsResponse | {
+        error: string;
+    }>>;
+    update: (request: import("next/server").NextRequest, context: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+        error: string;
+    }>>;
+    delete: (request: import("next/server").NextRequest, context: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<import("next/server").NextResponse<{
+        error: string;
+    } | null>>;
+    deleteAttachment: (request: import("next/server").NextRequest, context: {
+        params: Promise<{
+            id: string;
+            attachmentId: string;
+        }>;
+    }) => Promise<import("next/server").NextResponse<import("../comments.interfaces").Comment | {
+        error: string;
+    }>>;
+};
+//# sourceMappingURL=comments.handlers.d.ts.map

package/dist/comments/api/comments.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.handlers.d.ts","sourceRoot":"","sources":["../../../lib/comments/api/comments.handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAU5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY;;;;GAiCxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa;;;;GAqBzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,WAAW;;YACqD,MAAM;;;;GAyBlF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa;;YACyD,MAAM;;;;GAkBxF,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;YACmD,MAAM;;;;UAmBlF,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;;YAIW,MAAM;sBAAgB,MAAM;;;;GAgBnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;gBAxJiD,MAAM;;;;;;;gBAkDA,MAAM;;;;;;;gBAsCZ,MAAM;;;;;;;gBA2C3C,MAAM;0BAAgB,MAAM;;;;;CA4BnE,CAAC"}