@budarin/pluggable-serviceworker 1.0.1

package/.prettierignore

@@ -0,0 +1,3 @@
+.vscode
+# dist
+node_modules

package/.prettierrc.mjs

@@ -0,0 +1,14 @@
+/**
+ * @see https://prettier.io/docs/en/configuration.html
+ * @type {import("prettier").Config}
+ */
+const config = {
+    trailingComma: 'es5',
+    tabWidth: 4,
+    // semi: false,
+    singleQuote: true,
+    plugins: [],
+    htmlWhitespaceSensitivity: 'ignore',
+};
+
+export default config;

package/.vscode/extensions.json

@@ -0,0 +1,26 @@
+{
+  "recommendations": [
+    // "codeium.codeium",
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "stylelint.vscode-stylelint",
+    "dsznajder.es7-react-js-snippets",
+    "ecmel.vscode-html-css",
+    "vitest.explorer",
+    "vscode-icons-team.vscode-icons",
+    "wayou.vscode-todo-highlight",
+    "felixfbecker.css-stacking-contexts",
+    // "formulahendry.auto-rename-tag",
+    "mhutchie.git-graph",
+    "ms-azuretools.vscode-docker",
+    "ms-playwright.playwrigh",
+    "naumovs.color-highlight",
+    "planbcoding.vscode-react-refactor",
+    "svetlanakost.typograf",
+    "viktorzetterstrom.non-breaking-space-highlighter",
+    "wallabyjs.wallaby-vscode",
+    "yoavbls.pretty-ts-errors",
+    "donjayamanne.githistory",
+    "pranaygp.vscode-css-peek"
+  ]
+}

package/.vscode/launch.json

@@ -0,0 +1,20 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Launch Program",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}\\src\\sw\\helpers\\handleFetch\\index.ts",
+            "outFiles": [
+                "${workspaceFolder}/**/*.js"
+            ]
+        }
+    ]
+}

package/.vscode/settings.json

