Works offline: detect it from the service worker, tag listings, filter by it

[ralyodio]

Anthony asked: when a listing is created, work out whether the PWA works offline and tag it as a feature the store can filter by.

Detection (apps/web/src/inspect.js)

• serviceWorkerUrls() parses navigator.serviceWorker.register('<url>') (minified and new URL(...) forms too). Only same-origin URLs count.
• detectOffline() tries candidates in this order: what the page registers, the manifest's serviceworker.src, one small same-origin registration script (for example vite-plugin-pwa's registerSW.js), then /sw.js, /service-worker.js, /serviceworker.js and /sw.min.js. It makes at most 4 fetches through safeFetch, each capped at 1 MB and 5 s. An SPA's catch-all index.html is not accepted as a worker.
• classifyServiceWorker() returns offline for Workbox, or for a fetch handler that uses the Cache API. A pass-through fetch handler, a push-only worker or no worker at all gives false. The reason is stored.
• New recommended check: "Works offline".

Storage

Migration 0011_app_features.sql adds apps.features text[] with a GIN index, plus offline_reason and features_checked_at. These are set on submit, on refresh, on the saasrow import, and during release-detect's daily re-read. A new daemon job, feature-backfill, re-inspects 6 never-checked listings every 2 minutes.

Surfaces

• GET /api/v1/apps?feature=offline (alias offline=1). An unknown feature returns 400.
• Browse has a "Works offline" chip that keeps q, category, sort and publisher. The home page links to the filter. Cards and the details page show a tag. shape() now includes features, offline and offline_reason.
• CLI 0.6.0: pwamart search|browse --offline. MCP 0.6.0: search_apps takes feature or offline.
• sw.js VERSION is bumped to v5.

Tests

• Unit tests in test/offline.test.js cover the classifier and the URL parser.
• API tests: the fixture's notes app is offline-capable and todo only passes requests through. The tests check the filter, the browse chip, the tags and the backfill. All 94 pass against Postgres 16.

🤖 Generated with Claude Code