chore: update comment in example sw

This commit is contained in:
Ayo Ayco 2024-08-03 10:31:50 +02:00
parent 489c458de1
commit fb8a4699cb
2 changed files with 39 additions and 1 deletions

38
README.md Normal file
View file

@ -0,0 +1,38 @@
> **>>> TL;DR:** Simple Astro integration to use your own authored service-worker; by default, devs retain full control as opposed to getting generated sw code
# Astro SW
The integration `serviceWorker` accepts configuration with service worker path and automatically injects needed dynamic variables such as `assets` generated by Astro for caching
## Usage
Example `astro.config.mjs`
```js
import { defineConfig } from "astro/config";
import node from "@astrojs/node";
import serviceWorker from "@ayco/astro-sw";
export default defineConfig({
output: "server",
adapter: node({
mode: "middleware"
}),
integrations: [
serviceWorker({
path: "./src/sw.js",
assetCachePrefix: 'cozy-reader',
})
]
});
```
## API
The integration accepts a configuration object of type `ServiceWorkerConfig` with the following properties
| property | type | required? | notes |
| --- | --- | --- | --- |
| path | string | required | path to your *own* service worker script; no surprises & easy debugging |
| assetCachePrefix | string | optional | cache storage name prefix; useful for debugging & invalidation |
| assetCacheVersionID | string | optional | cache storage name versioning; by default, a random UUID is used but you can provide your own for easy debugging |

View file

@ -1,6 +1,6 @@
/**
* Note: @ayco/astro-sw integration injects variables `__prefix`, `__version`, & `__assets`
* -- find usage in `astro.config.mjs` integrations
* -- find usage in package readme; `astro.config.mjs` integrations
* @see https://ayco.io/n/@ayco/astro-sw
*/
const cacheName = `${__prefix ?? 'app'}-v${__version ?? '000'}`