native-update 1.1.3 → 1.1.4

package/docs/NATIVE_UPDATES_GUIDE.md

@@ -191,7 +191,7 @@ export class AndroidFlexibleUpdate {
 
       // Listen for download progress
       NativeUpdate.addListener(
-        'onAppUpdateDownloadProgress',
+        'appUpdateProgress',
         (progress) => {
           console.log(
             `Download progress: ${progress.bytesDownloaded} / ${progress.totalBytesToDownload}`

package/docs/QUICK_START.md

@@ -229,7 +229,7 @@ export class AndroidUpdateProgress {
 
     // Track progress
     NativeUpdate.addListener(
-      'onAppUpdateDownloadProgress',
+      'appUpdateProgress',
       (progress) => {
         this.downloadProgress = Math.round(
           (progress.bytesDownloaded / progress.totalBytesToDownload) * 100

package/docs/api/app-update-api.md

@@ -73,7 +73,15 @@ await NativeUpdate.openAppStore({
 
 ## Events
 
-Note: App update events are not directly exposed. Instead, use the `updateStateChanged` and `downloadProgress` events from the Live Update API when performing app updates. The native update process on Android and iOS is handled by the platform's native update mechanisms.
+App update events are available for monitoring the native app update process. See the [Events API Reference](./events-api.md#app-update-events) for complete documentation of the following events:
+
+- `appUpdateStateChanged` - Fired when update state changes
+- `appUpdateProgress` - Monitor download progress for flexible updates
+- `appUpdateAvailable` - Notified when a new version is available
+- `appUpdateReady` - Update downloaded and ready to install
+- `appUpdateFailed` - Update process failed
+- `appUpdateNotificationClicked` - User clicked update notification
+- `appUpdateInstallClicked` - User clicked install in notification
 
 ## Platform Differences
 

package/docs/api/events-api.md

@@ -64,6 +64,129 @@ NativeUpdate.addListener('downloadProgress', (progress) => {
 }
 ```
 
+## App Update Events
+
+### appUpdateStateChanged
+
+Fired when the native app update state changes.
+
+```typescript
+NativeUpdate.addListener('appUpdateStateChanged', (state) => {
+  console.log('App update state:', state.status);
+});
+```
+
+**Event Data:**
+```typescript
+{
+  status: InstallStatus; // See InstallStatus enum
+  installErrorCode?: number; // Error code if status is FAILED
+}
+```
+
+### appUpdateProgress
+
+Fired during app update download progress.
+
+```typescript
+NativeUpdate.addListener('appUpdateProgress', (progress) => {
+  console.log(`Download progress: ${progress.percent}%`);
+});
+```
+
+**Event Data:**
+```typescript
+{
+  percent: number; // Download percentage (0-100)
+  bytesDownloaded: number; // Bytes downloaded so far
+  totalBytes: number; // Total download size
+}
+```
+
+### appUpdateAvailable
+
+Fired when a new app update is detected.
+
+```typescript
+NativeUpdate.addListener('appUpdateAvailable', (info) => {
+  console.log(`Update available: ${info.availableVersion}`);
+});
+```
+
+**Event Data:**
+```typescript
+{
+  currentVersion: string;
+  availableVersion: string;
+  updatePriority: number; // 0-5, where 5 is critical
+  updateSize?: number; // Update size in bytes
+  releaseNotes?: string[]; // Release notes array
+  storeUrl?: string; // App store URL
+}
+```
+
+### appUpdateReady
+
+Fired when the app update is downloaded and ready to install.
+
+```typescript
+NativeUpdate.addListener('appUpdateReady', (event) => {
+  console.log('Update ready to install');
+  // Prompt user to restart/install
+});
+```
+
+**Event Data:**
+```typescript
+{
+  message: string; // "Update downloaded and ready to install"
+}
+```
+
+### appUpdateFailed
+
+Fired when an app update fails.
+
+```typescript
+NativeUpdate.addListener('appUpdateFailed', (error) => {
+  console.error('Update failed:', error.error);
+});
+```
+
+**Event Data:**
+```typescript
+{
+  error: string; // Error message
+  code: string; // Error code
+}
+```
+
+### appUpdateNotificationClicked
+
+Fired when the user clicks on an update notification.
+
+```typescript
+NativeUpdate.addListener('appUpdateNotificationClicked', () => {
+  console.log('User clicked update notification');
+  // Navigate to update screen
+});
+```
+
+**Event Data:** Empty object `{}`
+
+### appUpdateInstallClicked
+
+Fired when the user clicks the install button in an update notification.
+
+```typescript
+NativeUpdate.addListener('appUpdateInstallClicked', () => {
+  console.log('User clicked install in notification');
+  // Start update installation
+});
+```
+
+**Event Data:** Empty object `{}`
+
 ## Background Update Events
 
 ### backgroundUpdateProgress

package/docs/features/app-updates.md

@@ -95,7 +95,7 @@ class AppUpdateManager {
   private setupUpdateListeners() {
     // Android flexible update state changes
     NativeUpdate.addListener(
-      'flexibleUpdateStateChanged',
+      'appUpdateStateChanged',
       (state) => {
         this.handleFlexibleUpdateState(state);
       }
@@ -103,7 +103,7 @@ class AppUpdateManager {
 
     // Download progress for flexible updates
     NativeUpdate.addListener(
-      'flexibleUpdateProgress',
+      'appUpdateProgress',
       (progress) => {
         this.downloadProgress = progress.percent;
         this.updateProgressUI(progress);
@@ -276,7 +276,7 @@ const androidUpdate = {
 
     // Monitor progress
     const listener = await NativeUpdate.addListener(
-      'flexibleUpdateProgress',
+      'appUpdateProgress',
       (progress) => {
         console.log(
           `Downloaded: ${progress.bytesDownloaded}/${progress.totalBytes}`
@@ -551,7 +551,7 @@ class UpdateProgressUI {
     this.createProgressUI();
 
     NativeUpdate.addListener(
-      'flexibleUpdateProgress',
+      'appUpdateProgress',
       (progress) => {
         this.updateProgress(progress);
       }

package/docs/getting-started/quick-start.md

@@ -159,7 +159,7 @@ async function startFlexibleUpdate() {
 
   // Listen for download completion
   const listener = await NativeUpdate.addListener(
-    'flexibleUpdateStateChanged',
+    'appUpdateStateChanged',
     (state) => {
       if (state.status === 'DOWNLOADED') {
         // Prompt user to restart

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "native-update",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Foundation package for building a comprehensive update system for Capacitor apps. Provides architecture and interfaces but requires backend implementation.",
   "type": "module",
   "main": "dist/plugin.cjs.js",
@@ -44,7 +44,17 @@
     "plugin",
     "native",
     "app-updates",
-    "native-updates"
+    "native-updates",
+    "ota",
+    "live-updates",
+    "hot-reload",
+    "app-store",
+    "google-play",
+    "in-app-updates",
+    "app-reviews",
+    "ios",
+    "android",
+    "hybrid"
   ],
   "scripts": {
     "build": "npm run clean && npm run tsc && rollup -c rollup.config.js",
@@ -78,14 +88,14 @@
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "@types/node": "^24.3.0",
-    "@typescript-eslint/eslint-plugin": "^8.39.1",
-    "@typescript-eslint/parser": "^8.39.1",
+    "@typescript-eslint/eslint-plugin": "^8.40.0",
+    "@typescript-eslint/parser": "^8.40.0",
     "@vitest/ui": "^3.2.4",
     "eslint": "^9.33.0",
     "happy-dom": "^18.0.1",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
-    "rollup": "^4.46.2",
+    "rollup": "^4.46.3",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },