@casys/mcp-bridge 0.2.0

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,2 @@
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,gCAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -0,0 +1,57 @@
+const dntGlobals = {};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/adapters/base-adapter.d.ts

@@ -0,0 +1,25 @@
+import type { McpAppsAdapter, MessageHandler } from "../core/adapter.js";
+import type { AdapterConfig, McpAppsMessage } from "../core/types.js";
+/**
+ * Abstract base for postMessage-based platform adapters.
+ *
+ * Handles the common lifecycle:
+ * - `init()`: set up `message` event listener, derive targetOrigin from config
+ * - `sendToHost()`: forward JSON-RPC to parent frame via postMessage
+ * - `onMessageFromHost()`: register message handlers
+ * - `destroy()`: tear down listener and handlers
+ *
+ * Concrete adapters (Telegram, LINE) extend this and set `platform`.
+ */
+export declare abstract class BasePostMessageAdapter implements McpAppsAdapter {
+    abstract readonly platform: string;
+    private initialized;
+    private handlers;
+    private boundListener;
+    private targetOrigin;
+    init(config: AdapterConfig): Promise<void>;
+    sendToHost(message: McpAppsMessage): void;
+    onMessageFromHost(handler: MessageHandler): void;
+    destroy(): void;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/esm/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/base-adapter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMtE;;;;;;;;;;GAUG;AACH,8BAAsB,sBAAuB,YAAW,cAAc;IACpE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAO;IAE3B,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA6C1C,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAYzC,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,OAAO,IAAI,IAAI;CAQhB"}

package/esm/adapters/base-adapter.js

@@ -0,0 +1,86 @@
+/**
+ * Base postMessage adapter for platform integrations.
+ *
+ * Provides the common message interception and dispatch logic shared by
+ * all platform adapters that communicate via `window.parent.postMessage`.
+ *
+ * Subclasses only need to set their `platform` identifier.
+ */
+import * as dntShim from "../_dnt.shims.js";
+// Cast globalThis to access browser-only APIs at runtime.
+// deno-lint-ignore no-explicit-any
+const _global = dntShim.dntGlobalThis;
+/**
+ * Abstract base for postMessage-based platform adapters.
+ *
+ * Handles the common lifecycle:
+ * - `init()`: set up `message` event listener, derive targetOrigin from config
+ * - `sendToHost()`: forward JSON-RPC to parent frame via postMessage
+ * - `onMessageFromHost()`: register message handlers
+ * - `destroy()`: tear down listener and handlers
+ *
+ * Concrete adapters (Telegram, LINE) extend this and set `platform`.
+ */
+export class BasePostMessageAdapter {
+    initialized = false;
+    handlers = [];
+    boundListener = null;
+    targetOrigin = "*";
+    init(config) {
+        if (this.initialized) {
+            throw new Error(`[${this.platform}Adapter] Already initialized.`);
+        }
+        // Use resourceBaseUrl as targetOrigin instead of "*" (security)
+        if (config.resourceBaseUrl) {
+            try {
+                const url = new URL(config.resourceBaseUrl);
+                this.targetOrigin = url.origin;
+            }
+            catch {
+                console.warn(`[${this.platform}Adapter] Invalid resourceBaseUrl, falling back to '*' targetOrigin:`, config.resourceBaseUrl);
+            }
+        }
+        this.boundListener = ((event) => {
+            try {
+                // deno-lint-ignore no-explicit-any
+                const msgEvent = event;
+                const raw = msgEvent.data;
+                const data = typeof raw === "string" ? JSON.parse(raw) : raw;
+                if (data && typeof data === "object" && data.jsonrpc === "2.0") {
+                    const message = data;
+                    for (const handler of this.handlers) {
+                        handler(message);
+                    }
+                }
+            }
+            catch {
+                // Non-JSON messages are expected (other postMessage traffic),
+                // silently ignore to avoid log noise.
+            }
+        });
+        if (typeof _global.addEventListener === "function") {
+            _global.addEventListener("message", this.boundListener);
+        }
+        this.initialized = true;
+        return Promise.resolve();
+    }
+    sendToHost(message) {
+        if (!this.initialized) {
+            throw new Error(`[${this.platform}Adapter] Not initialized. Call init() first.`);
+        }
+        if (typeof _global.parent?.postMessage === "function") {
+            _global.parent.postMessage(JSON.stringify(message), this.targetOrigin);
+        }
+    }
+    onMessageFromHost(handler) {
+        this.handlers.push(handler);
+    }
+    destroy() {
+        if (this.boundListener && typeof _global.removeEventListener === "function") {
+            _global.removeEventListener("message", this.boundListener);
+        }
+        this.boundListener = null;
+        this.handlers = [];
+        this.initialized = false;
+    }
+}

package/esm/adapters/line/adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LINE LIFF adapter for MCP Apps Bridge.
+ *
+ * Uses `postMessage` / `message` events to communicate with the LINE
+ * host WebView.
+ */
+import { BasePostMessageAdapter } from "../base-adapter.js";
+export declare class LineAdapter extends BasePostMessageAdapter {
+    readonly platform: "line";
+}
+//# sourceMappingURL=adapter.d.ts.map

package/esm/adapters/line/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/line/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qBAAa,WAAY,SAAQ,sBAAsB;IACrD,QAAQ,CAAC,QAAQ,SAAmB;CACrC"}

package/esm/adapters/line/adapter.js

@@ -0,0 +1,10 @@
+/**
+ * LINE LIFF adapter for MCP Apps Bridge.
+ *
+ * Uses `postMessage` / `message` events to communicate with the LINE
+ * host WebView.
+ */
+import { BasePostMessageAdapter } from "../base-adapter.js";
+export class LineAdapter extends BasePostMessageAdapter {
+    platform = "line";
+}

package/esm/adapters/line/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LINE LIFF specific types.
+ */
+import type { AdapterConfig } from "../../core/types.js";
+/** Configuration for the LINE LIFF adapter. */
+export interface LineAdapterConfig extends AdapterConfig {
+    readonly platformOptions?: {
+        /** LINE LIFF App ID. */
+        readonly liffId?: string;
+    };
+}
+/**
+ * Subset of the LIFF SDK API.
+ * @see https://developers.line.biz/en/reference/liff/
+ */
+export interface LiffSdk {
+    init(config: {
+        liffId: string;
+    }): Promise<void>;
+    isLoggedIn(): boolean;
+    getAccessToken(): string | null;
+    sendMessages(messages: readonly Record<string, unknown>[]): Promise<void>;
+    closeWindow(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/adapters/line/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/line/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,+CAA+C;AAC/C,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,wBAAwB;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,IAAI,OAAO,CAAC;IACtB,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,WAAW,IAAI,IAAI,CAAC;CACrB"}

package/esm/adapters/line/types.js

@@ -0,0 +1,4 @@
+/**
+ * LINE LIFF specific types.
+ */
+export {};

package/esm/adapters/telegram/adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Telegram Mini App adapter for MCP Apps Bridge.
+ *
+ * Uses `postMessage` / `message` events to communicate with the Telegram
+ * host WebView.
+ */
+import { BasePostMessageAdapter } from "../base-adapter.js";
+export declare class TelegramAdapter extends BasePostMessageAdapter {
+    readonly platform: "telegram";
+}
+//# sourceMappingURL=adapter.d.ts.map

package/esm/adapters/telegram/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,qBAAa,eAAgB,SAAQ,sBAAsB;IACzD,QAAQ,CAAC,QAAQ,aAAuB;CACzC"}

package/esm/adapters/telegram/adapter.js

@@ -0,0 +1,10 @@
+/**
+ * Telegram Mini App adapter for MCP Apps Bridge.
+ *
+ * Uses `postMessage` / `message` events to communicate with the Telegram
+ * host WebView.
+ */
+import { BasePostMessageAdapter } from "../base-adapter.js";
+export class TelegramAdapter extends BasePostMessageAdapter {
+    platform = "telegram";
+}

package/esm/adapters/telegram/platform-adapter.d.ts

@@ -0,0 +1,40 @@
+import type { LifecycleEventHandler, PlatformAdapter } from "../../core/adapter.js";
+import type { ContainerDimensions, HostContext } from "../../core/types.js";
+/**
+ * Maps Telegram WebApp SDK to the MCP Apps PlatformAdapter interface.
+ *
+ * Usage:
+ * ```ts
+ * const adapter = new TelegramPlatformAdapter();
+ * const client = new BridgeClient({ platform: adapter, ... });
+ * ```
+ */
+export declare class TelegramPlatformAdapter implements PlatformAdapter {
+    readonly name: "telegram";
+    private tg;
+    private lifecycleHandlers;
+    private boundThemeHandler;
+    private boundViewportHandler;
+    private boundActivatedHandler;
+    private boundDeactivatedHandler;
+    initialize(): Promise<HostContext>;
+    getTheme(): "light" | "dark";
+    getContainerDimensions(): ContainerDimensions;
+    onLifecycleEvent(handler: LifecycleEventHandler): void;
+    openLink(url: string): Promise<void>;
+    sendMessage(text: string): Promise<void>;
+    getAuthData(): Record<string, unknown>;
+    /**
+     * Clean up Telegram event listeners.
+     * Call this when the bridge is destroyed.
+     */
+    destroy(): void;
+    private buildHostContext;
+    private buildStyles;
+    private buildSafeAreaInsets;
+    private getLocale;
+    private getTimeZone;
+    private setupEventListeners;
+    private emitLifecycleEvent;
+}
+//# sourceMappingURL=platform-adapter.d.ts.map

package/esm/adapters/telegram/platform-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/platform-adapter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAIZ,MAAM,qBAAqB,CAAC;AAI7B;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,QAAQ,CAAC,IAAI,aAAuB;IAEpC,OAAO,CAAC,EAAE,CAA+B;IACzC,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,uBAAuB,CAA6B;IAE5D,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAiBlC,QAAQ,IAAI,OAAO,GAAG,MAAM;IAO5B,sBAAsB,IAAI,mBAAmB;IAY7C,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAItD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAuBf,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,WAAW;IA2CnB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,kBAAkB;CAK3B"}

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

@@ -0,0 +1,214 @@
+/**
+ * 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.
+ */
+import * as dntShim from "../../_dnt.shims.js";
+import { getTelegramWebApp } from "./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, ... });
+ * ```
+ */
+export class TelegramPlatformAdapter {
+    name = "telegram";
+    tg = null;
+    lifecycleHandlers = [];
+    boundThemeHandler = null;
+    boundViewportHandler = null;
+    boundActivatedHandler = null;
+    boundDeactivatedHandler = null;
+    initialize() {
+        this.tg = 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);
+        }
+    }
+}

package/esm/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/esm/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/esm/adapters/telegram/sdk-bridge.js

@@ -0,0 +1,22 @@
+/**
+ * Bridge between the Telegram WebApp SDK and the MCP Apps protocol.
+ *
+ * Wraps `window.Telegram.WebApp` to provide send/receive capabilities
+ * for JSON-RPC messages.
+ */
+import * as dntShim from "../../_dnt.shims.js";
+/**
+ * Attempt to get the Telegram WebApp instance from the global scope.
+ *
+ * @throws {Error} if running outside a Telegram Mini App context.
+ */
+export 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/esm/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/esm/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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"}