mcp-server-rocketchat-threads 1.0.0

package/dist/formatters/message-formatter.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Message Formatter
+ * Transforms Rocket.Chat API responses into MCP-friendly formats
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMessage = formatMessage;
+exports.formatMessages = formatMessages;
+exports.formatChannel = formatChannel;
+exports.formatChannels = formatChannels;
+exports.formatThread = formatThread;
+exports.formatThreads = formatThreads;
+exports.formatUser = formatUser;
+exports.formatUsers = formatUsers;
+exports.formatThreadWithReplies = formatThreadWithReplies;
+exports.createSearchSummary = createSearchSummary;
+/**
+ * Format a single message for MCP response
+ * Supports both regular messages and search results with OpenSearch fields
+ */
+function formatMessage(msg) {
+    const searchMsg = msg;
+    const result = {
+        id: msg._id,
+        roomId: msg.rid,
+        text: msg.msg,
+        author: {
+            id: msg.u._id,
+            username: msg.u.username,
+            displayName: msg.u.name
+        },
+        timestamp: msg.ts,
+        threadId: msg.tmid,
+        replyCount: msg.tcount,
+        lastReplyAt: msg.tlm,
+        reactions: msg.reactions
+            ? Object.fromEntries(Object.entries(msg.reactions).map(([emoji, data]) => [emoji, data.usernames.length]))
+            : undefined,
+        hasAttachments: (msg.attachments?.length || 0) > 0,
+        isPinned: msg.pinned || false
+    };
+    // Add OpenSearch fields if present
+    if (searchMsg._highlight) {
+        result.highlight = searchMsg._highlight;
+    }
+    if (searchMsg._score !== undefined) {
+        result.score = searchMsg._score;
+    }
+    return result;
+}
+/**
+ * Format multiple messages
+ */
+function formatMessages(messages) {
+    return messages.map(formatMessage);
+}
+/**
+ * Format a channel for MCP response
+ */
+function formatChannel(room) {
+    const typeMap = {
+        'c': 'public',
+        'p': 'private',
+        'd': 'direct',
+        'l': 'livechat'
+    };
+    return {
+        id: room._id,
+        name: room.name || room._id,
+        displayName: room.fname,
+        type: typeMap[room.t] || 'public',
+        memberCount: room.usersCount,
+        messageCount: room.msgs,
+        topic: room.topic,
+        description: room.description,
+        isReadOnly: room.ro || false,
+        lastActivity: room._updatedAt
+    };
+}
+/**
+ * Format multiple channels
+ */
+function formatChannels(rooms) {
+    return rooms.map(formatChannel);
+}
+/**
+ * Format a thread for MCP response
+ */
+function formatThread(msg, roomName) {
+    // Truncate title to first 100 characters
+    const title = msg.msg.length > 100
+        ? msg.msg.substring(0, 100) + '...'
+        : msg.msg;
+    return {
+        id: msg._id,
+        roomId: msg.rid,
+        roomName,
+        title,
+        author: {
+            id: msg.u._id,
+            username: msg.u.username,
+            displayName: msg.u.name
+        },
+        createdAt: msg.ts,
+        replyCount: msg.tcount || 0,
+        lastReplyAt: msg.tlm || msg.ts,
+        participants: msg.replies || []
+    };
+}
+/**
+ * Format multiple threads
+ */
+function formatThreads(messages, roomName) {
+    return messages.map(msg => formatThread(msg, roomName));
+}
+/**
+ * Format a user for MCP response
+ */
+function formatUser(user) {
+    return {
+        id: user._id,
+        username: user.username,
+        displayName: user.name,
+        email: user.emails?.[0]?.address,
+        status: user.status || 'offline',
+        roles: user.roles || []
+    };
+}
+/**
+ * Format multiple users
+ */
+function formatUsers(users) {
+    return users.map(formatUser);
+}
+function formatThreadWithReplies(parentMsg, replies, roomName) {
+    return {
+        thread: formatThread(parentMsg, roomName),
+        parentMessage: formatMessage(parentMsg),
+        replies: formatMessages(replies),
+        totalReplies: parentMsg.tcount || replies.length
+    };
+}
+function createSearchSummary(query, messages, totalResults) {
+    const timestamps = messages.map(m => new Date(m.ts).getTime());
+    const threadIds = new Set(messages.filter(m => m.tmid).map(m => m.tmid));
+    const channelIds = new Set(messages.map(m => m.rid));
+    return {
+        query,
+        totalResults,
+        channels: channelIds.size,
+        threads: threadIds.size,
+        messages: messages.length,
+        timeRange: messages.length > 0
+            ? {
+                oldest: new Date(Math.min(...timestamps)).toISOString(),
+                newest: new Date(Math.max(...timestamps)).toISOString()
+            }
+            : undefined
+    };
+}
+//# sourceMappingURL=message-formatter.js.map

