@forgeintel/sdk 0.5.0-beta.11 → 0.5.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -4
- package/package.json +2 -6
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **Beta.** Install with `npm install @forgeintel/sdk`. The API may change before 1.0.
|
|
4
4
|
|
|
5
|
-
The Forge SDK for x402 paid APIs. Paid responses carry a `feedback_id`, the 402 challenge asks agents to rate the call, a rating is
|
|
5
|
+
The Forge SDK for x402 paid APIs. Paid responses carry a `feedback_id`, the 402 challenge asks agents to rate the call, a rating is a free GET with no payment, and every call is reported to your Forge dashboard in the background. Never on your critical path: no network calls while your API serves a request, and it fails open. Aware of x402 v1 and v2, and of OpenAPI 2.0 through 3.2. Every change is additive, and anything it doesn't understand passes through untouched.
|
|
6
6
|
|
|
7
7
|
## Express
|
|
8
8
|
|
|
@@ -17,7 +17,7 @@ app.use(forge.middleware()); // 1. first: before payments
|
|
|
17
17
|
app.use(paymentMiddleware(routes, resourceServer)); // 2. your existing x402 setup, unchanged
|
|
18
18
|
```
|
|
19
19
|
|
|
20
|
-
Works with `@x402/express` (v2) and `x402-express` (v1), on Express 4.21+ or 5. The root export is the Express adapter (also at `@forgeintel/sdk/express`).
|
|
20
|
+
Works with `@x402/express` (v2) and `x402-express` (v1), on Express 4.21+ or 5. Complete example: [forge-examples/node-express](https://github.com/tryforgeintel/forge-examples/tree/main/node-express). The root export is the Express adapter (also at `@forgeintel/sdk/express`).
|
|
21
21
|
|
|
22
22
|
## Hono (Node, Bun, Deno, Cloudflare Workers)
|
|
23
23
|
|
|
@@ -47,7 +47,7 @@ export const { GET, POST, HEAD } = forge.routes;
|
|
|
47
47
|
|
|
48
48
|
## Any other framework
|
|
49
49
|
|
|
50
|
-
`@forgeintel/sdk/core` is the same logic without a framework. Call `forge.route()` first, then `forge.call()` per paid request, and `call.headers()` / `call.json()` / `call.finish()` where you build the 402 and the paid response. See the [core
|
|
50
|
+
`@forgeintel/sdk/core` is the same logic without a framework. Call `forge.route()` first, then `forge.call()` per paid request, and `call.headers()` / `call.json()` / `call.finish()` where you build the 402 and the paid response. See the [core API reference](https://docs.forgeintel.co/reference/core-api).
|
|
51
51
|
|
|
52
52
|
Zero runtime dependencies. Node ≥ 20.19. Works from both `import` and `require()`.
|
|
53
53
|
|
|
@@ -103,7 +103,7 @@ OpenAPI: Swagger 2.0 and OpenAPI 3.0, 3.1 and 3.2. Additive only; shared compone
|
|
|
103
103
|
|
|
104
104
|
`forge.diagnostics()` returns counters and the last OpenAPI report. `forge.enrichOpenApi(doc)` is available for build-time use. Call `await forge.shutdown()` in your shutdown handler to flush pending events.
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
Runnable examples (Express and FastAPI): [github.com/tryforgeintel/forge-examples](https://github.com/tryforgeintel/forge-examples). Docs: [docs.forgeintel.co](https://docs.forgeintel.co).
|
|
107
107
|
|
|
108
108
|
Client headers are captured automatically at discovery, challenge, payment, and rating stages, including unknown clients. Forge identifies awal, AgentCash, pay.sh and x402scan-mcp from known headers; other clients remain unknown. There is no client-signals switch. Legacy `agent_context.client` inputs remain accepted but are no longer requested.
|
|
109
109
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@forgeintel/sdk",
|
|
3
|
-
"version": "0.5.0-beta.
|
|
3
|
+
"version": "0.5.0-beta.12",
|
|
4
4
|
"description": "The Forge SDK for x402 paid APIs: agent feedback, agent context, OpenAPI and challenge enrichment, and passive call signals. Express, Hono, Next.js and fetch handlers. No Forge network request on the merchant response path.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -61,11 +61,7 @@
|
|
|
61
61
|
"cloudflare-workers",
|
|
62
62
|
"bun"
|
|
63
63
|
],
|
|
64
|
-
"
|
|
65
|
-
"type": "git",
|
|
66
|
-
"url": "git+https://github.com/ClawCash/forge-feedback.git",
|
|
67
|
-
"directory": "packages/sdk"
|
|
68
|
-
},
|
|
64
|
+
"homepage": "https://docs.forgeintel.co",
|
|
69
65
|
"scripts": {
|
|
70
66
|
"build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
|
|
71
67
|
"test": "node -e \"require('fs').rmSync('dist-test',{recursive:true,force:true})\" && tsc -p tsconfig.test.json && node --test --test-reporter=spec \"dist-test/test/**/*.test.js\"",
|