@zappzarapp/browser-utils 1.0.0

package/dist/offline/OfflineQueue.js

@@ -0,0 +1,339 @@
+import { BrowserUtilsError, generateUUID, CryptoError } from '../core';
+import { IndexedDBManager } from '../indexeddb';
+import { NetworkStatus } from '../network';
+export class OfflineQueueError extends BrowserUtilsError {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause);
+        this.code = code;
+    }
+    static notSupported() {
+        return new OfflineQueueError('NOT_SUPPORTED', 'OfflineQueue requires IndexedDB support which is not available');
+    }
+    static databaseError(operation, cause) {
+        return new OfflineQueueError('DATABASE_ERROR', `Database operation "${operation}" failed`, cause);
+    }
+    static processorError(cause) {
+        return new OfflineQueueError('PROCESSOR_ERROR', 'Queue item processor failed', cause);
+    }
+    static cryptoUnavailable() {
+        return new OfflineQueueError('CRYPTO_UNAVAILABLE', 'Crypto API is not available. Secure random ID generation requires crypto.randomUUID() or crypto.getRandomValues()');
+    }
+    static queueDestroyed() {
+        return new OfflineQueueError('QUEUE_DESTROYED', 'Queue has been destroyed');
+    }
+}
+const STORE_NAME = 'queue';
+const DB_VERSION = 1;
+function generateId() {
+    try {
+        return generateUUID();
+    }
+    catch (e) {
+        if (e instanceof CryptoError) {
+            throw OfflineQueueError.cryptoUnavailable();
+        }
+        throw e;
+    }
+}
+function lastWriteWins() {
+    return 'keep-local';
+}
+export const OfflineQueue = {
+    isSupported() {
+        return IndexedDBManager.isSupported();
+    },
+    async create(config) {
+        if (!OfflineQueue.isSupported()) {
+            throw OfflineQueueError.notSupported();
+        }
+        const { name, processor, conflictResolver = lastWriteWins, maxRetries = 3, syncDelay = 1000, autoSync = true, rateLimit, } = config;
+        let db;
+        try {
+            db = await IndexedDBManager.open({
+                name: `offline-queue-${name}`,
+                version: DB_VERSION,
+                stores: {
+                    [STORE_NAME]: {
+                        keyPath: 'id',
+                        indexes: {
+                            byPriority: { keyPath: 'priority' },
+                            byCreatedAt: { keyPath: 'createdAt' },
+                        },
+                    },
+                },
+            });
+        }
+        catch (e) {
+            throw OfflineQueueError.databaseError('open', e);
+        }
+        let destroyed = false;
+        let syncing = false;
+        let syncTimeout = null;
+        const operationTimestamps = [];
+        const syncHandlers = new Set();
+        const errorHandlers = new Set();
+        const conflictHandlers = new Set();
+        const emitSync = (item) => {
+            syncHandlers.forEach((handler) => handler(item));
+        };
+        const emitError = (error, item) => {
+            errorHandlers.forEach((handler) => handler(error, item));
+        };
+        const emitConflict = (resolution, local, remote) => {
+            conflictHandlers.forEach((handler) => handler(resolution, local, remote));
+        };
+        const sortItems = (items) => {
+            return items.sort((a, b) => {
+                if (a.priority !== b.priority) {
+                    return a.priority - b.priority;
+                }
+                return a.createdAt - b.createdAt;
+            });
+        };
+        const checkRateLimit = () => {
+            if (!rateLimit) {
+                return true;
+            }
+            const now = Date.now();
+            const { windowMs, maxRequestsPerWindow } = rateLimit;
+            const cutoff = now - windowMs;
+            while (operationTimestamps.length > 0 && operationTimestamps[0] < cutoff) {
+                operationTimestamps.shift();
+            }
+            return operationTimestamps.length < maxRequestsPerWindow;
+        };
+        const recordOperation = () => {
+            if (!rateLimit) {
+                return;
+            }
+            operationTimestamps.push(Date.now());
+        };
+        const calculateRateLimitDelay = () => {
+            if (!rateLimit || operationTimestamps.length === 0) {
+                return 0;
+            }
+            const now = Date.now();
+            const { windowMs } = rateLimit;
+            const oldestTimestamp = operationTimestamps[0];
+            const timeUntilExpiry = oldestTimestamp + windowMs - now;
+            return Math.max(1, timeUntilExpiry);
+        };
+        const delay = (ms) => {
+            return new Promise((resolve) => setTimeout(resolve, ms));
+        };
+        const processItem = async (item) => {
+            try {
+                await processor(item.data);
+                await db.delete(STORE_NAME, item.id);
+                emitSync(item);
+                recordOperation();
+                return true;
+            }
+            catch (e) {
+                const newRetryCount = item.retryCount + 1;
+                const errorMessage = e instanceof Error ? e.message : String(e);
+                if (newRetryCount >= maxRetries) {
+                    await db.delete(STORE_NAME, item.id);
+                    emitError(OfflineQueueError.processorError(e), item);
+                    return false;
+                }
+                const updatedItem = {
+                    ...item,
+                    retryCount: newRetryCount,
+                    lastError: errorMessage,
+                };
+                await db.put(STORE_NAME, updatedItem);
+                emitError(OfflineQueueError.processorError(e), updatedItem);
+                return false;
+            }
+        };
+        const syncAll = async () => {
+            if (destroyed || syncing || !NetworkStatus.isOnline()) {
+                return;
+            }
+            syncing = true;
+            try {
+                const items = await db.getAll(STORE_NAME);
+                const sorted = sortItems([...items]);
+                for (const item of sorted) {
+                    if (destroyed || !NetworkStatus.isOnline()) {
+                        break;
+                    }
+                    if (rateLimit && !checkRateLimit()) {
+                        const delayMs = calculateRateLimitDelay();
+                        await delay(delayMs);
+                        if (!checkRateLimit()) {
+                            scheduleSync();
+                            break;
+                        }
+                    }
+                    await processItem(item);
+                }
+            }
+            finally {
+                syncing = false;
+            }
+        };
+        const scheduleSync = () => {
+            if (destroyed || syncTimeout) {
+                return;
+            }
+            syncTimeout = setTimeout(() => {
+                syncTimeout = null;
+                void syncAll();
+            }, syncDelay);
+        };
+        let networkCleanup = null;
+        if (autoSync) {
+            networkCleanup = NetworkStatus.onOnline(() => {
+                scheduleSync();
+            });
+            if (NetworkStatus.isOnline()) {
+                scheduleSync();
+            }
+        }
+        const checkDestroyed = () => {
+            if (destroyed) {
+                throw OfflineQueueError.queueDestroyed();
+            }
+        };
+        return {
+            get name() {
+                return name;
+            },
+            async add(data, priority = 0) {
+                checkDestroyed();
+                const item = {
+                    id: generateId(),
+                    data,
+                    createdAt: Date.now(),
+                    retryCount: 0,
+                    priority,
+                };
+                try {
+                    await db.add(STORE_NAME, item);
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('add', e);
+                }
+                if (autoSync && NetworkStatus.isOnline()) {
+                    scheduleSync();
+                }
+                return item;
+            },
+            async remove(id) {
+                checkDestroyed();
+                try {
+                    const existing = await db.get(STORE_NAME, id);
+                    if (!existing) {
+                        return false;
+                    }
+                    await db.delete(STORE_NAME, id);
+                    return true;
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('remove', e);
+                }
+            },
+            async peek() {
+                checkDestroyed();
+                try {
+                    const items = await db.getAll(STORE_NAME);
+                    if (items.length === 0) {
+                        return undefined;
+                    }
+                    const sorted = sortItems([...items]);
+                    return sorted[0];
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('peek', e);
+                }
+            },
+            async clear() {
+                checkDestroyed();
+                try {
+                    await db.clear(STORE_NAME);
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('clear', e);
+                }
+            },
+            async size() {
+                checkDestroyed();
+                try {
+                    return await db.count(STORE_NAME);
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('size', e);
+                }
+            },
+            async getAll() {
+                checkDestroyed();
+                try {
+                    const items = await db.getAll(STORE_NAME);
+                    return sortItems([...items]);
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('getAll', e);
+                }
+            },
+            async getStats() {
+                checkDestroyed();
+                try {
+                    const items = await db.getAll(STORE_NAME);
+                    const failedCount = items.filter((item) => item.retryCount > 0).length;
+                    return {
+                        size: items.length,
+                        failedCount,
+                        isSyncing: syncing,
+                        isOnline: NetworkStatus.isOnline(),
+                    };
+                }
+                catch (e) {
+                    throw OfflineQueueError.databaseError('getStats', e);
+                }
+            },
+            async sync() {
+                checkDestroyed();
+                await syncAll();
+            },
+            onSync(handler) {
+                syncHandlers.add(handler);
+                return () => syncHandlers.delete(handler);
+            },
+            onError(handler) {
+                errorHandlers.add(handler);
+                return () => errorHandlers.delete(handler);
+            },
+            onConflict(handler) {
+                conflictHandlers.add(handler);
+                return () => conflictHandlers.delete(handler);
+            },
+            resolveConflict(local, remote) {
+                const resolution = conflictResolver(local, remote);
+                emitConflict(resolution, local, remote);
+                return resolution;
+            },
+            destroy() {
+                if (destroyed) {
+                    return;
+                }
+                destroyed = true;
+                if (syncTimeout) {
+                    clearTimeout(syncTimeout);
+                    syncTimeout = null;
+                }
+                if (networkCleanup) {
+                    networkCleanup();
+                    networkCleanup = null;
+                }
+                db.close();
+                syncHandlers.clear();
+                errorHandlers.clear();
+                conflictHandlers.clear();
+            },
+        };
+    },
+};
+//# sourceMappingURL=OfflineQueue.js.map

