django-cfg 1.4.48__py3-none-any.whl → 1.5.7__py3-none-any.whl

django_cfg/static/js/api/types.mjs

@@ -8,133 +8,262 @@
 // These types can be used for better IDE support and documentation
 
 /**
- * @typedef {Object} APIKeyCreate * @description API key creation serializer with service integration.
+ * @typedef {Object} APIResponse * @description Standard API response serializer. * @property {boolean} success - Operation success status * @property {string} [message] - Success message * @property {string} [error] - Error message * @property {Record<string, any>} [data] - Response data */
 
-Creates new API keys and returns the full key value (only once). * @property {string} name - Descriptive name for the API key * @property {number} [expires_in_days] - Expiration in days (optional, null for no expiration) */
+/**
+ * @typedef {Object} APIResponseRequest * @description Standard API response serializer. * @property {boolean} success - Operation success status * @property {string} [message] - Success message * @property {string} [error] - Error message * @property {Record<string, any>} [data] - Response data */
 
 /**
- * @typedef {Object} APIKeyCreateRequest * @description API key creation serializer with service integration.
+ * @typedef {Object} ArchiveItem * @description Archive item serializer. * @property {string} id * @property {string} relative_path - Path within archive * @property {string} item_name - Item name * @property {string} item_type - MIME type * @property {"document" | "code" | "image" | "data" | "archive" | "unknown"} content_type - Content classification
 
-Creates new API keys and returns the full key value (only once). * @property {string} name - Descriptive name for the API key * @property {number} [expires_in_days] - Expiration in days (optional, null for no expiration) */
+* `document` - Document
+* `code` - Code
+* `image` - Image
+* `data` - Data
+* `archive` - Archive
+* `unknown` - Unknown * @property {number} [file_size] - Item size in bytes * @property {boolean} is_processable - Whether item can be processed for chunks * @property {string} language - Programming language or document language * @property {string} encoding - Character encoding * @property {number} chunks_count - Number of chunks created * @property {number} total_tokens - Total tokens in all chunks * @property {number} processing_cost - Processing cost for this item * @property {string} created_at * @property {string} updated_at */
 
 /**
- * @typedef {Object} APIKeyDetail * @description Complete API key serializer with full details.
+ * @typedef {Object} ArchiveItemChunk * @description Archive item chunk serializer. * @property {string} id * @property {string} content - Chunk text content * @property {number} chunk_index - Sequential chunk number within item * @property {"text" | "code" | "heading" | "metadata" | "table" | "list"} [chunk_type] - Type of content in chunk
 
-Used for API key detail views (no key value for security). * @property {string} id - Unique identifier for this record * @property {string} user * @property {string} name - Human-readable name for this API key * @property {string} key_preview * @property {boolean} is_active - Whether this API key is active * @property {boolean} is_expired * @property {boolean} is_valid * @property {number} days_until_expiry * @property {number} total_requests - Total number of requests made with this key * @property {string} last_used_at - When this API key was last used * @property {string} expires_at - When this API key expires (null = never expires) * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
+* `text` - Text
+* `code` - Code
+* `heading` - Heading
+* `metadata` - Metadata
+* `table` - Table
+* `list` - List * @property {number} token_count - Number of tokens in chunk * @property {number} character_count - Number of characters in chunk * @property {string} embedding_model - Model used for embedding generation * @property {number} embedding_cost - Cost in USD for embedding generation * @property {Record<string, any>} context_summary - Get context summary for display. * @property {string} created_at */
 
 /**
- * @typedef {Object} APIKeyList * @description Lightweight API key serializer for lists.
+ * @typedef {Object} ArchiveItemChunkDetail * @description Detailed chunk serializer with full context. * @property {string} id * @property {string} content - Chunk text content * @property {number} chunk_index - Sequential chunk number within item * @property {"text" | "code" | "heading" | "metadata" | "table" | "list"} [chunk_type] - Type of content in chunk
 
-Optimized for API key lists with minimal data (no key value). * @property {string} id - Unique identifier for this record * @property {string} user * @property {string} name - Human-readable name for this API key * @property {boolean} is_active - Whether this API key is active * @property {boolean} is_expired * @property {boolean} is_valid * @property {number} total_requests - Total number of requests made with this key * @property {string} last_used_at - When this API key was last used * @property {string} expires_at - When this API key expires (null = never expires) * @property {string} created_at - When this record was created */
+* `text` - Text
+* `code` - Code
+* `heading` - Heading
+* `metadata` - Metadata
+* `table` - Table
+* `list` - List * @property {number} token_count - Number of tokens in chunk * @property {number} character_count - Number of characters in chunk * @property {string} embedding_model - Model used for embedding generation * @property {number} embedding_cost - Cost in USD for embedding generation * @property {Record<string, any>} context_summary - Get context summary for display. * @property {string} created_at * @property {any} context_metadata */
 
 /**
- * @typedef {Object} APIKeyUpdate * @description API key update serializer for modifying API key properties.
+ * @typedef {Object} ArchiveItemChunkRequest * @description Archive item chunk serializer. * @property {string} content - Chunk text content * @property {number} chunk_index - Sequential chunk number within item * @property {"text" | "code" | "heading" | "metadata" | "table" | "list"} [chunk_type] - Type of content in chunk
 
-Allows updating name and active status only. * @property {string} name - Human-readable name for this API key * @property {boolean} [is_active] - Whether this API key is active */
+* `text` - Text
+* `code` - Code
+* `heading` - Heading
+* `metadata` - Metadata
+* `table` - Table
+* `list` - List */
 
 /**
- * @typedef {Object} APIKeyUpdateRequest * @description API key update serializer for modifying API key properties.
+ * @typedef {Object} ArchiveItemDetail * @description Detailed archive item serializer with content. * @property {string} id * @property {string} relative_path - Path within archive * @property {string} item_name - Item name * @property {string} item_type - MIME type * @property {"document" | "code" | "image" | "data" | "archive" | "unknown"} content_type - Content classification
 
-Allows updating name and active status only. * @property {string} name - Human-readable name for this API key * @property {boolean} [is_active] - Whether this API key is active */
+* `document` - Document
+* `code` - Code
+* `image` - Image
+* `data` - Data
+* `archive` - Archive
+* `unknown` - Unknown * @property {number} [file_size] - Item size in bytes * @property {boolean} is_processable - Whether item can be processed for chunks * @property {string} language - Programming language or document language * @property {string} encoding - Character encoding * @property {number} chunks_count - Number of chunks created * @property {number} total_tokens - Total tokens in all chunks * @property {number} processing_cost - Processing cost for this item * @property {string} created_at * @property {string} updated_at * @property {string} raw_content * @property {any} metadata */
 
 /**
- * @typedef {Object} APIKeyValidationRequest * @description API key validation serializer.
+ * @typedef {Object} ArchiveItemRequest * @description Archive item serializer. * @property {string} relative_path - Path within archive * @property {string} item_name - Item name * @property {string} item_type - MIME type * @property {number} [file_size] - Item size in bytes */
 
-Validates API key and returns key information. * @property {string} key - API key to validate */
+/**
+ * @typedef {Object} ArchiveProcessingResult * @description Archive processing result serializer. * @property {string} archive_id * @property {string} status * @property {number} processing_time_ms * @property {number} items_processed * @property {number} chunks_created * @property {number} vectorized_chunks * @property {number} total_cost_usd * @property {string} error_message */
 
 /**
- * @typedef {Object} APIKeyValidationResponse * @description API key validation response serializer.
+ * @typedef {Object} ArchiveSearchRequestRequest * @description Archive search request serializer. * @property {string} query - Search query * @property {"document" | "code" | "image" | "data" | "archive" | "unknown"[]} [content_types] - Filter by content types * @property {string[]} [languages] - Filter by programming languages * @property {"text" | "code" | "heading" | "metadata" | "table" | "list"[]} [chunk_types] - Filter by chunk types * @property {string[]} [archive_ids] - Search within specific archives * @property {number} [limit] - Maximum number of results * @property {number} [similarity_threshold] - Minimum similarity threshold */
 
