VK user init data: utm, info

Author: kosyachniy

.github/workflows/deploy.yml

@@ -106,6 +106,7 @@ jobs:
           port: ${{ secrets.PORT }}
           username: ${{ secrets.USER }}
           key: ${{ secrets.SSH }}
+          command_timeout: 30m
           # script_stop: true
           script: |
             # set -euo pipefail
@@ -201,7 +202,7 @@ jobs:
                 "${STACK}_${service}"
             done
 
-            #
+            echo "Clean"
             yes | sudo docker system prune -a
 
             # check services

AGENTS.md

@@ -47,6 +47,7 @@ The "tasks" feature is a reward checklist that grants users inner coins after ve
 ## Referrals (Frens)
 - Backend: `POST /users/frens/` returns the current user's frens list (sorted by balance) with relation labels and `referral_link`.
 - Referral key: `UserLocal.link` is generated via `encrypt(user.id, 8)` and decoded with `decrypt()` in `routes/users/auth.update_utm` to resolve referrers.
+- VK Mini Apps: share links should use `vk_ref=<referral>` so the frontend can map it to `utm` on session init.
 - Frontend: `web/src/app/[locale]/social/page.tsx` renders the frens list and uses `navigation.frens` + `social.*` i18n; mobile bottom bar includes the frens entry linking to `/social`.
 
 ## Environments

web/src/features/auth/api/authApi.ts

@@ -41,6 +41,10 @@ export async function loginWithTelegramAppApi(data: TelegramAppAuthRequest): Pro
 export interface VkAppAuthRequest {
     url: string;
     utm?: string | null;
+    name?: string | null;
+    surname?: string | null;
+    image?: string | null;
+    mail?: string | null;
 }
 
 export async function loginWithVkAppApi(data: VkAppAuthRequest): Promise<AuthUser> {

web/src/features/auth/components/VkAuthInitializer.tsx

@@ -8,6 +8,53 @@ import { useAppDispatch, useAppSelector } from '@/shared/stores/store';
 import { isVkMiniApp } from '@/shared/lib/vk';
 import { loginWithVkApp, selectAuthUser } from '../stores/authSlice';
 
+type VkUserInfo = {
+    first_name?: string;
+    last_name?: string;
+    photo_200?: string;
+    photo_200_orig?: string;
+    photo_100?: string;
+};
+
+const getVkUtm = () => {
+    if (typeof window === 'undefined') return null;
+    const params = new URLSearchParams(window.location.search);
+    return params.get('utm') || params.get('vk_ref') || null;
+};
+
+const getVkEmail = () => {
+    if (typeof window === 'undefined') return null;
+    const params = new URLSearchParams(window.location.search);
+    return params.get('vk_email') || null;
+};
+
+const getVkUserInfo = async (): Promise<VkUserInfo | null> => {
+    if (typeof window === 'undefined') return null;
+    const bridge = window.vkBridge;
+    if (!bridge?.send) return null;
+
+    const supportsAsync = (bridge as unknown as { supportsAsync?: (method: string) => Promise<boolean> }).supportsAsync;
+    if (typeof supportsAsync === 'function') {
+        try {
+            const supported = await supportsAsync('VKWebAppGetUserInfo');
+            if (!supported) return null;
+        } catch {
+            // Ignore capability detection errors.
+        }
+    }
+
+    try {
+        const response = await bridge.send('VKWebAppGetUserInfo');
+        if (response && typeof response === 'object') {
+            return response as VkUserInfo;
+        }
+    } catch {
+        // Ignore VK bridge errors.
+    }
+
+    return null;
+};
+
 export default function VkAuthInitializer() {
     const dispatch = useAppDispatch();
     const { error: showError } = useToastActions();
@@ -28,8 +75,25 @@ export default function VkAuthInitializer() {
 
         hasAttempted.current = true;
         inFlightRef.current = true;
-        dispatch(loginWithVkApp({ url, utm }))
-            .unwrap()
+        const runAuth = async () => {
+            const resolvedUtm = utm || getVkUtm();
+            const userInfo = await getVkUserInfo();
+            const image = userInfo?.photo_200_orig || userInfo?.photo_200 || userInfo?.photo_100 || null;
+            const mail = getVkEmail();
+
+            return dispatch(
+                loginWithVkApp({
+                    url,
+                    utm: resolvedUtm,
+                    name: userInfo?.first_name,
+                    surname: userInfo?.last_name,
+                    image,
+                    mail,
+                })
+            ).unwrap();
+        };
+
+        runAuth()
             .catch((err) => {
                 showError(formatApiErrorMessage(err, tSystem('server_error')));
             })

web/src/features/session/components/SessionInitializer.tsx

@@ -17,7 +17,7 @@ export default function SessionInitializer() {
     const authToken = useAppSelector((state) => state.session.authToken);
     const { error: showError } = useToastActions();
 
-    const utmParam = useMemo(() => searchParams?.get('utm') || null, [searchParams]);
+    const utmParam = useMemo(() => searchParams?.get('utm') || searchParams?.get('vk_ref') || null, [searchParams]);
 
     useEffect(() => {
         if (utmParam) {

web/src/widgets/social/ui/SocialPage.tsx

@@ -49,7 +49,7 @@ const buildVkReferralUrl = (referralKey: string) => {
     }
 
     const url = new URL(`https://vk.com/app${appId}`);
-    url.searchParams.set('utm', referralKey);
+    url.searchParams.set('vk_ref', referralKey);
     return url.toString();
 };
 
@@ -115,7 +115,7 @@ const openTelegramShareMessage = (messageId: string) => {
     return true;
 };
 
-const openVkShare = async ({ url, text }: { url: string; text?: string }) => {
+const openVkShare = async ({ url, text, forceLink = false }: { url: string; text?: string; forceLink?: boolean }) => {
     if (typeof window === 'undefined') return false;
     const bridge = window.vkBridge;
     if (!bridge?.send) return false;
@@ -125,8 +125,12 @@ const openVkShare = async ({ url, text }: { url: string; text?: string }) => {
             ? (bridge as unknown as { isWebView: () => boolean }).isWebView()
             : false;
 
+    if (forceLink && !(await supportsVkMethod('VKWebAppShare'))) {
+        return false;
+    }
+
     // New invite dialog (mobile webview only; crashes on desktop/messenger if unsupported).
-    if (isWebView && (await supportsVkMethod('VKWebAppShowInviteBox'))) {
+    if (!forceLink && isWebView && (await supportsVkMethod('VKWebAppShowInviteBox'))) {
         const inviteParams = text ? { message: text } : undefined;
         try {
             await bridge.send('VKWebAppShowInviteBox', inviteParams);
@@ -144,7 +148,7 @@ const openVkShare = async ({ url, text }: { url: string; text?: string }) => {
     }
 
     // VK recommend sheet (if available) - no custom text support.
-    if (await supportsVkMethod('VKWebAppRecommend')) {
+    if (!forceLink && (await supportsVkMethod('VKWebAppRecommend'))) {
         try {
             await bridge.send('VKWebAppRecommend');
             return true;
@@ -439,8 +443,7 @@ export default function SocialPage() {
             }
 
             if (network === 'vk' || hasVkBridge) {
-                const shareMessage = text ? `${text} ${url}` : url;
-                if (await openVkShare({ url, text: shareMessage })) return;
+                if (await openVkShare({ url, text, forceLink: true })) return;
             }
 
             if (network === 'max') {