import { expect, test } from './fixtures'; // The shared fixture already neutralises the real telegram-web-app.js, so these // specs control window.Telegram deterministically (injected below) with no network. // A minimal valid-looking Telegram WebApp stub: non-empty initData triggers the Mini // App launch path (the mock gateway accepts any initData and returns a durable // session); themeParams override the design tokens. function webAppStub(startParam = '') { return { Telegram: { WebApp: { initData: 'query_id=test&user=%7B%22id%22%3A1%7D&auth_date=1&hash=deadbeef', initDataUnsafe: startParam ? { start_param: startParam } : {}, themeParams: { bg_color: '#101418', text_color: '#ffffff' }, ready() {}, expand() {}, }, }, }; } test('Telegram launch auto-authenticates into the lobby and applies the theme', async ({ page }) => { await page.addInitScript((stub) => { Object.assign(window, stub); }, webAppStub()); await page.goto('/'); // No guest-login click: the Mini App authenticates from initData and lands on the lobby. await expect(page.getByText('Your turn')).toBeVisible(); // The Telegram themeParams override the background token at runtime. await expect .poll(() => page.evaluate(() => getComputedStyle(document.documentElement).getPropertyValue('--bg').trim())) .toBe('#101418'); }); test('a Telegram launch fragment in the URL still lands on the lobby and normalises the hash', async ({ page, }) => { await page.addInitScript((stub) => { Object.assign(window, stub); }, webAppStub()); // Telegram appends its launch params to the URL fragment on a cold launch; the router must // not treat that as a route (it parsed as notfound, which re-keyed the pane and slid the // lobby in as if returning from another screen). await page.goto( '/#tgWebAppData=query_id%3Dtest%26user%3D%257B%2522id%2522%253A1%257D&tgWebAppVersion=7.0&tgWebAppPlatform=ios', ); await expect(page.getByText('Your turn')).toBeVisible(); // The lobby is the root: bootstrap normalised the launch-param fragment to '#/'. await expect.poll(() => new URL(page.url()).hash).toBe('#/'); }); test('tg-fullscreen header keeps a constant native-nav gap as the font scales', async ({ page }) => { await page.goto('/'); await page.getByRole('button', { name: /guest/i }).click(); await expect(page.getByText('Your turn')).toBeVisible(); // the lobby header is present + settled // Emulate Telegram fullscreen: the class + safe-area vars our header positions against. await page.evaluate(() => { const h = document.documentElement; h.classList.add('tg-fullscreen'); h.style.setProperty('--tg-safe-top', '47px'); h.style.setProperty('--tg-content-top', '50px'); }); const probe = () => page.evaluate(() => { const bar = document.querySelector('.bar')!.getBoundingClientRect(); const h1 = document.querySelector('.bar h1')!.getBoundingClientRect(); return { h1Top: Math.round(h1.top), overflows: h1.bottom > bar.bottom + 0.5 }; }); const normal = await probe(); // Scale the root font up (an OS / Telegram "larger text" setting scales rem-based text). await page.evaluate(() => (document.documentElement.style.fontSize = '28px')); const large = await probe(); // The gap to Telegram's native controls is a fixed px, so the title's top does not move… expect(large.h1Top).toBe(normal.h1Top); // …the title grows downward inside the bar (which grows with it), never overflowing it. expect(normal.overflows).toBe(false); expect(large.overflows).toBe(false); }); test('inside Telegram, a failed launch shows the retry screen, not the web login', async ({ page }) => { // initData carrying the mock's "bootfail" sentinel makes authTelegram reject, simulating a // backend outage during launch (e.g. a deploy rolling). The Mini App must surface its own // boot-error/retry screen and never fall back to the web (guest/email) login. await page.addInitScript(() => { Object.assign(window, { Telegram: { WebApp: { initData: 'query_id=bootfail&user=%7B%22id%22%3A1%7D&auth_date=1&hash=deadbeef', initDataUnsafe: {}, ready() {}, expand() {}, }, }, }); }); await page.goto('/'); // After the silent retries, the boot-error screen with its Retry button shows… await expect(page.getByRole('button', { name: 'Retry' })).toBeVisible(); // …and the web login (guest) is never shown inside Telegram. await expect(page.getByRole('button', { name: /guest/i })).toHaveCount(0); }); test('outside Telegram, the /telegram/ entry shows the launch diagnostic, not a redirect', async ({ page, }) => { await page.goto('/telegram/'); // The entry no longer bounces a visitor without Telegram sign-in data to the marketing landing; // it shows a compact diagnostic screen (Share + Retry) that helps pinpoint why initData was // absent — notably the Android empty-initData failure. await expect(page.getByRole('button', { name: 'Share' })).toBeVisible(); await expect(page.getByRole('button', { name: 'Retry' })).toBeVisible(); // It stays on /telegram/ (no redirect) and never shows the web (guest) login. await expect(page).toHaveURL(/\/telegram\//); await expect(page.getByRole('button', { name: /guest/i })).toHaveCount(0); }); test('inside Telegram (online-only), an offline signal never switches the app to offline mode', async ({ page, }) => { // The Telegram mini-app is online-only: the offline model (implicit offline, device-local games, // the transport kill switch) must stay inert there. Even when the net-state machine is driven to an // offline state, offlineMode must remain false — otherwise the chrome turns blue, the lobby greys the // server games and, critically, a vs_ai start would create a device-local game instead of enqueuing. await page.addInitScript((stub) => { Object.assign(window, stub); }, webAppStub()); await page.goto('/'); await expect(page.getByText('Your turn')).toBeVisible(); // the durable mini-app session, in the lobby // Drive the net-state machine to an offline state through the mock hook. await page.evaluate(() => (window as unknown as { __net: { offline(): void } }).__net.offline()); // Because the channel is online-only, offlineMode stays inert: on the lobby the chrome never turns blue // and no server game is greyed… await expect(page.locator('header.nav.offline')).toHaveCount(0); await expect(page.locator('.rowwrap.greyed')).toHaveCount(0); // …and New Game's quick match still offers the opponent choice (AI / random), which is hidden only in // real offline mode. Its presence is the positive proof that offlineMode is false — so the vs_ai start, // whose device-local branch is gated on offlineMode, enqueues on the server instead of creating a // device-local game. await page.locator('button.tab').nth(0).click(); await expect(page.locator('button.opt', { hasText: '🤖' })).toBeVisible(); }); test('inside Telegram (online-only), New Game with friends offers remote invites only', async ({ page, }) => { // A Telegram launch authenticates a durable account, so New Game shows the auto/with-friends selector. // "Play with friends" must offer only the remote invite — never the online/offline segment, whose // "Pass and play" is the device-local hotseat flow that has no place in an online-only mini-app. await page.addInitScript((stub) => { Object.assign(window, stub); }, webAppStub()); await page.goto('/'); await expect(page.getByText('Your turn')).toBeVisible(); await page.locator('button.tab').nth(0).click(); // the New tab opens the create screen await page.getByRole('button', { name: 'Play with friends' }).click(); // The online/offline segment (Invite a friend / Pass and play) is absent — only the invite form shows. await expect(page.getByRole('button', { name: 'Pass and play' })).toHaveCount(0); await expect(page.getByRole('button', { name: 'Invite a friend' })).toHaveCount(0); }); test('a blocked telegram-web-app.js does not hang the diagnostic screen', async ({ page }) => { // Simulate a network where telegram.org is unreachable: the SDK fetch fails. Because the SPA // loads the SDK dynamically with a timeout (not a render-blocking