package/dist/formatters/message-formatter.js.map

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

package/dist/formatters/response-builder.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Response Builder
+ * Creates standardized MCP tool responses with consistent structure
+ */
+export interface McpToolResponse {
+    success: boolean;
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+        details?: string;
+        suggestion?: string;
+    };
+    metadata?: {
+        count?: number;
+        total?: number;
+        offset?: number;
+        truncated?: boolean;
+        executionTime?: number;
+    };
+}
+/**
+ * Build a successful response
+ */
+export declare function buildSuccessResponse<T>(data: T, metadata?: McpToolResponse['metadata']): McpToolResponse;
+/**
+ * Build a paginated success response
+ */
+export declare function buildPaginatedResponse<T>(items: T[], total: number, offset: number, truncated?: boolean): McpToolResponse;
+/**
+ * Build an error response following What-Why-How pattern
+ */
+export declare function buildErrorResponse(code: string, what: string, why?: string, how?: string): McpToolResponse;
+/**
+ * Common error responses
+ */
+export declare const CommonErrors: {
+    NOT_FOUND: (resource: string, identifier: string) => McpToolResponse;
+    UNAUTHORIZED: () => McpToolResponse;
+    FORBIDDEN: (action: string, resource: string) => McpToolResponse;
+    WRITE_DISABLED: () => McpToolResponse;
+    ROOM_NOT_WRITABLE: (roomId: string, whitelist: string[]) => McpToolResponse;
+    RATE_LIMITED: (retryAfter?: number) => McpToolResponse;
+    VALIDATION_ERROR: (field: string, requirement: string) => McpToolResponse;
+    API_ERROR: (statusCode: number, message: string) => McpToolResponse;
+    CONNECTION_ERROR: () => McpToolResponse;
+    TIMEOUT: () => McpToolResponse;
+};
+/**
+ * Serialize response to JSON string with token limiting
+ */
+export declare function serializeResponse(response: McpToolResponse): string;
+/**
+ * Format response for MCP text content
+ */
+export declare function formatAsTextContent(response: McpToolResponse): {
+    type: 'text';
+    text: string;
+}[];
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/formatters/response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../src/formatters/response-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACL;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,IAAI,EAAE,CAAC,EACP,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,GACvC,eAAe,CAMjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,OAAe,GAC3B,eAAe,CAWjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACb,eAAe,CAUjB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;0BACC,MAAM,cAAc,MAAM;;wBAc5B,MAAM,YAAY,MAAM;;gCAchB,MAAM,aAAa,MAAM,EAAE;gCAS3B,MAAM;8BASR,MAAM,eAAe,MAAM;4BAO7B,MAAM,WAAW,MAAM;;;CAoBlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CA+BnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAK/F"}

