native-update 1.0.0

package/dist/esm/core/cache-manager.js

@@ -0,0 +1,275 @@
+import { ConfigManager } from './config';
+import { Logger } from './logger';
+import { Directory, Encoding } from '@capacitor/filesystem';
+/**
+ * Manages caching with expiration for various data types
+ */
+export class CacheManager {
+    constructor() {
+        this.filesystem = null;
+        this.memoryCache = new Map();
+        this.CACHE_DIR = 'cache';
+        this.logger = Logger.getInstance();
+        this.configManager = ConfigManager.getInstance();
+    }
+    /**
+     * Initialize cache manager
+     */
+    async initialize() {
+        this.filesystem = this.configManager.get('filesystem');
+        if (!this.filesystem) {
+            throw new Error('Filesystem not configured');
+        }
+        // Create cache directory if it doesn't exist
+        try {
+            await this.filesystem.mkdir({
+                path: this.CACHE_DIR,
+                directory: Directory.Data,
+                recursive: true,
+            });
+        }
+        catch (error) {
+            this.logger.debug('Cache directory may already exist', error);
+        }
+        // Clean expired cache on initialization
+        await this.cleanExpiredCache();
+    }
+    /**
+     * Set cache entry with expiration
+     */
+    async set(key, data, ttlMs) {
+        const expiry = Date.now() + (ttlMs || this.configManager.get('cacheExpiration'));
+        const entry = {
+            data,
+            timestamp: Date.now(),
+            expiry,
+        };
+        // Update memory cache
+        this.memoryCache.set(key, entry);
+        // Persist to filesystem for larger data
+        if (this.shouldPersist(data)) {
+            await this.persistToFile(key, entry);
+        }
+        this.logger.debug('Cache entry set', { key, expiry: new Date(expiry) });
+    }
+    /**
+     * Get cache entry
+     */
+    async get(key) {
+        // Check memory cache first
+        const memEntry = this.memoryCache.get(key);
+        if (memEntry) {
+            if (Date.now() < memEntry.expiry) {
+                return memEntry.data;
+            }
+            else {
+                // Expired - remove from memory
+                this.memoryCache.delete(key);
+            }
+        }
+        // Check filesystem cache
+        const fileEntry = await this.loadFromFile(key);
+        if (fileEntry) {
+            if (Date.now() < fileEntry.expiry) {
+                // Update memory cache
+                this.memoryCache.set(key, fileEntry);
+                return fileEntry.data;
+            }
+            else {
+                // Expired - remove file
+                await this.removeFile(key);
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if cache entry exists and is valid
+     */
+    async has(key) {
+        const value = await this.get(key);
+        return value !== null;
+    }
+    /**
+     * Remove cache entry
+     */
+    async remove(key) {
+        this.memoryCache.delete(key);
+        await this.removeFile(key);
+        this.logger.debug('Cache entry removed', { key });
+    }
+    /**
+     * Clear all cache
+     */
+    async clear() {
+        this.memoryCache.clear();
+        // Remove cache directory
+        try {
+            await this.filesystem.rmdir({
+                path: this.CACHE_DIR,
+                directory: Directory.Data,
+                recursive: true,
+            });
+            // Recreate empty cache directory
+            await this.filesystem.mkdir({
+                path: this.CACHE_DIR,
+                directory: Directory.Data,
+                recursive: true,
+            });
+        }
+        catch (error) {
+            this.logger.warn('Failed to clear cache directory', error);
+        }
+        this.logger.info('Cache cleared');
+    }
+    /**
+     * Clean expired cache entries
+     */
+    async cleanExpiredCache() {
+        const now = Date.now();
+        let cleanedCount = 0;
+        // Clean memory cache
+        for (const [key, entry] of this.memoryCache) {
+            if (now >= entry.expiry) {
+                this.memoryCache.delete(key);
+                cleanedCount++;
+            }
+        }
+        // Clean filesystem cache
+        try {
+            const files = await this.filesystem.readdir({
+                path: this.CACHE_DIR,
+                directory: Directory.Data,
+            });
+            for (const file of files.files) {
+                const key = file.name.replace('.json', '');
+                const entry = await this.loadFromFile(key);
+                if (!entry || now >= entry.expiry) {
+                    await this.removeFile(key);
+                    cleanedCount++;
+                }
+            }
+        }
+        catch (error) {
+            this.logger.debug('Failed to clean filesystem cache', error);
+        }
+        if (cleanedCount > 0) {
+            this.logger.info('Cleaned expired cache entries', {
+                count: cleanedCount,
+            });
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async getStats() {
+        let fileEntries = 0;
+        let totalSize = 0;
+        try {
+            const files = await this.filesystem.readdir({
+                path: this.CACHE_DIR,
+                directory: Directory.Data,
+            });
+            fileEntries = files.files.length;
+            // Estimate size (this is approximate)
+            for (const file of files.files) {
+                const stat = await this.filesystem.stat({
+                    path: `${this.CACHE_DIR}/${file.name}`,
+                    directory: Directory.Data,
+                });
+                totalSize += stat.size || 0;
+            }
+        }
+        catch (error) {
+            this.logger.debug('Failed to get cache stats', error);
+        }
+        return {
+            memoryEntries: this.memoryCache.size,
+            fileEntries,
+            totalSize,
+        };
+    }
+    /**
+     * Cache bundle metadata
+     */
+    async cacheBundleMetadata(bundle) {
+        const key = `bundle_meta_${bundle.bundleId}`;
+        await this.set(key, bundle, 24 * 60 * 60 * 1000); // 24 hours
+    }
+    /**
+     * Get cached bundle metadata
+     */
+    async getCachedBundleMetadata(bundleId) {
+        const key = `bundle_meta_${bundleId}`;
+        return this.get(key);
+    }
+    /**
+     * Check if data should be persisted to filesystem
+     */
+    shouldPersist(data) {
+        // Persist objects and large strings
+        if (typeof data === 'object')
+            return true;
+        if (typeof data === 'string' && data.length > 1024)
+            return true;
+        return false;
+    }
+    /**
+     * Persist cache entry to file
+     */
+    async persistToFile(key, entry) {
+        if (!this.filesystem)
+            return;
+        try {
+            const path = `${this.CACHE_DIR}/${key}.json`;
+            const data = JSON.stringify(entry);
+            await this.filesystem.writeFile({
+                path,
+                data,
+                directory: Directory.Data,
+                encoding: Encoding.UTF8,
+            });
+        }
+        catch (error) {
+            this.logger.warn('Failed to persist cache to file', { key, error });
+        }
+    }
+    /**
+     * Load cache entry from file
+     */
+    async loadFromFile(key) {
+        if (!this.filesystem)
+            return null;
+        try {
+            const path = `${this.CACHE_DIR}/${key}.json`;
+            const result = await this.filesystem.readFile({
+                path,
+                directory: Directory.Data,
+                encoding: Encoding.UTF8,
+            });
+            return JSON.parse(result.data);
+        }
+        catch (_a) {
+            // File doesn't exist or is corrupted
+            return null;
+        }
+    }
+    /**
+     * Remove cache file
+     */
+    async removeFile(key) {
+        if (!this.filesystem)
+            return;
+        try {
+            const path = `${this.CACHE_DIR}/${key}.json`;
+            await this.filesystem.deleteFile({
+                path,
+                directory: Directory.Data,
+            });
+        }
+        catch (error) {
+            // File may not exist
+            this.logger.debug('Failed to remove cache file', { key, error });
+        }
+    }
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/esm/core/cache-manager.js.map

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

package/dist/esm/core/config.d.ts

@@ -0,0 +1,48 @@
+import type { Filesystem } from '@capacitor/filesystem';
+import type { Preferences } from '@capacitor/preferences';
+import type { UpdateStrategy, ChecksumAlgorithm, SecurityConfig } from '../definitions';
+export interface PluginConfig {
+    filesystem?: typeof Filesystem;
+    preferences?: typeof Preferences;
+    baseUrl?: string;
+    allowedHosts?: string[];
+    maxBundleSize?: number;
+    downloadTimeout?: number;
+    retryAttempts?: number;
+    retryDelay?: number;
+    enableSignatureValidation?: boolean;
+    publicKey?: string;
+    cacheExpiration?: number;
+    enableLogging?: boolean;
+    serverUrl?: string;
+    channel?: string;
+    autoCheck?: boolean;
+    autoUpdate?: boolean;
+    updateStrategy?: UpdateStrategy;
+    requireSignature?: boolean;
+    checksumAlgorithm?: ChecksumAlgorithm;
+    checkInterval?: number;
+    security?: SecurityConfig;
+    promptAfterPositiveEvents?: boolean;
+    maxPromptsPerVersion?: number;
+    minimumDaysSinceLastPrompt?: number;
+    isPremiumUser?: boolean;
+    appStoreId?: string;
+    iosAppId?: string;
+    packageName?: string;
+    webReviewUrl?: string;
+    minimumVersion?: string;
+}
+export declare class ConfigManager {
+    private static instance;
+    private config;
+    private constructor();
+    static getInstance(): ConfigManager;
+    private getDefaultConfig;
+    configure(config: PluginConfig): void;
+    private validateConfig;
+    get<K extends keyof Required<PluginConfig>>(key: K): Required<PluginConfig>[K];
+    set<K extends keyof Required<PluginConfig>>(key: K, value: Required<PluginConfig>[K]): void;
+    getAll(): Required<PluginConfig>;
+    isConfigured(): boolean;
+}

package/dist/esm/core/config.js

@@ -0,0 +1,83 @@
+export class ConfigManager {
+    constructor() {
+        this.config = this.getDefaultConfig();
+    }
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    getDefaultConfig() {
+        return {
+            filesystem: null,
+            preferences: null,
+            baseUrl: '',
+            allowedHosts: [],
+            maxBundleSize: 100 * 1024 * 1024, // 100MB
+            downloadTimeout: 30000, // 30 seconds
+            retryAttempts: 3,
+            retryDelay: 1000, // 1 second
+            enableSignatureValidation: true,
+            publicKey: '',
+            cacheExpiration: 24 * 60 * 60 * 1000, // 24 hours
+            enableLogging: false,
+            serverUrl: '',
+            channel: 'production',
+            autoCheck: true,
+            autoUpdate: false,
+            updateStrategy: 'background',
+            requireSignature: true,
+            checksumAlgorithm: 'SHA-256',
+            checkInterval: 24 * 60 * 60 * 1000, // 24 hours
+            security: {
+                enforceHttps: true,
+                validateInputs: true,
+                secureStorage: true,
+                logSecurityEvents: false,
+            },
+            // App review config
+            promptAfterPositiveEvents: false,
+            maxPromptsPerVersion: 1,
+            minimumDaysSinceLastPrompt: 7,
+            isPremiumUser: false,
+            // Platform-specific config
+            appStoreId: '',
+            iosAppId: '',
+            packageName: '',
+            webReviewUrl: '',
+            minimumVersion: '1.0.0',
+        };
+    }
+    configure(config) {
+        this.config = Object.assign(Object.assign({}, this.config), config);
+        this.validateConfig();
+    }
+    validateConfig() {
+        if (this.config.maxBundleSize <= 0) {
+            throw new Error('maxBundleSize must be greater than 0');
+        }
+        if (this.config.downloadTimeout <= 0) {
+            throw new Error('downloadTimeout must be greater than 0');
+        }
+        if (this.config.retryAttempts < 0) {
+            throw new Error('retryAttempts must be non-negative');
+        }
+        if (this.config.retryDelay < 0) {
+            throw new Error('retryDelay must be non-negative');
+        }
+    }
+    get(key) {
+        return this.config[key];
+    }
+    set(key, value) {
+        this.config[key] = value;
+    }
+    getAll() {
+        return Object.assign({}, this.config);
+    }
+    isConfigured() {
+        return !!(this.config.filesystem && this.config.preferences);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/esm/core/config.js.map

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

package/dist/esm/core/errors.d.ts

@@ -0,0 +1,51 @@
+export declare enum ErrorCode {
+    NOT_CONFIGURED = "NOT_CONFIGURED",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    MISSING_DEPENDENCY = "MISSING_DEPENDENCY",
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    DOWNLOAD_TIMEOUT = "DOWNLOAD_TIMEOUT",
+    INVALID_URL = "INVALID_URL",
+    UNAUTHORIZED_HOST = "UNAUTHORIZED_HOST",
+    BUNDLE_TOO_LARGE = "BUNDLE_TOO_LARGE",
+    CHECKSUM_MISMATCH = "CHECKSUM_MISMATCH",
+    SIGNATURE_INVALID = "SIGNATURE_INVALID",
+    VERSION_DOWNGRADE = "VERSION_DOWNGRADE",
+    INVALID_BUNDLE_FORMAT = "INVALID_BUNDLE_FORMAT",
+    STORAGE_FULL = "STORAGE_FULL",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    UPDATE_FAILED = "UPDATE_FAILED",
+    ROLLBACK_FAILED = "ROLLBACK_FAILED",
+    BUNDLE_NOT_READY = "BUNDLE_NOT_READY",
+    PLATFORM_NOT_SUPPORTED = "PLATFORM_NOT_SUPPORTED",
+    NATIVE_ERROR = "NATIVE_ERROR"
+}
+export declare class CapacitorNativeUpdateError extends Error {
+    code: ErrorCode;
+    message: string;
+    details?: unknown | undefined;
+    originalError?: Error | undefined;
+    constructor(code: ErrorCode, message: string, details?: unknown | undefined, originalError?: Error | undefined);
+    toJSON(): {
+        name: string;
+        code: ErrorCode;
+        message: string;
+        details: unknown;
+        stack: string | undefined;
+    };
+}
+export declare class ConfigurationError extends CapacitorNativeUpdateError {
+    constructor(message: string, details?: unknown);
+}
+export declare class DownloadError extends CapacitorNativeUpdateError {
+    constructor(code: ErrorCode, message: string, details?: unknown, originalError?: Error);
+}
+export declare class ValidationError extends CapacitorNativeUpdateError {
+    constructor(code: ErrorCode, message: string, details?: unknown);
+}
+export declare class StorageError extends CapacitorNativeUpdateError {
+    constructor(code: ErrorCode, message: string, details?: unknown, originalError?: Error);
+}
+export declare class UpdateError extends CapacitorNativeUpdateError {
+    constructor(code: ErrorCode, message: string, details?: unknown, originalError?: Error);
+}

package/dist/esm/core/errors.js

@@ -0,0 +1,80 @@
+export var ErrorCode;
+(function (ErrorCode) {
+    // Configuration errors
+    ErrorCode["NOT_CONFIGURED"] = "NOT_CONFIGURED";
+    ErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    ErrorCode["MISSING_DEPENDENCY"] = "MISSING_DEPENDENCY";
+    // Download errors
+    ErrorCode["DOWNLOAD_FAILED"] = "DOWNLOAD_FAILED";
+    ErrorCode["DOWNLOAD_TIMEOUT"] = "DOWNLOAD_TIMEOUT";
+    ErrorCode["INVALID_URL"] = "INVALID_URL";
+    ErrorCode["UNAUTHORIZED_HOST"] = "UNAUTHORIZED_HOST";
+    ErrorCode["BUNDLE_TOO_LARGE"] = "BUNDLE_TOO_LARGE";
+    // Validation errors
+    ErrorCode["CHECKSUM_MISMATCH"] = "CHECKSUM_MISMATCH";
+    ErrorCode["SIGNATURE_INVALID"] = "SIGNATURE_INVALID";
+    ErrorCode["VERSION_DOWNGRADE"] = "VERSION_DOWNGRADE";
+    ErrorCode["INVALID_BUNDLE_FORMAT"] = "INVALID_BUNDLE_FORMAT";
+    // Storage errors
+    ErrorCode["STORAGE_FULL"] = "STORAGE_FULL";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    // Update errors
+    ErrorCode["UPDATE_FAILED"] = "UPDATE_FAILED";
+    ErrorCode["ROLLBACK_FAILED"] = "ROLLBACK_FAILED";
+    ErrorCode["BUNDLE_NOT_READY"] = "BUNDLE_NOT_READY";
+    // Platform errors
+    ErrorCode["PLATFORM_NOT_SUPPORTED"] = "PLATFORM_NOT_SUPPORTED";
+    ErrorCode["NATIVE_ERROR"] = "NATIVE_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class CapacitorNativeUpdateError extends Error {
+    constructor(code, message, details, originalError) {
+        super(message);
+        this.code = code;
+        this.message = message;
+        this.details = details;
+        this.originalError = originalError;
+        this.name = 'CapacitorNativeUpdateError';
+        Object.setPrototypeOf(this, CapacitorNativeUpdateError.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            stack: this.stack,
+        };
+    }
+}
+export class ConfigurationError extends CapacitorNativeUpdateError {
+    constructor(message, details) {
+        super(ErrorCode.INVALID_CONFIG, message, details);
+        this.name = 'ConfigurationError';
+    }
+}
+export class DownloadError extends CapacitorNativeUpdateError {
+    constructor(code, message, details, originalError) {
+        super(code, message, details, originalError);
+        this.name = 'DownloadError';
+    }
+}
+export class ValidationError extends CapacitorNativeUpdateError {
+    constructor(code, message, details) {
+        super(code, message, details);
+        this.name = 'ValidationError';
+    }
+}
+export class StorageError extends CapacitorNativeUpdateError {
+    constructor(code, message, details, originalError) {
+        super(code, message, details, originalError);
+        this.name = 'StorageError';
+    }
+}
+export class UpdateError extends CapacitorNativeUpdateError {
+    constructor(code, message, details, originalError) {
+        super(code, message, details, originalError);
+        this.name = 'UpdateError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAgCX;AAhCD,WAAY,SAAS;IACnB,uBAAuB;IACvB,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,sDAAyC,CAAA;IAEzC,kBAAkB;IAClB,gDAAmC,CAAA;IACnC,kDAAqC,CAAA;IACrC,wCAA2B,CAAA;IAC3B,oDAAuC,CAAA;IACvC,kDAAqC,CAAA;IAErC,oBAAoB;IACpB,oDAAuC,CAAA;IACvC,oDAAuC,CAAA;IACvC,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;IAE/C,iBAAiB;IACjB,0CAA6B,CAAA;IAC7B,8CAAiC,CAAA;IACjC,oDAAuC,CAAA;IAEvC,gBAAgB;IAChB,4CAA+B,CAAA;IAC/B,gDAAmC,CAAA;IACnC,kDAAqC,CAAA;IAErC,kBAAkB;IAClB,8DAAiD,CAAA;IACjD,0CAA6B,CAAA;AAC/B,CAAC,EAhCW,SAAS,KAAT,SAAS,QAgCpB;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YACS,IAAe,EACf,OAAe,EACf,OAAiB,EACjB,aAAqB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAAQ;QACf,YAAO,GAAP,OAAO,CAAU;QACjB,kBAAa,GAAb,aAAa,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,0BAA0B;IAChE,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,0BAA0B;IAC3D,YACE,IAAe,EACf,OAAe,EACf,OAAiB,EACjB,aAAqB;QAErB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,0BAA0B;IAC7D,YAAY,IAAe,EAAE,OAAe,EAAE,OAAiB;QAC7D,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,0BAA0B;IAC1D,YACE,IAAe,EACf,OAAe,EACf,OAAiB,EACjB,aAAqB;QAErB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,0BAA0B;IACzD,YACE,IAAe,EACf,OAAe,EACf,OAAiB,EACjB,aAAqB;QAErB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/esm/core/logger.d.ts

@@ -0,0 +1,21 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export declare class Logger {
+    private static instance;
+    private configManager;
+    private context;
+    constructor(context?: string);
+    static getInstance(): Logger;
+    private shouldLog;
+    private sanitize;
+    log(message: string, data?: unknown): void;
+    private logWithLevel;
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, error?: Error | unknown): void;
+}