native-update 1.3.0 → 1.3.2

package/dist/esm/live-update/delta-processor.js

@@ -0,0 +1,212 @@
+/**
+ * Delta Processor
+ *
+ * Handles delta/patch-based updates for reduced download sizes.
+ * Uses a simple file-level patching strategy that works in JavaScript.
+ *
+ * For production, a WASM-based bsdiff/bspatch implementation can be added
+ * for better performance on binary files.
+ */
+import { Logger } from '../core/logger';
+import { ConfigManager } from '../core/config';
+import { DownloadError, ErrorCode, ValidationError } from '../core/errors';
+/**
+ * Delta processor for applying patch updates
+ */
+export class DeltaProcessor {
+    constructor() {
+        this.logger = Logger.getInstance();
+        this.configManager = ConfigManager.getInstance();
+    }
+    /**
+     * Download update with delta support
+     * Falls back to full download if delta fails
+     */
+    async downloadWithDelta(updateInfo, currentBundleData, onProgress) {
+        var _a;
+        const startTime = Date.now();
+        // Check if delta is available and we have current bundle
+        if (this.configManager.get('enableDeltaUpdates') &&
+            ((_a = updateInfo.delta) === null || _a === void 0 ? void 0 : _a.available) &&
+            updateInfo.delta.patchUrl &&
+            currentBundleData) {
+            try {
+                this.logger.info('Attempting delta update', {
+                    patchSize: updateInfo.delta.patchSize,
+                    fullSize: updateInfo.size,
+                });
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(10);
+                // Download delta patch
+                const patchData = await this.downloadPatch(updateInfo.delta.patchUrl);
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(50);
+                // Apply delta patch
+                const patchedBundle = await this.applyPatch(currentBundleData, patchData, updateInfo.delta.targetChecksum || updateInfo.checksum);
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(90);
+                // Verify result
+                const resultChecksum = await this.calculateChecksum(patchedBundle);
+                if (resultChecksum !== (updateInfo.delta.targetChecksum || updateInfo.checksum)) {
+                    throw new ValidationError(ErrorCode.CHECKSUM_MISMATCH, 'Delta patch result checksum mismatch');
+                }
+                onProgress === null || onProgress === void 0 ? void 0 : onProgress(100);
+                const duration = Date.now() - startTime;
+                this.logger.info('Delta update successful', {
+                    downloadSize: patchData.byteLength,
+                    resultSize: patchedBundle.byteLength,
+                    savings: `${Math.round((1 - patchData.byteLength / (updateInfo.size || patchedBundle.byteLength)) * 100)}%`,
+                    duration,
+                });
+                return {
+                    usedDelta: true,
+                    bundleData: patchedBundle,
+                    checksum: resultChecksum,
+                    downloadSize: patchData.byteLength,
+                    duration,
+                };
+            }
+            catch (error) {
+                this.logger.warn('Delta update failed, falling back to full download', { error });
+                // Fall through to full download
+            }
+        }
+        // Full download
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress(10);
+        if (!updateInfo.bundleUrl) {
+            throw new DownloadError(ErrorCode.DOWNLOAD_FAILED, 'No bundle URL provided');
+        }
+        const fullBundle = await this.downloadFull(updateInfo.bundleUrl, onProgress);
+        const duration = Date.now() - startTime;
+        const checksum = await this.calculateChecksum(fullBundle);
+        // Verify checksum
+        if (updateInfo.checksum && checksum !== updateInfo.checksum) {
+            throw new ValidationError(ErrorCode.CHECKSUM_MISMATCH, 'Full bundle checksum mismatch');
+        }
+        return {
+            usedDelta: false,
+            bundleData: fullBundle,
+            checksum,
+            downloadSize: fullBundle.byteLength,
+            duration,
+        };
+    }
+    /**
+     * Download a delta patch file
+     */
+    async downloadPatch(url) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new DownloadError(ErrorCode.DOWNLOAD_FAILED, `Failed to download delta patch: ${response.status}`);
+        }
+        return response.arrayBuffer();
+    }
+    /**
+     * Download full bundle
+     */
+    async downloadFull(url, onProgress) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new DownloadError(ErrorCode.DOWNLOAD_FAILED, `Failed to download bundle: ${response.status}`);
+        }
+        // If we can track progress
+        const contentLength = response.headers.get('content-length');
+        const totalBytes = contentLength ? parseInt(contentLength, 10) : 0;
+        if (totalBytes && response.body) {
+            const reader = response.body.getReader();
+            const chunks = [];
+            let receivedBytes = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+                receivedBytes += value.length;
+                if (onProgress) {
+                    const percent = Math.round((receivedBytes / totalBytes) * 90) + 10;
+                    onProgress(Math.min(percent, 99));
+                }
+            }
+            onProgress === null || onProgress === void 0 ? void 0 : onProgress(100);
+            // Combine chunks
+            const result = new Uint8Array(receivedBytes);
+            let offset = 0;
+            for (const chunk of chunks) {
+                result.set(chunk, offset);
+                offset += chunk.length;
+            }
+            return result.buffer;
+        }
+        // Simple download without progress
+        const data = await response.arrayBuffer();
+        onProgress === null || onProgress === void 0 ? void 0 : onProgress(100);
+        return data;
+    }
+    /**
+     * Apply a delta patch to create new bundle
+     *
+     * This is a simplified patch format using JSON metadata + file-level changes.
+     * For production binary patching, a WASM bspatch implementation would be used.
+     */
+    async applyPatch(currentBundle, patchData, _expectedChecksum) {
+        try {
+            // Try to parse as JSON patch (file-level patching)
+            const patchText = new TextDecoder().decode(patchData);
+            const patch = JSON.parse(patchText);
+            if (patch.type === 'file-level') {
+                return this.applyFileLevelPatch(currentBundle, patch);
+            }
+            // Binary patch format
+            return this.applyBinaryPatch(currentBundle, patchData);
+        }
+        catch (_a) {
+            // Treat as binary patch
+            return this.applyBinaryPatch(currentBundle, patchData);
+        }
+    }
+    /**
+     * Apply file-level patch (JSON format)
+     */
+    async applyFileLevelPatch(_currentBundle, _patch) {
+        // This would require JSZip on the client side
+        // For now, throw an error to fall back to full download
+        this.logger.debug('File-level patch not supported in plugin, falling back');
+        throw new Error('File-level patch not supported in plugin');
+    }
+    /**
+     * Apply binary patch (bsdiff format)
+     *
+     * NOTE: This is a placeholder. For production, use WASM-compiled bspatch.
+     */
+    async applyBinaryPatch(_currentBundle, _patchData) {
+        // Binary patching requires WASM implementation
+        // For now, throw an error to fall back to full download
+        this.logger.debug('Binary patch requires WASM module, falling back');
+        throw new Error('Binary patch not supported without WASM module');
+    }
+    /**
+     * Calculate SHA-256 checksum
+     */
+    async calculateChecksum(data) {
+        const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+    }
+    /**
+     * Verify checksum matches
+     */
+    async verifyChecksum(data, expectedChecksum) {
+        const actualChecksum = await this.calculateChecksum(data);
+        return actualChecksum.toLowerCase() === expectedChecksum.toLowerCase();
+    }
+    /**
+     * Check if delta updates are enabled
+     */
+    isDeltaEnabled() {
+        return this.configManager.get('enableDeltaUpdates');
+    }
+}
+/**
+ * Create delta processor instance
+ */
+export function createDeltaProcessor() {
+    return new DeltaProcessor();
+}
+//# sourceMappingURL=delta-processor.js.map

