@budarin/pluggable-serviceworker 1.0.28 → 1.0.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Вадим Бударин
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Вадим Бударин
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,315 +1,398 @@
1
- # @budarin/pluggable-serviceworker
2
-
3
- 🔌 Расширяемый через плагины Service Worker
4
-
5
- Библиотека для создания модульных и расширяемых Service Worker'ов с помощью системы плагинов.
6
-
7
- ## 🚀 Почему этот пакет облегчает разработку?
8
-
9
- Разработка Service Worker'ов традиционно сложна из-за необходимости вручную управлять множественными обработчиками событий, обработкой ошибок и порядком выполнения. Этот пакет решает эти проблемы:
10
-
11
- ### 🔌 **Модульная архитектура**
12
-
13
- - **Плагинная система** позволяет разбивать функциональность на независимые модули
14
- - Каждый плагин отвечает за свою задачу (кеширование, аутентификация, уведомления)
15
- - Легко добавлять/удалять функциональность без изменения основного кода
16
- - Не нужно думать об инфраструктурном коде в обработчиках событий - пишите простой код не думая о сложностях кода самого сервисворкера
17
-
18
- ### 🎯 **Управление порядком выполнения**
19
-
20
- - **Предсказуемый порядок** - плагины без `order` выполняются первыми, затем по возрастанию `order`
21
- - **Гибкость** - можно контролировать последовательность инициализации
22
- - **Масштабируемость** - легко добавлять новые плагины в нужном месте
23
-
24
- ### ⚡ **Оптимизированная логика выполнения**
25
-
26
- - **Параллельно** для `install`, `activate`, `message`, `sync` - независимые задачи выполняются одновременно
27
- - **Последовательно** для `fetch`, `push` - первый успешный результат прерывает цепочку
28
- - **Производительность** - правильный выбор стратегии для каждого типа события
29
-
30
- ### 🛡️ **Централизованная обработка ошибок**
31
-
32
- - **Единый обработчик** для всех типов ошибок
33
- - **Типизированные ошибки** - знаешь, что именно сломалось
34
- - **Изоляция** - ошибка в одном плагине не ломает остальные
35
- - **Автоматическая обработка** глобальных событий ошибок
36
-
37
- ### 📝 **Удобное логирование**
38
-
39
- - **Настраиваемый логгер** с разными уровнями
40
- - **Контекстная информация** в логах
41
- - **Отладка** становится намного проще
42
-
43
- ## 📦 Установка
44
-
45
- ```bash
46
- npm install @budarin/pluggable-serviceworker
47
- ```
48
-
49
- или
50
-
51
- ```bash
52
- pnpm add @budarin/pluggable-serviceworker
53
- ```
54
-
55
- ## 🚀 Быстрый старт
56
-
57
- ### Базовое использование
58
-
59
- ```typescript
60
- // sw.js
61
- import { initializeServiceWorker } from '@budarin/pluggable-serviceworker';
62
-
63
- // Простой плагин для кеширования
64
- const cachePlugin = {
65
- name: 'cache-plugin',
66
-
67
- install: async (event) => {
68
- const cache = await caches.open('my-cache-v1');
69
- await cache.addAll(['/', '/styles.css', '/script.js']);
70
- },
71
-
72
- fetch: async (event) => {
73
- const cachedResponse = await caches.match(event.request);
74
- return cachedResponse || fetch(event.request);
75
- },
76
- };
77
-
78
- // Инициализация Service Worker с плагинами
79
- initializeServiceWorker([cachePlugin], { logger: console });
80
- ```
81
-
82
- ### Обработка ошибок
83
-
84
- Библиотека предоставляет единый обработчик для всех типов ошибок в Service Worker:
85
-
86
- ```typescript
87
- import {
88
- initializeServiceWorker,
89
- ServiceWorkerErrorType,
90
- } from '@budarin/pluggable-serviceworker';
91
-
92
- const config = {
93
- onError: (error, event, errorType) => {
94
- console.log(`Ошибка типа "${errorType}":`, error);
95
-
96
- switch (errorType) {
97
- case ServiceWorkerErrorType.ERROR:
98
- // JavaScript ошибки
99
- console.error('JavaScript error:', error);
100
- break;
101
-
102
- case ServiceWorkerErrorType.MESSAGE_ERROR:
103
- // Ошибки сообщений
104
- console.error('Message error:', error);
105
- break;
106
-
107
- case ServiceWorkerErrorType.UNHANDLED_REJECTION:
108
- // Необработанные Promise rejection
109
- console.error('Unhandled promise rejection:', error);
110
- break;
111
-
112
- case ServiceWorkerErrorType.REJECTION_HANDLED:
113
- // Обработанные Promise rejection
114
- console.log('Promise rejection handled:', error);
115
- break;
116
-
117
- case ServiceWorkerErrorType.PLUGIN_ERROR:
118
- // Ошибки в плагинах
119
- console.error('Plugin error:', error);
120
- break;
121
-
122
- default:
123
- // Неизвестные типы ошибок
124
- console.error('Unknown error type:', error);
125
-
126
- // Отправка ошибки в аналитику
127
- fetch('/api/errors', {
128
- method: 'POST',
129
- body: JSON.stringify({
130
- error: error.message,
131
- eventType: event.type,
132
- url: event.request?.url,
133
- timestamp: Date.now(),
134
- }),
135
- }).catch(() => {
136
- // Игнорируем ошибки отправки логов
137
- });
138
- }
139
- },
140
- };
141
-
142
- initializeServiceWorker(
143
- [
144
- /* ваши плагины */
145
- ],
146
- config
147
- );
148
- ```
149
-
150
- ## 🔌 Интерфейс плагина
151
-
152
- Каждый плагин должен реализовывать интерфейс `ServiceWorkerPlugin`:
153
-
154
- ```typescript
155
- interface ServiceWorkerPlugin {
156
- /** Уникальное имя плагина */
157
- name: string;
158
-
159
- /** Порядок выполнения (опционально) */
160
- order?: number;
161
-
162
- /** Обработчик события install */
163
- install?: (event: ExtendableEvent) => Promise<void> | void;
164
-
165
- /** Обработчик события activate */
166
- activate?: (event: ExtendableEvent) => Promise<void> | void;
167
-
168
- /** Обработчик события fetch */
169
- fetch?: (
170
- event: FetchEvent
171
- ) => Promise<Response | undefined> | Response | undefined;
172
-
173
- /** Обработчик события message */
174
- message?: (event: ExtendableMessageEvent) => Promise<void> | void;
175
-
176
- /** Обработчик события sync */
177
- sync?: (event: SyncEvent) => Promise<void> | void;
178
-
179
- /** Обработчик события push */
180
- push?: (event: PushEvent) => Promise<void> | void;
181
-
182
- /** Обработчик события periodicsync */
183
- periodicsync?: (event: PeriodicSyncEvent) => Promise<void> | void;
184
- }
185
- ```
186
-
187
- ### 📝 Описание методов
188
-
189
- | Метод | Событие | Возвращает | Описание |
190
- | -------------- | -------------- | ----------------------- | --------------------------------------- |
191
- | `install` | `install` | `void` | Инициализация плагина при установке SW |
192
- | `activate` | `activate` | `void` | Активация плагина при обновлении SW |
193
- | `fetch` | `fetch` | `Response \| undefined` | Обработка сетевых запросов |
194
- | `message` | `message` | `void` | Обработка сообщений от основного потока |
195
- | `sync` | `sync` | `void` | Синхронизация данных в фоне |
196
- | `push` | `push` | `void` | Обработка push-уведомлений |
197
- | `periodicsync` | `periodicsync` | `void` | Периодические фоновые задачи |
198
-
199
- ### 🎯 Особенности обработчиков
200
-
201
- - **`fetch`**: Возвращает `Response` для завершения цепочки или `undefined` для передачи следующему плагину
202
- - **Остальные**: Не возвращают значения, выполняются для всех плагинов
203
- - **Все методы опциональны** - реализуйте только нужные события
204
-
205
- ## 🎯 Порядок выполнения
206
-
207
- Плагины выполняются в следующем порядке:
208
-
209
- 1. **Сначала ВСЕ плагины без `order`** - в том порядке, в котором они были добавлены
210
- 2. **Затем плагины с `order`** - в порядке возрастания значений `order`
211
-
212
- ### Пример:
213
-
214
- ```typescript
215
- const plugins = [
216
- { name: 'first' }, // без order - выполняется первым
217
- { name: 'fourth', order: 2 },
218
- { name: 'second' }, // без order - выполняется вторым
219
- { name: 'third', order: 1 },
220
- { name: 'fifth' }, // без order - выполняется третьим
221
- ];
222
-
223
- // Порядок выполнения: first → second → fifth → third → fourth
224
- ```
225
-
226
- **Преимущества новой системы:**
227
-
228
- - 🎯 **Предсказуемость** - плагины без `order` всегда выполняются первыми
229
- - 🔧 **Простота** - не нужно знать, какие номера уже заняты
230
- - 📈 **Масштабируемость** - легко добавлять новые плагины в нужном порядке
231
-
232
- ## Логика выполнения обработчиков
233
-
234
- Разные типы событий Service Worker обрабатываются по-разному в зависимости от их специфики:
235
-
236
- ### 🔄 Параллельное выполнение
237
-
238
- **События:** `install`, `activate`, `message`, `sync`, `periodicsync`
239
-
240
- Все обработчики выполняются **одновременно** с помощью `Promise.all()`:
241
-
242
- ```typescript
243
- // Все плагины инициализируются параллельно
244
- const installPlugin1 = {
245
- name: 'cache-assets',
246
- install: async () => {
247
- /* кеширование ресурсов приложения*/
248
- },
249
- };
250
- const installPlugin2 = {
251
- name: 'cache-ext',
252
- install: async () => {
253
- /* кэширование вспомогательных ресурсов */
254
- },
255
- };
256
-
257
- // Оба install обработчика выполнятся одновременно
258
- ```
259
-
260
- **Почему параллельно:**
261
-
262
- - **install/activate**: Все плагины должны инициализироваться независимо
263
- - **message**: Все плагины должны получить сообщение одновременно
264
- - **sync**: Разные задачи синхронизации независимы (синхронизация данных + кеша)
265
- - **periodicsync**: Периодические задачи независимы друг от друга
266
-
267
- ### ➡️ Последовательное выполнение
268
-
269
- **События:** `fetch`, `push`
270
-
271
- Обработчики выполняются **по очереди** до первого успешного результата:
272
-
273
- #### Fetch - с прерыванием цепочки
274
-
275
- ```typescript
276
- const authPlugin = {
277
- name: 'auth',
278
- // Без order - выполняется первым
279
- fetch: async (event) => {
280
- if (needsAuth(event.request)) {
281
- return new Response('Unauthorized', { status: 401 }); // Прерывает цепочку
282
- }
283
- return undefined; // Передает следующему плагину
284
- },
285
- };
286
- ```
287
-
288
- **Почему последовательно:**
289
-
290
- - **fetch**: Нужен только один ответ, первый успешный прерывает цепочку
291
- - **push**: Избегает конфликтов уведомлений, но все плагины должны обработать событие
292
-
293
- ### 📋 Сводная таблица
294
-
295
- | Событие | Выполнение | Прерывание | Причина |
296
- | -------------- | --------------- | ---------- | -------------------------------- |
297
- | `install` | Параллельно | Нет | Независимая инициализация |
298
- | `activate` | Параллельно | Нет | Независимая активация |
299
- | `fetch` | Последовательно | Да | Нужен один ответ |
300
- | `message` | Параллельно | Нет | Все получают сообщение |
301
- | `sync` | Параллельно | Нет | Независимые задачи |
302
- | `periodicsync` | Параллельно | Нет | Независимые периодические задачи |
303
- | `push` | Последовательно | Нет | Избегание конфликтов |
304
-
305
- ## 🛡️ Обработка ошибок
306
-
307
- - **Единый обработчик** - все типы ошибок обрабатываются через `config.onError`
308
- - **Типизированные ошибки** - третий параметр `errorType` указывает тип ошибки
309
- - **Глобальные события** - автоматическая обработка `error`, `messageerror`, `unhandledrejection`, `rejectionhandled`
310
- - **Изоляция ошибок** - ошибка в одном плагине не останавливает выполнение других
311
- - **Безопасность** - ошибки в самих обработчиках ошибок логируются в консоль
312
-
313
- ## 📄 Лицензия
314
-
315
- MIT © Vadim Budarin
1
+ # @budarin/pluggable-serviceworker
2
+
3
+ 🔌 Расширяемый через плагины Service Worker
4
+
5
+ Библиотека для создания модульных и расширяемых Service Worker'ов с помощью системы плагинов.
6
+
7
+ ## 🚀 Почему этот пакет облегчает разработку?
8
+
9
+ Разработка Service Worker'ов традиционно сложна из-за необходимости вручную управлять множественными обработчиками событий, обработкой ошибок и порядком выполнения. Этот пакет решает эти проблемы:
10
+
11
+ ### 🔌 **Модульная архитектура**
12
+
13
+ - **Плагинная система** позволяет разбивать функциональность на независимые модули
14
+ - Каждый плагин отвечает за свою задачу (кеширование, аутентификация, уведомления)
15
+ - Легко добавлять/удалять функциональность без изменения основного кода
16
+ - Не нужно думать об инфраструктурном коде в обработчиках событий - пишите простой код не думая о сложностях кода самого сервисворкера
17
+
18
+ ### 🎯 **Управление порядком выполнения**
19
+
20
+ - **Предсказуемый порядок** - плагины без `order` выполняются первыми, затем по возрастанию `order`
21
+ - **Гибкость** - можно контролировать последовательность инициализации
22
+ - **Масштабируемость** - легко добавлять новые плагины в нужном месте
23
+
24
+ ### ⚡ **Оптимизированная логика выполнения**
25
+
26
+ - **Параллельно** для `install`, `activate`, `message`, `sync` - независимые задачи выполняются одновременно
27
+ - **Последовательно** для `fetch`, `push` - первый успешный результат прерывает цепочку
28
+ - **Производительность** - правильный выбор стратегии для каждого типа события
29
+
30
+ ### 🛡️ **Централизованная обработка ошибок**
31
+
32
+ - **Единый обработчик** для всех типов ошибок
33
+ - **Типизированные ошибки** - знаешь, что именно сломалось
34
+ - **Изоляция** - ошибка в одном плагине не ломает остальные
35
+ - **Автоматическая обработка** глобальных событий ошибок
36
+
37
+ ### 📝 **Удобное логирование**
38
+
39
+ - **Настраиваемый логгер** с разными уровнями
40
+ - **Контекстная информация** в логах
41
+ - **Отладка** становится намного проще
42
+
43
+ ## 📦 Установка
44
+
45
+ ```bash
46
+ npm install @budarin/pluggable-serviceworker
47
+ ```
48
+
49
+ или
50
+
51
+ ```bash
52
+ pnpm add @budarin/pluggable-serviceworker
53
+ ```
54
+
55
+ ## 🚀 Быстрый старт
56
+
57
+ ### Базовое использование
58
+
59
+ ```typescript
60
+ // sw.js
61
+ import { initializeServiceWorker } from '@budarin/pluggable-serviceworker';
62
+
63
+ // Простой плагин для кеширования
64
+ const cachePlugin = {
65
+ name: 'cache-plugin',
66
+
67
+ install: async (event) => {
68
+ const cache = await caches.open('my-cache-v1');
69
+ await cache.addAll(['/', '/styles.css', '/script.js']);
70
+ },
71
+
72
+ fetch: async (event) => {
73
+ const cachedResponse = await caches.match(event.request);
74
+ return cachedResponse || fetch(event.request);
75
+ },
76
+ };
77
+
78
+ // Инициализация Service Worker с плагинами
79
+ initializeServiceWorker([cachePlugin], { logger: console });
80
+ ```
81
+
82
+ ## ⚙️ Конфигурация
83
+
84
+ Функция `initializeServiceWorker` принимает второй параметр `config` типа `ServiceWorkerConfig`:
85
+
86
+ ```typescript
87
+ interface ServiceWorkerConfig {
88
+ logger: Logger; // Обязательное поле
89
+ // Опциональное поле
90
+ onError?: (
91
+ error: Error | any,
92
+ event: Event,
93
+ errorType?: ServiceWorkerErrorType
94
+ ) => void;
95
+ }
96
+ ```
97
+
98
+ ### Поля конфигурации
99
+
100
+ #### `logger: Logger` (обязательное)
101
+
102
+ Объект для логирования с методами `info`, `warn`, `error`, `debug`. Может быть передан `console` или любой другой объект, реализующий интерфейс `Logger`.
103
+
104
+ ```typescript
105
+ interface Logger {
106
+ info: (...data: unknown[]) => void;
107
+ warn: (...data: unknown[]) => void;
108
+ error: (...data: unknown[]) => void;
109
+ debug: (...data: unknown[]) => void;
110
+ }
111
+ ```
112
+
113
+ **Пример:**
114
+
115
+ ```typescript
116
+ const config = {
117
+ logger: console, // Использование стандартного console
118
+ // или
119
+ logger: {
120
+ info: (...data) => customLog('INFO', ...data),
121
+ warn: (...data) => customLog('WARN', ...data),
122
+ error: (...data) => customLog('ERROR', ...data),
123
+ debug: (...data) => customLog('DEBUG', ...data),
124
+ },
125
+ };
126
+ ```
127
+
128
+ #### `onError?: (error, event, errorType) => void` (опциональное)
129
+
130
+ Единый обработчик для всех типов ошибок в Service Worker. **Дефолтного обработчика ошибок нет** - если `onError` не передан, ошибки будут проигнорированы (не обработаны).
131
+
132
+ **Параметры:**
133
+
134
+ - `error: Error | any` - объект ошибки
135
+ - `event: Event` - событие, в контексте которого произошла ошибка
136
+ - `errorType?: ServiceWorkerErrorType` - тип ошибки (см. раздел "Обработка ошибок")
137
+
138
+ **Важно:** Если `onError` не указан, ошибки в плагинах и глобальные ошибки будут проигнорированы. Для production-окружения рекомендуется всегда указывать `onError` для логирования и мониторинга ошибок.
139
+
140
+ **Пример минимальной конфигурации:**
141
+
142
+ ```typescript
143
+ // Без onError - ошибки будут проигнорированы
144
+ initializeServiceWorker([cachePlugin], { logger: console });
145
+
146
+ // С onError - ошибки будут обработаны
147
+ initializeServiceWorker([cachePlugin], {
148
+ logger: console,
149
+ onError: (error, event, errorType) => {
150
+ console.error('Service Worker error:', error, errorType);
151
+ },
152
+ });
153
+ ```
154
+
155
+ ### Обработка ошибок
156
+
157
+ Библиотека предоставляет единый обработчик для всех типов ошибок в Service Worker:
158
+
159
+ ```typescript
160
+ import {
161
+ initializeServiceWorker,
162
+ ServiceWorkerErrorType,
163
+ } from '@budarin/pluggable-serviceworker';
164
+
165
+ const config = {
166
+ onError: (error, event, errorType) => {
167
+ console.log(`Ошибка типа "${errorType}":`, error);
168
+
169
+ switch (errorType) {
170
+ case ServiceWorkerErrorType.ERROR:
171
+ // JavaScript ошибки
172
+ console.error('JavaScript error:', error);
173
+ break;
174
+
175
+ case ServiceWorkerErrorType.MESSAGE_ERROR:
176
+ // Ошибки сообщений
177
+ console.error('Message error:', error);
178
+ break;
179
+
180
+ case ServiceWorkerErrorType.UNHANDLED_REJECTION:
181
+ // Необработанные Promise rejection
182
+ console.error('Unhandled promise rejection:', error);
183
+ break;
184
+
185
+ case ServiceWorkerErrorType.REJECTION_HANDLED:
186
+ // Обработанные Promise rejection
187
+ console.log('Promise rejection handled:', error);
188
+ break;
189
+
190
+ case ServiceWorkerErrorType.PLUGIN_ERROR:
191
+ // Ошибки в плагинах
192
+ console.error('Plugin error:', error);
193
+ break;
194
+
195
+ default:
196
+ // Неизвестные типы ошибок
197
+ console.error('Unknown error type:', error);
198
+
199
+ // Отправка ошибки в аналитику
200
+ fetch('/api/errors', {
201
+ method: 'POST',
202
+ body: JSON.stringify({
203
+ error: error.message,
204
+ eventType: event.type,
205
+ url: event.request?.url,
206
+ timestamp: Date.now(),
207
+ }),
208
+ }).catch(() => {
209
+ // Игнорируем ошибки отправки логов
210
+ });
211
+ }
212
+ },
213
+ };
214
+
215
+ initializeServiceWorker(
216
+ [
217
+ /* ваши плагины */
218
+ ],
219
+ config
220
+ );
221
+ ```
222
+
223
+ ## 🔌 Интерфейс плагина
224
+
225
+ Каждый плагин должен реализовывать интерфейс `ServiceWorkerPlugin`:
226
+
227
+ ```typescript
228
+ interface ServiceWorkerPlugin {
229
+ /** Уникальное имя плагина */
230
+ name: string;
231
+
232
+ /** Порядок выполнения (опционально) */
233
+ order?: number;
234
+
235
+ /** Обработчик события install */
236
+ install?: (event: ExtendableEvent) => Promise<void> | void;
237
+
238
+ /** Обработчик события activate */
239
+ activate?: (event: ExtendableEvent) => Promise<void> | void;
240
+
241
+ /** Обработчик события fetch */
242
+ fetch?: (
243
+ event: FetchEvent
244
+ ) => Promise<Response | undefined> | Response | undefined;
245
+
246
+ /** Обработчик события message */
247
+ message?: (event: ExtendableMessageEvent) => Promise<void> | void;
248
+
249
+ /** Обработчик события sync */
250
+ sync?: (event: SyncEvent) => Promise<void> | void;
251
+
252
+ /** Обработчик события push */
253
+ push?: (event: PushEvent) => Promise<void> | void;
254
+
255
+ /** Обработчик события periodicsync */
256
+ periodicsync?: (event: PeriodicSyncEvent) => Promise<void> | void;
257
+ }
258
+ ```
259
+
260
+ ### 📝 Описание методов
261
+
262
+ | Метод | Событие | Возвращает | Описание |
263
+ | -------------- | -------------- | ----------------------- | --------------------------------------- |
264
+ | `install` | `install` | `void` | Инициализация плагина при установке SW |
265
+ | `activate` | `activate` | `void` | Активация плагина при обновлении SW |
266
+ | `fetch` | `fetch` | `Response \| undefined` | Обработка сетевых запросов |
267
+ | `message` | `message` | `void` | Обработка сообщений от основного потока |
268
+ | `sync` | `sync` | `void` | Синхронизация данных в фоне |
269
+ | `push` | `push` | `void` | Обработка push-уведомлений |
270
+ | `periodicsync` | `periodicsync` | `void` | Периодические фоновые задачи |
271
+
272
+ ### 🎯 Особенности обработчиков
273
+
274
+ - **`fetch`**: Возвращает `Response` для завершения цепочки или `undefined` для передачи следующему плагину
275
+ - **Остальные**: Не возвращают значения, выполняются для всех плагинов
276
+ - **Все методы опциональны** - реализуйте только нужные события
277
+
278
+ ## 🎯 Порядок выполнения
279
+
280
+ Плагины выполняются в следующем порядке:
281
+
282
+ 1. **Сначала ВСЕ плагины без `order`** - в том порядке, в котором они были добавлены
283
+ 2. **Затем плагины с `order`** - в порядке возрастания значений `order`
284
+
285
+ ### Пример:
286
+
287
+ ```typescript
288
+ const plugins = [
289
+ { name: 'first' }, // без order - выполняется первым
290
+ { name: 'fourth', order: 2 },
291
+ { name: 'second' }, // без order - выполняется вторым
292
+ { name: 'third', order: 1 },
293
+ { name: 'fifth' }, // без order - выполняется третьим
294
+ ];
295
+
296
+ // Порядок выполнения: first second fifth → third → fourth
297
+ ```
298
+
299
+ **Преимущества новой системы:**
300
+
301
+ - 🎯 **Предсказуемость** - плагины без `order` всегда выполняются первыми
302
+ - 🔧 **Простота** - не нужно знать, какие номера уже заняты
303
+ - 📈 **Масштабируемость** - легко добавлять новые плагины в нужном порядке
304
+
305
+ ## Логика выполнения обработчиков
306
+
307
+ Разные типы событий Service Worker обрабатываются по-разному в зависимости от их специфики:
308
+
309
+ ### 🔄 Параллельное выполнение
310
+
311
+ **События:** `install`, `activate`, `message`, `sync`, `periodicsync`
312
+
313
+ Все обработчики выполняются **одновременно** с помощью `Promise.all()`:
314
+
315
+ ```typescript
316
+ // Все плагины инициализируются параллельно
317
+ const installPlugin1 = {
318
+ name: 'cache-assets',
319
+ install: async () => {
320
+ /* кеширование ресурсов приложения*/
321
+ },
322
+ };
323
+ const installPlugin2 = {
324
+ name: 'cache-ext',
325
+ install: async () => {
326
+ /* кэширование вспомогательных ресурсов */
327
+ },
328
+ };
329
+
330
+ // Оба install обработчика выполнятся одновременно
331
+ ```
332
+
333
+ **Почему параллельно:**
334
+
335
+ - **install/activate**: Все плагины должны инициализироваться независимо
336
+ - **message**: Все плагины должны получить сообщение одновременно
337
+ - **sync**: Разные задачи синхронизации независимы (синхронизация данных + кеша)
338
+ - **periodicsync**: Периодические задачи независимы друг от друга
339
+
340
+ ### ➡️ Последовательное выполнение
341
+
342
+ **События:** `fetch`, `push`
343
+
344
+ Обработчики выполняются **по очереди** до первого успешного результата:
345
+
346
+ #### Fetch - с прерыванием цепочки
347
+
348
+ ```typescript
349
+ const authPlugin = {
350
+ name: 'auth',
351
+ // Без order - выполняется первым
352
+ fetch: async (event) => {
353
+ if (needsAuth(event.request)) {
354
+ return new Response('Unauthorized', { status: 401 }); // Прерывает цепочку
355
+ }
356
+ return undefined; // Передает следующему плагину
357
+ },
358
+ };
359
+ ```
360
+
361
+ **Почему последовательно:**
362
+
363
+ - **fetch**: Нужен только один ответ, первый успешный прерывает цепочку
364
+ - **push**: Избегает конфликтов уведомлений, но все плагины должны обработать событие
365
+
366
+ ### 📋 Сводная таблица
367
+
368
+ | Событие | Выполнение | Прерывание | Причина |
369
+ | -------------- | --------------- | ---------- | -------------------------------- |
370
+ | `install` | Параллельно | Нет | Независимая инициализация |
371
+ | `activate` | Параллельно | Нет | Независимая активация |
372
+ | `fetch` | Последовательно | Да | Нужен один ответ |
373
+ | `message` | Параллельно | Нет | Все получают сообщение |
374
+ | `sync` | Параллельно | Нет | Независимые задачи |
375
+ | `periodicsync` | Параллельно | Нет | Независимые периодические задачи |
376
+ | `push` | Последовательно | Нет | Избегание конфликтов |
377
+
378
+ ## 🛡️ Обработка ошибок
379
+
380
+ Библиотека автоматически перехватывает и обрабатывает все типы ошибок в Service Worker через единый обработчик `config.onError` (см. раздел [Конфигурация](#-конфигурация)).
381
+
382
+ **Особенности:**
383
+
384
+ - **Единый обработчик** - все типы ошибок обрабатываются через `config.onError` (опциональное поле)
385
+ - **Дефолтного обработчика нет** - если `onError` не указан, ошибки будут проигнорированы
386
+ - **Типизированные ошибки** - третий параметр `errorType` указывает тип ошибки из `ServiceWorkerErrorType`
387
+ - **Глобальные события** - автоматическая обработка `error`, `messageerror`, `unhandledrejection`, `rejectionhandled`
388
+ - **Изоляция ошибок** - ошибка в одном плагине не останавливает выполнение других
389
+ - **Безопасность** - ошибки в самих обработчиках ошибок логируются через `logger.error`
390
+
391
+ ## Режим разработки
392
+
393
+ Важно, чтобы в режиме разработки ни один из плагинов ничего не кэшировал и не пытался что-либо отдавать из кэша.
394
+ В пакетах для этого можно использовть `import.meta.env.DEV` для Vite
395
+
396
+ ## 📄 Лицензия
397
+
398
+ MIT © Vadim Budarin
@@ -0,0 +1,65 @@
1
+ export declare enum ServiceWorkerErrorType {
2
+ ERROR = "error",
3
+ MESSAGE_ERROR = "messageerror",
4
+ UNHANDLED_REJECTION = "unhandledrejection",
5
+ REJECTION_HANDLED = "rejectionhandled",
6
+ PLUGIN_ERROR = "plugin_error"
7
+ }
8
+ interface SyncEvent extends ExtendableEvent {
9
+ readonly tag: string;
10
+ readonly lastChance: boolean;
11
+ }
12
+ interface PeriodicSyncEvent extends ExtendableEvent {
13
+ readonly tag: string;
14
+ }
15
+ declare global {
16
+ interface ServiceWorkerGlobalScopeEventMap {
17
+ sync: SyncEvent;
18
+ periodicsync: PeriodicSyncEvent;
19
+ }
20
+ }
21
+ export interface SwMessageEvent extends Omit<ExtendableMessageEvent, 'data'> {
22
+ data: {
23
+ type: string;
24
+ };
25
+ }
26
+ export interface Logger {
27
+ info: (...data: unknown[]) => void;
28
+ warn: (...data: unknown[]) => void;
29
+ error: (...data: unknown[]) => void;
30
+ debug: (...data: unknown[]) => void;
31
+ }
32
+ interface ServiceWorkerEventHandlers {
33
+ install?: (event: ExtendableEvent) => void | Promise<void>;
34
+ activate?: (event: ExtendableEvent) => void | Promise<void>;
35
+ fetch?: (event: FetchEvent) => Promise<Response | undefined>;
36
+ message?: (event: SwMessageEvent) => void;
37
+ sync?: (event: SyncEvent) => Promise<void>;
38
+ periodicsync?: (event: PeriodicSyncEvent) => Promise<void>;
39
+ push?: (event: PushEvent) => void | Promise<void>;
40
+ }
41
+ export interface ServiceWorkerPlugin extends ServiceWorkerEventHandlers {
42
+ name: string;
43
+ order?: number;
44
+ }
45
+ interface ServiceWorkerConfig {
46
+ logger: Logger;
47
+ onError?: (error: Error | any, event: Event, errorType?: ServiceWorkerErrorType) => void;
48
+ }
49
+ export type FetchResponse = Promise<Response | undefined>;
50
+ export declare function createEventHandlers(plugins: ServiceWorkerPlugin[], config: ServiceWorkerConfig): {
51
+ install: (event: ExtendableEvent) => void;
52
+ activate: (event: ExtendableEvent) => void;
53
+ fetch: (event: FetchEvent) => void;
54
+ message: (event: SwMessageEvent) => void;
55
+ sync: (event: SyncEvent) => void;
56
+ periodicsync: (event: PeriodicSyncEvent) => void;
57
+ push: (event: PushEvent) => void;
58
+ error: (event: ErrorEvent) => void;
59
+ messageerror: (event: MessageEvent) => void;
60
+ unhandledrejection: (event: PromiseRejectionEvent) => void;
61
+ rejectionhandled: (event: PromiseRejectionEvent) => void;
62
+ };
63
+ export declare function initializeServiceWorker(plugins: ServiceWorkerPlugin[], config: ServiceWorkerConfig): void;
64
+ export {};
65
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@budarin/pluggable-serviceworker",
3
- "version": "1.0.28",
3
+ "version": "1.0.30",
4
4
  "description": "Extensible via plugins service worker",
5
5
  "keywords": [
6
6
  "serviceworker",
@@ -19,14 +19,14 @@
19
19
  "./types": "./dist/index.d.ts"
20
20
  },
21
21
  "devDependencies": {
22
- "@types/node": "^24.5.2",
22
+ "@types/node": "^24.10.0",
23
23
  "@types/serviceworker": "^0.0.153",
24
24
  "@types/web": "^0.0.269",
25
25
  "prettier": "^3.6.2",
26
- "typescript": "^5.9.2"
26
+ "typescript": "^5.9.3"
27
27
  },
28
28
  "dependencies": {
29
- "@budarin/http-constants": "^1.0.15"
29
+ "@budarin/http-constants": "^1.0.16"
30
30
  },
31
31
  "scripts": {
32
32
  "build": "tsc",