package/dist/formatters/response-builder.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Response Builder
+ * Creates standardized MCP tool responses with consistent structure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommonErrors = void 0;
+exports.buildSuccessResponse = buildSuccessResponse;
+exports.buildPaginatedResponse = buildPaginatedResponse;
+exports.buildErrorResponse = buildErrorResponse;
+exports.serializeResponse = serializeResponse;
+exports.formatAsTextContent = formatAsTextContent;
+const token_counter_js_1 = require("../utils/token-counter.js");
+/**
+ * Build a successful response
+ */
+function buildSuccessResponse(data, metadata) {
+    return {
+        success: true,
+        data,
+        metadata
+    };
+}
+/**
+ * Build a paginated success response
+ */
+function buildPaginatedResponse(items, total, offset, truncated = false) {
+    return {
+        success: true,
+        data: items,
+        metadata: {
+            count: items.length,
+            total,
+            offset,
+            truncated
+        }
+    };
+}
+/**
+ * Build an error response following What-Why-How pattern
+ */
+function buildErrorResponse(code, what, why, how) {
+    return {
+        success: false,
+        error: {
+            code,
+            message: what,
+            details: why,
+            suggestion: how
+        }
+    };
+}
+/**
+ * Common error responses
+ */
+exports.CommonErrors = {
+    NOT_FOUND: (resource, identifier) => buildErrorResponse('NOT_FOUND', `${resource} not found`, `No ${resource} with identifier "${identifier}" exists`, `Check the ${resource} ID or name and try again`),
+    UNAUTHORIZED: () => buildErrorResponse('UNAUTHORIZED', 'Authentication failed', 'Invalid or expired authentication token', 'Check ROCKETCHAT_AUTH_TOKEN and ROCKETCHAT_USER_ID environment variables'),
+    FORBIDDEN: (action, resource) => buildErrorResponse('FORBIDDEN', `Cannot ${action} ${resource}`, 'You do not have permission to perform this action', 'Request access from a channel administrator'),
+    WRITE_DISABLED: () => buildErrorResponse('WRITE_DISABLED', 'Write operations are disabled', 'The MCP server is configured in read-only mode', 'Set ROCKETCHAT_WRITE_ENABLED=true to enable write operations'),
+    ROOM_NOT_WRITABLE: (roomId, whitelist) => buildErrorResponse('ROOM_NOT_WRITABLE', 'Cannot write to this room', `Room "${roomId}" is not in the allowed write list`, whitelist.length > 0
+        ? `Allowed rooms: ${whitelist.join(', ')}`
+        : 'Configure ROCKETCHAT_WRITE_ROOMS to allow write access'),
+    RATE_LIMITED: (retryAfter) => buildErrorResponse('RATE_LIMITED', 'Too many requests', 'The Rocket.Chat API rate limit has been exceeded', retryAfter
+        ? `Wait ${retryAfter} seconds before retrying`
+        : 'Reduce request frequency and try again'),
+    VALIDATION_ERROR: (field, requirement) => buildErrorResponse('VALIDATION_ERROR', `Invalid parameter: ${field}`, requirement, `Provide a valid value for "${field}"`),
+    API_ERROR: (statusCode, message) => buildErrorResponse('API_ERROR', `Rocket.Chat API error (${statusCode})`, message, 'Check the Rocket.Chat server status and logs'),
+    CONNECTION_ERROR: () => buildErrorResponse('CONNECTION_ERROR', 'Cannot connect to Rocket.Chat server', 'The server may be down or the URL is incorrect', 'Verify ROCKETCHAT_URL and ensure the server is running'),
+    TIMEOUT: () => buildErrorResponse('TIMEOUT', 'Request timed out', 'The Rocket.Chat server took too long to respond', 'Try again with smaller limits or a more specific query')
+};
+/**
+ * Serialize response to JSON string with token limiting
+ */
+function serializeResponse(response) {
+    const json = JSON.stringify(response, null, 2);
+    // Check if response exceeds token limit
+    if (token_counter_js_1.TokenCounter.wouldExceedLimit(json)) {
+        // If response is an array, truncate items
+        if (Array.isArray(response.data)) {
+            const { items, truncated } = token_counter_js_1.TokenCounter.truncateToFit(response.data, item => JSON.stringify(item));
+            const truncatedResponse = {
+                ...response,
+                data: items,
+                metadata: {
+                    ...response.metadata,
+                    truncated: truncated,
+                    count: items.length
+                }
+            };
+            return JSON.stringify(truncatedResponse, null, 2);
+        }
+        // For non-array data, truncate the JSON string
+        const { text } = token_counter_js_1.TokenCounter.truncateText(json);
+        return text;
+    }
+    return json;
+}
+/**
+ * Format response for MCP text content
+ */
+function formatAsTextContent(response) {
+    return [{
+            type: 'text',
+            text: serializeResponse(response)
+        }];
+}
+//# sourceMappingURL=response-builder.js.map

