Forgejo Releases

@reset/forgejo-releasesv2026.10.22.1· MIT· 1d agoBEHAVIORSACCEPTED WARNINGS

01README

Record Forgejo or Gitea releases and their asset downloads.

02Behaviors1

@reset/forgejo-releasesv2026.10.22.1forgejo_releases.ts

Argument	Type	Required	Description
host	string	yes	Base https URL of the Forgejo or Gitea host, e.g. https://codeberg.org; the API is under /api/v1
token?	string	no	Optional access token for a private repository, supplied with a vault.get expression, never a literal. Sent only as an Authorization token header

fn sample(owner: string, repo: string)

Read a repository's releases from the host's /api/v1 releases endpoint and record them as a new version

Argument	Type	Required	Description
owner	string	yes	Repository owner, the user or organisation, e.g. forgejo
repo	string	yes	Repository name, e.g. forgejo

fn summarise(owner: string, repo: string, since?: string)

Summarise the recorded samples of a repository: per release and asset the first and latest download count and the change, and the total downloads

Argument	Type	Required	Description
owner	string	yes	Repository owner, the user or organisation, e.g. forgejo
repo	string	yes	Repository name, e.g. forgejo
since?	string	no	Only summarise samples recorded at or after this ISO-8601 time; all samples when omitted

releases(infinite)— One repository's releases and their assets' download counts at one moment, flagging releases new since the previous version

summary(infinite)— Per release and asset the first and latest download count and the change, and the total downloads

03Stats

86 / 100

Downloads

Archive size

16.7 KB

05Platforms

06Labels

04Accepted warnings1