-Defines the structure of API key validation response for OpenAPI schema. * @property {boolean} success - Whether the validation was successful * @property {boolean} valid - Whether the API key is valid * @property {any} api_key - API key details if valid * @property {string} message - Validation message * @property {string} [error] - Error message if validation failed * @property {string} [error_code] - Error code if validation failed */
+/**
+ * @typedef {Object} ArchiveSearchResult * @description Archive search result serializer. * @property {any} chunk * @property {number} similarity_score * @property {Record<string, any>} context_summary * @property {Record<string, any>} archive_info * @property {Record<string, any>} item_info */
 
 /**
- * @typedef {Object} APIKeysOverview * @description API keys overview metrics * @property {number} total_keys - Total number of API keys * @property {number} active_keys - Number of active API keys * @property {number} expired_keys - Number of expired API keys * @property {number} total_requests - Total requests across all keys * @property {string} last_used_at - When any key was last used * @property {string} most_used_key_name - Name of most used API key * @property {number} most_used_key_requests - Requests count for most used key * @property {number} expiring_soon_count - Number of keys expiring within 7 days */
+ * @typedef {Object} ArchiveStatistics * @description Archive statistics serializer. * @property {number} total_archives * @property {number} processed_archives * @property {number} failed_archives * @property {number} total_items * @property {number} total_chunks * @property {number} total_tokens * @property {number} total_cost * @property {number} avg_processing_time * @property {number} avg_items_per_archive * @property {number} avg_chunks_per_archive */
 
 /**
- * @typedef {Object} APIResponse * @description Standard API response serializer. * @property {boolean} success - Operation success status * @property {string} [message] - Success message * @property {string} [error] - Error message * @property {Record<string, any>} [data] - Response data */
+ * @typedef {Object} Balance * @description User balance serializer. * @property {string} balance_usd - Current balance in USD * @property {string} balance_display * @property {string} total_deposited - Total amount deposited (lifetime) * @property {string} total_withdrawn - Total amount withdrawn (lifetime) * @property {string} last_transaction_at - When the last transaction occurred */
 
 /**
- * @typedef {Object} APIResponseRequest * @description Standard API response serializer. * @property {boolean} success - Operation success status * @property {string} [message] - Success message * @property {string} [error] - Error message * @property {Record<string, any>} [data] - Response data */
+ * @typedef {Object} BulkEmailRequest * @description Simple serializer for bulk email. * @property {string[]} recipients * @property {string} subject * @property {string} email_title * @property {string} main_text * @property {string} [main_html_content] * @property {string} [button_text] * @property {string} [button_url] * @property {string} [secondary_text] */
 
 /**
- * @typedef {Object} AdminPaymentCreate * @description Serializer for creating payments in admin interface.
-Uses UniversalPayment only for data creation. * @property {number} user * @property {number} amount_usd * @property {string} provider * @property {string} [description] * @property {string} [callback_url] * @property {string} [cancel_url] */
+ * @typedef {Object} BulkEmailResponse * @description Response for bulk email sending. * @property {boolean} success * @property {number} sent_count * @property {number} failed_count * @property {number} total_recipients * @property {string} [error] */
 
 /**
- * @typedef {Object} AdminPaymentCreateRequest * @description Serializer for creating payments in admin interface.
-Uses UniversalPayment only for data creation. * @property {number} user * @property {number} amount_usd * @property {string} currency_code - Provider currency code (e.g., BTC, ZROERC20) * @property {string} provider * @property {string} [description] * @property {string} [callback_url] * @property {string} [cancel_url] */
+ * @typedef {Object} CentrifugoChannelInfo * @description Information about a single channel. * @property {number} num_clients - Number of connected clients in channel */
 
 /**
- * @typedef {Object} AdminPaymentDetail * @description Detailed serializer for individual payment in admin interface.
-Uses UniversalPayment only for data extraction. * @property {string} id * @property {any} user * @property {string} internal_payment_id * @property {number} amount_usd * @property {number} actual_amount_usd * @property {number} fee_amount_usd * @property {string} currency_code * @property {string} currency_name * @property {string} provider * @property {string} provider_display * @property {string} status * @property {string} status_display * @property {string} pay_amount * @property {string} pay_address * @property {string} payment_url * @property {string} transaction_hash * @property {number} confirmations_count * @property {string} security_nonce * @property {string} expires_at * @property {string} completed_at * @property {string} status_changed_at * @property {string} description * @property {string} callback_url * @property {string} cancel_url * @property {any} provider_data * @property {any} webhook_data * @property {string} created_at * @property {string} updated_at * @property {string} age */
+ * @typedef {Object} CentrifugoChannelsRequestRequest * @description Request to list active channels. * @property {any} [pattern] - Pattern to filter channels (e.g., 'user:*') */
 
 /**
- * @typedef {Object} AdminPaymentList * @description Serializer for payment list in admin interface.
-Uses UniversalPayment only for data extraction. * @property {string} id * @property {string} internal_payment_id * @property {any} user * @property {number} amount_usd * @property {string} currency_code * @property {string} currency_name * @property {string} provider * @property {string} provider_display * @property {string} status * @property {string} status_display * @property {string} pay_amount * @property {string} pay_address * @property {string} transaction_hash * @property {string} created_at * @property {string} updated_at * @property {string} description * @property {string} age */
+ * @typedef {Object} CentrifugoChannelsResponse * @description List of active channels response. * @property {any} [error] - Error if any * @property {any} [result] - Result data */
 
 /**
- * @typedef {Object} AdminPaymentStats * @description Serializer for payment statistics in admin interface. * @property {number} total_payments * @property {number} total_amount_usd * @property {number} successful_payments * @property {number} failed_payments * @property {number} pending_payments * @property {number} success_rate * @property {Record<string, Record<string, any>>} by_provider - Statistics by provider * @property {Record<string, Record<string, any>>} by_currency - Statistics by currency * @property {Record<string, number>} last_24h - Payments in last 24 hours * @property {Record<string, number>} last_7d - Payments in last 7 days * @property {Record<string, number>} last_30d - Payments in last 30 days */
+ * @typedef {Object} CentrifugoChannelsResult * @description Channels result wrapper. * @property {Record<string, CentrifugoChannelInfo>} channels - Map of channel names to channel info */
 
 /**
- * @typedef {Object} AdminPaymentUpdate * @description Serializer for updating payments in admin interface. * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
+ * @typedef {Object} CentrifugoClientInfo * @description Information about connected client. * @property {string} user - User ID * @property {string} client - Client UUID * @property {any} [conn_info] - Connection metadata * @property {any} [chan_info] - Channel-specific metadata */
 
-* `pending` - Pending
-* `confirming` - Confirming
-* `confirmed` - Confirmed
-* `completed` - Completed
-* `failed` - Failed
-* `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} [description] - Payment description * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {any} [provider_data] - Provider-specific data (validated by Pydantic) * @property {any} [webhook_data] - Webhook data (validated by Pydantic) */
+/**
+ * @typedef {Object} CentrifugoError * @description Centrifugo API error structure. * @property {number} [code] - Error code (0 = no error) * @property {string} [message] - Error message */
 
 /**
- * @typedef {Object} AdminPaymentUpdateRequest * @description Serializer for updating payments in admin interface. * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
+ * @typedef {Object} CentrifugoHistoryRequestRequest * @description Request to get channel history. * @property {string} channel - Channel name * @property {any} [limit] - Maximum number of messages to return * @property {any} [since] - Stream position to get messages since * @property {any} [reverse] - Reverse message order (newest first) */
 
-* `pending` - Pending
-* `confirming` - Confirming
-* `confirmed` - Confirmed
-* `completed` - Completed
-* `failed` - Failed
-* `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} [description] - Payment description * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {any} [provider_data] - Provider-specific data (validated by Pydantic) * @property {any} [webhook_data] - Webhook data (validated by Pydantic) */
+/**
+ * @typedef {Object} CentrifugoHistoryResponse * @description Channel history response. * @property {any} [error] - Error if any * @property {any} [result] - Result data */
 
 /**
- * @typedef {Object} AdminUser * @description Simplified user serializer for admin interface. * @property {number} id * @property {string} username - Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only. * @property {string} email * @property {string} first_name * @property {string} last_name * @property {boolean} is_active - Designates whether this user should be treated as active. Unselect this instead of deleting accounts. */
+ * @typedef {Object} CentrifugoHistoryResult * @description History result wrapper. * @property {CentrifugoPublication[]} publications - List of publications * @property {string} epoch - Current stream epoch * @property {number} offset - Latest stream offset */
 
 /**
- * @typedef {Object} BalanceOverview * @description User balance overview metrics * @property {number} current_balance - Current balance in USD * @property {string} balance_display - Formatted balance display * @property {number} total_deposited - Total amount deposited (lifetime) * @property {number} total_spent - Total amount spent (lifetime) * @property {string} last_transaction_at - Last transaction timestamp * @property {boolean} has_transactions - Whether user has any transactions * @property {boolean} is_empty - Whether balance is zero */
+ * @typedef {Object} CentrifugoInfoResponse * @description Server info response. * @property {any} [error] - Error if any * @property {any} [result] - Result data */
 
 /**
- * @typedef {Object} BulkEmailRequest * @description Simple serializer for bulk email. * @property {string[]} recipients * @property {string} subject * @property {string} email_title * @property {string} main_text * @property {string} [main_html_content] * @property {string} [button_text] * @property {string} [button_url] * @property {string} [secondary_text] */
+ * @typedef {Object} CentrifugoInfoResult * @description Info result wrapper. * @property {CentrifugoNodeInfo[]} nodes - List of Centrifugo nodes */
 
 /**
- * @typedef {Object} BulkEmailResponse * @description Response for bulk email sending. * @property {boolean} success * @property {number} sent_count * @property {number} failed_count * @property {number} total_recipients * @property {string} [error] */
+ * @typedef {Object} CentrifugoMetrics * @description Server metrics. * @property {number} interval - Metrics collection interval * @property {Record<string, number>} items - Metric name to value mapping */
+
+/**
+ * @typedef {Object} CentrifugoNodeInfo * @description Information about a single Centrifugo node. * @property {string} uid - Unique node identifier * @property {string} name - Node name * @property {string} version - Centrifugo version * @property {number} num_clients - Number of connected clients * @property {number} num_users - Number of unique users * @property {number} num_channels - Number of active channels * @property {number} uptime - Node uptime in seconds * @property {number} num_subs - Total number of subscriptions * @property {any} [metrics] - Server metrics * @property {any} [process] - Process information */
+
+/**
+ * @typedef {Object} CentrifugoPresenceRequestRequest * @description Request to get channel presence. * @property {string} channel - Channel name */
+
+/**
+ * @typedef {Object} CentrifugoPresenceResponse * @description Channel presence response. * @property {any} [error] - Error if any * @property {any} [result] - Result data */
+
+/**
+ * @typedef {Object} CentrifugoPresenceResult * @description Presence result wrapper. * @property {Record<string, CentrifugoClientInfo>} presence - Map of client IDs to client info */
+
+/**
+ * @typedef {Object} CentrifugoPresenceStatsRequestRequest * @description Request to get channel presence statistics. * @property {string} channel - Channel name */
+
+/**
+ * @typedef {Object} CentrifugoPresenceStatsResponse * @description Channel presence stats response. * @property {any} [error] - Error if any * @property {any} [result] - Result data */
+
+/**
+ * @typedef {Object} CentrifugoPresenceStatsResult * @description Presence stats result. * @property {number} num_clients - Number of connected clients * @property {number} num_users - Number of unique users */
+
+/**
+ * @typedef {Object} CentrifugoProcess * @description Process information. * @property {number} cpu - CPU usage percentage * @property {number} rss - Resident set size in bytes */
+
+/**
+ * @typedef {Object} CentrifugoPublication * @description Single publication (message) in channel history. * @property {Record<string, any>} data - Message payload * @property {any} [info] - Publisher client info * @property {number} offset - Message offset in channel stream * @property {any} [tags] - Optional message tags */
+
+/**
+ * @typedef {Object} CentrifugoStreamPosition * @description Stream position for pagination. * @property {number} offset - Stream offset * @property {string} epoch - Stream epoch */
+
+/**
+ * @typedef {Object} ChannelList * @description List of channel statistics. * @property {ChannelStatsSerializer[]} channels - Channel statistics * @property {number} total_channels - Total number of channels */
+
+/**
+ * @typedef {Object} ChannelStatsSerializer * @description Statistics per channel. * @property {string} channel - Channel name * @property {number} total - Total publishes to this channel * @property {number} successful - Successful publishes * @property {number} failed - Failed publishes * @property {number} avg_duration_ms - Average duration * @property {number} avg_acks - Average ACKs received */
+
+/**
+ * @typedef {Object} ChatHistory * @description Chat history response serializer. * @property {string} session_id * @property {ChatMessage[]} messages * @property {number} total_messages */
+
+/**
+ * @typedef {Object} ChatMessage * @description Chat message response serializer. * @property {string} id * @property {"user" | "assistant" | "system"} role - Message sender role
+
+* `user` - User
+* `assistant` - Assistant
+* `system` - System * @property {string} content - Message content * @property {number} [tokens_used] - Tokens used for this message * @property {number} cost_usd * @property {number} [processing_time_ms] - Processing time in milliseconds * @property {string} created_at * @property {any} [context_chunks] - IDs of chunks used for context */
+
+/**
+ * @typedef {Object} ChatQueryRequest * @description Chat query request serializer. * @property {string} [session_id] - Chat session ID (creates new if not provided) * @property {string} query - User query * @property {number} [max_tokens] - Maximum response tokens * @property {boolean} [include_sources] - Include source documents in response */
+
+/**
+ * @typedef {Object} ChatResponse * @description Chat response serializer. * @property {string} message_id * @property {string} content * @property {number} tokens_used * @property {number} cost_usd * @property {number} processing_time_ms * @property {string} model_used * @property {ChatSource[]} [sources] */
+
+/**
+ * @typedef {Object} ChatResponseRequest * @description Chat response serializer. * @property {string} message_id * @property {string} content * @property {number} tokens_used * @property {number} cost_usd * @property {number} processing_time_ms * @property {string} model_used * @property {ChatSourceRequest[]} [sources] */
 
 /**
- * @typedef {Object} ChartDataPoint * @description Chart data point for payments analytics * @property {string} x - X-axis value (date) * @property {number} y - Y-axis value (amount or count) */
+ * @typedef {Object} ChatSession * @description Chat session response serializer. * @property {string} id * @property {string} [title] - Session title (auto-generated if empty) * @property {boolean} [is_active] - Whether session accepts new messages * @property {number} [messages_count] * @property {number} [total_tokens_used] * @property {number} total_cost_usd * @property {string} [model_name] - LLM model used for this session * @property {number} [temperature] - Temperature setting for LLM * @property {number} [max_context_chunks] - Maximum chunks to include in context * @property {string} created_at * @property {string} updated_at */
 
 /**
- * @typedef {Object} ChartSeries * @description Chart series data for payments visualization * @property {string} name - Series name * @property {ChartDataPoint[]} data - Data points * @property {string} color - Series color */
+ * @typedef {Object} ChatSessionCreateRequest * @description Chat session creation request serializer. * @property {string} [title] - Session title * @property {string} [model_name] - LLM model to use * @property {number} [temperature] - Response creativity * @property {number} [max_context_chunks] - Maximum context chunks */
 
 /**
- * @typedef {Object} Currency * @description Complete currency serializer with full details.
+ * @typedef {Object} ChatSessionRequest * @description Chat session response serializer. * @property {string} [title] - Session title (auto-generated if empty) * @property {boolean} [is_active] - Whether session accepts new messages * @property {number} [messages_count] * @property {number} [total_tokens_used] * @property {string} [model_name] - LLM model used for this session * @property {number} [temperature] - Temperature setting for LLM * @property {number} [max_context_chunks] - Maximum chunks to include in context */
 
