Ilia Denisov
da17c18895
CI / changes (pull_request) Successful in 2s
CI / unit (pull_request) Has been skipped
CI / integration (pull_request) Has been skipped
CI / ui (pull_request) Successful in 55s
CI / gate (pull_request) Successful in 0s
CI / deploy (pull_request) Successful in 1m25s
Group B of the VK integration — the contour-verified follow-up to the launch+auth MVP: - Share/copy inside the VK iframe go through VK Bridge: the friend-code invite shares via VKWebAppShare and copies via VKWebAppCopyText, since navigator.share is absent in the desktop iframe and navigator.clipboard is blocked there. - The invite link is a VK Mini App direct link (vk.com/app<id>#f<code>) on VK instead of the Telegram link; the app id comes from vk_app_id in the launch params (no build arg needed). The recipient's launch routes the deep link from VK's `hash` launch query parameter. - The app's "auto" theme follows the VK client's light/dark appearance (VKWebAppUpdateConfig), which the VK mobile webview's prefers-color-scheme does not track. - The safe-area CSS vars default to env(safe-area-inset-*), so the VK mobile layout clears the home bar (and Capacitor/PWA too); Telegram still overrides them from its SDK. vk.ts adds vkAppId/vkStartParam/vkShare/vkCopyText/vkOnScheme. Verified: svelte-check, 347 unit (+ vkAppId/vkStartParam/vkShareLink), build, bundle-gate. The VK-Bridge behaviours need the live contour (not reproducible headless).
92 lines
3.3 KiB
TypeScript
92 lines
3.3 KiB
TypeScript
// Telegram Mini App deep-link "start parameters", mirroring the connector's Go
|
|
// scheme (platform/telegram/internal/deeplink): a one-character kind prefix plus a
|
|
// value —
|
|
// g<game uuid> open that game
|
|
// i<invitation uuid> open that invitation
|
|
// f<6-digit code> redeem that friend code
|
|
// An empty or unrecognised parameter opens the lobby.
|
|
|
|
import { vkAppId } from './vk';
|
|
|
|
export type DeepLink =
|
|
| { kind: 'lobby' }
|
|
| { kind: 'game'; id: string }
|
|
| { kind: 'invitation'; id: string }
|
|
| { kind: 'friendCode'; code: string };
|
|
|
|
/** parseStartParam classifies a Telegram start parameter into a routing target. */
|
|
export function parseStartParam(param: string | undefined | null): DeepLink {
|
|
if (!param) return { kind: 'lobby' };
|
|
const value = param.slice(1);
|
|
if (!value) return { kind: 'lobby' };
|
|
switch (param[0]) {
|
|
case 'g':
|
|
return { kind: 'game', id: value };
|
|
case 'i':
|
|
return { kind: 'invitation', id: value };
|
|
case 'f':
|
|
return { kind: 'friendCode', code: value };
|
|
default:
|
|
return { kind: 'lobby' };
|
|
}
|
|
}
|
|
|
|
/** gameParam builds the start parameter that opens a game. */
|
|
export const gameParam = (id: string): string => 'g' + id;
|
|
/** invitationParam builds the start parameter that opens an invitation. */
|
|
export const invitationParam = (id: string): string => 'i' + id;
|
|
/** friendCodeParam builds the start parameter that redeems a friend code. */
|
|
export const friendCodeParam = (code: string): string => 'f' + code;
|
|
|
|
function envVar(name: string): string | undefined {
|
|
return (import.meta.env as Record<string, string | undefined>)[name];
|
|
}
|
|
|
|
/**
|
|
* telegramBase returns the single bot's Mini App link base (e.g. https://t.me/<bot>/<app>)
|
|
* from VITE_TELEGRAM_LINK, or null when it is not configured.
|
|
*/
|
|
function telegramBase(): string | null {
|
|
return envVar('VITE_TELEGRAM_LINK') || null;
|
|
}
|
|
|
|
/**
|
|
* botUsername extracts the bot's @username (without the @) from the configured Mini App
|
|
* link: the first path segment of https://t.me/<bot>/<app>. Returns null when no base is
|
|
* configured or the link carries no path.
|
|
*/
|
|
export function botUsername(): string | null {
|
|
const base = telegramBase();
|
|
if (!base) return null;
|
|
try {
|
|
const seg = new URL(base).pathname.split('/').filter(Boolean)[0];
|
|
return seg || null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* shareLink wraps a deep-link start parameter in a t.me Mini App link for the single
|
|
* bot. Returns null when no base is configured, so callers can hide the share affordance.
|
|
*/
|
|
export function shareLink(param: string): string | null {
|
|
const base = telegramBase();
|
|
if (!base) return null;
|
|
const sep = base.includes('?') ? '&' : '?';
|
|
return `${base}${sep}startapp=${encodeURIComponent(param)}`;
|
|
}
|
|
|
|
/**
|
|
* vkShareLink wraps a deep-link start parameter in a VK Mini App direct link
|
|
* (https://vk.com/app<id>#<param>). VK forwards everything after the '#' to the app as the `hash`
|
|
* launch parameter (read back by vk.ts vkStartParam); a query string ('?') is not supported for VK
|
|
* direct links. Returns null when the VK app id is unknown (outside a VK launch), so the caller
|
|
* falls back to the Telegram/web link.
|
|
*/
|
|
export function vkShareLink(param: string): string | null {
|
|
const id = vkAppId();
|
|
if (!id) return null;
|
|
return `https://vk.com/app${id}#${param}`;
|
|
}
|