package/dist/offline/OfflineQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineQueue.js","sourceRoot":"","sources":["../../src/offline/OfflineQueue.ts"],"names":[],"mappings":"AAiOA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAkB,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAA0B,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmB3C,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IAE3C;IADX,YACW,IAA2B,EACpC,OAAe,EACf,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAJb,SAAI,GAAJ,IAAI,CAAuB;IAKtC,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,iBAAiB,CAC1B,eAAe,EACf,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,SAAiB,EAAE,KAAe;QACrD,OAAO,IAAI,iBAAiB,CAC1B,gBAAgB,EAChB,uBAAuB,SAAS,UAAU,EAC1C,KAAK,CACN,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,KAAe;QACnC,OAAO,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,CAAC,iBAAiB;QACtB,OAAO,IAAI,iBAAiB,CAC1B,oBAAoB,EACpB,mHAAmH,CACpH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;IAC9E,CAAC;CACF;AAwMD,MAAM,UAAU,GAAG,OAAO,CAAC;AAC3B,MAAM,UAAU,GAAG,CAAC,CAAC;AAMrB,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,WAAW,EAAE,CAAC;YAC7B,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;QAC9C,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAKD,SAAS,aAAa;IACpB,OAAO,YAAY,CAAC;AACtB,CAAC;AAMD,MAAM,CAAC,MAAM,YAAY,GAAG;IAc1B,WAAW;QACT,OAAO,gBAAgB,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAiDD,KAAK,CAAC,MAAM,CAAI,MAA6B;QAC3C,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC;YAChC,MAAM,iBAAiB,CAAC,YAAY,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,EACJ,IAAI,EACJ,SAAS,EACT,gBAAgB,GAAG,aAAa,EAChC,UAAU,GAAG,CAAC,EACd,SAAS,GAAG,IAAI,EAChB,QAAQ,GAAG,IAAI,EACf,SAAS,GACV,GAAG,MAAM,CAAC;QAGX,IAAI,EAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC;gBAC/B,IAAI,EAAE,iBAAiB,IAAI,EAAE;gBAC7B,OAAO,EAAE,UAAU;gBACnB,MAAM,EAAE;oBACN,CAAC,UAAU,CAAC,EAAE;wBACZ,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE;4BACP,UAAU,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;4BACnC,WAAW,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;yBACtC;qBACF;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;QAGD,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,WAAW,GAAyC,IAAI,CAAC;QAG7D,MAAM,mBAAmB,GAAa,EAAE,CAAC;QAGzC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;QACjD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAsB,CAAC;QAGvD,MAAM,QAAQ,GAAG,CAAC,IAAkB,EAAQ,EAAE;YAC5C,YAAY,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC;QAGF,MAAM,SAAS,GAAG,CAAC,KAAwB,EAAE,IAAkB,EAAQ,EAAE;YACvE,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QAGF,MAAM,YAAY,GAAG,CAAC,UAAiC,EAAE,KAAQ,EAAE,MAAS,EAAQ,EAAE;YACpF,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC;QAGF,MAAM,SAAS,GAAG,CAAC,KAAqB,EAAkB,EAAE;YAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAC9B,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;gBACjC,CAAC;gBACD,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAGF,MAAM,cAAc,GAAG,GAAY,EAAE;YACnC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAC;YAGrD,MAAM,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC;YAC9B,OAAO,mBAAmB,CAAC,MAAM,GAAG,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAE,GAAG,MAAM,EAAE,CAAC;gBAC1E,mBAAmB,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;YAGD,OAAO,mBAAmB,CAAC,MAAM,GAAG,oBAAoB,CAAC;QAC3D,CAAC,CAAC;QAGF,MAAM,eAAe,GAAG,GAAS,EAAE;YACjC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YACD,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC;QAGF,MAAM,uBAAuB,GAAG,GAAW,EAAE;YAC3C,IAAI,CAAC,SAAS,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;YAC/B,MAAM,eAAe,GAAG,mBAAmB,CAAC,CAAC,CAAE,CAAC;YAChD,MAAM,eAAe,GAAG,eAAe,GAAG,QAAQ,GAAG,GAAG,CAAC;YAGzD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;QACtC,CAAC,CAAC;QAGF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE;YAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QAGF,MAAM,WAAW,GAAG,KAAK,EAAE,IAAkB,EAAoB,EAAE;YACjE,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAE3B,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAGf,eAAe,EAAE,CAAC;gBAElB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC1C,MAAM,YAAY,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAEhE,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;oBAEhC,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;oBACrC,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;oBACrD,OAAO,KAAK,CAAC;gBACf,CAAC;gBAGD,MAAM,WAAW,GAAiB;oBAChC,GAAG,IAAI;oBACP,UAAU,EAAE,aAAa;oBACzB,SAAS,EAAE,YAAY;iBACxB,CAAC;gBAEF,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;gBACtC,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC,CAAC;QAGF,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,SAAS,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,OAAO,GAAG,IAAI,CAAC;YAEf,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,UAAU,CAAC,CAAC;gBACxD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;gBAErC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAE1B,IAAI,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;wBAC3C,MAAM;oBACR,CAAC;oBAGD,IAAI,SAAS,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;wBAEnC,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;wBAC1C,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;wBAErB,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;4BAEtB,YAAY,EAAE,CAAC;4BACf,MAAM;wBACR,CAAC;oBACH,CAAC;oBAED,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC,CAAC;QAGF,MAAM,YAAY,GAAG,GAAS,EAAE;YAC9B,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,WAAW,GAAG,IAAI,CAAC;gBACnB,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC;QAGF,IAAI,cAAc,GAAqB,IAAI,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE;gBAC3C,YAAY,EAAE,CAAC;YACjB,CAAC,CAAC,CAAC;YAGH,IAAI,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC7B,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAGD,MAAM,cAAc,GAAG,GAAS,EAAE;YAChC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,iBAAiB,CAAC,cAAc,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC;QAEF,OAAO;YACL,IAAI,IAAI;gBACN,OAAO,IAAI,CAAC;YACd,CAAC;YAED,KAAK,CAAC,GAAG,CAAC,IAAO,EAAE,QAAQ,GAAG,CAAC;gBAC7B,cAAc,EAAE,CAAC;gBAEjB,MAAM,IAAI,GAAiB;oBACzB,EAAE,EAAE,UAAU,EAAE;oBAChB,IAAI;oBACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,UAAU,EAAE,CAAC;oBACb,QAAQ;iBACT,CAAC;gBAEF,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAClD,CAAC;gBAGD,IAAI,QAAQ,IAAI,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;oBACzC,YAAY,EAAE,CAAC;gBACjB,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;YAED,KAAK,CAAC,MAAM,CAAC,EAAU;gBACrB,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,GAAG,CAAe,UAAU,EAAE,EAAE,CAAC,CAAC;oBAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;oBAChC,OAAO,IAAI,CAAC;gBACd,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,IAAI;gBACR,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,UAAU,CAAC,CAAC;oBACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACvB,OAAO,SAAS,CAAC;oBACnB,CAAC;oBACD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;oBACrC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,KAAK;gBACT,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,IAAI;gBACR,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,MAAM;gBACV,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,UAAU,CAAC,CAAC;oBACxD,OAAO,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,QAAQ;gBACZ,cAAc,EAAE,CAAC;gBAEjB,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,UAAU,CAAC,CAAC;oBACxD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;oBAEvE,OAAO;wBACL,IAAI,EAAE,KAAK,CAAC,MAAM;wBAClB,WAAW;wBACX,SAAS,EAAE,OAAO;wBAClB,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;qBACnC,CAAC;gBACJ,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,iBAAiB,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAED,KAAK,CAAC,IAAI;gBACR,cAAc,EAAE,CAAC;gBACjB,MAAM,OAAO,EAAE,CAAC;YAClB,CAAC;YAED,MAAM,CAAC,OAAuB;gBAC5B,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC1B,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,CAAC,OAAwB;gBAC9B,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3B,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,CAAC;YAED,UAAU,CAAC,OAA2B;gBACpC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,OAAO,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;YAED,eAAe,CAAC,KAAQ,EAAE,MAAS;gBACjC,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBACnD,YAAY,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBACxC,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,OAAO;gBACL,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO;gBACT,CAAC;gBAED,SAAS,GAAG,IAAI,CAAC;gBAGjB,IAAI,WAAW,EAAE,CAAC;oBAChB,YAAY,CAAC,WAAW,CAAC,CAAC;oBAC1B,WAAW,GAAG,IAAI,CAAC;gBACrB,CAAC;gBAGD,IAAI,cAAc,EAAE,CAAC;oBACnB,cAAc,EAAE,CAAC;oBACjB,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;gBAGD,EAAE,CAAC,KAAK,EAAE,CAAC;gBAGX,YAAY,CAAC,KAAK,EAAE,CAAC;gBACrB,aAAa,CAAC,KAAK,EAAE,CAAC;gBACtB,gBAAgB,CAAC,KAAK,EAAE,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;CACO,CAAC"}

