captify 0.1.18 → 1.1.0

package/dist/collaboration/collaboration.schemas.js

@@ -0,0 +1,353 @@
+/**
+ * Collaboration Documents Schemas - Single source of truth for all validation
+ *
+ * This file contains all Zod schemas for collaboration operations, used by:
+ * - Service layer (CRUD operations)
+ * - API layer (request body validation)
+ * - Client/Form layer (form validation)
+ *
+ * Schema Hierarchy:
+ * 1. Enums and primitives
+ * 2. Base fields (reusable field definitions)
+ * 3. Entity schemas
+ * 4. CRUD schemas (service layer)
+ * 5. API body schemas (derived from CRUD schemas)
+ */
+import { AI_CONTEXT_MODES, COLLABORATION_ERROR_MESSAGES, COLLABORATION_LIMITS, COLLAB_DOC_STATUSES, COMMENT_STATUSES, DOCUMENT_FILTERS, PERMISSION_LEVELS, SNAPSHOT_TYPES, } from "./collaboration.constants";
+import { userIdSchema } from "../shared/services/services.schemas";
+import { baseEntitySchema, tenantIdSchema } from "../shared/shared.schemas";
+import { z } from "zod";
+// ============================================================================
+// Binary Data Schema
+// ============================================================================
+/**
+ * Flexible binary data schema that accepts Uint8Array, Buffer, or array-like binary data.
+ * DynamoDB may return binary data in different formats depending on the SDK version.
+ */
+const binarySchema = z
+    .custom((val) => {
+    // Accept Uint8Array directly
+    if (val instanceof Uint8Array)
+        return true;
+    // Accept Node.js Buffer (which extends Uint8Array)
+    if (Buffer.isBuffer(val))
+        return true;
+    // Accept array-like objects that could be binary data
+    if (val &&
+        typeof val === "object" &&
+        "length" in val &&
+        typeof val.length === "number") {
+        return true;
+    }
+    return false;
+}, { message: COLLABORATION_ERROR_MESSAGES.INVALID_CONTENT })
+    .transform((val) => {
+    // Ensure we always return a proper Uint8Array
+    if (val instanceof Uint8Array)
+        return val;
+    if (Buffer.isBuffer(val))
+        return new Uint8Array(val);
+    // Convert array-like to Uint8Array
+    return new Uint8Array(val);
+});
+// ============================================================================
+// Primitive Schemas
+// ============================================================================
+/** Document ID (UUID format) */
+export const documentIdSchema = z.uuid({
+    message: COLLABORATION_ERROR_MESSAGES.DOCUMENT_ID_INVALID_FORMAT,
+});
+/** Comment ID (UUID format) */
+export const commentIdSchema = z.uuid({ message: "Comment ID must be a valid UUID" });
+// ============================================================================
+// Enum Schemas
+// ============================================================================
+/** Document status enum */
+export const collabDocStatusSchema = z.enum(COLLAB_DOC_STATUSES);
+/** Permission level enum */
+export const permissionLevelSchema = z.enum(PERMISSION_LEVELS);
+/** Comment status enum */
+export const commentStatusSchema = z.enum(COMMENT_STATUSES);
+/** Snapshot type enum */
+export const snapshotTypeSchema = z.enum(SNAPSHOT_TYPES);
+/** AI context mode enum */
+export const aiContextModeSchema = z.enum(AI_CONTEXT_MODES);
+/** Document filter enum */
+export const documentFilterSchema = z.enum(DOCUMENT_FILTERS);
+// ============================================================================
+// Base Field Schemas
+// ============================================================================
+/**
+ * Base document field schemas with full validation.
+ * These are the building blocks for all other schemas.
+ */
+export const collabDocFields = {
+    title: z
+        .string()
+        .trim()
+        .min(1, COLLABORATION_ERROR_MESSAGES.TITLE_REQUIRED)
+        .max(COLLABORATION_LIMITS.MAX_TITLE_LENGTH, COLLABORATION_ERROR_MESSAGES.TITLE_TOO_LONG),
+    content: binarySchema,
+    contentVector: binarySchema.optional(),
+    contentS3Key: z.string().optional(),
+    wordCount: z.number().int().min(0),
+    previewSnippet: z.string().max(COLLABORATION_LIMITS.MAX_PREVIEW_SNIPPET_LENGTH).optional(),
+    ownerId: z.string().trim().min(1, "Owner ID is required"),
+    ownerName: z.string().trim().min(1, "Owner name is required"),
+    ownerEmail: z.string().email("Invalid owner email"),
+    status: collabDocStatusSchema,
+    trashedAt: z.number().optional(),
+    deletedAt: z.number().optional(),
+};
+/**
+ * Collaborator field schemas
+ */
+export const collaboratorFields = {
+    documentId: documentIdSchema,
+    userId: userIdSchema,
+    userName: z.string().trim().min(1, "User name is required"),
+    userEmail: z.string().email("Invalid user email"),
+    userAvatar: z.string().url().optional(),
+    permissionLevel: permissionLevelSchema,
+    invitedById: z.string().trim().min(1, "Inviter ID is required"),
+    invitedByName: z.string().trim().min(1, "Inviter name is required"),
+};
+/**
+ * Version field schemas
+ */
+export const versionFields = {
+    documentId: documentIdSchema,
+    content: binarySchema,
+    contentS3Key: z.string().optional(),
+    wordCount: z.number().int().min(0),
+    editorId: z.string().trim().min(1, "Editor ID is required"),
+    editorName: z.string().trim().min(1, "Editor name is required"),
+    snapshotType: snapshotTypeSchema,
+    label: z.string().max(COLLABORATION_LIMITS.MAX_VERSION_LABEL_LENGTH).optional(),
+};
+/**
+ * Comment field schemas
+ */
+export const commentFields = {
+    documentId: documentIdSchema,
+    parentId: z.string().uuid().nullable(),
+    anchorStart: binarySchema,
+    anchorEnd: binarySchema,
+    anchorText: z.string().max(COLLABORATION_LIMITS.MAX_ANCHOR_TEXT_LENGTH).optional(),
+    content: z
+        .string()
+        .trim()
+        .min(1, "Comment content is required")
+        .max(COLLABORATION_LIMITS.MAX_COMMENT_LENGTH, COLLABORATION_ERROR_MESSAGES.COMMENT_TOO_LONG),
+    authorId: z.string().trim().min(1, "Author ID is required"),
+    authorName: z.string().trim().min(1, "Author name is required"),
+    authorEmail: z.string().email("Invalid author email"),
+    authorAvatar: z.string().url().optional(),
+    status: commentStatusSchema,
+    resolvedById: z.string().optional(),
+    resolvedAt: z.number().optional(),
+    mentions: z.array(z.string()).optional(),
+};
+// ============================================================================
+// Entity Schemas
+// ============================================================================
+/**
+ * CollabDocument entity schema for DynamoDB storage.
+ * Extends baseEntitySchema for consistent id, timestamps, and audit fields.
+ */
+export const collabDocumentSchema = baseEntitySchema
+    .extend({
+    tenantId: tenantIdSchema,
+    title: collabDocFields.title,
+    content: collabDocFields.content,
+    contentVector: collabDocFields.contentVector,
+    contentS3Key: collabDocFields.contentS3Key,
+    wordCount: collabDocFields.wordCount,
+    previewSnippet: collabDocFields.previewSnippet,
+    ownerId: collabDocFields.ownerId,
+    ownerName: collabDocFields.ownerName,
+    ownerEmail: collabDocFields.ownerEmail,
+    status: collabDocFields.status,
+    trashedAt: collabDocFields.trashedAt,
+    deletedAt: collabDocFields.deletedAt,
+})
+    .describe("Collaborative document entity stored in DynamoDB");
+/**
+ * DocumentCollaborator entity schema
+ */
+export const documentCollaboratorSchema = baseEntitySchema
+    .extend({
+    documentId: collaboratorFields.documentId,
+    userId: collaboratorFields.userId,
+    userName: collaboratorFields.userName,
+    userEmail: collaboratorFields.userEmail,
+    userAvatar: collaboratorFields.userAvatar,
+    permissionLevel: collaboratorFields.permissionLevel,
+    invitedById: collaboratorFields.invitedById,
+    invitedByName: collaboratorFields.invitedByName,
+})
+    .describe("Document collaborator with permission level");
+/**
+ * DocumentVersion entity schema (no updatedAt, versions are immutable)
+ */
+export const documentVersionSchema = z
+    .object({
+    id: z.string().uuid(),
+    documentId: versionFields.documentId,
+    content: versionFields.content,
+    contentS3Key: versionFields.contentS3Key,
+    wordCount: versionFields.wordCount,
+    editorId: versionFields.editorId,
+    editorName: versionFields.editorName,
+    snapshotType: versionFields.snapshotType,
+    label: versionFields.label,
+    createdAt: z.number().int().positive(),
+})
+    .describe("Document version snapshot");
+/**
+ * DocumentComment entity schema
+ */
+export const documentCommentSchema = baseEntitySchema
+    .extend({
+    documentId: commentFields.documentId,
+    parentId: commentFields.parentId,
+    anchorStart: commentFields.anchorStart,
+    anchorEnd: commentFields.anchorEnd,
+    anchorText: commentFields.anchorText,
+    content: commentFields.content,
+    authorId: commentFields.authorId,
+    authorName: commentFields.authorName,
+    authorEmail: commentFields.authorEmail,
+    authorAvatar: commentFields.authorAvatar,
+    status: commentFields.status,
+    resolvedById: commentFields.resolvedById,
+    resolvedAt: commentFields.resolvedAt,
+    mentions: commentFields.mentions,
+})
+    .describe("Document inline comment");
+// ============================================================================
+// API Body Schemas
+// ============================================================================
+/**
+ * Schema for POST /api/collaboration body
+ */
+export const createDocumentBodySchema = z.object({
+    title: collabDocFields.title,
+});
+/**
+ * Schema for PATCH /api/collaboration/:documentId body
+ */
+export const updateDocumentBodySchema = z
+    .object({
+    title: collabDocFields.title.optional(),
+    content: z.string().optional(), // Base64 encoded
+    wordCount: collabDocFields.wordCount.optional(),
+    previewSnippet: collabDocFields.previewSnippet,
+})
+    .refine((obj) => Object.keys(obj).length > 0, {
+    message: "At least one field is required to update document",
+});
+/**
+ * Schema for POST /api/collaboration/:documentId/collaborators body
+ */
+export const addCollaboratorBodySchema = z.object({
+    userId: collaboratorFields.userId,
+    permissionLevel: collaboratorFields.permissionLevel,
+});
+/**
+ * Schema for PATCH /api/collaboration/:documentId/collaborators/:userId body
+ */
+export const updateCollaboratorBodySchema = z.object({
+    permissionLevel: collaboratorFields.permissionLevel,
+});
+/**
+ * Schema for POST /api/collaboration/:documentId/versions body
+ */
+export const createVersionBodySchema = z.object({
+    label: versionFields.label,
+    /** Current document content as base64-encoded Yjs state */
+    content: z.string().min(1, "Content is required"),
+    /** Current word count */
+    wordCount: z.number().int().nonnegative(),
+});
+/**
+ * Schema for POST /api/collaboration/:documentId/comments body
+ */
+export const createCommentBodySchema = z.object({
+    content: commentFields.content,
+    anchorStart: z.string(), // Base64 encoded
+    anchorEnd: z.string(), // Base64 encoded
+    anchorText: commentFields.anchorText,
+    parentId: z.string().uuid().optional(),
+    mentions: commentFields.mentions,
+});
+/**
+ * Schema for PATCH /api/collaboration/:documentId/comments/:commentId body
+ */
+export const updateCommentBodySchema = z
+    .object({
+    content: commentFields.content.optional(),
+    status: commentFields.status.optional(),
+    mentions: commentFields.mentions,
+})
+    .refine((obj) => Object.keys(obj).length > 0, {
+    message: "At least one field is required to update comment",
+});
+/**
+ * Schema for POST /api/collaboration/generate/stream body
+ */
+export const generateContentBodySchema = z.object({
+    messages: z.array(z.any()),
+    documentId: documentIdSchema,
+    contextMode: aiContextModeSchema,
+    selectionText: z.string().optional(),
+    documentContent: z.string().optional(),
+    files: z
+        .array(z.object({
+        url: z.string().min(1, "File URL is required"),
+        mediaType: z.string().optional(),
+        filename: z.string().optional(),
+    }))
+        .max(COLLABORATION_LIMITS.MAX_FILES_FOR_GENERATION)
+        .optional(),
+    modelId: z.string().optional(),
+    agentId: z.string().optional(),
+});
+/**
+ * Schema for POST /api/collaboration/documents/:documentId/generate body
+ */
+export const generateDocumentBodySchema = z.object({
+    prompt: z.string().trim().min(1, "Prompt is required"),
+});
+// ============================================================================
+// Query Parameter Schemas
+// ============================================================================
+/**
+ * Schema for GET /api/collaboration query parameters
+ */
+export const listDocumentsQuerySchema = z.object({
+    filter: documentFilterSchema.optional(),
+    search: z.string().optional(),
+    limit: z.coerce.number().int().min(1).max(COLLABORATION_LIMITS.MAX_PAGE_SIZE).optional(),
+    nextToken: z.string().optional(),
+});
+/**
+ * Schema for GET /api/collaboration/:documentId/versions query parameters
+ */
+export const listVersionsQuerySchema = z.object({
+    limit: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(COLLABORATION_LIMITS.MAX_VERSIONS_PER_DOCUMENT)
+        .optional(),
+});
+/**
+ * Schema for GET /api/collaboration/:documentId/comments query parameters
+ */
+export const listCommentsQuerySchema = z.object({
+    status: commentStatusSchema.optional(),
+    includeReplies: z.coerce.boolean().optional().default(true),
+    limit: z.coerce.number().int().min(1).max(COLLABORATION_LIMITS.MAX_PAGE_SIZE).optional(),
+});
+//# sourceMappingURL=collaboration.schemas.js.map

