frontend/src/lib/telegram.ts - master - rustwizard/balda

frontend/src/lib/telegram.ts

54 строки2 KB

Rust Wizard

feat: friend invites via Telegram startapp deep links

04 авг 2026, 10:52

04 авг 2026, 10:52fc4dbe3

// Thin wrapper around the Telegram Mini App JS API. Outside the Telegram
// WebView the global is absent and every helper degrades to a no-op.

interface TelegramWebApp {
  initData: string;
  initDataUnsafe?: { start_param?: string };
  ready(): void;
  expand(): void;
  openTelegramLink?(url: string): void;
}

interface TelegramWindow extends Window {
  Telegram?: { WebApp?: TelegramWebApp };
}

function webApp(): TelegramWebApp | null {
  return (window as TelegramWindow).Telegram?.WebApp ?? null;
}

// isMiniApp reports whether the page runs inside the Telegram WebView with
// signed init data available (empty string means the app was opened outside
// a bot context).
export function isMiniApp(): boolean {
  const app = webApp();
  return !!app && app.initData.length > 0;
}

// getTelegramInitData returns the signed init data to send to the backend,
// or null when not running as a Mini App.
export function getTelegramInitData(): string | null {
  const app = webApp();
  return app && app.initData.length > 0 ? app.initData : null;
}

// getStartParam returns the startapp deep-link payload the Mini App was
// opened with (e.g. "game_<id>" from a friend invite), or null.
export function getStartParam(): string | null {
  const p = webApp()?.initDataUnsafe?.start_param;
  return p && p.length > 0 ? p : null;
}

// shareTelegramLink opens the native Telegram share dialog for the given URL.
export function shareTelegramLink(url: string): void {
  webApp()?.openTelegramLink?.(`https://t.me/share/url?url=${encodeURIComponent(url)}`);
}

// initMiniApp tells Telegram the app is ready and asks for the full-height
// layout. Safe to call outside the WebView.
export function initMiniApp(): void {
  const app = webApp();
  if (!app) return;
  app.ready();
  app.expand();
}