offline-page-kit 0.1.1 → 0.2.2

package/README.md

@@ -0,0 +1,264 @@
+<!-- =============================================== -->
+<!-- 🔥 Animated SVG Header Banner -->
+<!-- =============================================== -->
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=waving&color=ff7a00&height=200&section=header&text=offline-page-kit&fontSize=42&fontColor=ffffff&animation=fadeIn&fontAlignY=38" />
+</p>
+
+<p align="center">
+  <b>Framework-agnostic Offline Fallback System</b><br/>
+  Lightweight • Deterministic • Production-Safe
+</p>
+
+---
+
+<!-- =============================================== -->
+<!-- 🌐 Social & Community Links -->
+<!-- =============================================== -->
+
+<p align="center">
+  🌍 <b>Website:</b> <a href="https://devcrack.dev">devcrack.dev</a> &nbsp; | &nbsp;
+  ▶️ <b>YouTube:</b> <a href="https://www.youtube.com/@dev-crack">DevCrack Channel</a><br/>
+  🔹 <b>Facebook:</b> <a href="https://web.facebook.com/profile.php?id=61573018852861">Profile</a> &nbsp; | &nbsp;
+  🔹 <b>Community Group:</b> <a href="https://web.facebook.com/groups/1672263410026163">Join Community</a>
+</p>
+
+---
+
+<!-- =============================================== -->
+<!-- 🟢 NPM + CI + Coverage Badges -->
+<!-- =============================================== -->
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/offline-page-kit">
+    <img src="https://img.shields.io/npm/v/offline-page-kit?style=for-the-badge&color=orange" alt="npm version">
+  </a>
+  <a href="https://www.npmjs.com/package/offline-page-kit">
+    <img src="https://img.shields.io/npm/dm/offline-page-kit?style=for-the-badge&color=blue" alt="npm downloads">
+  </a>
+  <a href="https://bundlephobia.com/package/offline-page-kit">
+    <img src="https://img.shields.io/bundlephobia/minzip/offline-page-kit?style=for-the-badge&color=purple" alt="bundle size">
+  </a>
+  <img src="https://img.shields.io/github/actions/workflow/status/YOUR_GITHUB_USERNAME/offline-page-kit/ci.yml?style=for-the-badge" alt="CI status">
+  <img src="https://img.shields.io/codecov/c/github/YOUR_GITHUB_USERNAME/offline-page-kit?style=for-the-badge" alt="coverage">
+  <img src="https://img.shields.io/badge/TypeScript-Ready-3178c6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript Ready">
+  <img src="https://img.shields.io/badge/Zero-Dependencies-black?style=for-the-badge" alt="Zero Dependencies">
+</p>
+
+---
+
+# 📦 offline-page-kit
+
+> Minimal, framework-agnostic Service Worker generator that prevents blank screens during network failure.
+
+---
+
+# 🟡 Professional npm Description
+
+**offline-page-kit** is a lightweight, zero-dependency Service Worker toolkit that provides deterministic offline fallback behavior for modern web applications.
+
+It guarantees that when network connectivity fails, users see a controlled offline experience instead of browser error pages or blank screens.
+
+Designed for production-grade stability across:
+
+- Next.js
+- Vite
+- React
+- Vue
+- Static sites
+- Any public-folder architecture
+
+No Workbox.  
+No complex runtime caching layers.  
+No unpredictable asset behavior.
+
+Just reliable navigation fallback.
+
+---
+
+# 🚀 Quick Start
+
+### 1️⃣ Install
+
+```
+npm install offline-page-kit
+```
+
+### 2️⃣ Generate Service Worker
+
+```
+npx offline-page-kit init --outDir public
+```
+
+This generates:
+
+```
+public/
+ ├── sw.js
+ ├── offline.html
+ └── offline.svg
+```
+
+### 3️⃣ Register in Client
+
+```ts
+import { registerOfflineKit } from "offline-page-kit";
+
+registerOfflineKit({ debug: true });
+```
+
+Done ✅
+
+---
+
+# 🧠 Architecture
+
+```
+Browser
+   ↓
+Service Worker
+   ↓
+Fetch Navigation Request
+   ├─ Network OK  → return live page
+   └─ Network FAIL → return cached offline.html
+```
+
+Only navigation requests are intercepted.
+
+No API mutation.  
+No asset rewriting.  
+No hidden caching layers.
+
+---
+
+# 🔄 Lifecycle
+
+```
+Install → Activate → Control → Fetch
+```
+
+### Install
+- Caches offline page + fallback image
+- Uses Promise.allSettled() to avoid failure
+
+### Activate
+- Immediately claims clients
+
+### Fetch
+- Applies network-first
+- Falls back to offline page
+
+---
+
+# 🧩 Framework Examples
+
+## Next.js (App Router)
+
+```tsx
+"use client";
+
+import { useEffect } from "react";
+import { registerOfflineKit } from "offline-page-kit";
+
+export default function SWRegister() {
+  useEffect(() => {
+    registerOfflineKit({ debug: true });
+  }, []);
+  return null;
+}
+```
+
+---
+
+## Vite / React
+
+```ts
+import { registerOfflineKit } from "offline-page-kit";
+
+registerOfflineKit();
+```
+
+---
+
+# ⚙ CLI Options
+
+```
+npx offline-page-kit init \
+  --outDir public \
+  --offlinePage /offline.html \
+  --offlineImage /offline.svg \
+  --cacheName my-app-cache
+```
+
+| Option | Default | Description |
+|--------|---------|------------|
+| outDir | public | Static folder |
+| offlinePage | /offline.html | Navigation fallback |
+| offlineImage | /offline.svg | Fallback asset |
+| cacheName | offline-page-kit | Cache namespace |
+
+---
+
+# 🔐 Security
+
+- Requires HTTPS (or localhost)
+- Does not cache authenticated APIs
+- Does not alter CORS behavior
+- Per-origin scoped
+
+---
+
+# ⚡ Performance
+
+- Zero runtime dependencies
+- Minimal memory usage
+- No background sync
+- No bundle overhead
+
+---
+
+# 🧪 Testing
+
+1. Load site
+2. Reload once
+3. DevTools → Application → Service Workers
+4. Enable Offline
+5. Refresh
+
+Offline page should render.
+
+---
+
+# 🏢 Production Notes
+
+- Always deploy over HTTPS
+- Version cache when updating logic
+- Avoid multiple SWs in same scope
+
+---
+
+# 🧭 Roadmap
+
+- Asset caching layer
+- API strategy module
+- Auto public folder scan
+- Cache version hashing
+- Metrics integration
+- Advanced fallback strategies
+
+---
+
+# 📜 License
+
+MIT
+
+---
+
+<p align="center">
+  Built for modern web applications.
+</p>
+
+<p align="center">
+  <img src="https://capsule-render.vercel.app/api?type=waving&color=ff7a00&height=120&section=footer"/>
+</p>

package/dist/cli.cjs

@@ -105,127 +105,23 @@ function offlineSvgTemplate() {
 }
 
 // src/core/swTemplate.ts
