native-update 1.1.4 → 1.2.0

package/docs/PROJECT_COMPLETION_TRACKER.md

@@ -0,0 +1,243 @@
+# Project Completion Tracker
+
+**Last Updated**: 2025-12-26
+**Project**: Native Update - Capacitor Plugin
+**Version**: 1.1.6
+
+---
+
+## ✅ COMPLETED FEATURES
+
+### Core TypeScript Implementation
+- [x] Plugin architecture with proper interfaces (`src/definitions.ts`)
+- [x] Live update manager (`src/live-update/update-manager.ts`)
+- [x] Bundle manager with download and installation (`src/live-update/bundle-manager.ts`)
+- [x] Version manager with semantic versioning (`src/live-update/version-manager.ts`)
+- [x] Download manager with progress tracking (`src/live-update/download-manager.ts`)
+- [x] Certificate pinning for secure connections (`src/live-update/certificate-pinning.ts`)
+- [x] App update checker (`src/app-update/app-update-checker.ts`)
+- [x] App update installer (`src/app-update/app-update-installer.ts`)
+- [x] App update manager (`src/app-update/app-update-manager.ts`)
+- [x] App update notifier with UI (`src/app-update/app-update-notifier.ts`)
+- [x] Platform app update integration (`src/app-update/platform-app-update.ts`)
+- [x] App review manager (`src/app-review/app-review-manager.ts`)
+- [x] Platform review handler (`src/app-review/platform-review-handler.ts`)
+- [x] Review conditions checker (`src/app-review/review-conditions-checker.ts`)
+- [x] Review rate limiter (`src/app-review/review-rate-limiter.ts`)
+- [x] Background scheduler (`src/background-update/background-scheduler.ts`)
+- [x] Notification manager (`src/background-update/notification-manager.ts`)
+
+### Core Infrastructure
+- [x] Analytics framework (`src/core/analytics.ts`)
+- [x] Cache manager (`src/core/cache-manager.ts`)
+- [x] Configuration system (`src/core/config.ts`)
+- [x] Error handling (`src/core/errors.ts`)
+- [x] Event emitter (`src/core/event-emitter.ts`)
+- [x] Logger (`src/core/logger.ts`)
+- [x] Performance monitoring (`src/core/performance.ts`)
+- [x] Plugin manager (`src/core/plugin-manager.ts`)
+- [x] Security utilities (`src/core/security.ts`)
+
+### Security Implementation
+- [x] Crypto utilities (`src/security/crypto.ts`)
+- [x] Input/output validator (`src/security/validator.ts`)
+- [x] SHA-256 checksum verification
+- [x] RSA/ECDSA signature verification
+- [x] HTTPS enforcement
+- [x] Certificate pinning architecture
+
+### Native Implementations
+
+#### iOS (Swift)
+- [x] Main plugin class (`ios/Plugin/NativeUpdatePlugin.swift`)
+- [x] Live update implementation (`ios/Plugin/LiveUpdate/LiveUpdatePlugin.swift`)
+- [x] Bundle manager (`ios/Plugin/LiveUpdate/BundleManager.swift`)
+- [x] Security manager (`ios/Plugin/Security/SecurityManager.swift`)
+- [x] App update plugin (`ios/Plugin/AppUpdate/AppUpdatePlugin.swift`)
+- [x] App review plugin (`ios/Plugin/AppReview/AppReviewPlugin.swift`)
+- [x] Background update plugin (`ios/Plugin/BackgroundUpdate/BackgroundUpdatePlugin.swift`)
+
+#### Android (Kotlin)
+- [x] Main plugin class (`android/src/main/java/com/aoneahsan/nativeupdate/NativeUpdatePlugin.kt`)
+- [x] Live update implementation (`android/src/main/java/com/aoneahsan/nativeupdate/LiveUpdatePlugin.kt`)
+- [x] Bundle manager (`android/src/main/java/com/aoneahsan/nativeupdate/BundleManager.kt`)
+- [x] Security manager (`android/src/main/java/com/aoneahsan/nativeupdate/SecurityManager.kt`)
+- [x] App update plugin (`android/src/main/java/com/aoneahsan/nativeupdate/AppUpdatePlugin.kt`)
+- [x] App review plugin (`android/src/main/java/com/aoneahsan/nativeupdate/AppReviewPlugin.kt`)
+- [x] Background update plugin (`android/src/main/java/com/aoneahsan/nativeupdate/BackgroundUpdatePlugin.kt`)
+
+### Testing Infrastructure
+- [x] Vitest configuration (`vitest.config.ts`)
+- [x] Bundle manager tests (`src/__tests__/bundle-manager.test.ts`)
+- [x] Config tests (`src/__tests__/config.test.ts`)
+- [x] Integration tests (`src/__tests__/integration.test.ts`)
+- [x] Security tests (`src/__tests__/security.test.ts`)
+- [x] Version manager tests (`src/__tests__/version-manager.test.ts`)
+
+### CLI Tools
+- [x] Main CLI (`cli/index.js`)
+- [x] Init command (`cli/commands/init.js`)
+- [x] Bundle create command (`cli/commands/bundle-create.js`)
+- [x] Bundle sign command (`cli/commands/bundle-sign.js`)
+- [x] Bundle verify command (`cli/commands/bundle-verify.js`)
+- [x] Keys generate command (`cli/commands/keys-generate.js`)
+- [x] Backend create command (`cli/commands/backend-create.js`)
+- [x] Server start command (`cli/commands/server-start.js`)
+- [x] Monitor command (`cli/commands/monitor.js`)
+
+### Backend Infrastructure
+
+#### Production Backend (Node.js + SQLite)
+- [x] Main server (`production-backend/src/index.js`)
+- [x] Database initialization (`production-backend/src/database/init.js`)
+- [x] Auth middleware (`production-backend/src/middleware/auth.js`)
+- [x] Error middleware (`production-backend/src/middleware/error.js`)
+- [x] Logging middleware (`production-backend/src/middleware/logging.js`)
+- [x] Validation middleware (`production-backend/src/middleware/validation.js`)
+- [x] Analytics routes (`production-backend/src/routes/analytics.js`)
+- [x] Auth routes (`production-backend/src/routes/auth.js`)
+- [x] Bundles routes (`production-backend/src/routes/bundles.js`)
+- [x] Health routes (`production-backend/src/routes/health.js`)
+- [x] Updates routes (`production-backend/src/routes/updates.js`)
+- [x] Logger utility (`production-backend/src/utils/logger.js`)
+
+#### Firebase Backend Example
+- [x] Firebase Functions (`example-app/firebase-backend/src/index.ts`)
+- [x] Auth middleware (`example-app/firebase-backend/src/middleware/auth.ts`)
+- [x] Analytics routes (`example-app/firebase-backend/src/routes/analytics.ts`)
+- [x] Bundles routes (`example-app/firebase-backend/src/routes/bundles.ts`)
+- [x] Updates routes (`example-app/firebase-backend/src/routes/updates.ts`)
+- [x] Validation utils (`example-app/firebase-backend/src/utils/validation.ts`)
+- [x] Version utils (`example-app/firebase-backend/src/utils/version.ts`)
+- [x] Firestore indexes (`example-app/firebase-backend/firestore.indexes.json`)
+- [x] Firestore rules (`example-app/firebase-backend/firestore.rules`)
+- [x] Storage rules (`example-app/firebase-backend/storage.rules`)
+
+#### Backend Template (Express)
+- [x] Simple server (`backend-template/server.js`)
+
+### Documentation
+- [x] Main README (`Readme.md`)
+- [x] API documentation (`API.md`)
+- [x] Changelog (`CHANGELOG.md`)
+- [x] Contributing guide (`CONTRIBUTING.md`)
+- [x] Security policy (`SECURITY.md`)
+- [x] Features overview (`FEATURES.md`)
+- [x] Quick start guide (`docs/QUICK_START.md`)
+- [x] Live updates guide (`docs/LIVE_UPDATES_GUIDE.md`)
+- [x] Native updates guide (`docs/NATIVE_UPDATES_GUIDE.md`)
+- [x] App review guide (`docs/APP_REVIEW_GUIDE.md`)
+- [x] Bundle signing guide (`docs/BUNDLE_SIGNING.md`)
+- [x] Background updates (`docs/background-updates.md`)
+- [x] CLI reference (`docs/cli-reference.md`)
+- [x] Migration guide (`docs/MIGRATION.md`)
+- [x] Production readiness (`docs/production-readiness.md`)
+- [x] Server requirements (`docs/server-requirements.md`)
+- [x] Installation (`docs/getting-started/installation.md`)
+- [x] Configuration (`docs/getting-started/configuration.md`)
+- [x] Quick start (`docs/getting-started/quick-start.md`)
+- [x] Live updates feature (`docs/features/live-updates.md`)
+- [x] App updates feature (`docs/features/app-updates.md`)
+- [x] App reviews feature (`docs/features/app-reviews.md`)
+- [x] Basic usage examples (`docs/examples/basic-usage.md`)
+- [x] Advanced scenarios (`docs/examples/advanced-scenarios.md`)
+- [x] Deployment guide (`docs/guides/deployment-guide.md`)
+- [x] Key management (`docs/guides/key-management.md`)
+- [x] Migration from CodePush (`docs/guides/migration-from-codepush.md`)
+- [x] Security best practices (`docs/guides/security-best-practices.md`)
+- [x] Testing guide (`docs/guides/testing-guide.md`)
+- [x] Certificate pinning (`docs/security/certificate-pinning.md`)
+- [x] API references for all modules (`docs/api/`)
+
+### Example Applications
+- [x] Basic example app (`example/`)
+- [x] Advanced example app with Firebase (`example-app/`)
+- [x] Test app for development (`test-app/`)
+
+### Build & Development Tools
+- [x] TypeScript configuration (`tsconfig.json`, `tsconfig.node.json`)
+- [x] Rollup bundler config (`rollup.config.js`)
+- [x] ESLint config (`eslint.config.js`)
+- [x] Prettier config (`.prettierrc`)
+- [x] Vitest config (`vitest.config.ts`)
+- [x] Package.json with all scripts
+- [x] NVM version file (`.nvmrc`)
+- [x] EditorConfig (`.editorconfig`)
+- [x] Capacitor config (`capacitor.config.ts`)
+- [x] CocoaPods spec (`NativeUpdate.podspec`)
+
+### Utilities
+- [x] Bundle creator tool (`tools/bundle-creator.js`)
+- [x] Bundle signer tool (`tools/bundle-signer.js`)
+- [x] Server example (`server-example/`)
+
+---
+
+## ⚠️ PENDING FIXES (MUST COMPLETE NOW)
+
+### Code Quality Issues
+- [ ] **CRITICAL**: Fix all 40 ESLint warnings (TypeScript `any` types) - MUST FIX NOW
+- [ ] **CRITICAL**: Remove placeholder code in `src/core/performance.ts` (storage check) - MUST IMPLEMENT NOW
+- [ ] **CRITICAL**: Remove placeholder code in `src/core/security.ts` (certificate pinning note) - MUST CLARIFY NOW
+- [ ] **CRITICAL**: Remove placeholder code in `ios/Plugin/LiveUpdate/LiveUpdatePlugin.swift` (file copy & unzip) - MUST IMPLEMENT NOW
+
+### Documentation Updates
+- [ ] Update `FINAL_STATUS.md` to reflect current TRUE status
+- [ ] Update `PRODUCTION_STATUS.md` to reflect current TRUE status
+- [ ] Update `REMAINING_FEATURES.md` to reflect ACTUAL remaining work
+- [ ] Update `ROADMAP.md` to reflect completed items
+- [ ] Create Firebase indexes/rules verification document
+
+---
+
+## 🚫 NOT APPLICABLE / NOT NEEDED
+
+### Items That Don't Apply
+- ❌ Vite logging level change (not a Vite project, uses Rollup)
+- ❌ Firebase permissions errors in core plugin (Firebase only used in example-app)
+
+---
+
+## 📊 COMPLETION STATISTICS
+
+### Overall Progress
+- **Core Plugin**: 100% Complete
+- **Native Implementations**: 95% Complete (some placeholders need implementation)
+- **CLI Tools**: 100% Complete
+- **Backend Examples**: 100% Complete
+- **Documentation**: 100% Complete
+- **Testing**: 100% Complete
+- **Code Quality**: 90% (40 ESLint warnings to fix)
+
+### Issues to Resolve
+1. **40 ESLint warnings** - Replace `any` with proper types
+2. **3 code placeholders** - Implement or document as intentional
+3. **Documentation inconsistency** - Status files show conflicting states
+
+---
+
+## 🎯 IMMEDIATE ACTION ITEMS
+
+1. ✅ Fix all 40 ESLint `any` type warnings
+2. ✅ Remove or implement all placeholder code
+3. ✅ Create Firebase tracking document
+4. ✅ Update all status documents for consistency
+5. ✅ Run final build with zero warnings
+6. ✅ Verify no errors or warnings in entire project
+
+---
+
+## 📝 NOTES
+
+- This is a **Capacitor plugin package**, not a web app, so:
+  - No Vite (uses Rollup instead)
+  - No browser-based development server
+  - Firebase only used in example-app, not core plugin
+
+- The plugin provides:
+  - Live/OTA updates for web assets
+  - Native app store update checking
+  - In-app review prompts
+
+- Backend implementation is left to users (examples provided)
+- Real device testing recommended before production use

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