package/dist/offline/index.d.ts

@@ -0,0 +1,2 @@
+export { OfflineQueue, OfflineQueueError, type OfflineQueueErrorCode, type ConflictResolution, type ConflictResolver, type ItemProcessor, type QueueItem, type OfflineQueueConfig, type QueueStats, type SyncHandler, type ErrorHandler, type ConflictHandler, type OfflineQueueInstance, } from './OfflineQueue.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/offline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/offline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/offline/index.js

@@ -0,0 +1,2 @@
+export { OfflineQueue, OfflineQueueError, } from './OfflineQueue.js';
+//# sourceMappingURL=index.js.map

package/dist/offline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/offline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,GAYlB,MAAM,mBAAmB,CAAC"}

package/dist/performance/PerformanceMonitor.d.ts

@@ -0,0 +1,29 @@
+import type { CleanupFn } from '../core';
+export interface PerformanceMetrics {
+    readonly fcp?: number;
+    readonly lcp?: number;
+    readonly fid?: number;
+    readonly cls?: number;
+    readonly inp?: number;
+    readonly ttfb?: number;
+}
+export type MetricType = 'fcp' | 'lcp' | 'fid' | 'cls' | 'inp';
+export type MetricHandler = (value: number) => void;
+export interface PerformanceMonitorInstance {
+    isSupported(): boolean;
+    mark(name: string): void;
+    measure(name: string, startMark?: string, endMark?: string): PerformanceMeasure | undefined;
+    getMetrics(): PerformanceMetrics;
+    getEntries(type?: string): PerformanceEntryList;
+    onMetric(type: MetricType, handler: MetricHandler): CleanupFn;
+    clearMarks(name?: string): void;
+    clearMeasures(name?: string): void;
+    getTTFB(): number | undefined;
+    getFCP(): number | undefined;
+    _reset(): void;
+}
+export declare const PerformanceMonitor: {
+    readonly isSupported: () => boolean;
+    readonly create: () => PerformanceMonitorInstance;
+};
+//# sourceMappingURL=PerformanceMonitor.d.ts.map

