native-update 1.3.0 → 1.3.2

package/dist/esm/__tests__/rollout-checker.test.js

@@ -0,0 +1,210 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { RolloutChecker } from '../live-update/rollout-checker';
+import { ConfigManager } from '../core/config';
+// Mock crypto.subtle
+const mockDigest = vi.fn();
+Object.defineProperty(global, 'crypto', {
+    value: {
+        subtle: {
+            digest: mockDigest,
+        },
+        randomUUID: () => 'test-uuid-1234',
+    },
+});
+describe('RolloutChecker', () => {
+    let rolloutChecker;
+    let configManager;
+    const mockDeviceInfo = {
+        deviceId: 'device-123',
+        platform: 'ios',
+        appVersion: '1.5.0',
+        bundleVersion: '1.0.0',
+        osVersion: '17.0',
+        locale: 'en-US',
+        region: 'US',
+    };
+    const createTimestamp = (date) => ({
+        seconds: Math.floor(date.getTime() / 1000),
+        nanoseconds: 0,
+    });
+    beforeEach(() => {
+        // Reset ConfigManager singleton
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        ConfigManager['instance'] = undefined;
+        configManager = ConfigManager.getInstance();
+        configManager.configure({ enableStagedRollouts: true });
+        rolloutChecker = new RolloutChecker();
+        // Mock crypto.subtle.digest to return predictable hash
+        mockDigest.mockResolvedValue(new Uint8Array([0x50, 0x00, 0x00, 0x00]).buffer); // ~31% percentile
+    });
+    describe('checkEligibility', () => {
+        it('should return eligible when rollouts are disabled in config', async () => {
+            configManager.configure({ enableStagedRollouts: false });
+            rolloutChecker = new RolloutChecker();
+            const rollout = {
+                enabled: true,
+                percentage: 10,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(true);
+            expect(result.reason).toBe('Staged rollouts disabled in config');
+        });
+        it('should return eligible when rollout is not enabled', async () => {
+            const rollout = {
+                enabled: false,
+                percentage: 10,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(true);
+            expect(result.reason).toBe('Rollout not enabled, all devices eligible');
+        });
+        it('should return ineligible when rollout has not started', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() + 86400000)), // Tomorrow
+                endTime: null,
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('Rollout not started yet');
+        });
+        it('should return ineligible when rollout has ended', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000 * 7)), // Week ago
+                endTime: createTimestamp(new Date(Date.now() - 86400000)), // Yesterday
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('Rollout ended');
+        });
+        it('should return ineligible when device percentile exceeds rollout percentage', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 10, // Only 10%
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('exceeds rollout');
+        });
+        it('should return eligible when device percentile is within rollout percentage', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 50, // 50% - device at ~31% should be eligible
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(true);
+            expect(result.reason).toBe('Device eligible for update');
+        });
+        it('should check platform segments', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+                targetSegments: {
+                    platforms: ['android'], // iOS device should be excluded
+                },
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('Platform ios not in target list');
+        });
+        it('should check minimum app version', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+                targetSegments: {
+                    minAppVersion: '2.0.0', // Device has 1.5.0
+                },
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('below minimum');
+        });
+        it('should check maximum app version', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+                targetSegments: {
+                    maxAppVersion: '1.0.0', // Device has 1.5.0
+                },
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('above maximum');
+        });
+        it('should check device ID whitelist', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+                targetSegments: {
+                    deviceIds: ['other-device', 'another-device'],
+                },
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toBe('Device not in whitelist');
+        });
+        it('should check region targeting', async () => {
+            const rollout = {
+                enabled: true,
+                percentage: 100,
+                startTime: createTimestamp(new Date(Date.now() - 86400000)),
+                endTime: null,
+                targetSegments: {
+                    regions: ['CA', 'UK'], // Device is in US
+                },
+            };
+            const result = await rolloutChecker.checkEligibility(rollout, mockDeviceInfo);
+            expect(result.eligible).toBe(false);
+            expect(result.reason).toContain('Region US not in target list');
+        });
+    });
+    describe('getDevicePercentile', () => {
+        it('should return consistent percentile for same device ID', async () => {
+            const percentile1 = await rolloutChecker.getDevicePercentile('device-123');
+            const percentile2 = await rolloutChecker.getDevicePercentile('device-123');
+            expect(percentile1).toBe(percentile2);
+        });
+        it('should return value between 0 and 100', async () => {
+            const percentile = await rolloutChecker.getDevicePercentile('device-123');
+            expect(percentile).toBeGreaterThanOrEqual(0);
+            expect(percentile).toBeLessThanOrEqual(100);
+        });
+    });
+    describe('device info caching', () => {
+        it('should cache and retrieve device info', () => {
+            expect(rolloutChecker.getDeviceInfo()).toBeNull();
+            rolloutChecker.setDeviceInfo(mockDeviceInfo);
+            expect(rolloutChecker.getDeviceInfo()).toEqual(mockDeviceInfo);
+        });
+    });
+    describe('isEnabled', () => {
+        it('should return config value for enableStagedRollouts', () => {
+            configManager.configure({ enableStagedRollouts: true });
+            rolloutChecker = new RolloutChecker();
+            expect(rolloutChecker.isEnabled()).toBe(true);
+            configManager.configure({ enableStagedRollouts: false });
+            rolloutChecker = new RolloutChecker();
+            expect(rolloutChecker.isEnabled()).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=rollout-checker.test.js.map

package/dist/esm/__tests__/rollout-checker.test.js.map

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

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

@@ -1,6 +1,11 @@
 import type { Filesystem } from '@capacitor/filesystem';
 import type { Preferences } from '@capacitor/preferences';
 import type { UpdateStrategy, ChecksumAlgorithm, SecurityConfig } from '../definitions';
+import type { FirestoreConfig } from '../firestore/schema';
+/**
+ * Backend type for update checking
+ */
+export type BackendType = 'http' | 'firestore';
 export interface PluginConfig {
     filesystem?: typeof Filesystem;
     preferences?: typeof Preferences;
@@ -16,6 +21,7 @@ export interface PluginConfig {
     enableLogging?: boolean;
     serverUrl?: string;
     channel?: string;
+    appId?: string;
     autoCheck?: boolean;
     autoUpdate?: boolean;
     updateStrategy?: UpdateStrategy;
@@ -32,6 +38,26 @@ export interface PluginConfig {
     packageName?: string;
     webReviewUrl?: string;
     minimumVersion?: string;
+    /**
+     * Backend type for update checking
+     * - 'http': Traditional HTTP server (default)
+     * - 'firestore': Google Firestore (free tier)
+     */
+    backendType?: BackendType;
+    /**
+     * Firestore configuration (required if backendType is 'firestore')
+     */
+    firestore?: FirestoreConfig;
+    /**
+     * Enable delta updates (binary patching)
+     * Reduces download size by 50-90%
+     */
+    enableDeltaUpdates?: boolean;
+    /**
+     * Enable staged rollouts
+     * Allows gradual deployment to a percentage of users
+     */
+    enableStagedRollouts?: boolean;
 }
 export declare class ConfigManager {
     private static instance;

package/dist/esm/core/config.js

@@ -24,6 +24,7 @@ export class ConfigManager {
             enableLogging: false,
             serverUrl: '',
             channel: 'production',
+            appId: '',
             autoCheck: true,
             autoUpdate: false,
             updateStrategy: 'background',
@@ -47,6 +48,11 @@ export class ConfigManager {
             packageName: '',
             webReviewUrl: '',
             minimumVersion: '1.0.0',
+            // Firestore backend configuration
+            backendType: 'http',
+            firestore: null,
+            enableDeltaUpdates: true,
+            enableStagedRollouts: true,
         };
     }
     configure(config) {

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,aAAa;IAIxB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEO,gBAAgB;QACtB,OAAO;YACL,UAAU,EAAE,IAAoC;YAChD,WAAW,EAAE,IAAqC;YAClD,OAAO,EAAE,EAAE;YACX,YAAY,EAAE,EAAE;YAChB,aAAa,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;YAC1C,eAAe,EAAE,KAAK,EAAE,aAAa;YACrC,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,IAAI,EAAE,WAAW;YAC7B,yBAAyB,EAAE,IAAI;YAC/B,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;YACjD,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,cAAc,EAAE,YAA8B;YAC9C,gBAAgB,EAAE,IAAI;YACtB,iBAAiB,EAAE,SAA8B;YACjD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;YAC/C,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,KAAK;aACzB;YACD,oBAAoB;YACpB,yBAAyB,EAAE,KAAK;YAChC,oBAAoB,EAAE,CAAC;YACvB,0BAA0B,EAAE,CAAC;YAC7B,aAAa,EAAE,KAAK;YACpB,2BAA2B;YAC3B,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAoB;QAC5B,IAAI,CAAC,MAAM,mCAAQ,IAAI,CAAC,MAAM,GAAK,MAAM,CAAE,CAAC;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,GAAG,CACD,GAAM;QAEN,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CACD,GAAM,EACN,KAAgC;QAEhC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,yBAAY,IAAI,CAAC,MAAM,EAAG;IAC5B,CAAC;IAED,YAAY;QACV,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC;CACF"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/config.ts"],"names":[],"mappings":"AA2EA,MAAM,OAAO,aAAa;IAIxB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEO,gBAAgB;QACtB,OAAO;YACL,UAAU,EAAE,IAAoC;YAChD,WAAW,EAAE,IAAqC;YAClD,OAAO,EAAE,EAAE;YACX,YAAY,EAAE,EAAE;YAChB,aAAa,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;YAC1C,eAAe,EAAE,KAAK,EAAE,aAAa;YACrC,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,IAAI,EAAE,WAAW;YAC7B,yBAAyB,EAAE,IAAI;YAC/B,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;YACjD,aAAa,EAAE,KAAK;YACpB,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,KAAK;YACjB,cAAc,EAAE,YAA8B;YAC9C,gBAAgB,EAAE,IAAI;YACtB,iBAAiB,EAAE,SAA8B;YACjD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;YAC/C,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,KAAK;aACzB;YACD,oBAAoB;YACpB,yBAAyB,EAAE,KAAK;YAChC,oBAAoB,EAAE,CAAC;YACvB,0BAA0B,EAAE,CAAC;YAC7B,aAAa,EAAE,KAAK;YACpB,2BAA2B;YAC3B,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,OAAO;YACvB,kCAAkC;YAClC,WAAW,EAAE,MAAqB;YAClC,SAAS,EAAE,IAAkC;YAC7C,kBAAkB,EAAE,IAAI;YACxB,oBAAoB,EAAE,IAAI;SAC3B,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAoB;QAC5B,IAAI,CAAC,MAAM,mCAAQ,IAAI,CAAC,MAAM,GAAK,MAAM,CAAE,CAAC;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,GAAG,CACD,GAAM;QAEN,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,GAAG,CACD,GAAM,EACN,KAAgC;QAEhC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,MAAM;QACJ,yBAAY,IAAI,CAAC,MAAM,EAAG;IAC5B,CAAC;IAED,YAAY;QACV,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/esm/firestore/firestore-client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Firestore Client
+ *
+ * Lightweight Firestore client for reading update manifests.
+ * Uses Firebase REST API to avoid SDK bundle size in the plugin.
+ *
+ * For the admin dashboard, the full Firebase SDK is used instead.
+ */
+import type { FirestoreConfig, ManifestDocument } from './schema';
+/**
+ * Firestore client for reading manifests
+ */
+export declare class FirestoreClient {
+    private readonly config;
+    private readonly logger;
+    private readonly cache;
+    private static instance;
+    constructor(config: FirestoreConfig);
+    /**
+     * Get or create singleton instance
+     */
+    static getInstance(config?: FirestoreConfig): FirestoreClient;
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Get the Firestore REST API base URL
+     */
+    private getBaseUrl;
+    /**
+     * Read a document from Firestore
+     */
+    getDocument<T>(collection: string, documentId: string): Promise<T | null>;
+    /**
+     * Get update manifest for current app and channel
+     */
+    getManifest(): Promise<ManifestDocument | null>;
+    /**
+     * Get manifest for a specific app and channel
+     */
+    getManifestFor(appId: string, channel: string): Promise<ManifestDocument | null>;
+    /**
+     * Parse Firestore REST document to TypeScript object
+     */
+    private parseDocument;
+    /**
+     * Parse a Firestore value to native JavaScript type
+     */
+    private parseValue;
+    /**
+     * Parse ISO timestamp to FirestoreTimestamp
+     */
+    private parseTimestamp;
+    /**
+     * Get value from cache
+     */
+    private getFromCache;
+    /**
+     * Set value in cache
+     */
+    private setCache;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): void;
+    /**
+     * Clear specific cache entry
+     */
+    clearCacheEntry(collection: string, documentId: string): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Get current configuration
+     */
+    getConfig(): FirestoreConfig;
+    /**
+     * Update channel
+     */
+    setChannel(channel: 'production' | 'staging' | 'development'): void;
+    /**
+     * Check if client is properly configured
+     */
+    isConfigured(): boolean;
+}
+/**
+ * Firestore error class
+ */
+export declare class FirestoreError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * Error codes for Firestore operations
+ */
+export declare const FirestoreErrorCode: {
+    readonly NOT_CONFIGURED: "NOT_CONFIGURED";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly INVALID_DOCUMENT: "INVALID_DOCUMENT";
+    readonly CACHE_ERROR: "CACHE_ERROR";
+};

package/dist/esm/firestore/firestore-client.js

@@ -0,0 +1,260 @@
+/**
+ * Firestore Client
+ *
+ * Lightweight Firestore client for reading update manifests.
+ * Uses Firebase REST API to avoid SDK bundle size in the plugin.
+ *
+ * For the admin dashboard, the full Firebase SDK is used instead.
+ */
+import { COLLECTIONS, getManifestId } from './schema';
+import { Logger } from '../core/logger';
+/**
+ * Firestore client for reading manifests
+ */
+export class FirestoreClient {
+    constructor(config) {
+        var _a;
+        this.cache = new Map();
+        this.config = {
+            projectId: config.projectId,
+            databaseId: config.databaseId || '(default)',
+            appId: config.appId,
+            channel: config.channel,
+            cacheDuration: config.cacheDuration || 5 * 60 * 1000, // 5 minutes default
+            enableOffline: (_a = config.enableOffline) !== null && _a !== void 0 ? _a : true,
+        };
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * Get or create singleton instance
+     */
+    static getInstance(config) {
+        if (!FirestoreClient.instance && config) {
+            FirestoreClient.instance = new FirestoreClient(config);
+        }
+        if (!FirestoreClient.instance) {
+            throw new Error('FirestoreClient not initialized. Call with config first.');
+        }
+        return FirestoreClient.instance;
+    }
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance() {
+        FirestoreClient.instance = null;
+    }
+    /**
+     * Get the Firestore REST API base URL
+     */
+    getBaseUrl() {
+        const db = this.config.databaseId;
+        return `https://firestore.googleapis.com/v1/projects/${this.config.projectId}/databases/${db}/documents`;
+    }
+    /**
+     * Read a document from Firestore
+     */
+    async getDocument(collection, documentId) {
+        const cacheKey = `${collection}/${documentId}`;
+        // Check cache first
+        const cached = this.getFromCache(cacheKey);
+        if (cached !== null) {
+            this.logger.debug('Firestore cache hit', { collection, documentId });
+            return cached;
+        }
+        const url = `${this.getBaseUrl()}/${collection}/${documentId}`;
+        try {
+            this.logger.debug('Fetching Firestore document', { url });
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (response.status === 404) {
+                this.logger.debug('Firestore document not found', {
+                    collection,
+                    documentId,
+                });
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`Firestore error: ${response.status} ${response.statusText}`);
+            }
+            const restDoc = (await response.json());
+            const data = this.parseDocument(restDoc);
+            // Cache the result
+            this.setCache(cacheKey, data);
+            return data;
+        }
+        catch (error) {
+            this.logger.error('Firestore fetch error', error);
+            // Try to return stale cache if available
+            const staleCache = this.getFromCache(cacheKey, true);
+            if (staleCache !== null) {
+                this.logger.warn('Using stale cache due to fetch error');
+                return staleCache;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get update manifest for current app and channel
+     */
+    async getManifest() {
+        const manifestId = getManifestId(this.config.appId, this.config.channel);
+        return this.getDocument(COLLECTIONS.MANIFESTS, manifestId);
+    }
+    /**
+     * Get manifest for a specific app and channel
+     */
+    async getManifestFor(appId, channel) {
+        const manifestId = getManifestId(appId, channel);
+        return this.getDocument(COLLECTIONS.MANIFESTS, manifestId);
+    }
+    /**
+     * Parse Firestore REST document to TypeScript object
+     */
+    parseDocument(doc) {
+        return this.parseValue({ mapValue: { fields: doc.fields } });
+    }
+    /**
+     * Parse a Firestore value to native JavaScript type
+     */
+    parseValue(value) {
+        if ('stringValue' in value) {
+            return value.stringValue;
+        }
+        if ('integerValue' in value) {
+            return parseInt(value.integerValue, 10);
+        }
+        if ('doubleValue' in value) {
+            return value.doubleValue;
+        }
+        if ('booleanValue' in value) {
+            return value.booleanValue;
+        }
+        if ('nullValue' in value) {
+            return null;
+        }
+        if ('timestampValue' in value) {
+            return this.parseTimestamp(value.timestampValue);
+        }
+        if ('mapValue' in value) {
+            const result = {};
+            const fields = value.mapValue.fields || {};
+            for (const [key, val] of Object.entries(fields)) {
+                result[key] = this.parseValue(val);
+            }
+            return result;
+        }
+        if ('arrayValue' in value) {
+            const values = value.arrayValue.values || [];
+            return values.map((v) => this.parseValue(v));
+        }
+        return null;
+    }
+    /**
+     * Parse ISO timestamp to FirestoreTimestamp
+     */
+    parseTimestamp(isoString) {
+        const date = new Date(isoString);
+        return {
+            seconds: Math.floor(date.getTime() / 1000),
+            nanoseconds: (date.getTime() % 1000) * 1000000,
+        };
+    }
+    /**
+     * Get value from cache
+     */
+    getFromCache(key, allowStale = false) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        const now = Date.now();
+        if (now < entry.expiresAt || allowStale) {
+            return entry.data;
+        }
+        // Cache expired
+        return null;
+    }
+    /**
+     * Set value in cache
+     */
+    setCache(key, data) {
+        const now = Date.now();
+        this.cache.set(key, {
+            data,
+            timestamp: now,
+            expiresAt: now + this.config.cacheDuration,
+        });
+    }
+    /**
+     * Clear all cached data
+     */
+    clearCache() {
+        this.cache.clear();
+        this.logger.debug('Firestore cache cleared');
+    }
+    /**
+     * Clear specific cache entry
+     */
+    clearCacheEntry(collection, documentId) {
+        const key = `${collection}/${documentId}`;
+        this.cache.delete(key);
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return Object.assign({}, this.config);
+    }
+    /**
+     * Update channel
+     */
+    setChannel(channel) {
+        this.config.channel = channel;
+        this.clearCache(); // Clear cache when channel changes
+    }
+    /**
+     * Check if client is properly configured
+     */
+    isConfigured() {
+        return !!(this.config.projectId &&
+            this.config.appId &&
+            this.config.channel);
+    }
+}
+FirestoreClient.instance = null;
+/**
+ * Firestore error class
+ */
+export class FirestoreError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'FirestoreError';
+    }
+}
+/**
+ * Error codes for Firestore operations
+ */
+export const FirestoreErrorCode = {
+    NOT_CONFIGURED: 'NOT_CONFIGURED',
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    NOT_FOUND: 'NOT_FOUND',
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    INVALID_DOCUMENT: 'INVALID_DOCUMENT',
+    CACHE_ERROR: 'CACHE_ERROR',
+};
+//# sourceMappingURL=firestore-client.js.map