-var DEFAULT_EXTS = [
-  "js",
-  "css",
-  "map",
-  "ico",
-  "png",
-  "jpg",
-  "jpeg",
-  "webp",
-  "svg",
-  "gif",
-  "woff2",
-  "woff",
-  "ttf",
-  "eot",
-  "json",
-  "txt",
-  "xml",
-  "webmanifest"
-];
-function jsString(v) {
-  return JSON.stringify(v);
-}
+var js = (v) => JSON.stringify(v);
 function buildServiceWorkerJS(options2) {
-  const {
-    cacheName,
-    offlinePage,
-    offlineImage,
-    precache,
-    htmlStrategy,
-    assetStrategy,
-    imageStrategy,
-    assetExtensions,
-    apiPrefixes
-  } = options2;
-  return `/* offline-page-kit service worker */
-const CACHE_NAME = ${jsString(cacheName)};
-const OFFLINE_PAGE = ${jsString(offlinePage)};
-const OFFLINE_IMAGE = ${jsString(offlineImage)};
-const PRECACHE = ${jsString([offlinePage, offlineImage, ...precache].filter(Boolean))};
-
-const HTML_STRATEGY = ${jsString(htmlStrategy)};
-const ASSET_STRATEGY = ${jsString(assetStrategy)};
-const IMAGE_STRATEGY = ${jsString(imageStrategy)};
-
-const ASSET_EXTS = new Set(${jsString(assetExtensions.length ? assetExtensions : DEFAULT_EXTS)});
-const API_PREFIXES = ${jsString(apiPrefixes)};
-
-// helpers
-const isApi = (url) => API_PREFIXES.some(p => url.href.startsWith(p) || url.pathname.startsWith(p));
-const extOf = (pathname) => {
-  const i = pathname.lastIndexOf(".");
-  return i === -1 ? "" : pathname.slice(i+1).toLowerCase();
-};
-
-async function cacheGet(req) {
-  const cache = await caches.open(CACHE_NAME);
-  return cache.match(req);
-}
-async function cachePut(req, res) {
-  const cache = await caches.open(CACHE_NAME);
-  await cache.put(req, res);
-}
-async function cacheDeleteOld() {
-  const keys = await caches.keys();
-  await Promise.all(keys.map(k => (k === CACHE_NAME ? null : caches.delete(k))));
-}
-
-// strategies
-async function networkFirst(req, fallbackUrl) {
-  try {
-    const res = await fetch(req);
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  } catch {
-    const cached = await cacheGet(req);
-    if (cached) return cached;
-    if (fallbackUrl) return cacheGet(fallbackUrl);
-    return new Response("Offline", { status: 503 });
-  }
-}
-
-async function cacheFirst(req, fallbackUrl) {
-  const cached = await cacheGet(req);
-  if (cached) return cached;
-  try {
-    const res = await fetch(req);
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  } catch {
-    if (fallbackUrl) return cacheGet(fallbackUrl);
-    return new Response("Offline", { status: 503 });
-  }
-}
-
-async function staleWhileRevalidate(req) {
-  const cached = await cacheGet(req);
-  const fetchPromise = fetch(req).then(res => {
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  }).catch(() => null);
-
-  return cached || (await fetchPromise) || new Response("Offline", { status: 503 });
-}
-
-function pickStrategy(name) {
-  if (name === "cacheFirst") return cacheFirst;
-  if (name === "staleWhileRevalidate") return staleWhileRevalidate;
-  return networkFirst;
-}
+  const { cacheName, offlinePage, offlineImage } = options2;
+  return `/* offline-page-kit service worker (minimal) */
+const CACHE_NAME = ${js(cacheName)};
+const OFFLINE_PAGE = ${js(offlinePage)};
+const OFFLINE_IMAGE = ${js(offlineImage)};
 
 self.addEventListener("install", (event) => {
   event.waitUntil((async () => {
     const cache = await caches.open(CACHE_NAME);
 
-    const urls = [OFFLINE_PAGE, OFFLINE_IMAGE];
-
-    // \u2705 Do not let one 404 kill the whole SW install
-    await Promise.allSettled(
-      urls.map((u) => cache.add(u))
-    );
+    // \u2705 Do not let one 404 kill the install
+    await Promise.allSettled([
+      cache.add(OFFLINE_PAGE),
+      cache.add(OFFLINE_IMAGE),
+    ]);
 
     await self.skipWaiting();
   })());
@@ -240,7 +136,7 @@ self.addEventListener("activate", (event) => {
 self.addEventListener("fetch", (event) => {
   const req = event.request;
 
-  // \u2705 Offline fallback for page navigations
+  // \u2705 Offline fallback only for page navigations
   if (req.mode === "navigate") {
     event.respondWith((async () => {
       try {

package/dist/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/core/utils.ts","../src/core/offlineHtml.ts","../src/core/offlineSvg.ts","../src/core/swTemplate.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport path from \"node:path\";\r\nimport { parseArgs, splitList, writeFileSafe, exists } from \"./core/utils\";\r\nimport { offlineHtmlTemplate } from \"./core/offlineHtml\";\r\nimport { offlineSvgTemplate } from \"./core/offlineSvg\";\r\nimport { buildServiceWorkerJS } from \"./core/swTemplate\";\r\nimport type { OfflineKitBuildOptions } from \"./types\";\r\n\r\nfunction normalizePublicPath(p: string) {\r\n    if (!p.startsWith(\"/\")) return \"/\" + p;\r\n    return p;\r\n}\r\n\r\nfunction withDefaults(o: OfflineKitBuildOptions): Required<OfflineKitBuildOptions> {\r\n    return {\r\n        outDir: o.outDir ?? \"public\",\r\n        swFileName: o.swFileName ?? \"sw.js\",\r\n        offlinePage: normalizePublicPath(o.offlinePage ?? \"/offline.html\"),\r\n        offlineImage: normalizePublicPath(o.offlineImage ?? \"/offline.svg\"),\r\n        cacheName: o.cacheName ?? \"offline-page-kit\",\r\n        precache: o.precache ?? [],\r\n        htmlStrategy: o.htmlStrategy ?? \"networkFirst\",\r\n        assetStrategy: o.assetStrategy ?? \"staleWhileRevalidate\",\r\n        imageStrategy: o.imageStrategy ?? \"cacheFirst\",\r\n        assetExtensions: o.assetExtensions ?? [],\r\n        apiPrefixes: o.apiPrefixes ?? [],\r\n    };\r\n}\r\n\r\nconst args = parseArgs(process.argv.slice(2));\r\nconst cmd = process.argv.slice(2).find(a => !a.startsWith(\"--\")) || \"init\";\r\n\r\nconst outDir = path.resolve(process.cwd(), args.get(\"outDir\") || \"public\");\r\n\r\nconst options = withDefaults({\r\n    outDir,\r\n    swFileName: args.get(\"swFileName\") || \"sw.js\",\r\n    offlinePage: args.get(\"offlinePage\") || \"/offline.html\",\r\n    offlineImage: args.get(\"offlineImage\") || \"/offline.svg\",\r\n    cacheName: args.get(\"cacheName\") || \"offline-page-kit\",\r\n    precache: splitList(args.get(\"precache\")),\r\n    htmlStrategy: (args.get(\"htmlStrategy\") as any) || \"networkFirst\",\r\n    assetStrategy: (args.get(\"assetStrategy\") as any) || \"staleWhileRevalidate\",\r\n    imageStrategy: (args.get(\"imageStrategy\") as any) || \"cacheFirst\",\r\n    assetExtensions: splitList(args.get(\"assetExtensions\")),\r\n    apiPrefixes: splitList(args.get(\"apiPrefixes\")),\r\n} as OfflineKitBuildOptions);\r\n\r\nconst swOut = path.join(outDir, options.swFileName);\r\nconst offlineHtmlOut = path.join(outDir, options.offlinePage.replace(/^\\//, \"\"));\r\nconst offlineSvgOut = path.join(outDir, options.offlineImage.replace(/^\\//, \"\"));\r\n\r\nif (cmd === \"init\" || cmd === \"build\") {\r\n    // generate offline page if missing OR force (when build)\r\n    if (cmd === \"build\" || !exists(offlineHtmlOut)) {\r\n        writeFileSafe(offlineHtmlOut, offlineHtmlTemplate());\r\n    }\r\n    if (cmd === \"build\" || !exists(offlineSvgOut)) {\r\n        writeFileSafe(offlineSvgOut, offlineSvgTemplate());\r\n    }\r\n\r\n    const sw = buildServiceWorkerJS(options);\r\n    writeFileSafe(swOut, sw);\r\n\r\n    console.log(`[offline-page-kit] Generated:\r\n- ${swOut}\r\n- ${offlineHtmlOut}\r\n- ${offlineSvgOut}\r\n`);\r\n} else {\r\n    console.log(`[offline-page-kit] Unknown command: ${cmd}\r\nUse:\r\n  offline-page-kit init --outDir public\r\n  offline-page-kit build --outDir public\r\n`);\r\n}","import fs from \"node:fs\";\r\nimport path from \"node:path\";\r\n\r\nexport function ensureDir(p: string) {\r\n    fs.mkdirSync(p, { recursive: true });\r\n}\r\n\r\nexport function writeFileSafe(filePath: string, content: string) {\r\n    ensureDir(path.dirname(filePath));\r\n    fs.writeFileSync(filePath, content, \"utf8\");\r\n}\r\n\r\nexport function exists(filePath: string) {\r\n    try { fs.accessSync(filePath); return true; } catch { return false; }\r\n}\r\n\r\nexport function parseArgs(argv: string[]) {\r\n    const m = new Map<string, string>();\r\n    for (let i = 0; i < argv.length; i++) {\r\n        const a = argv[i];\r\n        if (!a.startsWith(\"--\")) continue;\r\n        const key = a.slice(2);\r\n        const value = argv[i + 1] && !argv[i + 1].startsWith(\"--\") ? argv[++i] : \"true\";\r\n        m.set(key, value);\r\n    }\r\n    return m;\r\n}\r\n\r\nexport function splitList(v: string | undefined) {\r\n    return (v || \"\")\r\n        .split(\",\")\r\n        .map(s => s.trim())\r\n        .filter(Boolean);\r\n}","export function offlineHtmlTemplate(title = \"You're Offline\") {\r\n    return `<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n  <meta charset=\"UTF-8\"/>\r\n  <meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"/>\r\n  <title>${title}</title>\r\n  <style>\r\n    body{margin:0;height:100vh;display:grid;place-items:center;font-family:system-ui,-apple-system,Segoe UI,Roboto;background:#0b0f19;color:#fff}\r\n    .box{max-width:560px;padding:28px 26px;border-radius:18px;border:1px solid rgba(255,255,255,.12);background:rgba(255,255,255,.04)}\r\n    h1{margin:0 0 10px;font-size:28px}\r\n    p{margin:0 0 18px;opacity:.85;line-height:1.5}\r\n    .row{display:flex;gap:10px;flex-wrap:wrap}\r\n    button,a{appearance:none;border:0;border-radius:12px;padding:10px 14px;cursor:pointer;text-decoration:none}\r\n    button{background:#fff;color:#111}\r\n    a{background:rgba(255,255,255,.1);color:#fff}\r\n  </style>\r\n</head>\r\n<body>\r\n  <div class=\"box\">\r\n    <h1>⚡ You’re Offline</h1>\r\n    <p>No internet connection detected. You can retry, or go back to the homepage (if cached).</p>\r\n    <div class=\"row\">\r\n      <button onclick=\"location.reload()\">Retry</button>\r\n      <a href=\"/\">Go Home</a>\r\n    </div>\r\n  </div>\r\n</body>\r\n</html>`;\r\n}","export function offlineSvgTemplate() {\r\n    return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"630\" viewBox=\"0 0 1200 630\">\r\n  <rect width=\"1200\" height=\"630\" fill=\"#0b0f19\"/>\r\n  <text x=\"80\" y=\"220\" fill=\"#ffffff\" font-size=\"64\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">You’re Offline</text>\r\n  <text x=\"80\" y=\"300\" fill=\"#cbd5e1\" font-size=\"28\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">Please check your connection and try again.</text>\r\n  <circle cx=\"1040\" cy=\"220\" r=\"90\" fill=\"rgba(255,255,255,0.08)\"/>\r\n  <path d=\"M980 220c40-40 120-40 160 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <path d=\"M1010 250c25-25 75-25 100 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <circle cx=\"1060\" cy=\"290\" r=\"10\" fill=\"#fff\" opacity=\"0.7\"/>\r\n</svg>`;\r\n}","import type { OfflineKitBuildOptions, Strategy } from \"../types\";\r\n\r\nconst DEFAULT_EXTS = [\r\n    \"js\", \"css\", \"map\", \"ico\", \"png\", \"jpg\", \"jpeg\", \"webp\", \"svg\", \"gif\",\r\n    \"woff2\", \"woff\", \"ttf\", \"eot\", \"json\", \"txt\", \"xml\", \"webmanifest\"\r\n];\r\n\r\nfunction jsString(v: unknown) {\r\n    return JSON.stringify(v);\r\n}\r\n\r\nexport function buildServiceWorkerJS(options: Required<OfflineKitBuildOptions>) {\r\n    const {\r\n        cacheName,\r\n        offlinePage,\r\n        offlineImage,\r\n        precache,\r\n        htmlStrategy,\r\n        assetStrategy,\r\n        imageStrategy,\r\n        assetExtensions,\r\n        apiPrefixes,\r\n    } = options;\r\n\r\n    return `/* offline-page-kit service worker */\r\nconst CACHE_NAME = ${jsString(cacheName)};\r\nconst OFFLINE_PAGE = ${jsString(offlinePage)};\r\nconst OFFLINE_IMAGE = ${jsString(offlineImage)};\r\nconst PRECACHE = ${jsString([offlinePage, offlineImage, ...precache].filter(Boolean))};\r\n\r\nconst HTML_STRATEGY = ${jsString(htmlStrategy)};\r\nconst ASSET_STRATEGY = ${jsString(assetStrategy)};\r\nconst IMAGE_STRATEGY = ${jsString(imageStrategy)};\r\n\r\nconst ASSET_EXTS = new Set(${jsString(assetExtensions.length ? assetExtensions : DEFAULT_EXTS)});\r\nconst API_PREFIXES = ${jsString(apiPrefixes)};\r\n\r\n// helpers\r\nconst isApi = (url) => API_PREFIXES.some(p => url.href.startsWith(p) || url.pathname.startsWith(p));\r\nconst extOf = (pathname) => {\r\n  const i = pathname.lastIndexOf(\".\");\r\n  return i === -1 ? \"\" : pathname.slice(i+1).toLowerCase();\r\n};\r\n\r\nasync function cacheGet(req) {\r\n  const cache = await caches.open(CACHE_NAME);\r\n  return cache.match(req);\r\n}\r\nasync function cachePut(req, res) {\r\n  const cache = await caches.open(CACHE_NAME);\r\n  await cache.put(req, res);\r\n}\r\nasync function cacheDeleteOld() {\r\n  const keys = await caches.keys();\r\n  await Promise.all(keys.map(k => (k === CACHE_NAME ? null : caches.delete(k))));\r\n}\r\n\r\n// strategies\r\nasync function networkFirst(req, fallbackUrl) {\r\n  try {\r\n    const res = await fetch(req);\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  } catch {\r\n    const cached = await cacheGet(req);\r\n    if (cached) return cached;\r\n    if (fallbackUrl) return cacheGet(fallbackUrl);\r\n    return new Response(\"Offline\", { status: 503 });\r\n  }\r\n}\r\n\r\nasync function cacheFirst(req, fallbackUrl) {\r\n  const cached = await cacheGet(req);\r\n  if (cached) return cached;\r\n  try {\r\n    const res = await fetch(req);\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  } catch {\r\n    if (fallbackUrl) return cacheGet(fallbackUrl);\r\n    return new Response(\"Offline\", { status: 503 });\r\n  }\r\n}\r\n\r\nasync function staleWhileRevalidate(req) {\r\n  const cached = await cacheGet(req);\r\n  const fetchPromise = fetch(req).then(res => {\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  }).catch(() => null);\r\n\r\n  return cached || (await fetchPromise) || new Response(\"Offline\", { status: 503 });\r\n}\r\n\r\nfunction pickStrategy(name) {\r\n  if (name === \"cacheFirst\") return cacheFirst;\r\n  if (name === \"staleWhileRevalidate\") return staleWhileRevalidate;\r\n  return networkFirst;\r\n}\r\n\r\nself.addEventListener(\"install\", (event) => {\r\n  event.waitUntil((async () => {\r\n    const cache = await caches.open(CACHE_NAME);\r\n\r\n    const urls = [OFFLINE_PAGE, OFFLINE_IMAGE];\r\n\r\n    // ✅ Do not let one 404 kill the whole SW install\r\n    await Promise.allSettled(\r\n      urls.map((u) => cache.add(u))\r\n    );\r\n\r\n    await self.skipWaiting();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"activate\", (event) => {\r\n  event.waitUntil((async () => {\r\n    await self.clients.claim();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"fetch\", (event) => {\r\n  const req = event.request;\r\n\r\n  // ✅ Offline fallback for page navigations\r\n  if (req.mode === \"navigate\") {\r\n    event.respondWith((async () => {\r\n      try {\r\n        return await fetch(req);\r\n      } catch {\r\n        const cache = await caches.open(CACHE_NAME);\r\n        return (await cache.match(OFFLINE_PAGE)) || new Response(\"Offline\", { status: 503 });\r\n      }\r\n    })());\r\n  }\r\n});\r\n`;\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,IAAAA,oBAAiB;;;ACDjB,qBAAe;AACf,uBAAiB;AAEV,SAAS,UAAU,GAAW;AACjC,iBAAAC,QAAG,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACvC;AAEO,SAAS,cAAc,UAAkB,SAAiB;AAC7D,YAAU,iBAAAC,QAAK,QAAQ,QAAQ,CAAC;AAChC,iBAAAD,QAAG,cAAc,UAAU,SAAS,MAAM;AAC9C;AAEO,SAAS,OAAO,UAAkB;AACrC,MAAI;AAAE,mBAAAA,QAAG,WAAW,QAAQ;AAAG,WAAO;AAAA,EAAM,QAAQ;AAAE,WAAO;AAAA,EAAO;AACxE;AAEO,SAAS,UAAU,MAAgB;AACtC,QAAM,IAAI,oBAAI,IAAoB;AAClC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AAClC,UAAM,IAAI,KAAK,CAAC;AAChB,QAAI,CAAC,EAAE,WAAW,IAAI,EAAG;AACzB,UAAM,MAAM,EAAE,MAAM,CAAC;AACrB,UAAM,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,WAAW,IAAI,IAAI,KAAK,EAAE,CAAC,IAAI;AACzE,MAAE,IAAI,KAAK,KAAK;AAAA,EACpB;AACA,SAAO;AACX;AAEO,SAAS,UAAU,GAAuB;AAC7C,UAAQ,KAAK,IACR,MAAM,GAAG,EACT,IAAI,OAAK,EAAE,KAAK,CAAC,EACjB,OAAO,OAAO;AACvB;;;ACjCO,SAAS,oBAAoB,QAAQ,kBAAkB;AAC1D,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,WAKA,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBhB;;;AC7BO,SAAS,qBAAqB;AACjC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASX;;;ACRA,IAAM,eAAe;AAAA,EACjB;AAAA,EAAM;AAAA,EAAO;AAAA,EAAO;AAAA,EAAO;AAAA,EAAO;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAQ;AAAA,EAAO;AAAA,EAChE;AAAA,EAAS;AAAA,EAAQ;AAAA,EAAO;AAAA,EAAO;AAAA,EAAQ;AAAA,EAAO;AAAA,EAAO;AACzD;AAEA,SAAS,SAAS,GAAY;AAC1B,SAAO,KAAK,UAAU,CAAC;AAC3B;AAEO,SAAS,qBAAqBE,UAA2C;AAC5E,QAAM;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACJ,IAAIA;AAEJ,SAAO;AAAA,qBACU,SAAS,SAAS,CAAC;AAAA,uBACjB,SAAS,WAAW,CAAC;AAAA,wBACpB,SAAS,YAAY,CAAC;AAAA,mBAC3B,SAAS,CAAC,aAAa,cAAc,GAAG,QAAQ,EAAE,OAAO,OAAO,CAAC,CAAC;AAAA;AAAA,wBAE7D,SAAS,YAAY,CAAC;AAAA,yBACrB,SAAS,aAAa,CAAC;AAAA,yBACvB,SAAS,aAAa,CAAC;AAAA;AAAA,6BAEnB,SAAS,gBAAgB,SAAS,kBAAkB,YAAY,CAAC;AAAA,uBACvE,SAAS,WAAW,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsG5C;;;AJjIA,SAAS,oBAAoB,GAAW;AACpC,MAAI,CAAC,EAAE,WAAW,GAAG,EAAG,QAAO,MAAM;AACrC,SAAO;AACX;AAEA,SAAS,aAAa,GAA6D;AAC/E,SAAO;AAAA,IACH,QAAQ,EAAE,UAAU;AAAA,IACpB,YAAY,EAAE,cAAc;AAAA,IAC5B,aAAa,oBAAoB,EAAE,eAAe,eAAe;AAAA,IACjE,cAAc,oBAAoB,EAAE,gBAAgB,cAAc;AAAA,IAClE,WAAW,EAAE,aAAa;AAAA,IAC1B,UAAU,EAAE,YAAY,CAAC;AAAA,IACzB,cAAc,EAAE,gBAAgB;AAAA,IAChC,eAAe,EAAE,iBAAiB;AAAA,IAClC,eAAe,EAAE,iBAAiB;AAAA,IAClC,iBAAiB,EAAE,mBAAmB,CAAC;AAAA,IACvC,aAAa,EAAE,eAAe,CAAC;AAAA,EACnC;AACJ;AAEA,IAAM,OAAO,UAAU,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC5C,IAAM,MAAM,QAAQ,KAAK,MAAM,CAAC,EAAE,KAAK,OAAK,CAAC,EAAE,WAAW,IAAI,CAAC,KAAK;AAEpE,IAAM,SAAS,kBAAAC,QAAK,QAAQ,QAAQ,IAAI,GAAG,KAAK,IAAI,QAAQ,KAAK,QAAQ;AAEzE,IAAM,UAAU,aAAa;AAAA,EACzB;AAAA,EACA,YAAY,KAAK,IAAI,YAAY,KAAK;AAAA,EACtC,aAAa,KAAK,IAAI,aAAa,KAAK;AAAA,EACxC,cAAc,KAAK,IAAI,cAAc,KAAK;AAAA,EAC1C,WAAW,KAAK,IAAI,WAAW,KAAK;AAAA,EACpC,UAAU,UAAU,KAAK,IAAI,UAAU,CAAC;AAAA,EACxC,cAAe,KAAK,IAAI,cAAc,KAAa;AAAA,EACnD,eAAgB,KAAK,IAAI,eAAe,KAAa;AAAA,EACrD,eAAgB,KAAK,IAAI,eAAe,KAAa;AAAA,EACrD,iBAAiB,UAAU,KAAK,IAAI,iBAAiB,CAAC;AAAA,EACtD,aAAa,UAAU,KAAK,IAAI,aAAa,CAAC;AAClD,CAA2B;AAE3B,IAAM,QAAQ,kBAAAA,QAAK,KAAK,QAAQ,QAAQ,UAAU;AAClD,IAAM,iBAAiB,kBAAAA,QAAK,KAAK,QAAQ,QAAQ,YAAY,QAAQ,OAAO,EAAE,CAAC;AAC/E,IAAM,gBAAgB,kBAAAA,QAAK,KAAK,QAAQ,QAAQ,aAAa,QAAQ,OAAO,EAAE,CAAC;AAE/E,IAAI,QAAQ,UAAU,QAAQ,SAAS;AAEnC,MAAI,QAAQ,WAAW,CAAC,OAAO,cAAc,GAAG;AAC5C,kBAAc,gBAAgB,oBAAoB,CAAC;AAAA,EACvD;AACA,MAAI,QAAQ,WAAW,CAAC,OAAO,aAAa,GAAG;AAC3C,kBAAc,eAAe,mBAAmB,CAAC;AAAA,EACrD;AAEA,QAAM,KAAK,qBAAqB,OAAO;AACvC,gBAAc,OAAO,EAAE;AAEvB,UAAQ,IAAI;AAAA,IACZ,KAAK;AAAA,IACL,cAAc;AAAA,IACd,aAAa;AAAA,CAChB;AACD,OAAO;AACH,UAAQ,IAAI,uCAAuC,GAAG;AAAA;AAAA;AAAA;AAAA,CAIzD;AACD;","names":["import_node_path","fs","path","options","path"]}
+{"version":3,"sources":["../src/cli.ts","../src/core/utils.ts","../src/core/offlineHtml.ts","../src/core/offlineSvg.ts","../src/core/swTemplate.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport path from \"node:path\";\r\nimport { parseArgs, splitList, writeFileSafe, exists } from \"./core/utils\";\r\nimport { offlineHtmlTemplate } from \"./core/offlineHtml\";\r\nimport { offlineSvgTemplate } from \"./core/offlineSvg\";\r\nimport { buildServiceWorkerJS } from \"./core/swTemplate\";\r\nimport type { OfflineKitBuildOptions } from \"./types\";\r\n\r\nfunction normalizePublicPath(p: string) {\r\n    if (!p.startsWith(\"/\")) return \"/\" + p;\r\n    return p;\r\n}\r\n\r\nfunction withDefaults(o: OfflineKitBuildOptions): Required<OfflineKitBuildOptions> {\r\n    return {\r\n        outDir: o.outDir ?? \"public\",\r\n        swFileName: o.swFileName ?? \"sw.js\",\r\n        offlinePage: normalizePublicPath(o.offlinePage ?? \"/offline.html\"),\r\n        offlineImage: normalizePublicPath(o.offlineImage ?? \"/offline.svg\"),\r\n        cacheName: o.cacheName ?? \"offline-page-kit\",\r\n        precache: o.precache ?? [],\r\n        htmlStrategy: o.htmlStrategy ?? \"networkFirst\",\r\n        assetStrategy: o.assetStrategy ?? \"staleWhileRevalidate\",\r\n        imageStrategy: o.imageStrategy ?? \"cacheFirst\",\r\n        assetExtensions: o.assetExtensions ?? [],\r\n        apiPrefixes: o.apiPrefixes ?? [],\r\n    };\r\n}\r\n\r\nconst args = parseArgs(process.argv.slice(2));\r\nconst cmd = process.argv.slice(2).find(a => !a.startsWith(\"--\")) || \"init\";\r\n\r\nconst outDir = path.resolve(process.cwd(), args.get(\"outDir\") || \"public\");\r\n\r\nconst options = withDefaults({\r\n    outDir,\r\n    swFileName: args.get(\"swFileName\") || \"sw.js\",\r\n    offlinePage: args.get(\"offlinePage\") || \"/offline.html\",\r\n    offlineImage: args.get(\"offlineImage\") || \"/offline.svg\",\r\n    cacheName: args.get(\"cacheName\") || \"offline-page-kit\",\r\n    precache: splitList(args.get(\"precache\")),\r\n    htmlStrategy: (args.get(\"htmlStrategy\") as any) || \"networkFirst\",\r\n    assetStrategy: (args.get(\"assetStrategy\") as any) || \"staleWhileRevalidate\",\r\n    imageStrategy: (args.get(\"imageStrategy\") as any) || \"cacheFirst\",\r\n    assetExtensions: splitList(args.get(\"assetExtensions\")),\r\n    apiPrefixes: splitList(args.get(\"apiPrefixes\")),\r\n} as OfflineKitBuildOptions);\r\n\r\nconst swOut = path.join(outDir, options.swFileName);\r\nconst offlineHtmlOut = path.join(outDir, options.offlinePage.replace(/^\\//, \"\"));\r\nconst offlineSvgOut = path.join(outDir, options.offlineImage.replace(/^\\//, \"\"));\r\n\r\nif (cmd === \"init\" || cmd === \"build\") {\r\n    // generate offline page if missing OR force (when build)\r\n    if (cmd === \"build\" || !exists(offlineHtmlOut)) {\r\n        writeFileSafe(offlineHtmlOut, offlineHtmlTemplate());\r\n    }\r\n    if (cmd === \"build\" || !exists(offlineSvgOut)) {\r\n        writeFileSafe(offlineSvgOut, offlineSvgTemplate());\r\n    }\r\n\r\n    const sw = buildServiceWorkerJS(options);\r\n    writeFileSafe(swOut, sw);\r\n\r\n    console.log(`[offline-page-kit] Generated:\r\n- ${swOut}\r\n- ${offlineHtmlOut}\r\n- ${offlineSvgOut}\r\n`);\r\n} else {\r\n    console.log(`[offline-page-kit] Unknown command: ${cmd}\r\nUse:\r\n  offline-page-kit init --outDir public\r\n  offline-page-kit build --outDir public\r\n`);\r\n}","import fs from \"node:fs\";\r\nimport path from \"node:path\";\r\n\r\nexport function ensureDir(p: string) {\r\n    fs.mkdirSync(p, { recursive: true });\r\n}\r\n\r\nexport function writeFileSafe(filePath: string, content: string) {\r\n    ensureDir(path.dirname(filePath));\r\n    fs.writeFileSync(filePath, content, \"utf8\");\r\n}\r\n\r\nexport function exists(filePath: string) {\r\n    try { fs.accessSync(filePath); return true; } catch { return false; }\r\n}\r\n\r\nexport function parseArgs(argv: string[]) {\r\n    const m = new Map<string, string>();\r\n    for (let i = 0; i < argv.length; i++) {\r\n        const a = argv[i];\r\n        if (!a.startsWith(\"--\")) continue;\r\n        const key = a.slice(2);\r\n        const value = argv[i + 1] && !argv[i + 1].startsWith(\"--\") ? argv[++i] : \"true\";\r\n        m.set(key, value);\r\n    }\r\n    return m;\r\n}\r\n\r\nexport function splitList(v: string | undefined) {\r\n    return (v || \"\")\r\n        .split(\",\")\r\n        .map(s => s.trim())\r\n        .filter(Boolean);\r\n}","export function offlineHtmlTemplate(title = \"You're Offline\") {\r\n    return `<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n  <meta charset=\"UTF-8\"/>\r\n  <meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"/>\r\n  <title>${title}</title>\r\n  <style>\r\n    body{margin:0;height:100vh;display:grid;place-items:center;font-family:system-ui,-apple-system,Segoe UI,Roboto;background:#0b0f19;color:#fff}\r\n    .box{max-width:560px;padding:28px 26px;border-radius:18px;border:1px solid rgba(255,255,255,.12);background:rgba(255,255,255,.04)}\r\n    h1{margin:0 0 10px;font-size:28px}\r\n    p{margin:0 0 18px;opacity:.85;line-height:1.5}\r\n    .row{display:flex;gap:10px;flex-wrap:wrap}\r\n    button,a{appearance:none;border:0;border-radius:12px;padding:10px 14px;cursor:pointer;text-decoration:none}\r\n    button{background:#fff;color:#111}\r\n    a{background:rgba(255,255,255,.1);color:#fff}\r\n  </style>\r\n</head>\r\n<body>\r\n  <div class=\"box\">\r\n    <h1>⚡ You’re Offline</h1>\r\n    <p>No internet connection detected. You can retry, or go back to the homepage (if cached).</p>\r\n    <div class=\"row\">\r\n      <button onclick=\"location.reload()\">Retry</button>\r\n      <a href=\"/\">Go Home</a>\r\n    </div>\r\n  </div>\r\n</body>\r\n</html>`;\r\n}","export function offlineSvgTemplate() {\r\n  return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"630\" viewBox=\"0 0 1200 630\">\r\n  <rect width=\"1200\" height=\"630\" fill=\"#0b0f19\"/>\r\n  <text x=\"80\" y=\"220\" fill=\"#ffffff\" font-size=\"64\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">You’re Offline</text>\r\n  <text x=\"80\" y=\"300\" fill=\"#cbd5e1\" font-size=\"28\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">Please check your connection and try again.</text>\r\n  <circle cx=\"1040\" cy=\"220\" r=\"90\" fill=\"rgba(255,255,255,0.08)\"/>\r\n  <path d=\"M980 220c40-40 120-40 160 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <path d=\"M1010 250c25-25 75-25 100 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <circle cx=\"1060\" cy=\"290\" r=\"10\" fill=\"#fff\" opacity=\"0.7\"/>\r\n</svg>`;\r\n}","import type { OfflineKitBuildOptions } from \"../types\";\r\n\r\nconst js = (v: unknown) => JSON.stringify(v);\r\n\r\nexport function buildServiceWorkerJS(options: Required<OfflineKitBuildOptions>) {\r\n  const { cacheName, offlinePage, offlineImage } = options;\r\n\r\n  return `/* offline-page-kit service worker (minimal) */\r\nconst CACHE_NAME = ${js(cacheName)};\r\nconst OFFLINE_PAGE = ${js(offlinePage)};\r\nconst OFFLINE_IMAGE = ${js(offlineImage)};\r\n\r\nself.addEventListener(\"install\", (event) => {\r\n  event.waitUntil((async () => {\r\n    const cache = await caches.open(CACHE_NAME);\r\n\r\n    // ✅ Do not let one 404 kill the install\r\n    await Promise.allSettled([\r\n      cache.add(OFFLINE_PAGE),\r\n      cache.add(OFFLINE_IMAGE),\r\n    ]);\r\n\r\n    await self.skipWaiting();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"activate\", (event) => {\r\n  event.waitUntil((async () => {\r\n    await self.clients.claim();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"fetch\", (event) => {\r\n  const req = event.request;\r\n\r\n  // ✅ Offline fallback only for page navigations\r\n  if (req.mode === \"navigate\") {\r\n    event.respondWith((async () => {\r\n      try {\r\n        return await fetch(req);\r\n      } catch {\r\n        const cache = await caches.open(CACHE_NAME);\r\n        return (await cache.match(OFFLINE_PAGE)) || new Response(\"Offline\", { status: 503 });\r\n      }\r\n    })());\r\n  }\r\n});\r\n`;\r\n}"],"mappings":"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","names":["import_node_path","fs","path","options","path"]}

package/dist/cli.js

@@ -82,127 +82,23 @@ function offlineSvgTemplate() {
 }
 
 // src/core/swTemplate.ts
-var DEFAULT_EXTS = [
-  "js",
-  "css",
-  "map",
-  "ico",
-  "png",
-  "jpg",
-  "jpeg",
-  "webp",
-  "svg",
-  "gif",
-  "woff2",
-  "woff",
-  "ttf",
-  "eot",
-  "json",
-  "txt",
-  "xml",
-  "webmanifest"
-];
-function jsString(v) {
-  return JSON.stringify(v);
-}
+var js = (v) => JSON.stringify(v);
 function buildServiceWorkerJS(options2) {
-  const {
-    cacheName,
-    offlinePage,
-    offlineImage,
-    precache,
-    htmlStrategy,
-    assetStrategy,
-    imageStrategy,
-    assetExtensions,
-    apiPrefixes
-  } = options2;
-  return `/* offline-page-kit service worker */
-const CACHE_NAME = ${jsString(cacheName)};
-const OFFLINE_PAGE = ${jsString(offlinePage)};
-const OFFLINE_IMAGE = ${jsString(offlineImage)};
-const PRECACHE = ${jsString([offlinePage, offlineImage, ...precache].filter(Boolean))};
-
-const HTML_STRATEGY = ${jsString(htmlStrategy)};
-const ASSET_STRATEGY = ${jsString(assetStrategy)};
-const IMAGE_STRATEGY = ${jsString(imageStrategy)};
-
-const ASSET_EXTS = new Set(${jsString(assetExtensions.length ? assetExtensions : DEFAULT_EXTS)});
-const API_PREFIXES = ${jsString(apiPrefixes)};
-
-// helpers
-const isApi = (url) => API_PREFIXES.some(p => url.href.startsWith(p) || url.pathname.startsWith(p));
-const extOf = (pathname) => {
-  const i = pathname.lastIndexOf(".");
-  return i === -1 ? "" : pathname.slice(i+1).toLowerCase();
-};
-
-async function cacheGet(req) {
-  const cache = await caches.open(CACHE_NAME);
-  return cache.match(req);
-}
-async function cachePut(req, res) {
-  const cache = await caches.open(CACHE_NAME);
-  await cache.put(req, res);
-}
-async function cacheDeleteOld() {
-  const keys = await caches.keys();
-  await Promise.all(keys.map(k => (k === CACHE_NAME ? null : caches.delete(k))));
-}
-
-// strategies
-async function networkFirst(req, fallbackUrl) {
-  try {
-    const res = await fetch(req);
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  } catch {
-    const cached = await cacheGet(req);
-    if (cached) return cached;
-    if (fallbackUrl) return cacheGet(fallbackUrl);
-    return new Response("Offline", { status: 503 });
-  }
-}
-
-async function cacheFirst(req, fallbackUrl) {
-  const cached = await cacheGet(req);
-  if (cached) return cached;
-  try {
-    const res = await fetch(req);
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  } catch {
-    if (fallbackUrl) return cacheGet(fallbackUrl);
-    return new Response("Offline", { status: 503 });
-  }
-}
-
-async function staleWhileRevalidate(req) {
-  const cached = await cacheGet(req);
-  const fetchPromise = fetch(req).then(res => {
-    if (res && res.ok) cachePut(req, res.clone());
-    return res;
-  }).catch(() => null);
-
-  return cached || (await fetchPromise) || new Response("Offline", { status: 503 });
-}
-
-function pickStrategy(name) {
-  if (name === "cacheFirst") return cacheFirst;
-  if (name === "staleWhileRevalidate") return staleWhileRevalidate;
-  return networkFirst;
-}
+  const { cacheName, offlinePage, offlineImage } = options2;
+  return `/* offline-page-kit service worker (minimal) */
+const CACHE_NAME = ${js(cacheName)};
+const OFFLINE_PAGE = ${js(offlinePage)};
+const OFFLINE_IMAGE = ${js(offlineImage)};
 
 self.addEventListener("install", (event) => {
   event.waitUntil((async () => {
     const cache = await caches.open(CACHE_NAME);
 
-    const urls = [OFFLINE_PAGE, OFFLINE_IMAGE];
-
-    // \u2705 Do not let one 404 kill the whole SW install
-    await Promise.allSettled(
-      urls.map((u) => cache.add(u))
-    );
+    // \u2705 Do not let one 404 kill the install
+    await Promise.allSettled([
+      cache.add(OFFLINE_PAGE),
+      cache.add(OFFLINE_IMAGE),
+    ]);
 
     await self.skipWaiting();
   })());
@@ -217,7 +113,7 @@ self.addEventListener("activate", (event) => {
 self.addEventListener("fetch", (event) => {
   const req = event.request;
 
-  // \u2705 Offline fallback for page navigations
+  // \u2705 Offline fallback only for page navigations
   if (req.mode === "navigate") {
     event.respondWith((async () => {
       try {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/core/utils.ts","../src/core/offlineHtml.ts","../src/core/offlineSvg.ts","../src/core/swTemplate.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport path from \"node:path\";\r\nimport { parseArgs, splitList, writeFileSafe, exists } from \"./core/utils\";\r\nimport { offlineHtmlTemplate } from \"./core/offlineHtml\";\r\nimport { offlineSvgTemplate } from \"./core/offlineSvg\";\r\nimport { buildServiceWorkerJS } from \"./core/swTemplate\";\r\nimport type { OfflineKitBuildOptions } from \"./types\";\r\n\r\nfunction normalizePublicPath(p: string) {\r\n    if (!p.startsWith(\"/\")) return \"/\" + p;\r\n    return p;\r\n}\r\n\r\nfunction withDefaults(o: OfflineKitBuildOptions): Required<OfflineKitBuildOptions> {\r\n    return {\r\n        outDir: o.outDir ?? \"public\",\r\n        swFileName: o.swFileName ?? \"sw.js\",\r\n        offlinePage: normalizePublicPath(o.offlinePage ?? \"/offline.html\"),\r\n        offlineImage: normalizePublicPath(o.offlineImage ?? \"/offline.svg\"),\r\n        cacheName: o.cacheName ?? \"offline-page-kit\",\r\n        precache: o.precache ?? [],\r\n        htmlStrategy: o.htmlStrategy ?? \"networkFirst\",\r\n        assetStrategy: o.assetStrategy ?? \"staleWhileRevalidate\",\r\n        imageStrategy: o.imageStrategy ?? \"cacheFirst\",\r\n        assetExtensions: o.assetExtensions ?? [],\r\n        apiPrefixes: o.apiPrefixes ?? [],\r\n    };\r\n}\r\n\r\nconst args = parseArgs(process.argv.slice(2));\r\nconst cmd = process.argv.slice(2).find(a => !a.startsWith(\"--\")) || \"init\";\r\n\r\nconst outDir = path.resolve(process.cwd(), args.get(\"outDir\") || \"public\");\r\n\r\nconst options = withDefaults({\r\n    outDir,\r\n    swFileName: args.get(\"swFileName\") || \"sw.js\",\r\n    offlinePage: args.get(\"offlinePage\") || \"/offline.html\",\r\n    offlineImage: args.get(\"offlineImage\") || \"/offline.svg\",\r\n    cacheName: args.get(\"cacheName\") || \"offline-page-kit\",\r\n    precache: splitList(args.get(\"precache\")),\r\n    htmlStrategy: (args.get(\"htmlStrategy\") as any) || \"networkFirst\",\r\n    assetStrategy: (args.get(\"assetStrategy\") as any) || \"staleWhileRevalidate\",\r\n    imageStrategy: (args.get(\"imageStrategy\") as any) || \"cacheFirst\",\r\n    assetExtensions: splitList(args.get(\"assetExtensions\")),\r\n    apiPrefixes: splitList(args.get(\"apiPrefixes\")),\r\n} as OfflineKitBuildOptions);\r\n\r\nconst swOut = path.join(outDir, options.swFileName);\r\nconst offlineHtmlOut = path.join(outDir, options.offlinePage.replace(/^\\//, \"\"));\r\nconst offlineSvgOut = path.join(outDir, options.offlineImage.replace(/^\\//, \"\"));\r\n\r\nif (cmd === \"init\" || cmd === \"build\") {\r\n    // generate offline page if missing OR force (when build)\r\n    if (cmd === \"build\" || !exists(offlineHtmlOut)) {\r\n        writeFileSafe(offlineHtmlOut, offlineHtmlTemplate());\r\n    }\r\n    if (cmd === \"build\" || !exists(offlineSvgOut)) {\r\n        writeFileSafe(offlineSvgOut, offlineSvgTemplate());\r\n    }\r\n\r\n    const sw = buildServiceWorkerJS(options);\r\n    writeFileSafe(swOut, sw);\r\n\r\n    console.log(`[offline-page-kit] Generated:\r\n- ${swOut}\r\n- ${offlineHtmlOut}\r\n- ${offlineSvgOut}\r\n`);\r\n} else {\r\n    console.log(`[offline-page-kit] Unknown command: ${cmd}\r\nUse:\r\n  offline-page-kit init --outDir public\r\n  offline-page-kit build --outDir public\r\n`);\r\n}","import fs from \"node:fs\";\r\nimport path from \"node:path\";\r\n\r\nexport function ensureDir(p: string) {\r\n    fs.mkdirSync(p, { recursive: true });\r\n}\r\n\r\nexport function writeFileSafe(filePath: string, content: string) {\r\n    ensureDir(path.dirname(filePath));\r\n    fs.writeFileSync(filePath, content, \"utf8\");\r\n}\r\n\r\nexport function exists(filePath: string) {\r\n    try { fs.accessSync(filePath); return true; } catch { return false; }\r\n}\r\n\r\nexport function parseArgs(argv: string[]) {\r\n    const m = new Map<string, string>();\r\n    for (let i = 0; i < argv.length; i++) {\r\n        const a = argv[i];\r\n        if (!a.startsWith(\"--\")) continue;\r\n        const key = a.slice(2);\r\n        const value = argv[i + 1] && !argv[i + 1].startsWith(\"--\") ? argv[++i] : \"true\";\r\n        m.set(key, value);\r\n    }\r\n    return m;\r\n}\r\n\r\nexport function splitList(v: string | undefined) {\r\n    return (v || \"\")\r\n        .split(\",\")\r\n        .map(s => s.trim())\r\n        .filter(Boolean);\r\n}","export function offlineHtmlTemplate(title = \"You're Offline\") {\r\n    return `<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n  <meta charset=\"UTF-8\"/>\r\n  <meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"/>\r\n  <title>${title}</title>\r\n  <style>\r\n    body{margin:0;height:100vh;display:grid;place-items:center;font-family:system-ui,-apple-system,Segoe UI,Roboto;background:#0b0f19;color:#fff}\r\n    .box{max-width:560px;padding:28px 26px;border-radius:18px;border:1px solid rgba(255,255,255,.12);background:rgba(255,255,255,.04)}\r\n    h1{margin:0 0 10px;font-size:28px}\r\n    p{margin:0 0 18px;opacity:.85;line-height:1.5}\r\n    .row{display:flex;gap:10px;flex-wrap:wrap}\r\n    button,a{appearance:none;border:0;border-radius:12px;padding:10px 14px;cursor:pointer;text-decoration:none}\r\n    button{background:#fff;color:#111}\r\n    a{background:rgba(255,255,255,.1);color:#fff}\r\n  </style>\r\n</head>\r\n<body>\r\n  <div class=\"box\">\r\n    <h1>⚡ You’re Offline</h1>\r\n    <p>No internet connection detected. You can retry, or go back to the homepage (if cached).</p>\r\n    <div class=\"row\">\r\n      <button onclick=\"location.reload()\">Retry</button>\r\n      <a href=\"/\">Go Home</a>\r\n    </div>\r\n  </div>\r\n</body>\r\n</html>`;\r\n}","export function offlineSvgTemplate() {\r\n    return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"630\" viewBox=\"0 0 1200 630\">\r\n  <rect width=\"1200\" height=\"630\" fill=\"#0b0f19\"/>\r\n  <text x=\"80\" y=\"220\" fill=\"#ffffff\" font-size=\"64\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">You’re Offline</text>\r\n  <text x=\"80\" y=\"300\" fill=\"#cbd5e1\" font-size=\"28\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">Please check your connection and try again.</text>\r\n  <circle cx=\"1040\" cy=\"220\" r=\"90\" fill=\"rgba(255,255,255,0.08)\"/>\r\n  <path d=\"M980 220c40-40 120-40 160 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <path d=\"M1010 250c25-25 75-25 100 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <circle cx=\"1060\" cy=\"290\" r=\"10\" fill=\"#fff\" opacity=\"0.7\"/>\r\n</svg>`;\r\n}","import type { OfflineKitBuildOptions, Strategy } from \"../types\";\r\n\r\nconst DEFAULT_EXTS = [\r\n    \"js\", \"css\", \"map\", \"ico\", \"png\", \"jpg\", \"jpeg\", \"webp\", \"svg\", \"gif\",\r\n    \"woff2\", \"woff\", \"ttf\", \"eot\", \"json\", \"txt\", \"xml\", \"webmanifest\"\r\n];\r\n\r\nfunction jsString(v: unknown) {\r\n    return JSON.stringify(v);\r\n}\r\n\r\nexport function buildServiceWorkerJS(options: Required<OfflineKitBuildOptions>) {\r\n    const {\r\n        cacheName,\r\n        offlinePage,\r\n        offlineImage,\r\n        precache,\r\n        htmlStrategy,\r\n        assetStrategy,\r\n        imageStrategy,\r\n        assetExtensions,\r\n        apiPrefixes,\r\n    } = options;\r\n\r\n    return `/* offline-page-kit service worker */\r\nconst CACHE_NAME = ${jsString(cacheName)};\r\nconst OFFLINE_PAGE = ${jsString(offlinePage)};\r\nconst OFFLINE_IMAGE = ${jsString(offlineImage)};\r\nconst PRECACHE = ${jsString([offlinePage, offlineImage, ...precache].filter(Boolean))};\r\n\r\nconst HTML_STRATEGY = ${jsString(htmlStrategy)};\r\nconst ASSET_STRATEGY = ${jsString(assetStrategy)};\r\nconst IMAGE_STRATEGY = ${jsString(imageStrategy)};\r\n\r\nconst ASSET_EXTS = new Set(${jsString(assetExtensions.length ? assetExtensions : DEFAULT_EXTS)});\r\nconst API_PREFIXES = ${jsString(apiPrefixes)};\r\n\r\n// helpers\r\nconst isApi = (url) => API_PREFIXES.some(p => url.href.startsWith(p) || url.pathname.startsWith(p));\r\nconst extOf = (pathname) => {\r\n  const i = pathname.lastIndexOf(\".\");\r\n  return i === -1 ? \"\" : pathname.slice(i+1).toLowerCase();\r\n};\r\n\r\nasync function cacheGet(req) {\r\n  const cache = await caches.open(CACHE_NAME);\r\n  return cache.match(req);\r\n}\r\nasync function cachePut(req, res) {\r\n  const cache = await caches.open(CACHE_NAME);\r\n  await cache.put(req, res);\r\n}\r\nasync function cacheDeleteOld() {\r\n  const keys = await caches.keys();\r\n  await Promise.all(keys.map(k => (k === CACHE_NAME ? null : caches.delete(k))));\r\n}\r\n\r\n// strategies\r\nasync function networkFirst(req, fallbackUrl) {\r\n  try {\r\n    const res = await fetch(req);\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  } catch {\r\n    const cached = await cacheGet(req);\r\n    if (cached) return cached;\r\n    if (fallbackUrl) return cacheGet(fallbackUrl);\r\n    return new Response(\"Offline\", { status: 503 });\r\n  }\r\n}\r\n\r\nasync function cacheFirst(req, fallbackUrl) {\r\n  const cached = await cacheGet(req);\r\n  if (cached) return cached;\r\n  try {\r\n    const res = await fetch(req);\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  } catch {\r\n    if (fallbackUrl) return cacheGet(fallbackUrl);\r\n    return new Response(\"Offline\", { status: 503 });\r\n  }\r\n}\r\n\r\nasync function staleWhileRevalidate(req) {\r\n  const cached = await cacheGet(req);\r\n  const fetchPromise = fetch(req).then(res => {\r\n    if (res && res.ok) cachePut(req, res.clone());\r\n    return res;\r\n  }).catch(() => null);\r\n\r\n  return cached || (await fetchPromise) || new Response(\"Offline\", { status: 503 });\r\n}\r\n\r\nfunction pickStrategy(name) {\r\n  if (name === \"cacheFirst\") return cacheFirst;\r\n  if (name === \"staleWhileRevalidate\") return staleWhileRevalidate;\r\n  return networkFirst;\r\n}\r\n\r\nself.addEventListener(\"install\", (event) => {\r\n  event.waitUntil((async () => {\r\n    const cache = await caches.open(CACHE_NAME);\r\n\r\n    const urls = [OFFLINE_PAGE, OFFLINE_IMAGE];\r\n\r\n    // ✅ Do not let one 404 kill the whole SW install\r\n    await Promise.allSettled(\r\n      urls.map((u) => cache.add(u))\r\n    );\r\n\r\n    await self.skipWaiting();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"activate\", (event) => {\r\n  event.waitUntil((async () => {\r\n    await self.clients.claim();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"fetch\", (event) => {\r\n  const req = event.request;\r\n\r\n  // ✅ Offline fallback for page navigations\r\n  if (req.mode === \"navigate\") {\r\n    event.respondWith((async () => {\r\n      try {\r\n        return await fetch(req);\r\n      } catch {\r\n        const cache = await caches.open(CACHE_NAME);\r\n        return (await cache.match(OFFLINE_PAGE)) || new Response(\"Offline\", { status: 503 });\r\n      }\r\n    })());\r\n  }\r\n});\r\n`;\r\n}"],"mappings":"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","names":["path","options","path"]}
+{"version":3,"sources":["../src/cli.ts","../src/core/utils.ts","../src/core/offlineHtml.ts","../src/core/offlineSvg.ts","../src/core/swTemplate.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport path from \"node:path\";\r\nimport { parseArgs, splitList, writeFileSafe, exists } from \"./core/utils\";\r\nimport { offlineHtmlTemplate } from \"./core/offlineHtml\";\r\nimport { offlineSvgTemplate } from \"./core/offlineSvg\";\r\nimport { buildServiceWorkerJS } from \"./core/swTemplate\";\r\nimport type { OfflineKitBuildOptions } from \"./types\";\r\n\r\nfunction normalizePublicPath(p: string) {\r\n    if (!p.startsWith(\"/\")) return \"/\" + p;\r\n    return p;\r\n}\r\n\r\nfunction withDefaults(o: OfflineKitBuildOptions): Required<OfflineKitBuildOptions> {\r\n    return {\r\n        outDir: o.outDir ?? \"public\",\r\n        swFileName: o.swFileName ?? \"sw.js\",\r\n        offlinePage: normalizePublicPath(o.offlinePage ?? \"/offline.html\"),\r\n        offlineImage: normalizePublicPath(o.offlineImage ?? \"/offline.svg\"),\r\n        cacheName: o.cacheName ?? \"offline-page-kit\",\r\n        precache: o.precache ?? [],\r\n        htmlStrategy: o.htmlStrategy ?? \"networkFirst\",\r\n        assetStrategy: o.assetStrategy ?? \"staleWhileRevalidate\",\r\n        imageStrategy: o.imageStrategy ?? \"cacheFirst\",\r\n        assetExtensions: o.assetExtensions ?? [],\r\n        apiPrefixes: o.apiPrefixes ?? [],\r\n    };\r\n}\r\n\r\nconst args = parseArgs(process.argv.slice(2));\r\nconst cmd = process.argv.slice(2).find(a => !a.startsWith(\"--\")) || \"init\";\r\n\r\nconst outDir = path.resolve(process.cwd(), args.get(\"outDir\") || \"public\");\r\n\r\nconst options = withDefaults({\r\n    outDir,\r\n    swFileName: args.get(\"swFileName\") || \"sw.js\",\r\n    offlinePage: args.get(\"offlinePage\") || \"/offline.html\",\r\n    offlineImage: args.get(\"offlineImage\") || \"/offline.svg\",\r\n    cacheName: args.get(\"cacheName\") || \"offline-page-kit\",\r\n    precache: splitList(args.get(\"precache\")),\r\n    htmlStrategy: (args.get(\"htmlStrategy\") as any) || \"networkFirst\",\r\n    assetStrategy: (args.get(\"assetStrategy\") as any) || \"staleWhileRevalidate\",\r\n    imageStrategy: (args.get(\"imageStrategy\") as any) || \"cacheFirst\",\r\n    assetExtensions: splitList(args.get(\"assetExtensions\")),\r\n    apiPrefixes: splitList(args.get(\"apiPrefixes\")),\r\n} as OfflineKitBuildOptions);\r\n\r\nconst swOut = path.join(outDir, options.swFileName);\r\nconst offlineHtmlOut = path.join(outDir, options.offlinePage.replace(/^\\//, \"\"));\r\nconst offlineSvgOut = path.join(outDir, options.offlineImage.replace(/^\\//, \"\"));\r\n\r\nif (cmd === \"init\" || cmd === \"build\") {\r\n    // generate offline page if missing OR force (when build)\r\n    if (cmd === \"build\" || !exists(offlineHtmlOut)) {\r\n        writeFileSafe(offlineHtmlOut, offlineHtmlTemplate());\r\n    }\r\n    if (cmd === \"build\" || !exists(offlineSvgOut)) {\r\n        writeFileSafe(offlineSvgOut, offlineSvgTemplate());\r\n    }\r\n\r\n    const sw = buildServiceWorkerJS(options);\r\n    writeFileSafe(swOut, sw);\r\n\r\n    console.log(`[offline-page-kit] Generated:\r\n- ${swOut}\r\n- ${offlineHtmlOut}\r\n- ${offlineSvgOut}\r\n`);\r\n} else {\r\n    console.log(`[offline-page-kit] Unknown command: ${cmd}\r\nUse:\r\n  offline-page-kit init --outDir public\r\n  offline-page-kit build --outDir public\r\n`);\r\n}","import fs from \"node:fs\";\r\nimport path from \"node:path\";\r\n\r\nexport function ensureDir(p: string) {\r\n    fs.mkdirSync(p, { recursive: true });\r\n}\r\n\r\nexport function writeFileSafe(filePath: string, content: string) {\r\n    ensureDir(path.dirname(filePath));\r\n    fs.writeFileSync(filePath, content, \"utf8\");\r\n}\r\n\r\nexport function exists(filePath: string) {\r\n    try { fs.accessSync(filePath); return true; } catch { return false; }\r\n}\r\n\r\nexport function parseArgs(argv: string[]) {\r\n    const m = new Map<string, string>();\r\n    for (let i = 0; i < argv.length; i++) {\r\n        const a = argv[i];\r\n        if (!a.startsWith(\"--\")) continue;\r\n        const key = a.slice(2);\r\n        const value = argv[i + 1] && !argv[i + 1].startsWith(\"--\") ? argv[++i] : \"true\";\r\n        m.set(key, value);\r\n    }\r\n    return m;\r\n}\r\n\r\nexport function splitList(v: string | undefined) {\r\n    return (v || \"\")\r\n        .split(\",\")\r\n        .map(s => s.trim())\r\n        .filter(Boolean);\r\n}","export function offlineHtmlTemplate(title = \"You're Offline\") {\r\n    return `<!doctype html>\r\n<html lang=\"en\">\r\n<head>\r\n  <meta charset=\"UTF-8\"/>\r\n  <meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"/>\r\n  <title>${title}</title>\r\n  <style>\r\n    body{margin:0;height:100vh;display:grid;place-items:center;font-family:system-ui,-apple-system,Segoe UI,Roboto;background:#0b0f19;color:#fff}\r\n    .box{max-width:560px;padding:28px 26px;border-radius:18px;border:1px solid rgba(255,255,255,.12);background:rgba(255,255,255,.04)}\r\n    h1{margin:0 0 10px;font-size:28px}\r\n    p{margin:0 0 18px;opacity:.85;line-height:1.5}\r\n    .row{display:flex;gap:10px;flex-wrap:wrap}\r\n    button,a{appearance:none;border:0;border-radius:12px;padding:10px 14px;cursor:pointer;text-decoration:none}\r\n    button{background:#fff;color:#111}\r\n    a{background:rgba(255,255,255,.1);color:#fff}\r\n  </style>\r\n</head>\r\n<body>\r\n  <div class=\"box\">\r\n    <h1>⚡ You’re Offline</h1>\r\n    <p>No internet connection detected. You can retry, or go back to the homepage (if cached).</p>\r\n    <div class=\"row\">\r\n      <button onclick=\"location.reload()\">Retry</button>\r\n      <a href=\"/\">Go Home</a>\r\n    </div>\r\n  </div>\r\n</body>\r\n</html>`;\r\n}","export function offlineSvgTemplate() {\r\n  return `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1200\" height=\"630\" viewBox=\"0 0 1200 630\">\r\n  <rect width=\"1200\" height=\"630\" fill=\"#0b0f19\"/>\r\n  <text x=\"80\" y=\"220\" fill=\"#ffffff\" font-size=\"64\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">You’re Offline</text>\r\n  <text x=\"80\" y=\"300\" fill=\"#cbd5e1\" font-size=\"28\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto\">Please check your connection and try again.</text>\r\n  <circle cx=\"1040\" cy=\"220\" r=\"90\" fill=\"rgba(255,255,255,0.08)\"/>\r\n  <path d=\"M980 220c40-40 120-40 160 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <path d=\"M1010 250c25-25 75-25 100 0\" stroke=\"#fff\" stroke-width=\"10\" fill=\"none\" opacity=\"0.6\"/>\r\n  <circle cx=\"1060\" cy=\"290\" r=\"10\" fill=\"#fff\" opacity=\"0.7\"/>\r\n</svg>`;\r\n}","import type { OfflineKitBuildOptions } from \"../types\";\r\n\r\nconst js = (v: unknown) => JSON.stringify(v);\r\n\r\nexport function buildServiceWorkerJS(options: Required<OfflineKitBuildOptions>) {\r\n  const { cacheName, offlinePage, offlineImage } = options;\r\n\r\n  return `/* offline-page-kit service worker (minimal) */\r\nconst CACHE_NAME = ${js(cacheName)};\r\nconst OFFLINE_PAGE = ${js(offlinePage)};\r\nconst OFFLINE_IMAGE = ${js(offlineImage)};\r\n\r\nself.addEventListener(\"install\", (event) => {\r\n  event.waitUntil((async () => {\r\n    const cache = await caches.open(CACHE_NAME);\r\n\r\n    // ✅ Do not let one 404 kill the install\r\n    await Promise.allSettled([\r\n      cache.add(OFFLINE_PAGE),\r\n      cache.add(OFFLINE_IMAGE),\r\n    ]);\r\n\r\n    await self.skipWaiting();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"activate\", (event) => {\r\n  event.waitUntil((async () => {\r\n    await self.clients.claim();\r\n  })());\r\n});\r\n\r\nself.addEventListener(\"fetch\", (event) => {\r\n  const req = event.request;\r\n\r\n  // ✅ Offline fallback only for page navigations\r\n  if (req.mode === \"navigate\") {\r\n    event.respondWith((async () => {\r\n      try {\r\n        return await fetch(req);\r\n      } catch {\r\n        const cache = await caches.open(CACHE_NAME);\r\n        return (await cache.match(OFFLINE_PAGE)) || new Response(\"Offline\", { status: 503 });\r\n      }\r\n    })());\r\n  }\r\n});\r\n`;\r\n}"],"mappings":"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","names":["path","options","path"]}

package/package.json

@@ -1,8 +1,25 @@
 {
   "name": "offline-page-kit",
-  "version": "0.1.1",
+  "version": "0.2.2",
   "description": "Framework-agnostic offline page + service worker generator (TypeScript)",
   "license": "MIT",
+  "author": {
+    "name": "MD Kuhel Ahmed",
+    "email": "kuhelahmed84@gmail.com",
+    "url": "https://devcrack.dev"
+  },
+  "homepage": "https://devcrack.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_GITHUB_USERNAME/offline-page-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/YOUR_GITHUB_USERNAME/offline-page-kit/issues"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://www.youtube.com/@dev-crack"
+  },
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -14,15 +31,34 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": [
-    "dist"
-  ],
   "bin": {
     "offline-page-kit": "./dist/cli.cjs"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "offline",
+    "offline-page",
+    "service-worker",
+    "pwa",
+    "service worker",
+    "generator",
+    "typescript",
+    "nextjs",
+    "vite",
+    "framework-agnostic"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
   },
   "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
   }
 }