Tracks daily downloads count for packages. Data is stored in a Postgres database.
- Tracks daily and total downloads count for packages
- Stores data in a Postgres database
There is currently no web UI or endpoints for retrieving downloads count stats, the only way is via running queries on the database.
- Postgres Database (Tested on Postgres 15)
- Verdaccio 5
Install like any other Verdaccio middleware.
npm install verdaccio-downloads-count
To use the middleware, you will need to add the middleware to your verdaccio's config middleware option.
middlewares:
downloads-count:
# (Required) Connection string to the database. Standard Postgres connection string. Can also be set by VDC_DB_CONNECTION_STRING
connectionString: <Postgres Connection String>
# (Optional) Automatically migrate the database. Uses the postgres-migrations package for handling migration.
migrate: true
Since this package stores its data in Postgres database, the database will need to contain the schema this package needs.
If the migrate option is enabled in the config, then this package will automatically maintain the migrations using the postgres-migrations package. Otherwise you will need to maintain the database migrations your self. Migrations scripts can be found migrations/ directory within the package (or repo).
Why use Postgres as the datastore for storing package downloads count? Simple, all other packages use a different datastore for storing the data, and I already use Postgres in my stack, but not the others, and I don't currently want to introduce another one of these solutions just for storing downloads count.
Other solutions include:
- verdaccio-install-counts - Uses Redis
- @xlts.dev/verdaccio-prometheus-middleware - Uses prometheus
- Voltstro - Initial work - Voltstro
-
verdaccio-install-counts - Provided base example on tracking downlands count.
parseVersionFromTarballFilenamemethod comes from here too.