@budarin/pluggable-serviceworker 1.0.1 → 1.0.3

package/README.md

@@ -1,4 +1,4 @@
-# @vadimbudarin/pluggable-serviceworker
+# @budarin/pluggable-serviceworker
 
 🔌 Расширяемый через плагины Service Worker
 
@@ -15,13 +15,13 @@
 ## 📦 Установка
 
 ```bash
-npm install @vadimbudarin/pluggable-serviceworker
+npm install @budarin/pluggable-serviceworker
 ```
 
 или
 
 ```bash
-pnpm add @vadimbudarin/pluggable-serviceworker
+pnpm add @budarin/pluggable-serviceworker
 ```
 
 ## 🚀 Быстрый старт
@@ -30,7 +30,7 @@ pnpm add @vadimbudarin/pluggable-serviceworker
 
 ```typescript
 // sw.js
-import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+import { initializeServiceWorker } from '@budarin/pluggable-serviceworker';
 
 // Простой плагин для кеширования
 const cachePlugin = {
@@ -54,7 +54,7 @@ initializeServiceWorker([cachePlugin]);
 ### Использование с приоритетами
 
 ```typescript
-import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+import { initializeServiceWorker } from '@budarin/pluggable-serviceworker';
 
 const authPlugin = {
     name: 'auth-plugin',
@@ -98,7 +98,7 @@ initializeServiceWorker([authPlugin, cachePlugin, loggingPlugin]);
 ### Обработка ошибок
 
 ```typescript
-import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+import { initializeServiceWorker } from '@budarin/pluggable-serviceworker';
 
 const config = {
     onError: (error, event) => {
@@ -142,8 +142,9 @@ interface ServiceWorkerPlugin {
     activate?: (event: ExtendableEvent) => void | Promise<void>;
     fetch?: (event: FetchEvent) => Promise<Response | null>;
     message?: (event: MessageEvent) => void;
-    sync?: (event: SyncEvent) => void;
-    push?: (event: PushEvent) => void;
+    sync?: (event: SyncEvent) => void | Promise<void>; // Фоновая синхронизация
+    periodicsync?: (event: PeriodicSyncEvent) => void | Promise<void>; // Периодическая синхронизация
+    push?: (event: PushEvent) => void | Promise<void>; // Может быть асинхронным
 }
 ```
 
@@ -218,7 +219,7 @@ const cachePlugin = {
 const notificationPlugin = {
     name: 'notifications',
 
-    push: (event) => {
+    push: async (event) => {
         const data = event.data?.json() || {};
 
         const options = {
@@ -229,7 +230,7 @@ const notificationPlugin = {
             data: data.url ? { url: data.url } : undefined,
         };
 
-        self.registration.showNotification(
+        await self.registration.showNotification(
             data.title || 'Уведомление',
             options
         );
@@ -250,9 +251,19 @@ const notificationPlugin = {
 const backgroundSyncPlugin = {
     name: 'background-sync',
 
-    sync: (event) => {
-        if (event.tag === 'background-sync') {
-            event.waitUntil(doBackgroundSync());
+    sync: async (event) => {
+        // Тег 'sync-data' регистрируется через:
+        // await self.registration.sync.register('sync-data');
+        if (event.tag === 'sync-data') {
+            await doBackgroundSync();
+        }
+    },
+
+    periodicsync: async (event) => {
+        // Тег 'content-sync' регистрируется через:
+        // await self.registration.periodicSync.register('content-sync', { minInterval: 24 * 60 * 60 * 1000 });
+        if (event.tag === 'content-sync') {
+            await doPeriodicSync();
         }
     },
 };
@@ -275,6 +286,38 @@ async function doBackgroundSync() {
         }
     }
 }
+
+async function doPeriodicSync() {
+    // Периодическая синхронизация данных
+    try {
+        const response = await fetch('/api/sync');
+        const data = await response.json();
+
+        // Сохранение данных в кеш или IndexedDB
+        await updateLocalData(data);
+
+        console.log('Периодическая синхронизация завершена');
+    } catch (error) {
+        console.error('Ошибка периодической синхронизации:', error);
+    }
+}
+
+// Регистрация синхронизации из основного потока (main thread):
+//
+// // Фоновая синхронизация (одноразовая)
+// navigator.serviceWorker.ready.then(registration => {
+//     return registration.sync.register('sync-data');
+// });
+//
+// // Периодическая синхронизация (требует разрешения)
+// navigator.serviceWorker.ready.then(async registration => {
+//     const status = await navigator.permissions.query({ name: 'periodic-background-sync' });
+//     if (status.state === 'granted') {
+//         await registration.periodicSync.register('content-sync', {
+//             minInterval: 24 * 60 * 60 * 1000 // 24 часа
+//         });
+//     }
+// });
 ```
 
 ## 🎯 Порядок выполнения
@@ -298,6 +341,111 @@ const plugins = [
 // Порядок выполнения: first → second → third → fourth → fifth
 ```
 
+## ⚡ Логика выполнения обработчиков
+
+Разные типы событий Service Worker обрабатываются по-разному в зависимости от их специфики:
+
+### 🔄 Параллельное выполнение
+
+**События:** `install`, `activate`, `message`, `sync`, `periodicsync`
+
+Все обработчики выполняются **одновременно** с помощью `Promise.all()`:
+
+```typescript
+// Все плагины инициализируются параллельно
+const installPlugin1 = {
+    name: 'cache',
+    install: async () => {
+        /* кеширование */
+    },
+};
+const installPlugin2 = {
+    name: 'db',
+    install: async () => {
+        /* инициализация БД */
+    },
+};
+
+// Оба install обработчика выполнятся одновременно
+```
+
+**Почему параллельно:**
+
+- **install/activate**: Все плагины должны инициализироваться независимо
+- **message**: Все плагины должны получить сообщение одновременно
+- **sync**: Разные задачи синхронизации независимы (синхронизация данных + кеша)
+- **periodicsync**: Периодические задачи независимы друг от друга
+
+### ➡️ Последовательное выполнение
+
+**События:** `fetch`, `push`
+
+Обработчики выполняются **по очереди** до первого успешного результата:
+
+#### Fetch - с прерыванием цепочки
+
+```typescript
+const authPlugin = {
+    name: 'auth',
+    priority: 1,
+    fetch: async (event) => {
+        if (needsAuth(event.request)) {
+            return new Response('Unauthorized', { status: 401 }); // Прерывает цепочку
+        }
+        return null; // Передает следующему плагину
+    },
+};
+
+const cachePlugin = {
+    name: 'cache',
+    priority: 2,
+    fetch: async (event) => {
+        return await caches.match(event.request); // Может вернуть Response или null
+    },
+};
+
+// Выполнение: auth → cache → fetch(event.request) если все вернули null
+```
+
+#### Push - без прерывания
+
+```typescript
+const notificationPlugin = {
+    name: 'notifications',
+    push: async (event) => {
+        await self.registration.showNotification('Уведомление');
+        // Не прерывает выполнение других плагинов
+    },
+};
+
+const analyticsPlugin = {
+    name: 'analytics',
+    push: async (event) => {
+        await sendPushAnalytics(event.data);
+        // Выполнится после notifications
+    },
+};
+
+// Все push обработчики выполнятся последовательно
+```
+
+**Почему последовательно:**
+
+- **fetch**: Нужен только один ответ, первый успешный прерывает цепочку
+- **push**: Избегает конфликтов уведомлений, но все плагины должны обработать событие
+
+### 📋 Сводная таблица
+
+| Событие        | Выполнение      | Прерывание | Причина                          |
+| -------------- | --------------- | ---------- | -------------------------------- |
+| `install`      | Параллельно     | Нет        | Независимая инициализация        |
+| `activate`     | Параллельно     | Нет        | Независимая активация            |
+| `fetch`        | Последовательно | Да         | Нужен один ответ                 |
+| `message`      | Параллельно     | Нет        | Все получают сообщение           |
+| `sync`         | Параллельно     | Нет        | Независимые задачи               |
+| `periodicsync` | Параллельно     | Нет        | Независимые периодические задачи |
+| `push`         | Последовательно | Нет        | Избегание конфликтов             |
+
 ## 🛡️ Обработка ошибок
 
 - Ошибки в плагинах автоматически перехватываются

package/dist/index.d.ts

@@ -2,9 +2,13 @@ interface SyncEvent extends ExtendableEvent {
     readonly tag: string;
     readonly lastChance: boolean;
 }
+interface PeriodicSyncEvent extends ExtendableEvent {
+    readonly tag: string;
+}
 declare global {
     interface ServiceWorkerGlobalScopeEventMap {
         sync: SyncEvent;
+        periodicsync: PeriodicSyncEvent;
     }
 }
 interface ServiceWorkerEventHandlers {
@@ -12,8 +16,9 @@ interface ServiceWorkerEventHandlers {
     activate?: (event: ExtendableEvent) => void | Promise<void>;
     fetch?: (event: FetchEvent) => Promise<Response | null>;
     message?: (event: MessageEvent) => void;
-    sync?: (event: SyncEvent) => void;
-    push?: (event: PushEvent) => void;
+    sync?: (event: SyncEvent) => void | Promise<void>;
+    periodicsync?: (event: PeriodicSyncEvent) => void | Promise<void>;
+    push?: (event: PushEvent) => void | Promise<void>;
 }
 interface ServiceWorkerPlugin extends ServiceWorkerEventHandlers {
     name: string;
@@ -29,6 +34,7 @@ export declare function createEventHandlers(plugins: ServiceWorkerPlugin[], conf
     fetch: (event: FetchEvent) => void;
     message: (event: MessageEvent) => void;
     sync: (event: SyncEvent) => void;
+    periodicsync: (event: PeriodicSyncEvent) => void;
     push: (event: PushEvent) => void;
 };
 export declare function initializeServiceWorker(plugins: ServiceWorkerPlugin[], config?: ServiceWorkerConfig): void;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU,SAAU,SAAQ,eAAe;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,gCAAgC;QACtC,IAAI,EAAE,SAAS,CAAC;KACnB;CACJ;AAED,UAAU,0BAA0B;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC;AAED,UAAU,mBAAoB,SAAQ,0BAA0B;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,mBAAmB;IACzB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD;AAID,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,MAAM,GAAE,mBAAwB,GACjC;IACC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC,CAkGA;AAED,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,MAAM,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CASN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU,SAAU,SAAQ,eAAe;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAED,UAAU,iBAAkB,SAAQ,eAAe;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,gCAAgC;QACtC,IAAI,EAAE,SAAS,CAAC;QAChB,YAAY,EAAE,iBAAiB,CAAC;KACnC;CACJ;AAED,UAAU,0BAA0B;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,UAAU,mBAAoB,SAAQ,0BAA0B;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,mBAAmB;IACzB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD;AAID,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,MAAM,GAAE,mBAAwB,GACjC;IACC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACpC,CAmIA;AAED,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,MAAM,CAAC,EAAE,mBAAmB,GAC7B,IAAI,CAUN"}

package/dist/index.js

@@ -5,6 +5,7 @@ export function createEventHandlers(plugins, config = {}) {
         fetch: [],
         message: [],
         sync: [],
+        periodicsync: [],
         push: [],
     };
     const sortedPlugins = [
@@ -24,6 +25,8 @@ export function createEventHandlers(plugins, config = {}) {
             handlers.message.push(plugin.message);
         if (plugin.sync)
             handlers.sync.push(plugin.sync);
+        if (plugin.periodicsync)
+            handlers.periodicsync.push(plugin.periodicsync);
         if (plugin.push)
             handlers.push.push(plugin.push);
     });
@@ -61,14 +64,22 @@ export function createEventHandlers(plugins, config = {}) {
             });
         },
         sync: (event) => {
-            handlers.sync.forEach((handler) => {
-                handler(event);
-            });
+            event.waitUntil(Promise.all(handlers.sync.map((handler) => Promise.resolve(handler(event)).catch((error) => config.onError?.(error, event)))));
+        },
+        periodicsync: (event) => {
+            event.waitUntil(Promise.all(handlers.periodicsync.map((handler) => Promise.resolve(handler(event)).catch((error) => config.onError?.(error, event)))));
         },
         push: (event) => {
-            handlers.push.forEach((handler) => {
-                handler(event);
-            });
+            event.waitUntil((async () => {
+                for (const handler of handlers.push) {
+                    try {
+                        await Promise.resolve(handler(event));
+                    }
+                    catch (error) {
+                        config.onError?.(error, event);
+                    }
+                }
+            })());
         },
     };
 }
@@ -79,6 +90,7 @@ export function initializeServiceWorker(plugins, config) {
     self.addEventListener('fetch', handlers.fetch);
     self.addEventListener('message', handlers.message);
     self.addEventListener('sync', handlers.sync);
+    self.addEventListener('periodicsync', handlers.periodicsync);
     self.addEventListener('push', handlers.push);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuCA,MAAM,UAAU,mBAAmB,CAC/B,OAA8B,EAC9B,SAA8B,EAAE;IAUhC,MAAM,QAAQ,GAAG;QACb,OAAO,EAAE,EAA0D;QACnE,QAAQ,EAAE,EAA0D;QACpE,KAAK,EAAE,EAA8C;QACrD,OAAO,EAAE,EAAuC;QAChD,IAAI,EAAE,EAAoD;QAC1D,YAAY,EAAE,EAEc;QAC5B,IAAI,EAAE,EAAoD;KAC7D,CAAC;IAOF,MAAM,aAAa,GAAG;QAClB,GAAG,OAAO;aACL,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC;aACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAC1D,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC;KAC/D,CAAC;IAEF,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7B,IAAI,MAAM,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,QAAQ;YAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK;YAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,YAAY;YACnB,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,OAAO,EAAE,CAAC,KAAsB,EAAQ,EAAE;YACtC,KAAK,CAAC,SAAS,CACX,OAAO,CAAC,GAAG,CACP,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACjC,CAAC,KAAc,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAC9C,CACJ,CACJ,CACJ,CAAC;QACN,CAAC;QAED,QAAQ,EAAE,CAAC,KAAsB,EAAQ,EAAE;YACvC,KAAK,CAAC,SAAS,CACX,OAAO,CAAC,GAAG,CACP,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC9B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACjC,CAAC,KAAc,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAC9C,CACJ,CACJ,CACJ,CAAC;QACN,CAAC;QAED,KAAK,EAAE,CAAC,KAAiB,EAAQ,EAAE;YAC/B,KAAK,CAAC,WAAW,CACb,CAAC,KAAK,IAAuB,EAAE;gBAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACnC,IAAI,CAAC;wBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;wBACpC,IAAI,MAAM,EAAE,CAAC;4BACT,OAAO,MAAM,CAAC;wBAClB,CAAC;oBACL,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACb,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAAC;oBAC5C,CAAC;gBACL,CAAC;gBACD,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC,CAAC,EAAE,CACP,CAAC;QACN,CAAC;QAED,OAAO,EAAE,CAAC,KAAmB,EAAQ,EAAE;YACnC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBACjC,IAAI,CAAC;oBACD,OAAO,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAAC;gBAC5C,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,EAAE,CAAC,KAAgB,EAAQ,EAAE;YAC7B,KAAK,CAAC,SAAS,CACX,OAAO,CAAC,GAAG,CACP,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACjC,CAAC,KAAc,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAC9C,CACJ,CACJ,CACJ,CAAC;QACN,CAAC;QAED,YAAY,EAAE,CAAC,KAAwB,EAAQ,EAAE;YAC7C,KAAK,CAAC,SAAS,CACX,OAAO,CAAC,GAAG,CACP,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAClC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CACjC,CAAC,KAAc,EAAE,EAAE,CACf,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAC9C,CACJ,CACJ,CACJ,CAAC;QACN,CAAC;QAED,IAAI,EAAE,CAAC,KAAgB,EAAQ,EAAE;YAC7B,KAAK,CAAC,SAAS,CACX,CAAC,KAAK,IAAmB,EAAE;gBACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAClC,IAAI,CAAC;wBACD,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC1C,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACb,MAAM,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,KAAK,CAAC,CAAC;oBAC5C,CAAC;gBACL,CAAC;YACL,CAAC,CAAC,EAAE,CACP,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CACnC,OAA8B,EAC9B,MAA4B;IAE5B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEtD,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7D,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@budarin/pluggable-serviceworker",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Extensible via plugins service worker",
   "keywords": [
     "serviceworker",

package/src/index.ts

@@ -3,10 +3,15 @@ interface SyncEvent extends ExtendableEvent {
     readonly lastChance: boolean;
 }
 
-// Extend ServiceWorkerGlobalScope to include sync event
+interface PeriodicSyncEvent extends ExtendableEvent {
+    readonly tag: string;
+}
+
+// Extend ServiceWorkerGlobalScope to include sync events
 declare global {
     interface ServiceWorkerGlobalScopeEventMap {
         sync: SyncEvent;
+        periodicsync: PeriodicSyncEvent;
     }
 }
 
@@ -15,8 +20,9 @@ interface ServiceWorkerEventHandlers {
     activate?: (event: ExtendableEvent) => void | Promise<void>;
     fetch?: (event: FetchEvent) => Promise<Response | null>;
     message?: (event: MessageEvent) => void;
-    sync?: (event: SyncEvent) => void;
-    push?: (event: PushEvent) => void;
+    sync?: (event: SyncEvent) => void | Promise<void>;
+    periodicsync?: (event: PeriodicSyncEvent) => void | Promise<void>;
+    push?: (event: PushEvent) => void | Promise<void>;
 }
 
 interface ServiceWorkerPlugin extends ServiceWorkerEventHandlers {
@@ -40,6 +46,7 @@ export function createEventHandlers(
     fetch: (event: FetchEvent) => void;
     message: (event: MessageEvent) => void;
     sync: (event: SyncEvent) => void;
+    periodicsync: (event: PeriodicSyncEvent) => void;
     push: (event: PushEvent) => void;
 } {
     const handlers = {
@@ -47,8 +54,11 @@ export function createEventHandlers(
         activate: [] as ((event: ExtendableEvent) => void | Promise<void>)[],
         fetch: [] as ((event: FetchEvent) => FetchResponse)[],
         message: [] as ((event: MessageEvent) => void)[],
-        sync: [] as ((event: SyncEvent) => void)[],
-        push: [] as ((event: PushEvent) => void)[],
+        sync: [] as ((event: SyncEvent) => void | Promise<void>)[],
+        periodicsync: [] as ((
+            event: PeriodicSyncEvent
+        ) => void | Promise<void>)[],
+        push: [] as ((event: PushEvent) => void | Promise<void>)[],
     };
 
     // Здесь происходит сортировка плагинов по их приоритету.
@@ -69,6 +79,8 @@ export function createEventHandlers(
         if (plugin.fetch) handlers.fetch.push(plugin.fetch);
         if (plugin.message) handlers.message.push(plugin.message);
         if (plugin.sync) handlers.sync.push(plugin.sync);
+        if (plugin.periodicsync)
+            handlers.periodicsync.push(plugin.periodicsync);
         if (plugin.push) handlers.push.push(plugin.push);
     });
 
@@ -128,15 +140,43 @@ export function createEventHandlers(
         },
 
         sync: (event: SyncEvent): void => {
-            handlers.sync.forEach((handler) => {
-                handler(event);
-            });
+            event.waitUntil(
+                Promise.all(
+                    handlers.sync.map((handler) =>
+                        Promise.resolve(handler(event)).catch(
+                            (error: unknown) =>
+                                config.onError?.(error as Error, event)
+                        )
+                    )
+                )
+            );
+        },
+
+        periodicsync: (event: PeriodicSyncEvent): void => {
+            event.waitUntil(
+                Promise.all(
+                    handlers.periodicsync.map((handler) =>
+                        Promise.resolve(handler(event)).catch(
+                            (error: unknown) =>
+                                config.onError?.(error as Error, event)
+                        )
+                    )
+                )
+            );
         },
 
         push: (event: PushEvent): void => {
-            handlers.push.forEach((handler) => {
-                handler(event);
-            });
+            event.waitUntil(
+                (async (): Promise<void> => {
+                    for (const handler of handlers.push) {
+                        try {
+                            await Promise.resolve(handler(event));
+                        } catch (error) {
+                            config.onError?.(error as Error, event);
+                        }
+                    }
+                })()
+            );
         },
     };
 }
@@ -152,5 +192,6 @@ export function initializeServiceWorker(
     self.addEventListener('fetch', handlers.fetch);
     self.addEventListener('message', handlers.message);
     self.addEventListener('sync', handlers.sync);
+    self.addEventListener('periodicsync', handlers.periodicsync);
     self.addEventListener('push', handlers.push);
 }