react-pwa-hazhtech 1.0.0

package/README.md

@@ -0,0 +1,410 @@
+
+# react-pwa-hazhtech
+
+A React library for Progressive Web App (PWA) functionality with install prompts, status tracking, and standalone mode detection.
+
+## Features
+
+- 🚀 **PWA Install Prompts**: Easy-to-use install prompt functionality
+- 📱 **Status Tracking**: Track PWA installation and standalone mode status
+- 🎯 **TypeScript Support**: Full TypeScript support with type definitions
+- ⚡ **Lightweight**: Minimal bundle size with tree-shaking support
+- 🔧 **Easy Integration**: Simple React context-based API
+
+## Installation
+
+```bash
+npm install react-pwa-hazhtech
+```
+
+## Quick Start
+
+### 1. Wrap your app with PWAProvider
+
+```tsx
+import React from 'react';
+import { PWAProvider } from 'react-pwa-hazhtech';
+import App from './App';
+
+function Root() {
+  return (
+    <PWAProvider>
+      <App />
+    </PWAProvider>
+  );
+}
+
+export default Root;
+```
+
+### 2. Use the PWA hook in your components
+
+```tsx
+import React from 'react';
+import { usePWA } from 'react-pwa-hazhtech';
+
+function InstallButton() {
+  const { isInstallable, isInstalled, isStandalone, promptInstall } = usePWA();
+
+  const handleInstall = async () => {
+    try {
+      const result = await promptInstall();
+      if (result?.outcome === 'accepted') {
+        console.log('PWA installed successfully');
+      }
+    } catch (error) {
+      console.error('Installation failed:', error);
+    }
+  };
+
+  if (isInstalled || isStandalone) {
+    return <div>App is already installed</div>;
+  }
+
+  if (!isInstallable) {
+    return <div>App is not installable</div>;
+  }
+
+  return (
+    <button onClick={handleInstall}>
+      Install App
+    </button>
+  );
+}
+
+export default InstallButton;
+```
+
+## API Reference
+
+### PWAProvider
+
+The `PWAProvider` component provides PWA context to your application.
+
+```tsx
+<PWAProvider>
+  {/* Your app components */}
+</PWAProvider>
+```
+
+### usePWA Hook
+
+The `usePWA` hook provides access to PWA functionality and state.
+
+```tsx
+const {
+  isInstallable,
+  isInstalled,
+  isStandalone,
+  promptInstall,
+  installPromptEvent
+} = usePWA();
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `isInstallable` | `boolean` | Whether the app can be installed |
+| `isInstalled` | `boolean` | Whether the app has been installed |
+| `isStandalone` | `boolean` | Whether the app is running in standalone mode |
+| `promptInstall` | `() => Promise<{outcome: 'accepted' \| 'dismissed'} \| null>` | Function to trigger the install prompt |
+| `installPromptEvent` | `BeforeInstallPromptEvent \| null` | Raw browser install prompt event |
+
+#### Methods
+
+##### promptInstall()
+
+Triggers the PWA installation prompt.
+
+```tsx
+const result = await promptInstall();
+if (result?.outcome === 'accepted') {
+  // User accepted the installation
+} else if (result?.outcome === 'dismissed') {
+  // User dismissed the installation
+} else {
+  // Install prompt not available
+}
+```
+
+**Returns:** `Promise<{outcome: 'accepted' | 'dismissed'} | null>`
+
+### Standalone Functions
+
+These utility functions can be used without the PWA context:
+
+#### triggerPWAInstall()
+
+Triggers PWA installation without using the hook context.
+
+```tsx
+import { triggerPWAInstall } from 'react-pwa-hazhtech';
+
+const handleInstall = async () => {
+  const result = await triggerPWAInstall();
+  if (result?.outcome === 'accepted') {
+    console.log('Installation successful');
+  }
+};
+```
+
+**Returns:** `Promise<{outcome: 'accepted' | 'dismissed'} | null>`
+
+#### isPWAInstallAvailable()
+
+Checks if PWA installation is available.
+
+```tsx
+import { isPWAInstallAvailable } from 'react-pwa-hazhtech';
+
+if (isPWAInstallAvailable()) {
+  // Show install button
+}
+```
+
+**Returns:** `boolean`
+
+#### isPWAMode()
+
+Checks if the app is running as a PWA (standalone mode).
+
+```tsx
+import { isPWAMode } from 'react-pwa-hazhtech';
+
+if (isPWAMode()) {
+  // App is running as PWA
+}
+```
+
+**Returns:** `boolean`
+
+## TypeScript Support
+
+This library includes full TypeScript support. The `BeforeInstallPromptEvent` type is automatically available when using the library.
+
+```tsx
+import { PWAContextType } from 'react-pwa-hazhtech';
+
+// PWAContextType includes all the hook properties and methods
+```
+
+## Advanced Usage
+
+### Using the Hook in Components
+
+```tsx
+import { usePWA } from 'react-pwa-hazhtech';
+
+function PWAStatus() {
+  const { isInstalled, isInstallable, isStandalone } = usePWA();
+
+  return (
+    <div>
+      <p>Installable: {isInstallable ? 'Yes' : 'No'}</p>
+      <p>Installed: {isInstalled ? 'Yes' : 'No'}</p>
+      <p>Standalone: {isStandalone ? 'Yes' : 'No'}</p>
+    </div>
+  );
+}
+```
+
+### Using Standalone Functions
+
+For cases where you need to trigger installation outside of the React context:
+
+```tsx
+import { triggerPWAInstall, isPWAInstallAvailable } from 'react-pwa-hazhtech';
+
+// In any JavaScript function
+const installApp = async () => {
+  if (isPWAInstallAvailable()) {
+    const result = await triggerPWAInstall();
+    if (result?.outcome === 'accepted') {
+      console.log('App installed successfully!');
+    }
+  }
+};
+
+// Can be called from anywhere
+document.getElementById('install-btn')?.addEventListener('click', installApp);
+```
+
+### Custom Install Flow
+
+```tsx
+import { usePWA } from 'react-pwa-hazhtech';
+
+function CustomInstallFlow() {
+  const { isInstallable, promptInstall, installPromptEvent } = usePWA();
+  const [showPrompt, setShowPrompt] = useState(false);
+
+  useEffect(() => {
+    if (isInstallable && !localStorage.getItem('installPromptShown')) {
+      setShowPrompt(true);
+    }
+  }, [isInstallable]);
+
+  const handleInstall = async () => {
+    try {
+      const result = await promptInstall();
+      if (result?.outcome === 'accepted') {
+        console.log('Installation successful');
+      }
+      setShowPrompt(false);
+      localStorage.setItem('installPromptShown', 'true');
+    } catch (error) {
+      console.error('Installation error:', error);
+    }
+  };
+
+  const handleDismiss = () => {
+    setShowPrompt(false);
+    localStorage.setItem('installPromptShown', 'true');
+  };
+
+  if (!showPrompt) return null;
+
+  return (
+    <div className="install-prompt">
+      <h3>Install Our App</h3>
+      <p>Install our app for the best experience!</p>
+      <button onClick={handleInstall}>Install</button>
+      <button onClick={handleDismiss}>Maybe Later</button>
+    </div>
+  );
+}
+```
+
+## PWA Setup Requirements
+
+To use this library effectively, your app needs to meet PWA requirements:
+
+### 1. Service Worker
+
+Create a `public/sw.js` file:
+
+```js
+const CACHE_NAME = 'my-app-v1';
+
+self.addEventListener('install', (event) => {
+  console.log('[Service Worker] Installed');
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  console.log('[Service Worker] Activated');
+  event.waitUntil(clients.claim());
+});
+
+self.addEventListener('fetch', (event) => {
+  event.respondWith(
+    caches.match(event.request)
+      .then(response => {
+        return response || fetch(event.request);
+      })
+  );
+});
+```
+
+### 2. Register Service Worker
+
+In your main app file:
+
+```tsx
+// Register service worker
+if ('serviceWorker' in navigator) {
+  window.addEventListener('load', () => {
+    navigator.serviceWorker.register('/sw.js')
+      .then((registration) => {
+        console.log('SW registered: ', registration);
+      })
+      .catch((registrationError) => {
+        console.log('SW registration failed: ', registrationError);
+      });
+  });
+}
+```
+
+### 3. Web App Manifest
+
+Create a `public/manifest.json` file:
+
+```json
+{
+  "name": "My PWA App",
+  "short_name": "MyApp",
+  "description": "My Progressive Web App",
+  "start_url": "/",
+  "display": "standalone",
+  "theme_color": "#000000",
+  "background_color": "#ffffff",
+  "icons": [
+    {
+      "src": "icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}
+```
+
+Add to your HTML head:
+
+```html
+<link rel="manifest" href="/manifest.json">
+<meta name="theme-color" content="#000000">
+```
+
+## Browser Support
+
+This library supports all modern browsers that implement the PWA standards:
+
+- Chrome 68+
+- Edge 79+
+- Safari 14.1+ (iOS 14.5+)
+- Firefox 85+ (Android only)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © [HazhTech](https://github.com/hazhtech/react-pwa-hazhtech)
+
+## Support
+
+If you have any questions or issues, please [open an issue](https://github.com/hazhtech/react-pwa-hazhtech/issues) on GitHub.-worker.js`
+To enable basic service worker behavior in the consuming app, add the following `service-worker.js`:
+
+```js
+self.addEventListener('install', (event) => {
+  console.log('[Service Worker] Installed');
+});
+
+self.addEventListener('activate', (event) => {
+  console.log('[Service Worker] Activated');
+});
+
+self.addEventListener('fetch', (event) => {
+  event.respondWith(fetch(event.request));
+});
+```
+
+Register the service worker in your app’s `index.tsx`:
+
+```ts
+if ('serviceWorker' in navigator) {
+  window.addEventListener('load', () => {
+    navigator.serviceWorker.register('/service-worker.js')
+      .then(registration => console.log('SW registered:', registration))
+      .catch(err => console.error('SW registration failed:', err));
+  });
+}
+```

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+import React from 'react';
+
+interface PWAContextProps {
+    isInstalled: boolean;
+    isInstallable: boolean;
+    promptInstall: () => Promise<{
+        outcome: 'accepted' | 'dismissed';
+    } | null>;
+    installPromptEvent: BeforeInstallPromptEvent | null;
+    isStandalone: boolean;
+}
+declare const PWAContext: React.Context<PWAContextProps>;
+declare global {
+    interface WindowEventMap {
+        beforeinstallprompt: BeforeInstallPromptEvent;
+        appinstalled: Event;
+    }
+    interface BeforeInstallPromptEvent extends Event {
+        prompt: () => Promise<void>;
+        userChoice: Promise<{
+            outcome: 'accepted' | 'dismissed';
+        }>;
+    }
+}
+interface PWAProviderProps {
+    children: React.ReactNode;
+    onInstallPromptAvailable?: (event: BeforeInstallPromptEvent) => void;
+    onAppInstalled?: () => void;
+}
+declare const PWAProvider: React.FC<PWAProviderProps>;
+declare const triggerPWAInstall: () => Promise<{
+    outcome: "accepted" | "dismissed";
+} | null>;
+declare const isPWAInstallAvailable: () => boolean;
+declare const isPWAMode: () => boolean;
+
+declare const usePWA: () => PWAContextProps;
+
+export { PWAContext, type PWAContextProps, PWAProvider, isPWAInstallAvailable, isPWAMode, triggerPWAInstall, usePWA };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+
+interface PWAContextProps {
+    isInstalled: boolean;
+    isInstallable: boolean;
+    promptInstall: () => Promise<{
+        outcome: 'accepted' | 'dismissed';
+    } | null>;
+    installPromptEvent: BeforeInstallPromptEvent | null;
+    isStandalone: boolean;
+}
+declare const PWAContext: React.Context<PWAContextProps>;
+declare global {
+    interface WindowEventMap {
+        beforeinstallprompt: BeforeInstallPromptEvent;
+        appinstalled: Event;
+    }
+    interface BeforeInstallPromptEvent extends Event {
+        prompt: () => Promise<void>;
+        userChoice: Promise<{
+            outcome: 'accepted' | 'dismissed';
+        }>;
+    }
+}
+interface PWAProviderProps {
+    children: React.ReactNode;
+    onInstallPromptAvailable?: (event: BeforeInstallPromptEvent) => void;
+    onAppInstalled?: () => void;
+}
+declare const PWAProvider: React.FC<PWAProviderProps>;
+declare const triggerPWAInstall: () => Promise<{
+    outcome: "accepted" | "dismissed";
+} | null>;
+declare const isPWAInstallAvailable: () => boolean;
+declare const isPWAMode: () => boolean;
+
+declare const usePWA: () => PWAContextProps;
+
+export { PWAContext, type PWAContextProps, PWAProvider, isPWAInstallAvailable, isPWAMode, triggerPWAInstall, usePWA };

package/dist/index.js

@@ -0,0 +1,3 @@
+'use strict';var react=require('react'),jsxRuntime=require('react/jsx-runtime');var i=react.createContext({isInstalled:false,isInstallable:false,promptInstall:async()=>null,installPromptEvent:null,isStandalone:false}),E=({children:d,onInstallPromptAvailable:a,onAppInstalled:l})=>{let[n,r]=react.useState(null),[f,p]=react.useState(false),[P,c]=react.useState(false),[w,v]=react.useState(false);react.useEffect(()=>{let e=()=>{let m=window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://");v(m),p(m);};e();let t=window.matchMedia("(display-mode: standalone)"),o=()=>e();return t.addEventListener?t.addEventListener("change",o):t.addListener(o),()=>{t.removeEventListener?t.removeEventListener("change",o):t.removeListener(o);}},[]),react.useEffect(()=>{let e=o=>{o.preventDefault(),r(o),c(true),a?.(o);},t=()=>{p(true),c(false),r(null),l?.();};return window.addEventListener("beforeinstallprompt",e),window.addEventListener("appinstalled",t),()=>{window.removeEventListener("beforeinstallprompt",e),window.removeEventListener("appinstalled",t);}},[a,l]);let I=react.useCallback(async()=>{if(!n)return console.warn("Install prompt is not available. Make sure the app meets PWA criteria."),null;try{await n.prompt();let e=await n.userChoice;return e.outcome==="accepted"&&(p(!0),c(!1)),r(null),e}catch(e){throw console.error("Error during install prompt:",e),e}},[n]);return jsxRuntime.jsx(i.Provider,{value:{isInstalled:f,isInstallable:P,promptInstall:I,installPromptEvent:n,isStandalone:w},children:d})},W=async()=>typeof window>"u"?(console.warn("triggerPWAInstall: Not in browser environment"),null):window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://")?(console.warn("triggerPWAInstall: App is already installed"),null):new Promise(a=>{let l=async n=>{n.preventDefault();try{await n.prompt();let r=await n.userChoice;a(r);}catch(r){console.error("Error during install prompt:",r),a(null);}};window.deferredPrompt?l(window.deferredPrompt):(window.addEventListener("beforeinstallprompt",l,{once:true}),setTimeout(()=>{window.removeEventListener("beforeinstallprompt",l),console.warn("triggerPWAInstall: Install prompt not available within timeout"),a(null);},5e3));}),b=()=>typeof window>"u"?false:!(window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://"))&&(window.deferredPrompt!==void 0||"serviceWorker"in navigator),y=()=>typeof window>"u"?false:window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://");var C=()=>react.useContext(i);
+exports.PWAContext=i;exports.PWAProvider=E;exports.isPWAInstallAvailable=b;exports.isPWAMode=y;exports.triggerPWAInstall=W;exports.usePWA=C;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PWAProvider.tsx","../src/usePWA.ts"],"names":["PWAContext","createContext","PWAProvider","children","onInstallPromptAvailable","onAppInstalled","deferredPrompt","setDeferredPrompt","useState","isInstalled","setIsInstalled","isInstallable","setIsInstallable","isStandalone","setIsStandalone","useEffect","checkStandalone","standalone","mediaQuery","handleChange","handleBeforeInstall","e","handleInstalled","promptInstall","useCallback","result","error","jsx","triggerPWAInstall","resolve","isPWAInstallAvailable","isPWAMode","usePWA","useContext"],"mappings":"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","file":"index.js","sourcesContent":["import React, { createContext, useEffect, useState, useCallback } from 'react';\n\nexport interface PWAContextProps {\n  isInstalled: boolean;\n  isInstallable: boolean;\n  promptInstall: () => Promise<{ outcome: 'accepted' | 'dismissed' } | null>;\n  installPromptEvent: BeforeInstallPromptEvent | null;\n  isStandalone: boolean;\n}\n\nexport const PWAContext = createContext<PWAContextProps>({\n  isInstalled: false,\n  isInstallable: false,\n  promptInstall: async () => null,\n  installPromptEvent: null,\n  isStandalone: false,\n});\n\ndeclare global {\n  interface WindowEventMap {\n    beforeinstallprompt: BeforeInstallPromptEvent;\n    appinstalled: Event;\n  }\n  \n  interface BeforeInstallPromptEvent extends Event {\n    prompt: () => Promise<void>;\n    userChoice: Promise<{ outcome: 'accepted' | 'dismissed' }>;\n  }\n}\n\nexport interface PWAProviderProps {\n  children: React.ReactNode;\n  onInstallPromptAvailable?: (event: BeforeInstallPromptEvent) => void;\n  onAppInstalled?: () => void;\n}\n\nexport const PWAProvider: React.FC<PWAProviderProps> = ({ \n  children, \n  onInstallPromptAvailable,\n  onAppInstalled \n}) => {\n  const [deferredPrompt, setDeferredPrompt] = useState<BeforeInstallPromptEvent | null>(null);\n  const [isInstalled, setIsInstalled] = useState<boolean>(false);\n  const [isInstallable, setIsInstallable] = useState<boolean>(false);\n  const [isStandalone, setIsStandalone] = useState<boolean>(false);\n\n  // Check if app is running in standalone mode\n  useEffect(() => {\n    const checkStandalone = () => {\n      const standalone = window.matchMedia('(display-mode: standalone)').matches ||\n        (window.navigator as any).standalone ||\n        document.referrer.includes('android-app://');\n      setIsStandalone(standalone);\n      setIsInstalled(standalone);\n    };\n\n    checkStandalone();\n    \n    // Listen for changes in display mode\n    const mediaQuery = window.matchMedia('(display-mode: standalone)');\n    const handleChange = () => checkStandalone();\n    \n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n    } else {\n      // Fallback for older browsers\n      mediaQuery.addListener(handleChange);\n    }\n\n    return () => {\n      if (mediaQuery.removeEventListener) {\n        mediaQuery.removeEventListener('change', handleChange);\n      } else {\n        mediaQuery.removeListener(handleChange);\n      }\n    };\n  }, []);\n\n  useEffect(() => {\n    const handleBeforeInstall = (e: BeforeInstallPromptEvent) => {\n      e.preventDefault();\n      setDeferredPrompt(e);\n      setIsInstallable(true);\n      onInstallPromptAvailable?.(e);\n    };\n\n    const handleInstalled = () => {\n      setIsInstalled(true);\n      setIsInstallable(false);\n      setDeferredPrompt(null);\n      onAppInstalled?.();\n    };\n\n    window.addEventListener('beforeinstallprompt', handleBeforeInstall);\n    window.addEventListener('appinstalled', handleInstalled);\n\n    return () => {\n      window.removeEventListener('beforeinstallprompt', handleBeforeInstall);\n      window.removeEventListener('appinstalled', handleInstalled);\n    };\n  }, [onInstallPromptAvailable, onAppInstalled]);\n\n  const promptInstall = useCallback(async (): Promise<{ outcome: 'accepted' | 'dismissed' } | null> => {\n    if (!deferredPrompt) {\n      console.warn('Install prompt is not available. Make sure the app meets PWA criteria.');\n      return null;\n    }\n\n    try {\n      await deferredPrompt.prompt();\n      const result = await deferredPrompt.userChoice;\n      \n      if (result.outcome === 'accepted') {\n        setIsInstalled(true);\n        setIsInstallable(false);\n      }\n      \n      setDeferredPrompt(null);\n      return result;\n    } catch (error) {\n      console.error('Error during install prompt:', error);\n      throw error;\n    }\n  }, [deferredPrompt]);\n\n  return (\n    <PWAContext.Provider value={{ \n      isInstalled, \n      isInstallable,\n      promptInstall, \n      installPromptEvent: deferredPrompt,\n      isStandalone\n    }}>\n      {children}\n    </PWAContext.Provider>\n  );\n};\n\n// Utility function to trigger PWA install without using the hook\nexport const triggerPWAInstall = async (): Promise<{ outcome: 'accepted' | 'dismissed' } | null> => {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    console.warn('triggerPWAInstall: Not in browser environment');\n    return null;\n  }\n\n  // Check if the app is already installed\n  const isStandalone = window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n  \n  if (isStandalone) {\n    console.warn('triggerPWAInstall: App is already installed');\n    return null;\n  }\n\n  return new Promise((resolve) => {\n    const handleBeforeInstall = async (e: BeforeInstallPromptEvent) => {\n      e.preventDefault();\n      \n      try {\n        await e.prompt();\n        const result = await e.userChoice;\n        resolve(result);\n      } catch (error) {\n        console.error('Error during install prompt:', error);\n        resolve(null);\n      }\n    };\n\n    // Check if there's already a deferred prompt available\n    if ((window as any).deferredPrompt) {\n      handleBeforeInstall((window as any).deferredPrompt);\n    } else {\n      // Listen for the beforeinstallprompt event\n      window.addEventListener('beforeinstallprompt', handleBeforeInstall, { once: true });\n      \n      // Timeout after 5 seconds if no install prompt is available\n      setTimeout(() => {\n        window.removeEventListener('beforeinstallprompt', handleBeforeInstall);\n        console.warn('triggerPWAInstall: Install prompt not available within timeout');\n        resolve(null);\n      }, 5000);\n    }\n  });\n};\n\n// Utility function to check if PWA install is available\nexport const isPWAInstallAvailable = (): boolean => {\n  if (typeof window === 'undefined') return false;\n  \n  const isStandalone = window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n  \n  return !isStandalone && (\n    (window as any).deferredPrompt !== undefined ||\n    'serviceWorker' in navigator\n  );\n};\n\n// Utility function to check if app is running as PWA\nexport const isPWAMode = (): boolean => {\n  if (typeof window === 'undefined') return false;\n  \n  return window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n};","import { useContext } from 'react';\nimport { PWAContext } from './PWAProvider';\n\nexport const usePWA = () => useContext(PWAContext);"]}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import {createContext,useContext,useState,useEffect,useCallback}from'react';import {jsx}from'react/jsx-runtime';var i=createContext({isInstalled:false,isInstallable:false,promptInstall:async()=>null,installPromptEvent:null,isStandalone:false}),E=({children:d,onInstallPromptAvailable:a,onAppInstalled:l})=>{let[n,r]=useState(null),[f,p]=useState(false),[P,c]=useState(false),[w,v]=useState(false);useEffect(()=>{let e=()=>{let m=window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://");v(m),p(m);};e();let t=window.matchMedia("(display-mode: standalone)"),o=()=>e();return t.addEventListener?t.addEventListener("change",o):t.addListener(o),()=>{t.removeEventListener?t.removeEventListener("change",o):t.removeListener(o);}},[]),useEffect(()=>{let e=o=>{o.preventDefault(),r(o),c(true),a?.(o);},t=()=>{p(true),c(false),r(null),l?.();};return window.addEventListener("beforeinstallprompt",e),window.addEventListener("appinstalled",t),()=>{window.removeEventListener("beforeinstallprompt",e),window.removeEventListener("appinstalled",t);}},[a,l]);let I=useCallback(async()=>{if(!n)return console.warn("Install prompt is not available. Make sure the app meets PWA criteria."),null;try{await n.prompt();let e=await n.userChoice;return e.outcome==="accepted"&&(p(!0),c(!1)),r(null),e}catch(e){throw console.error("Error during install prompt:",e),e}},[n]);return jsx(i.Provider,{value:{isInstalled:f,isInstallable:P,promptInstall:I,installPromptEvent:n,isStandalone:w},children:d})},W=async()=>typeof window>"u"?(console.warn("triggerPWAInstall: Not in browser environment"),null):window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://")?(console.warn("triggerPWAInstall: App is already installed"),null):new Promise(a=>{let l=async n=>{n.preventDefault();try{await n.prompt();let r=await n.userChoice;a(r);}catch(r){console.error("Error during install prompt:",r),a(null);}};window.deferredPrompt?l(window.deferredPrompt):(window.addEventListener("beforeinstallprompt",l,{once:true}),setTimeout(()=>{window.removeEventListener("beforeinstallprompt",l),console.warn("triggerPWAInstall: Install prompt not available within timeout"),a(null);},5e3));}),b=()=>typeof window>"u"?false:!(window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://"))&&(window.deferredPrompt!==void 0||"serviceWorker"in navigator),y=()=>typeof window>"u"?false:window.matchMedia("(display-mode: standalone)").matches||window.navigator.standalone||document.referrer.includes("android-app://");var C=()=>useContext(i);
+export{i as PWAContext,E as PWAProvider,b as isPWAInstallAvailable,y as isPWAMode,W as triggerPWAInstall,C as usePWA};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PWAProvider.tsx","../src/usePWA.ts"],"names":["PWAContext","createContext","PWAProvider","children","onInstallPromptAvailable","onAppInstalled","deferredPrompt","setDeferredPrompt","useState","isInstalled","setIsInstalled","isInstallable","setIsInstallable","isStandalone","setIsStandalone","useEffect","checkStandalone","standalone","mediaQuery","handleChange","handleBeforeInstall","e","handleInstalled","promptInstall","useCallback","result","error","jsx","triggerPWAInstall","resolve","isPWAInstallAvailable","isPWAMode","usePWA","useContext"],"mappings":"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","file":"index.mjs","sourcesContent":["import React, { createContext, useEffect, useState, useCallback } from 'react';\n\nexport interface PWAContextProps {\n  isInstalled: boolean;\n  isInstallable: boolean;\n  promptInstall: () => Promise<{ outcome: 'accepted' | 'dismissed' } | null>;\n  installPromptEvent: BeforeInstallPromptEvent | null;\n  isStandalone: boolean;\n}\n\nexport const PWAContext = createContext<PWAContextProps>({\n  isInstalled: false,\n  isInstallable: false,\n  promptInstall: async () => null,\n  installPromptEvent: null,\n  isStandalone: false,\n});\n\ndeclare global {\n  interface WindowEventMap {\n    beforeinstallprompt: BeforeInstallPromptEvent;\n    appinstalled: Event;\n  }\n  \n  interface BeforeInstallPromptEvent extends Event {\n    prompt: () => Promise<void>;\n    userChoice: Promise<{ outcome: 'accepted' | 'dismissed' }>;\n  }\n}\n\nexport interface PWAProviderProps {\n  children: React.ReactNode;\n  onInstallPromptAvailable?: (event: BeforeInstallPromptEvent) => void;\n  onAppInstalled?: () => void;\n}\n\nexport const PWAProvider: React.FC<PWAProviderProps> = ({ \n  children, \n  onInstallPromptAvailable,\n  onAppInstalled \n}) => {\n  const [deferredPrompt, setDeferredPrompt] = useState<BeforeInstallPromptEvent | null>(null);\n  const [isInstalled, setIsInstalled] = useState<boolean>(false);\n  const [isInstallable, setIsInstallable] = useState<boolean>(false);\n  const [isStandalone, setIsStandalone] = useState<boolean>(false);\n\n  // Check if app is running in standalone mode\n  useEffect(() => {\n    const checkStandalone = () => {\n      const standalone = window.matchMedia('(display-mode: standalone)').matches ||\n        (window.navigator as any).standalone ||\n        document.referrer.includes('android-app://');\n      setIsStandalone(standalone);\n      setIsInstalled(standalone);\n    };\n\n    checkStandalone();\n    \n    // Listen for changes in display mode\n    const mediaQuery = window.matchMedia('(display-mode: standalone)');\n    const handleChange = () => checkStandalone();\n    \n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n    } else {\n      // Fallback for older browsers\n      mediaQuery.addListener(handleChange);\n    }\n\n    return () => {\n      if (mediaQuery.removeEventListener) {\n        mediaQuery.removeEventListener('change', handleChange);\n      } else {\n        mediaQuery.removeListener(handleChange);\n      }\n    };\n  }, []);\n\n  useEffect(() => {\n    const handleBeforeInstall = (e: BeforeInstallPromptEvent) => {\n      e.preventDefault();\n      setDeferredPrompt(e);\n      setIsInstallable(true);\n      onInstallPromptAvailable?.(e);\n    };\n\n    const handleInstalled = () => {\n      setIsInstalled(true);\n      setIsInstallable(false);\n      setDeferredPrompt(null);\n      onAppInstalled?.();\n    };\n\n    window.addEventListener('beforeinstallprompt', handleBeforeInstall);\n    window.addEventListener('appinstalled', handleInstalled);\n\n    return () => {\n      window.removeEventListener('beforeinstallprompt', handleBeforeInstall);\n      window.removeEventListener('appinstalled', handleInstalled);\n    };\n  }, [onInstallPromptAvailable, onAppInstalled]);\n\n  const promptInstall = useCallback(async (): Promise<{ outcome: 'accepted' | 'dismissed' } | null> => {\n    if (!deferredPrompt) {\n      console.warn('Install prompt is not available. Make sure the app meets PWA criteria.');\n      return null;\n    }\n\n    try {\n      await deferredPrompt.prompt();\n      const result = await deferredPrompt.userChoice;\n      \n      if (result.outcome === 'accepted') {\n        setIsInstalled(true);\n        setIsInstallable(false);\n      }\n      \n      setDeferredPrompt(null);\n      return result;\n    } catch (error) {\n      console.error('Error during install prompt:', error);\n      throw error;\n    }\n  }, [deferredPrompt]);\n\n  return (\n    <PWAContext.Provider value={{ \n      isInstalled, \n      isInstallable,\n      promptInstall, \n      installPromptEvent: deferredPrompt,\n      isStandalone\n    }}>\n      {children}\n    </PWAContext.Provider>\n  );\n};\n\n// Utility function to trigger PWA install without using the hook\nexport const triggerPWAInstall = async (): Promise<{ outcome: 'accepted' | 'dismissed' } | null> => {\n  // Check if we're in a browser environment\n  if (typeof window === 'undefined') {\n    console.warn('triggerPWAInstall: Not in browser environment');\n    return null;\n  }\n\n  // Check if the app is already installed\n  const isStandalone = window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n  \n  if (isStandalone) {\n    console.warn('triggerPWAInstall: App is already installed');\n    return null;\n  }\n\n  return new Promise((resolve) => {\n    const handleBeforeInstall = async (e: BeforeInstallPromptEvent) => {\n      e.preventDefault();\n      \n      try {\n        await e.prompt();\n        const result = await e.userChoice;\n        resolve(result);\n      } catch (error) {\n        console.error('Error during install prompt:', error);\n        resolve(null);\n      }\n    };\n\n    // Check if there's already a deferred prompt available\n    if ((window as any).deferredPrompt) {\n      handleBeforeInstall((window as any).deferredPrompt);\n    } else {\n      // Listen for the beforeinstallprompt event\n      window.addEventListener('beforeinstallprompt', handleBeforeInstall, { once: true });\n      \n      // Timeout after 5 seconds if no install prompt is available\n      setTimeout(() => {\n        window.removeEventListener('beforeinstallprompt', handleBeforeInstall);\n        console.warn('triggerPWAInstall: Install prompt not available within timeout');\n        resolve(null);\n      }, 5000);\n    }\n  });\n};\n\n// Utility function to check if PWA install is available\nexport const isPWAInstallAvailable = (): boolean => {\n  if (typeof window === 'undefined') return false;\n  \n  const isStandalone = window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n  \n  return !isStandalone && (\n    (window as any).deferredPrompt !== undefined ||\n    'serviceWorker' in navigator\n  );\n};\n\n// Utility function to check if app is running as PWA\nexport const isPWAMode = (): boolean => {\n  if (typeof window === 'undefined') return false;\n  \n  return window.matchMedia('(display-mode: standalone)').matches ||\n    (window.navigator as any).standalone ||\n    document.referrer.includes('android-app://');\n};","import { useContext } from 'react';\nimport { PWAContext } from './PWAProvider';\n\nexport const usePWA = () => useContext(PWAContext);"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "react-pwa-hazhtech",
+  "version": "1.0.0",
+  "description": "A React library for Progressive Web App (PWA) functionality with install prompts and status tracking",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "react",
+    "pwa",
+    "progressive-web-app",
+    "install",
+    "status",
+    "hazhtech",
+    "beforeinstallprompt",
+    "service-worker"
+  ],
+  "author": "HazhTech",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hazhtech/react-pwa-hazhtech.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hazhtech/react-pwa-hazhtech/issues"
+  },
+  "homepage": "https://github.com/hazhtech/react-pwa-hazhtech#readme",
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}