@blueforge-studio/forge-git-sdk

Typed SDK for the forge-git platform — self-hosted Gitea plus forge-git-specific endpoints. This is the same client the fgit CLI and the web wrap use, re-exported one-to-one.

Install

npm i @blueforge-studio/forge-git-sdk

The package is on the private packr registry — your project needs the @blueforge-studio scope map in .npmrc plus a PACKR_TOKEN-authorized token (see the packr docs). No runtime dependencies: the client and its one library dep are bundled into a single ESM file.

Quickstart

import { getPullRequest, mergePullRequest } from '@blueforge-studio/forge-git-sdk'

// Auth + base URL come from FORGE_GIT_TOKEN / FORGE_GIT_URL, or pass
// { token, baseUrl } per call.
const pr = await getPullRequest('blueforge-studio', 'my-repo', 42)
if (!pr.merged && pr.mergeable) {
  await mergePullRequest('blueforge-studio', 'my-repo', 42, { style: 'squash' })
}

Docs

• SDK guide — install, auth, quickstart, error handling.
• API reference — every function, by area, plus the forge-git-specific REST endpoints that sit above Gitea.