package/dist/esm/live-update/delta-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-processor.js","sourceRoot":"","sources":["../../../src/live-update/delta-processor.ts"],"names":[],"mappings":"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"}

package/dist/esm/live-update/rollout-checker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Rollout Checker
+ *
+ * Client-side rollout eligibility checking for staged deployments.
+ * Uses deterministic hashing for consistent rollout decisions.
+ */
+import type { RolloutConfig, DeviceInfo } from '../firestore/schema';
+/**
+ * Rollout eligibility result
+ */
+export interface RolloutEligibilityResult {
+    /** Whether device is eligible for the update */
+    eligible: boolean;
+    /** Reason for the eligibility decision */
+    reason: string;
+    /** Device's calculated percentile (0-100) */
+    devicePercentile?: number;
+    /** Current rollout percentage */
+    currentPercentage?: number;
+}
+/**
+ * Rollout checker for determining update eligibility
+ */
+export declare class RolloutChecker {
+    private readonly logger;
+    private readonly configManager;
+    private deviceInfoCache;
+    constructor();
+    /**
+     * Check if device is eligible for update based on rollout config
+     */
+    checkEligibility(rollout: RolloutConfig, deviceInfo: DeviceInfo): Promise<RolloutEligibilityResult>;
+    /**
+     * Check time window for rollout
+     */
+    private checkTimeWindow;
+    /**
+     * Check scheduled start time
+     */
+    private checkScheduled;
+    /**
+     * Check target segments
+     */
+    private checkSegments;
+    /**
+     * Calculate current rollout percentage based on schedule
+     */
+    private calculateCurrentPercentage;
+    /**
+     * Get deterministic percentile for device ID
+     * Uses SHA-256 hash for uniform distribution
+     */
+    getDevicePercentile(deviceId: string): Promise<number>;
+    /**
+     * Hash a string using SHA-256
+     */
+    private hashString;
+    /**
+     * Convert hash to percentile (0-100)
+     */
+    private hashToPercentile;
+    /**
+     * Compare semantic versions
+     */
+    private compareVersions;
+    /**
+     * Set cached device info
+     */
+    setDeviceInfo(deviceInfo: DeviceInfo): void;
+    /**
+     * Get cached device info
+     */
+    getDeviceInfo(): DeviceInfo | null;
+    /**
+     * Check if staged rollouts are enabled
+     */
+    isEnabled(): boolean;
+}
+/**
+ * Create rollout checker instance
+ */
+export declare function createRolloutChecker(): RolloutChecker;
+/**
+ * Collect device information for rollout eligibility
+ */
+export declare function collectDeviceInfo(): Promise<DeviceInfo>;