package/dist/formatters/response-builder.js.map

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

package/dist/guards/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Guards module - Security and access control
+ */
+export { WriteGuard, getWriteGuard, resetWriteGuard } from './write-guard.js';
+export type { WriteCheckResult } from './write-guard.js';
+export { MessageSanitizer, getSanitizer, resetSanitizer } from './sanitizer.js';
+export type { SanitizeResult } from './sanitizer.js';
+export { InputValidator, validateRoomId, validateMessageId, validateUserId, validateUsername, validateQuery, validateMessageText, validateEmoji, validateLimit, validateOffset, escapeHtml, MAX_LENGTHS } from './input-validator.js';
+export type { ValidationResult } from './input-validator.js';
+export { RateLimiter, RateLimiterManager, getRateLimiterManager, resetRateLimiterManager, checkRateLimit, checkApiRateLimit, checkWriteRateLimit, checkSearchRateLimit, DEFAULT_LIMITS } from './rate-limiter.js';
+export type { RateLimitConfig, RateLimitResult } from './rate-limiter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChF,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EACH,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/guards/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Guards module - Security and access control
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LIMITS = exports.checkSearchRateLimit = exports.checkWriteRateLimit = exports.checkApiRateLimit = exports.checkRateLimit = exports.resetRateLimiterManager = exports.getRateLimiterManager = exports.RateLimiterManager = exports.RateLimiter = exports.MAX_LENGTHS = exports.escapeHtml = exports.validateOffset = exports.validateLimit = exports.validateEmoji = exports.validateMessageText = exports.validateQuery = exports.validateUsername = exports.validateUserId = exports.validateMessageId = exports.validateRoomId = exports.InputValidator = exports.resetSanitizer = exports.getSanitizer = exports.MessageSanitizer = exports.resetWriteGuard = exports.getWriteGuard = exports.WriteGuard = void 0;
+// Write guard
+var write_guard_js_1 = require("./write-guard.js");
+Object.defineProperty(exports, "WriteGuard", { enumerable: true, get: function () { return write_guard_js_1.WriteGuard; } });
+Object.defineProperty(exports, "getWriteGuard", { enumerable: true, get: function () { return write_guard_js_1.getWriteGuard; } });
+Object.defineProperty(exports, "resetWriteGuard", { enumerable: true, get: function () { return write_guard_js_1.resetWriteGuard; } });
+// Message sanitizer
+var sanitizer_js_1 = require("./sanitizer.js");
+Object.defineProperty(exports, "MessageSanitizer", { enumerable: true, get: function () { return sanitizer_js_1.MessageSanitizer; } });
+Object.defineProperty(exports, "getSanitizer", { enumerable: true, get: function () { return sanitizer_js_1.getSanitizer; } });
+Object.defineProperty(exports, "resetSanitizer", { enumerable: true, get: function () { return sanitizer_js_1.resetSanitizer; } });
+// Input validator
+var input_validator_js_1 = require("./input-validator.js");
+Object.defineProperty(exports, "InputValidator", { enumerable: true, get: function () { return input_validator_js_1.InputValidator; } });
+Object.defineProperty(exports, "validateRoomId", { enumerable: true, get: function () { return input_validator_js_1.validateRoomId; } });
+Object.defineProperty(exports, "validateMessageId", { enumerable: true, get: function () { return input_validator_js_1.validateMessageId; } });
+Object.defineProperty(exports, "validateUserId", { enumerable: true, get: function () { return input_validator_js_1.validateUserId; } });
+Object.defineProperty(exports, "validateUsername", { enumerable: true, get: function () { return input_validator_js_1.validateUsername; } });
+Object.defineProperty(exports, "validateQuery", { enumerable: true, get: function () { return input_validator_js_1.validateQuery; } });
+Object.defineProperty(exports, "validateMessageText", { enumerable: true, get: function () { return input_validator_js_1.validateMessageText; } });
+Object.defineProperty(exports, "validateEmoji", { enumerable: true, get: function () { return input_validator_js_1.validateEmoji; } });
+Object.defineProperty(exports, "validateLimit", { enumerable: true, get: function () { return input_validator_js_1.validateLimit; } });
+Object.defineProperty(exports, "validateOffset", { enumerable: true, get: function () { return input_validator_js_1.validateOffset; } });
+Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return input_validator_js_1.escapeHtml; } });
+Object.defineProperty(exports, "MAX_LENGTHS", { enumerable: true, get: function () { return input_validator_js_1.MAX_LENGTHS; } });
+// Rate limiter
+var rate_limiter_js_1 = require("./rate-limiter.js");
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return rate_limiter_js_1.RateLimiter; } });
+Object.defineProperty(exports, "RateLimiterManager", { enumerable: true, get: function () { return rate_limiter_js_1.RateLimiterManager; } });
+Object.defineProperty(exports, "getRateLimiterManager", { enumerable: true, get: function () { return rate_limiter_js_1.getRateLimiterManager; } });
+Object.defineProperty(exports, "resetRateLimiterManager", { enumerable: true, get: function () { return rate_limiter_js_1.resetRateLimiterManager; } });
+Object.defineProperty(exports, "checkRateLimit", { enumerable: true, get: function () { return rate_limiter_js_1.checkRateLimit; } });
+Object.defineProperty(exports, "checkApiRateLimit", { enumerable: true, get: function () { return rate_limiter_js_1.checkApiRateLimit; } });
+Object.defineProperty(exports, "checkWriteRateLimit", { enumerable: true, get: function () { return rate_limiter_js_1.checkWriteRateLimit; } });
+Object.defineProperty(exports, "checkSearchRateLimit", { enumerable: true, get: function () { return rate_limiter_js_1.checkSearchRateLimit; } });
+Object.defineProperty(exports, "DEFAULT_LIMITS", { enumerable: true, get: function () { return rate_limiter_js_1.DEFAULT_LIMITS; } });
+//# sourceMappingURL=index.js.map