@@ -0,0 +1,164 @@
+{
+    // explorer
+    "explorer.autoReveal": true,
+    "explorer.incrementalNaming": "smart",
+    "debug.openExplorerOnEnd": true,
+
+    // editor
+    "editor.fontLigatures": true,
+    "editor.mouseWheelZoom": true,
+    "editor.smoothScrolling": true,
+    "editor.cursorSmoothCaretAnimation": "on",
+    "editor.minimap.enabled": false,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.formatOnPaste": true,
+    "editor.language.colorizedBracketPairs": [
+        [
+            "(",
+            ")"
+        ],
+        [
+            "[",
+            "]"
+        ],
+        [
+            "{",
+            "}"
+        ]
+    ],
+    "editor.suggestSelection": "first",
+    "editor.codeActionsOnSave": {
+        "source.fixAll": "explicit",
+        "source.organizeImports": "never"
+    },
+    "editor.guides.bracketPairs": true,
+    "editor.guides.highlightActiveBracketPair": false,
+    "editor.fontFamily": "Consolas, Monaco, Menlo,'Courier New', monospace",
+
+    // files
+    "files.autoSave": "onFocusChange",
+    "files.insertFinalNewline": true,
+    "files.trimFinalNewlines": true,
+    "files.trimTrailingWhitespace": true,
+    "files.eol": "\n",
+
+    // git
+    "git.enableSmartCommit": true,
+    "git.confirmSync": false,
+    "git.autofetch": true,
+    "git.autofetchPeriod": 60,
+    // "git.branchProtection": ["master"],
+    "git.checkoutType": [
+        "local",
+        "remote"
+    ],
+    "git.ignoreRebaseWarning": true,
+    "git.inputValidationSubjectLength": 100,
+    "git.inputValidationLength": 200,
+
+    // ts/javascript
+    // "typescript.surveys.enabled": false,
+    "javascript.suggestionActions.enabled": false,
+    "typescript.tsdk": "./node_modules/typescript/lib",
+    "typescript.updateImportsOnFileMove.enabled": "always",
+    "typescript.preferences.importModuleSpecifier": "shortest",
+    "javascript.updateImportsOnFileMove.enabled": "always",
+    "typescript.format.semicolons": "insert",
+    "javascript.format.semicolons": "insert",
+
+    // prettier
+    "prettier.enable": true,
+    "json.format.enable": true,
+    "prettier.configPath": ".prettierrc.mjs",
+    "prettier.experimentalTernaries": true,
+    "prettier.enableDebugLogs": true,
+    "prettier.prettierPath": "./node_modules/prettier",
+    "prettier.htmlWhitespaceSensitivity": "strict",
+    "[json]": {
+        "editor.formatOnSave": true
+    },
+    "[css]": {
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "vscode.css-language-features"
+    },
+    "[html]": {
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "vscode.html-language-features"
+    },
+    "[jsonc]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[xml]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[svg]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescriptreact]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascriptreact]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[markdown]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+
+    // workbench
+    "workbench.iconTheme": "vscode-icons",
+    "workbench.colorTheme": "Default Dark+",
+    "workbench.externalBrowser": "chrome",
+    "workbench.colorCustomizations": {},
+
+    // terminal
+    "terminal.integrated.defaultProfile.windows": "Git Bash",
+    "terminal.integrated.cursorBlinking": true,
+    "terminal.integrated.fontFamily": "Consolas, 'Courier New', monospace",
+    "terminal.integrated.minimumContrastRatio": 4.5,
+    "terminal.integrated.smoothScrolling": true,
+    "terminal.integrated.profiles.windows": {
+        "Bash": {
+            "path": "C:\\Program Files\\Git\\bin\\bash.exe",
+            "args": []
+        }
+    },
+    "terminal.integrated.scrollback": 500000,
+    "terminal.integrated.enablePersistentSessions": false,
+    "workbench.tree.enableStickyScroll": false,
+    "editor.stickyScroll.scrollWithEditor": false,
+    "editor.stickyScroll.enabled": false,
+    "accessibility.signals.terminalBell": {
+        "sound": "on"
+    },
+    "terminal.integrated.enableVisualBell": true,
+
+    // npm scripts
+    "npm.scriptExplorerAction": "run",
+
+    // emmet
+    "emmet.includeLanguages": {
+        "postcss": "css",
+        "javascript": "javascriptreact",
+        "typescript": "typescriptreact"
+    },
+    "emmet.showSuggestionsAsSnippets": true,
+
+    "notebook.defaultFormatter": "esbenp.prettier-vscode",
+    "window.zoomLevel": 0,
+
+    // extensions
+    "reactSnippets.settings.prettierEnabled": true,
+
+    "stylelint.configBasedir": "./",
+    "stylelint.configFile": "./stylelint.config.mjs",
+    "stylelint.packageManager": "pnpm",
+
+    "javascript.preferences.importModuleSpecifier": "non-relative",
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Вадим Бударин
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,309 @@
+# @vadimbudarin/pluggable-serviceworker
+
+🔌 Расширяемый через плагины Service Worker
+
+Библиотека для создания модульных и расширяемых Service Worker'ов с помощью системы плагинов. Позволяет легко добавлять функциональность через плагины с поддержкой приоритетов и обработки ошибок.
+
+## ✨ Особенности
+
+- 🔌 **Система плагинов** - модульная архитектура для расширения функциональности
+- 📊 **Приоритеты** - контроль порядка выполнения плагинов
+- 🛡️ **Обработка ошибок** - централизованная обработка ошибок
+- 🎯 **TypeScript** - полная поддержка типов
+- 🚀 **Простота использования** - минимальная настройка
+
+## 📦 Установка
+
+```bash
+npm install @vadimbudarin/pluggable-serviceworker
+```
+
+или
+
+```bash
+pnpm add @vadimbudarin/pluggable-serviceworker
+```
+
+## 🚀 Быстрый старт
+
+### Базовое использование
+
+```typescript
+// sw.js
+import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+
+// Простой плагин для кеширования
+const cachePlugin = {
+    name: 'cache-plugin',
+
+    install: async (event) => {
+        const cache = await caches.open('my-cache-v1');
+        await cache.addAll(['/', '/styles.css', '/script.js']);
+    },
+
+    fetch: async (event) => {
+        const cachedResponse = await caches.match(event.request);
+        return cachedResponse || fetch(event.request);
+    },
+};
+
+// Инициализация Service Worker с плагинами
+initializeServiceWorker([cachePlugin]);
+```
+
+### Использование с приоритетами
+
+```typescript
+import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+
+const authPlugin = {
+    name: 'auth-plugin',
+    priority: 1, // Выполняется первым
+
+    fetch: async (event) => {
+        // Проверка авторизации для API запросов
+        if (event.request.url.includes('/api/')) {
+            const token = await getAuthToken();
+            if (!token) {
+                return new Response('Unauthorized', { status: 401 });
+            }
+        }
+        return null; // Передать обработку следующему плагину
+    },
+};
+
+const cachePlugin = {
+    name: 'cache-plugin',
+    priority: 2, // Выполняется вторым
+
+    fetch: async (event) => {
+        const cachedResponse = await caches.match(event.request);
+        return cachedResponse || fetch(event.request);
+    },
+};
+
+const loggingPlugin = {
+    name: 'logging-plugin',
+    // Без приоритета - выполняется последним
+
+    fetch: async (event) => {
+        console.log('Запрос:', event.request.url);
+        return null;
+    },
+};
+
+initializeServiceWorker([authPlugin, cachePlugin, loggingPlugin]);
+```
+
+### Обработка ошибок
+
+```typescript
+import { initializeServiceWorker } from '@vadimbudarin/pluggable-serviceworker';
+
+const config = {
+    onError: (error, event) => {
+        console.error('Ошибка в Service Worker:', error);
+
+        // Отправка ошибки в аналитику
+        if ('fetch' in event) {
+            fetch('/api/errors', {
+                method: 'POST',
+                body: JSON.stringify({
+                    error: error.message,
+                    url: event.request?.url,
+                    timestamp: Date.now(),
+                }),
+            }).catch(() => {
+                // Игнорируем ошибки отправки логов
+            });
+        }
+    },
+};
+
+initializeServiceWorker(
+    [
+        /* ваши плагины */
+    ],
+    config
+);
+```
+
+## 🔧 API
+
+### ServiceWorkerPlugin
+
+Интерфейс плагина:
+
+```typescript
+interface ServiceWorkerPlugin {
+    name: string; // Уникальное имя плагина
+    priority?: number; // Приоритет выполнения (меньше = раньше)
+    install?: (event: ExtendableEvent) => void | Promise<void>;
+    activate?: (event: ExtendableEvent) => void | Promise<void>;
+    fetch?: (event: FetchEvent) => Promise<Response | null>;
+    message?: (event: MessageEvent) => void;
+    sync?: (event: SyncEvent) => void;
+    push?: (event: PushEvent) => void;
+}
+```
+
+### initializeServiceWorker
+
+Основная функция для инициализации Service Worker:
+
+```typescript
+function initializeServiceWorker(
+    plugins: ServiceWorkerPlugin[],
+    config?: ServiceWorkerConfig
+): void;
+```
+
+### ServiceWorkerConfig
+
+Конфигурация Service Worker:
+
+```typescript
+interface ServiceWorkerConfig {
+    plugins?: ServiceWorkerPlugin[];
+    onError?: (error: Error, event: Event) => void;
+}
+```
+
+## 📝 Примеры плагинов
+
+### Плагин кеширования
+
+```typescript
+const cachePlugin = {
+    name: 'advanced-cache',
+    priority: 10,
+
+    install: async (event) => {
+        const cache = await caches.open('app-cache-v1');
+        await cache.addAll([
+            '/',
+            '/offline.html',
+            '/assets/app.css',
+            '/assets/app.js',
+        ]);
+    },
+
+    fetch: async (event) => {
+        // Стратегия "Cache First" для статических ресурсов
+        if (event.request.url.includes('/assets/')) {
+            const cachedResponse = await caches.match(event.request);
+            return cachedResponse || fetch(event.request);
+        }
+
+        // Стратегия "Network First" для API
+        if (event.request.url.includes('/api/')) {
+            try {
+                const response = await fetch(event.request);
+                const cache = await caches.open('api-cache-v1');
+                cache.put(event.request, response.clone());
+                return response;
+            } catch (error) {
+                return caches.match(event.request);
+            }
+        }
+
+        return null;
+    },
+};
+```
+
+### Плагин уведомлений
+
+```typescript
+const notificationPlugin = {
+    name: 'notifications',
+
+    push: (event) => {
+        const data = event.data?.json() || {};
+
+        const options = {
+            body: data.body || 'Новое уведомление',
+            icon: data.icon || '/icon-192x192.png',
+            badge: '/badge-72x72.png',
+            tag: data.tag || 'default',
+            data: data.url ? { url: data.url } : undefined,
+        };
+
+        self.registration.showNotification(
+            data.title || 'Уведомление',
+            options
+        );
+    },
+
+    message: (event) => {
+        if (event.data?.type === 'NOTIFICATION_CLICK') {
+            // Обработка клика по уведомлению
+            clients.openWindow(event.data.url);
+        }
+    },
+};
+```
+
+### Плагин фоновой синхронизации
+
+```typescript
+const backgroundSyncPlugin = {
+    name: 'background-sync',
+
+    sync: (event) => {
+        if (event.tag === 'background-sync') {
+            event.waitUntil(doBackgroundSync());
+        }
+    },
+};
+
+async function doBackgroundSync() {
+    // Получение отложенных задач из IndexedDB
+    const tasks = await getPendingTasks();
+
+    for (const task of tasks) {
+        try {
+            await fetch(task.url, {
+                method: task.method,
+                body: task.body,
+                headers: task.headers,
+            });
+
+            await removeTask(task.id);
+        } catch (error) {
+            console.error('Ошибка синхронизации:', error);
+        }
+    }
+}
+```
+
+## 🎯 Порядок выполнения
+
+Плагины выполняются в следующем порядке:
+
+1. **Плагины с приоритетом** - сортируются по возрастанию значения `priority`
+2. **Плагины без приоритета** - выполняются в порядке добавления
+
+### Пример:
+
+```typescript
+const plugins = [
+    { name: 'third', priority: 30 },
+    { name: 'first', priority: 10 },
+    { name: 'fourth' }, // без приоритета
+    { name: 'second', priority: 20 },
+    { name: 'fifth' }, // без приоритета
+];
+
+// Порядок выполнения: first → second → third → fourth → fifth
+```
+
+## 🛡️ Обработка ошибок
+
+- Ошибки в плагинах автоматически перехватываются
+- Можно настроить кастомный обработчик через `config.onError`
+- Ошибка в одном плагине не останавливает выполнение других
+
+## 📄 Лицензия
+
+MIT © Vadim Budarin

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+interface SyncEvent extends ExtendableEvent {
+    readonly tag: string;
+    readonly lastChance: boolean;
+}
+declare global {
+    interface ServiceWorkerGlobalScopeEventMap {
+        sync: SyncEvent;
+    }
+}
+interface ServiceWorkerEventHandlers {
+    install?: (event: ExtendableEvent) => void | Promise<void>;
+    activate?: (event: ExtendableEvent) => void | Promise<void>;
+    fetch?: (event: FetchEvent) => Promise<Response | null>;
+    message?: (event: MessageEvent) => void;
+    sync?: (event: SyncEvent) => void;
+    push?: (event: PushEvent) => void;
+}
+interface ServiceWorkerPlugin extends ServiceWorkerEventHandlers {
+    name: string;
+    priority?: number;
+}
+interface ServiceWorkerConfig {
+    plugins?: ServiceWorkerPlugin[];
+    onError?: (error: Error, event: Event) => void;
+}
+export declare function createEventHandlers(plugins: ServiceWorkerPlugin[], config?: ServiceWorkerConfig): {
+    install: (event: ExtendableEvent) => void;
+    activate: (event: ExtendableEvent) => void;
+    fetch: (event: FetchEvent) => void;
+    message: (event: MessageEvent) => void;
+    sync: (event: SyncEvent) => void;
+    push: (event: PushEvent) => void;
+};
+export declare function initializeServiceWorker(plugins: ServiceWorkerPlugin[], config?: ServiceWorkerConfig): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,84 @@
+export function createEventHandlers(plugins, config = {}) {
+    const handlers = {
+        install: [],
+        activate: [],
+        fetch: [],
+        message: [],
+        sync: [],
+        push: [],
+    };
+    const sortedPlugins = [
+        ...plugins
+            .filter((plugin) => plugin.priority !== undefined)
+            .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0)),
+        ...plugins.filter((plugin) => plugin.priority === undefined),
+    ];
+    sortedPlugins.forEach((plugin) => {
+        if (plugin.install)
+            handlers.install.push(plugin.install);
+        if (plugin.activate)
+            handlers.activate.push(plugin.activate);
+        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.push)
+            handlers.push.push(plugin.push);
+    });
+    return {
+        install: (event) => {
+            event.waitUntil(Promise.all(handlers.install.map((handler) => Promise.resolve(handler(event)).catch((error) => config.onError?.(error, event)))));
+        },
+        activate: (event) => {
+            event.waitUntil(Promise.all(handlers.activate.map((handler) => Promise.resolve(handler(event)).catch((error) => config.onError?.(error, event)))));
+        },
+        fetch: (event) => {
+            event.respondWith((async () => {
+                for (const handler of handlers.fetch) {
+                    try {
+                        const result = await handler(event);
+                        if (result) {
+                            return result;
+                        }
+                    }
+                    catch (error) {
+                        config.onError?.(error, event);
+                    }
+                }
+                return fetch(event.request);
+            })());
+        },
+        message: (event) => {
+            handlers.message.forEach((handler) => {
+                try {
+                    handler(event);
+                }
+                catch (error) {
+                    config.onError?.(error, event);
+                }
+            });
+        },
+        sync: (event) => {
+            handlers.sync.forEach((handler) => {
+                handler(event);
+            });
+        },
+        push: (event) => {
+            handlers.push.forEach((handler) => {
+                handler(event);
+            });
+        },
+    };
+}
+export function initializeServiceWorker(plugins, config) {
+    const handlers = createEventHandlers(plugins, config);
+    self.addEventListener('install', handlers.install);
+    self.addEventListener('activate', handlers.activate);
+    self.addEventListener('fetch', handlers.fetch);
+    self.addEventListener('message', handlers.message);
+    self.addEventListener('sync', handlers.sync);
+    self.addEventListener('push', handlers.push);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@budarin/pluggable-serviceworker",
+  "version": "1.0.1",
+  "description": "Extensible via plugins service worker",
+  "keywords": [
+    "serviceworker",
+    "plugins",
+    "extensible",
+    "serviceworker-plugins",
+    "serviceworker-plugins-extensible"
+  ],
+  "author": "Vadim Budarin",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./dist/index.d.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "@types/serviceworker": "^0.0.153",
+    "@types/web": "^0.0.269",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "publish-package": "pnpm build && pnpm publish --access=public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,156 @@
+interface SyncEvent extends ExtendableEvent {
+    readonly tag: string;
+    readonly lastChance: boolean;
+}
+
+// Extend ServiceWorkerGlobalScope to include sync event
+declare global {
+    interface ServiceWorkerGlobalScopeEventMap {
+        sync: SyncEvent;
+    }
+}
+
+interface ServiceWorkerEventHandlers {
+    install?: (event: ExtendableEvent) => void | Promise<void>;
+    activate?: (event: ExtendableEvent) => void | Promise<void>;
+    fetch?: (event: FetchEvent) => Promise<Response | null>;
+    message?: (event: MessageEvent) => void;
+    sync?: (event: SyncEvent) => void;
+    push?: (event: PushEvent) => void;
+}
+
+interface ServiceWorkerPlugin extends ServiceWorkerEventHandlers {
+    name: string;
+    priority?: number;
+}
+
+interface ServiceWorkerConfig {
+    plugins?: ServiceWorkerPlugin[];
+    onError?: (error: Error, event: Event) => void;
+}
+
+type FetchResponse = Promise<Response | null>;
+
+export function createEventHandlers(
+    plugins: ServiceWorkerPlugin[],
+    config: ServiceWorkerConfig = {}
+): {
+    install: (event: ExtendableEvent) => void;
+    activate: (event: ExtendableEvent) => void;
+    fetch: (event: FetchEvent) => void;
+    message: (event: MessageEvent) => void;
+    sync: (event: SyncEvent) => void;
+    push: (event: PushEvent) => void;
+} {
+    const handlers = {
+        install: [] as ((event: ExtendableEvent) => void | Promise<void>)[],
+        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)[],
+    };
+
+    // Здесь происходит сортировка плагинов по их приоритету.
+    // Сначала выбираются плагины, у которых явно указан priority (plugin.priority !== undefined),
+    // затем они сортируются по возрастанию этого значения (меньший priority — выше в списке).
+    // После отсортированных по приоритету плагинов добавляются все остальные плагины,
+    // у которых priority не указан (plugin.priority === undefined), сохраняя их исходный порядок.
+    const sortedPlugins = [
+        ...plugins
+            .filter((plugin) => plugin.priority !== undefined)
+            .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0)),
+        ...plugins.filter((plugin) => plugin.priority === undefined),
+    ];
+
+    sortedPlugins.forEach((plugin) => {
+        if (plugin.install) handlers.install.push(plugin.install);
+        if (plugin.activate) handlers.activate.push(plugin.activate);
+        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.push) handlers.push.push(plugin.push);
+    });
+
+    return {
+        install: (event: ExtendableEvent): void => {
+            event.waitUntil(
+                Promise.all(
+                    handlers.install.map((handler) =>
+                        Promise.resolve(handler(event)).catch(
+                            (error: unknown) =>
+                                config.onError?.(error as Error, event)
+                        )
+                    )
+                )
+            );
+        },
+
+        activate: (event: ExtendableEvent): void => {
+            event.waitUntil(
+                Promise.all(
+                    handlers.activate.map((handler) =>
+                        Promise.resolve(handler(event)).catch(
+                            (error: unknown) =>
+                                config.onError?.(error as Error, event)
+                        )
+                    )
+                )
+            );
+        },
+
+        fetch: (event: FetchEvent): void => {
+            event.respondWith(
+                (async (): Promise<Response> => {
+                    for (const handler of handlers.fetch) {
+                        try {
+                            const result = await handler(event);
+                            if (result) {
+                                return result;
+                            }
+                        } catch (error) {
+                            config.onError?.(error as Error, event);
+                        }
+                    }
+                    return fetch(event.request);
+                })()
+            );
+        },
+
+        message: (event: MessageEvent): void => {
+            handlers.message.forEach((handler) => {
+                try {
+                    handler(event);
+                } catch (error) {
+                    config.onError?.(error as Error, event);
+                }
+            });
+        },
+
+        sync: (event: SyncEvent): void => {
+            handlers.sync.forEach((handler) => {
+                handler(event);
+            });
+        },
+
+        push: (event: PushEvent): void => {
+            handlers.push.forEach((handler) => {
+                handler(event);
+            });
+        },
+    };
+}
+
+export function initializeServiceWorker(
+    plugins: ServiceWorkerPlugin[],
+    config?: ServiceWorkerConfig
+): void {
+    const handlers = createEventHandlers(plugins, config);
+
+    self.addEventListener('install', handlers.install);
+    self.addEventListener('activate', handlers.activate);
+    self.addEventListener('fetch', handlers.fetch);
+    self.addEventListener('message', handlers.message);
+    self.addEventListener('sync', handlers.sync);
+    self.addEventListener('push', handlers.push);
+}

