captify 0.1.15

package/dist/chat/services/chat-message.service.d.ts

@@ -0,0 +1,136 @@
+import type { ChatMessage, ChatMessageServiceDeps, ChatMessagesResponse, ChatServiceOptions, MessageAttachment } from "../chat.interfaces";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+/**
+ * Service responsible for managing chat messages within sessions.
+ * Handles message CRUD operations and attachment URL generation.
+ * Messages are stored in a dedicated DynamoDB table for optimal performance.
+ *
+ * Responsibilities:
+ * - Message CRUD: getMessages, addMessage, deleteMessage
+ * - Presigned URL generation for attachments
+ * - Message validation and data integrity
+ * - Batch message queries with pagination
+ *
+ * Does NOT handle:
+ * - Session metadata (see ChatSessionService)
+ * - Usage tracking (see ChatUsageService)
+ * - File uploads (see ChatAttachmentService)
+ */
+export declare class ChatMessageService extends BaseAwsService {
+    private messagesDb;
+    private s3Service;
+    constructor(deps: ChatMessageServiceDeps);
+    /**
+     * Get messages for a chat session sorted by timestamp with optional pagination.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param sessionId Session ID to get messages for
+     * @param params Optional pagination parameters (limit, lastEvaluatedKey)
+     * @param totalCount Total count of messages in the session (from session metadata)
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to messages response with pagination info
+     * @throws ValidationError if userId or sessionId is invalid
+     *
+     * @example
+     * ```typescript
+     * // Get first 50 messages
+     * const response = await messageService.getMessages(tenantId, userId, sessionId, { limit: 50 }, 150);
+     * console.log(response.messages, response.totalCount);
+     *
+     * // Get next page
+     * const nextPage = await messageService.getMessages(tenantId, userId, sessionId, {
+     *   limit: 50,
+     *   lastEvaluatedKey: response.lastEvaluatedKey
+     * }, 150);
+     * ```
+     */
+    getMessages(tenantId: string, userId: string, sessionId: string, params?: {
+        limit?: number;
+        lastEvaluatedKey?: Record<string, unknown>;
+    }, totalCount?: number, options?: ChatServiceOptions): Promise<ChatMessagesResponse>;
+    /**
+     * Add a new message to the messages table.
+     * NOTE: This only writes to the messages table. Session metadata updates
+     * (messageCount, lastUpdated, usage) must be handled by the caller.
+     *
+     * @param message Complete message object to store
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the stored message (with presigned URLs for attachments)
+     *
+     * @internal Used by ChatService after validation and session checks
+     */
+    addMessage(message: ChatMessage, options?: ChatServiceOptions): Promise<ChatMessage>;
+    /**
+     * Update an existing message in the messages table.
+     * NOTE: This only writes to the messages table. Session metadata updates
+     * must be handled by the caller.
+     *
+     * @param message Complete message object to store (must have existing timestamp)
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the updated message (with presigned URLs for attachments)
+     *
+     * @internal Used by ChatService after validation and session checks
+     */
+    updateMessage(message: ChatMessage, options?: ChatServiceOptions): Promise<ChatMessage>;
+    /**
+     * Get a specific message by ID from a session.
+     *
+     * @param sessionId Session ID containing the message
+     * @param messageId Message ID to retrieve
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the message, or null if not found
+     *
+     * @internal Used by ChatService for message operations
+     */
+    getMessageById(sessionId: string, messageId: string, options?: ChatServiceOptions): Promise<ChatMessage | null>;
+    /**
+     * Delete a message from the messages table.
+     * NOTE: This only deletes from the messages table. Session metadata updates
+     * and attachment cleanup must be handled by the caller.
+     *
+     * @param sessionId Session ID containing the message
+     * @param messageId Message ID to delete
+     * @param timestamp Message timestamp (required for sort key)
+     * @param options Optional service options including user credentials
+     *
+     * @internal Used by ChatService after validation and attachment cleanup
+     */
+    deleteMessage(sessionId: string, messageId: string, timestamp: number, options?: ChatServiceOptions): Promise<void>;
+    /**
+     * Delete all messages for a session.
+     * Returns the list of attachments that need to be deleted from S3.
+     *
+     * @param sessionId Session ID to delete messages for
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to array of attachments to delete
+     *
+     * @internal Used by ChatService during session deletion
+     */
+    deleteAllMessagesForSession(sessionId: string, options?: ChatServiceOptions): Promise<MessageAttachment[]>;
+    /**
+     * Generate presigned URLs for message attachments.
+     * Replaces direct S3 URLs with presigned URLs that are accessible.
+     *
+     * @param attachments Array of message attachments to generate presigned URLs for
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to attachments with presigned URLs
+     *
+     * @example
+     * ```typescript
+     * const presignedAttachments = await messageService.generatePresignedUrlsForAttachments(
+     *   message.attachments,
+     *   options,
+     * );
+     * ```
+     */
+    generatePresignedUrlsForAttachments(attachments: MessageAttachment[], options?: ChatServiceOptions): Promise<MessageAttachment[]>;
+    /**
+     * Generate presigned URLs for all attachments in messages.
+     * Only generates for recent messages (last 20 or within 24 hours) to optimize performance.
+     *
+     * @private
+     */
+    private generatePresignedUrlsForMessages;
+}
+//# sourceMappingURL=chat-message.service.d.ts.map