-Used for currency information and management. * @property {number} id * @property {string} code - Currency code (e.g., BTC, USD, ETH) * @property {string} name - Full currency name (e.g., Bitcoin, US Dollar) * @property {string} symbol - Currency symbol (e.g., $, ₿, Ξ) * @property {"fiat" | "crypto"} currency_type - Type of currency
+/**
+ * @typedef {Object} ChatSource * @description Chat source document information serializer. * @property {string} document_title * @property {string} chunk_content * @property {number} similarity */
+
+/**
+ * @typedef {Object} ChatSourceRequest * @description Chat source document information serializer. * @property {string} document_title * @property {string} chunk_content * @property {number} similarity */
+
+/**
+ * @typedef {Object} ChunkRevectorizationRequestRequest * @description Chunk re-vectorization request serializer. * @property {string[]} chunk_ids - List of chunk IDs to re-vectorize * @property {boolean} [force] - Force re-vectorization even if already vectorized */
+
+/**
+ * @typedef {Object} ConnectionTokenRequestRequest * @description Request model for connection token generation. * @property {string} user_id - User ID for the connection * @property {string[]} [channels] - List of channels to authorize */
+
+/**
+ * @typedef {Object} ConnectionTokenResponse * @description Response model for connection token. * @property {string} token - JWT token for WebSocket connection * @property {string} centrifugo_url - Centrifugo WebSocket URL * @property {string} expires_at - Token expiration time (ISO 8601) */
+
+/**
+ * @typedef {Object} Currency * @description Currency list serializer. * @property {string} code - Currency code from provider (e.g., USDTTRC20, BTC, ETH) * @property {string} name - Full currency name (e.g., USDT (TRC20), Bitcoin) * @property {string} token - Token symbol (e.g., USDT, BTC, ETH) * @property {string} network - Network name (e.g., TRC20, ERC20, Bitcoin) * @property {string} display_name * @property {string} symbol - Currency symbol (e.g., ₮, ₿, Ξ) * @property {number} decimal_places - Number of decimal places for this currency * @property {boolean} is_active - Whether this currency is available for payments * @property {string} min_amount_usd - Minimum payment amount in USD * @property {number} sort_order - Sort order for currency list (lower = higher priority) */
+
+/**
+ * @typedef {Object} Document * @description Document response serializer. * @property {string} id * @property {string} title - Document title * @property {string} [file_type] - MIME type of original file * @property {number} [file_size] - Original file size in bytes * @property {string} processing_status * @property {number} chunks_count * @property {number} total_tokens * @property {number} total_cost_usd * @property {string} created_at * @property {string} updated_at * @property {string} processing_started_at * @property {string} processing_completed_at * @property {string} processing_error * @property {any} [metadata] - Additional document metadata */
+
+/**
+ * @typedef {Object} DocumentArchive * @description Document archive serializer. * @property {string} id * @property {string} title - Archive title * @property {string} [description] - Archive description * @property {DocumentCategory[]} categories * @property {boolean} [is_public] - Whether this archive is publicly accessible * @property {string} archive_file - Uploaded archive file * @property {string} original_filename - Original uploaded filename * @property {number} file_size - Archive size in bytes * @property {"zip" | "tar" | "tar.gz" | "tar.bz2"} archive_type - Archive format
+
+* `zip` - ZIP
+* `tar` - TAR
+* `tar.gz` - TAR GZ
+* `tar.bz2` - TAR BZ2 * @property {"pending" | "processing" | "completed" | "failed" | "cancelled"} processing_status - * `pending` - Pending
+* `processing` - Processing
+* `completed` - Completed
+* `failed` - Failed
+* `cancelled` - Cancelled * @property {string} processed_at - When processing completed * @property {number} processing_duration_ms - Processing time in milliseconds * @property {string} processing_error - Error message if processing failed * @property {number} total_items - Total items in archive * @property {number} processed_items - Successfully processed items * @property {number} total_chunks - Total chunks created * @property {number} vectorized_chunks - Chunks with embeddings * @property {number} total_tokens - Total tokens across all chunks * @property {number} total_cost_usd - Total processing cost in USD * @property {number} processing_progress - Calculate processing progress as percentage. * @property {number} vectorization_progress - Calculate vectorization progress as percentage. * @property {boolean} is_processed - Check if archive processing is completed. * @property {string} created_at * @property {string} updated_at */
+
+/**
+ * @typedef {Object} DocumentArchiveDetail * @description Detailed archive serializer with items. * @property {string} id * @property {string} title - Archive title * @property {string} [description] - Archive description * @property {DocumentCategory[]} categories * @property {boolean} [is_public] - Whether this archive is publicly accessible * @property {string} archive_file - Uploaded archive file * @property {string} original_filename - Original uploaded filename * @property {number} file_size - Archive size in bytes * @property {"zip" | "tar" | "tar.gz" | "tar.bz2"} archive_type - Archive format
+
+* `zip` - ZIP
+* `tar` - TAR
+* `tar.gz` - TAR GZ
+* `tar.bz2` - TAR BZ2 * @property {"pending" | "processing" | "completed" | "failed" | "cancelled"} processing_status - * `pending` - Pending
+* `processing` - Processing
+* `completed` - Completed
+* `failed` - Failed
+* `cancelled` - Cancelled * @property {string} processed_at - When processing completed * @property {number} processing_duration_ms - Processing time in milliseconds * @property {string} processing_error - Error message if processing failed * @property {number} total_items - Total items in archive * @property {number} processed_items - Successfully processed items * @property {number} total_chunks - Total chunks created * @property {number} vectorized_chunks - Chunks with embeddings * @property {number} total_tokens - Total tokens across all chunks * @property {number} total_cost_usd - Total processing cost in USD * @property {number} processing_progress - Calculate processing progress as percentage. * @property {number} vectorization_progress - Calculate vectorization progress as percentage. * @property {boolean} is_processed - Check if archive processing is completed. * @property {string} created_at * @property {string} updated_at * @property {ArchiveItem[]} items * @property {Record<string, any>} file_tree - Get hierarchical file tree. * @property {any} [metadata] - Additional archive metadata */
+
+/**
+ * @typedef {Object} DocumentArchiveList * @description Simplified archive serializer for list views. * @property {string} id * @property {string} title - Archive title * @property {string} description - Archive description * @property {DocumentCategory[]} categories * @property {boolean} is_public - Whether this archive is publicly accessible * @property {string} original_filename - Original uploaded filename * @property {number} file_size - Archive size in bytes * @property {"zip" | "tar" | "tar.gz" | "tar.bz2"} archive_type - Archive format
+
+* `zip` - ZIP
+* `tar` - TAR
+* `tar.gz` - TAR GZ
+* `tar.bz2` - TAR BZ2 * @property {"pending" | "processing" | "completed" | "failed" | "cancelled"} processing_status - * `pending` - Pending
+* `processing` - Processing
+* `completed` - Completed
+* `failed` - Failed
+* `cancelled` - Cancelled * @property {string} processed_at - When processing completed * @property {number} total_items - Total items in archive * @property {number} total_chunks - Total chunks created * @property {number} total_cost_usd - Total processing cost in USD * @property {number} processing_progress - Calculate processing progress as percentage. * @property {string} created_at */
+
+/**
+ * @typedef {Object} DocumentArchiveRequest * @description Document archive serializer. * @property {string} title - Archive title * @property {string} [description] - Archive description * @property {boolean} [is_public] - Whether this archive is publicly accessible */
 