package/dist/collaboration/collaboration.schemas.js.map

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

package/dist/collaboration/collaboration.utilities.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Collaboration module utilities
+ *
+ * Only includes utilities currently in use.
+ * Additional utilities for permissions, presence, and formatting
+ * should be added when those features are implemented.
+ */
+import type { DocumentGenerationMessageContent, DocumentGenerationParsedResult, DocumentTocEntry, InlineCommentFileAttachment, DocumentGenerationInput, StoredDocumentGenerationInput } from "./collaboration.interfaces";
+import type { AiContextMode } from "./collaboration.constants";
+import type { CollabDocument } from "./collaboration.schemas";
+/**
+ * Extract plain text from yjs-encoded content.
+ * Decodes the Yjs document state and extracts the text content.
+ *
+ * @param content - Yjs document state as Uint8Array
+ * @returns Plain text content from the document
+ */
+export declare function extractPlainText(content: Uint8Array): string;
+/**
+ * Count words in plain text
+ */
+export declare function countWords(text: string): number;
+/**
+ * Generate preview snippet from plain text
+ */
+export declare function generatePreviewSnippet(text: string, maxLength?: number): string;
+/**
+ * Build table of contents entries from markdown content.
+ */
+export declare function buildMarkdownToc(markdown: string): DocumentTocEntry[];
+export declare function buildContentGenerationPrompt(contextMode: AiContextMode): string;
+export declare function buildUserMessage(prompt: string, contextMode: AiContextMode, selectionText?: string, documentContent?: string): string;
+export declare function buildMessageContent(prompt: string, files?: InlineCommentFileAttachment[]): DocumentGenerationMessageContent;
+export declare function parseGeneratedDocument(rawText: string): DocumentGenerationParsedResult;
+export declare function normalizeTitle(title: string): string;
+export declare function buildDocumentContent(markdown: string): Uint8Array;
+export declare function buildDocumentGenerationStorageKey(documentId: string): string;
+export declare function filterDocumentGenerationFiles(files?: DocumentGenerationInput["files"]): import("../shared/shared.interfaces").PromptFileAttachment[] | undefined;
+export declare function storeDocumentGenerationInput(documentId: string, input: DocumentGenerationInput): boolean;
+export declare function getAndClearDocumentGenerationInput(documentId: string): StoredDocumentGenerationInput | undefined;
+export declare function getPresenceColorClass(userId: string): {
+    readonly border: "border-[#F44336]";
+    readonly background: "bg-[#F44336]";
+} | {
+    readonly border: "border-[#E91E63]";
+    readonly background: "bg-[#E91E63]";
+} | {
+    readonly border: "border-[#9C27B0]";
+    readonly background: "bg-[#9C27B0]";
+} | {
+    readonly border: "border-[#673AB7]";
+    readonly background: "bg-[#673AB7]";
+} | {
+    readonly border: "border-[#3F51B5]";
+    readonly background: "bg-[#3F51B5]";
+} | {
+    readonly border: "border-[#2196F3]";
+    readonly background: "bg-[#2196F3]";
+} | {
+    readonly border: "border-[#03A9F4]";
+    readonly background: "bg-[#03A9F4]";
+} | {
+    readonly border: "border-[#00BCD4]";
+    readonly background: "bg-[#00BCD4]";
+} | {
+    readonly border: "border-[#009688]";
+    readonly background: "bg-[#009688]";
+} | {
+    readonly border: "border-[#4CAF50]";
+    readonly background: "bg-[#4CAF50]";
+} | {
+    readonly border: "border-[#8BC34A]";
+    readonly background: "bg-[#8BC34A]";
+} | {
+    readonly border: "border-[#FF9800]";
+    readonly background: "bg-[#FF9800]";
+};
+/**
+ * Encode Uint8Array to base64 string
+ * Uses chunking to avoid stack overflow on large arrays
+ */
+export declare function encodeToBase64(bytes: Uint8Array): string;
+/**
+ * Decode base64 string to Uint8Array
+ */
+export declare function decodeFromBase64(base64: string): Uint8Array;
+/**
+ * Build context string from a collaborative document for AI-powered features.
+ * Used by the comments AI service to provide document context.
+ * Extracts full document content from Yjs-encoded data.
+ *
+ * @param document - The collaborative document
+ * @returns A formatted string containing document context for AI
+ */
+export declare function buildDocumentContext(document: CollabDocument): string;
+//# sourceMappingURL=collaboration.utilities.d.ts.map

package/dist/collaboration/collaboration.utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration.utilities.d.ts","sourceRoot":"","sources":["../../lib/collaboration/collaboration.utilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,OAAO,KAAK,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,gBAAgB,EAChB,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAMhF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAiBpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAwCrE;AAMD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,aAAa,GAAG,MAAM,CAO/E;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,aAAa,EAC1B,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CASR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,2BAA2B,EAAE,GACpC,gCAAgC,CAoBlC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,8BAA8B,CA8BtF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAKjE;AAED,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,uBAAuB,CAAC,OAAO,CAAC,4EAMrF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAqBT;AAED,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,MAAM,GACjB,6BAA6B,GAAG,SAAS,CAuB3C;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAYxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAU3D;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CA4BrE"}