Files
web-at-transit/frontend/public/sw.js
T
Bkk1234 092f551b7d Add service worker and harden the web app manifest for Android 14+ / iOS 17+
Android (Samsung S23, One UI 6) refuses 'Install app' / standalone mode
when the origin is not secure or the app has no service worker. The ported
Next.js app shipped neither: only a manifest existed, and no sw.js at all.

- public/sw.js: navigation network-first with an offline fallback,
  cache-first for static assets, /api and /files bypassed, versioned
  cache with skipWaiting + clients.claim.
- public/offline.html: offline shell.
- src/components/PwaBoot.tsx: registers the worker, wires
  beforeinstallprompt into an in-app install button, and shows a
  share-sheet hint on iOS/Samsung Internet where the event never fires.
- ui-manifest.json: add id, display_override, prefer_related_applications,
  launch_handler, handle_links, a maskable icon for Android 14 and
  screenshots for the install preview.
- layout.tsx: viewport-fit=cover, interactive-widget, maximumScale 5
  (never user-scalable=no), appleWebApp metadata, format detection off,
  and drop manually duplicated meta tags that Next already emits.

Verified: manifest passes 8/8 installability checks, sw.js and offline.html
serve with correct content types, tsc clean, npm run build passes.
2026-10-23 22:40:58 +07:00

124 lines
4.4 KiB
JavaScript

/* ============================================================
Atroute — Service Worker (Next.js)
ทำไมต้องมี:
Chrome/Edge/Samsung Internet จะ "ติดตั้งเป็นแอป" ได้ก็ต่อเมื่อ
1) เสิร์ฟผ่าน HTTPS (หรือ localhost)
2) มี manifest ที่ถูกต้อง (192 + 512 icon, start_url, display)
3) ★ มี service worker ที่มี fetch handler ควบคุมหน้าเว็บ
ข้อ 3 คือสิ่งที่ Next.js ไม่มีให้เอง — ไฟล์นี้คือคำตอบ
กลยุทธ์
- นำทาง (HTML) → network-first (ออนไลน์ได้ของใหม่, ออฟไลน์ใช้ cache)
- /_next/static, /image, /vendor, ฟอนต์ → cache-first (เร็ว + ออฟไลน์ได้)
- /api → ไม่แตะ (ให้ network จัดการ)
- SW ใหม่ → skipWaiting + clients.claim + แจ้งหน้าเว็บ
============================================================ */
const VERSION = "1.0.0";
const CACHE = `atroute-${VERSION}`;
const OFFLINE_URL = "/offline.html";
/* ไฟล์ที่ precache ไว้ใช้ตอนออฟไลน์ (เฉพาะที่ path คงที่) */
const PRECACHE = [
"/",
OFFLINE_URL,
"/ui-manifest.json",
"/image/icons/minibus-192x192.png",
"/image/icons/minibus-512x512.png",
"/image/icons/minibus-maskable-512x512.png",
"/logo.svg",
"/vendor/fonts/k2d.css",
"/vendor/leaflet/leaflet.css",
];
self.addEventListener("install", (event) => {
event.waitUntil(
caches
.open(CACHE)
.then((cache) => cache.addAll(PRECACHE).catch(() => undefined))
.then(() => self.skipWaiting()),
);
});
self.addEventListener("activate", (event) => {
event.waitUntil(
caches
.keys()
.then((keys) => Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k))))
.then(() => self.clients.claim())
.then(() => {
self.clients.matchAll({ type: "window" }).then((cs) => {
cs.forEach((c) => c.postMessage({ type: "SW_ACTIVATED", version: VERSION }));
});
}),
);
});
self.addEventListener("message", (event) => {
if (event.data === "SKIP_WAITING") self.skipWaiting();
});
/** ไฟล์ static ที่ cache-first ได้ (path มี hash หรือไม่เปลี่ยนบ่อย) */
function isStaticAsset(url) {
return (
url.pathname.startsWith("/_next/static/") ||
url.pathname.startsWith("/image/") ||
url.pathname.startsWith("/vendor/") ||
url.pathname.startsWith("/content/") ||
/\.(?:png|jpe?g|webp|avif|svg|ico|woff2?|ttf|css|js)$/i.test(url.pathname)
);
}
self.addEventListener("fetch", (event) => {
const req = event.request;
if (req.method !== "GET") return;
const url = new URL(req.url);
/* ไม่ยุ่งกับ API และ cross-origin */
if (url.origin !== self.location.origin) return;
if (url.pathname.startsWith("/api/") || url.pathname.startsWith("/files/")) return;
/* ---- นำทาง: network-first + offline fallback ---- */
if (req.mode === "navigate") {
event.respondWith(
fetch(req)
.then((res) => {
const copy = res.clone();
caches.open(CACHE).then((c) => c.put(req, copy)).catch(() => undefined);
return res;
})
.catch(async () => {
const cached = await caches.match(req);
return cached || (await caches.match(OFFLINE_URL)) || Response.error();
}),
);
return;
}
/* ---- static: cache-first แล้วค่อยเติม cache ---- */
if (isStaticAsset(url)) {
event.respondWith(
caches.match(req).then((cached) => {
if (cached) return cached;
return fetch(req).then((res) => {
if (res.ok && res.type === "basic") {
const copy = res.clone();
caches.open(CACHE).then((c) => c.put(req, copy)).catch(() => undefined);
}
return res;
});
}),
);
return;
}
/* ---- อื่น ๆ: network-first ---- */
event.respondWith(
fetch(req)
.then((res) => res)
.catch(() => caches.match(req).then((r) => r || Response.error())),
);
});