captify 0.1.15

package/dist/chat/chat.schemas.js

@@ -0,0 +1,909 @@
+import { z } from "zod";
+import { MAX_MULTIPART_PARTS } from "../files/files.constants";
+import { createOptionalStringSchema, createRequiredStringSchema, } from "../shared/shared.schemas";
+import { baseFileUploadParamsSchema, baseSessionParamsSchema, baseUserParamsSchema, createPaginationLimitSchema, sessionIdSchema, userIdSchema, } from "../shared/services";
+import { CHAT_ERROR_MESSAGES, CHAT_LIMITS } from "./chat.constants";
+/**
+ * Message role values matching UIMessage["role"] from ai sdk
+ */
+const messageRoles = [
+    "user",
+    "assistant",
+    "system",
+];
+/**
+ * Message role schema - validates role matches UIMessage["role"]
+ */
+export const messageRoleSchema = z.enum(messageRoles);
+/**
+ * Sanitizes text input by removing control characters and normalizing whitespace
+ * Preserves tab, newline, and carriage return characters
+ */
+function sanitizeText(text) {
+    return text
+        .trim()
+        .replace(/[\u0000-\u0008\u000B-\u000C\u000E-\u001F\u007F-\u009F\u200B-\u200D\uFEFF]/g, "")
+        .trim();
+}
+// ============================================================================
+// Chat-Specific ID Schemas
+// ============================================================================
+/**
+ * Message ID schema - validates message identifiers.
+ *
+ * @description Validates unique message identifiers within a chat session.
+ *
+ * @constraints
+ * - Required: Cannot be empty
+ *
+ * @example
+ * messageIdSchema.parse("msg_001"); // Valid
+ */
+export const messageIdSchema = z
+    .string()
+    .trim()
+    .min(1, CHAT_ERROR_MESSAGES.MESSAGE_ID_REQUIRED)
+    .describe("Unique identifier for a chat message");
+/**
+ * Provider ID schema - validates LLM provider identifier in chat context.
+ *
+ * @description Validates the provider ID that identifies which LLM provider
+ * (e.g., OpenAI, Anthropic) was used for a message.
+ *
+ * @constraints
+ * - Required: Cannot be empty
+ * - Max length: 50 characters
+ * - Invalid chars: '#' (DynamoDB key delimiter)
+ *
+ * @example
+ * providerIdSchema.parse("openai"); // Valid
+ */
+export const providerIdSchema = z
+    .string()
+    .trim()
+    .min(1, CHAT_ERROR_MESSAGES.PROVIDER_ID_REQUIRED)
+    .max(50, CHAT_ERROR_MESSAGES.PROVIDER_ID_TOO_LONG)
+    .refine((val) => !val.includes("#"), {
+    error: CHAT_ERROR_MESSAGES.PROVIDER_ID_INVALID_CHARS,
+})
+    .describe("Identifier for the LLM provider");
+/**
+ * Model ID schema - validates LLM model identifier in chat context.
+ *
+ * @description Validates the model ID that identifies which specific model
+ * (e.g., gpt-4, claude-3-opus) was used for a message.
+ *
+ * @constraints
+ * - Required: Cannot be empty
+ * - Max length: 500 characters
+ * - Invalid chars: '#' (DynamoDB key delimiter)
+ *
+ * @example
+ * modelIdSchema.parse("gpt-4-turbo"); // Valid
+ */
+export const modelIdSchema = z
+    .string()
+    .trim()
+    .min(1, CHAT_ERROR_MESSAGES.MODEL_ID_REQUIRED)
+    .max(500, CHAT_ERROR_MESSAGES.MODEL_ID_TOO_LONG)
+    .refine((val) => !val.includes("#"), {
+    error: CHAT_ERROR_MESSAGES.MODEL_ID_INVALID_CHARS,
+})
+    .describe("Identifier for the LLM model");
+// ============================================================================
+// Content Schemas (with sanitization)
+// ============================================================================
+/**
+ * Title schema - validates and sanitizes session titles
+ */
+export const titleSchema = createRequiredStringSchema({
+    requiredMessage: CHAT_ERROR_MESSAGES.TITLE_REQUIRED,
+    maxLength: CHAT_LIMITS.MAX_TITLE_LENGTH,
+    maxLengthMessage: CHAT_ERROR_MESSAGES.TITLE_TOO_LONG,
+    sanitize: sanitizeText,
+});
+/**
+ * Message content schema - validates and sanitizes message content
+ */
+export const contentSchema = createRequiredStringSchema({
+    requiredMessage: CHAT_ERROR_MESSAGES.MESSAGE_CONTENT_REQUIRED,
+    maxLength: CHAT_LIMITS.MAX_MESSAGE_CONTENT_LENGTH,
+    maxLengthMessage: CHAT_ERROR_MESSAGES.MESSAGE_CONTENT_TOO_LONG,
+    sanitize: sanitizeText,
+});
+/**
+ * Reasoning schema - optional, validates and sanitizes AI reasoning text
+ */
+export const reasoningSchema = createOptionalStringSchema({
+    maxLength: CHAT_LIMITS.MAX_REASONING_LENGTH,
+    maxLengthMessage: CHAT_ERROR_MESSAGES.MESSAGE_REASONING_TOO_LONG,
+    sanitize: sanitizeText,
+});
+// ============================================================================
+// Pagination Schema
+// ============================================================================
+/**
+ * Default session pagination limit schema
+ */
+export const sessionLimitSchema = createPaginationLimitSchema({
+    defaultLimit: CHAT_LIMITS.DEFAULT_SESSION_LIMIT,
+    maxLimit: CHAT_LIMITS.MAX_SESSION_LIMIT,
+});
+// ============================================================================
+// Multipart Upload Schemas
+// ============================================================================
+/**
+ * Part number schema for multipart uploads.
+ *
+ * @description Validates part numbers for S3 multipart uploads.
+ * S3 requires part numbers to be integers between 1 and 10,000.
+ */
+export const partNumberSchema = z
+    .number()
+    .int("Part number must be an integer")
+    .min(1, "Part number must be at least 1")
+    .max(MAX_MULTIPART_PARTS, `Part number must not exceed ${MAX_MULTIPART_PARTS}`)
+    .describe("Multipart upload part number (1-10000)");
+// ============================================================================
+// Base Parameter Schemas (imported from shared)
+// ============================================================================
+// The base param schemas (baseUserParamsSchema, baseSessionParamsSchema,
+// baseFileUploadParamsSchema) are imported from ../shared/services/schemas
+// and used directly in the method parameter schemas below.
+// ============================================================================
+// Method Parameter Schemas
+// ============================================================================
+/**
+ * Schema for get() method - list sessions.
+ *
+ * @description Retrieves a paginated list of chat sessions for a user.
+ * Supports filtering by status (active/archived) and pagination via lastEvaluatedKey.
+ *
+ * @see ChatService.get
+ */
+export const getSessionsParamsSchema = baseUserParamsSchema
+    .extend({
+    status: z
+        .enum(["active", "archived"], {
+        error: "Status must be either 'active' or 'archived'",
+    })
+        .optional()
+        .describe("Filter sessions by archive status"),
+    limit: sessionLimitSchema.describe("Maximum number of sessions to return"),
+    lastEvaluatedKey: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("DynamoDB pagination cursor"),
+})
+    .describe("Parameters for listing chat sessions");
+/**
+ * Schema for getById() method - get a single session.
+ *
+ * @description Retrieves a specific chat session by its ID.
+ * Returns the session metadata without messages.
+ *
+ * @see ChatService.getById
+ */
+export const getSessionByIdParamsSchema = baseSessionParamsSchema.describe("Parameters for retrieving a chat session by ID");
+/**
+ * Schema for create() method - create a new session.
+ *
+ * @description Creates a new chat session for the user.
+ * If no title is provided, defaults to "New Chat".
+ *
+ * @see ChatService.create
+ */
+export const createSessionParamsSchema = baseUserParamsSchema
+    .extend({
+    title: titleSchema
+        .optional()
+        .default("New Chat")
+        .describe("Session title (defaults to 'New Chat')"),
+})
+    .describe("Parameters for creating a new chat session");
+/**
+ * Schema for update() method - update session properties.
+ *
+ * @description Updates mutable properties of a chat session.
+ * Supports updating title and archive status.
+ *
+ * @note isArchived accepts boolean for API convenience but is stored as 0|1 in DynamoDB
+ *
+ * @see ChatService.update
+ */
+export const updateSessionParamsSchema = baseSessionParamsSchema
+    .extend({
+    updates: z
+        .object({
+        title: titleSchema.optional().describe("New session title"),
+        isArchived: z.boolean().optional().describe("Archive status"),
+    })
+        .describe("Fields to update"),
+})
+    .describe("Parameters for updating a chat session");
+/**
+ * Schema for delete() method - delete a single session.
+ *
+ * @description Permanently deletes a chat session and all its messages.
+ * This operation cannot be undone.
+ *
+ * @see ChatService.delete
+ */
+export const deleteSessionParamsSchema = baseSessionParamsSchema.describe("Parameters for deleting a chat session");
+/**
+ * Schema for deleteAll() method - delete all user sessions.
+ *
+ * @description Permanently deletes all chat sessions for a user.
+ * This is a destructive operation and cannot be undone.
+ *
+ * @see ChatService.deleteAll
+ */
+export const deleteAllSessionsParamsSchema = baseUserParamsSchema.describe("Parameters for deleting all chat sessions for a user");
+/**
+ * Schema for getMessages() method - get session messages.
+ *
+ * @description Retrieves messages in a chat session with optional pagination.
+ * Messages are returned in chronological order.
+ *
+ * @see ChatService.getMessages
+ */
+export const getMessagesParamsSchema = baseSessionParamsSchema
+    .extend({
+    limit: z
+        .number()
+        .int("Limit must be an integer")
+        .min(1, "Limit must be at least 1")
+        .max(1000, "Limit cannot exceed 1000")
+        .optional()
+        .describe("Maximum number of messages to return (default: all)"),
+    lastEvaluatedKey: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe("DynamoDB pagination cursor from previous request"),
+})
+    .describe("Parameters for retrieving chat messages");
+/**
+ * Source reference schema for message sources.
+ *
+ * @description Represents a citation or reference that accompanies an AI response.
+ * Sources are typically web search results or document references.
+ */
+export const sourceSchema = z
+    .object({
+    title: z.string().describe("Display title of the source"),
+    href: z
+        .url({ error: "Source href must be a valid URL" })
+        .describe("URL to the source document"),
+})
+    .describe("Citation or reference for AI response content");
+/**
+ * Message attachment schema.
+ *
+ * @description Represents a file attached to a chat message.
+ * Attachments are stored in S3 and referenced by URL.
+ */
+export const attachmentSchema = z
+    .object({
+    filename: z.string().optional().describe("Original filename"),
+    mediaType: z.string().describe("MIME type of the file"),
+    url: z.url().describe("S3 URL to the attachment"),
+    size: z
+        .int("File size must be an integer")
+        .nonnegative("File size must be non-negative")
+        .describe("File size in bytes"),
+    timestamp: z
+        .int("Timestamp must be an integer")
+        .positive("Timestamp must be a positive number")
+        .describe("Upload timestamp (Unix ms)"),
+})
+    .describe("File attachment for a chat message");
+/**
+ * Schema for addMessage() method - add a message to a session.
+ *
+ * @description Adds a new message to a chat session. This can be a user message
+ * or an AI assistant response. For assistant responses, optional metadata like
+ * reasoning, sources, and token usage can be included.
+ *
+ * @note sdkUsage accepts LanguageModelUsage from AI SDK directly without validation
+ * to maintain compatibility with the Vercel AI SDK types.
+ *
+ * @see ChatService.addMessage
+ */
+export const addMessageParamsSchema = baseSessionParamsSchema
+    .extend({
+    content: contentSchema.describe("Message content text"),
+    providerId: providerIdSchema.describe("LLM provider that generated this message"),
+    modelId: modelIdSchema.describe("LLM model that generated this message"),
+    role: messageRoleSchema.describe("Message role (user/assistant/system)"),
+    reasoning: reasoningSchema.optional().describe("AI reasoning chain (for assistant messages)"),
+    reasoningDuration: z
+        .number()
+        .transform((val) => Math.round(val))
+        .pipe(z
+        .int("Reasoning duration must be an integer")
+        .nonnegative("Reasoning duration must be non-negative"))
+        .optional()
+        .describe("Time spent on reasoning (ms)"),
+    sources: z.array(sourceSchema).optional().describe("Citations for the response"),
+    attachments: z.array(attachmentSchema).optional().describe("File attachments"),
+    messageId: messageIdSchema.optional().describe("Optional custom message ID"),
+    sdkUsage: z.custom().optional().describe("Token usage from AI SDK"),
+})
+    .describe("Parameters for adding a message to a chat session");
+/**
+ * Schema for deleteMessage() method - delete a single message.
+ *
+ * @description Permanently deletes a message from a chat session.
+ * This also removes any associated attachments from S3.
+ *
+ * @see ChatService.deleteMessage
+ */
+export const deleteMessageParamsSchema = baseSessionParamsSchema
+    .extend({
+    messageId: messageIdSchema.describe("ID of the message to delete"),
+})
+    .describe("Parameters for deleting a chat message");
+/**
+ * Schema for getUsage() method - get session token usage.
+ *
+ * @description Retrieves aggregated token usage and cost statistics
+ * for all messages in a chat session.
+ *
+ * @see ChatService.getUsage
+ */
+export const getUsageParamsSchema = baseSessionParamsSchema.describe("Parameters for retrieving chat session usage statistics");
+/**
+ * Schema for uploadMessageAttachments() method.
+ *
+ * @description Parameters for uploading attachments to a chat session.
+ * Used internally by the attachment upload flow.
+ *
+ * @note Does not include tenantId as attachments are uploaded before tenant context is established.
+ */
+export const uploadAttachmentsParamsSchema = z
+    .object({
+    userId: userIdSchema.describe("User uploading the attachment"),
+    sessionId: sessionIdSchema.describe("Session to attach file to"),
+})
+    .describe("Parameters for uploading message attachments");
+// ============================================================================
+// DynamoDB Data Validation Schemas
+// ============================================================================
+/**
+ * Token usage schema for message usage tracking.
+ *
+ * @description Tracks token consumption and estimated cost for a single message.
+ * Used to calculate session-level usage aggregations.
+ */
+export const tokenUsageSchema = z
+    .object({
+    promptTokens: z
+        .int("Prompt tokens must be an integer")
+        .nonnegative("Prompt tokens must be non-negative")
+        .describe("Input tokens consumed"),
+    completionTokens: z
+        .int("Completion tokens must be an integer")
+        .nonnegative("Completion tokens must be non-negative")
+        .describe("Output tokens generated"),
+    totalTokens: z
+        .int("Total tokens must be an integer")
+        .nonnegative("Total tokens must be non-negative")
+        .describe("Total tokens (prompt + completion)"),
+    reasoningTokens: z
+        .int("Reasoning tokens must be an integer")
+        .nonnegative("Reasoning tokens must be non-negative")
+        .describe("Tokens used for reasoning"),
+    estimatedCost: z
+        .number()
+        .nonnegative("Estimated cost must be non-negative")
+        .describe("Estimated cost in USD"),
+    calculatedAt: z
+        .int("Calculated at timestamp must be an integer")
+        .positive("Calculated at timestamp must be a positive number")
+        .describe("Calculation timestamp (Unix ms)"),
+})
+    .describe("Token usage and cost tracking for a message");
+/**
+ * Message version schema.
+ *
+ * @description Represents a version of a message's content.
+ * Supports message editing by maintaining version history.
+ */
+export const messageVersionSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1, "Version ID is required and cannot be empty")
+        .describe("Version identifier"),
+    content: z.string().describe("Message content for this version"),
+})
+    .describe("Version entry for message content history");
+/**
+ * Reasoning schema for stored messages.
+ *
+ * @description Contains the AI's reasoning/thinking process and timing.
+ * Used for chain-of-thought explanations.
+ */
+export const storedReasoningSchema = z
+    .object({
+    content: z.string().describe("Reasoning text content"),
+    duration: z
+        .int("Reasoning duration must be an integer")
+        .nonnegative("Reasoning duration must be non-negative")
+        .describe("Time spent reasoning (ms)"),
+})
+    .describe("AI reasoning metadata for a message");
+/**
+ * Schema for validating ChatMessage data from DynamoDB.
+ *
+ * @description Validates the structure of chat messages retrieved from DynamoDB.
+ * Used to filter out malformed or corrupted records during query operations.
+ *
+ * @note This schema is intentionally more permissive than input schemas to handle
+ * legacy data that may not conform to current validation rules.
+ */
+export const chatMessageSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1, "Message ID is required and cannot be empty")
+        .describe("Unique message identifier"),
+    sessionId: z
+        .string()
+        .min(1, "Session ID is required and cannot be empty")
+        .describe("Parent session ID"),
+    tenantId: z
+        .string()
+        .min(1, "Tenant ID is required and cannot be empty")
+        .describe("Tenant ID for multi-tenant isolation"),
+    userId: z
+        .string()
+        .min(1, "User ID is required and cannot be empty")
+        .describe("User ID for access control"),
+    timestamp: z
+        .int("Timestamp must be an integer")
+        .positive("Timestamp must be a positive number")
+        .describe("Message creation timestamp (Unix ms)"),
+    role: messageRoleSchema.describe("Message author role"),
+    providerId: z
+        .string()
+        .min(1, "Provider ID is required and cannot be empty")
+        .describe("LLM provider used"),
+    modelId: z
+        .string()
+        .min(1, "Model ID is required and cannot be empty")
+        .describe("LLM model used"),
+    reasoning: storedReasoningSchema.optional().describe("AI reasoning metadata"),
+    sources: z
+        .array(z.object({
+        title: z.string().describe("Source title"),
+        href: z.string().describe("Source URL"),
+    }))
+        .optional()
+        .describe("Citation sources for AI response"),
+    versions: z
+        .array(messageVersionSchema)
+        .min(1, "At least one message version is required")
+        .describe("Message content versions"),
+    usage: tokenUsageSchema.optional().describe("Token usage for this message"),
+    attachments: z
+        .array(z.object({
+        filename: z.string().optional().describe("Original filename"),
+        mediaType: z.string().describe("MIME type"),
+        url: z.string().describe("S3 URL"),
+        size: z
+            .int("File size must be an integer")
+            .nonnegative("File size must be non-negative")
+            .describe("File size in bytes"),
+        timestamp: z
+            .int("Timestamp must be an integer")
+            .positive("Timestamp must be a positive number")
+            .describe("Upload timestamp"),
+    }))
+        .optional()
+        .describe("File attachments"),
+})
+    .strip()
+    .describe("Chat message stored in DynamoDB");
+/**
+ * Schema for validating ChatSession data from DynamoDB.
+ *
+ * @description Validates the structure of chat sessions retrieved from DynamoDB.
+ * Used to filter out malformed or corrupted records during query operations.
+ */
+export const chatSessionSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1, "Session ID is required and cannot be empty")
+        .describe("Unique session identifier"),
+    userId: z.string().min(1, "User ID is required and cannot be empty").describe("Owner user ID"),
+    title: z
+        .string()
+        .min(1, "Session title is required and cannot be empty")
+        .describe("Session display title"),
+    lastUpdated: z
+        .int("Last updated timestamp must be an integer")
+        .positive("Last updated timestamp must be a positive number")
+        .describe("Last modification timestamp (Unix ms)"),
+    isArchived: z.boolean().describe("Archive status"),
+    messageCount: z
+        .int("Message count must be an integer")
+        .nonnegative("Message count must be non-negative")
+        .describe("Number of messages in session"),
+    aggregatedUsage: z
+        .object({
+        totalPromptTokens: z
+            .int("Total prompt tokens must be an integer")
+            .nonnegative("Total prompt tokens must be non-negative")
+            .describe("Sum of prompt tokens"),
+        totalCompletionTokens: z
+            .int("Total completion tokens must be an integer")
+            .nonnegative("Total completion tokens must be non-negative")
+            .describe("Sum of completion tokens"),
+        totalReasoningTokens: z
+            .int("Total reasoning tokens must be an integer")
+            .nonnegative("Total reasoning tokens must be non-negative")
+            .describe("Sum of reasoning tokens"),
+        totalTokens: z
+            .int("Total tokens must be an integer")
+            .nonnegative("Total tokens must be non-negative")
+            .describe("Total tokens across all messages"),
+        totalCost: z
+            .number()
+            .nonnegative("Total cost must be non-negative")
+            .describe("Estimated total cost in USD"),
+        messageCount: z
+            .int("Message count must be an integer")
+            .nonnegative("Message count must be non-negative")
+            .describe("Number of messages"),
+        lastCalculated: z
+            .int("Last calculated timestamp must be an integer")
+            .positive("Last calculated timestamp must be a positive number")
+            .describe("Last aggregation timestamp"),
+    })
+        .optional()
+        .describe("Aggregated token usage statistics"),
+})
+    .strip()
+    .describe("Chat session stored in DynamoDB");
+// ============================================================================
+// File Operation Schemas
+// ============================================================================
+/**
+ * Schema for getSessionFiles() method - list files in a session.
+ *
+ * @description Retrieves all file attachments associated with a chat session.
+ *
+ * @see ChatService.getSessionFiles
+ */
+export const getSessionFilesParamsSchema = baseSessionParamsSchema.describe("Parameters for listing session files");
+/**
+ * Schema for getFileDownloadUrl() method - get presigned download URL.
+ *
+ * @description Generates a presigned S3 URL for downloading a file attachment.
+ *
+ * @see ChatService.getFileDownloadUrl
+ */
+export const getFileDownloadUrlParamsSchema = baseSessionParamsSchema
+    .extend({
+    fileUrl: z
+        .url()
+        .min(1, "File URL is required and cannot be empty")
+        .describe("S3 URL of the file to download"),
+})
+    .describe("Parameters for generating file download URL");
+/**
+ * Schema for deleteTempFile() method - delete a temporary file.
+ *
+ * @description Deletes a temporary file from S3 that was uploaded but not attached.
+ *
+ * @see ChatService.deleteTempFile
+ */
+export const deleteTempFileParamsSchema = baseSessionParamsSchema
+    .extend({
+    messageId: z
+        .string()
+        .min(1, "Message ID is required and cannot be empty")
+        .describe("Associated message ID"),
+    fileUrl: z
+        .url()
+        .min(1, "File URL is required and cannot be empty")
+        .describe("S3 URL of the file to delete"),
+})
+    .describe("Parameters for deleting a temporary file");
+// baseFileUploadParamsSchema is imported from shared schemas
+/**
+ * Schema for getPresignedUploadUrl() method - get presigned upload URL.
+ *
+ * @description Generates a presigned S3 URL for uploading a small file (single-part upload).
+ * For large files, use initiateMultipartUpload instead.
+ *
+ * @see ChatService.getPresignedUploadUrl
+ */
+export const getPresignedUploadUrlParamsSchema = baseFileUploadParamsSchema.describe("Parameters for generating presigned upload URL");
+/**
+ * Schema for initiateMultipartUpload() method - start multipart upload.
+ *
+ * @description Initiates a multipart upload for large files.
+ * Returns an uploadId used to upload parts and complete the upload.
+ *
+ * @see ChatService.initiateMultipartUpload
+ */
+export const initiateMultipartUploadParamsSchema = baseFileUploadParamsSchema.describe("Parameters for initiating multipart upload");
+/**
+ * Schema for getMultipartPartUrl() method - get URL for uploading a part.
+ *
+ * @description Generates a presigned URL for uploading a single part of a multipart upload.
+ *
+ * @note partNumber must be between 1 and 10000 (S3 limit)
+ *
+ * @see ChatService.getMultipartPartUrl
+ */
+export const getMultipartPartUrlParamsSchema = baseSessionParamsSchema
+    .extend({
+    key: z.string().min(1, "Key is required and cannot be empty").describe("S3 object key"),
+    uploadId: z
+        .string()
+        .min(1, "Upload ID is required and cannot be empty")
+        .describe("Multipart upload ID"),
+    partNumber: partNumberSchema,
+})
+    .describe("Parameters for getting multipart part upload URL");
+/**
+ * Uploaded part schema.
+ *
+ * @description Represents a successfully uploaded part of a multipart upload.
+ * Used when completing the multipart upload.
+ */
+export const uploadedPartSchema = z
+    .object({
+    partNumber: partNumberSchema,
+    etag: z
+        .string()
+        .min(1, "ETag is required and cannot be empty")
+        .describe("ETag returned by S3 after part upload"),
+})
+    .describe("Completed multipart upload part");
+/**
+ * Schema for completeMultipartUpload() method - finalize multipart upload.
+ *
+ * @description Completes a multipart upload by combining all uploaded parts.
+ * All parts must be uploaded before calling this method.
+ *
+ * @see ChatService.completeMultipartUpload
+ */
+export const completeMultipartUploadParamsSchema = baseSessionParamsSchema
+    .extend({
+    key: z.string().min(1, "Key is required and cannot be empty").describe("S3 object key"),
+    uploadId: z
+        .string()
+        .min(1, "Upload ID is required and cannot be empty")
+        .describe("Multipart upload ID"),
+    fileName: z
+        .string()
+        .min(1, "File name is required and cannot be empty")
+        .describe("Original filename"),
+    fileSize: z
+        .int("File size must be an integer")
+        .positive("File size must be a positive number")
+        .describe("Total file size"),
+    contentType: z
+        .string()
+        .min(1, "Content type is required and cannot be empty")
+        .describe("MIME type"),
+    parts: z
+        .array(uploadedPartSchema)
+        .min(1, "At least one part is required")
+        .describe("List of uploaded parts"),
+})
+    .describe("Parameters for completing multipart upload");
+/**
+ * Schema for abortMultipartUpload() method - cancel multipart upload.
+ *
+ * @description Aborts a multipart upload and cleans up any uploaded parts.
+ * Should be called if the upload cannot be completed.
+ *
+ * @see ChatService.abortMultipartUpload
+ */
+export const abortMultipartUploadParamsSchema = baseSessionParamsSchema
+    .extend({
+    key: z.string().min(1, "Key is required and cannot be empty").describe("S3 object key"),
+    uploadId: z
+        .string()
+        .min(1, "Upload ID is required and cannot be empty")
+        .describe("Multipart upload ID to abort"),
+})
+    .describe("Parameters for aborting multipart upload");
+// ============================================================================
+// API Request/Response Schemas (from lib/api/chats/schema.ts)
+// ============================================================================
+/**
+ * Schema for GET /api/chats query parameters
+ */
+export const listChatsQuerySchema = z.object({
+    status: z
+        .enum(["active", "archived"], {
+        error: "Status must be either 'active' or 'archived'",
+    })
+        .optional()
+        .default("active"),
+    limit: z
+        .string()
+        .optional()
+        .transform((val) => (val ? parseInt(val, 10) : 50))
+        .pipe(z
+        .int("Limit must be an integer")
+        .positive("Limit must be a positive number")
+        .max(100, "Limit cannot exceed 100")),
+    lastEvaluatedKey: z
+        .string()
+        .optional()
+        .transform((val) => {
+        if (!val)
+            return undefined;
+        try {
+            return JSON.parse(val);
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }),
+});
+/**
+ * Schema for GET /api/chats/:id/files/download query parameters
+ */
+export const downloadFileQuerySchema = z.object({
+    fileUrl: z.url().min(1, "fileUrl query parameter is required and cannot be empty"),
+});
+/**
+ * Schema for POST /api/chats body
+ */
+export const createChatBodySchema = z.object({
+    title: z
+        .string()
+        .min(1, "Chat title cannot be empty")
+        .max(200, "Chat title cannot exceed 200 characters")
+        .optional(),
+});
+/**
+ * Schema for PATCH /api/chats/:id body
+ */
+export const updateChatBodySchema = z.object({
+    title: z
+        .string()
+        .min(1, "Chat title cannot be empty")
+        .max(200, "Chat title cannot exceed 200 characters")
+        .optional(),
+    isArchived: z.boolean().optional(),
+});
+/**
+ * Schema for DELETE /api/chats/:id/files body
+ */
+export const deleteFileBodySchema = z.object({
+    messageId: z.string().min(1, "Message ID is required and cannot be empty"),
+    fileUrl: z.url({ error: "File URL must be a valid URL" }),
+});
+/**
+ * Schema for POST /api/chats/:id/files/upload-url body
+ */
+export const getUploadUrlBodySchema = z.object({
+    fileName: z.string().min(1, "File name is required and cannot be empty"),
+    fileSize: z.int("File size must be an integer").positive("File size must be a positive number"),
+    contentType: z.string().min(1, "Content type is required and cannot be empty"),
+});
+/**
+ * Schema for POST /api/chats/:id/files/multipart-init body
+ */
+export const initiateMultipartBodySchema = z.object({
+    fileName: z.string().min(1, "File name is required and cannot be empty"),
+    fileSize: z.int("File size must be an integer").positive("File size must be a positive number"),
+    contentType: z.string().min(1, "Content type is required and cannot be empty"),
+});
+/**
+ * Schema for POST /api/chats/:id/files/multipart-part-url body
+ */
+export const getPartUrlBodySchema = z.object({
+    key: z.string().min(1, "Key is required and cannot be empty"),
+    uploadId: z.string().min(1, "Upload ID is required and cannot be empty"),
+    partNumber: z.int("Part number must be an integer").min(1, "Part number must be at least 1"),
+});
+/**
+ * API uploaded part schema (simpler than service-layer version)
+ */
+export const apiUploadedPartSchema = z.object({
+    partNumber: z.int("Part number must be an integer").min(1, "Part number must be at least 1"),
+    etag: z.string().min(1, "ETag is required and cannot be empty"),
+});
+/**
+ * Schema for POST /api/chats/:id/files/multipart-complete body
+ */
+export const completeMultipartBodySchema = z.object({
+    key: z.string().min(1, "Key is required and cannot be empty"),
+    uploadId: z.string().min(1, "Upload ID is required and cannot be empty"),
+    fileName: z.string().min(1, "File name is required and cannot be empty"),
+    fileSize: z.int("File size must be an integer").positive("File size must be a positive number"),
+    contentType: z.string().min(1, "Content type is required and cannot be empty"),
+    parts: z.array(apiUploadedPartSchema).min(1, "At least one part is required"),
+});
+/**
+ * Schema for POST /api/chats/:id/files/multipart-abort body
+ */
+export const abortMultipartBodySchema = z.object({
+    key: z.string().min(1, "Key is required and cannot be empty"),
+    uploadId: z.string().min(1, "Upload ID is required and cannot be empty"),
+});
+// ============================================================================
+// Message API Schemas (from lib/chat/api/messages/schema.ts)
+// ============================================================================
+/**
+ * Schema for UI message parts - using loose to allow all valid AI SDK parts
+ */
+export const messagePartSchema = z
+    .object({
+    type: z.string(),
+})
+    .loose();
+/**
+ * Schema for UI message - loosely validated to allow AI SDK's UIMessage type
+ */
+export const uiMessageSchema = z
+    .object({
+    id: z.string(),
+    role: z.enum(["user", "assistant", "system"], {
+        error: "Message role must be one of: user, assistant, or system",
+    }),
+    parts: z.array(messagePartSchema),
+})
+    .loose();
+/**
+ * Extract text content from a user message's parts
+ */
+function extractUserMessageText(message) {
+    return message.parts
+        .flatMap((part) => (part.type === "text" && "text" in part ? [part.text] : []))
+        .join("");
+}
+/**
+ * Schema for POST /api/chats/:id/messages body
+ */
+export const createMessageBodySchema = z
+    .object({
+    messages: z.array(uiMessageSchema).min(1, "At least one message is required"),
+    trigger: z
+        .enum(["submit-message", "regenerate-message"], {
+        error: "Trigger must be either 'submit-message' or 'regenerate-message'",
+    })
+        .optional()
+        .default("submit-message"),
+    webSearch: z.boolean().optional().default(false),
+    providerId: z.string().min(1, "Provider ID is required and cannot be empty"),
+    modelId: z.string().min(1, "Model ID is required and cannot be empty"),
+})
+    .transform((data) => {
+    const lastUserMessage = data.messages
+        .slice()
+        .reverse()
+        .find((msg) => msg.role === "user");
+    if (!lastUserMessage) {
+        throw new z.ZodError([
+            {
+                code: "custom",
+                message: "User message is required",
+                path: ["messages"],
+            },
+        ]);
+    }
+    const userMessageText = extractUserMessageText(lastUserMessage);
+    if (!userMessageText.trim()) {
+        throw new z.ZodError([
+            {
+                code: "custom",
+                message: "Message text is required",
+                path: ["messages"],
+            },
+        ]);
+    }
+    return Object.assign(Object.assign({}, data), { messages: data.messages, lastUserMessage: lastUserMessage, userMessageText });
+});
+//# sourceMappingURL=chat.schemas.js.map