package/dist/esm/live-update/rollout-checker.js

@@ -0,0 +1,305 @@
+/**
+ * Rollout Checker
+ *
+ * Client-side rollout eligibility checking for staged deployments.
+ * Uses deterministic hashing for consistent rollout decisions.
+ */
+import { timestampToDate } from '../firestore/schema';
+import { Logger } from '../core/logger';
+import { ConfigManager } from '../core/config';
+/**
+ * Rollout checker for determining update eligibility
+ */
+export class RolloutChecker {
+    constructor() {
+        this.deviceInfoCache = null;
+        this.logger = Logger.getInstance();
+        this.configManager = ConfigManager.getInstance();
+    }
+    /**
+     * Check if device is eligible for update based on rollout config
+     */
+    async checkEligibility(rollout, deviceInfo) {
+        var _a;
+        // If rollouts are disabled in config, always eligible
+        if (!this.configManager.get('enableStagedRollouts')) {
+            return { eligible: true, reason: 'Staged rollouts disabled in config' };
+        }
+        // If rollout is not enabled, all devices are eligible
+        if (!rollout.enabled) {
+            return { eligible: true, reason: 'Rollout not enabled, all devices eligible' };
+        }
+        // Check time window
+        const timeCheck = this.checkTimeWindow(rollout);
+        if (!timeCheck.eligible) {
+            return timeCheck;
+        }
+        // Check scheduled rollout
+        if (((_a = rollout.schedule) === null || _a === void 0 ? void 0 : _a.type) === 'scheduled' && rollout.schedule.scheduledTime) {
+            const scheduledCheck = this.checkScheduled(rollout.schedule.scheduledTime);
+            if (!scheduledCheck.eligible) {
+                return scheduledCheck;
+            }
+        }
+        // Check target segments
+        if (rollout.targetSegments) {
+            const segmentCheck = this.checkSegments(rollout.targetSegments, deviceInfo);
+            if (!segmentCheck.eligible) {
+                return segmentCheck;
+            }
+        }
+        // Calculate current rollout percentage
+        const currentPercentage = this.calculateCurrentPercentage(rollout);
+        // Get device percentile
+        const devicePercentile = await this.getDevicePercentile(deviceInfo.deviceId);
+        // Check if device is in rollout percentage
+        if (devicePercentile > currentPercentage) {
+            return {
+                eligible: false,
+                reason: `Device percentile ${devicePercentile.toFixed(1)}% exceeds rollout ${currentPercentage}%`,
+                devicePercentile,
+                currentPercentage,
+            };
+        }
+        this.logger.debug('Device eligible for update', {
+            devicePercentile,
+            currentPercentage,
+        });
+        return {
+            eligible: true,
+            reason: 'Device eligible for update',
+            devicePercentile,
+            currentPercentage,
+        };
+    }
+    /**
+     * Check time window for rollout
+     */
+    checkTimeWindow(rollout) {
+        const now = Date.now();
+        const startTime = timestampToDate(rollout.startTime).getTime();
+        if (now < startTime) {
+            return {
+                eligible: false,
+                reason: `Rollout not started yet. Starts at ${new Date(startTime).toISOString()}`,
+            };
+        }
+        if (rollout.endTime) {
+            const endTime = timestampToDate(rollout.endTime).getTime();
+            if (now > endTime) {
+                return {
+                    eligible: false,
+                    reason: `Rollout ended at ${new Date(endTime).toISOString()}`,
+                };
+            }
+        }
+        return { eligible: true, reason: 'Within time window' };
+    }
+    /**
+     * Check scheduled start time
+     */
+    checkScheduled(scheduledTime) {
+        const now = Date.now();
+        const scheduled = timestampToDate(scheduledTime).getTime();
+        if (now < scheduled) {
+            return {
+                eligible: false,
+                reason: `Scheduled for ${new Date(scheduled).toISOString()}`,
+            };
+        }
+        return { eligible: true, reason: 'Scheduled time passed' };
+    }
+    /**
+     * Check target segments
+     */
+    checkSegments(segments, deviceInfo) {
+        // Platform check
+        if (segments.platforms && segments.platforms.length > 0) {
+            if (!segments.platforms.includes(deviceInfo.platform)) {
+                return {
+                    eligible: false,
+                    reason: `Platform ${deviceInfo.platform} not in target list: ${segments.platforms.join(', ')}`,
+                };
+            }
+        }
+        // App version checks
+        if (segments.minAppVersion) {
+            if (this.compareVersions(deviceInfo.appVersion, segments.minAppVersion) < 0) {
+                return {
+                    eligible: false,
+                    reason: `App version ${deviceInfo.appVersion} below minimum ${segments.minAppVersion}`,
+                };
+            }
+        }
+        if (segments.maxAppVersion) {
+            if (this.compareVersions(deviceInfo.appVersion, segments.maxAppVersion) > 0) {
+                return {
+                    eligible: false,
+                    reason: `App version ${deviceInfo.appVersion} above maximum ${segments.maxAppVersion}`,
+                };
+            }
+        }
+        // Device ID whitelist
+        if (segments.deviceIds && segments.deviceIds.length > 0) {
+            if (!segments.deviceIds.includes(deviceInfo.deviceId)) {
+                return {
+                    eligible: false,
+                    reason: 'Device not in whitelist',
+                };
+            }
+        }
+        // Region check
+        if (segments.regions && segments.regions.length > 0) {
+            if (!deviceInfo.region || !segments.regions.includes(deviceInfo.region)) {
+                return {
+                    eligible: false,
+                    reason: `Region ${deviceInfo.region || 'unknown'} not in target list: ${segments.regions.join(', ')}`,
+                };
+            }
+        }
+        return { eligible: true, reason: 'Segment checks passed' };
+    }
+    /**
+     * Calculate current rollout percentage based on schedule
+     */
+    calculateCurrentPercentage(rollout) {
+        if (!rollout.schedule || rollout.schedule.type !== 'gradual') {
+            return rollout.percentage;
+        }
+        const { gradualSteps, gradualInterval } = rollout.schedule;
+        if (!gradualSteps || !gradualInterval) {
+            return rollout.percentage;
+        }
+        const startTime = timestampToDate(rollout.startTime).getTime();
+        const elapsedHours = (Date.now() - startTime) / (1000 * 60 * 60);
+        const stepIndex = Math.floor(elapsedHours / gradualInterval);
+        if (stepIndex >= gradualSteps.length) {
+            return gradualSteps[gradualSteps.length - 1];
+        }
+        return gradualSteps[stepIndex];
+    }
+    /**
+     * Get deterministic percentile for device ID
+     * Uses SHA-256 hash for uniform distribution
+     */
+    async getDevicePercentile(deviceId) {
+        const hash = await this.hashString(deviceId);
+        return this.hashToPercentile(hash);
+    }
+    /**
+     * Hash a string using SHA-256
+     */
+    async hashString(input) {
+        const encoder = new TextEncoder();
+        const data = encoder.encode(input);
+        const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+    }
+    /**
+     * Convert hash to percentile (0-100)
+     */
+    hashToPercentile(hash) {
+        const hashInt = parseInt(hash.substring(0, 8), 16);
+        const maxInt = parseInt('ffffffff', 16);
+        return (hashInt / maxInt) * 100;
+    }
+    /**
+     * Compare semantic versions
+     */
+    compareVersions(v1, v2) {
+        const cleanV1 = v1.split('-')[0];
+        const cleanV2 = v2.split('-')[0];
+        const parts1 = cleanV1.split('.').map(Number);
+        const parts2 = cleanV2.split('.').map(Number);
+        for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+            const p1 = parts1[i] || 0;
+            const p2 = parts2[i] || 0;
+            if (p1 > p2)
+                return 1;
+            if (p1 < p2)
+                return -1;
+        }
+        return 0;
+    }
+    /**
+     * Set cached device info
+     */
+    setDeviceInfo(deviceInfo) {
+        this.deviceInfoCache = deviceInfo;
+    }
+    /**
+     * Get cached device info
+     */
+    getDeviceInfo() {
+        return this.deviceInfoCache;
+    }
+    /**
+     * Check if staged rollouts are enabled
+     */
+    isEnabled() {
+        return this.configManager.get('enableStagedRollouts');
+    }
+}
+/**
+ * Create rollout checker instance
+ */
+export function createRolloutChecker() {
+    return new RolloutChecker();
+}
+/**
+ * Collect device information for rollout eligibility
+ */
+export async function collectDeviceInfo() {
+    // Try to get Capacitor device info if available
+    let platform = 'web';
+    let osVersion = '';
+    try {
+        const { Device } = await import('@capacitor/device');
+        const info = await Device.getInfo();
+        platform = info.platform;
+        osVersion = info.osVersion;
+    }
+    catch (_a) {
+        // Running in web or Device plugin not available
+        platform = 'web';
+        osVersion = navigator.userAgent;
+    }
+    // Get or generate device ID
+    let deviceId = '';
+    try {
+        const { Preferences } = await import('@capacitor/preferences');
+        const { value } = await Preferences.get({ key: 'native_update_device_id' });
+        if (value) {
+            deviceId = value;
+        }
+        else {
+            deviceId = crypto.randomUUID();
+            await Preferences.set({ key: 'native_update_device_id', value: deviceId });
+        }
+    }
+    catch (_b) {
+        // Generate a session-based ID
+        deviceId = `web_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    // Get app version
+    let appVersion = '1.0.0';
+    try {
+        const { App } = await import('@capacitor/app');
+        const info = await App.getInfo();
+        appVersion = info.version;
+    }
+    catch (_c) {
+        // Use default version
+    }
+    return {
+        deviceId,
+        platform,
+        appVersion,
+        bundleVersion: '1.0.0', // Will be updated by the plugin
+        osVersion,
+        locale: navigator.language,
+        region: undefined, // Could be determined via geolocation or timezone
+    };
+}
+//# sourceMappingURL=rollout-checker.js.map

package/dist/esm/live-update/rollout-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollout-checker.js","sourceRoot":"","sources":["../../../src/live-update/rollout-checker.ts"],"names":[],"mappings":"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"}

package/dist/esm/live-update/version-manager.d.ts

@@ -1,4 +1,5 @@
 import type { LatestVersion } from '../definitions';
+import type { DeviceInfo, UpdateCheckResponse } from '../firestore/schema';
 /**
  * Manages version checking and comparison
  */
@@ -10,6 +11,8 @@ export declare class VersionManager {
     private readonly securityValidator;
     private preferences;
     private memoryCache;
+    private firestoreClient;
+    private manifestReader;
     constructor();
     /**
      * Compare two semantic versions
@@ -27,6 +30,15 @@ export declare class VersionManager {
      * Initialize the version manager
      */
     initialize(): Promise<void>;
+    /**
+     * Check for updates from Firestore backend
+     * Uses ManifestReader for efficient single-document reads
+     */
+    checkForUpdatesFromFirestore(currentVersion: string, deviceInfo: DeviceInfo): Promise<UpdateCheckResponse | null>;
+    /**
+     * Get the appropriate update checker based on backend type
+     */
+    checkForUpdatesAuto(currentVersion: string, deviceInfo?: DeviceInfo): Promise<LatestVersion | UpdateCheckResponse | null>;
     /**
      * Check for latest version from server
      */