package/dist/performance/PerformanceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMonitor.d.ts","sourceRoot":"","sources":["../../src/performance/PerformanceMonitor.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzC,MAAM,WAAW,kBAAkB;IAEjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAK/D,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAKpD,MAAM,WAAW,0BAA0B;IAEzC,WAAW,IAAI,OAAO,CAAC;IAEvB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE5F,UAAU,IAAI,kBAAkB,CAAC;IAEjC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAEhD,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;IAE9D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAE9B,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC;IAE7B,MAAM,IAAI,IAAI,CAAC;CAChB;AA+DD,eAAO,MAAM,kBAAkB;gCAId,OAAO;2BAaZ,0BAA0B;CAqQ5B,CAAC"}

package/dist/performance/PerformanceMonitor.js

@@ -0,0 +1,259 @@
+function getEntryTypeForMetric(metric) {
+    switch (metric) {
+        case 'fcp':
+            return 'paint';
+        case 'lcp':
+            return 'largest-contentful-paint';
+        case 'fid':
+            return 'first-input';
+        case 'cls':
+            return 'layout-shift';
+        case 'inp':
+            return 'event';
+    }
+}
+function extractMetricValue(metric, entry) {
+    switch (metric) {
+        case 'fcp':
+            if (entry.name === 'first-contentful-paint') {
+                return entry.startTime;
+            }
+            return undefined;
+        case 'lcp':
+            return entry.startTime;
+        case 'fid':
+            if ('processingStart' in entry && typeof entry.processingStart === 'number') {
+                return entry.processingStart - entry.startTime;
+            }
+            return undefined;
+        case 'cls':
+            if ('hadRecentInput' in entry && entry.hadRecentInput === false && 'value' in entry) {
+                return entry.value;
+            }
+            return undefined;
+        case 'inp':
+            if ('duration' in entry && typeof entry.duration === 'number' && entry.duration > 0) {
+                return entry.duration;
+            }
+            return undefined;
+    }
+}
+function supportsEntryType(entryType) {
+    try {
+        const supportedTypes = PerformanceObserver.supportedEntryTypes;
+        return Array.isArray(supportedTypes) && supportedTypes.includes(entryType);
+    }
+    catch {
+        return false;
+    }
+}
+export const PerformanceMonitor = {
+    isSupported() {
+        return typeof performance !== 'undefined' && typeof performance.mark === 'function';
+    },
+    create() {
+        let collectedMetrics = {};
+        const activeObservers = new Map();
+        const metricHandlers = new Map();
+        function updateCollectedMetrics(metric, value) {
+            if (metric === 'cls') {
+                const currentCls = collectedMetrics.cls ?? 0;
+                collectedMetrics = { ...collectedMetrics, cls: currentCls + value };
+            }
+            else if (metric === 'inp') {
+                const currentInp = collectedMetrics.inp ?? 0;
+                if (value > currentInp) {
+                    collectedMetrics = { ...collectedMetrics, inp: value };
+                }
+            }
+            else {
+                collectedMetrics = { ...collectedMetrics, [metric]: value };
+            }
+        }
+        function notifyHandlers(metric, value) {
+            const handlers = metricHandlers.get(metric);
+            if (!handlers) {
+                return;
+            }
+            const finalValue = metric === 'cls'
+                ? (collectedMetrics.cls ?? value)
+                : metric === 'inp'
+                    ? (collectedMetrics.inp ?? value)
+                    : value;
+            for (const handler of handlers) {
+                handler(finalValue);
+            }
+        }
+        function processEntry(metric, entry) {
+            const value = extractMetricValue(metric, entry);
+            if (value === undefined) {
+                return;
+            }
+            updateCollectedMetrics(metric, value);
+            notifyHandlers(metric, value);
+        }
+        function createObserverForMetric(metric) {
+            const entryType = getEntryTypeForMetric(metric);
+            if (!supportsEntryType(entryType)) {
+                return undefined;
+            }
+            try {
+                const observer = new PerformanceObserver((list) => {
+                    for (const entry of list.getEntries()) {
+                        processEntry(metric, entry);
+                    }
+                });
+                const observeOptions = { type: entryType, buffered: true };
+                if (metric === 'inp') {
+                    observeOptions.durationThreshold = 16;
+                }
+                observer.observe(observeOptions);
+                return observer;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        const instance = {
+            isSupported() {
+                return PerformanceMonitor.isSupported();
+            },
+            mark(name) {
+                if (!instance.isSupported()) {
+                    return;
+                }
+                performance.mark(name);
+            },
+            measure(name, startMark, endMark) {
+                if (!instance.isSupported()) {
+                    return undefined;
+                }
+                try {
+                    return performance.measure(name, startMark, endMark);
+                }
+                catch {
+                    return undefined;
+                }
+            },
+            getMetrics() {
+                if (!instance.isSupported()) {
+                    return {};
+                }
+                if (collectedMetrics.ttfb === undefined) {
+                    const ttfb = instance.getTTFB();
+                    if (ttfb !== undefined) {
+                        collectedMetrics = { ...collectedMetrics, ttfb };
+                    }
+                }
+                if (collectedMetrics.fcp === undefined) {
+                    const fcp = instance.getFCP();
+                    if (fcp !== undefined) {
+                        collectedMetrics = { ...collectedMetrics, fcp };
+                    }
+                }
+                return { ...collectedMetrics };
+            },
+            getEntries(type) {
+                if (!instance.isSupported()) {
+                    return [];
+                }
+                if (type !== undefined) {
+                    return performance.getEntriesByType(type);
+                }
+                return performance.getEntries();
+            },
+            onMetric(type, handler) {
+                if (typeof PerformanceObserver === 'undefined') {
+                    return () => { };
+                }
+                let handlers = metricHandlers.get(type);
+                if (!handlers) {
+                    handlers = new Set();
+                    metricHandlers.set(type, handlers);
+                }
+                handlers.add(handler);
+                if (!activeObservers.has(type)) {
+                    const observer = createObserverForMetric(type);
+                    if (observer) {
+                        activeObservers.set(type, observer);
+                    }
+                }
+                const currentValue = collectedMetrics[type];
+                if (currentValue !== undefined) {
+                    handler(currentValue);
+                }
+                return () => {
+                    const handlersSet = metricHandlers.get(type);
+                    if (handlersSet) {
+                        handlersSet.delete(handler);
+                        if (handlersSet.size === 0) {
+                            const observer = activeObservers.get(type);
+                            if (observer) {
+                                observer.disconnect();
+                                activeObservers.delete(type);
+                            }
+                            metricHandlers.delete(type);
+                        }
+                    }
+                };
+            },
+            clearMarks(name) {
+                if (!instance.isSupported()) {
+                    return;
+                }
+                if (name !== undefined) {
+                    performance.clearMarks(name);
+                }
+                else {
+                    performance.clearMarks();
+                }
+            },
+            clearMeasures(name) {
+                if (!instance.isSupported()) {
+                    return;
+                }
+                if (name !== undefined) {
+                    performance.clearMeasures(name);
+                }
+                else {
+                    performance.clearMeasures();
+                }
+            },
+            getTTFB() {
+                if (!instance.isSupported()) {
+                    return undefined;
+                }
+                const entries = performance.getEntriesByType('navigation');
+                if (entries.length > 0) {
+                    const nav = entries[0];
+                    if (nav && nav.responseStart > 0) {
+                        return nav.responseStart;
+                    }
+                }
+                return undefined;
+            },
+            getFCP() {
+                if (!instance.isSupported()) {
+                    return undefined;
+                }
+                const entries = performance.getEntriesByType('paint');
+                for (const entry of entries) {
+                    if (entry.name === 'first-contentful-paint') {
+                        return entry.startTime;
+                    }
+                }
+                return undefined;
+            },
+            _reset() {
+                collectedMetrics = {};
+                for (const observer of activeObservers.values()) {
+                    observer.disconnect();
+                }
+                activeObservers.clear();
+                metricHandlers.clear();
+            },
+        };
+        return instance;
+    },
+};
+//# sourceMappingURL=PerformanceMonitor.js.map