@casys/mcp-bridge 0.2.0

package/script/adapters/telegram/platform-adapter.js

@@ -0,0 +1,241 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramPlatformAdapter = void 0;
+/**
+ * Telegram PlatformAdapter for the MCP Apps Bridge.
+ *
+ * Implements the high-level PlatformAdapter interface by wrapping the
+ * Telegram WebApp SDK. Maps Telegram theme, viewport, and lifecycle
+ * events to MCP Apps HostContext and LifecycleEvents.
+ *
+ * This runs client-side inside the Telegram Mini App WebView.
+ */
+const dntShim = __importStar(require("../../_dnt.shims.js"));
+const sdk_bridge_js_1 = require("./sdk-bridge.js");
+/**
+ * Maps Telegram WebApp SDK to the MCP Apps PlatformAdapter interface.
+ *
+ * Usage:
+ * ```ts
+ * const adapter = new TelegramPlatformAdapter();
+ * const client = new BridgeClient({ platform: adapter, ... });
+ * ```
+ */
+class TelegramPlatformAdapter {
+    name = "telegram";
+    tg = null;
+    lifecycleHandlers = [];
+    boundThemeHandler = null;
+    boundViewportHandler = null;
+    boundActivatedHandler = null;
+    boundDeactivatedHandler = null;
+    initialize() {
+        this.tg = (0, sdk_bridge_js_1.getTelegramWebApp)();
+        // Signal to Telegram that the app is ready
+        this.tg.ready();
+        // Expand to full viewport by default
+        if (!this.tg.isExpanded) {
+            this.tg.expand();
+        }
+        // Register event listeners
+        this.setupEventListeners();
+        return Promise.resolve(this.buildHostContext());
+    }
+    getTheme() {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized.");
+        }
+        return this.tg.colorScheme;
+    }
+    getContainerDimensions() {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized.");
+        }
+        // deno-lint-ignore no-explicit-any
+        const _global = dntShim.dntGlobalThis;
+        return {
+            width: _global.innerWidth ?? 0,
+            maxHeight: this.tg.viewportStableHeight,
+        };
+    }
+    onLifecycleEvent(handler) {
+        this.lifecycleHandlers.push(handler);
+    }
+    openLink(url) {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized.");
+        }
+        this.tg.openLink(url);
+        return Promise.resolve();
+    }
+    sendMessage(text) {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized.");
+        }
+        // WARNING: sendData() closes the Mini App!
+        this.tg.sendData(text);
+        return Promise.resolve();
+    }
+    getAuthData() {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized. Call initialize() first.");
+        }
+        return {
+            initData: this.tg.initData,
+            initDataUnsafe: this.tg.initDataUnsafe,
+            platform: this.tg.platform,
+            version: this.tg.version,
+        };
+    }
+    /**
+     * Clean up Telegram event listeners.
+     * Call this when the bridge is destroyed.
+     */
+    destroy() {
+        if (this.tg) {
+            if (this.boundThemeHandler) {
+                this.tg.offEvent("themeChanged", this.boundThemeHandler);
+            }
+            if (this.boundViewportHandler) {
+                this.tg.offEvent("viewportChanged", this.boundViewportHandler);
+            }
+            if (this.boundActivatedHandler) {
+                this.tg.offEvent("activated", this.boundActivatedHandler);
+            }
+            if (this.boundDeactivatedHandler) {
+                this.tg.offEvent("deactivated", this.boundDeactivatedHandler);
+            }
+        }
+        this.lifecycleHandlers = [];
+        this.tg = null;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    buildHostContext() {
+        if (!this.tg) {
+            throw new Error("[TelegramPlatformAdapter] Not initialized.");
+        }
+        return {
+            theme: this.tg.colorScheme,
+            styles: this.buildStyles(this.tg.themeParams),
+            containerDimensions: this.getContainerDimensions(),
+            platform: "mobile",
+            locale: this.getLocale(),
+            timeZone: this.getTimeZone(),
+            safeAreaInsets: this.buildSafeAreaInsets(),
+        };
+    }
+    buildStyles(params) {
+        const variables = {};
+        if (params.bg_color) {
+            variables["--color-background-primary"] = params.bg_color;
+        }
+        if (params.secondary_bg_color) {
+            variables["--color-background-secondary"] = params.secondary_bg_color;
+        }
+        if (params.text_color) {
+            variables["--color-text-primary"] = params.text_color;
+        }
+        if (params.subtitle_text_color) {
+            variables["--color-text-secondary"] = params.subtitle_text_color;
+        }
+        if (params.section_separator_color) {
+            variables["--color-border-primary"] = params.section_separator_color;
+        }
+        if (params.accent_text_color) {
+            variables["--color-ring-primary"] = params.accent_text_color;
+        }
+        if (params.hint_color) {
+            variables["--color-text-hint"] = params.hint_color;
+        }
+        if (params.link_color) {
+            variables["--color-text-link"] = params.link_color;
+        }
+        if (params.button_color) {
+            variables["--color-button-primary"] = params.button_color;
+        }
+        if (params.button_text_color) {
+            variables["--color-button-text"] = params.button_text_color;
+        }
+        if (params.header_bg_color) {
+            variables["--color-background-header"] = params.header_bg_color;
+        }
+        if (params.section_bg_color) {
+            variables["--color-background-section"] = params.section_bg_color;
+        }
+        return { variables };
+    }
+    buildSafeAreaInsets() {
+        const inset = this.tg?.safeAreaInset;
+        return {
+            top: inset?.top ?? 0,
+            right: inset?.right ?? 0,
+            bottom: inset?.bottom ?? 0,
+            left: inset?.left ?? 0,
+        };
+    }
+    getLocale() {
+        // deno-lint-ignore no-explicit-any
+        const nav = dntShim.dntGlobalThis.navigator;
+        return nav?.language ?? "en";
+    }
+    getTimeZone() {
+        try {
+            return Intl.DateTimeFormat().resolvedOptions().timeZone;
+        }
+        catch {
+            // Intl may not be available in all webview runtimes; UTC is safe default
+            return "UTC";
+        }
+    }
+    setupEventListeners() {
+        if (!this.tg)
+            return;
+        this.boundThemeHandler = () => {
+            this.emitLifecycleEvent({ type: "theme-changed" });
+        };
+        this.boundViewportHandler = () => {
+            this.emitLifecycleEvent({ type: "viewport-changed" });
+        };
+        this.boundActivatedHandler = () => {
+            this.emitLifecycleEvent({ type: "activated" });
+        };
+        this.boundDeactivatedHandler = () => {
+            this.emitLifecycleEvent({ type: "deactivated" });
+        };
+        this.tg.onEvent("themeChanged", this.boundThemeHandler);
+        this.tg.onEvent("viewportChanged", this.boundViewportHandler);
+        this.tg.onEvent("activated", this.boundActivatedHandler);
+        this.tg.onEvent("deactivated", this.boundDeactivatedHandler);
+    }
+    emitLifecycleEvent(event) {
+        for (const handler of this.lifecycleHandlers) {
+            handler(event);
+        }
+    }
+}
+exports.TelegramPlatformAdapter = TelegramPlatformAdapter;