-* `fiat` - Fiat Currency
-* `crypto` - Cryptocurrency * @property {string} type_display * @property {number} decimal_places - Number of decimal places for this currency * @property {boolean} is_active - Whether this currency is available for payments * @property {boolean} is_crypto - Check if this is a cryptocurrency. * @property {boolean} is_fiat - Check if this is a fiat currency. * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
+/**
+ * @typedef {Object} DocumentCategory * @description Document category serializer. * @property {string} id * @property {string} name - Category name * @property {string} [description] - Category description * @property {boolean} [is_public] - Whether documents in this category are publicly accessible * @property {string} created_at */
+
+/**
+ * @typedef {Object} DocumentCategoryRequest * @description Document category serializer. * @property {string} name - Category name * @property {string} [description] - Category description * @property {boolean} [is_public] - Whether documents in this category are publicly accessible */
 
 /**
- * @typedef {Object} CurrencyAnalyticsItem * @description Analytics data for a single currency * @property {string} currency_code - Currency code (e.g., BTC) * @property {string} currency_name - Currency name (e.g., Bitcoin) * @property {number} total_payments - Total number of payments * @property {number} total_amount - Total amount in USD * @property {number} completed_payments - Number of completed payments * @property {number} average_amount - Average payment amount in USD * @property {number} success_rate - Success rate percentage */
+ * @typedef {Object} DocumentCreateRequest * @description Document creation request serializer. * @property {string} title - Document title * @property {string} content - Document content * @property {string} [file_type] - MIME type * @property {any} [metadata] - Additional metadata */
 
 /**
- * @typedef {Object} CurrencyList * @description Lightweight currency serializer for lists.
+ * @typedef {Object} DocumentProcessingStatus * @description Document processing status serializer. * @property {string} id * @property {string} status * @property {any} progress * @property {string} [error] * @property {number} [processing_time_seconds] */
 
-Optimized for currency selection and lists. * @property {number} id * @property {string} code - Currency code (e.g., BTC, USD, ETH) * @property {string} name - Full currency name (e.g., Bitcoin, US Dollar) * @property {string} symbol - Currency symbol (e.g., $, ₿, Ξ) * @property {"fiat" | "crypto"} currency_type - Type of currency
+/**
+ * @typedef {Object} DocumentRequest * @description Document response serializer. * @property {string} title - Document title * @property {string} [file_type] - MIME type of original file * @property {number} [file_size] - Original file size in bytes * @property {any} [metadata] - Additional document metadata */
 
-* `fiat` - Fiat Currency
-* `crypto` - Cryptocurrency * @property {string} type_display * @property {boolean} is_active - Whether this currency is available for payments */
+/**
+ * @typedef {Object} DocumentStats * @description Document processing statistics serializer. * @property {number} total_documents * @property {number} completed_documents * @property {number} processing_success_rate * @property {number} total_chunks * @property {number} total_tokens * @property {number} total_cost_usd * @property {number} avg_processing_time_seconds */
 
 /**
  * @typedef {Object} EmailLog * @description Serializer for EmailLog model. * @property {string} id * @property {number} user * @property {string} user_email * @property {number} newsletter * @property {string} newsletter_title * @property {string} recipient - Comma-separated email addresses * @property {string} subject * @property {string} body * @property {"pending" | "sent" | "failed"} status - * `pending` - Pending
@@ -144,11 +273,6 @@ Optimized for currency selection and lists. * @property {number} id * @property
 /**
  * @typedef {Object} Endpoint * @description Serializer for single endpoint status. * @property {string} url - Resolved URL (for parametrized URLs) or URL pattern * @property {string} [url_pattern] - Original URL pattern (for parametrized URLs) * @property {string} [url_name] - Django URL name (if available) * @property {string} [namespace] - URL namespace * @property {string} group - URL group (up to 3 depth) * @property {string} [view] - View function/class name * @property {string} status - Status: healthy, unhealthy, warning, error, skipped, pending * @property {number} [status_code] - HTTP status code * @property {number} [response_time_ms] - Response time in milliseconds * @property {boolean} [is_healthy] - Whether endpoint is healthy * @property {string} [error] - Error message if check failed * @property {string} [error_type] - Error type: database, general, etc. * @property {string} [reason] - Reason for warning/skip * @property {string} [last_checked] - Timestamp of last check * @property {boolean} [has_parameters] - Whether URL has parameters that were resolved with test values * @property {boolean} [required_auth] - Whether endpoint required JWT authentication * @property {boolean} [rate_limited] - Whether endpoint returned 429 (rate limited) */
 
-/**
- * @typedef {Object} EndpointGroup * @description Endpoint group serializer for API access management.
-
-Used for subscription endpoint group configuration. * @property {number} id * @property {string} name - Endpoint group name (e.g., 'Payment API', 'Balance API') * @property {string} description - Description of what this endpoint group provides * @property {boolean} is_enabled - Whether this endpoint group is available * @property {string} created_at * @property {string} updated_at */
-
 /**
  * @typedef {Object} EndpointsStatus * @description Serializer for overall endpoints status response. * @property {string} status - Overall status: healthy, degraded, or unhealthy * @property {string} timestamp - Timestamp of the check * @property {number} total_endpoints - Total number of endpoints checked * @property {number} healthy - Number of healthy endpoints * @property {number} unhealthy - Number of unhealthy endpoints * @property {number} warnings - Number of endpoints with warnings * @property {number} errors - Number of endpoints with errors * @property {number} skipped - Number of skipped endpoints * @property {Endpoint[]} endpoints - List of all endpoints with their status */
 
@@ -156,7 +280,7 @@ Used for subscription endpoint group configuration. * @property {number} id * @p
  * @typedef {Object} ErrorResponse * @description Generic error response. * @property {boolean} [success] * @property {string} message */
 
 /**
- * @typedef {Object} HealthCheck * @description Serializer for health check response. * @property {string} status - Overall health status: healthy, degraded, or unhealthy * @property {string} timestamp - Timestamp of the health check * @property {string} service - Service name * @property {string} version - Django-CFG version * @property {Record<string, any>} checks - Detailed health checks for databases, cache, and system * @property {Record<string, any>} environment - Environment information */
+ * @typedef {Object} HealthCheck * @description Health check response. * @property {string} status - Health status: healthy or unhealthy * @property {string} wrapper_url - Configured wrapper URL * @property {boolean} has_api_key - Whether API key is configured * @property {string} timestamp - Current timestamp */
 
 /**
  * @typedef {Object} LeadSubmission * @description Serializer for lead form submission from frontend. * @property {string} name * @property {string} email * @property {string} [company] * @property {string} [company_site] * @property {"email" | "whatsapp" | "telegram" | "phone" | "other"} [contact_type] - * `email` - Email
@@ -179,27 +303,22 @@ Used for subscription endpoint group configuration. * @property {number} id * @p
  * @typedef {Object} LeadSubmissionResponse * @description Response serializer for successful lead submission. * @property {boolean} success * @property {string} message * @property {number} lead_id */
 
 /**
- * @typedef {Object} Message * @property {string} uuid * @property {string} ticket * @property {any} sender * @property {boolean} is_from_author - Check if this message is from the ticket author. * @property {string} text * @property {string} created_at */
+ * @typedef {Object} ManualAckRequestRequest * @description Request model for manual ACK sending. * @property {string} message_id - Message ID to acknowledge * @property {string} client_id - Client ID sending the ACK */
 
 /**
- * @typedef {Object} MessageCreate * @property {string} text */
+ * @typedef {Object} ManualAckResponse * @description Response model for manual ACK. * @property {boolean} success - Whether ACK was sent successfully * @property {string} message_id - Message ID that was acknowledged * @property {any} [error] - Error message if failed */
 
 /**
- * @typedef {Object} MessageCreateRequest * @property {string} text */
-
-/**
- * @typedef {Object} MessageRequest * @property {string} text */
+ * @typedef {Object} Message * @property {string} uuid * @property {string} ticket * @property {any} sender * @property {boolean} is_from_author - Check if this message is from the ticket author. * @property {string} text * @property {string} created_at */
 
 /**
- * @typedef {Object} MethodStat * @description Serializer for individual method statistics. * @property {string} method - RPC method name * @property {number} count - Number of calls * @property {number} percentage - Percentage of total calls * @property {number} [avg_time_ms] - Average execution time in milliseconds * @property {number} [avg_time] - Average execution time (alternative field) * @property {number} [success_rate] - Success rate percentage * @property {string} [last_called] - ISO timestamp of last call */
+ * @typedef {Object} MessageCreate * @property {string} text */
 
 /**
- * @typedef {Object} MethodStats * @description Serializer for method statistics response. * @property {MethodStat[]} methods - List of method statistics * @property {number} count - Total number of methods * @property {number} total_calls - Total calls across all methods */
+ * @typedef {Object} MessageCreateRequest * @property {string} text */
 
 /**
- * @typedef {Object} Network * @description Network serializer for blockchain networks.
-
-Used for network information and selection. * @property {number} id * @property {any} currency * @property {string} name - Network name (e.g., Ethereum, Bitcoin, Polygon) * @property {string} code - Network code (e.g., ETH, BTC, MATIC) * @property {boolean} is_active - Whether this network is available for payments * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
+ * @typedef {Object} MessageRequest * @property {string} text */
 
 /**
  * @typedef {Object} Newsletter * @description Serializer for Newsletter model. * @property {number} id * @property {string} title * @property {string} [description] * @property {boolean} [is_active] * @property {boolean} [auto_subscribe] - Automatically subscribe new users to this newsletter * @property {string} created_at * @property {string} updated_at * @property {number} subscribers_count */
