captify 0.1.18 → 1.1.0

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

@@ -0,0 +1,219 @@
+/**
+ * DocumentGenerationService - AI generation for collaborative documents
+ */
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+import { streamText } from "ai";
+import { getCollaborationService } from "./collaboration.service";
+import { getCollaboratorService } from "./collaborator.service";
+import { getLLMService } from "../../llm-providers/services";
+import { getAgentsService } from "../../agents/services";
+import { getUsageTrackingService } from "../../model-budget/services";
+import { COLLABORATION_ERROR_MESSAGES, COLLABORATION_LIMITS, DOCUMENT_GENERATION_PROMPTS, } from "../collaboration.constants";
+import { AccessDeniedError } from "../collaboration.errors";
+import { ValidationError } from "../../shared/services";
+import { buildContentGenerationPrompt, buildDocumentContent, buildMessageContent, buildUserMessage, countWords, generatePreviewSnippet, normalizeTitle, parseGeneratedDocument, } from "../collaboration.utilities";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+export class DocumentGenerationService extends BaseAwsService {
+    constructor() {
+        super({ serviceName: "DocumentGenerationService" });
+    }
+    /**
+     * Stream content generation with model/agent routing.
+     * Returns a Response object using the AI SDK streaming protocol.
+     */
+    async streamContentGeneration(params) {
+        const { tenantId, userId, documentId, userCredentials } = params;
+        await this.assertGenerationAccess({ tenantId, userId, documentId, userCredentials });
+        // Route to agent or direct model
+        if (params.agentId) {
+            return this.streamAgentContent(params);
+        }
+        return this.streamDirectModelContent(params);
+    }
+    /**
+     * Route through AgentsService for agent-based generation.
+     * Enriches the last user message with document context before forwarding.
+     */
+    async streamAgentContent(params) {
+        const { tenantId, userId, prompt, contextMode, userCredentials, messages } = params;
+        // Build the enriched prompt with document context
+        const enrichedUserMessage = buildUserMessage(prompt, contextMode, params.selectionText, params.documentContent);
+        const enrichedContent = buildMessageContent(enrichedUserMessage, params.files);
+        // Replace the last user message content with the enriched version
+        const enrichedMessages = messages.map((msg, idx) => {
+            if (idx === messages.length - 1 && msg.role === "user") {
+                return Object.assign(Object.assign({}, msg), { parts: [
+                        {
+                            type: "text",
+                            text: typeof enrichedContent === "string"
+                                ? enrichedContent
+                                : enrichedContent.map((c) => ("text" in c ? c.text : "")).join(""),
+                        },
+                    ] });
+            }
+            return msg;
+        });
+        return getAgentsService().streamResponse({
+            agentId: params.agentId,
+            tenantId,
+            userId,
+            messages: enrichedMessages,
+            userCredentials,
+        });
+    }
+    /**
+     * Stream using a direct model (user-selected or system default).
+     * Uses streamText + toUIMessageStreamResponse for AI SDK protocol.
+     */
+    async streamDirectModelContent(params) {
+        const { tenantId, prompt, contextMode, userCredentials, messages } = params;
+        const model = await this.resolveModel(tenantId, params.modelId, userCredentials);
+        const systemPrompt = buildContentGenerationPrompt(contextMode);
+        const userMessage = buildUserMessage(prompt, contextMode, params.selectionText, params.documentContent);
+        const messageContent = buildMessageContent(userMessage, params.files);
+        const result = await streamText({
+            model,
+            system: systemPrompt,
+            messages: [{ role: "user", content: messageContent }],
+            temperature: 0.7,
+        });
+        return result.toUIMessageStreamResponse({
+            originalMessages: messages,
+        });
+    }
+    /**
+     * Resolve an AI SDK LanguageModel from either a specific modelId (UUID)
+     * or the system default.
+     */
+    async resolveModel(tenantId, modelId, userCredentials) {
+        const llmService = getLLMService();
+        if (modelId) {
+            // Look up by UUID - no providerId needed
+            const modelRecord = await llmService.getModelById(tenantId, modelId, { userCredentials });
+            if (!modelRecord) {
+                throw new ValidationError(`Model with ID ${modelId} not found`);
+            }
+            if (!modelRecord.isAvailable) {
+                throw new ValidationError(`Model ${modelRecord.name} is not available`);
+            }
+            const provider = await llmService.getProviderById(tenantId, modelRecord.providerId, {
+                userCredentials,
+            });
+            if (!provider || !provider.isEnabled) {
+                throw new ValidationError("Model provider is not available");
+            }
+            // Check usage limits
+            const usageTracker = getUsageTrackingService();
+            await usageTracker.checkLimitsOrThrow({
+                tenantId,
+                providerId: provider.id,
+                modelId: modelRecord.id,
+                userCredentials,
+            });
+            return llmService
+                .getAISDKProvider(provider, userCredentials)
+                .languageModel(modelRecord.modelId);
+        }
+        // Fall back to default model
+        return (await this.getModel({ tenantId, userCredentials })).model;
+    }
+    async generateDocumentFromPrompt(params) {
+        var _a, e_1, _b, _c;
+        const { tenantId, userId, documentId, prompt, userCredentials } = params;
+        await this.assertGenerationAccess({ tenantId, userId, documentId, userCredentials });
+        const { model } = await this.getModel({ tenantId, userCredentials });
+        const result = streamText({
+            model,
+            system: DOCUMENT_GENERATION_PROMPTS.DOCUMENT_SYSTEM,
+            messages: [{ role: "user", content: [{ type: "text", text: prompt }] }],
+            temperature: 0.7,
+        });
+        let fullContent = "";
+        try {
+            for (var _d = true, _e = __asyncValues((await result).textStream), _f; _f = await _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const textPart = _c;
+                fullContent += textPart;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) await _b.call(_e);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        const parsed = parseGeneratedDocument(fullContent);
+        const content = parsed.content || fullContent.trim();
+        const title = normalizeTitle(parsed.title || prompt);
+        const contentUpdate = buildDocumentContent(content);
+        const wordCount = countWords(content);
+        const previewSnippet = generatePreviewSnippet(content, COLLABORATION_LIMITS.MAX_PREVIEW_SNIPPET_LENGTH);
+        return getCollaborationService().update({
+            tenantId,
+            documentId,
+            userId,
+            updates: {
+                title,
+                content: contentUpdate,
+                wordCount,
+                previewSnippet,
+            },
+            userCredentials,
+        });
+    }
+    async getModel({ tenantId, userCredentials }) {
+        const llmService = getLLMService();
+        const effectiveModelResult = await llmService.getEffectiveBasicAssistantModel(tenantId, {
+            userCredentials,
+        });
+        if (!effectiveModelResult) {
+            throw new ValidationError(COLLABORATION_ERROR_MESSAGES.NO_AVAILABLE_LLM_MODELS);
+        }
+        const { provider: defaultProvider, model: defaultModel } = effectiveModelResult;
+        const usageTracker = getUsageTrackingService();
+        await usageTracker.checkLimitsOrThrow({
+            tenantId,
+            providerId: defaultProvider.id,
+            modelId: defaultModel.id,
+            userCredentials,
+        });
+        const aiProvider = llmService.getAISDKProvider(defaultProvider, userCredentials);
+        return {
+            model: aiProvider.languageModel(defaultModel.modelId),
+        };
+    }
+    async assertGenerationAccess({ tenantId, userId, documentId, userCredentials, }) {
+        const document = await getCollaborationService().get({
+            tenantId,
+            documentId,
+            userId,
+            userCredentials,
+        });
+        if (document.ownerId === userId)
+            return;
+        const permission = await getCollaboratorService().getPermissionLevel({
+            documentId,
+            userId,
+            userCredentials,
+        });
+        if (!permission || permission === "view") {
+            throw new AccessDeniedError(userId, documentId, "generate");
+        }
+    }
+}
+let documentGenerationService = null;
+export function getDocumentGenerationService() {
+    if (!documentGenerationService) {
+        documentGenerationService = new DocumentGenerationService();
+    }
+    return documentGenerationService;
+}
+//# sourceMappingURL=document-generation.service.js.map

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

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

package/dist/collaboration/services/index.d.ts

@@ -0,0 +1,7 @@
+export { streamDocumentGeneration } from "./document-generation-client.service";
+export { DocumentGenerationService } from "./document-generation.service";
+export { CollaborationService } from "./collaboration.service";
+export { CollaboratorService } from "./collaborator.service";
+export { CommentService } from "./comment.service";
+export { VersionService } from "./version.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/collaboration/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iEAAiE,CAAC;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/collaboration/services/index.js

@@ -0,0 +1,7 @@
+export { streamDocumentGeneration } from "./document-generation-client.service";
+export { DocumentGenerationService } from "./document-generation.service";
+export { CollaborationService } from "./collaboration.service";
+export { CollaboratorService } from "./collaborator.service";
+export { CommentService } from "./comment.service";
+export { VersionService } from "./version.service";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/collaboration/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iEAAiE,CAAC;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC"}

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

@@ -0,0 +1,99 @@
+/**
+ * VersionService - Document version history operations
+ *
+ * Handles version snapshot creation, retrieval, and restoration.
+ * Supports auto-save, manual snapshots, and version limits.
+ */
+import type { CreateVersionParams, GetVersionParams, ListVersionsParams, ListVersionsResponse, RestoreVersionParams, VersionServiceDeps } from "../collaboration.interfaces";
+import type { DocumentVersion } from "../collaboration.schemas";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+/**
+ * Service for managing document versions.
+ *
+ * @example
+ * ```typescript
+ * const service = getVersionService();
+ *
+ * // Create a version snapshot
+ * const version = await service.create({
+ *   documentId: "doc-123",
+ *   content: contentBytes,
+ *   wordCount: 1500,
+ *   editorId: "user-123",
+ *   editorName: "John Doe",
+ *   snapshotType: "manual",
+ *   label: "Before refactoring",
+ * });
+ *
+ * // List versions
+ * const { versions } = await service.list({ documentId: "doc-123" });
+ *
+ * // Restore a version
+ * await service.restore({
+ *   documentId: "doc-123",
+ *   versionId: "version-456",
+ *   tenantId: "acme",
+ *   userId: "user-123",
+ *   userName: "John Doe",
+ * });
+ * ```
+ */
+export declare class VersionService extends BaseAwsService {
+    private db;
+    constructor(deps?: VersionServiceDeps);
+    /**
+     * Create a new version snapshot.
+     *
+     * @param params - Version creation parameters
+     * @returns The created version
+     * @throws {CollaborationError} If version limit is exceeded
+     */
+    create(params: CreateVersionParams): Promise<DocumentVersion>;
+    /**
+     * List versions for a document (newest first).
+     *
+     * @param params - List parameters
+     * @returns List of versions
+     */
+    list(params: ListVersionsParams): Promise<ListVersionsResponse>;
+    /**
+     * Get a single version by ID.
+     *
+     * Note: This method has a performance limitation - it queries all versions
+     * for the document and filters client-side because:
+     * - The sort key (SK) is the timestamp, which enables chronological ordering
+     * - The versionId is stored as a separate attribute, not in the key
+     * - DynamoDB FilterExpression is applied AFTER reading all items
+     *
+     * Performance impact: O(n) where n = number of versions for the document
+     * Mitigation: Documents are limited to MAX_VERSIONS_PER_DOCUMENT (50)
+     *
+     * Future optimization: Add a GSI with versionId as the key for O(1) lookups
+     *
+     * @param params - Get parameters
+     * @returns The version if found
+     * @throws {DocumentNotFoundError} If version not found
+     */
+    get(params: GetVersionParams): Promise<DocumentVersion>;
+    /**
+     * Restore a document to a specific version.
+     *
+     * Creates a new "restore" snapshot and updates the document content.
+     *
+     * @param params - Restore parameters
+     * @throws {DocumentNotFoundError} If version not found
+     */
+    restore(params: RestoreVersionParams): Promise<void>;
+    /**
+     * Delete a version by timestamp.
+     * Internal method used for enforcing version limits.
+     */
+    private delete;
+}
+/**
+ * Get the VersionService singleton instance.
+ *
+ * @returns VersionService instance
+ */
+export declare function getVersionService(): VersionService;
+//# sourceMappingURL=version.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.service.d.ts","sourceRoot":"","sources":["../../../lib/collaboration/services/version.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAMjF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AASxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,OAAO,CAAC,EAAE,CAA6C;gBAE3C,IAAI,GAAE,kBAAuB;IAMzC;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6DnE;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiCrE;;;;;;;;;;;;;;;;;OAiBG;IACG,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqC7D;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C1D;;;OAGG;YACW,MAAM;CAarB;AAQD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAclD"}

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

@@ -0,0 +1,267 @@
+/**
+ * VersionService - Document version history operations
+ *
+ * Handles version snapshot creation, retrieval, and restoration.
+ * Supports auto-save, manual snapshots, and version limits.
+ */
+import { COLLABORATION_LIMITS } from "../collaboration.constants";
+import { VersionNotFoundError } from "../collaboration.errors";
+import { versionKeys } from "../../db/schemas/collab-versions.schema";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+import { DynamoDbInstances } from "../../shared/services/dynamodb";
+import { LoggerFactory } from "../../shared/services/logger";
+import { TABLES } from "../../shared/shared.constants";
+import { randomUUID } from "crypto";
+import { getCollaborationService } from "./collaboration.service";
+/**
+ * Service for managing document versions.
+ *
+ * @example
+ * ```typescript
+ * const service = getVersionService();
+ *
+ * // Create a version snapshot
+ * const version = await service.create({
+ *   documentId: "doc-123",
+ *   content: contentBytes,
+ *   wordCount: 1500,
+ *   editorId: "user-123",
+ *   editorName: "John Doe",
+ *   snapshotType: "manual",
+ *   label: "Before refactoring",
+ * });
+ *
+ * // List versions
+ * const { versions } = await service.list({ documentId: "doc-123" });
+ *
+ * // Restore a version
+ * await service.restore({
+ *   documentId: "doc-123",
+ *   versionId: "version-456",
+ *   tenantId: "acme",
+ *   userId: "user-123",
+ *   userName: "John Doe",
+ * });
+ * ```
+ */
+export class VersionService extends BaseAwsService {
+    constructor(deps = {}) {
+        var _a;
+        super({ logger: deps.logger });
+        this.db =
+            (_a = deps.db) !== null && _a !== void 0 ? _a : DynamoDbInstances.getInstance(TABLES.collabVersions);
+    }
+    /**
+     * Create a new version snapshot.
+     *
+     * @param params - Version creation parameters
+     * @returns The created version
+     * @throws {CollaborationError} If version limit is exceeded
+     */
+    async create(params) {
+        const { documentId, content, wordCount, editorId, editorName, snapshotType, label, userCredentials, } = params;
+        // Check version limit - fetch at least MAX + 1 to ensure we get the true oldest
+        const existing = await this.list({
+            documentId,
+            limit: COLLABORATION_LIMITS.MAX_VERSIONS_PER_DOCUMENT + 1,
+            userCredentials,
+        });
+        if (existing.versions.length >= COLLABORATION_LIMITS.MAX_VERSIONS_PER_DOCUMENT) {
+            // Delete oldest version to make room
+            const oldestVersion = existing.versions[existing.versions.length - 1];
+            await this.delete(documentId, oldestVersion.createdAt, userCredentials);
+            this.logger.info("Deleted oldest version due to limit", {
+                documentId,
+                deletedVersionId: oldestVersion.id,
+            });
+        }
+        const versionId = randomUUID();
+        const now = Date.now();
+        const version = {
+            id: versionId,
+            documentId,
+            content: content,
+            wordCount,
+            editorId,
+            editorName,
+            snapshotType,
+            label,
+            createdAt: now,
+        };
+        const document = Object.assign({ PK: versionKeys.pk(documentId), SK: versionKeys.sk(now) }, version);
+        await this.db.putItem(document, { userCredentials });
+        this.logger.info("Version created", {
+            documentId,
+            versionId,
+            snapshotType,
+            wordCount,
+        });
+        return version;
+    }
+    /**
+     * List versions for a document (newest first).
+     *
+     * @param params - List parameters
+     * @returns List of versions
+     */
+    async list(params) {
+        var _a;
+        const { documentId, limit = 50, userCredentials } = params;
+        const result = await this.db.queryItems({
+            KeyConditionExpression: "PK = :pk",
+            ExpressionAttributeValues: {
+                ":pk": versionKeys.pk(documentId),
+            },
+            ScanIndexForward: false, // Newest first
+            Limit: limit,
+        }, { userCredentials });
+        // Map versions but exclude content for list response (it's large binary data)
+        // Content is only needed for restore operations, which fetch the individual version
+        const versions = ((_a = result.Items) !== null && _a !== void 0 ? _a : []).map((doc) => ({
+            id: doc.id,
+            documentId: doc.documentId,
+            // Omit content - not needed for listing, only for restore
+            contentS3Key: doc.contentS3Key,
+            wordCount: doc.wordCount,
+            editorId: doc.editorId,
+            editorName: doc.editorName,
+            snapshotType: doc.snapshotType,
+            label: doc.label,
+            createdAt: doc.createdAt,
+        }));
+        return { versions };
+    }
+    /**
+     * Get a single version by ID.
+     *
+     * Note: This method has a performance limitation - it queries all versions
+     * for the document and filters client-side because:
+     * - The sort key (SK) is the timestamp, which enables chronological ordering
+     * - The versionId is stored as a separate attribute, not in the key
+     * - DynamoDB FilterExpression is applied AFTER reading all items
+     *
+     * Performance impact: O(n) where n = number of versions for the document
+     * Mitigation: Documents are limited to MAX_VERSIONS_PER_DOCUMENT (50)
+     *
+     * Future optimization: Add a GSI with versionId as the key for O(1) lookups
+     *
+     * @param params - Get parameters
+     * @returns The version if found
+     * @throws {DocumentNotFoundError} If version not found
+     */
+    async get(params) {
+        var _a;
+        const { documentId, versionId, userCredentials } = params;
+        // Query to find the version by ID (we don't know the timestamp)
+        // PERFORMANCE NOTE: This reads all versions and filters client-side
+        // because versionId is not in the key structure (timestamp is SK for ordering)
+        const result = await this.db.queryItems({
+            KeyConditionExpression: "PK = :pk",
+            FilterExpression: "id = :id",
+            ExpressionAttributeValues: {
+                ":pk": versionKeys.pk(documentId),
+                ":id": versionId,
+            },
+        }, { userCredentials });
+        const doc = (_a = result.Items) === null || _a === void 0 ? void 0 : _a[0];
+        if (!doc) {
+            throw new VersionNotFoundError(versionId);
+        }
+        return {
+            id: doc.id,
+            documentId: doc.documentId,
+            content: doc.content,
+            contentS3Key: doc.contentS3Key,
+            wordCount: doc.wordCount,
+            editorId: doc.editorId,
+            editorName: doc.editorName,
+            snapshotType: doc.snapshotType,
+            label: doc.label,
+            createdAt: doc.createdAt,
+        };
+    }
+    /**
+     * Restore a document to a specific version.
+     *
+     * Creates a new "restore" snapshot and updates the document content.
+     *
+     * @param params - Restore parameters
+     * @throws {DocumentNotFoundError} If version not found
+     */
+    async restore(params) {
+        var _a;
+        const { documentId, versionId, tenantId, userId, userName, userCredentials } = params;
+        // Get the version to restore
+        const version = await this.get({ documentId, versionId, userCredentials });
+        // Create a "restore" snapshot of the current state
+        const collabService = getCollaborationService();
+        const currentDoc = await collabService.get({
+            documentId,
+            tenantId,
+            userId,
+            userCredentials,
+        });
+        await this.create({
+            documentId,
+            content: currentDoc.content,
+            wordCount: (_a = currentDoc.wordCount) !== null && _a !== void 0 ? _a : 0,
+            editorId: userId,
+            editorName: userName,
+            snapshotType: "restore",
+            label: `State before restore to ${new Date(version.createdAt).toLocaleString()}`,
+            userCredentials,
+        });
+        // Update the document with the version's content
+        await collabService.update({
+            documentId,
+            tenantId,
+            userId,
+            updates: {
+                content: version.content,
+                wordCount: version.wordCount,
+            },
+            userCredentials,
+        });
+        this.logger.info("Version restored", {
+            documentId,
+            versionId,
+            userId,
+            restoredFrom: version.createdAt,
+        });
+    }
+    /**
+     * Delete a version by timestamp.
+     * Internal method used for enforcing version limits.
+     */
+    async delete(documentId, timestamp, userCredentials) {
+        await this.db.deleteItem({
+            PK: versionKeys.pk(documentId),
+            SK: versionKeys.sk(timestamp),
+        }, { userCredentials });
+    }
+}
+// ============================================================================
+// Singleton Pattern
+// ============================================================================
+let instance = null;
+/**
+ * Get the VersionService singleton instance.
+ *
+ * @returns VersionService instance
+ */
+export function getVersionService() {
+    if (!instance) {
+        instance = new VersionService({
+            logger: LoggerFactory.createLogger({
+                serviceName: "VersionService",
+                userContext: {
+                    userId: "system",
+                    email: "system@captify.com",
+                    name: "System Service Account",
+                },
+            }),
+        });
+    }
+    return instance;
+}
+//# sourceMappingURL=version.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.service.js","sourceRoot":"","sources":["../../../lib/collaboration/services/version.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAchF,OAAO,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAG7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAGhD,YAAY,OAA2B,EAAE;;QACvC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE;YACL,MAAA,IAAI,CAAC,EAAE,mCAAI,iBAAiB,CAAC,WAAW,CAA4B,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,EACJ,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,KAAK,EACL,eAAe,GAChB,GAAG,MAAM,CAAC;QAEX,gFAAgF;QAChF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YAC/B,UAAU;YACV,KAAK,EAAE,oBAAoB,CAAC,yBAAyB,GAAG,CAAC;YACzD,eAAe;SAChB,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,oBAAoB,CAAC,yBAAyB,EAAE,CAAC;YAC/E,qCAAqC;YACrC,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;gBACtD,UAAU;gBACV,gBAAgB,EAAE,aAAa,CAAC,EAAE;aACnC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,SAAS;YACb,UAAU;YACV,OAAO,EAAE,OAAkC;YAC3C,SAAS;YACT,QAAQ;YACR,UAAU;YACV,YAAY;YACZ,KAAK;YACL,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,MAAM,QAAQ,mBACZ,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,EAC9B,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,CAAC,IACpB,OAAO,CACX,CAAC;QAEF,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;QAErD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAClC,UAAU;YACV,SAAS;YACT,YAAY;YACZ,SAAS;SACV,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,MAA0B;;QACnC,MAAM,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CACrC;YACE,sBAAsB,EAAE,UAAU;YAClC,yBAAyB,EAAE;gBACzB,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC;aAClC;YACD,gBAAgB,EAAE,KAAK,EAAE,eAAe;YACxC,KAAK,EAAE,KAAK;SACb,EACD,EAAE,eAAe,EAAE,CACpB,CAAC;QAEF,8EAA8E;QAC9E,oFAAoF;QACpF,MAAM,QAAQ,GAAG,CAAC,MAAA,MAAM,CAAC,KAAK,mCAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAoB,EAAE,EAAE,CAAC,CAAC;YACnE,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,0DAA0D;YAC1D,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,GAAG,CAAC,MAAwB;;QAChC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAE1D,gEAAgE;QAChE,oEAAoE;QACpE,+EAA+E;QAC/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CACrC;YACE,sBAAsB,EAAE,UAAU;YAClC,gBAAgB,EAAE,UAAU;YAC5B,yBAAyB,EAAE;gBACzB,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC;gBACjC,KAAK,EAAE,SAAS;aACjB;SACF,EACD,EAAE,eAAe,EAAE,CACpB,CAAC;QAEF,MAAM,GAAG,GAAG,MAAA,MAAM,CAAC,KAAK,0CAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,MAA4B;;QACxC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;QAEtF,6BAA6B;QAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;QAE3E,mDAAmD;QACnD,MAAM,aAAa,GAAG,uBAAuB,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC;YACzC,UAAU;YACV,QAAQ;YACR,MAAM;YACN,eAAe;SAChB,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,MAAM,CAAC;YAChB,UAAU;YACV,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,SAAS,EAAE,MAAA,UAAU,CAAC,SAAS,mCAAI,CAAC;YACpC,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE,SAAS;YACvB,KAAK,EAAE,2BAA2B,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE;YAChF,eAAe;SAChB,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,aAAa,CAAC,MAAM,CAAC;YACzB,UAAU;YACV,QAAQ;YACR,MAAM;YACN,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B;YACD,eAAe;SAChB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACnC,UAAU;YACV,SAAS;YACT,MAAM;YACN,YAAY,EAAE,OAAO,CAAC,SAAS;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,MAAM,CAClB,UAAkB,EAClB,SAAiB,EACjB,eAAoC;QAEpC,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CACtB;YACE,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC;YAC9B,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC;SAC9B,EACD,EAAE,eAAe,EAAE,CACpB,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,cAAc,CAAC;YAC5B,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC;gBACjC,WAAW,EAAE,gBAAgB;gBAC7B,WAAW,EAAE;oBACX,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,oBAAoB;oBAC3B,IAAI,EAAE,wBAAwB;iBAC/B;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,28 @@
+import { NextResponse } from "next/server";
+import type { CommentsAiHandlerConfig } from "../comments.interfaces";
+/**
+ * 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 declare function createCommentsAiHandlers(config?: CommentsAiHandlerConfig): {
+    streamAiReply: (request: import("next/server").NextRequest, context: {
+        params: Promise<Record<string, unknown>>;
+    }) => Promise<NextResponse<{
+        error: string;
+    } | {
+        error: string;
+    }>>;
+    streamSummary: (request: import("next/server").NextRequest, context: {
+        params: Promise<Record<string, unknown>>;
+    }) => Promise<NextResponse<{
+        error: string;
+    } | {
+        error: string;
+    }>>;
+};
+//# sourceMappingURL=comments-ai.handlers.d.ts.map