package/dist/chat/services/chat-message.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message.service.d.ts","sourceRoot":"","sources":["../../../lib/chat/services/chat-message.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAMxE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,SAAS,CAAY;gBAEjB,IAAI,EAAE,sBAAsB;IAMxC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EACvE,UAAU,SAAI,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAyChC;;;;;;;;;;OAUG;IACG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B1F;;;;;;;;;;OAUG;IACG,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B7F;;;;;;;;;OASG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoB9B;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAUhB;;;;;;;;;OASG;IACG,2BAA2B,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6C/B;;;;;;;;;;;;;;;OAeG;IACG,mCAAmC,CACvC,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAmC/B;;;;;OAKG;YACW,gCAAgC;CA2F/C"}

package/dist/chat/services/chat-message.service.js

@@ -0,0 +1,326 @@
+import { TABLES } from "../../shared/shared.constants";
+import { DynamoDbInstances } from "../../shared/services/dynamodb";
+import { extractS3Key, S3ServiceSingleton } from "../../shared/services/s3";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+// Import constants
+import { buildMessageSK, buildMessagesPK } from "../chat.constants";
+// Import schemas
+import { chatMessageSchema, getMessagesParamsSchema } from "../chat.schemas";
+/**
+ * Service responsible for managing chat messages within sessions.
+ * Handles message CRUD operations and attachment URL generation.
+ * Messages are stored in a dedicated DynamoDB table for optimal performance.
+ *
+ * Responsibilities:
+ * - Message CRUD: getMessages, addMessage, deleteMessage
+ * - Presigned URL generation for attachments
+ * - Message validation and data integrity
+ * - Batch message queries with pagination
+ *
+ * Does NOT handle:
+ * - Session metadata (see ChatSessionService)
+ * - Usage tracking (see ChatUsageService)
+ * - File uploads (see ChatAttachmentService)
+ */
+export class ChatMessageService extends BaseAwsService {
+    constructor(deps) {
+        var _a, _b;
+        super({ logger: deps.logger });
+        this.messagesDb = (_a = deps.messagesDb) !== null && _a !== void 0 ? _a : DynamoDbInstances.getInstance(TABLES.chatMessages);
+        this.s3Service = (_b = deps.s3) !== null && _b !== void 0 ? _b : S3ServiceSingleton.getInstance();
+    }
+    /**
+     * Get messages for a chat session sorted by timestamp with optional pagination.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param sessionId Session ID to get messages for
+     * @param params Optional pagination parameters (limit, lastEvaluatedKey)
+     * @param totalCount Total count of messages in the session (from session metadata)
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to messages response with pagination info
+     * @throws ValidationError if userId or sessionId is invalid
+     *
+     * @example
+     * ```typescript
+     * // Get first 50 messages
+     * const response = await messageService.getMessages(tenantId, userId, sessionId, { limit: 50 }, 150);
+     * console.log(response.messages, response.totalCount);
+     *
+     * // Get next page
+     * const nextPage = await messageService.getMessages(tenantId, userId, sessionId, {
+     *   limit: 50,
+     *   lastEvaluatedKey: response.lastEvaluatedKey
+     * }, 150);
+     * ```
+     */
+    async getMessages(tenantId, userId, sessionId, params, totalCount = 0, options) {
+        const validated = getMessagesParamsSchema.parse({
+            tenantId,
+            userId,
+            sessionId,
+            limit: params === null || params === void 0 ? void 0 : params.limit,
+            lastEvaluatedKey: params === null || params === void 0 ? void 0 : params.lastEvaluatedKey,
+        });
+        // Get messages from messages table with optional pagination
+        const { Items, LastEvaluatedKey } = await this.messagesDb.queryItems(Object.assign(Object.assign({ KeyConditionExpression: "PK = :pk", ExpressionAttributeValues: {
+                ":pk": buildMessagesPK(validated.sessionId),
+            }, ScanIndexForward: true }, (validated.limit ? { Limit: validated.limit } : {})), (validated.lastEvaluatedKey ? { ExclusiveStartKey: validated.lastEvaluatedKey } : {})), { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+        const messages = (Items !== null && Items !== void 0 ? Items : [])
+            .map((item) => chatMessageSchema.safeParse(item))
+            .filter((result) => result.success)
+            .map((result) => result.data);
+        // Generate presigned URLs for attachments so they're accessible
+        const messagesWithPresignedUrls = await this.generatePresignedUrlsForMessages(messages, options);
+        return {
+            messages: messagesWithPresignedUrls,
+            lastEvaluatedKey: LastEvaluatedKey,
+            totalCount,
+        };
+    }
+    /**
+     * Add a new message to the messages table.
+     * NOTE: This only writes to the messages table. Session metadata updates
+     * (messageCount, lastUpdated, usage) must be handled by the caller.
+     *
+     * @param message Complete message object to store
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the stored message (with presigned URLs for attachments)
+     *
+     * @internal Used by ChatService after validation and session checks
+     */
+    async addMessage(message, options) {
+        // Store message in messages table
+        await this.messagesDb.putItem(Object.assign({ PK: buildMessagesPK(message.sessionId), SK: buildMessageSK(message.timestamp, message.id) }, message), { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+        // Generate presigned URLs for attachments before returning
+        if (message.attachments && message.attachments.length > 0) {
+            const presignedAttachments = await this.generatePresignedUrlsForAttachments(message.attachments, options);
+            return Object.assign(Object.assign({}, message), { attachments: presignedAttachments });
+        }
+        return message;
+    }
+    /**
+     * Update an existing message in the messages table.
+     * NOTE: This only writes to the messages table. Session metadata updates
+     * must be handled by the caller.
+     *
+     * @param message Complete message object to store (must have existing timestamp)
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the updated message (with presigned URLs for attachments)
+     *
+     * @internal Used by ChatService after validation and session checks
+     */
+    async updateMessage(message, options) {
+        // Update message in messages table
+        await this.messagesDb.putItem(Object.assign({ PK: buildMessagesPK(message.sessionId), SK: buildMessageSK(message.timestamp, message.id) }, message), { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+        // Generate presigned URLs for attachments before returning
+        if (message.attachments && message.attachments.length > 0) {
+            const presignedAttachments = await this.generatePresignedUrlsForAttachments(message.attachments, options);
+            return Object.assign(Object.assign({}, message), { attachments: presignedAttachments });
+        }
+        return message;
+    }
+    /**
+     * Get a specific message by ID from a session.
+     *
+     * @param sessionId Session ID containing the message
+     * @param messageId Message ID to retrieve
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to the message, or null if not found
+     *
+     * @internal Used by ChatService for message operations
+     */
+    async getMessageById(sessionId, messageId, options) {
+        const { Items } = await this.messagesDb.queryItems({
+            KeyConditionExpression: "PK = :pk",
+            ExpressionAttributeValues: {
+                ":pk": buildMessagesPK(sessionId),
+            },
+        }, { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+        const message = (Items !== null && Items !== void 0 ? Items : [])
+            .map((item) => chatMessageSchema.safeParse(item))
+            .filter((result) => result.success)
+            .map((result) => result.data)
+            .find((m) => m.id === messageId);
+        return message !== null && message !== void 0 ? message : null;
+    }
+    /**
+     * Delete a message from the messages table.
+     * NOTE: This only deletes from the messages table. Session metadata updates
+     * and attachment cleanup must be handled by the caller.
+     *
+     * @param sessionId Session ID containing the message
+     * @param messageId Message ID to delete
+     * @param timestamp Message timestamp (required for sort key)
+     * @param options Optional service options including user credentials
+     *
+     * @internal Used by ChatService after validation and attachment cleanup
+     */
+    async deleteMessage(sessionId, messageId, timestamp, options) {
+        await this.messagesDb.deleteItem({
+            PK: buildMessagesPK(sessionId),
+            SK: buildMessageSK(timestamp, messageId),
+        }, { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+    }
+    /**
+     * Delete all messages for a session.
+     * Returns the list of attachments that need to be deleted from S3.
+     *
+     * @param sessionId Session ID to delete messages for
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to array of attachments to delete
+     *
+     * @internal Used by ChatService during session deletion
+     */
+    async deleteAllMessagesForSession(sessionId, options) {
+        const allMessageKeys = [];
+        const allAttachments = [];
+        let lastEvaluatedKey;
+        do {
+            const { Items, LastEvaluatedKey } = await this.messagesDb.queryItems({
+                KeyConditionExpression: "PK = :pk",
+                ExpressionAttributeValues: {
+                    ":pk": buildMessagesPK(sessionId),
+                },
+                ExclusiveStartKey: lastEvaluatedKey,
+            }, { userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials });
+            if (Items === null || Items === void 0 ? void 0 : Items.length) {
+                // Extract message keys and collect attachments
+                for (const item of Items) {
+                    allMessageKeys.push({
+                        PK: item.PK,
+                        SK: item.SK,
+                    });
+                    // Check if this message has attachments
+                    if (Array.isArray(item.attachments) && item.attachments.length > 0) {
+                        allAttachments.push(...item.attachments);
+                    }
+                }
+            }
+            lastEvaluatedKey = LastEvaluatedKey;
+        } while (lastEvaluatedKey);
+        // Batch delete all messages from messages table
+        if (allMessageKeys.length > 0) {
+            await this.messagesDb.batchWrite(allMessageKeys, "delete", {
+                userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials,
+            });
+        }
+        return allAttachments;
+    }
+    /**
+     * Generate presigned URLs for message attachments.
+     * Replaces direct S3 URLs with presigned URLs that are accessible.
+     *
+     * @param attachments Array of message attachments to generate presigned URLs for
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to attachments with presigned URLs
+     *
+     * @example
+     * ```typescript
+     * const presignedAttachments = await messageService.generatePresignedUrlsForAttachments(
+     *   message.attachments,
+     *   options,
+     * );
+     * ```
+     */
+    async generatePresignedUrlsForAttachments(attachments, options) {
+        if (!attachments || attachments.length === 0) {
+            return [];
+        }
+        const presignedPromises = attachments.map(async (attachment) => {
+            try {
+                const s3Key = extractS3Key(attachment.url);
+                // Generate presigned URL valid for 1 hour
+                const presignedUrl = await this.s3Service.generateSignedUrl({
+                    key: s3Key,
+                    operation: "getObject",
+                    expiresIn: 3600, // 1 hour
+                    userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials,
+                });
+                return Object.assign(Object.assign({}, attachment), { url: presignedUrl });
+            }
+            catch (error) {
+                // If presigned URL generation fails, return original attachment
+                // (will likely fail to load, but better than losing the metadata)
+                this.logger.warn("Failed to generate presigned URL for attachment", {
+                    url: attachment.url,
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+                return attachment;
+            }
+        });
+        return Promise.all(presignedPromises);
+    }
+    /**
+     * Generate presigned URLs for all attachments in messages.
+     * Only generates for recent messages (last 20 or within 24 hours) to optimize performance.
+     *
+     * @private
+     */
+    async generatePresignedUrlsForMessages(messages, options) {
+        if (!messages || messages.length === 0) {
+            return [];
+        }
+        const now = Date.now();
+        const twentyFourHoursAgo = now - 24 * 60 * 60 * 1000;
+        // Only generate presigned URLs for recent messages to optimize performance
+        // Messages older than 24 hours or beyond the last 20 messages will need
+        // to generate presigned URLs on-demand when downloading
+        const messagesToProcess = messages
+            .filter((m) => m.timestamp > twentyFourHoursAgo || messages.indexOf(m) >= messages.length - 20)
+            .filter((m) => m.attachments && m.attachments.length > 0);
+        if (messagesToProcess.length === 0) {
+            return messages;
+        }
+        // Flatten all attachments with their message IDs for batch processing
+        const attachmentsWithMessageIds = messagesToProcess.flatMap((message) => (message.attachments || []).map((attachment) => ({
+            messageId: message.id,
+            attachment,
+        })));
+        // Generate all presigned URLs in parallel (single batch)
+        const presignedAttachmentsWithIds = await Promise.all(attachmentsWithMessageIds.map(async ({ messageId, attachment }) => {
+            try {
+                const s3Key = extractS3Key(attachment.url);
+                // Generate presigned URL valid for 1 hour
+                const presignedUrl = await this.s3Service.generateSignedUrl({
+                    key: s3Key,
+                    operation: "getObject",
+                    expiresIn: 3600, // 1 hour
+                    userCredentials: options === null || options === void 0 ? void 0 : options.userCredentials,
+                });
+                return {
+                    messageId,
+                    attachment: Object.assign(Object.assign({}, attachment), { url: presignedUrl }),
+                };
+            }
+            catch (error) {
+                // If presigned URL generation fails, return original attachment
+                this.logger.warn("Failed to generate presigned URL for attachment", {
+                    url: attachment.url,
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+                return {
+                    messageId,
+                    attachment,
+                };
+            }
+        }));
+        // Group presigned attachments by message ID
+        const attachmentsByMessageId = presignedAttachmentsWithIds.reduce((acc, { messageId, attachment }) => {
+            if (!acc[messageId]) {
+                acc[messageId] = [];
+            }
+            acc[messageId].push(attachment);
+            return acc;
+        }, {});
+        // Replace attachments in original messages array
+        return messages.map((message) => {
+            const presignedAttachments = attachmentsByMessageId[message.id];
+            if (presignedAttachments) {
+                return Object.assign(Object.assign({}, message), { attachments: presignedAttachments });
+            }
+            return message;
+        });
+    }
+}
+//# sourceMappingURL=chat-message.service.js.map

package/dist/chat/services/chat-message.service.js.map

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

package/dist/chat/services/chat-session.service.d.ts

@@ -0,0 +1,188 @@
+import type { ChatGetParams, ChatGetResponse, ChatServiceOptions, ChatSession, ChatSessionServiceDeps } from "../chat.interfaces";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+/**
+ * Service responsible for managing chat session lifecycle and metadata.
+ * Handles session CRUD operations including creation, retrieval, updates, and deletion.
+ * Sessions are stored in a dedicated DynamoDB table for optimal query performance.
+ *
+ * Responsibilities:
+ * - Session CRUD: get, getById, create, update, delete, deleteAll
+ * - Session validation and data integrity checks
+ * - GSI-based queries for efficient session listing
+ * - Batch operations for bulk deletions
+ *
+ * Does NOT handle:
+ * - Message operations (see ChatMessageService)
+ * - Usage tracking (see ChatUsageService)
+ * - Attachment management (see ChatAttachmentService)
+ */
+export declare class ChatSessionService extends BaseAwsService {
+    private sessionsDb;
+    constructor(deps: ChatSessionServiceDeps);
+    /**
+     * Get all chat sessions metadata for a user sorted by lastUpdated in descending order.
+     *
+     * @param tenantId Tenant ID to scope the query
+     * @param userId User ID to get sessions for
+     * @param opts Optional parameters for filtering and pagination
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to sessions array and pagination token
+     * @throws ValidationError if userId is invalid
+     *
+     * @example
+     * ```typescript
+     * const { sessions, lastEvaluatedKey } = await sessionService.get(tenantId, userId, {
+     *   status: 'active',
+     *   limit: 20
+     * }, { userCredentials });
+     * ```
+     */
+    get(tenantId: string, userId: string, opts: ChatGetParams, options?: ChatServiceOptions): Promise<ChatGetResponse>;
+    /**
+     * Get a specific chat session by its ID for a user.
+     * Returns only session metadata without messages.
+     *
+     * @param tenantId Tenant ID to scope the query
+     * @param userId User ID to get session for
+     * @param id ID of the session to get
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to session metadata, or null if not found
+     * @throws ValidationError if userId or sessionId is invalid
+     * @throws SessionIntegrityError if session userId doesn't match
+     *
+     * @example
+     * ```typescript
+     * const session = await sessionService.getById(tenantId, userId, sessionId, { userCredentials });
+     * if (session) {
+     *   console.log(session.title, session.messageCount);
+     * }
+     * ```
+     */
+    getById(tenantId: string, userId: string, id: string, options?: ChatServiceOptions): Promise<ChatSession | null>;
+    /**
+     * Create a new chat session for a user.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param title Optional session title (defaults to "New Chat")
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to created session
+     * @throws ValidationError if userId or title is invalid
+     *
+     * @example
+     * ```typescript
+     * const session = await sessionService.create(tenantId, userId, "My Chat Session", { userCredentials });
+     * console.log(session.id); // UUID
+     * ```
+     */
+    create(tenantId: string, userId: string, title?: string, options?: ChatServiceOptions): Promise<ChatSession>;
+    /**
+     * Update an existing session.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param id ID of the session to update
+     * @param updates Partial session fields to update
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to updated session
+     * @throws ValidationError if userId, sessionId, or updates are invalid
+     * @throws SessionNotFoundError if session doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const updated = await sessionService.update(tenantId, userId, sessionId, {
+     *   title: "Updated Title",
+     *   isArchived: true
+     * }, { userCredentials });
+     * ```
+     */
+    update(tenantId: string, userId: string, id: string, updates: Partial<ChatSession>, options?: ChatServiceOptions): Promise<ChatSession>;
+    /**
+     * Delete a chat session from the sessions table.
+     * NOTE: This only deletes the session metadata. Messages must be deleted separately
+     * by the caller using ChatMessageService.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param id ID of the session to delete
+     * @param options Optional service options including user credentials
+     * @returns Promise that resolves when deletion is complete
+     * @throws ValidationError if userId or sessionId is invalid
+     *
+     * @remarks
+     * This method is idempotent - calling delete on a non-existent session will
+     * succeed without error. This follows the principle that the desired state
+     * (session deleted) is achieved regardless of whether the session existed.
+     *
+     * @example
+     * ```typescript
+     * await sessionService.delete(tenantId, userId, sessionId, { userCredentials });
+     * // Calling again won't throw an error
+     * await sessionService.delete(tenantId, userId, sessionId, { userCredentials }); // Silent success
+     * ```
+     */
+    delete(tenantId: string, userId: string, id: string, options?: ChatServiceOptions): Promise<void>;
+    /**
+     * Delete all chat sessions for a user from the sessions table.
+     * NOTE: This only deletes session metadata. Messages must be deleted separately
+     * by the caller using ChatMessageService.
+     *
+     * @param tenantId Tenant ID to scope the sessions
+     * @param userId User ID whose sessions should be deleted
+     * @param options Optional service options including user credentials
+     * @returns Promise resolving to array of session IDs that were deleted
+     * @throws ValidationError if userId is invalid
+     *
+     * @remarks
+     * This is a destructive operation that cannot be undone. The method:
+     * 1. Queries all session metadata using the GSI to get session IDs
+     * 2. Batch deletes all sessions from DynamoDB (batchWrite handles chunking automatically)
+     * 3. Returns the list of session IDs that were deleted
+     *
+     * This method is idempotent - calling it multiple times will succeed
+     * without error, returning an empty array for subsequent calls.
+     *
+     * @example
+     * ```typescript
+     * const deletedIds = await sessionService.deleteAll(tenantId, userId, { userCredentials });
+     * console.log(`Deleted ${deletedIds.length} sessions`);
+     * ```
+     */
+    deleteAll(tenantId: string, userId: string, options?: ChatServiceOptions): Promise<string[]>;
+    /**
+     * Increment the message count for a session.
+     * Used internally when messages are added.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param sessionId Session ID to update
+     * @param delta Amount to increment (positive) or decrement (negative)
+     * @param options Optional service options including user credentials
+     * @internal
+     */
+    incrementMessageCount(tenantId: string, userId: string, sessionId: string, delta: number, options?: ChatServiceOptions): Promise<void>;
+    /**
+     * Update the session's lastUpdated timestamp and GSI sort key.
+     * Used internally when messages are added or modified.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param sessionId Session ID to update
+     * @param options Optional service options including user credentials
+     * @internal
+     */
+    touchSession(tenantId: string, userId: string, sessionId: string, options?: ChatServiceOptions): Promise<void>;
+    /**
+     * Update aggregated usage statistics for a session.
+     * Used internally by ChatUsageService.
+     *
+     * @param tenantId Tenant ID to scope the session
+     * @param userId User ID who owns the session
+     * @param sessionId Session ID to update
+     * @param aggregatedUsage Usage statistics to store
+     * @param options Optional service options including user credentials
+     * @internal
+     */
+    updateAggregatedUsage(tenantId: string, userId: string, sessionId: string, aggregatedUsage: ChatSession["aggregatedUsage"], options?: ChatServiceOptions): Promise<void>;
+}
+//# sourceMappingURL=chat-session.service.d.ts.map