feat(plugins): count marketplace downloads and installs

This commit is contained in:
t8y2 committed 2026-09-15 14:24:11 +08:00
1 parent 83c8447b4d
commit 08c163fe32
6 files changed
+178 -1

No files matched your search

+34
View File
@@ -0,0 +1,34 @@
# plugin-stats-worker
Cloudflare Worker that counts plugin marketplace traffic. Deployed on the same
Cloudflare account as the dbxio.com site (`pnpm dlx wrangler deploy` from this
directory; OAuth login required).
## Routes
- `dl.dbxio.com/plugins/*` — counts every `GET` of a marketplace artifact, then
passes the request through to the R2 custom domain. Artifact bytes, headers,
and Range semantics are untouched; the route sits in front of the origin only.
- `dbxio.com/api/plugins/*` —
`POST /api/plugins/install` is the fire-and-forget beacon the desktop app
sends after a successful marketplace install;
`GET /api/plugins/stats` returns the current counters
(`{ downloads: {key: n}, installs: {key: n} }`) and is how counters should be
read (the wrangler CLI can show a stale/split view of a fresh namespace).
## Storage
Single KV namespace `plugin_stats` (binding `PLUGIN_STATS`):
- `dl:{pluginId}:{version}` — passive artifact download count
- `inst:{pluginId}:{version}` — client-reported install count
Counters are best-effort (KV read-modify-write can drop counts under same-key
concurrency; acceptable for decorative stats). Inspect values with:
```sh
pnpm dlx wrangler kv key list --namespace-id 483dcc36cd3c4da5af5cdbb4532166f2 --prefix "dl:io.dbx.ssh"
pnpm dlx wrangler kv key get --namespace-id 483dcc36cd3c4da5af5cdbb4532166f2 "dl:io.dbx.ssh:0.4.73"
```
No display in the app yet; counts accrue until the marketplace UI surfaces them.