package/tsconfig.json

@@ -0,0 +1,44 @@
+{
+    // Visit https://aka.ms/tsconfig to read more about this file
+    "compilerOptions": {
+        // File Layout
+        "rootDir": "./src",
+        "outDir": "./dist",
+
+        // Environment Settings
+        // See also https://aka.ms/tsconfig/module
+        "module": "nodenext",
+        "target": "esnext",
+        // For nodejs:
+        "lib": ["esnext"],
+        "types": ["node", "serviceworker", "web"],
+        // and npm install -D @types/node
+
+        // Other Outputs
+        "sourceMap": true,
+        "declaration": true,
+        "declarationMap": true,
+
+        // Stricter Typechecking Options
+        "noUncheckedIndexedAccess": true,
+        "exactOptionalPropertyTypes": true,
+
+        // Style Options
+        "noImplicitReturns": true,
+        "noImplicitOverride": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noFallthroughCasesInSwitch": true,
+        "noPropertyAccessFromIndexSignature": true,
+
+        // Recommended Options
+        "strict": true,
+        "jsx": "react-jsx",
+        "verbatimModuleSyntax": true,
+        "isolatedModules": true,
+        "noUncheckedSideEffectImports": true,
+        "moduleDetection": "force",
+        "skipLibCheck": true,
+        "removeComments": true
+    }
+}