native-update 1.0.4 → 1.0.6

package/Readme.md

@@ -191,14 +191,14 @@ export class AppComponent implements OnInit {
 
   async checkAllUpdates() {
     // 1. Check live updates first (fastest)
-    const liveUpdate = await NativeUpdate.checkForUpdate();
-    if (liveUpdate.available) {
+    const liveUpdate = await NativeUpdate.sync();
+    if (liveUpdate.status === 'UPDATE_AVAILABLE' || liveUpdate.status === 'UPDATE_INSTALLED') {
       await this.promptLiveUpdate(liveUpdate);
       return; // Don't check native if live update is available
     }
 
     // 2. Check native updates
-    const nativeUpdate = await NativeUpdate.checkAppUpdate();
+    const nativeUpdate = await NativeUpdate.getAppUpdateInfo();
     if (nativeUpdate.updateAvailable) {
       await this.promptNativeUpdate(nativeUpdate);
     }

package/android/build.gradle

@@ -1,17 +1,7 @@
-ext {
-    compileSdkVersion = 34
-    targetSdkVersion = 34
-    minSdkVersion = 21
-    androidxAppCompatVersion = '1.6.1'
-    androidxCoreVersion = '1.13.1'
-    androidxWorkVersion = '2.9.0'
-    playServicesVersion = '18.2.0'
-    playReviewVersion = '2.0.1'
-    okhttpVersion = '4.12.0'
-    kotlinVersion = '2.0.21'
-}
-
 buildscript {
+    ext {
+        kotlinVersion = '1.9.22'
+    }
     repositories {
         google()
         mavenCentral()
@@ -22,6 +12,18 @@ buildscript {
     }
 }
 
+ext {
+    compileSdkVersion = 34
+    targetSdkVersion = 34
+    minSdkVersion = 21
+    androidxAppCompatVersion = '1.6.1'
+    androidxCoreVersion = '1.13.1'
+    androidxWorkVersion = '2.9.0'
+    playAppUpdateVersion = '2.1.0'
+    playReviewVersion = '2.0.1'
+    okhttpVersion = '4.12.0'
+}
+
 apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 
@@ -67,14 +69,17 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     
+    // Kotlin
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlinVersion"
+    
     // AndroidX
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
     implementation "androidx.core:core-ktx:$androidxCoreVersion"
     implementation "androidx.work:work-runtime-ktx:$androidxWorkVersion"
     
     // Google Play Services
-    implementation "com.google.android.play:app-update:$playServicesVersion"
-    implementation "com.google.android.play:app-update-ktx:$playServicesVersion"
+    implementation "com.google.android.play:app-update:$playAppUpdateVersion"
+    implementation "com.google.android.play:app-update-ktx:$playAppUpdateVersion"
     implementation "com.google.android.play:review:$playReviewVersion"
     implementation "com.google.android.play:review-ktx:$playReviewVersion"
     

package/docs/APP_REVIEW_GUIDE.md

@@ -765,4 +765,4 @@ Key takeaways for implementing app reviews:
 
 - Review the [Quick Start Guide](./QUICK_START.md)
 - Check the [API Reference](./api/app-review-api.md)
-- See [Example Implementation](../example/src/services/review.service.ts)
+- See example implementation in the `/example` directory

package/docs/BUNDLE_SIGNING.md

@@ -240,12 +240,18 @@ Response: {
 ### Plugin Methods
 
 ```typescript
-// Manual verification (advanced use)
-const isValid = await NativeUpdate.verifySignature({
+// Signature verification is handled automatically during sync/download
+// Use validateUpdate for manual verification
+const result = await NativeUpdate.LiveUpdate.validateUpdate({
   bundlePath: '/path/to/bundle.zip',
-  signature: 'base64-signature',
-  publicKey: 'base64-public-key', // Optional, uses config if not provided
+  checksum: 'expected-sha256-checksum',
+  signature: 'base64-signature' // Optional
 });
+
+console.log('Validation result:', result.isValid);
+if (!result.isValid) {
+  console.log('Validation details:', result.details);
+}
 ```
 
 ## Compliance

package/docs/LIVE_UPDATES_GUIDE.md

@@ -168,41 +168,41 @@ export class UpdateService {
 
   async checkForUpdates(silent = false) {
     try {
-      const { available, version, mandatory, notes } =
-        await NativeUpdate.sync();
+      const result = await NativeUpdate.sync();
 
-      if (!available) {
+      if (result.status === 'UP_TO_DATE') {
         if (!silent) {
           await this.showAlert('No Updates', 'Your app is up to date!');
         }
         return;
       }
 
-      // Show update dialog
-      const alert = await this.alertCtrl.create({
-        header: 'Update Available',
-        message: `Version ${version} is available.\n\n${notes || 'Bug fixes and improvements'}`,
-        buttons: [
-          {
-            text: mandatory ? 'Update Now' : 'Later',
-            role: 'cancel',
-            handler: () => {
-              if (mandatory) {
-                // Force update for mandatory updates
-                this.downloadAndApplyUpdate();
-                return false;
-              }
+      if (result.status === 'UPDATE_AVAILABLE' || result.status === 'UPDATE_INSTALLED') {
+        // Show update dialog
+        const alert = await this.alertCtrl.create({
+          header: 'Update Available',
+          message: `Version ${result.version} is available.\n\n${result.description || 'Bug fixes and improvements'}`,
+          buttons: [
+            {
+              text: result.mandatory ? 'Update Now' : 'Later',
+              role: 'cancel',
+              handler: () => {
+                if (result.mandatory) {
+                  // Force update for mandatory updates
+                  this.downloadAndApplyUpdate();
+                  return false;
+                }
+              },
             },
-          },
-          {
-            text: 'Update',
-            handler: () => {
-              this.downloadAndApplyUpdate();
+            {
+              text: 'Update',
+              handler: () => {
+                this.downloadAndApplyUpdate();
+              },
             },
-          },
-        ],
-        backdropDismiss: !mandatory,
-      });
+          ],
+          backdropDismiss: !result.mandatory,
+        });
 
       await alert.present();
     } catch (error) {
@@ -220,11 +220,14 @@ export class UpdateService {
 
     try {
       // Download with progress
-      await NativeUpdate.download({
-        onProgress: (progress) => {
+      // The sync method already handles downloading
+      // Progress tracking would be done via event listeners
+      const downloadListener = NativeUpdate.addListener(
+        'downloadProgress',
+        (progress) => {
           loading.message = `Downloading... ${Math.round(progress.percent)}%`;
-        },
-      });
+        }
+      );
 
       loading.message = 'Applying update...';
 
@@ -291,31 +294,25 @@ export class AppComponent implements OnInit {
 export class UpdateStrategies {
   // Immediate update (default)
   async immediateUpdate() {
-    const { available } = await NativeUpdate.sync();
-    if (available) {
-      await NativeUpdate.download();
+    const result = await NativeUpdate.sync();
+    if (result.status === 'UPDATE_INSTALLED') {
       await NativeUpdate.reload(); // Restarts immediately
     }
   }
 
   // Update on next restart
   async updateOnRestart() {
-    const { available } = await NativeUpdate.sync();
-    if (available) {
-      await NativeUpdate.download();
-      await NativeUpdate.applyUpdate({
-        reloadStrategy: 'on-next-restart',
-      });
-      // Update will be applied next time app starts
+    const result = await NativeUpdate.sync();
+    if (result.status === 'UPDATE_INSTALLED') {
+      // Update is already installed, just don't reload immediately
+      // Update will be applied on next app restart
     }
   }
 
   // Update with confirmation
   async updateWithConfirmation() {
-    const { available } = await NativeUpdate.sync();
-    if (available) {
-      await NativeUpdate.download();
-
+    const result = await NativeUpdate.sync();
+    if (result.status === 'UPDATE_INSTALLED') {
       // Show confirmation dialog
       const confirmed = await this.showUpdateReadyDialog();
       if (confirmed) {
@@ -429,45 +426,51 @@ await NativeUpdate.setChannel({ channel: 'beta' });
 ### 2. Delta Updates
 
 ```typescript
-// Enable delta updates to reduce download size
-await NativeUpdate.configureDeltaUpdates({
-  enabled: true,
-  threshold: 0.3, // Use delta if size < 30% of full bundle
-});
+// Delta updates would be handled server-side
+// The sync() method will automatically use delta updates if available
+// Configure your server to provide delta updates when appropriate
 ```
 
 ### 3. Rollback Support
 
 ```typescript
-// List available versions
-const { versions } = await NativeUpdate.getVersions();
+// List all downloaded bundles
+const bundles = await NativeUpdate.list();
 
-// Rollback to previous version
-if (versions.length > 1) {
-  await NativeUpdate.reset();
-}
+// Rollback to original app bundle
+await NativeUpdate.reset();
 
-// Rollback to specific version
-await NativeUpdate.switchVersion({
-  version: '1.0.0',
-});
+// Rollback to a specific bundle
+if (bundles.length > 1) {
+  const previousBundle = bundles[bundles.length - 2];
+  await NativeUpdate.set(previousBundle);
+  await NativeUpdate.reload();
+}
 ```
 
 ### 4. Update Metrics
 
 ```typescript
-// Track update success
-await NativeUpdate.reportUpdateSuccess({
-  version: '1.0.1',
-  duration: 5000,
-});
+// Implement your own metrics tracking
+class UpdateMetrics {
+  async trackSuccess(version: string, duration: number) {
+    // Send to your analytics service
+    await analytics.track('update_success', {
+      version,
+      duration,
+      timestamp: Date.now()
+    });
+  }
 
-// Track update failure
-await NativeUpdate.reportUpdateFailure({
-  version: '1.0.1',
-  error: 'DOWNLOAD_FAILED',
-  details: 'Network timeout',
-});
+  async trackFailure(version: string, error: string) {
+    // Send to your analytics service
+    await analytics.track('update_failure', {
+      version,
+      error,
+      timestamp: Date.now()
+    });
+  }
+}
 ```
 
 ### 5. Custom Update UI
@@ -484,7 +487,7 @@ class CustomUpdateUI {
     // Custom check
     const update = await NativeUpdate.sync();
 
-    if (update.available) {
+    if (update.status === 'UPDATE_AVAILABLE' || update.status === 'UPDATE_INSTALLED') {
       // Show custom UI
       const modal = await this.modalCtrl.create({
         component: UpdateModalComponent,
@@ -561,15 +564,13 @@ await NativeUpdate.setChannel({
 // Download during off-peak hours
 const now = new Date().getHours();
 if (now >= 2 && now <= 6) {
-  await NativeUpdate.download({
-    priority: 'low',
-  });
+  // Download priority would be configured during sync
+  await NativeUpdate.sync();
 }
 
-// Pause/resume downloads
-const downloadId = await NativeUpdate.startDownload();
-await NativeUpdate.pauseDownload({ id: downloadId });
-await NativeUpdate.resumeDownload({ id: downloadId });
+// Download management would be handled by the sync() method
+// For custom download control, implement your own download manager
+// that uses the download() method with proper retry logic
 ```
 
 ## Troubleshooting
@@ -579,42 +580,56 @@ await NativeUpdate.resumeDownload({ id: downloadId });
 1. **Update not applying**
 
    ```typescript
-   // Check if update was downloaded
-   const { ready } = await NativeUpdate.isUpdateReady();
-   if (ready) {
-     // Force apply
-     await NativeUpdate.applyUpdate({ force: true });
+   // Check current bundle status
+   const current = await NativeUpdate.current();
+   console.log('Current bundle:', current);
+   
+   // List all bundles to see if update was downloaded
+   const bundles = await NativeUpdate.list();
+   console.log('Available bundles:', bundles);
+   
+   // If update bundle exists but not active, set it
+   const updateBundle = bundles.find(b => b.version === 'new-version');
+   if (updateBundle && updateBundle.bundleId !== current.bundleId) {
+     await NativeUpdate.set(updateBundle);
+     await NativeUpdate.reload();
    }
    ```
 
 2. **Signature verification fails**
 
    ```typescript
-   // Verify public key configuration
-   const config = await NativeUpdate.getConfiguration();
-   console.log('Public key:', config.publicKey);
+   // Check current configuration by examining the plugin setup
+   // Configuration is set during plugin initialization
+   console.log('Verify your capacitor.config.json for publicKey setting');
    ```
 
 3. **Storage issues**
    ```typescript
-   // Clear old versions
-   await NativeUpdate.cleanup({
-     keepVersions: 1,
+   // Delete old bundles, keeping only the latest N versions
+   await NativeUpdate.delete({
+     keepVersions: 2  // Keep only 2 most recent versions
+   });
+   
+   // Or delete bundles older than a certain date
+   const thirtyDaysAgo = Date.now() - (30 * 24 * 60 * 60 * 1000);
+   await NativeUpdate.delete({
+     olderThan: thirtyDaysAgo
    });
    ```
 
 ### Debug Mode
 
 ```typescript
-// Enable debug logging
-await NativeUpdate.setDebugMode({ enabled: true });
+// Enable debug logging through your app's logging system
+// The plugin will log errors and important events automatically
 
 // Monitor update events
-NativeUpdate.addListener('updateDownloadProgress', (progress) => {
+NativeUpdate.addListener('downloadProgress', (progress) => {
   console.log('Download progress:', progress);
 });
 
-NativeUpdate.addListener('updateStateChange', (state) => {
+NativeUpdate.addListener('updateStateChanged', (state) => {
   console.log('Update state:', state);
 });
 ```
@@ -622,15 +637,25 @@ NativeUpdate.addListener('updateStateChange', (state) => {
 ### Health Checks
 
 ```typescript
-// Verify update system health
-const health = await NativeUpdate.getHealth();
-console.log('Update system health:', {
-  enabled: health.enabled,
-  lastCheck: health.lastCheck,
-  lastUpdate: health.lastUpdate,
-  currentVersion: health.currentVersion,
-  availableSpace: health.availableSpace,
-});
+// Implement your own health check system
+class UpdateHealthCheck {
+  async checkHealth() {
+    const current = await NativeUpdate.current();
+    const bundles = await NativeUpdate.list();
+    
+    const health = {
+      currentVersion: current.version,
+      currentBundleId: current.bundleId,
+      bundleStatus: current.status,
+      totalBundles: bundles.length,
+      lastUpdateTime: current.downloadTime,
+      isVerified: current.verified
+    };
+    
+    console.log('Update system health:', health);
+    return health;
+  }
+}
 ```
 
 ## Security Considerations

package/docs/MIGRATION.md

@@ -187,6 +187,6 @@ await NativeUpdate.configure(config);
 
 ### Getting Help
 
-- Check our [example app](../example) for implementation patterns
+- Check our example app in the `/example` directory for implementation patterns
 - Review the [API documentation](./api/live-update-api.md)
 - File issues on GitHub for migration problems

package/docs/NATIVE_UPDATES_GUIDE.md

@@ -201,10 +201,12 @@ export class AndroidFlexibleUpdate {
       );
 
       // Listen for download completion
-      NativeUpdate.addListener('onAppUpdateDownloaded', () => {
-        console.log('Update downloaded');
-        this.updateDownloaded = true;
-        this.showInstallPrompt();
+      NativeUpdate.addListener('updateStateChanged', (event) => {
+        if (event.status === 'DOWNLOADED') {
+          console.log('Update downloaded');
+          this.updateDownloaded = true;
+          this.showInstallPrompt();
+        }
       });
     } catch (error) {
       console.error('Flexible update failed:', error);
@@ -411,7 +413,7 @@ export class UpdateStatusManager {
 
   private setupUpdateListeners() {
     // Installation status
-    NativeUpdate.addListener('onAppUpdateInstallStatus', (status) => {
+    NativeUpdate.addListener('updateStateChanged', (status) => {
       switch (status.status) {
         case 'PENDING':
           console.log('Update pending');
@@ -650,9 +652,8 @@ if (state.status === 'FAILED') {
 #### 3. iOS App Store Not Opening
 
 ```typescript
-// Verify App Store ID configuration
-const config = await NativeUpdate.getConfiguration();
-console.log('App Store ID:', config.appStoreId);
+// App Store ID is configured in capacitor.config.json
+// Check your configuration file for the appStoreId setting
 
 // Manual fallback
 if (!config.appStoreId) {

package/docs/QUICK_START.md

@@ -238,19 +238,21 @@ export class AndroidUpdateProgress {
     );
 
     // Handle completion
-    NativeUpdate.addListener('onAppUpdateDownloaded', async () => {
-      const alert = await this.alertController.create({
-        header: 'Update Ready',
-        message: 'Update has been downloaded. Install now?',
-        buttons: [
-          { text: 'Later' },
-          {
-            text: 'Install',
-            handler: () => NativeUpdate.completeFlexibleUpdate(),
-          },
-        ],
-      });
-      await alert.present();
+    NativeUpdate.addListener('updateStateChanged', async (event) => {
+      if (event.status === 'DOWNLOADED') {
+        const alert = await this.alertController.create({
+          header: 'Update Ready',
+          message: 'Update has been downloaded. Install now?',
+          buttons: [
+            { text: 'Later' },
+            {
+              text: 'Install',
+              handler: () => NativeUpdate.completeFlexibleUpdate(),
+            },
+          ],
+        });
+        await alert.present();
+      }
     });
   }
 }
@@ -533,11 +535,10 @@ curl -X POST http://localhost:3000/api/v1/bundles \
 ### 3. Test App Reviews
 
 ```typescript
-// Enable debug mode
-await NativeUpdate.setReviewDebugMode({ enabled: true });
-
-// Force show review (debug only)
-await NativeUpdate.requestReview({ force: true });
+// Test review prompts
+// Note: Reviews may not show in development builds
+// Test with TestFlight (iOS) or Internal Test Track (Android)
+await NativeUpdate.requestReview();
 ```
 
 ## What's Next?
@@ -566,12 +567,11 @@ Now that you have the basics working:
 ### Live Updates Not Working?
 
 ```typescript
-// Enable debug logging
-await NativeUpdate.setDebugMode({ enabled: true });
+// Enable debug logging in your app
+console.log('Checking update configuration...');
 
-// Check configuration
-const config = await NativeUpdate.getConfiguration();
-console.log('Update URL:', config.updateUrl);
+// Configuration is set in capacitor.config.json
+// Check your config file for updateUrl and other settings
 ```
 
 ### Native Updates Not Detected?

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

@@ -92,27 +92,7 @@ await NativeUpdate.trackSignificantEvent(eventName: string);
 
 ## Events
 
-### reviewPromptDisplayed
-
-Fired when review prompt is shown.
-
-```typescript
-NativeUpdate.addListener('reviewPromptDisplayed', (event) => {
-  console.log('Review prompt shown on:', event.platform);
-  analytics.track('review_prompt_displayed');
-});
-```
-
-### reviewPromptDismissed
-
-Fired when review prompt is dismissed.
-
-```typescript
-NativeUpdate.addListener('reviewPromptDismissed', (event) => {
-  console.log('Review prompt dismissed');
-  analytics.track('review_prompt_dismissed');
-});
-```
+Note: App review events are handled natively by the platform's review system. The plugin does not expose custom events for review prompts as these are controlled by iOS StoreKit and Android Play Core.
 
 ## Platform Implementation
 

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

@@ -25,20 +25,22 @@ await NativeUpdate.configure({
 });
 ```
 
-### sync()
+### sync(options?)
 
 Sync with update server and apply updates based on strategy.
 
 ```typescript
 const result = await NativeUpdate.sync({
-  installMode?: 'IMMEDIATE' | 'ON_NEXT_RESTART' | 'ON_NEXT_RESUME';
-  minimumBackgroundDuration?: number; // Minimum background time (ms)
+  channel?: string;           // Update channel (optional)
+  updateMode?: UpdateMode;    // Update mode (optional)
 });
 // Returns:
 {
-  status: 'UP_TO_DATE' | 'UPDATE_AVAILABLE' | 'UPDATE_INSTALLED' | 'ERROR';
-  bundle?: BundleInfo;        // Bundle information if update available/installed
-  error?: { code: string; message: string; };
+  status: SyncStatus;         // 'UP_TO_DATE' | 'UPDATE_AVAILABLE' | 'UPDATE_INSTALLED' | 'ERROR'
+  version?: string;           // Version if update available
+  description?: string;       // Update description
+  mandatory?: boolean;        // Is update mandatory
+  error?: UpdateError;        // Error details if status is ERROR
 }
 ```
 
@@ -48,15 +50,25 @@ Download a specific bundle version.
 
 ```typescript
 const result = await NativeUpdate.download({
-  version: string;            // Version to download
+  url: string;                // Bundle URL (required)
+  version: string;            // Version to download (required)
+  checksum: string;           // Expected SHA-256 checksum (required)
+  signature?: string;         // Optional bundle signature
+  maxRetries?: number;        // Max download retries
+  timeout?: number;           // Download timeout in ms
 });
 // Returns:
 {
   bundleId: string;           // Unique bundle ID
   version: string;            // Bundle version
   path: string;              // Local path
+  downloadTime: number;       // Download timestamp
   size: number;              // File size
+  status: BundleStatus;       // Bundle status
   checksum: string;           // SHA-256 checksum
+  signature?: string;         // Bundle signature if provided
+  verified: boolean;          // Signature verification status
+  metadata?: Record<string, unknown>; // Optional metadata
 }
 ```
 
@@ -115,7 +127,8 @@ Delete bundles.
 ```typescript
 await NativeUpdate.delete({
   bundleId?: string;          // Delete specific bundle
-  keepLatest?: number;        // Keep N most recent versions
+  keepVersions?: number;      // Keep N most recent versions
+  olderThan?: number;         // Delete bundles older than timestamp
 });
 ```
 
@@ -135,21 +148,6 @@ Notify that the app has successfully started with the new bundle.
 await NativeUpdate.notifyAppReady();
 ```
 
-### pauseAutoUpdates()
-
-Temporarily pause automatic update checks.
-
-```typescript
-await NativeUpdate.pauseAutoUpdates();
-```
-
-### resumeAutoUpdates()
-
-Resume automatic update checks.
-
-```typescript
-await NativeUpdate.resumeAutoUpdates();
-```
 
 ### setChannel(channel)
 
@@ -172,7 +170,7 @@ await NativeUpdate.setUpdateUrl(url: string);
 Validate a bundle's integrity.
 
 ```typescript
-const result = await NativeUpdate.validateUpdate({
+const result = await NativeUpdate.LiveUpdate.validateUpdate({
   bundlePath: string;
   checksum: string;
   signature?: string;
@@ -210,13 +208,23 @@ NativeUpdate.addListener('downloadProgress', (progress) => {
 });
 ```
 
-### error
+### backgroundUpdateProgress
+
+Fired during background update operations.
+
+```typescript
+NativeUpdate.addListener('backgroundUpdateProgress', (progress) => {
+  console.log('Background update:', progress.status);
+});
+```
+
+### backgroundUpdateNotification
 
-Fired when an error occurs.
+Fired when background update notifications are triggered.
 
 ```typescript
-NativeUpdate.addListener('error', (error) => {
-  console.error('Update error:', error.code, error.message);
+NativeUpdate.addListener('backgroundUpdateNotification', (notification) => {
+  console.log('Update notification:', notification.type);
 });
 ```
 

package/docs/examples/advanced-scenarios.md

@@ -23,8 +23,11 @@ async function checkForDeltaUpdate() {
 }
 
 async function downloadDeltaUpdate(deltaUrl: string) {
+  // Download requires url, version, and checksum parameters
   const download = await NativeUpdate.download({
-    version: 'delta-version'
+    url: result.deltaUrl,
+    version: result.version,
+    checksum: result.checksum
   });
   
   // Set the bundle as active
@@ -108,12 +111,14 @@ async function setupBackgroundUpdates() {
 }
 
 // Handle background update events
-NativeUpdate.addListener('backgroundUpdateReady', (event) => {
+NativeUpdate.addListener('backgroundUpdateNotification', (event) => {
   // Notify user that update is ready
-  showUpdateNotification({
-    version: event.version,
-    releaseNotes: event.releaseNotes
-  });
+  if (event.updateAvailable) {
+    showUpdateNotification({
+      version: event.version,
+      type: event.type
+    });
+  }
 });
 ```
 
@@ -190,7 +195,9 @@ async function setupABTest(config: ABTestConfig) {
     : config.variants.control;
     
   const download = await NativeUpdate.download({
-    version: variant
+    url: bundleUrl,
+    version: variant,
+    checksum: 'bundle-checksum' // This should come from server
   });
   
   // Set the bundle as active
@@ -247,8 +254,11 @@ class UpdateManager {
     );
     
     try {
+      // Download requires url, version, and checksum
       const download = await NativeUpdate.download({
-        version: updateInfo.version
+        url: updateInfo.url,
+        version: updateInfo.version,
+        checksum: updateInfo.checksum
       });
       
       this.updateState = { status: 'installing' };
@@ -296,11 +306,13 @@ async function secureUpdateCheck() {
 
 async function downloadWithIntegrityCheck(url: string, expectedHash: string) {
   const download = await NativeUpdate.download({
-    version: 'secure-version'
+    url: url,
+    version: 'secure-version',
+    checksum: expectedHash
   });
   
   // Additional verification
-  const verified = await NativeUpdate.validateUpdate({
+  const verified = await NativeUpdate.LiveUpdate.validateUpdate({
     bundlePath: download.path,
     checksum: download.checksum,
     signature: 'bundle-signature'
@@ -344,7 +356,9 @@ class UpdateMetrics {
       // Download phase
       metrics.downloadStarted = Date.now();
       const download = await NativeUpdate.download({
-        version: result.version
+        url: result.url,
+        version: result.version,
+        checksum: result.checksum
       });
       metrics.downloadCompleted = Date.now();
       metrics.downloadSize = download.size;

package/docs/examples/basic-usage.md

@@ -41,6 +41,7 @@ async function downloadAndInstall(version: string) {
   
   // Set the downloaded bundle as active
   await NativeUpdate.set({
+    bundleId: download.bundleId,
     version: download.version,
     checksum: download.checksum
   });

package/docs/features/app-reviews.md

@@ -966,7 +966,7 @@ async function monitorReviewSuccess() {
 ## Next Steps
 
 - Implement [Security Best Practices](../guides/security-best-practices.md)
-- Set up [Analytics Tracking](../examples/analytics-integration.md)
+- Review the [API Reference](../api/app-review-api.md)
 - Configure [Live Updates](./live-updates.md)
 - Review [API Reference](../api/app-review-api.md)
 

package/docs/features/app-updates.md

@@ -777,7 +777,7 @@ async function trackUpdateMetrics(event: string, data: any) {
 
 - Configure [App Reviews](./app-reviews.md) for user feedback
 - Implement [Security Best Practices](../guides/security-best-practices.md)
-- Set up [Update Monitoring](../guides/monitoring.md)
+- Review [Testing Guide](../guides/testing-guide.md)
 - Review [API Reference](../api/app-update-api.md)
 
 ---

package/docs/features/live-updates.md

@@ -379,9 +379,10 @@ async function getFeatureFlags() {
 2. **Implement delta updates** (coming soon):
    ```typescript
    // Future API
-   const delta = await NativeUpdate.LiveUpdate.downloadDelta({
-     fromVersion: current.version,
-     toVersion: latest.version,
+   // Note: Delta updates are handled automatically by the sync() method
+   // when configured on the server. Direct delta download is not available
+   const bundle = await NativeUpdate.LiveUpdate.download({
+     version: latest.version,
    });
    ```
 
@@ -409,15 +410,23 @@ async function getFeatureFlags() {
 ### Storage Management
 
 ```typescript
-// Monitor storage usage
-const storage = await NativeUpdate.LiveUpdate.getStorageInfo();
-console.log(`Used: ${storage.usedBytes} / ${storage.totalBytes}`);
-
-// Clean up when needed
-if (storage.usedBytes > storage.totalBytes * 0.8) {
-  await NativeUpdate.LiveUpdate.delete({
-    olderThan: Date.now() - 30 * 24 * 60 * 60 * 1000, // 30 days
-  });
+// Monitor bundle count and clean up old versions
+const bundles = await NativeUpdate.LiveUpdate.list();
+console.log(`Total bundles: ${bundles.length}`);
+
+// Clean up old bundles (keep only recent 5)
+if (bundles.length > 5) {
+  // Sort by downloadTime and keep the 5 most recent
+  const sortedBundles = bundles.sort((a, b) => 
+    new Date(b.downloadTime).getTime() - new Date(a.downloadTime).getTime()
+  );
+  
+  const toDelete = sortedBundles.slice(5);
+  for (const bundle of toDelete) {
+    await NativeUpdate.LiveUpdate.delete({
+      bundleId: bundle.bundleId,
+    });
+  }
 }
 ```
 
@@ -526,7 +535,7 @@ const devConfig = {
 };
 
 // Force update check
-await NativeUpdate.LiveUpdate.sync({ forceCheck: true });
+await NativeUpdate.LiveUpdate.sync();
 
 // Simulate different scenarios
 await testUpdateScenarios();
@@ -623,7 +632,7 @@ async function loadFeature(featureName: string) {
 
 ## Next Steps
 
-- Set up your [Update Server](../examples/server-setup.md)
+- Set up your update server (see backend-template folder)
 - Implement [Security Best Practices](../guides/security-best-practices.md)
 - Configure [App Updates](./app-updates.md) for native changes
 - Explore [API Reference](../api/live-update-api.md)

package/docs/getting-started/configuration.md

@@ -460,7 +460,7 @@ try {
 ## Next Steps
 
 - Implement [Security Best Practices](../guides/security-best-practices.md)
-- Set up your [Update Server](../examples/server-setup.md)
+- Set up your update server (see backend-template folder)
 - Explore [Advanced Features](../features/live-updates.md)
 
 ---

package/docs/getting-started/installation.md

@@ -194,13 +194,13 @@ After successful installation:
 1. Read the [Quick Start Guide](./quick-start.md) for basic usage
 2. Configure the plugin with your [update server settings](./configuration.md)
 3. Implement [security best practices](../guides/security-best-practices.md)
-4. Set up your [update server](../examples/server-setup.md)
+4. Set up your update server (see backend-template folder)
 
 ## Support
 
 If you encounter any issues during installation:
 
-- Check our [Troubleshooting Guide](../guides/troubleshooting.md)
+- Check our [Testing Guide](../guides/testing-guide.md)
 - Search existing [GitHub Issues](https://github.com/aoneahsan/native-update/issues)
 - Create a new issue with detailed information about your setup
 

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

@@ -53,7 +53,7 @@ initializeUpdates();
 // Sync with server and apply updates if available
 async function syncUpdates() {
   try {
-    const result = await NativeUpdate.LiveUpdate.sync();
+    const result = await NativeUpdate.sync();
 
     if (result.status === 'UPDATE_INSTALLED') {
       console.log('Update installed:', result.bundle.version);
@@ -259,7 +259,7 @@ class UpdateManager {
 
   async checkForUpdates() {
     try {
-      const result = await NativeUpdate.LiveUpdate.sync();
+      const result = await NativeUpdate.sync();
 
       if (result.status === 'UPDATE_INSTALLED') {
         // Notify user about update
@@ -349,7 +349,7 @@ async function safeUpdateCheck() {
 
 Now that you have the basics working:
 
-1. Set up your [Update Server](../examples/server-setup.md)
+1. Set up your update server (see backend-template folder)
 2. Implement [Security Best Practices](../guides/security-best-practices.md)
 3. Configure [Advanced Options](./configuration.md)
 4. Explore [API Reference](../api/live-update-api.md) for all available methods

package/docs/guides/migration-from-codepush.md

@@ -136,6 +136,6 @@ node tools/bundle-signer.js sign bundle.zip private-key.pem
 
 ## Need Help?
 
-- See [Troubleshooting Guide](../guides/troubleshooting.md)
+- See [Testing Guide](../guides/testing-guide.md)
 - Check [Server Requirements](../server-requirements.md)
 - Review [Security Best Practices](./security-best-practices.md)

package/docs/guides/security-best-practices.md

@@ -1048,9 +1048,9 @@ const productionSecurityConfig = {
 ## Next Steps
 
 - Review [Production Readiness](../production-readiness.md) checklist
-- Implement [Monitoring and Analytics](../examples/monitoring-setup.md)
-- Set up [Incident Response](../guides/incident-response.md) procedures
-- Configure [Update Server Security](../examples/server-security.md)
+- Implement proper monitoring and analytics
+- Set up incident response procedures
+- Configure update server security (see backend-template folder)
 
 ---
 

package/docs/guides/testing-guide.md

@@ -123,7 +123,7 @@ try {
 node tools/bundle-signer.js sign test-bundle.zip private-key.pem
 
 # Verify in app
-const isValid = await NativeUpdate.validateUpdate({
+const isValid = await NativeUpdate.LiveUpdate.validateUpdate({
   bundlePath: 'bundle-path',
   checksum: 'bundle-checksum',
   signature: signature
@@ -135,7 +135,7 @@ const isValid = await NativeUpdate.validateUpdate({
 #### Download Performance
 ```typescript
 // Monitor download speed
-NativeUpdate.addListener('downloadProgress', (progress) => {
+NativeUpdate.LiveUpdate.addListener('downloadProgress', (progress) => {
   console.log(`Speed: ${progress.speed} MB/s`);
   console.log(`Progress: ${progress.percent}%`);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "native-update",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "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",