@julien-lin/universal-pwa-core 1.3.0 → 1.3.1

package/dist/index.cjs

@@ -1290,6 +1290,7 @@ function injectMetaTags(htmlContent, options = {}) {
       const escapedSwPath = escapeJavaScriptString(swPath);
       const swScript = `
 <script>
+// Service Worker Registration
 if ('serviceWorker' in navigator) {
   window.addEventListener('load', () => {
     navigator.serviceWorker.register(${escapedSwPath})
@@ -1297,6 +1298,67 @@ if ('serviceWorker' in navigator) {
       .catch((error) => console.error('SW registration failed:', error));
   });
 }
+
+// PWA Install Handler
+let deferredPrompt = null;
+let isInstalled = false;
+
+// Check if app is already installed
+if (window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true) {
+  isInstalled = true;
+}
+
+// Listen for beforeinstallprompt event
+window.addEventListener('beforeinstallprompt', (e) => {
+  // Prevent the mini-infobar from appearing on mobile
+  e.preventDefault();
+  // Stash the event so it can be triggered later
+  deferredPrompt = e;
+  // Update UI to notify the user they can install the PWA
+  window.dispatchEvent(new CustomEvent('pwa-installable', { detail: { installable: true } }));
+  console.log('PWA installable: beforeinstallprompt event captured');
+});
+
+// Listen for app installed event
+window.addEventListener('appinstalled', () => {
+  isInstalled = true;
+  deferredPrompt = null;
+  window.dispatchEvent(new CustomEvent('pwa-installed', { detail: { installed: true } }));
+  console.log('PWA installed successfully');
+});
+
+// Expose global install function
+window.installPWA = function() {
+  if (!deferredPrompt) {
+    console.warn('PWA install prompt not available. App may already be installed or not installable.');
+    return Promise.reject(new Error('PWA install prompt not available'));
+  }
+  
+  // Show the install prompt
+  deferredPrompt.prompt();
+  
+  // Wait for the user to respond to the prompt
+  return deferredPrompt.userChoice.then((choiceResult) => {
+    if (choiceResult.outcome === 'accepted') {
+      console.log('User accepted the install prompt');
+    } else {
+      console.log('User dismissed the install prompt');
+    }
+    deferredPrompt = null;
+    window.dispatchEvent(new CustomEvent('pwa-install-choice', { detail: { outcome: choiceResult.outcome } }));
+    return choiceResult;
+  });
+};
+
+// Expose global check function
+window.isPWAInstalled = function() {
+  return isInstalled || window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true;
+};
+
+// Expose global check if installable
+window.isPWAInstallable = function() {
+  return deferredPrompt !== null;
+};
 </script>`;
       if (modifiedHtml.includes("</body>")) {
         modifiedHtml = modifiedHtml.replace("</body>", `${swScript}
@@ -1305,7 +1367,66 @@ if ('serviceWorker' in navigator) {
         modifiedHtml = `${modifiedHtml}${swScript}`;
       }
       result.injected.push("Service Worker registration script");
+      result.injected.push("PWA install handler script");
     } else {
+      if (!htmlContent.includes("beforeinstallprompt") && !htmlContent.includes("window.installPWA")) {
+        const installScript = `
+<script>
+// PWA Install Handler
+let deferredPrompt = null;
+let isInstalled = false;
+
+// Check if app is already installed
+if (window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true) {
+  isInstalled = true;
+}
+
+// Listen for beforeinstallprompt event
+window.addEventListener('beforeinstallprompt', (e) => {
+  e.preventDefault();
+  deferredPrompt = e;
+  window.dispatchEvent(new CustomEvent('pwa-installable', { detail: { installable: true } }));
+  console.log('PWA installable: beforeinstallprompt event captured');
+});
+
+window.addEventListener('appinstalled', () => {
+  isInstalled = true;
+  deferredPrompt = null;
+  window.dispatchEvent(new CustomEvent('pwa-installed', { detail: { installed: true } }));
+  console.log('PWA installed successfully');
+});
+
+window.installPWA = function() {
+  if (!deferredPrompt) {
+    console.warn('PWA install prompt not available.');
+    return Promise.reject(new Error('PWA install prompt not available'));
+  }
+  deferredPrompt.prompt();
+  return deferredPrompt.userChoice.then((choiceResult) => {
+    deferredPrompt = null;
+    window.dispatchEvent(new CustomEvent('pwa-install-choice', { detail: { outcome: choiceResult.outcome } }));
+    return choiceResult;
+  });
+};
+
+window.isPWAInstalled = function() {
+  return isInstalled || window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true;
+};
+
+window.isPWAInstallable = function() {
+  return deferredPrompt !== null;
+};
+</script>`;
+        if (modifiedHtml.includes("</body>")) {
+          modifiedHtml = modifiedHtml.replace("</body>", `${installScript}
+</body>`);
+        } else {
+          modifiedHtml = `${modifiedHtml}${installScript}`;
+        }
+        result.injected.push("PWA install handler script");
+      } else {
+        result.skipped.push("PWA install handler (already exists)");
+      }
       result.skipped.push("Service Worker registration (already exists)");
     }
   }

package/dist/index.js

@@ -1224,6 +1224,7 @@ function injectMetaTags(htmlContent, options = {}) {
       const escapedSwPath = escapeJavaScriptString(swPath);
       const swScript = `
 <script>
+// Service Worker Registration
 if ('serviceWorker' in navigator) {
   window.addEventListener('load', () => {
     navigator.serviceWorker.register(${escapedSwPath})
@@ -1231,6 +1232,67 @@ if ('serviceWorker' in navigator) {
       .catch((error) => console.error('SW registration failed:', error));
   });
 }
+
+// PWA Install Handler
+let deferredPrompt = null;
+let isInstalled = false;
+
+// Check if app is already installed
+if (window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true) {
+  isInstalled = true;
+}
+
+// Listen for beforeinstallprompt event
+window.addEventListener('beforeinstallprompt', (e) => {
+  // Prevent the mini-infobar from appearing on mobile
+  e.preventDefault();
+  // Stash the event so it can be triggered later
+  deferredPrompt = e;
+  // Update UI to notify the user they can install the PWA
+  window.dispatchEvent(new CustomEvent('pwa-installable', { detail: { installable: true } }));
+  console.log('PWA installable: beforeinstallprompt event captured');
+});
+
+// Listen for app installed event
+window.addEventListener('appinstalled', () => {
+  isInstalled = true;
+  deferredPrompt = null;
+  window.dispatchEvent(new CustomEvent('pwa-installed', { detail: { installed: true } }));
+  console.log('PWA installed successfully');
+});
+
+// Expose global install function
+window.installPWA = function() {
+  if (!deferredPrompt) {
+    console.warn('PWA install prompt not available. App may already be installed or not installable.');
+    return Promise.reject(new Error('PWA install prompt not available'));
+  }
+  
+  // Show the install prompt
+  deferredPrompt.prompt();
+  
+  // Wait for the user to respond to the prompt
+  return deferredPrompt.userChoice.then((choiceResult) => {
+    if (choiceResult.outcome === 'accepted') {
+      console.log('User accepted the install prompt');
+    } else {
+      console.log('User dismissed the install prompt');
+    }
+    deferredPrompt = null;
+    window.dispatchEvent(new CustomEvent('pwa-install-choice', { detail: { outcome: choiceResult.outcome } }));
+    return choiceResult;
+  });
+};
+
+// Expose global check function
+window.isPWAInstalled = function() {
+  return isInstalled || window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true;
+};
+
+// Expose global check if installable
+window.isPWAInstallable = function() {
+  return deferredPrompt !== null;
+};
 </script>`;
       if (modifiedHtml.includes("</body>")) {
         modifiedHtml = modifiedHtml.replace("</body>", `${swScript}
@@ -1239,7 +1301,66 @@ if ('serviceWorker' in navigator) {
         modifiedHtml = `${modifiedHtml}${swScript}`;
       }
       result.injected.push("Service Worker registration script");
+      result.injected.push("PWA install handler script");
     } else {
+      if (!htmlContent.includes("beforeinstallprompt") && !htmlContent.includes("window.installPWA")) {
+        const installScript = `
+<script>
+// PWA Install Handler
+let deferredPrompt = null;
+let isInstalled = false;
+
+// Check if app is already installed
+if (window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true) {
+  isInstalled = true;
+}
+
+// Listen for beforeinstallprompt event
+window.addEventListener('beforeinstallprompt', (e) => {
+  e.preventDefault();
+  deferredPrompt = e;
+  window.dispatchEvent(new CustomEvent('pwa-installable', { detail: { installable: true } }));
+  console.log('PWA installable: beforeinstallprompt event captured');
+});
+
+window.addEventListener('appinstalled', () => {
+  isInstalled = true;
+  deferredPrompt = null;
+  window.dispatchEvent(new CustomEvent('pwa-installed', { detail: { installed: true } }));
+  console.log('PWA installed successfully');
+});
+
+window.installPWA = function() {
+  if (!deferredPrompt) {
+    console.warn('PWA install prompt not available.');
+    return Promise.reject(new Error('PWA install prompt not available'));
+  }
+  deferredPrompt.prompt();
+  return deferredPrompt.userChoice.then((choiceResult) => {
+    deferredPrompt = null;
+    window.dispatchEvent(new CustomEvent('pwa-install-choice', { detail: { outcome: choiceResult.outcome } }));
+    return choiceResult;
+  });
+};
+
+window.isPWAInstalled = function() {
+  return isInstalled || window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone === true;
+};
+
+window.isPWAInstallable = function() {
+  return deferredPrompt !== null;
+};
+</script>`;
+        if (modifiedHtml.includes("</body>")) {
+          modifiedHtml = modifiedHtml.replace("</body>", `${installScript}
+</body>`);
+        } else {
+          modifiedHtml = `${modifiedHtml}${installScript}`;
+        }
+        result.injected.push("PWA install handler script");
+      } else {
+        result.skipped.push("PWA install handler (already exists)");
+      }
       result.skipped.push("Service Worker registration (already exists)");
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@julien-lin/universal-pwa-core",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Core engine for scanning, generation, and injection for UniversalPWA",
   "keywords": [
     "pwa",
@@ -61,7 +61,7 @@
     "workbox-routing": "^7.4.0",
     "workbox-strategies": "^7.4.0",
     "zod": "^4.2.1",
-    "@julien-lin/universal-pwa-templates": "^1.3.0"
+    "@julien-lin/universal-pwa-templates": "^1.3.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^2.1.4",