native-update 1.1.3 → 1.1.6

package/android/src/main/java/com/aoneahsan/nativeupdate/AppUpdatePlugin.kt

@@ -24,6 +24,7 @@ class AppUpdatePlugin(
     private val activity: Activity,
     private val context: Context
 ) {
+    private var eventListener: ((String, JSObject) -> Unit)? = null
     private val appUpdateManager: AppUpdateManager = AppUpdateManagerFactory.create(context)
     private var config: JSObject? = null
     private var updateInfo: AppUpdateInfo? = null
@@ -44,6 +45,10 @@ class AppUpdatePlugin(
         this.config = config
     }
     
+    fun setEventListener(listener: (String, JSObject) -> Unit) {
+        this.eventListener = listener
+    }
+    
     fun getAppUpdateInfo(call: PluginCall) {
         val appUpdateInfoTask = appUpdateManager.appUpdateInfo
         
@@ -66,6 +71,15 @@ class AppUpdatePlugin(
                 result.put("totalBytesToDownload", appUpdateInfo.totalBytesToDownload())
             }
             
+            // Emit available event if update is available
+            if (appUpdateInfo.updateAvailability() == UpdateAvailability.UPDATE_AVAILABLE) {
+                val availableData = JSObject()
+                availableData.put("currentVersion", getCurrentAppVersion())
+                availableData.put("availableVersion", appUpdateInfo.availableVersionCode().toString())
+                availableData.put("updatePriority", appUpdateInfo.updatePriority())
+                eventListener?.invoke("appUpdateAvailable", availableData)
+            }
+            
             call.resolve(result)
         }.addOnFailureListener { e ->
             call.reject("UPDATE_CHECK_FAILED", e.message)
@@ -174,10 +188,33 @@ class AppUpdatePlugin(
     }
     
     private fun handleInstallState(state: InstallState) {
+        // Emit state change event
+        val eventData = JSObject()
+        eventData.put("status", getInstallStatusString(state.installStatus()))
+        if (state.installError() != 0) {
+            eventData.put("installErrorCode", state.installError())
+        }
+        eventListener?.invoke("appUpdateStateChanged", eventData)
+        
+        // Emit progress event for downloads
+        if (state.installStatus() == InstallStatus.DOWNLOADING) {
+            val progressData = JSObject()
+            progressData.put("percent", if (state.totalBytesToDownload() > 0) 
+                ((state.bytesDownloaded() * 100) / state.totalBytesToDownload()).toInt() else 0)
+            progressData.put("bytesDownloaded", state.bytesDownloaded())
+            progressData.put("totalBytes", state.totalBytesToDownload())
+            eventListener?.invoke("appUpdateProgress", progressData)
+        }
+        
         when (state.installStatus()) {
             InstallStatus.DOWNLOADED -> {
                 // Update has been downloaded, prompt user to restart
                 popupSnackbarForCompleteUpdate()
+                
+                // Emit ready event
+                val readyData = JSObject()
+                readyData.put("message", "Update downloaded and ready to install")
+                eventListener?.invoke("appUpdateReady", readyData)
             }
             InstallStatus.INSTALLED -> {
                 // Update installed, cleanup
@@ -185,6 +222,10 @@ class AppUpdatePlugin(
             }
             InstallStatus.FAILED -> {
                 // Update failed
+                val failedData = JSObject()
+                failedData.put("error", "Update installation failed")
+                failedData.put("code", "INSTALL_FAILED")
+                eventListener?.invoke("appUpdateFailed", failedData)
             }
             else -> {
                 // Handle other states

package/android/src/main/java/com/aoneahsan/nativeupdate/LiveUpdatePlugin.kt

@@ -23,10 +23,13 @@ class LiveUpdatePlugin(
     private val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())
     private lateinit var okHttpClient: OkHttpClient
     private val securityManager = SecurityManager(context)
+    private val activeDownloads = mutableMapOf<String, Long>()
+    private var downloadManager: android.app.DownloadManager? = null
     
     init {
         // Initialize OkHttp with default settings
         okHttpClient = createOkHttpClient()
+        downloadManager = context.getSystemService(Context.DOWNLOAD_SERVICE) as? android.app.DownloadManager
     }
     
     private fun createOkHttpClient(): OkHttpClient {
@@ -495,6 +498,15 @@ class LiveUpdatePlugin(
         }
     }
     
+    fun cleanup() {
+        // Clean up any resources
+        // Cancel any ongoing downloads
+        activeDownloads.values.forEach { downloadId ->
+            downloadManager?.remove(downloadId)
+        }
+        activeDownloads.clear()
+    }
+    
     private fun markBundleAsVerified() {
         val prefs = context.getSharedPreferences("native_update", Context.MODE_PRIVATE)
         prefs.edit().putBoolean("current_bundle_verified", true).apply()

package/android/src/main/java/com/aoneahsan/nativeupdate/NativeUpdatePlugin.kt

@@ -23,6 +23,7 @@ class NativeUpdatePlugin : Plugin() {
     private lateinit var appReviewPlugin: AppReviewPlugin
     private lateinit var backgroundUpdatePlugin: BackgroundUpdatePlugin
     private lateinit var securityManager: SecurityManager
+    private var isInitialized = false
     
     override fun load() {
         super.load()
@@ -34,6 +35,11 @@ class NativeUpdatePlugin : Plugin() {
         backgroundUpdatePlugin = BackgroundUpdatePlugin()
         securityManager = SecurityManager(context)
         
+        // Set up app update event listener
+        appUpdatePlugin.setEventListener { eventName, data ->
+            notifyListeners(eventName, data)
+        }
+        
         // Register plugins with manager for background access
         BackgroundUpdateManager.registerLiveUpdatePlugin(liveUpdatePlugin)
         BackgroundUpdateManager.registerAppUpdatePlugin(appUpdatePlugin)
@@ -48,6 +54,45 @@ class NativeUpdatePlugin : Plugin() {
         }
     }
     
+    @PluginMethod
+    fun initialize(call: PluginCall) {
+        val config = call.getObject("config")
+        if (config == null) {
+            call.reject("Configuration object is required")
+            return
+        }
+        
+        try {
+            // Initialize with filesystem and preferences if provided
+            // In Android, we typically don't need these as we use native APIs
+            
+            // Apply configuration
+            configure(call)
+            
+            isInitialized = true
+            call.resolve()
+        } catch (e: Exception) {
+            call.reject("Initialization failed", e)
+        }
+    }
+    
+    @PluginMethod
+    fun isInitialized(call: PluginCall) {
+        call.resolve(JSObject().put("initialized", isInitialized))
+    }
+    
+    @PluginMethod
+    fun cleanup(call: PluginCall) {
+        try {
+            // Clean up any resources
+            liveUpdatePlugin.cleanup()
+            backgroundUpdatePlugin.disableBackgroundUpdates()
+            call.resolve()
+        } catch (e: Exception) {
+            call.reject("Cleanup failed", e)
+        }
+    }
+    
     @PluginMethod
     fun configure(call: PluginCall) {
         val config = call.getObject("config")
@@ -118,7 +163,13 @@ class NativeUpdatePlugin : Plugin() {
     
     @PluginMethod
     fun reset(call: PluginCall) {
-        liveUpdatePlugin.reset(call)
+        try {
+            // Reset plugin state
+            liveUpdatePlugin.reset(call)
+            isInitialized = false
+        } catch (e: Exception) {
+            call.reject("Reset failed", e)
+        }
     }
     
     @PluginMethod

package/backend-template/README.md

@@ -0,0 +1,56 @@
+# Minimal Backend Server Template
+
+This is a minimal backend server for testing Capacitor Native Update plugin.
+
+⚠️ **NOT FOR PRODUCTION USE** - This is only for development and testing!
+
+## Quick Start
+
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Start server:
+```bash
+npm start
+```
+
+Server runs on http://localhost:3000
+
+## API Endpoints
+
+### Check for Updates
+```
+GET /api/v1/check?version=1.0.0&channel=production&appId=com.example.app
+```
+
+### Upload Bundle
+```
+POST /api/v1/bundles
+Content-Type: multipart/form-data
+Fields:
+- bundle: ZIP file
+- version: 1.0.1
+- appId: com.example.app
+- channel: production
+- mandatory: false
+- releaseNotes: Bug fixes
+```
+
+### Download Bundle
+```
+GET /api/v1/bundles/bundle-1.0.1.zip
+```
+
+## Production Requirements
+
+For production, you need:
+- Real database (PostgreSQL, MongoDB, etc.)
+- Authentication & authorization
+- CDN for bundle distribution
+- Rate limiting
+- Monitoring & logging
+- SSL/TLS certificates
+- Load balancing
+- Backup strategy

package/backend-template/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "capacitor-update-server",
+  "version": "1.0.0",
+  "description": "Minimal backend server for Capacitor Native Update",
+  "type": "module",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "cors": "^2.8.5",
+    "multer": "^1.4.5-lts.1",
+    "crypto": "^1.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/backend-template/server.js

@@ -0,0 +1,121 @@
+import express from 'express';
+import cors from 'cors';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import multer from 'multer';
+import crypto from 'crypto';
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+// Ensure directories exist
+if (!existsSync('./bundles')) mkdirSync('./bundles');
+if (!existsSync('./data')) mkdirSync('./data');
+
+// Middleware
+app.use(cors());
+app.use(express.json());
+
+// Storage for bundles
+const storage = multer.diskStorage({
+  destination: './bundles',
+  filename: (req, file, cb) => {
+    const version = req.body.version || Date.now();
+    cb(null, `bundle-${version}.zip`);
+  }
+});
+
+const upload = multer({ storage });
+
+// In-memory database (use real DB in production)
+let versions = {};
+const versionsFile = './data/versions.json';
+
+// Load existing versions
+if (existsSync(versionsFile)) {
+  versions = JSON.parse(readFileSync(versionsFile, 'utf8'));
+}
+
+// Save versions
+function saveVersions() {
+  writeFileSync(versionsFile, JSON.stringify(versions, null, 2));
+}
+
+// Routes
+app.get('/api/v1/check', (req, res) => {
+  const { version, channel = 'production', appId } = req.query;
+  
+  const key = `${appId}-${channel}`;
+  const latest = versions[key];
+  
+  if (!latest) {
+    return res.json({ updateAvailable: false });
+  }
+  
+  res.json({
+    updateAvailable: latest.version !== version,
+    version: latest.version,
+    downloadUrl: `${req.protocol}://${req.get('host')}/api/v1/bundles/${latest.bundleId}`,
+    checksum: latest.checksum,
+    size: latest.size,
+    mandatory: latest.mandatory || false,
+    releaseNotes: latest.releaseNotes || 'Bug fixes and improvements'
+  });
+});
+
+app.post('/api/v1/bundles', upload.single('bundle'), (req, res) => {
+  const { version, channel = 'production', appId, mandatory, releaseNotes } = req.body;
+  
+  if (!req.file) {
+    return res.status(400).json({ error: 'No bundle file provided' });
+  }
+  
+  // Calculate checksum
+  const bundleData = readFileSync(req.file.path);
+  const checksum = crypto.createHash('sha256').update(bundleData).digest('hex');
+  
+  const bundleId = req.file.filename;
+  const key = `${appId}-${channel}`;
+  
+  versions[key] = {
+    version,
+    bundleId,
+    checksum,
+    size: req.file.size,
+    mandatory: mandatory === 'true',
+    releaseNotes,
+    uploadedAt: new Date().toISOString()
+  };
+  
+  saveVersions();
+  
+  res.json({
+    success: true,
+    version,
+    bundleId,
+    checksum
+  });
+});
+
+app.get('/api/v1/bundles/:bundleId', (req, res) => {
+  const bundlePath = join('./bundles', req.params.bundleId);
+  
+  if (!existsSync(bundlePath)) {
+    return res.status(404).json({ error: 'Bundle not found' });
+  }
+  
+  res.sendFile(bundlePath, { root: '.' });
+});
+
+app.get('/health', (req, res) => {
+  res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+
+app.listen(PORT, () => {
+  console.log(`Update server running on http://localhost:${PORT}`);
+  console.log('\nEndpoints:');
+  console.log(`- GET  /api/v1/check`);
+  console.log(`- POST /api/v1/bundles`);
+  console.log(`- GET  /api/v1/bundles/:bundleId`);
+  console.log(`- GET  /health`);
+});

package/cli/index.js

@@ -38,9 +38,11 @@ ${chalk.bold('Documentation:')}
   });
 
 // Bundle Management Commands
-program
+const bundleCmd = program
   .command('bundle')
-  .description('Bundle management commands')
+  .description('Bundle management commands');
+
+bundleCmd
   .command('create <webDir>')
   .alias('create-bundle')
   .description(`Create an update bundle from your web directory
@@ -63,8 +65,7 @@ ${chalk.bold('Examples:')}
     await createBundle(webDir, options);
   });
 
-program
-  .command('bundle')
+bundleCmd
   .command('sign <bundlePath>')
   .alias('sign-bundle')
   .description(`Sign an update bundle with your private key
@@ -82,8 +83,7 @@ ${chalk.bold('Examples:')}
     await signBundle(bundlePath, options);
   });
 
-program
-  .command('bundle')
+bundleCmd
   .command('verify <bundlePath>')
   .alias('verify-bundle')
   .description(`Verify a signed bundle with public key
@@ -97,9 +97,11 @@ ${chalk.bold('Example:')}
   });
 
 // Key Management Commands
-program
+const keysCmd = program
   .command('keys')
-  .description('Key management commands')
+  .description('Key management commands');
+
+keysCmd
   .command('generate')
   .alias('generate-keys')
   .description(`Generate a new key pair for bundle signing
@@ -122,9 +124,11 @@ ${chalk.bold('Examples:')}
   });
 
 // Server Commands
-program
+const serverCmd = program
   .command('server')
-  .description('Development server commands')
+  .description('Development server commands');
+
+serverCmd
   .command('start')
   .alias('start-server')
   .description('Start a local update server for testing')
@@ -158,9 +162,11 @@ ${chalk.bold('Examples:')}
   });
 
 // Backend Commands
-program
+const backendCmd = program
   .command('backend')
-  .description('Backend template commands')
+  .description('Backend template commands');
+
+backendCmd
   .command('create <type>')
   .alias('create-backend')
   .description(`Create a backend template (express, firebase, vercel)
@@ -183,9 +189,11 @@ ${chalk.bold('Examples:')}
   });
 
 // Config Commands
-program
+const configCmd = program
   .command('config')
-  .description('Configuration commands')
+  .description('Configuration commands');
+
+configCmd
   .command('check')
   .description('Validate your native-update configuration')
   .action(async () => {

package/dist/esm/core/event-emitter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Centralized event emitter for the Native Update plugin
+ */
+export declare class EventEmitter {
+    private static instance;
+    private listeners;
+    private constructor();
+    static getInstance(): EventEmitter;
+    /**
+     * Add a listener for an event
+     */
+    addListener(eventName: string, listener: (data: unknown) => void): () => void;
+    /**
+     * Emit an event to all listeners
+     */
+    emit(eventName: string, data: unknown): void;
+    /**
+     * Remove all listeners for a specific event
+     */
+    removeListeners(eventName: string): void;
+    /**
+     * Remove all listeners
+     */
+    removeAllListeners(): void;
+    /**
+     * Get the number of listeners for an event
+     */
+    listenerCount(eventName: string): number;
+    /**
+     * Get all event names that have listeners
+     */
+    eventNames(): string[];
+}

package/dist/esm/core/event-emitter.js

@@ -0,0 +1,75 @@
+/**
+ * Centralized event emitter for the Native Update plugin
+ */
+export class EventEmitter {
+    constructor() {
+        this.listeners = new Map();
+    }
+    static getInstance() {
+        if (!EventEmitter.instance) {
+            EventEmitter.instance = new EventEmitter();
+        }
+        return EventEmitter.instance;
+    }
+    /**
+     * Add a listener for an event
+     */
+    addListener(eventName, listener) {
+        if (!this.listeners.has(eventName)) {
+            this.listeners.set(eventName, new Set());
+        }
+        this.listeners.get(eventName).add(listener);
+        // Return remove function
+        return () => {
+            const listeners = this.listeners.get(eventName);
+            if (listeners) {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    this.listeners.delete(eventName);
+                }
+            }
+        };
+    }
+    /**
+     * Emit an event to all listeners
+     */
+    emit(eventName, data) {
+        const listeners = this.listeners.get(eventName);
+        if (listeners) {
+            listeners.forEach(listener => {
+                try {
+                    listener(data);
+                }
+                catch (error) {
+                    console.error(`Error in event listener for ${eventName}:`, error);
+                }
+            });
+        }
+    }
+    /**
+     * Remove all listeners for a specific event
+     */
+    removeListeners(eventName) {
+        this.listeners.delete(eventName);
+    }
+    /**
+     * Remove all listeners
+     */
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+    /**
+     * Get the number of listeners for an event
+     */
+    listenerCount(eventName) {
+        var _a;
+        return ((_a = this.listeners.get(eventName)) === null || _a === void 0 ? void 0 : _a.size) || 0;
+    }
+    /**
+     * Get all event names that have listeners
+     */
+    eventNames() {
+        return Array.from(this.listeners.keys());
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/esm/core/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../../../src/core/event-emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAY;IAIvB;QAFQ,cAAS,GAA8C,IAAI,GAAG,EAAE,CAAC;IAElD,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CACT,SAAiB,EACjB,QAAiC;QAEjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE7C,yBAAyB;QACzB,OAAO,GAAG,EAAE;YACV,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,SAAiB,EAAE,IAAa;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC3B,IAAI,CAAC;oBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB;;QAC7B,OAAO,CAAA,MAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,0CAAE,IAAI,KAAI,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/esm/core/plugin-manager.d.ts

@@ -4,6 +4,8 @@ import { SecurityValidator } from './security';
 import { BundleManager } from '../live-update/bundle-manager';
 import { DownloadManager } from '../live-update/download-manager';
 import { VersionManager } from '../live-update/version-manager';
+import { AppUpdateManager } from '../app-update/app-update-manager';
+import { EventEmitter } from './event-emitter';
 import { PluginInitConfig } from '../definitions';
 /**
  * Central manager for all plugin components
@@ -13,9 +15,11 @@ export declare class PluginManager {
     private readonly configManager;
     private readonly logger;
     private readonly securityValidator;
+    private readonly eventEmitter;
     private bundleManager;
     private downloadManager;
     private versionManager;
+    private appUpdateManager;
     private initialized;
     private constructor();
     static getInstance(): PluginManager;
@@ -55,6 +59,14 @@ export declare class PluginManager {
      * Get security validator
      */
     getSecurityValidator(): SecurityValidator;
+    /**
+     * Get app update manager
+     */
+    getAppUpdateManager(): AppUpdateManager;
+    /**
+     * Get event emitter
+     */
+    getEventEmitter(): EventEmitter;
     /**
      * Reset plugin state
      */
@@ -63,4 +75,8 @@ export declare class PluginManager {
      * Clean up resources
      */
     cleanup(): Promise<void>;
+    /**
+     * Setup event bridge between AppUpdateManager and central EventEmitter
+     */
+    private setupAppUpdateEventBridge;
 }