@shivaedev/mcp 0.9.23 → 0.10.0
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/CHANGELOG.md +14 -0
- package/README.md +4 -3
- package/dist/InvalidTokenClaim.d.ts.map +1 -0
- package/dist/InvalidTokenClaim.js.map +1 -0
- package/dist/adapters/bearer.d.ts +1 -1
- package/dist/adapters/bearer.d.ts.map +1 -1
- package/dist/adapters/bearer.js +1 -1
- package/dist/adapters/bearer.js.map +1 -1
- package/dist/adapters/betterAuth.d.ts +1 -1
- package/package.json +10 -10
- package/src/adapters/bearer.ts +1 -1
- package/dist/adapters/InvalidTokenClaim.d.ts.map +0 -1
- package/dist/adapters/InvalidTokenClaim.js.map +0 -1
- /package/dist/{adapters/InvalidTokenClaim.d.ts → InvalidTokenClaim.d.ts} +0 -0
- /package/dist/{adapters/InvalidTokenClaim.js → InvalidTokenClaim.js} +0 -0
- /package/src/{adapters/InvalidTokenClaim.ts → InvalidTokenClaim.ts} +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.10.0 - 2026-11-21
|
|
4
|
+
|
|
5
|
+
### Breaking
|
|
6
|
+
|
|
7
|
+
- import from `@shivaedev/mcp/InvalidTokenClaim.ts` instead of `@shivaedev/mcp/adapters/InvalidTokenClaim.ts`, which moved out of `adapters/`.
|
|
8
|
+
|
|
9
|
+
## 0.9.24 - 2026-11-20
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- Update `@shivaedev/access` from 0.6.6 to 0.7.0.
|
|
14
|
+
- Update `@shivaedev/errors` from 0.14.0 to 0.14.1.
|
|
15
|
+
- Update `@shivaedev/identity` from 0.35.0 to 0.36.0.
|
|
16
|
+
|
|
3
17
|
## 0.9.23 - 2026-11-20
|
|
4
18
|
|
|
5
19
|
### Changed
|
package/README.md
CHANGED
|
@@ -97,9 +97,9 @@ The Better Auth adapter is an optional edge module. Add its provider to the auth
|
|
|
97
97
|
import { admin, jwt } from "better-auth/plugins";
|
|
98
98
|
import { Effect, Layer } from "effect";
|
|
99
99
|
import { HttpRouter } from "effect/http";
|
|
100
|
-
import { betterAuthMount } from "@shivaedev/identity/server/better-auth/
|
|
100
|
+
import { betterAuthMount } from "@shivaedev/identity/server/better-auth/mount.ts";
|
|
101
101
|
import { betterAuthOauthGrants } from "@shivaedev/identity/server/better-auth/adapters/oauthGrants.ts";
|
|
102
|
-
import { trustedOrigins } from "@shivaedev/identity/server/
|
|
102
|
+
import { trustedOrigins } from "@shivaedev/identity/server/trustedOrigins.ts";
|
|
103
103
|
import { SessionPolicy } from "@shivaedev/identity/server/SessionPolicy.ts";
|
|
104
104
|
import { betterAuthMcp, mcpProvider } from "@shivaedev/mcp/adapters/betterAuth.ts";
|
|
105
105
|
import { mcpRoutes } from "@shivaedev/mcp/routes.ts";
|
|
@@ -152,7 +152,7 @@ The edge adapter verifies access-token signatures, issuer, endpoint audience, `m
|
|
|
152
152
|
|
|
153
153
|
### Diagnose token refusals
|
|
154
154
|
|
|
155
|
-
`betterAuthMcp` returns `authenticate(token)` alongside its route and session Layers. It verifies the token and resolves its current OAuth grant. A successful authentication returns `Option.some({ user })`; a refused grant returns `Option.none()`. Missing or malformed `iss`, `aud`, `sub`, `client_id` or `scope` claims fail with `InvalidTokenClaim` from `@shivaedev/mcp/
|
|
155
|
+
`betterAuthMcp` returns `authenticate(token)` alongside its route and session Layers. It verifies the token and resolves its current OAuth grant. A successful authentication returns `Option.some({ user })`; a refused grant returns `Option.none()`. Missing or malformed `iss`, `aud`, `sub`, `client_id` or `scope` claims fail with `InvalidTokenClaim` from `@shivaedev/mcp/InvalidTokenClaim.ts`. The failure names `claim`, and the adapter logs a warning with that name. Claims and token values stay out of this diagnostic. Blank subjects and client identifiers are invalid too.
|
|
156
156
|
|
|
157
157
|
Use `authenticate` in application stories to distinguish invalid claims from refused grants. HTTP sessions translate `InvalidTokenClaim` into the ordinary `401` resource challenge. A token with an invalid signature still receives that challenge; verification infrastructure failures remain `AuthUnavailable` and answer `503`.
|
|
158
158
|
|
|
@@ -167,6 +167,7 @@ When Better Auth uses a dynamic `baseURL`, give it a `fallback`, for example `{
|
|
|
167
167
|
By default verification fetches the authorization server's JWKS URL. Pass `jwks` to use an in-process public key source instead, including on story hosts whose public origin has no HTTP route:
|
|
168
168
|
|
|
169
169
|
```ts
|
|
170
|
+
// In a module under adapters/, because getJwks returns Better Auth's Promise.
|
|
170
171
|
const oauth = yield* betterAuthMcp({
|
|
171
172
|
auth: mounted.auth,
|
|
172
173
|
resource,
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"InvalidTokenClaim.d.ts","sourceRoot":"","sources":["../src/InvalidTokenClaim.ts"],"names":[],"mappings":";;;AAEA,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB,CAAC;IACD,IAAa,OAAO,WAEnB;CACD"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"InvalidTokenClaim.js","sourceRoot":"","sources":["../src/InvalidTokenClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAEzE;IACD,IAAa,OAAO;QACnB,OAAO,6CAA6C,IAAI,CAAC,KAAK,QAAQ,CAAC;IACxE,CAAC;CACD"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { verifyJwsAccessToken } from "better-auth/oauth2";
|
|
2
2
|
import { Effect, Option } from "effect";
|
|
3
3
|
import { AuthUnavailable } from "@shivaedev/errors/taxonomy.ts";
|
|
4
|
-
import { InvalidTokenClaim } from "#
|
|
4
|
+
import { InvalidTokenClaim } from "#InvalidTokenClaim.ts";
|
|
5
5
|
export type JwksSource = Parameters<typeof verifyJwsAccessToken>[1]["jwksFetch"];
|
|
6
6
|
export declare function bearer(jwks: JwksSource, audience: string, issuer: string): (token: string | undefined) => Effect.Effect<Option.Option<never> | Option.Option<{
|
|
7
7
|
iss?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bearer.d.ts","sourceRoot":"","sources":["../../src/adapters/bearer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"bearer.d.ts","sourceRoot":"","sources":["../../src/adapters/bearer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AA0CjF,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WACzD,MAAM,GAAG,SAAS;;;;;;;;;;gDAqBjC"}
|
package/dist/adapters/bearer.js
CHANGED
|
@@ -3,7 +3,7 @@ import { verifyJwsAccessToken } from "better-auth/oauth2";
|
|
|
3
3
|
import { Effect, Option } from "effect";
|
|
4
4
|
import { redact } from "@shivaedev/errors/redact.ts";
|
|
5
5
|
import { AuthUnavailable } from "@shivaedev/errors/taxonomy.ts";
|
|
6
|
-
import { InvalidTokenClaim } from "#
|
|
6
|
+
import { InvalidTokenClaim } from "#InvalidTokenClaim.ts";
|
|
7
7
|
const INVALID_TOKEN_ERRORS = new Set([
|
|
8
8
|
"ERR_JWT_EXPIRED",
|
|
9
9
|
"ERR_JWT_CLAIM_VALIDATION_FAILED",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bearer.js","sourceRoot":"","sources":["../../src/adapters/bearer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"bearer.js","sourceRoot":"","sources":["../../src/adapters/bearer.ts"],"names":[],"mappings":"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"}
|
|
@@ -44,7 +44,7 @@ export declare const betterAuthMcp: (options: {
|
|
|
44
44
|
}[];
|
|
45
45
|
readonly role?: string | null | undefined;
|
|
46
46
|
};
|
|
47
|
-
}>, AuthUnavailable | import("
|
|
47
|
+
}>, AuthUnavailable | import("../InvalidTokenClaim.ts").InvalidTokenClaim, never>;
|
|
48
48
|
resourceMetadataUrl: string;
|
|
49
49
|
routes: Layer.Layer<never, never, HttpRouter.HttpRouter | HttpRouter.Request<"Error", import("effect/http/HttpServerError").InternalError> | HttpRouter.Request<"Error", import("effect/http/HttpServerError").RequestParseError> | HttpRouter.Request<"Error", import("effect/http/HttpServerError").RouteNotFound> | HttpRouter.Request<"Error", AuthUnavailable & {
|
|
50
50
|
cause: unknown;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shivaedev/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "Identity-aware Effect MCP tools mounted on the application host",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"effect"
|
|
@@ -43,19 +43,19 @@
|
|
|
43
43
|
"README.md"
|
|
44
44
|
],
|
|
45
45
|
"dependencies": {
|
|
46
|
-
"@shivaedev/access": "0.
|
|
47
|
-
"@shivaedev/errors": "0.14.
|
|
48
|
-
"@shivaedev/identity": "0.
|
|
46
|
+
"@shivaedev/access": "0.7.0",
|
|
47
|
+
"@shivaedev/errors": "0.14.1",
|
|
48
|
+
"@shivaedev/identity": "0.37.0"
|
|
49
49
|
},
|
|
50
50
|
"devDependencies": {
|
|
51
51
|
"@effect/platform-node": "4.1.4",
|
|
52
52
|
"@effect/sql-pg": "4.1.4",
|
|
53
|
-
"@shivaedev/quality": "0.
|
|
54
|
-
"@shivaedev/rate-limit": "0.
|
|
55
|
-
"@shivaedev/server": "0.
|
|
56
|
-
"@shivaedev/test-kits": "0.
|
|
57
|
-
"@shivaedev/test-sql": "0.
|
|
58
|
-
"@shivaedev/test-story": "0.
|
|
53
|
+
"@shivaedev/quality": "0.82.0",
|
|
54
|
+
"@shivaedev/rate-limit": "0.8.0",
|
|
55
|
+
"@shivaedev/server": "0.39.0",
|
|
56
|
+
"@shivaedev/test-kits": "0.15.0",
|
|
57
|
+
"@shivaedev/test-sql": "0.26.0",
|
|
58
|
+
"@shivaedev/test-story": "0.51.0",
|
|
59
59
|
"@types/node": "24.19.2",
|
|
60
60
|
"better-auth": "1.7.22",
|
|
61
61
|
"effect": "4.1.4",
|
package/src/adapters/bearer.ts
CHANGED
|
@@ -3,7 +3,7 @@ import { verifyJwsAccessToken } from "better-auth/oauth2";
|
|
|
3
3
|
import { Effect, Option } from "effect";
|
|
4
4
|
import { redact } from "@shivaedev/errors/redact.ts";
|
|
5
5
|
import { AuthUnavailable } from "@shivaedev/errors/taxonomy.ts";
|
|
6
|
-
import { InvalidTokenClaim } from "#
|
|
6
|
+
import { InvalidTokenClaim } from "#InvalidTokenClaim.ts";
|
|
7
7
|
|
|
8
8
|
export type JwksSource = Parameters<typeof verifyJwsAccessToken>[1]["jwksFetch"];
|
|
9
9
|
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"InvalidTokenClaim.d.ts","sourceRoot":"","sources":["../../src/adapters/InvalidTokenClaim.ts"],"names":[],"mappings":";;;AAEA,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB,CAAC;IACD,IAAa,OAAO,WAEnB;CACD"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"InvalidTokenClaim.js","sourceRoot":"","sources":["../../src/adapters/InvalidTokenClaim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAEzE;IACD,IAAa,OAAO;QACnB,OAAO,6CAA6C,IAAI,CAAC,KAAK,QAAQ,CAAC;IACxE,CAAC;CACD"}
|
|
File without changes
|
|
File without changes
|
|
File without changes
|