package/script/adapters/telegram/sdk-bridge.d.ts

@@ -0,0 +1,8 @@
+import type { TelegramWebApp } from "./types.js";
+/**
+ * Attempt to get the Telegram WebApp instance from the global scope.
+ *
+ * @throws {Error} if running outside a Telegram Mini App context.
+ */
+export declare function getTelegramWebApp(): TelegramWebApp;
+//# sourceMappingURL=sdk-bridge.d.ts.map

package/script/adapters/telegram/sdk-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-bridge.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/sdk-bridge.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD"}

package/script/adapters/telegram/sdk-bridge.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTelegramWebApp = getTelegramWebApp;
+/**
+ * Bridge between the Telegram WebApp SDK and the MCP Apps protocol.
+ *
+ * Wraps `window.Telegram.WebApp` to provide send/receive capabilities
+ * for JSON-RPC messages.
+ */
+const dntShim = __importStar(require("../../_dnt.shims.js"));
+/**
+ * Attempt to get the Telegram WebApp instance from the global scope.
+ *
+ * @throws {Error} if running outside a Telegram Mini App context.
+ */
+function getTelegramWebApp() {
+    // deno-lint-ignore no-explicit-any
+    const global = dntShim.dntGlobalThis;
+    const tg = global?.Telegram?.WebApp;
+    if (!tg) {
+        throw new Error("[TelegramSdkBridge] Telegram.WebApp not found. " +
+            "This code must run inside a Telegram Mini App WebView.");
+    }
+    return tg;
+}