@@ -0,0 +1,157 @@
+# Background Update API Reference
+
+Complete API documentation for background update functionality.
+
+## Methods
+
+### enableBackgroundUpdates(config)
+
+Enable background update checking.
+
+```typescript
+await NativeUpdate.enableBackgroundUpdates({
+  checkInterval: 3600000,           // Check every hour (in ms)
+  requireWifi: true,                // Only check on WiFi
+  requireCharging: false,           // Don't require charging
+  updateTypes: ['live', 'native'],  // Check both update types
+  notificationConfig: {
+    enabled: true,
+    title: 'Update Available',
+    autoCancel: true
+  }
+});
+```
+
+### disableBackgroundUpdates()
+
+Disable all background update checks.
+
+```typescript
+await NativeUpdate.disableBackgroundUpdates();
+```
+
+### getBackgroundUpdateStatus()
+
+Get current background update configuration and status.
+
+```typescript
+const status = await NativeUpdate.getBackgroundUpdateStatus();
+// Returns:
+{
+  enabled: boolean;
+  lastCheckTime?: number;
+  nextScheduledCheck?: number;
+  checkInterval?: number;
+  updateTypes: string[];
+  notificationEnabled: boolean;
+}
+```
+
+### scheduleBackgroundCheck(options)
+
+Schedule a one-time background check.
+
+```typescript
+await NativeUpdate.scheduleBackgroundCheck({
+  delay: 60000,  // Check in 1 minute
+  type: 'live'   // Check for live updates only
+});
+```
+
+### triggerBackgroundCheck()
+
+Immediately trigger a background update check.
+
+```typescript
+const result = await NativeUpdate.triggerBackgroundCheck();
+// Returns:
+{
+  liveUpdateAvailable: boolean;
+  nativeUpdateAvailable: boolean;
+  error?: string;
+}
+```
+
+### setNotificationPreferences(preferences)
+
+Configure notification preferences for background updates.
+
+```typescript
+await NativeUpdate.setNotificationPreferences({
+  enabled: true,
+  showProgress: true,
+  soundEnabled: false,
+  vibrationEnabled: true,
+  ledColor: '#00FF00',
+  importance: 'HIGH'
+});
+```
+
+### getNotificationPermissions()
+
+Check current notification permissions.
+
+```typescript
+const permissions = await NativeUpdate.getNotificationPermissions();
+// Returns:
+{
+  granted: boolean;
+  canRequestPermission: boolean;
+  permanentlyDenied: boolean;
+}
+```
+
+### requestNotificationPermissions()
+
+Request notification permissions from the user.
+
+```typescript
+const result = await NativeUpdate.requestNotificationPermissions();
+// Returns:
+{
+  granted: boolean;
+  permanentlyDenied: boolean;
+}
+```
+
+## Events
+
+### backgroundUpdateProgress
+
+Fired during background update operations.
+
+```typescript
+NativeUpdate.addListener('backgroundUpdateProgress', (event) => {
+  console.log('Background update:', event.status);
+  // event.type: 'live' | 'native'
+  // event.status: 'checking' | 'downloading' | 'completed' | 'failed'
+});
+```
+
+### backgroundUpdateNotification
+
+Fired when background check finds an update.
+
+```typescript
+NativeUpdate.addListener('backgroundUpdateNotification', (event) => {
+  console.log('Update available:', event.updateAvailable);
+  // event.type: 'live' | 'native'
+  // event.version: string
+});
+```
+
+## Platform Notes
+
+### Android
+- Uses WorkManager for reliable scheduling
+- Respects battery optimization settings
+- Requires notification permission for user alerts
+
+### iOS
+- Uses BackgroundTasks framework
+- Limited by iOS background execution policies
+- May not run exactly at scheduled times
+
+### Web
+- Uses Service Workers when available
+- Falls back to periodic checks when app is active

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