@@ -216,9 +335,6 @@ Used for network information and selection. * @property {number} id * @property
 /**
  * @typedef {Object} NewsletterSubscription * @description Serializer for NewsletterSubscription model. * @property {number} id * @property {number} newsletter * @property {string} newsletter_title * @property {number} [user] * @property {string} user_email * @property {string} email * @property {boolean} [is_active] * @property {string} subscribed_at * @property {string} unsubscribed_at */
 
-/**
- * @typedef {Object} NotificationStats * @description Serializer for notification statistics. * @property {number} total_sent - Total notifications sent * @property {number} delivery_rate - Delivery success rate percentage * @property {Record<string, any>} [by_type] - Breakdown by notification type * @property {any[]} [recent] - Recent notifications * @property {string} [last_sent] - ISO timestamp of last notification * @property {string} [timestamp] - ISO timestamp of the stats * @property {string} [error] - Error message if any */
-
 /**
  * @typedef {Object} OTPErrorResponse * @description Error response for OTP operations. * @property {string} error - Error message */
 
@@ -241,37 +357,37 @@ Used for network information and selection. * @property {number} id * @property
  * @typedef {Object} OTPVerifyResponse * @description OTP verification response. * @property {string} refresh - JWT refresh token * @property {string} access - JWT access token * @property {any} user - User information */
 
 /**
- * @typedef {Object} OverviewStats * @description Serializer for overview statistics. * @property {boolean} [redis_connected] - Whether Redis is connected * @property {number} total_requests_today - Total requests processed today * @property {number} [total_requests_hour] - Total requests in the last hour * @property {string[]} active_methods - List of active RPC methods * @property {string} top_method - Most frequently called method * @property {Record<string, any>} [method_counts] - Count of requests per method * @property {number} avg_response_time_ms - Average response time in milliseconds * @property {number} success_rate - Success rate percentage * @property {number} [error_rate] - Error rate percentage * @property {string} [timestamp] - ISO timestamp of the stats * @property {string} [error] - Error message if any */
+ * @typedef {Object} OverviewStats * @description Overview statistics for Centrifugo publishes. * @property {number} total - Total publishes in period * @property {number} successful - Successful publishes * @property {number} failed - Failed publishes * @property {number} timeout - Timeout publishes * @property {number} success_rate - Success rate percentage * @property {number} avg_duration_ms - Average duration in milliseconds * @property {number} avg_acks_received - Average ACKs received * @property {number} period_hours - Statistics period in hours */
 
 /**
- * @typedef {Object} PaginatedAPIKeyListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {APIKeyList[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedArchiveItemChunkList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ArchiveItemChunk[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedAdminPaymentListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {AdminPaymentList[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedArchiveItemList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ArchiveItem[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedAdminPaymentStatsList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {AdminPaymentStats[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedArchiveSearchResultList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ArchiveSearchResult[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedAdminUserList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {AdminUser[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedChatResponseList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ChatResponse[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedCurrencyListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {CurrencyList[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedChatSessionList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ChatSession[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedEmailLogList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {EmailLog[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedDocumentArchiveListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {DocumentArchiveList[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedEndpointGroupList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {EndpointGroup[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedDocumentList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Document[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedLeadSubmissionList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {LeadSubmission[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedEmailLogList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {EmailLog[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedMessageList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Message[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedLeadSubmissionList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {LeadSubmission[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedNetworkList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Network[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedMessageList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Message[]} results - Array of items for current page */
 
 /**
  * @typedef {Object} PaginatedNewsletterCampaignList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {NewsletterCampaign[]} results - Array of items for current page */