package/script/adapters/telegram/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Telegram Mini App specific types.
+ *
+ * @see https://core.telegram.org/bots/webapps
+ */
+import type { AdapterConfig } from "../../core/types.js";
+/** Configuration for the Telegram Mini App adapter. */
+export interface TelegramAdapterConfig extends AdapterConfig {
+    readonly platformOptions?: {
+        /** Telegram Bot token (used server-side for validation). */
+        readonly botToken?: string;
+        /** If true, validate `initData` signature from Telegram. Defaults to true. */
+        readonly validateInitData?: boolean;
+    };
+}
+/**
+ * Telegram WebApp theme parameters.
+ * @see https://core.telegram.org/bots/webapps#themeparams
+ */
+export interface TelegramThemeParams {
+    readonly bg_color?: string;
+    readonly text_color?: string;
+    readonly hint_color?: string;
+    readonly link_color?: string;
+    readonly button_color?: string;
+    readonly button_text_color?: string;
+    readonly secondary_bg_color?: string;
+    readonly header_bg_color?: string;
+    readonly bottom_bar_bg_color?: string;
+    readonly accent_text_color?: string;
+    readonly section_bg_color?: string;
+    readonly section_header_text_color?: string;
+    readonly section_separator_color?: string;
+    readonly subtitle_text_color?: string;
+    readonly destructive_text_color?: string;
+    readonly [key: string]: string | undefined;
+}
+/** Safe area inset values from Telegram. */
+export interface TelegramSafeAreaInset {
+    readonly top?: number;
+    readonly bottom?: number;
+    readonly left?: number;
+    readonly right?: number;
+}
+/**
+ * Subset of the Telegram WebApp API exposed to Mini Apps.
+ * @see https://core.telegram.org/bots/webapps#initializing-mini-apps
+ */
+export interface TelegramWebApp {
+    readonly initData: string;
+    readonly initDataUnsafe: Record<string, unknown>;
+    readonly version: string;
+    readonly platform: string;
+    readonly colorScheme: "light" | "dark";
+    readonly themeParams: TelegramThemeParams;
+    readonly viewportHeight: number;
+    readonly viewportStableHeight: number;
+    readonly isExpanded: boolean;
+    readonly safeAreaInset?: TelegramSafeAreaInset;
+    readonly contentSafeAreaInset?: TelegramSafeAreaInset;
+    sendData(data: string): void;
+    ready(): void;
+    close(): void;
+    expand(): void;
+    requestFullscreen?(): void;
+    openLink(url: string, options?: {
+        try_instant_view?: boolean;
+    }): void;
+    openTelegramLink?(url: string): void;
+    onEvent(eventType: string, handler: () => void): void;
+    offEvent(eventType: string, handler: () => void): void;
+    MainButton?: {
+        text: string;
+        isVisible: boolean;
+        show(): void;
+        hide(): void;
+        onClick(handler: () => void): void;
+        offClick(handler: () => void): void;
+    };
+    BackButton?: {
+        isVisible: boolean;
+        show(): void;
+        hide(): void;
+        onClick(handler: () => void): void;
+        offClick(handler: () => void): void;
+    };
+}
+/**
+ * Telegram event types.
+ * @see https://core.telegram.org/bots/webapps#events-available-for-mini-apps
+ */
+export type TelegramEventType = "themeChanged" | "viewportChanged" | "mainButtonClicked" | "backButtonClicked" | "settingsButtonClicked" | "invoiceClosed" | "popupClosed" | "qrTextReceived" | "clipboardTextReceived" | "writeAccessRequested" | "contactRequested" | "activated" | "deactivated" | "fullscreenChanged" | "fullscreenFailed" | "homeScreenAdded" | "homeScreenChecked" | "accelerometerStarted" | "accelerometerStopped" | "accelerometerChanged" | "deviceOrientationStarted" | "deviceOrientationStopped" | "deviceOrientationChanged" | "gyroscopeStarted" | "gyroscopeStopped" | "gyroscopeChanged" | "locationManagerUpdated" | "locationRequested" | "emojiStatusSet" | "emojiStatusFailed" | "emojiStatusAccessRequested" | "fileDownloadRequested" | "shareMessageSent" | "shareMessageFailed";
+//# sourceMappingURL=types.d.ts.map

package/script/adapters/telegram/types.d.ts.map

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

package/script/adapters/telegram/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Telegram Mini App specific types.
+ *
+ * @see https://core.telegram.org/bots/webapps
+ */
+Object.defineProperty(exports, "__esModule", { value: true });