scrabble-game/ui/src/lib/share.test.ts

import { afterEach, describe, expect, it, vi } from 'vitest';
import { downloadUrl, pickGcgDelivery, pickTextShare, shareOrDownloadGcg, shareText } from './share';
import type { GcgExport } from './model';

const file = {} as File;

const gcg: GcgExport = { gameId: 'g1', filename: 'game.gcg', content: '#title game' };

describe('pickGcgDelivery', () => {
  const canShareNav = { canShare: () => true, share: async () => {} };
  const noShareNav = { canShare: () => false, share: async () => {} };

  it('shares when the platform can share files, even in an in-app webview (iOS)', () => {
    expect(pickGcgDelivery(canShareNav, file, false)).toBe('share');
    expect(pickGcgDelivery(canShareNav, file, true)).toBe('share');
  });

  it('copies in an in-app webview that cannot share files (Android Telegram/VK: no share, dead download)', () => {
    expect(pickGcgDelivery(noShareNav, file, true)).toBe('copy');
    expect(pickGcgDelivery(undefined, file, true)).toBe('copy');
    expect(pickGcgDelivery({ canShare: () => true } as never, file, true)).toBe('copy');
  });

  it('downloads on a plain browser without Web Share (desktop)', () => {
    expect(pickGcgDelivery(noShareNav, file, false)).toBe('download');
    expect(pickGcgDelivery(undefined, file, false)).toBe('download');
  });
});

describe('shareOrDownloadGcg', () => {
  afterEach(() => vi.unstubAllGlobals());

  const noCopy = async () => false;

  function stubDownloadEnv(canShare: boolean, share: () => Promise<void>) {
    const anchor = { href: '', download: '', click: vi.fn(), remove: vi.fn() };
    const createElement = vi.fn(() => anchor);
    vi.stubGlobal('File', class {});
    vi.stubGlobal('Blob', class {});
    vi.stubGlobal('navigator', { canShare: () => canShare, share });
    vi.stubGlobal('document', { createElement, body: { appendChild: vi.fn() } });
    vi.stubGlobal('URL', { createObjectURL: vi.fn(() => 'blob:x'), revokeObjectURL: vi.fn() });
    return { anchor, createElement };
  }

  it('never falls back to the navigating Blob download when a share is cancelled', async () => {
    // Reproduces the iOS Telegram Mini App break: Web Share is available and the user cancels it
    // (AbortError). The <a download> fallback navigates the WKWebView to the blob: URL and strands
    // the app, so a cancelled (or failed) share must do nothing here.
    const share = vi.fn().mockRejectedValue(new DOMException('cancelled', 'AbortError'));
    const { createElement } = stubDownloadEnv(true, share);

    expect(await shareOrDownloadGcg(gcg, false, noCopy)).toBe('shared');

    expect(share).toHaveBeenCalledOnce();
    expect(createElement).not.toHaveBeenCalled(); // no download anchor → no webview navigation
  });

  it('downloads via an anchor on a desktop browser that cannot share files', async () => {
    const { anchor, createElement } = stubDownloadEnv(false, vi.fn());

    expect(await shareOrDownloadGcg(gcg, false, noCopy)).toBe('downloaded');

    expect(createElement).toHaveBeenCalledWith('a');
    expect(anchor.click).toHaveBeenCalledOnce();
  });

  it('copies to the clipboard in an in-app webview that cannot share files (no dead Blob download)', async () => {
    // Android Telegram/VK expose no Web Share AND ignore <a download>, so the export must copy the
    // GCG text instead of silently issuing an anchor click that does nothing.
    const copy = vi.fn().mockResolvedValue(true);
    const { createElement } = stubDownloadEnv(false, vi.fn());

    expect(await shareOrDownloadGcg(gcg, true, copy)).toBe('copied');

    expect(copy).toHaveBeenCalledWith(gcg.content);
    expect(createElement).not.toHaveBeenCalled();
  });

  it('reports failure when the in-app clipboard copy fails', async () => {
    stubDownloadEnv(false, vi.fn());
    expect(await shareOrDownloadGcg(gcg, true, async () => false)).toBe('failed');
  });
});

describe('downloadUrl', () => {
  afterEach(() => vi.unstubAllGlobals());

  it('clicks a temporary anchor carrying the URL and the filename', () => {
    const anchor = { href: '', download: '', click: vi.fn(), remove: vi.fn() };
    const createElement = vi.fn(() => anchor);
    vi.stubGlobal('document', { createElement, body: { appendChild: vi.fn() } });

    downloadUrl('https://example.test/dl/g-1/png?e=1&s=x', 'game-1.png');

    expect(createElement).toHaveBeenCalledWith('a');
    expect(anchor.href).toBe('https://example.test/dl/g-1/png?e=1&s=x');
    expect(anchor.download).toBe('game-1.png');
    expect(anchor.click).toHaveBeenCalledOnce();
    expect(anchor.remove).toHaveBeenCalledOnce();
  });
});

describe('pickTextShare', () => {
  it('shares when Web Share is available', () => {
    expect(pickTextShare({ share: async () => {}, canShare: () => true })).toBe('share');
  });

  it('shares when share exists without canShare (text needs no file capability check)', () => {
    expect(pickTextShare({ share: async () => {} })).toBe('share');
  });

  it('copies when there is no Web Share (desktop)', () => {
    expect(pickTextShare(undefined)).toBe('copy');
    expect(pickTextShare({} as never)).toBe('copy');
  });
});

describe('shareText', () => {
  afterEach(() => vi.unstubAllGlobals());

  it('uses the OS share sheet when available', async () => {
    const share = vi.fn().mockResolvedValue(undefined);
    vi.stubGlobal('navigator', { share, canShare: () => true });
    expect(await shareText('diag', 'title')).toBe('shared');
    expect(share).toHaveBeenCalledWith({ title: 'title', text: 'diag' });
  });

  it('copies to the clipboard when Web Share is absent (desktop)', async () => {
    const writeText = vi.fn().mockResolvedValue(undefined);
    vi.stubGlobal('navigator', { clipboard: { writeText } });
    expect(await shareText('diag', 'title')).toBe('copied');
    expect(writeText).toHaveBeenCalledWith('diag');
  });

  it('reports failure without a fallback when the share is cancelled', async () => {
    const share = vi.fn().mockRejectedValue(new DOMException('cancelled', 'AbortError'));
    vi.stubGlobal('navigator', { share, canShare: () => true });
    expect(await shareText('diag', 'title')).toBe('failed');
  });
});