package/dist/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,cAAc;AACd,mDAA8E;AAArE,4GAAA,UAAU,OAAA;AAAE,+GAAA,aAAa,OAAA;AAAE,iHAAA,eAAe,OAAA;AAGnD,oBAAoB;AACpB,+CAAgF;AAAvE,gHAAA,gBAAgB,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,8GAAA,cAAc,OAAA;AAGvD,kBAAkB;AAClB,2DAa8B;AAZ1B,oHAAA,cAAc,OAAA;AACd,oHAAA,cAAc,OAAA;AACd,uHAAA,iBAAiB,OAAA;AACjB,oHAAA,cAAc,OAAA;AACd,sHAAA,gBAAgB,OAAA;AAChB,mHAAA,aAAa,OAAA;AACb,yHAAA,mBAAmB,OAAA;AACnB,mHAAA,aAAa,OAAA;AACb,mHAAA,aAAa,OAAA;AACb,oHAAA,cAAc,OAAA;AACd,gHAAA,UAAU,OAAA;AACV,iHAAA,WAAW,OAAA;AAIf,eAAe;AACf,qDAU2B;AATvB,8GAAA,WAAW,OAAA;AACX,qHAAA,kBAAkB,OAAA;AAClB,wHAAA,qBAAqB,OAAA;AACrB,0HAAA,uBAAuB,OAAA;AACvB,iHAAA,cAAc,OAAA;AACd,oHAAA,iBAAiB,OAAA;AACjB,sHAAA,mBAAmB,OAAA;AACnB,uHAAA,oBAAoB,OAAA;AACpB,iHAAA,cAAc,OAAA"}