@@ -148,6 +148,22 @@ Notify that the app has successfully started with the new bundle.
 await NativeUpdate.notifyAppReady();
 ```
 
+### getLatest()
+
+Get information about the latest available update from the server.
+
+```typescript
+const latest = await NativeUpdate.getLatest();
+// Returns:
+{
+  available: boolean;         // Whether an update is available
+  version?: string;          // Version number of the latest update
+  url?: string;              // Download URL for the update
+  mandatory?: boolean;       // Whether this is a mandatory update
+  notes?: string;            // Release notes for the update
+  size?: number;             // Size in bytes of the update bundle
+}
+```
 
 ### setChannel(channel)
 

package/ios/Plugin/AppUpdate/AppUpdatePlugin.swift

@@ -6,11 +6,16 @@ class AppUpdatePlugin {
     private weak var plugin: CAPPlugin?
     private var config: [String: Any]?
     private let iTunesLookupURL = "https://itunes.apple.com/lookup"
+    private var eventListener: ((String, [String: Any]) -> Void)?
     
     init(plugin: CAPPlugin) {
         self.plugin = plugin
     }
     
+    func setEventListener(_ listener: @escaping (String, [String: Any]) -> Void) {
+        self.eventListener = listener
+    }
+    
     func configure(_ config: [String: Any]) throws {
         self.config = config
     }
@@ -43,6 +48,16 @@ class AppUpdatePlugin {
                             result["clientVersionStalenessDays"] = days
                         }
                     }
+                    
+                    // Emit available event
+                    var availableData: [String: Any] = [
+                        "currentVersion": currentVersion,
+                        "availableVersion": storeVersion
+                    ]
+                    if let priority = result["updatePriority"] as? Int {
+                        availableData["updatePriority"] = priority
+                    }
+                    eventListener?("appUpdateAvailable", availableData)
                 }
                 
                 // iOS doesn't have the same update types as Android

package/ios/Plugin/LiveUpdate/LiveUpdatePlugin.swift

@@ -1,6 +1,7 @@
 import Foundation
 import Capacitor
 import CommonCrypto
+import ZIPFoundation
 
 class LiveUpdatePlugin {
     private weak var plugin: CAPPlugin?
@@ -517,6 +518,12 @@ class LiveUpdatePlugin {
         defaults.set(bundles, forKey: "native_update_bundles")
     }
     
+    func cleanup() {
+        // Clean up any resources
+        downloadTask?.cancel()
+        downloadTask = nil
+    }
+    
     private func cleanupOldBundles(keepVersions: Int) {
         let bundles = getAllBundles().sorted { bundle1, bundle2 in
             let time1 = bundle1["downloadTime"] as? Double ?? 0
@@ -542,40 +549,81 @@ class LiveUpdatePlugin {
     
     private func extractAndApplyBundle(_ bundleUrl: URL, bundleId: String) throws {
         let extractedPath = getUpdatesDirectory().appendingPathComponent(bundleId).appendingPathComponent("www")
-        
-        // Extract the zip bundle
-        try extractZipBundle(from: bundleUrl, to: extractedPath)
-        
-        // Update bundle info with extracted path
-        var bundleInfo = getAllBundles().first { $0["bundleId"] as? String == bundleId } ?? [:]
-        bundleInfo["extractedPath"] = extractedPath.path
-        bundleInfo["status"] = "READY"
-        saveBundleInfo(bundleInfo)
-        
-        // Configure WebView to use new path
-        configureWebViewPath(extractedPath.path)
+
+        do {
+            // Extract the zip bundle
+            try extractZipBundle(from: bundleUrl, to: extractedPath)
+
+            // Update bundle info with extracted path
+            var bundleInfo = getAllBundles().first { $0["bundleId"] as? String == bundleId } ?? [:]
+            bundleInfo["extractedPath"] = extractedPath.path
+            bundleInfo["status"] = "READY"
+            saveBundleInfo(bundleInfo)
+
+            // Configure WebView to use new path
+            configureWebViewPath(extractedPath.path)
+        } catch {
+            // Get the safe bundle path (current working bundle)
+            let safePath = UserDefaults.standard.string(forKey: "native_update_webview_path") ?? "/"
+
+            // Rollback to safe bundle
+            try? rollbackToSafeBundle(currentPath: extractedPath.path, safePath: safePath)
+
+            // Re-throw the error
+            throw error
+        }
     }
     
     private func extractZipBundle(from zipUrl: URL, to destinationUrl: URL) throws {
-        // Create destination directory
-        try FileManager.default.createDirectory(at: destinationUrl, withIntermediateDirectories: true)
-        
-        // Use FileManager to extract (requires iOS unzip library or manual implementation)
-        // For now, we'll use a simple file copy as placeholder
-        // In production, you would use a library like ZIPFoundation or SSZipArchive
-        
-        // This is a placeholder - in real implementation, use a proper unzip library
-        throw NSError(domain: "LiveUpdatePlugin", code: 5, userInfo: [
-            NSLocalizedDescriptionKey: "Unzip functionality not implemented. Please integrate a zip library like ZIPFoundation."
-        ])
+        // Ensure destination directory exists
+        try FileManager.default.createDirectory(at: destinationUrl, withIntermediateDirectories: true, attributes: nil)
+
+        // Extract the ZIP archive using ZIPFoundation
+        try FileManager.default.unzipItem(at: zipUrl, to: destinationUrl)
+
+        // Verify extraction succeeded by checking for index.html
+        let indexPath = destinationUrl.appendingPathComponent("index.html")
+        guard FileManager.default.fileExists(atPath: indexPath.path) else {
+            throw NSError(domain: "LiveUpdatePlugin", code: 6, userInfo: [
+                NSLocalizedDescriptionKey: "Bundle extraction failed: index.html not found in extracted bundle"
+            ])
+        }
+
+        // Clean up the ZIP file after successful extraction
+        try? FileManager.default.removeItem(at: zipUrl)
     }
     
     private func configureWebViewPath(_ path: String) {
         // Store the active bundle path
         UserDefaults.standard.set(path, forKey: "native_update_webview_path")
-        
-        // The actual WebView path configuration happens in the main plugin
-        // when the WebView is loaded or reloaded
+
+        // Configure Capacitor WebView to use the new bundle path
+        DispatchQueue.main.async { [weak self] in
+            guard let bridge = self?.plugin?.bridge else { return }
+
+            // Set the server base path to the extracted bundle directory
+            bridge.setServerBasePath(path)
+
+            // Optionally trigger a WebView reload (commented out by default)
+            // Uncomment if you want automatic reload after bundle extraction
+            // bridge.webView?.reload()
+        }
+    }
+
+    private func rollbackToSafeBundle(currentPath: String, safePath: String) throws {
+        // Remove the failed bundle directory
+        let currentUrl = URL(fileURLWithPath: currentPath)
+        try? FileManager.default.removeItem(at: currentUrl)
+
+        // Restore to the safe bundle
+        DispatchQueue.main.async { [weak self] in
+            guard let bridge = self?.plugin?.bridge else { return }
+            bridge.setServerBasePath(safePath)
+            bridge.webView?.reload()
+        }
+
+        // Update stored path
+        UserDefaults.standard.set(safePath, forKey: "native_update_webview_path")
     }
 }
 

package/ios/Plugin/NativeUpdatePlugin.swift

@@ -8,6 +8,7 @@ public class NativeUpdatePlugin: CAPPlugin {
     private var appReviewPlugin: AppReviewPlugin!
     private var backgroundUpdatePlugin: BackgroundUpdatePlugin!
     private var securityManager: SecurityManager!
+    private var isInitialized = false
     
     override public func load() {
         super.load()
@@ -27,6 +28,49 @@ public class NativeUpdatePlugin: CAPPlugin {
         liveUpdatePlugin.setStateChangeListener { [weak self] state in
             self?.notifyListeners("updateStateChanged", data: state)
         }
+        
+        // Set up app update event listener
+        appUpdatePlugin.setEventListener { [weak self] eventName, data in
+            self?.notifyListeners(eventName, data: data)
+        }
+    }
+    
+    @objc func initialize(_ call: CAPPluginCall) {
+        guard let config = call.getObject("config") else {
+            call.reject("Configuration object is required")
+            return
+        }
+        
+        do {
+            // Initialize with filesystem and preferences if provided
+            // In iOS, we typically don't need these as we use native APIs
+            
+            // Apply configuration
+            configure(call)
+            
+            isInitialized = true
+            call.resolve()
+        } catch {
+            call.reject("Initialization failed", error.localizedDescription)
+        }
+    }
+    
+    @objc func isInitialized(_ call: CAPPluginCall) {
+        call.resolve(["initialized": isInitialized])
+    }
+    
+    @objc func cleanup(_ call: CAPPluginCall) {
+        // Clean up any resources
+        liveUpdatePlugin.cleanup()
+        // Disable background updates through the plugin method
+        let disableCall = CAPPluginCall(
+            callbackId: "cleanup_disable",
+            options: [:],
+            success: { _ in },
+            error: { _ in }
+        )
+        backgroundUpdatePlugin.disableBackgroundUpdates(disableCall)
+        call.resolve()
     }
     
     @objc func configure(_ call: CAPPluginCall) {
@@ -88,6 +132,7 @@ public class NativeUpdatePlugin: CAPPlugin {
     
     @objc func reset(_ call: CAPPluginCall) {
         liveUpdatePlugin.reset(call)
+        isInitialized = false
     }
     
     @objc func current(_ call: CAPPluginCall) {