pushin.eu
The pushin.eu provider covers pushin.eu, a European git host with an API modelled on GitHub's. The provider reads repositories, labels, collaborators, issues, pull requests, comments and notifications. The API's OpenAPI specification documents its endpoints.
| Detail | Value |
|---|---|
| Import | forges/pushin |
| Factories | pushin() |
| Auth | token, anonymous |
Authentication
The provider accepts a personal access token that you create in your pushin.eu settings. Tokens start with pun_pat_ and aren't scoped to specific resources. The provider sends the token in an Authorization: Bearer <token> header:
import { pushin } from 'forges/pushin'
const forge = pushin({
auth: { type: 'token', token: process.env.PUSHIN_TOKEN! },
}).create()
Without auth, the provider reads public repositories anonymously.
Instance
baseUrl defaults to https://pushin.eu, and the provider appends /api/v1.
Issues and pull requests
threads.get() reads issues and pull requests. threads.list() lists both by default; set kind: 'issue' or kind: 'pull_request' to select one kind. threads.comments() reads comments on both kinds.
Listings use Link pagination and include rate-limit information from the response headers.
Notifications
notifications.list() reads the authenticated account's notifications. Set all: true to include read notifications, or since to filter by activity time. Notification writes aren't supported.
Thread events
The API has no timeline. threads.events() is 'emulated' from the comment listing, and returns comment events only.
Labels
Label.colour contains six-digit hex colours when supplied by the API. Named colours, such as purple, leave Label.colour unset.
Accounts
The API reads only the authenticated account, so users.get(login) is unavailable.
Webhooks
The API has no hook endpoints and no documented signature scheme. capabilities.sources.webhook is false, and the provider doesn't verify or translate deliveries.
pushin() contains no webhook code, so the provider has no pushinLite() factory.
Recording fixtures
PUSHIN_TOKEN=... FIXTURE_PUSHIN_REPO=pjullrich/pushin \
pnpm record-fixtures pushin
To choose the threads to record, set FIXTURE_PUSHIN_ISSUE and FIXTURE_PUSHIN_PULL. To record another deployment, set PUSHIN_BASE_URL. The recorder redacts pun_pat_ tokens.
Capabilities
Generated by pnpm capability-matrix; do not edit by hand.
| Capability | Support |
|---|---|
experimental | ✅ |
sources.poll | ❌ |
sources.webhook | ❌ |
sources.subscribe | ❌ |
repos.get | ✅ |
users.get | ❌ |
repos.list | experimental |
repos.labels | ✅ |
repos.createLabel | ❌ |
repos.milestones | ❌ |
repos.collaborators | experimental |
repos.permissionFor | ❌ |
repos.addCollaborator | ❌ |
repos.assignableUsers | ❌ |
repos.reviewerCandidates | ❌ |
threads.get | issue, PR (experimental) |
threads.list | issue, PR (experimental) |
threads.getMany | ✅ |
comments.list | issue, PR (experimental) |
comments.edit | ❌ |
comments.delete | ❌ |
reactions.list | ❌ |
notifications.list | experimental |
notifications.markRead | ❌ |
notifications.markDone | ❌ |
notifications.unsubscribe | ❌ |
notifications.markAllRead | ❌ |
notifications.markAllDone | ❌ |
notifications.unreadCount | ❌ |
writes.comment | ❌ |
writes.upsertComment | ❌ |
writes.close | ❌ |
writes.reopen | ❌ |
writes.create | ❌ |
writes.update | ❌ |
writes.setLabels | ❌ |
writes.addLabels | ❌ |
writes.removeLabels | ❌ |
writes.setMilestone | ❌ |
writes.react | ❌ |
writes.setAssignees | ❌ |
writes.requestReview | ❌ |
writes.merge | ❌ |
writes.approveAndMerge | ❌ |
writes.transfer | ❌ |
writes.markDuplicate | ❌ |
subscriptions.get | ❌ |
subscriptions.set | ❌ |
installations | ❌ |
checks.thread | ❌ |
checks.list | ❌ |
checks.report | ❌ |
checks.rerun | ❌ |
ci.runs | ❌ |
ci.run | ❌ |
ci.jobs | ❌ |
ci.log | ❌ |
contents.file | ❌ |
contents.tree | ❌ |
contents.branches | ❌ |
contents.tags | ❌ |
contents.resolveRef | ❌ |
contents.commits | ❌ |
contents.commit | ❌ |
contents.compare | ❌ |
contents.threadFiles | ❌ |
contents.threadCommits | ❌ |
reviews.list | ❌ |
reviews.create | ❌ |
reviews.submit | ❌ |
reviews.approve | ❌ |
reviews.resolveThread | ❌ |
releases.list | ❌ |
releases.get | ❌ |
releases.latest | ❌ |
releases.getByTag | ❌ |
releases.downloadAsset | ❌ |
webhooks.list | ❌ |
webhooks.create | ❌ |
webhooks.update | ❌ |
webhooks.delete | ❌ |
webhooks.rotateSecret | ❌ |
webhooks.deliveries | ❌ |
webhooks.redeliver | ❌ |
search.threads | ❌ |
search.repos | ❌ |
search.commits | ❌ |
securityAlerts | ❌ |
eventKinds | native |
auth | token, anonymous |
limits | unknown |