package/dist/guards/input-validator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Input Validator - Validates and sanitizes input parameters
+ * Provides defense against injection attacks and malformed input
+ */
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    sanitized?: string;
+}
+/**
+ * Maximum lengths for various input types
+ */
+export declare const MAX_LENGTHS: {
+    readonly roomId: 64;
+    readonly messageId: 64;
+    readonly threadId: 64;
+    readonly userId: 64;
+    readonly username: 128;
+    readonly query: 500;
+    readonly messageText: 10000;
+    readonly emoji: 64;
+};
+/**
+ * Input validator class
+ */
+export declare class InputValidator {
+    /**
+     * Validate a room ID
+     */
+    static validateRoomId(roomId: unknown): ValidationResult;
+    /**
+     * Validate a message ID
+     */
+    static validateMessageId(messageId: unknown): ValidationResult;
+    /**
+     * Validate a user ID
+     */
+    static validateUserId(userId: unknown): ValidationResult;
+    /**
+     * Validate a username
+     */
+    static validateUsername(username: unknown): ValidationResult;
+    /**
+     * Validate a search query
+     */
+    static validateQuery(query: unknown): ValidationResult;
+    /**
+     * Validate message text
+     */
+    static validateMessageText(text: unknown): ValidationResult;
+    /**
+     * Validate an emoji
+     */
+    static validateEmoji(emoji: unknown): ValidationResult;
+    /**
+     * Validate pagination limit
+     */
+    static validateLimit(limit: unknown, min?: number, max?: number, defaultValue?: number): number;
+    /**
+     * Validate pagination offset
+     */
+    static validateOffset(offset: unknown, defaultValue?: number): number;
+    /**
+     * Check if string contains dangerous patterns
+     */
+    private static containsDangerousPattern;
+    /**
+     * Escape HTML entities for safe display
+     */
+    static escapeHtml(text: string): string;
+    /**
+     * Validate and sanitize a generic string input
+     */
+    static validateString(value: unknown, fieldName: string, maxLength: number, required?: boolean): ValidationResult;
+}
+export declare const validateRoomId: typeof InputValidator.validateRoomId;
+export declare const validateMessageId: typeof InputValidator.validateMessageId;
+export declare const validateUserId: typeof InputValidator.validateUserId;
+export declare const validateUsername: typeof InputValidator.validateUsername;
+export declare const validateQuery: typeof InputValidator.validateQuery;
+export declare const validateMessageText: typeof InputValidator.validateMessageText;
+export declare const validateEmoji: typeof InputValidator.validateEmoji;
+export declare const validateLimit: typeof InputValidator.validateLimit;
+export declare const validateOffset: typeof InputValidator.validateOffset;
+export declare const escapeHtml: typeof InputValidator.escapeHtml;
+//# sourceMappingURL=input-validator.d.ts.map

package/dist/guards/input-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validator.d.ts","sourceRoot":"","sources":["../../src/guards/input-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAoCX;;GAEG;AACH,qBAAa,cAAc;IACvB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;IAsBxD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB;IAoB9D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;IAoBxD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,gBAAgB;IAuB5D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;IAkBtD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB;IAgB3D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;IAsBtD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAI,EAAE,GAAG,SAAM,EAAE,YAAY,SAAK,GAAG,MAAM;IAanF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM;IAahE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAIvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAWvC;;OAEG;IACH,MAAM,CAAC,cAAc,CACjB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,UAAO,GAChB,gBAAgB;CAwBtB;AAGD,eAAO,MAAM,cAAc,sCAAqD,CAAC;AACjF,eAAO,MAAM,iBAAiB,yCAAwD,CAAC;AACvF,eAAO,MAAM,cAAc,sCAAqD,CAAC;AACjF,eAAO,MAAM,gBAAgB,wCAAuD,CAAC;AACrF,eAAO,MAAM,aAAa,qCAAoD,CAAC;AAC/E,eAAO,MAAM,mBAAmB,2CAA0D,CAAC;AAC3F,eAAO,MAAM,aAAa,qCAAoD,CAAC;AAC/E,eAAO,MAAM,aAAa,qCAAoD,CAAC;AAC/E,eAAO,MAAM,cAAc,sCAAqD,CAAC;AACjF,eAAO,MAAM,UAAU,kCAAiD,CAAC"}