bn-telegram-mcp-server 0.0.1

package/dist/debug-middleware.d.ts

@@ -0,0 +1,12 @@
+import type { ToolResponse } from "./types.js";
+export declare const DEBUG_MODE: boolean;
+/**
+ * Wraps a tool execution with debug metadata when DEBUG mode is enabled.
+ *
+ * @param toolName - Name of the tool being executed
+ * @param toolInput - Input arguments passed to the tool
+ * @param executeToolFn - Async function that executes the tool and returns data
+ * @returns ToolResponse with data and optional debug metadata
+ */
+export declare function wrapWithDebug<T>(toolName: string, toolInput: unknown, executeToolFn: () => Promise<T>): Promise<ToolResponse<T>>;
+//# sourceMappingURL=debug-middleware.d.ts.map

package/dist/debug-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-middleware.d.ts","sourceRoot":"","sources":["../src/debug-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,eAAO,MAAM,UAAU,SAA+B,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA0B1B"}

package/dist/debug-middleware.js

@@ -0,0 +1,36 @@
+// Check if DEBUG mode is enabled via environment variable
+export const DEBUG_MODE = process.env.DEBUG === "true";
+/**
+ * Wraps a tool execution with debug metadata when DEBUG mode is enabled.
+ *
+ * @param toolName - Name of the tool being executed
+ * @param toolInput - Input arguments passed to the tool
+ * @param executeToolFn - Async function that executes the tool and returns data
+ * @returns ToolResponse with data and optional debug metadata
+ */
+export async function wrapWithDebug(toolName, toolInput, executeToolFn) {
+    const startTime = performance.now();
+    try {
+        const data = await executeToolFn();
+        const endTime = performance.now();
+        const toolCallTime = endTime - startTime;
+        if (DEBUG_MODE) {
+            return {
+                data,
+                debug: {
+                    toolName,
+                    toolInput,
+                    toolCallTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+        }
+        // In non-debug mode, return just the data wrapped
+        return { data };
+    }
+    catch (error) {
+        // Re-throw the error to be handled by caller
+        throw error;
+    }
+}
+//# sourceMappingURL=debug-middleware.js.map

package/dist/debug-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-middleware.js","sourceRoot":"","sources":["../src/debug-middleware.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,SAAkB,EAClB,aAA+B;IAE/B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE;oBACL,QAAQ;oBACR,SAAS;oBACT,YAAY;oBACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6CAA6C;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/encryption.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Decode the binlog from base64 format
+ *
+ * BlueNexus stores the TDLib binlog as raw base64 in providerData.binlog.
+ * This function simply decodes the base64 string to get the raw binlog bytes.
+ *
+ * @param base64Binlog - The base64-encoded binlog from the request body
+ * @returns Decoded binlog as Buffer
+ */
+export declare function decodeBinlog(base64Binlog: string): Buffer;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAmBzD"}

package/dist/encryption.js

@@ -0,0 +1,26 @@
+/**
+ * Decode the binlog from base64 format
+ *
+ * BlueNexus stores the TDLib binlog as raw base64 in providerData.binlog.
+ * This function simply decodes the base64 string to get the raw binlog bytes.
+ *
+ * @param base64Binlog - The base64-encoded binlog from the request body
+ * @returns Decoded binlog as Buffer
+ */
+export function decodeBinlog(base64Binlog) {
+    if (!base64Binlog || base64Binlog.trim() === "") {
+        throw new Error("Invalid binlog: empty or missing");
+    }
+    // Validate base64 format
+    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+    if (!base64Regex.test(base64Binlog)) {
+        throw new Error("Invalid binlog: not a valid base64 string");
+    }
+    // Decode the base64 string to get raw binlog bytes
+    const buffer = Buffer.from(base64Binlog, "base64");
+    if (buffer.length === 0) {
+        throw new Error("Invalid binlog: decoded to empty buffer");
+    }
+    return buffer;
+}
+//# sourceMappingURL=encryption.js.map

package/dist/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../src/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,wBAAwB,CAAC;IAC7C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,mDAAmD;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { Request } from "express";
+import type { Client } from "tdl";
+/**
+ * Get a TDLib client for the current request
+ *
+ * This function:
+ * 1. Extracts credentials and config from request headers
+ * 2. Generates a session ID from the access token
+ * 3. Decodes the base64-encoded binlog
+ * 4. Creates a TDLib client with the restored session
+ *
+ * @param req - Express request object
+ * @returns Object containing the TDLib client and session ID
+ */
+export declare function getClientForRequest(req: Request): Promise<{
+    client: Client;
+    sessionId: string;
+}>;
+/**
+ * Execute a tool with automatic client cleanup
+ *
+ * @param req - Express request object
+ * @param toolFn - Function to execute with the client
+ * @returns Result of the tool function
+ */
+export declare function withClient<T>(req: Request, toolFn: (client: Client) => Promise<T>): Promise<T>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAwElC;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAkBD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/helpers.js

@@ -0,0 +1,103 @@
+import crypto from "crypto";
+import { decodeBinlog } from "./encryption.js";
+import { createTelegramClient, cleanupSession } from "./telegram-client.js";
+import { createLogger } from "./logger.js";
+const logger = createLogger("Helpers");
+/**
+ * Extract Telegram credentials and config from request
+ *
+ * Expected headers:
+ * - Authorization: Bearer <accessToken>
+ * - X-Telegram-Api-Id: <API ID> (or fallback to env TELEGRAM_API_ID)
+ * - X-Telegram-Api-Hash: <API Hash> (or fallback to env TELEGRAM_API_HASH)
+ *
+ * The binlog is passed in the request body as _telegramBinlog but
+ * extracted and stored on req._telegramBinlog by index.ts before SDK processing
+ * (the MCP SDK's Zod validation rejects unrecognized keys in the body).
+ * The binlog is base64-encoded (NOT encrypted).
+ */
+function extractCredentials(req) {
+    const authHeader = req.headers.authorization;
+    if (!authHeader?.toLowerCase().startsWith("bearer ")) {
+        throw new Error("Missing or invalid Authorization header. Expected format: Bearer <token>");
+    }
+    const accessToken = authHeader.substring(7).trim();
+    // Get binlog from request object (extracted from body by index.ts)
+    const binlog = req._telegramBinlog;
+    if (!binlog) {
+        throw new Error("Missing _telegramBinlog. This field must be sent in the request body and contains the base64-encoded TDLib session binlog.");
+    }
+    // Get API credentials from headers first, then fallback to env vars
+    const apiIdHeader = req.headers["x-telegram-api-id"];
+    const apiHashHeader = req.headers["x-telegram-api-hash"];
+    const apiId = parseInt(apiIdHeader || process.env.TELEGRAM_API_ID || "0", 10);
+    const apiHash = apiHashHeader || process.env.TELEGRAM_API_HASH || "";
+    // Validate required config
+    if (!apiId || apiId === 0) {
+        throw new Error("Telegram API ID not provided. Set X-Telegram-Api-Id header or TELEGRAM_API_ID environment variable.");
+    }
+    if (!apiHash) {
+        throw new Error("Telegram API Hash not provided. Set X-Telegram-Api-Hash header or TELEGRAM_API_HASH environment variable.");
+    }
+    return { apiId, apiHash, accessToken, binlog };
+}
+/**
+ * Get a TDLib client for the current request
+ *
+ * This function:
+ * 1. Extracts credentials and config from request headers
+ * 2. Generates a session ID from the access token
+ * 3. Decodes the base64-encoded binlog
+ * 4. Creates a TDLib client with the restored session
+ *
+ * @param req - Express request object
+ * @returns Object containing the TDLib client and session ID
+ */
+export async function getClientForRequest(req) {
+    const { apiId, apiHash, accessToken, binlog: base64Binlog } = extractCredentials(req);
+    // Generate session ID from access token (for temp directory isolation)
+    const sessionId = crypto
+        .createHash("sha256")
+        .update(accessToken)
+        .digest("hex")
+        .substring(0, 16);
+    // Decode base64-encoded binlog
+    const binlog = decodeBinlog(base64Binlog);
+    // Create TDLib client with restored session
+    const client = await createTelegramClient(sessionId, binlog, apiId, apiHash);
+    return { client, sessionId };
+}
+/**
+ * Execute a tool with automatic client cleanup
+ *
+ * @param req - Express request object
+ * @param toolFn - Function to execute with the client
+ * @returns Result of the tool function
+ */
+export async function withClient(req, toolFn) {
+    const { client, sessionId } = await getClientForRequest(req);
+    try {
+        return await toolFn(client);
+    }
+    finally {
+        // Ensure client is fully closed before cleanup
+        let clientClosed = false;
+        try {
+            await client.close();
+            clientClosed = true;
+        }
+        catch (closeError) {
+            logger.warn("Failed to close TDLib client", {
+                sessionId,
+                error: closeError instanceof Error ? closeError : new Error(String(closeError)),
+            });
+        }
+        // Only cleanup session files after client is closed
+        // Add a small delay to ensure TDLib releases file handles
+        if (clientClosed) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        await cleanupSession(sessionId);
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import { z } from "zod";
+// Import schemas
+import { GetMeSchema, GetChatSchema, GetMessagesSchema, SendMessageSchema, GetUserSchema, GetContactsSchema, GetFileSchema, GetGroupSchema, GetChatMembersSchema, GetMessageContextSchema, } from "./schemas.js";
+// Import tool handlers
+import { getMe, getChat, getMessages, sendMessage, getUser, getContacts, getFile, getGroup, getChatMembers, getMessageContext, } from "./tools/index.js";
+// Import tool loader
+import { loadToolDefinitions } from "./tool-loader.js";
+// Import tool registry
+import { ToolRegistry } from "./tool-registry.js";
+// Import debug mode flag
+import { DEBUG_MODE } from "./debug-middleware.js";
+// Import logger
+import { createLogger } from "./logger.js";
+// Import request context
+import { runWithRequest, requireCurrentRequest, } from "./request-context.js";
+const logger = createLogger("MCPServer");
+// Create tool registry and register all tools
+const toolRegistry = new ToolRegistry();
+// Register consolidated tools (10 tools total)
+toolRegistry.register("getMe", GetMeSchema, getMe);
+toolRegistry.register("getChat", GetChatSchema, getChat);
+toolRegistry.register("getMessages", GetMessagesSchema, getMessages);
+toolRegistry.register("sendMessage", SendMessageSchema, sendMessage);
+toolRegistry.register("getUser", GetUserSchema, getUser);
+toolRegistry.register("getContacts", GetContactsSchema, getContacts);
+toolRegistry.register("getFile", GetFileSchema, getFile);
+toolRegistry.register("getGroup", GetGroupSchema, getGroup);
+toolRegistry.register("getChatMembers", GetChatMembersSchema, getChatMembers);
+toolRegistry.register("getMessageContext", GetMessageContextSchema, getMessageContext);
+// Create MCP server
+const server = new Server({
+    name: "telegram-mcp-server",
+    version: "0.0.1",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Register tool handlers
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    // Load tool definitions from JSON (reloads on each request in dev mode)
+    const toolDefinitions = loadToolDefinitions();
+    return {
+        tools: toolDefinitions,
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (DEBUG_MODE) {
+        logger.debug("CallToolRequestSchema handler called", {
+            toolName: request.params.name,
+            arguments: request.params.arguments,
+        });
+    }
+    // Get current request from AsyncLocalStorage context
+    const currentRequest = requireCurrentRequest();
+    try {
+        // Execute tool via registry (includes automatic validation and debug wrapping)
+        const result = await toolRegistry.execute(request.params.name, request.params.arguments, currentRequest);
+        if (DEBUG_MODE) {
+            logger.debug("Tool execution completed", { toolName: request.params.name });
+        }
+        // Return formatted response with data and optional debug info
+        // Debug info is included in the response when DEBUG mode is enabled
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        logger.error("Tool execution error", {
+            error: error instanceof Error ? error : new Error(String(error)),
+            toolName: request.params.name,
+        });
+        if (error instanceof z.ZodError) {
+            throw new Error(`Invalid arguments: ${error.message}`, { cause: error });
+        }
+        throw error;
+    }
+});
+// Create Express app with stateless HTTP transport
+const app = express();
+app.use(express.json());
+// Create stateless transport (no session management)
+const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: undefined, // Stateless mode
+    enableJsonResponse: true,
+});
+// Connect server to transport
+await server.connect(transport);
+// Handle MCP requests
+app.post("/mcp", async (req, res) => {
+    try {
+        // Log incoming request in DEBUG mode
+        if (DEBUG_MODE) {
+            logger.debug("Incoming MCP request", {
+                method: req.body?.method,
+                params: req.body?.params,
+            });
+        }
+        // Extract _telegramBinlog from body before passing to SDK
+        // The MCP SDK's Zod validation rejects unrecognized keys, so we strip it here
+        // and store it on the request for tool handlers to access
+        const { _telegramBinlog, ...cleanBody } = req.body;
+        // Store binlog on request object for helpers.ts to access
+        const telegramReq = req;
+        telegramReq._telegramBinlog = _telegramBinlog;
+        if (DEBUG_MODE) {
+            logger.debug("Binlog status", {
+                hasBinlog: !!_telegramBinlog,
+                binlogLength: _telegramBinlog?.length,
+            });
+        }
+        // Run the request handler within AsyncLocalStorage context
+        // This ensures proper request isolation for concurrent requests
+        await runWithRequest(telegramReq, async () => {
+            try {
+                await transport.handleRequest(req, res, cleanBody);
+                if (DEBUG_MODE) {
+                    logger.debug("Request handled successfully");
+                }
+            }
+            catch (transportError) {
+                logger.error("Transport error", {
+                    error: transportError instanceof Error ? transportError : new Error(String(transportError)),
+                });
+                throw transportError;
+            }
+        });
+    }
+    catch (error) {
+        logger.error("Error handling MCP request", {
+            error: error instanceof Error ? error : new Error(String(error)),
+        });
+        res.status(500).json({
+            error: "Internal server error",
+            message: error instanceof Error ? error.message : "Unknown error",
+        });
+    }
+});
+// Health check endpoint
+app.get("/health", (_req, res) => {
+    res.json({
+        status: "healthy",
+        server: "telegram-mcp-server",
+        version: "0.0.1",
+        stateless: true,
+        debug: DEBUG_MODE,
+        registeredTools: toolRegistry.getToolNames(),
+    });
+});
+// Start server
+const PORT = process.env.PORT || 30001;
+app.listen(PORT, () => {
+    logger.info("Server started", {
+        port: PORT,
+        mcpEndpoint: `http://localhost:${PORT}/mcp`,
+        healthEndpoint: `http://localhost:${PORT}/health`,
+        mode: "Stateless",
+        debug: DEBUG_MODE,
+    });
+    if (DEBUG_MODE) {
+        logger.debug("Registered tools", {
+            tools: toolRegistry.getToolNames().join(", "),
+        });
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Logger utility with PII sanitization for safe logging
+ */
+/**
+ * Context object for sanitized logging
+ */
+export interface LogContext {
+    sessionId?: string;
+    userId?: string | number;
+    phone?: string;
+    token?: string;
+    [key: string]: unknown;
+}
+/**
+ * Logger class with PII sanitization
+ */
+export declare class Logger {
+    private readonly component;
+    constructor(component: string);
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+}
+/**
+ * Create a logger for a specific component
+ */
+export declare function createLogger(component: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AA4DD;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAGnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/logger.js

@@ -0,0 +1,114 @@
+/**
+ * Logger utility with PII sanitization for safe logging
+ */
+/**
+ * Sanitize a session ID by showing only the first 4 characters
+ */
+function sanitizeSessionId(sessionId) {
+    if (sessionId.length <= 4) {
+        return "****";
+    }
+    return `${sessionId.substring(0, 4)}****`;
+}
+/**
+ * Sanitize a phone number by masking all but the last 4 digits
+ */
+function sanitizePhoneNumber(phone) {
+    const digitsOnly = phone.replace(/\D/g, "");
+    if (digitsOnly.length <= 4) {
+        return "****";
+    }
+    return `****${digitsOnly.slice(-4)}`;
+}
+/**
+ * Sanitize an access token by showing only first 8 characters
+ */
+function sanitizeToken(token) {
+    if (token.length <= 8) {
+        return "****";
+    }
+    return `${token.substring(0, 8)}****`;
+}
+/**
+ * Sanitize user ID by keeping it (IDs are not PII on their own, but can be partially masked if needed)
+ */
+function sanitizeUserId(userId) {
+    return String(userId);
+}
+/**
+ * Sanitize a context object for safe logging
+ */
+function sanitizeContext(context) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(context)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        // Apply specific sanitization based on key name
+        if (key === "sessionId" && typeof value === "string") {
+            sanitized[key] = sanitizeSessionId(value);
+        }
+        else if (key === "phone" && typeof value === "string") {
+            sanitized[key] = sanitizePhoneNumber(value);
+        }
+        else if ((key === "token" || key === "accessToken" || key === "refreshToken") &&
+            typeof value === "string") {
+            sanitized[key] = sanitizeToken(value);
+        }
+        else if (key === "userId") {
+            sanitized[key] = sanitizeUserId(value);
+        }
+        else if (key === "error" && value instanceof Error) {
+            // Preserve error objects properly
+            sanitized[key] = {
+                message: value.message,
+                name: value.name,
+                stack: value.stack,
+            };
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Format a log message with optional context
+ */
+function formatMessage(level, component, message, context) {
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${level}] [${component}]`;
+    if (context && Object.keys(context).length > 0) {
+        const sanitized = sanitizeContext(context);
+        return `${prefix} ${message} ${JSON.stringify(sanitized)}`;
+    }
+    return `${prefix} ${message}`;
+}
+/**
+ * Logger class with PII sanitization
+ */
+export class Logger {
+    component;
+    constructor(component) {
+        this.component = component;
+    }
+    info(message, context) {
+        console.log(formatMessage("INFO", this.component, message, context));
+    }
+    warn(message, context) {
+        console.warn(formatMessage("WARN", this.component, message, context));
+    }
+    error(message, context) {
+        console.error(formatMessage("ERROR", this.component, message, context));
+    }
+    debug(message, context) {
+        console.debug(formatMessage("DEBUG", this.component, message, context));
+    }
+}
+/**
+ * Create a logger for a specific component
+ */
+export function createLogger(component) {
+    return new Logger(component);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/request-context.d.ts

@@ -0,0 +1,24 @@
+import type { Request } from "express";
+/**
+ * Extended Express Request with Telegram binlog (session data)
+ */
+export type TelegramRequest = Request & {
+    _telegramBinlog?: string;
+};
+/**
+ * Run a callback with request context
+ * All async operations within the callback will have access to the request
+ *
+ * @param req - Express request object
+ * @param callback - Async callback to run with request context
+ * @returns Result of the callback
+ */
+export declare function runWithRequest<T>(req: TelegramRequest, callback: () => Promise<T>): Promise<T>;
+/**
+ * Get the current request from context, throwing if not available
+ *
+ * @returns Current request
+ * @throws Error if not in request context
+ */
+export declare function requireCurrentRequest(): TelegramRequest;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AASrE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAQvD"}