Files
ghatreh_user/src/modules/pwa/pwaInstall.ts
T

130 lines
3.8 KiB
TypeScript

import { PWA_MANIFEST_READY_EVENT } from '@/modules/pwa/manifest'
import { isTWA } from '@/utils/config'
export const PWA_INSTALL_BANNER_DISMISSED_KEY = 'pwa-install-banner-dismissed'
type BeforeInstallPromptEvent = Event & {
prompt: () => Promise<void>
userChoice: Promise<{ outcome: 'accepted' | 'dismissed' }>
}
let deferredInstallPrompt: BeforeInstallPromptEvent | null = null
let installListenerInitialized = false
export function isStandalonePwa() {
if (typeof window === 'undefined') return false
const nav = window.navigator as Navigator & { standalone?: boolean }
if (nav.standalone) return true
// installed / launched as app (not a normal browser tab)
const modes = ['standalone', 'fullscreen', 'minimal-ui', 'window-controls-overlay'] as const
return modes.some((mode) => window.matchMedia(`(display-mode: ${mode})`).matches)
}
/** دکمه/منوی نصب فقط وقتی هنوز داخل مرورگر عادی هستیم. */
export function shouldOfferPwaInstall() {
if (typeof window === 'undefined') return false
if (isStandalonePwa() || isTWA()) return false
return true
}
export function isAppleMobileDevice() {
if (typeof navigator === 'undefined') return false
const ua = navigator.userAgent || ''
if (/iPhone|iPod/i.test(ua)) return true
if (/iPad/i.test(ua)) return true
const isTouchMac = navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1
if (!isTouchMac) return false
if (/CriOS|FxiOS|EdgiOS/i.test(ua)) return true
if (/Chrome|Edg|Firefox|OPR/i.test(ua) && !/Mobile/i.test(ua)) return false
return true
}
export function isAndroidDevice() {
if (typeof navigator === 'undefined') return false
return /Android/i.test(navigator.userAgent || '')
}
export function isMobileBrowser() {
if (typeof window === 'undefined') return false
const coarsePointer = window.matchMedia('(pointer: coarse)').matches
const narrowViewport = window.matchMedia('(max-width: 767.98px)').matches
return coarsePointer || narrowViewport || isAppleMobileDevice() || isAndroidDevice()
}
export function getDefaultPwaPlatform(): 'android' | 'ios' {
if (isAppleMobileDevice()) return 'ios'
return 'android'
}
export function hasNativeInstallPrompt() {
return Boolean(deferredInstallPrompt)
}
export function isPwaInstallBannerDismissed() {
if (typeof localStorage === 'undefined') return false
return localStorage.getItem(PWA_INSTALL_BANNER_DISMISSED_KEY) === '1'
}
export function dismissPwaInstallBanner() {
localStorage.setItem(PWA_INSTALL_BANNER_DISMISSED_KEY, '1')
}
/** بعد از اولین نمایش بنر / راهنما دیگر نشان داده نشود. */
export function markPwaInstallBannerAsShown() {
dismissPwaInstallBanner()
}
export function shouldShowPwaInstallPrompt() {
if (typeof window === 'undefined') return false
if (!window.isSecureContext) return false
if (!shouldOfferPwaInstall()) return false
if (isPwaInstallBannerDismissed()) return false
return true
}
export function initPwaInstallPromptListener() {
if (installListenerInitialized || typeof window === 'undefined') return
installListenerInitialized = true
window.addEventListener(PWA_MANIFEST_READY_EVENT, (event) => {
const installEvent = (event as CustomEvent<{ installEvent?: Event | null }>).detail?.installEvent
if (installEvent) {
deferredInstallPrompt = installEvent as BeforeInstallPromptEvent
}
})
}
export async function triggerNativePwaInstall() {
const promptEvent = deferredInstallPrompt
if (!promptEvent) {
return false
}
try {
await promptEvent.prompt()
const choice = await promptEvent.userChoice
if (choice.outcome === 'accepted') {
deferredInstallPrompt = null
dismissPwaInstallBanner()
return true
}
} catch (error) {
console.warn('Native PWA install prompt failed', error)
}
return false
}