forges 0.0.0 → 0.1.0

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Roe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# forges
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![Github Actions][github-actions-src]][github-actions-href]
+[![Codecov][codecov-src]][codecov-href]
+
+One client, every forge.
+
+`forges` is a TypeScript library for working with issues, pull requests, notifications, checks and webhooks on ten forges: GitHub, GitLab, Bitbucket, Forgejo, Gitea, Gitee, Azure DevOps, Cursor Origin, Tangled and Pushin.eu. A forge is a service that hosts Git repositories and the collaboration around them. Each provider normalises the forge's responses into one data model and declares which operations it supports.
+
+Read the documentation at [forges.link](https://forges.link).
+
+## install
+
+```sh
+pnpm add forges
+```
+
+`forges` requires Node.js 22.18 or later.
+
+## usage
+
+```ts
+import { createForges, forgejo, github } from 'forges'
+
+const forges = createForges([
+  github({ auth: { type: 'token', token: process.env.GITHUB_TOKEN! } }),
+  forgejo({ baseUrl: 'https://codeberg.org', auth: { type: 'token', token: process.env.CODEBERG_TOKEN! } }),
+])
+
+for await (const notification of forges.notifications.list()) {
+  console.log(notification.ref.forge, notification.title)
+}
+```
+
+The example above lists the notifications of two forges in a single loop. To go further, the [quick start](https://forges.link/getting-started/quick-start) walks you through reading a thread, writing a comment and checking what a forge supports.
+
+## documentation
+
+- [Getting started](https://forges.link/getting-started/introduction) covers installation, import paths and a first call.
+- The [guides](https://forges.link/guides/authentication) explain authentication, working with several forges, environment variables, webhooks, capabilities, errors, pagination, browser bundles and testing.
+- The [concepts](https://forges.link/concepts/data-model) describe the data model, capabilities, providers and events.
+- Each [provider page](https://forges.link/providers) explains how to authenticate and how that forge behaves.
+- The [reference](https://forges.link/reference/overview) lists the API, the capability matrix, errors and JSON schemas.
+- The [examples](https://forges.link/examples) are small, tested projects that use `forges`.
+
+## related projects
+
+- [`@agntn/forges`](https://github.com/agntn/forges): a TypeScript API for GitHub, GitLab, Gitea, Forgejo and GitBucket, with an MCP server and Pi and OMP extensions for agents.
+- [`git-pkgs/forge`](https://github.com/git-pkgs/forge): a Go library and CLI for GitHub, GitLab, Gitea, Forgejo, Bitbucket Cloud, Gerrit and Tangled.
+
+## contributing
+
+Contributions are welcome. The [contribution guide](./CONTRIBUTING.md) explains how to set up the repository and run the checks.
+
+## licence
+
+Made with ❤️
+
+Published under the [MIT licence](./LICENCE).
+
+<!-- Badges -->
+
+[npm-version-src]: https://npmx.dev/api/registry/badge/version/forges
+[npm-version-href]: https://npmx.dev/package/forges
+[npm-downloads-src]: https://npmx.dev/api/registry/badge/downloads/forges
+[npm-downloads-href]: https://npm.chart.dev/forges
+[github-actions-src]: https://img.shields.io/github/actions/workflow/status/danielroe/forges/ci.yml?branch=main&style=flat-square
+[github-actions-href]: https://github.com/danielroe/forges/actions?query=workflow%3Aci
+[codecov-src]: https://img.shields.io/codecov/c/gh/danielroe/forges/main?style=flat-square
+[codecov-href]: https://codecov.io/gh/danielroe/forges

package/dist/azure-devops/index.d.mts

@@ -0,0 +1,2 @@
+import { a as azureDevOpsLite, i as azureDevOps, n as AzureDevOpsAuth, r as AzureDevOpsOptions, t as AZURE_DEVOPS_API_VERSION } from "../index-CTj5gQzl.mjs";
+export { AZURE_DEVOPS_API_VERSION, AzureDevOpsAuth, AzureDevOpsOptions, azureDevOps, azureDevOpsLite };

package/dist/azure-devops/index.mjs

@@ -0,0 +1 @@
+export { t as AZURE_DEVOPS_API_VERSION, n as azureDevOps, r as azureDevOpsLite } from "../azure-devops-DwQvL4TV.mjs";