@budarin/psw-plugin-opfs-serve-range 1.1.9 → 1.1.11

package/README.md

@@ -163,10 +163,6 @@ The response may not have a `Content-Length` header – when writing the full bo
 
 Client‑side helpers are exported from the entry point `@budarin/psw-plugin-opfs-serve-range/client`. This section gives signatures, types, and examples; [opfs-cache-behavior.md](https://github.com/budarin/psw-plugin-opfs-serve-range/blob/master/docs/opfs-cache-behavior.md) only describes **when** the service worker sends messages (limits, LRU, eviction), not the API.
 
-### Message payload
-
-Each handler receives a `MessageEvent`; `event.data` is `{ type: string } & OpfsMessagePayload`, and some events add a `count` field. The package type `OpfsMessagePayload` is `{ url?: string; size?: number; limit?: number; reason?: string }`.
-
 ### Message subscriptions
 
 Each function takes a handler and returns an unsubscribe function (call it to remove the subscription). Below are the subscriptions for messages that the service worker actually sends in the current version.
@@ -233,15 +229,11 @@ type Unsubscribe = () => void;
     onOPFSSkipQuotaExceeded(handler: (event: MessageEvent<EventData>) => void): Unsubscribe
     ```
 
-### Cache management and types
+### Cache management utilities
 
-- **`listOpfsCachedResources`** — returns the list of cached resources.
-
-    ```ts
-    listOpfsCachedResources(): Promise<OpfsCachedResource[]>
-    ```
+Functions to list cached resources, check by URL, and remove by URL. Called from the client (page); use when you need to show the user what is cached and let them delete selected items.
 
-    Each array element:
+- **`listOpfsCachedResources`** — returns the list of cached resources.
 
     ```ts
     interface OpfsCachedResource {
@@ -250,6 +242,8 @@ type Unsubscribe = () => void;
       type: string | undefined;
       lastModified: string | undefined;
     }
+
+    listOpfsCachedResources(): Promise<OpfsCachedResource[]>
     ```
 
 - **`hasInOpfsCache`** — checks whether a URL is in the cache.
@@ -296,7 +290,7 @@ When each message is sent: [opfs-cache-behavior.md](https://github.com/budarin/p
 
 ### Clearing the cache and managing individual resources
 
-To wipe the whole cache (e.g. from a UI button or on logout), call `clearOpfsCache()` from the service worker or client – the entire cache directory will be deleted.
+To wipe the whole cache (e.g. from a UI button or on logout), call **clearOpfsCache()** from the service worker or client – the entire cache directory will be deleted.
 
 If you need finer‑grained control (show a list of cached resources and let users delete specific ones), use the client utilities from `@budarin/psw-plugin-opfs-serve-range/client`: `listOpfsCachedResources`, `hasInOpfsCache`, `deleteFromOpfsCache` (see above). The list is built from metadata in the footer (each file stores its original `url`).
 

package/README.ru.md

@@ -153,10 +153,6 @@ await writeToOpfs(dir, key, response.body, metadata);
 
 Клиентские хелперы экспортируются из entry point `@budarin/psw-plugin-opfs-serve-range/client`. В этом разделе — сигнатуры, типы и примеры; в [opfs-cache-behavior.ru.md](https://github.com/budarin/psw-plugin-opfs-serve-range/blob/master/docs/opfs-cache-behavior.ru.md) описано только **когда** сервис-воркер шлёт сообщения (лимиты, LRU, эвикция), не API.
 
-### Данные в сообщениях
-
-Обработчик получает `MessageEvent`; `event.data` имеет тип `{ type: string } & OpfsMessagePayload` плюс при необходимости поле `count`. Тип `OpfsMessagePayload` в пакете: `{ url?: string; size?: number; limit?: number; reason?: string }`.
-
 ### Подписки на сообщения
 
 Каждая функция принимает обработчик и возвращает функцию отписки (вызов снимает подписку). Ниже перечислены подписки, сообщения которых сервис-воркер реально отправляет в текущей версии.
@@ -223,15 +219,11 @@ type Unsubscribe = () => void;
     onOPFSSkipQuotaExceeded(handler: (event: MessageEvent<EventData>) => void): Unsubscribe
     ```
 
-### Управление кешем и типы
+### Утилиты управления кэшем
 
-- **`listOpfsCachedResources`** — возвращает список закешированных ресурсов.
-
-    ```ts
-    listOpfsCachedResources(): Promise<OpfsCachedResource[]>
-    ```
+Функции для получения списка закешированных ресурсов, проверки по URL и удаления по URL. Вызываются на клиенте (страница); нужны, когда надо показать пользователю, что в кэше, и дать удалить выбранное.
 
-    Элемент массива:
+- **`listOpfsCachedResources`** — возвращает список закешированных ресурсов.
 
     ```ts
     interface OpfsCachedResource {
@@ -240,6 +232,8 @@ type Unsubscribe = () => void;
       type: string | undefined;
       lastModified: string | undefined;
     }
+
+    listOpfsCachedResources(): Promise<OpfsCachedResource[]>
     ```
 
 - **`hasInOpfsCache`** — проверяет наличие URL в кеше.
@@ -286,7 +280,7 @@ const unsubSkip = onOPFSSkipQuotaExceeded((event: MessageEvent) => {
 
 ### Очистка кеша и управление отдельными ресурсами
 
-Когда нужно сбросить весь кеш (например, по кнопке в UI или при логауте), можно вызвать `clearOpfsCache()` из сервис-воркера или клиента — будет удалена вся папка кеша.
+Когда нужно сбросить весь кеш (например, по кнопке в UI или при логауте), можно вызвать **clearOpfsCache()** из сервис-воркера или клиента — будет удалена вся папка кеша.
 
 Если нужно работать с отдельными ресурсами (показать пользователю список сохранённых файлов и дать удалить что-то выборочно), используйте клиентские утилиты из entry point `@budarin/psw-plugin-opfs-serve-range/client`: `listOpfsCachedResources`, `hasInOpfsCache`, `deleteFromOpfsCache` (см. выше). Список в кеше строится по метаданным в футере (там хранится исходный url каждого ресурса).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@budarin/psw-plugin-opfs-serve-range",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Service Worker plugin: serve HTTP Range requests from OPFS files",
   "keywords": [
     "service-worker",