@@ -286,51 +402,38 @@ Used for network information and selection. * @property {number} id * @property
  * @typedef {Object} PaginatedPaymentListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {PaymentList[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedProviderCurrencyList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {ProviderCurrency[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedPublicCategoryList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {PublicCategory[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedRecentPaymentList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {RecentPayment[]} results - Array of items for current page */
-
-/**
- * @typedef {Object} PaginatedRecentTransactionList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {RecentTransaction[]} results - Array of items for current page */
-
-/**
- * @typedef {Object} PaginatedSubscriptionListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {SubscriptionList[]} results - Array of items for current page */
-
-/**
- * @typedef {Object} PaginatedTariffList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Tariff[]} results - Array of items for current page */
+ * @typedef {Object} PaginatedPublicDocumentListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {PublicDocumentList[]} results - Array of items for current page */
 
 /**
  * @typedef {Object} PaginatedTicketList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Ticket[]} results - Array of items for current page */
 
 /**
- * @typedef {Object} PaginatedTransactionList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {Transaction[]} results - Array of items for current page */
+ * @typedef {Object} PatchedArchiveItemChunkRequest * @description Archive item chunk serializer. * @property {string} [content] - Chunk text content * @property {number} [chunk_index] - Sequential chunk number within item * @property {"text" | "code" | "heading" | "metadata" | "table" | "list"} [chunk_type] - Type of content in chunk
 
-/**
- * @typedef {Object} PaginatedUserBalanceList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {UserBalance[]} results - Array of items for current page */
+* `text` - Text
+* `code` - Code
+* `heading` - Heading
+* `metadata` - Metadata
+* `table` - Table
+* `list` - List */
 
 /**
- * @typedef {Object} PaginatedWebhookEventListList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {WebhookEventList[]} results - Array of items for current page */
+ * @typedef {Object} PatchedArchiveItemRequest * @description Archive item serializer. * @property {string} [relative_path] - Path within archive * @property {string} [item_name] - Item name * @property {string} [item_type] - MIME type * @property {number} [file_size] - Item size in bytes */
 
 /**
- * @typedef {Object} PaginatedWebhookStatsList * @property {number} count - Total number of items across all pages * @property {number} page - Current page number (1-based) * @property {number} pages - Total number of pages * @property {number} page_size - Number of items per page * @property {boolean} has_next - Whether there is a next page * @property {boolean} has_previous - Whether there is a previous page * @property {number} [next_page] - Next page number (null if no next page) * @property {number} [previous_page] - Previous page number (null if no previous page) * @property {WebhookStats[]} results - Array of items for current page */
+ * @typedef {Object} PatchedChatResponseRequest * @description Chat response serializer. * @property {string} [message_id] * @property {string} [content] * @property {number} [tokens_used] * @property {number} [cost_usd] * @property {number} [processing_time_ms] * @property {string} [model_used] * @property {ChatSourceRequest[]} [sources] */
 
 /**
- * @typedef {Object} PatchedAPIKeyUpdateRequest * @description API key update serializer for modifying API key properties.
-
-Allows updating name and active status only. * @property {string} [name] - Human-readable name for this API key * @property {boolean} [is_active] - Whether this API key is active */
+ * @typedef {Object} PatchedChatSessionRequest * @description Chat session response serializer. * @property {string} [title] - Session title (auto-generated if empty) * @property {boolean} [is_active] - Whether session accepts new messages * @property {number} [messages_count] * @property {number} [total_tokens_used] * @property {string} [model_name] - LLM model used for this session * @property {number} [temperature] - Temperature setting for LLM * @property {number} [max_context_chunks] - Maximum chunks to include in context */
 
 /**
- * @typedef {Object} PatchedAdminPaymentUpdateRequest * @description Serializer for updating payments in admin interface. * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
+ * @typedef {Object} PatchedDocumentArchiveRequest * @description Document archive serializer. * @property {string} [title] - Archive title * @property {string} [description] - Archive description * @property {boolean} [is_public] - Whether this archive is publicly accessible */
 
-* `pending` - Pending
-* `confirming` - Confirming
-* `confirmed` - Confirmed
-* `completed` - Completed
-* `failed` - Failed
-* `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} [description] - Payment description * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {any} [provider_data] - Provider-specific data (validated by Pydantic) * @property {any} [webhook_data] - Webhook data (validated by Pydantic) */
+/**
+ * @typedef {Object} PatchedDocumentRequest * @description Document response serializer. * @property {string} [title] - Document title * @property {string} [file_type] - MIME type of original file * @property {number} [file_size] - Original file size in bytes * @property {any} [metadata] - Additional document metadata */
 
 /**
  * @typedef {Object} PatchedLeadSubmissionRequest * @description Serializer for lead form submission from frontend. * @property {string} [name] * @property {string} [email] * @property {string} [company] * @property {string} [company_site] * @property {"email" | "whatsapp" | "telegram" | "phone" | "other"} [contact_type] - * `email` - Email
@@ -345,38 +448,6 @@ Allows updating name and active status only. * @property {string} [name] - Human
 /**
  * @typedef {Object} PatchedNewsletterCampaignRequest * @description Serializer for NewsletterCampaign model. * @property {number} [newsletter] * @property {string} [subject] * @property {string} [email_title] * @property {string} [main_text] * @property {string} [main_html_content] * @property {string} [button_text] * @property {string} [button_url] * @property {string} [secondary_text] */
 
-/**
- * @typedef {Object} PatchedPaymentRequest * @description Complete payment serializer with full details.
-
-Used for detail views and updates. * @property {number} [amount_usd] - Payment amount in USD (float for performance) * @property {number} [currency] - Payment currency * @property {number} [network] - Blockchain network (for crypto payments) * @property {"nowpayments"} [provider] - Payment provider
-
-* `nowpayments` - NowPayments * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
-
-* `pending` - Pending
-* `confirming` - Confirming
-* `confirmed` - Confirmed
-* `completed` - Completed
-* `failed` - Failed
-* `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {string} [description] - Payment description * @property {string} [expires_at] - When this payment expires */
-
-/**
- * @typedef {Object} PatchedSubscriptionRequest * @description Complete subscription serializer with full details.
-
-Used for subscription detail views and updates. * @property {"active" | "inactive" | "suspended" | "cancelled" | "expired"} [status] - Subscription status
-
-* `active` - Active
-* `inactive` - Inactive
-* `suspended` - Suspended
-* `cancelled` - Cancelled
-* `expired` - Expired * @property {"free" | "basic" | "pro" | "enterprise"} [tier] - Subscription tier
-
-* `free` - Free Tier
-* `basic` - Basic Tier
-* `pro` - Pro Tier
-* `enterprise` - Enterprise Tier * @property {string} [expires_at] - When this subscription expires */
-
 /**
  * @typedef {Object} PatchedTicketRequest * @property {number} [user] * @property {string} [subject] * @property {"open" | "waiting_for_user" | "waiting_for_admin" | "resolved" | "closed"} [status] - * `open` - Open
 * `waiting_for_user` - Waiting for User
@@ -391,107 +462,43 @@ Used for subscription detail views and updates. * @property {"active" | "inactiv
  * @typedef {Object} PatchedUserProfileUpdateRequest * @description Serializer for updating user profile. * @property {string} [first_name] * @property {string} [last_name] * @property {string} [company] * @property {string} [phone] * @property {string} [position] */
 
 /**
- * @typedef {Object} Payment * @description Complete payment serializer with full details.
-
-Used for detail views and updates. * @property {string} id - Unique identifier for this record * @property {string} user * @property {number} amount_usd - Payment amount in USD (float for performance) * @property {number} currency - Payment currency * @property {number} [network] - Blockchain network (for crypto payments) * @property {"nowpayments"} [provider] - Payment provider
-
-* `nowpayments` - NowPayments * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
-
-* `pending` - Pending
-* `confirming` - Confirming
-* `confirmed` - Confirmed
-* `completed` - Completed
-* `failed` - Failed
-* `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} status_display * @property {string} amount_display - Get formatted amount display. * @property {string} provider_payment_id - Provider's payment ID * @property {string} payment_url - Payment page URL * @property {string} pay_address - Cryptocurrency payment address * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {string} [description] - Payment description * @property {string} transaction_hash - Blockchain transaction hash * @property {number} confirmations_count - Number of blockchain confirmations * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated * @property {string} [expires_at] - When this payment expires * @property {string} completed_at - When this payment was completed * @property {boolean} is_pending - Check if payment is pending. * @property {boolean} is_completed - Check if payment is completed. * @property {boolean} is_failed - Check if payment is failed. * @property {boolean} is_expired - Check if payment is expired. */
-
-/**
- * @typedef {Object} PaymentAnalyticsResponse * @description Payment analytics response with currency and provider breakdown * @property {CurrencyAnalyticsItem[]} currency_analytics - Analytics by currency * @property {ProviderAnalyticsItem[]} provider_analytics - Analytics by provider */
-
-/**
- * @typedef {Object} PaymentCreate * @description Payment creation serializer with Pydantic integration.
-
-Validates input and delegates to PaymentService. * @property {number} amount_usd - Amount in USD (1.00 - 50,000.00) * @property {"BTC" | "ETH" | "LTC" | "XMR" | "USDT" | "USDC" | "ADA" | "DOT"} currency_code - Cryptocurrency to receive
-
-* `BTC` - Bitcoin
-* `ETH` - Ethereum
-* `LTC` - Litecoin
-* `XMR` - Monero
-* `USDT` - Tether
-* `USDC` - USD Coin
-* `ADA` - Cardano
-* `DOT` - Polkadot * @property {"nowpayments"} [provider] - Payment provider
-
-* `nowpayments` - NowPayments * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {string} [description] - Payment description * @property {any} [metadata] - Additional metadata */
-
-/**
- * @typedef {Object} PaymentCreateRequest * @description Payment creation serializer with Pydantic integration.
-
-Validates input and delegates to PaymentService. * @property {number} amount_usd - Amount in USD (1.00 - 50,000.00) * @property {"BTC" | "ETH" | "LTC" | "XMR" | "USDT" | "USDC" | "ADA" | "DOT"} currency_code - Cryptocurrency to receive
-
-* `BTC` - Bitcoin
-* `ETH` - Ethereum
-* `LTC` - Litecoin
-* `XMR` - Monero
-* `USDT` - Tether
-* `USDC` - USD Coin
-* `ADA` - Cardano
-* `DOT` - Polkadot * @property {"nowpayments"} [provider] - Payment provider
-
-* `nowpayments` - NowPayments * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {string} [description] - Payment description * @property {any} [metadata] - Additional metadata */
-
-/**
- * @typedef {Object} PaymentList * @description Lightweight serializer for payment lists.
-
-Optimized for list views with minimal data. * @property {string} id - Unique identifier for this record * @property {number} amount_usd - Payment amount in USD (float for performance) * @property {number} currency - Payment currency * @property {"nowpayments"} provider - Payment provider
-
-* `nowpayments` - NowPayments * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} status - Current payment status
+ * @typedef {Object} PaymentDetail * @description Detailed payment information. * @property {string} id - Unique identifier for this record * @property {string} internal_payment_id - Internal payment identifier (PAY_YYYYMMDDHHMMSS_UUID) * @property {string} amount_usd - Payment amount in USD * @property {string} currency_code * @property {string} currency_name * @property {string} currency_token * @property {string} currency_network * @property {string} pay_amount - Amount to pay in cryptocurrency * @property {string} actual_amount - Actual amount received in cryptocurrency * @property {string} actual_amount_usd - Actual amount received in USD * @property {"pending" | "confirming" | "confirmed" | "completed" | "partially_paid" | "failed" | "expired" | "cancelled"} status - Current payment status
 
 * `pending` - Pending
 * `confirming` - Confirming
 * `confirmed` - Confirmed
 * `completed` - Completed
+* `partially_paid` - Partially Paid
 * `failed` - Failed
 * `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} status_display * @property {string} amount_display - Get formatted amount display. * @property {string} created_at - When this record was created * @property {string} expires_at - When this payment expires */
+* `cancelled` - Cancelled * @property {string} status_display * @property {string} pay_address - Cryptocurrency payment address * @property {string} qr_code_url - Get QR code URL. * @property {string} payment_url - Payment page URL (if provided by provider) * @property {string} transaction_hash - Blockchain transaction hash * @property {string} explorer_link - Get blockchain explorer link. * @property {number} confirmations_count - Number of blockchain confirmations * @property {string} expires_at - When this payment expires (typically 30 minutes) * @property {string} completed_at - When this payment was completed * @property {string} created_at - When this record was created * @property {boolean} is_completed * @property {boolean} is_failed * @property {boolean} is_expired * @property {string} description - Payment description */
 
 /**
- * @typedef {Object} PaymentOverview * @description Payments overview metrics * @property {number} total_payments - Total number of payments * @property {number} completed_payments - Number of completed payments * @property {number} pending_payments - Number of pending payments * @property {number} failed_payments - Number of failed payments * @property {number} total_amount_usd - Total payment amount in USD * @property {number} completed_amount_usd - Total completed amount in USD * @property {number} average_payment_usd - Average payment amount in USD * @property {number} success_rate - Payment success rate percentage * @property {string} last_payment_at - Last payment timestamp * @property {number} payments_this_month - Number of payments this month * @property {number} amount_this_month - Total amount this month * @property {string} top_currency - Most used currency * @property {number} top_currency_count - Usage count for top currency */
-
-/**
- * @typedef {Object} PaymentRequest * @description Complete payment serializer with full details.
-
-Used for detail views and updates. * @property {number} amount_usd - Payment amount in USD (float for performance) * @property {number} currency - Payment currency * @property {number} [network] - Blockchain network (for crypto payments) * @property {"nowpayments"} [provider] - Payment provider
-
-* `nowpayments` - NowPayments * @property {"pending" | "confirming" | "confirmed" | "completed" | "failed" | "expired" | "cancelled" | "refunded"} [status] - Current payment status
+ * @typedef {Object} PaymentList * @description Payment list item (lighter than detail). * @property {string} id - Unique identifier for this record * @property {string} internal_payment_id - Internal payment identifier (PAY_YYYYMMDDHHMMSS_UUID) * @property {string} amount_usd - Payment amount in USD * @property {string} currency_code * @property {string} currency_token * @property {"pending" | "confirming" | "confirmed" | "completed" | "partially_paid" | "failed" | "expired" | "cancelled"} status - Current payment status
 
 * `pending` - Pending
 * `confirming` - Confirming
 * `confirmed` - Confirmed
 * `completed` - Completed
+* `partially_paid` - Partially Paid
 * `failed` - Failed
 * `expired` - Expired
-* `cancelled` - Cancelled
-* `refunded` - Refunded * @property {string} [callback_url] - Success callback URL * @property {string} [cancel_url] - Cancellation URL * @property {string} [description] - Payment description * @property {string} [expires_at] - When this payment expires */
+* `cancelled` - Cancelled * @property {string} status_display * @property {string} created_at - When this record was created * @property {string} completed_at - When this payment was completed */
 
 /**
- * @typedef {Object} PaymentsChartResponse * @description Complete chart response for payments analytics * @property {ChartSeries[]} series - Chart series data * @property {string} period - Time period * @property {number} total_amount - Total amount for period * @property {number} total_payments - Total payments for period * @property {number} success_rate - Success rate for period */
+ * @typedef {Object} PublicCategory * @description Public category serializer. * @property {string} id * @property {string} name - Category name * @property {string} [description] - Category description */
 
 /**
- * @typedef {Object} PaymentsDashboardOverview * @description Complete payments dashboard overview response * @property {any} metrics - Dashboard metrics * @property {RecentPayment[]} recent_payments - Recent payments * @property {RecentTransaction[]} recent_transactions - Recent transactions * @property {any} chart_data - Chart data for analytics */
+ * @typedef {Object} PublicDocument * @description Public document detail serializer - only essential data for clients. * @property {string} id * @property {string} title - Document title * @property {string} content - Full document content * @property {any} category * @property {string} created_at * @property {string} updated_at */
 
 /**
- * @typedef {Object} PaymentsMetrics * @description Complete payments dashboard metrics * @property {any} balance - Balance overview * @property {any} subscription - Subscription overview * @property {any} api_keys - API keys overview * @property {any} payments - Payments overview */
+ * @typedef {Object} PublicDocumentList * @description Public document list serializer - minimal fields for listing. * @property {string} id * @property {string} title - Document title * @property {any} category * @property {string} created_at * @property {string} updated_at */
 
 /**
- * @typedef {Object} ProviderAnalyticsItem * @description Analytics data for a single payment provider * @property {string} provider - Provider code * @property {string} provider_display - Provider display name * @property {number} total_payments - Total number of payments * @property {number} total_amount - Total amount in USD * @property {number} completed_payments - Number of completed payments * @property {number} success_rate - Success rate percentage */
+ * @typedef {Object} PublishTestRequestRequest * @description Request model for test message publishing. * @property {string} channel - Target channel name * @property {Record<string, any>} data - Message data (any JSON object) * @property {boolean} [wait_for_ack] - Wait for client acknowledgment * @property {number} [ack_timeout] - ACK timeout in seconds */
 
 /**
- * @typedef {Object} ProviderCurrency * @description Provider currency serializer for provider-specific currency info.
-
-Used for provider currency management and rates. * @property {number} id * @property {any} currency * @property {any} network * @property {string} provider - Payment provider name (e.g., nowpayments) * @property {string} provider_currency_code - Currency code as used by the provider * @property {number} provider_min_amount_usd - Get minimum amount from provider configuration. * @property {number} provider_max_amount_usd - Get maximum amount from provider configuration. * @property {number} provider_fee_percentage - Get fee percentage from provider configuration. * @property {number} provider_fixed_fee_usd - Get fixed fee from provider configuration. * @property {boolean} is_enabled - Whether this currency is enabled for this provider * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
+ * @typedef {Object} PublishTestResponse * @description Response model for test message publishing. * @property {boolean} success - Whether publish succeeded * @property {string} message_id - Unique message ID * @property {string} channel - Target channel * @property {number} [acks_received] - Number of ACKs received * @property {boolean} [delivered] - Whether message was delivered * @property {any} [error] - Error message if failed */
 
 /**
  * @typedef {Object} QueueAction * @description Serializer for queue management actions. * @property {"clear" | "clear_all" | "purge" | "purge_failed" | "flush"} action - Action to perform on queues
@@ -518,16 +525,7 @@ Used for provider currency management and rates. * @property {number} id * @prop
  * @typedef {Object} QuickHealth * @description Serializer for quick health check response. * @property {string} status - Quick health status: ok or error * @property {string} timestamp - Timestamp of the health check * @property {string} [error] - Error message if health check failed */
 
 /**
- * @typedef {Object} RPCRequest * @description Serializer for individual RPC request. * @property {string} [id] - Stream entry ID * @property {string} [request_id] - Unique request ID * @property {string} timestamp - ISO timestamp of the request * @property {string} method - RPC method name * @property {Record<string, any>} [params] - Request parameters * @property {string} [correlation_id] - Correlation ID for tracking * @property {string} [source] - Source of the request */
-
-/**
- * @typedef {Object} RecentPayment * @description Recent payment item * @property {string} id - Payment ID * @property {string} internal_payment_id - Internal payment ID * @property {number} amount_usd - Payment amount in USD * @property {string} amount_display - Formatted amount display * @property {string} currency_code - Currency code * @property {string} status - Payment status * @property {string} status_display - Human-readable status * @property {string} status_color - Color for status display * @property {string} provider - Payment provider * @property {string} created_at - Payment creation timestamp * @property {string} completed_at - Payment completion timestamp * @property {boolean} is_pending - Whether payment is pending * @property {boolean} is_completed - Whether payment is completed * @property {boolean} is_failed - Whether payment failed */
-
-/**
- * @typedef {Object} RecentRequests * @description Serializer for recent requests response. * @property {RPCRequest[]} requests - List of recent RPC requests * @property {number} count - Number of requests returned * @property {number} total_available - Total number of requests available */
-
-/**
- * @typedef {Object} RecentTransaction * @description Recent transaction item * @property {string} id - Transaction ID * @property {string} transaction_type - Transaction type * @property {number} amount_usd - Transaction amount in USD * @property {string} amount_display - Formatted amount display * @property {number} balance_after - Balance after transaction * @property {string} description - Transaction description * @property {string} created_at - Transaction timestamp * @property {string} payment_id - Related payment ID * @property {boolean} is_credit - Whether this is a credit transaction * @property {boolean} is_debit - Whether this is a debit transaction * @property {string} type_color - Color for transaction type display */
+ * @typedef {Object} RecentPublishes * @description Recent publishes list. * @property {Record<string, any>[]} publishes - List of recent publishes * @property {number} count - Number of publishes returned * @property {number} total_available - Total publishes available */
 
 /**
  * @typedef {Object} SendCampaignRequest * @description Simple serializer for sending campaign. * @property {number} campaign_id */
@@ -544,73 +542,9 @@ Used for provider currency management and rates. * @property {number} id * @prop
 /**
  * @typedef {Object} SubscribeResponse * @description Response for subscription. * @property {boolean} success * @property {string} message * @property {number} [subscription_id] */
 
-/**
- * @typedef {Object} Subscription * @description Complete subscription serializer with full details.
-
-Used for subscription detail views and updates. * @property {string} id - Unique identifier for this record * @property {string} user * @property {any} tariff * @property {any} endpoint_group * @property {"active" | "inactive" | "suspended" | "cancelled" | "expired"} [status] - Subscription status
-
-* `active` - Active
-* `inactive` - Inactive
-* `suspended` - Suspended
-* `cancelled` - Cancelled
-* `expired` - Expired * @property {string} status_display * @property {string} status_color - Get color for status display. * @property {"free" | "basic" | "pro" | "enterprise"} [tier] - Subscription tier
-
-* `free` - Free Tier
-* `basic` - Basic Tier
-* `pro` - Pro Tier
-* `enterprise` - Enterprise Tier * @property {number} total_requests - Total API requests made with this subscription * @property {number} usage_percentage - Get usage percentage for current period. * @property {string} last_request_at - When the last API request was made * @property {string} expires_at - When this subscription expires * @property {boolean} is_active - Check if subscription is active and not expired. * @property {boolean} is_expired - Check if subscription is expired. * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
-
-/**
- * @typedef {Object} SubscriptionCreate * @description Subscription creation serializer with service integration.
-
-Validates input and delegates to SubscriptionService. * @property {number} tariff_id - Tariff ID for the subscription * @property {number} [endpoint_group_id] - Endpoint group ID (optional) * @property {number} [duration_days] - Subscription duration in days */
-
-/**
- * @typedef {Object} SubscriptionCreateRequest * @description Subscription creation serializer with service integration.
-
-Validates input and delegates to SubscriptionService. * @property {number} tariff_id - Tariff ID for the subscription * @property {number} [endpoint_group_id] - Endpoint group ID (optional) * @property {number} [duration_days] - Subscription duration in days */
-
-/**
- * @typedef {Object} SubscriptionList * @description Lightweight subscription serializer for lists.
-
-Optimized for subscription lists with minimal data. * @property {string} id - Unique identifier for this record * @property {string} user * @property {string} tariff_name * @property {"active" | "inactive" | "suspended" | "cancelled" | "expired"} status - Subscription status
-
-* `active` - Active
-* `inactive` - Inactive
-* `suspended` - Suspended
-* `cancelled` - Cancelled
-* `expired` - Expired * @property {string} status_display * @property {boolean} is_active - Check if subscription is active and not expired. * @property {boolean} is_expired - Check if subscription is expired. * @property {string} expires_at - When this subscription expires * @property {string} created_at - When this record was created */
-
-/**
- * @typedef {Object} SubscriptionOverview * @description Current subscription overview * @property {string} tier - Subscription tier * @property {string} tier_display - Human-readable tier name * @property {string} status - Subscription status * @property {string} status_display - Human-readable status * @property {string} status_color - Color for status display * @property {boolean} is_active - Whether subscription is active * @property {boolean} is_expired - Whether subscription is expired * @property {number} days_remaining - Days until expiration * @property {number} requests_per_hour - Hourly request limit * @property {number} requests_per_day - Daily request limit * @property {number} total_requests - Total requests made * @property {number} usage_percentage - Usage percentage for current period * @property {number} monthly_cost_usd - Monthly cost in USD * @property {string} cost_display - Formatted cost display * @property {string} starts_at - Subscription start date * @property {string} expires_at - Subscription expiration date * @property {string} last_request_at - Last API request timestamp * @property {number} endpoint_groups_count - Number of accessible endpoint groups * @property {string[]} endpoint_groups - List of accessible endpoint group names */
-
-/**
- * @typedef {Object} SubscriptionRequest * @description Complete subscription serializer with full details.
-
-Used for subscription detail views and updates. * @property {"active" | "inactive" | "suspended" | "cancelled" | "expired"} [status] - Subscription status
-
-* `active` - Active
-* `inactive` - Inactive
-* `suspended` - Suspended
-* `cancelled` - Cancelled
-* `expired` - Expired * @property {"free" | "basic" | "pro" | "enterprise"} [tier] - Subscription tier
-
-* `free` - Free Tier
-* `basic` - Basic Tier
-* `pro` - Pro Tier
-* `enterprise` - Enterprise Tier * @property {string} expires_at - When this subscription expires */
-
 /**
  * @typedef {Object} SuccessResponse * @description Generic success response. * @property {boolean} success * @property {string} message */
 
-/**
- * @typedef {Object} SupportedProviders * @description Serializer for supported providers response. * @property {boolean} success - Request success status * @property {any} providers - List of supported providers * @property {number} total_count - Total number of providers * @property {string} timestamp - Response timestamp */
-
-/**
- * @typedef {Object} Tariff * @description Tariff serializer for subscription pricing.
-
-Used for tariff information and selection. * @property {number} id * @property {string} name - Tariff name (e.g., 'Free', 'Basic', 'Pro') * @property {string} description - Detailed description of what this tariff includes * @property {number} monthly_price_usd - Monthly price in USD * @property {number} requests_per_month - API requests allowed per month * @property {number} requests_per_hour - API requests allowed per hour * @property {boolean} is_active - Whether this tariff is available for new subscriptions * @property {EndpointGroup[]} endpoint_groups * @property {number} endpoint_groups_count * @property {string} created_at - When this record was created * @property {string} updated_at - When this record was last updated */
-
 /**
  * @typedef {Object} TaskStatistics * @description Serializer for task statistics data. * @property {Record<string, number>} statistics - Task count statistics * @property {Record<string, any>[]} recent_tasks - List of recent tasks * @property {string} timestamp - Current timestamp * @property {string} [error] - Error message if any */
 
@@ -638,9 +572,7 @@ Used for tariff information and selection. * @property {number} id * @property {
  * @typedef {Object} TokenRefreshRequest * @property {string} refresh */
 
 /**
- * @typedef {Object} Transaction * @description Transaction serializer with full details.
-
-Used for transaction history and details. * @property {string} id - Unique identifier for this record * @property {string} user * @property {number} amount_usd - Transaction amount in USD (positive=credit, negative=debit) * @property {string} amount_display * @property {"deposit" | "withdrawal" | "payment" | "refund" | "fee" | "bonus" | "adjustment"} transaction_type - Type of transaction
+ * @typedef {Object} Transaction * @description Transaction serializer. * @property {string} id - Unique identifier for this record * @property {"deposit" | "withdrawal" | "payment" | "refund" | "fee" | "bonus" | "adjustment"} transaction_type - Type of transaction
 
 * `deposit` - Deposit
 * `withdrawal` - Withdrawal
@@ -648,7 +580,7 @@ Used for transaction history and details. * @property {string} id - Unique ident
 * `refund` - Refund
 * `fee` - Fee
 * `bonus` - Bonus
-* `adjustment` - Adjustment * @property {string} type_color * @property {string} description - Transaction description * @property {string} payment_id - Related payment ID (if applicable) * @property {any} metadata - Additional transaction metadata * @property {boolean} is_credit * @property {boolean} is_debit * @property {string} created_at - When this record was created */
+* `adjustment` - Adjustment * @property {string} type_display * @property {string} amount_usd - Transaction amount in USD (positive=credit, negative=debit) * @property {string} amount_display * @property {string} balance_after - User balance after this transaction * @property {string} payment_id - Related payment ID (if applicable) * @property {string} description - Transaction description * @property {string} created_at - When this record was created */
 
 /**
  * @typedef {Object} Unsubscribe * @description Simple serializer for unsubscribe. * @property {number} subscription_id */
@@ -657,58 +589,16 @@ Used for transaction history and details. * @property {string} id - Unique ident
  * @typedef {Object} UnsubscribeRequest * @description Simple serializer for unsubscribe. * @property {number} subscription_id */
 
 /**
- * @typedef {Object} User * @description Serializer for user details. * @property {number} id * @property {string} email * @property {string} [first_name] * @property {string} [last_name] * @property {string} full_name - Get user's full name. * @property {string} initials - Get user's initials for avatar fallback. * @property {string} display_username - Get formatted username for display. * @property {string} [company] * @property {string} [phone] * @property {string} [position] * @property {string} [avatar] * @property {boolean} is_staff - Designates whether the user can log into this admin site. * @property {boolean} is_superuser - Designates that this user has all permissions without explicitly assigning them. * @property {string} date_joined * @property {string} last_login * @property {number} unanswered_messages_count - Get count of unanswered messages for the user. */
-
-/**
- * @typedef {Object} UserBalance * @description User balance serializer with computed fields.
-
-Provides balance information with display helpers. * @property {string} user * @property {number} balance_usd - Current balance in USD (float for performance) * @property {string} balance_display - Formatted balance display. * @property {boolean} is_empty - Check if balance is zero. * @property {boolean} has_transactions - Check if user has any transactions. * @property {string} created_at * @property {string} updated_at */
+ * @typedef {Object} User * @description Serializer for user details. * @property {number} id * @property {string} email * @property {string} [first_name] * @property {string} [last_name] * @property {string} full_name - Get user's full name. * @property {string} initials - Get user's initials for avatar fallback. * @property {string} display_username - Get formatted username for display. * @property {string} [company] * @property {string} [phone] * @property {string} [position] * @property {string} avatar * @property {boolean} is_staff - Designates whether the user can log into this admin site. * @property {boolean} is_superuser - Designates that this user has all permissions without explicitly assigning them. * @property {string} date_joined * @property {string} last_login * @property {number} unanswered_messages_count - Get count of unanswered messages for the user. */
 
 /**
  * @typedef {Object} UserProfileUpdateRequest * @description Serializer for updating user profile. * @property {string} [first_name] * @property {string} [last_name] * @property {string} [company] * @property {string} [phone] * @property {string} [position] */
 
 /**
- * @typedef {Object} WebhookEvent * @description Serializer for individual webhook event. * @property {number} id * @property {string} provider * @property {string} event_type * @property {"success" | "failed" | "pending" | "retry"} status - * `success` - Success
-* `failed` - Failed
-* `pending` - Pending
-* `retry` - Retry * @property {string} timestamp * @property {number} payload_size - Size in bytes * @property {number} response_time - Response time in ms * @property {number} [retry_count] * @property {string} [error_message] * @property {string} [payload_preview] * @property {number} [response_status_code] * @property {string} [webhook_url] */
-
-/**
- * @typedef {Object} WebhookEventList * @description Serializer for paginated webhook events list. * @property {WebhookEvent[]} events * @property {number} total * @property {number} page * @property {number} per_page * @property {boolean} has_next * @property {boolean} has_previous */
-
-/**
- * @typedef {Object} WebhookEventListRequest * @description Serializer for paginated webhook events list. * @property {WebhookEventRequest[]} events * @property {number} total * @property {number} page * @property {number} per_page * @property {boolean} has_next * @property {boolean} has_previous */
-
-/**
- * @typedef {Object} WebhookEventRequest * @description Serializer for individual webhook event. * @property {string} provider * @property {string} event_type * @property {"success" | "failed" | "pending" | "retry"} status - * `success` - Success
-* `failed` - Failed
-* `pending` - Pending
-* `retry` - Retry * @property {string} timestamp * @property {number} payload_size - Size in bytes * @property {number} response_time - Response time in ms * @property {number} [retry_count] * @property {string} [error_message] * @property {string} [payload_preview] * @property {number} [response_status_code] * @property {string} [webhook_url] */
-
-/**
- * @typedef {Object} WebhookHealth * @description Serializer for webhook health check response. * @property {string} status - Health status * @property {string} timestamp - Check timestamp * @property {any} providers - Provider health status */
-
-/**
- * @typedef {Object} WebhookProviderStats * @description Serializer for provider-specific webhook statistics. * @property {number} total * @property {number} successful * @property {number} failed * @property {number} [pending] * @property {number} success_rate */
-
-/**
- * @typedef {Object} WebhookProviderStatsRequest * @description Serializer for provider-specific webhook statistics. * @property {number} total * @property {number} successful * @property {number} failed * @property {number} [pending] * @property {number} success_rate */
-
-/**
- * @typedef {Object} WebhookResponse * @description Serializer for webhook processing response.
-
-Standard response format for all webhook endpoints. * @property {boolean} success - Whether webhook was processed successfully * @property {string} message - Processing result message * @property {string} [payment_id] - Internal payment ID * @property {string} [provider_payment_id] - Provider payment ID * @property {string} [processed_at] - Processing timestamp */
-
-/**
- * @typedef {Object} WebhookResponseRequest * @description Serializer for webhook processing response.
-
-Standard response format for all webhook endpoints. * @property {boolean} success - Whether webhook was processed successfully * @property {string} message - Processing result message * @property {string} [payment_id] - Internal payment ID * @property {string} [provider_payment_id] - Provider payment ID * @property {string} [processed_at] - Processing timestamp */
-
-/**
- * @typedef {Object} WebhookStats * @description Serializer for comprehensive webhook statistics. * @property {number} total * @property {number} successful * @property {number} failed * @property {number} pending * @property {number} success_rate * @property {Record<string, WebhookProviderStats>} providers - Statistics by provider * @property {Record<string, number>} last_24h - Events in last 24 hours * @property {number} avg_response_time * @property {number} max_response_time */
+ * @typedef {Object} VectorizationResult * @description Vectorization result serializer. * @property {number} vectorized_count * @property {number} failed_count * @property {number} total_tokens * @property {number} total_cost * @property {number} success_rate * @property {string[]} errors */
 
 /**
- * @typedef {Object} WebhookStatsRequest * @description Serializer for comprehensive webhook statistics. * @property {number} total * @property {number} successful * @property {number} failed * @property {number} pending * @property {number} success_rate * @property {Record<string, WebhookProviderStatsRequest>} providers - Statistics by provider * @property {Record<string, number>} last_24h - Events in last 24 hours * @property {number} avg_response_time * @property {number} max_response_time */
+ * @typedef {Object} VectorizationStatistics * @description Vectorization statistics serializer. * @property {number} total_chunks * @property {number} vectorized_chunks * @property {number} pending_chunks * @property {number} vectorization_rate * @property {number} total_tokens * @property {number} total_cost * @property {number} avg_tokens_per_chunk * @property {number} avg_cost_per_chunk */
 
 /**
  * @typedef {Object} WorkerAction * @description Serializer for worker management actions. * @property {"start" | "stop" | "restart"} action - Action to perform on workers