@lovable.dev/mcp-js 0.29.0-rc.3 → 0.29.0-rc.4

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.
Files changed (57) hide show
  1. package/README.internal.md +3 -3
  2. package/README.md +2 -25
  3. package/dist/{cors-BDv7pyfD.cjs → authorize-CKMlIxm9.cjs} +33 -90
  4. package/dist/{authorize-DNUlPT7k.d.ts → authorize-CqYsQYfa.d.ts} +1 -1
  5. package/dist/{authorize-9hTTG-qJ.d.cts → authorize-DIYS7zBP.d.cts} +1 -1
  6. package/dist/{cors-kKiIJSyL.js → authorize-b3VqTC_7.js} +28 -79
  7. package/dist/cli/extract-manifest.cjs +12 -7
  8. package/dist/cli/extract-manifest.js +12 -7
  9. package/dist/{errors-Cr95rSkB.cjs → errors-CN6Da8iz.cjs} +8 -23
  10. package/dist/{errors-Bwd1L0Rf.js → errors-DSe96Ffd.js} +8 -23
  11. package/dist/forwarded-Bhwcj22u.cjs +48 -0
  12. package/dist/forwarded-BlLF3dfc.js +43 -0
  13. package/dist/index.cjs +1 -38
  14. package/dist/index.d.cts +3 -3
  15. package/dist/index.d.ts +3 -3
  16. package/dist/index.js +1 -38
  17. package/dist/{io-D_5cuaEL.d.ts → io-DP3icuxa.d.ts} +1 -1
  18. package/dist/{io-CDV3mud0.d.cts → io-Dx0nPc1-.d.cts} +1 -1
  19. package/dist/mcp-BLs6_g8i.js +174 -0
  20. package/dist/mcp-DtHM-41c.cjs +179 -0
  21. package/dist/{package-2ZppkCKf.js → package-DMs4EVwG.js} +1 -1
  22. package/dist/{package-DAQNwT8T.cjs → package-Xk8p8Q_E.cjs} +1 -1
  23. package/dist/protocols/mcp/index.cjs +1 -1
  24. package/dist/protocols/mcp/index.d.cts +33 -3
  25. package/dist/protocols/mcp/index.d.ts +33 -3
  26. package/dist/protocols/mcp/index.js +1 -1
  27. package/dist/protocols/oauth-metadata.cjs +10 -27
  28. package/dist/protocols/oauth-metadata.d.cts +3 -4
  29. package/dist/protocols/oauth-metadata.d.ts +3 -4
  30. package/dist/protocols/oauth-metadata.js +4 -21
  31. package/dist/stacks/supabase/index.cjs +6 -6
  32. package/dist/stacks/supabase/index.d.cts +1 -1
  33. package/dist/stacks/supabase/index.d.ts +1 -1
  34. package/dist/stacks/supabase/index.js +4 -4
  35. package/dist/stacks/supabase/vite.cjs +1 -1
  36. package/dist/stacks/supabase/vite.d.cts +1 -1
  37. package/dist/stacks/supabase/vite.d.ts +1 -1
  38. package/dist/stacks/supabase/vite.js +1 -1
  39. package/dist/stacks/tanstack/index.cjs +5 -5
  40. package/dist/stacks/tanstack/index.d.cts +2 -2
  41. package/dist/stacks/tanstack/index.d.ts +2 -2
  42. package/dist/stacks/tanstack/index.js +4 -4
  43. package/dist/stacks/tanstack/vite.cjs +4 -8
  44. package/dist/stacks/tanstack/vite.d.cts +1 -4
  45. package/dist/stacks/tanstack/vite.d.ts +1 -4
  46. package/dist/stacks/tanstack/vite.js +4 -8
  47. package/dist/{types-3CZPz364.d.cts → types-C0Wgm9zp.d.cts} +29 -65
  48. package/dist/{types-3CZPz364.d.ts → types-C0Wgm9zp.d.ts} +29 -65
  49. package/package.json +1 -5
  50. package/dist/base-7cq6HCPO.d.ts +0 -36
  51. package/dist/base-CHNFFrMG.d.cts +0 -36
  52. package/dist/forwarded-Bnrwxbuj.js +0 -25
  53. package/dist/forwarded-OdBzzCMF.cjs +0 -30
  54. package/dist/mcp-BSNdmnJl.cjs +0 -353
  55. package/dist/mcp-GT9WU7nd.js +0 -348
  56. package/dist/schema-CW1jKvio.js +0 -65
  57. package/dist/schema-D3vClxb7.cjs +0 -76
@@ -4,7 +4,7 @@ Architecture rationale, source layout, and dev scripts for contributors. The use
4
4
 
5
5
  ## Folder meaning
6
6
 
7
- - **`protocols/`** is the wire layer — one folder per externally observable HTTP surface. `protocols/mcp` is the public MCP-over-HTTP surface; `protocols/oauth-metadata` serves the RFC 9728 protected-resource metadata required to bootstrap protected MCP clients. `protocols/gate.ts` is the shared CORS → auth → method gate both surfaces run behind.
7
+ - **`protocols/`** is the wire layer — one folder per externally observable HTTP surface. `protocols/mcp` is the public MCP-over-HTTP surface; `protocols/oauth-metadata` serves the RFC 9728 protected-resource metadata required to bootstrap protected MCP clients. `protocols/gate.ts` is the CORS → auth → method gate the MCP surface runs behind.
8
8
  - **`auth/`** (unpublished) is the cross-cutting OAuth middleware — bearer verification, issuer/JWKS discovery, the `auth.oauth.*` config namespace. It depends only on `core/`; `protocols/mcp` depends on it for the bearer gate, so it isn't a wire-format peer of `mcp` and doesn't live under `protocols/`.
9
9
  - **`stacks/`** is the framework integration. Two are published: `stacks/tanstack/` (file-router routes emitted by a Vite plugin) and `stacks/supabase/` (a single Deno-served function with URL-suffix dispatch, emitted by the Supabase Vite plugin). Future entries (classic Vite, Cloudflare Workers, …) live alongside them. Each stack forwards to `protocols/{mcp,oauth-metadata}` directly — protocol logic stays shared, only ctx unwrapping and route emission differ.
10
10
  - **`manifest/`** is the stack-agnostic snapshot writer. `lovable-mcp-extract-manifest` is one CLI for every stack: it asks Vite for the resolved config, finds any plugin whose name matches `@lovable.dev/mcp-js*`, and reads `mcpEntry` + `urlPath` off its `api`. TanStack publishes its configured route path (`/mcp`); Supabase publishes `/functions/v1/<functionName>`. The projection (`extract.ts` + `listing.ts`) is pure and derives from the same `defineMcp` definition the live `tools/list` serves, so the committed manifest and the served catalog can't drift.
@@ -79,7 +79,7 @@ The published `.d.ts` files import only from `zod` and `vite`. Three SDK concern
79
79
  - **`ZodRawShape`, `ZodType`, `infer`** — sourced directly from `zod` (a peer dep). zod v3 and v4 both export all three at the top level; `ZodType` is non-deprecated in both versions with safe generic defaults. We re-export them from `core/types.ts` as `ZodRawShape` / `ZodSchema` / `ShapeOutput` (`ZodSchema` is a no-generic alias for `ZodType`). No dependency on `@modelcontextprotocol/sdk/server/zod-compat.js` types.
80
80
  - **`ContentBlock` union** — `TextContent | ImageContent | AudioContent | EmbeddedResource | ResourceLink`, structurally matching MCP's wire format. Consumers can type custom content (`return { content: [<ImageContent>, <TextContent>] }`) without referencing the SDK.
81
81
 
82
- The **runtime** still hands off to the MCP SDKs — `createMcpHandler` + `McpServer` come from `@modelcontextprotocol/server` (v2), and `objectFromShape` + `safeParseAsync` + `toJsonSchemaCompat` come from `@modelcontextprotocol/sdk`'s zod-compat modules for input validation and JSON-Schema serialization. Those are runtime dependencies, not type-surface dependencies.
82
+ The **runtime** still hands off to the MCP SDKwe still `import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"` and call `registerTool`, and we still use `objectFromShape` + `toJsonSchemaCompat` from the SDK's zod-compat modules to serialize the tool catalog to JSON Schema. That's a runtime dependency, not a type-surface dependency.
83
83
 
84
84
  ### 8. Stale-route cleanup on every regen
85
85
 
@@ -141,7 +141,7 @@ src/
141
141
  vite.ts # mcpPlugin (Vite-lifecycle trigger; exposes McpPluginApi with urlPath=/functions/v1/<functionName>)
142
142
  index.ts # barrel
143
143
  tests/
144
- core/{content,cors,define,errors,forwarded,logger,promise,supabase-config,url}.test.ts
144
+ core/{content,define,errors,forwarded,logger,promise,supabase-config,url}.test.ts
145
145
  auth/{claims,config,context,oauth,oauth-fallback,oauth-logging,oauth-metrics}.test.ts # OAuth config + bearer verification
146
146
  metrics/{config,dispatch,otlp,recorder}.test.ts
147
147
  protocols/
package/README.md CHANGED
@@ -49,13 +49,7 @@ That's the whole authoring surface. No imperative server construction, no route
49
49
 
50
50
  The table shows the default `path: "/mcp"`; `mcpPlugin({ path: "/api/public/mcp" })` moves the MCP route accordingly.
51
51
 
52
- MCP (`POST <path>`, `/mcp` by default) is the wire format clients speak directly. All runtime routes import the same `defineMcp` result, so they stay in sync on which tools exist and which auth and browser-origin policies protect them. If `defineMcp({ auth: ... })` is omitted, the handlers stay unauthenticated; if OAuth auth is configured, clients must pass `Authorization: Bearer <token>`. Rate limiting belongs at the app host or edge.
53
-
54
- The MCP endpoint supports both protocol eras on one URL. Finalized `2026-07-28` clients send the version, client capabilities, and mirrored HTTP headers on every request; the server returns typed results plus cache metadata on discovery and list responses without initialization or protocol sessions. Initialization-era clients continue through a stateless compatibility path: `initialize`, `tools/list`, and `tools/call` work as independent requests, and the endpoint never mints `Mcp-Session-Id`. `GET` and `DELETE` return `405` because there is no standalone stream or session to manage.
55
-
56
- `outputSchema` accepts either the existing object-shape shorthand (`{ value: z.string() }`) or a JSON-Schema-representable Zod schema such as `z.array(z.string())`; `structuredContent` may be any JSON value. The server returns the schema's parsed output, so coercions are reflected in the result; transforms with no truthful JSON Schema are rejected when `defineMcp` runs. Modern clients receive the natural schema and value. The compatibility path wraps non-object schemas and values under `result` for initialization-era clients whose wire format requires an object root.
57
-
58
- Browser-origin checks apply to the MCP and OAuth metadata routes before authentication. Omit `allowedOrigins` to allow requests with no `Origin` header (Go, desktop, CLI, and server clients) plus same-origin browser requests. Set `allowedOrigins: ["https://client.example.com"]` for exact additional origins, or `allowedOrigins: "any"` to intentionally restore wildcard CORS. Exact and same origins are reflected with `Vary: Origin`; other browser origins receive `403` without an OAuth challenge. Reverse-proxy adapters compare against the effective public origin after applying only their configured trusted forwarded headers.
52
+ MCP (`POST <path>`, `/mcp` by default) is the wire format clients speak directly. All runtime routes import the same `defineMcp` result, so they stay in sync on which tools exist and which auth policy protects them. If `defineMcp({ auth: ... })` is omitted, the handlers stay unauthenticated; if OAuth auth is configured, clients must pass `Authorization: Bearer <token>`. Rate limiting belongs at the app host or edge.
59
53
 
60
54
  The OAuth metadata route is emitted by default and returns `404` until OAuth auth is configured. Disable it with `mcpPlugin({ protectedResourceMetadataRoute: false })` only if the app owns `/.well-known/oauth-protected-resource` itself.
61
55
 
@@ -166,23 +160,6 @@ and no `node:async_hooks` dependency, so it works on any runtime and is safe
166
160
  under concurrency by construction. A handler that hands `ctx` to deferred work (a
167
161
  detached timer, an un-awaited promise) keeps full access to it.
168
162
 
169
- Beyond auth, `ToolContext` carries the per-request runtime surface:
170
-
171
- | Member | Purpose |
172
- | --- | --- |
173
- | `signal` | An `AbortSignal` that aborts when the client cancels the request or disconnects. Pass it to `fetch` and other cancelable APIs, or check `signal.aborted` between steps of long work. |
174
- | `client` | What the calling client declared about itself (`McpClientInfo`): `protocol` (`"2026-07-28"` or `"legacy"`), and for modern requests the envelope's `info`, `capabilities`, and `extensions`. Unverified client input — use it to adapt output, never to authorize. |
175
- | `progress(update)` | Sends a `notifications/progress` frame (`{ progress, total?, message? }`) for long-running tools. A no-op unless the client requested progress by sending `_meta.progressToken`; safe to call unconditionally. |
176
-
177
- ```ts
178
- handler: async ({ url }, ctx) => {
179
- await ctx.progress({ progress: 0, total: 2, message: "fetching" });
180
- const res = await fetch(url, { signal: ctx.signal });
181
- await ctx.progress({ progress: 1, total: 2, message: "processing" });
182
- return { content: [{ type: "text", text: await res.text() }] };
183
- };
184
- ```
185
-
186
163
  **Security contract for the bearer token.** `getToken()` is the only way to read
187
164
  the raw token. `ToolContext` holds the verified context in a private field, so the
188
165
  credential can't be read off the instance via `JSON.stringify`, object spread, or
@@ -251,7 +228,7 @@ A `500` on an OAuth-protected route is always one of two causes, logged at `erro
251
228
 
252
229
  ## Usage metrics
253
230
 
254
- Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, and latency — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`), the authorization gate `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes — and `origin_rejected` for a request refused `403` by the origin policy. Tool-call records also carry the protocol era (`mcp.protocol`: `2026-07-28` or `legacy`); records emitted before protocol classification (auth challenges, transport errors, origin rejections) have no protocol attribute. No tool arguments or response payloads are ever captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
231
+ Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, and latency — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`) and the authorization gate: `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes. No tool arguments or response payloads are ever captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
255
232
 
256
233
  Configure it on the MCP definition:
257
234
 
@@ -1,7 +1,28 @@
1
1
  const require_logger = require("./logger-CN1q-KNn.cjs");
2
- const require_package = require("./package-DAQNwT8T.cjs");
2
+ const require_package = require("./package-Xk8p8Q_E.cjs");
3
3
  require("./metadata-path-zd7NSNoa.cjs");
4
4
  let jose = require("jose");
5
+ //#region src/core/cors.ts
6
+ const EXPOSE_HEADERS = "WWW-Authenticate, Mcp-Session-Id, Mcp-Protocol-Version";
7
+ const ALLOW_HEADERS = "Authorization, Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID";
8
+ /** Add permissive CORS to a built response, preserving its other headers. */
9
+ function withCors(response) {
10
+ response.headers.set("Access-Control-Allow-Origin", "*");
11
+ response.headers.set("Access-Control-Expose-Headers", EXPOSE_HEADERS);
12
+ return response;
13
+ }
14
+ function corsPreflightResponse(allowMethods) {
15
+ return new Response(null, {
16
+ status: 204,
17
+ headers: {
18
+ "Access-Control-Allow-Origin": "*",
19
+ "Access-Control-Allow-Methods": allowMethods,
20
+ "Access-Control-Allow-Headers": ALLOW_HEADERS,
21
+ "Access-Control-Max-Age": "86400"
22
+ }
23
+ });
24
+ }
25
+ //#endregion
5
26
  //#region src/core/http.ts
6
27
  const JSON_HEADERS = { "Content-Type": "application/json" };
7
28
  /** Strip the body from a built response, preserving status and headers, for HEAD. */
@@ -13,7 +34,7 @@ function headResponse(response) {
13
34
  });
14
35
  }
15
36
  function finalizeWireResponse(request, response) {
16
- return request.method === "HEAD" ? headResponse(response) : response;
37
+ return withCors(request.method === "HEAD" ? headResponse(response) : response);
17
38
  }
18
39
  function methodNotAllowed(allow) {
19
40
  return new Response(JSON.stringify({ error: "method not allowed" }), {
@@ -28,8 +49,7 @@ function methodNotAllowed(allow) {
28
49
  //#endregion
29
50
  //#region src/metrics/otlp.ts
30
51
  const SCOPE_NAME = "@lovable.dev/mcp-js";
31
- const TOOL_EVENT_NAME = "mcp.tool.invocation";
32
- const GATE_EVENT_NAME = "mcp.gate.rejection";
52
+ const EVENT_NAME = "mcp.tool.invocation";
33
53
  const SEVERITY_INFO = 9;
34
54
  function strAttr(key, value) {
35
55
  return {
@@ -44,9 +64,8 @@ function intAttr(key, value) {
44
64
  };
45
65
  }
46
66
  function toLogRecord(rec) {
47
- const eventName = rec.method === "authorize" ? GATE_EVENT_NAME : TOOL_EVENT_NAME;
48
67
  const attributes = [
49
- strAttr("event.name", eventName),
68
+ strAttr("event.name", EVENT_NAME),
50
69
  strAttr("mcp.method", rec.method),
51
70
  strAttr("mcp.outcome", rec.outcome),
52
71
  intAttr("mcp.duration_ms", rec.durationMs)
@@ -55,7 +74,6 @@ function toLogRecord(rec) {
55
74
  if (rec.reqBytes !== void 0) attributes.push(intAttr("mcp.request_size_bytes", rec.reqBytes));
56
75
  if (rec.resBytes !== void 0) attributes.push(intAttr("mcp.response_size_bytes", rec.resBytes));
57
76
  if (rec.httpMethod !== void 0) attributes.push(strAttr("http.request.method", rec.httpMethod));
58
- if (rec.protocol !== void 0) attributes.push(strAttr("mcp.protocol", rec.protocol));
59
77
  attributes.push(strAttr("mcp.stack", rec.stack));
60
78
  if (rec.endUserId !== void 0) attributes.push(strAttr("mcp.end_user_id", rec.endUserId));
61
79
  return {
@@ -63,7 +81,7 @@ function toLogRecord(rec) {
63
81
  observedTimeUnixNano: rec.timeUnixNano,
64
82
  severityNumber: SEVERITY_INFO,
65
83
  severityText: "INFO",
66
- body: { stringValue: eventName },
84
+ body: { stringValue: EVENT_NAME },
67
85
  attributes
68
86
  };
69
87
  }
@@ -153,13 +171,12 @@ var BaseMetricRecorder = class {
153
171
  }
154
172
  async emit(ev) {
155
173
  await this.applyLazyLogLevel();
156
- if (ev.outcome !== "auth_challenge") require_logger.log.info(ev.method === "authorize" ? "gate.rejected" : "tool.invoked", {
174
+ if (ev.outcome !== "auth_challenge") require_logger.log.info("tool.invoked", {
157
175
  tool: ev.tool,
158
176
  method: ev.method,
159
177
  outcome: ev.outcome,
160
178
  durationMs: ev.durationMs,
161
179
  stack: this.stack,
162
- ...ev.protocol !== void 0 && { protocol: ev.protocol },
163
180
  ...ev.errorText !== void 0 && { errorText: ev.errorText }
164
181
  });
165
182
  if (!this.config.enabled) return;
@@ -931,74 +948,6 @@ function createRequestAuthorizer(mcp, options = {}) {
931
948
  } };
932
949
  }
933
950
  //#endregion
934
- //#region src/core/cors.ts
935
- const EXPOSE_HEADERS = "WWW-Authenticate, MCP-Protocol-Version, Mcp-Session-Id";
936
- const ALLOW_HEADERS = [
937
- "Authorization",
938
- "Content-Type",
939
- "MCP-Protocol-Version",
940
- "Mcp-Method",
941
- "Mcp-Name",
942
- "Mcp-Session-Id",
943
- "Last-Event-ID"
944
- ];
945
- const MCP_PARAM_HEADER = /^mcp-param-[!#$%&'*+.^_`|~0-9A-Za-z-]+$/i;
946
- function appendVary(headers, value) {
947
- const values = new Set((headers.get("Vary") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean));
948
- values.add(value);
949
- headers.set("Vary", [...values].join(", "));
950
- }
951
- function addCorsHeaders(response, allowedOrigin, variesByOrigin) {
952
- if (allowedOrigin !== void 0) {
953
- response.headers.set("Access-Control-Allow-Origin", allowedOrigin);
954
- response.headers.set("Access-Control-Expose-Headers", EXPOSE_HEADERS);
955
- }
956
- if (variesByOrigin) appendVary(response.headers, "Origin");
957
- return response;
958
- }
959
- function allowedRequestHeaders(request) {
960
- const allowed = new Map(ALLOW_HEADERS.map((header) => [header.toLowerCase(), header]));
961
- for (const header of (request.headers.get("Access-Control-Request-Headers") ?? "").split(",")) {
962
- const normalized = header.trim();
963
- if (MCP_PARAM_HEADER.test(normalized)) allowed.set(normalized.toLowerCase(), normalized);
964
- }
965
- return [...allowed.values()].join(", ");
966
- }
967
- function evaluateCors(request, allowedOrigins) {
968
- const origin = request.headers.get("Origin");
969
- const allowAny = allowedOrigins === "any";
970
- const originAllowed = origin === null || origin === new URL(request.url).origin || allowedOrigins?.includes(origin) === true;
971
- if (!allowAny && !originAllowed) {
972
- const response = Response.json({ error: "origin not allowed" }, {
973
- status: 403,
974
- headers: { "Cache-Control": "no-store" }
975
- });
976
- appendVary(response.headers, "Origin");
977
- return {
978
- ok: false,
979
- response
980
- };
981
- }
982
- const allowedOrigin = allowAny ? "*" : origin ?? void 0;
983
- return {
984
- ok: true,
985
- withHeaders: (response) => addCorsHeaders(response, allowedOrigin, !allowAny),
986
- preflight: (allowMethods) => {
987
- const requestedHeaders = request.headers.get("Access-Control-Request-Headers");
988
- const response = new Response(null, {
989
- status: 204,
990
- headers: {
991
- "Access-Control-Allow-Methods": allowMethods,
992
- "Access-Control-Allow-Headers": allowedRequestHeaders(request),
993
- "Access-Control-Max-Age": "86400"
994
- }
995
- });
996
- if (requestedHeaders) appendVary(response.headers, "Access-Control-Request-Headers");
997
- return addCorsHeaders(response, allowedOrigin, !allowAny);
998
- }
999
- };
1000
- }
1001
- //#endregion
1002
951
  Object.defineProperty(exports, "JSON_HEADERS", {
1003
952
  enumerable: true,
1004
953
  get: function() {
@@ -1011,6 +960,12 @@ Object.defineProperty(exports, "assertResourcePathShape", {
1011
960
  return assertResourcePathShape;
1012
961
  }
1013
962
  });
963
+ Object.defineProperty(exports, "corsPreflightResponse", {
964
+ enumerable: true,
965
+ get: function() {
966
+ return corsPreflightResponse;
967
+ }
968
+ });
1014
969
  Object.defineProperty(exports, "createNoopRecorder", {
1015
970
  enumerable: true,
1016
971
  get: function() {
@@ -1029,12 +984,6 @@ Object.defineProperty(exports, "createRequestAuthorizer", {
1029
984
  return createRequestAuthorizer;
1030
985
  }
1031
986
  });
1032
- Object.defineProperty(exports, "evaluateCors", {
1033
- enumerable: true,
1034
- get: function() {
1035
- return evaluateCors;
1036
- }
1037
- });
1038
987
  Object.defineProperty(exports, "finalizeWireResponse", {
1039
988
  enumerable: true,
1040
989
  get: function() {
@@ -1053,12 +1002,6 @@ Object.defineProperty(exports, "methodNotAllowed", {
1053
1002
  return methodNotAllowed;
1054
1003
  }
1055
1004
  });
1056
- Object.defineProperty(exports, "normalizeHttpMethod", {
1057
- enumerable: true,
1058
- get: function() {
1059
- return normalizeHttpMethod;
1060
- }
1061
- });
1062
1005
  Object.defineProperty(exports, "nowMs", {
1063
1006
  enumerable: true,
1064
1007
  get: function() {
@@ -1,4 +1,4 @@
1
- import "./types-3CZPz364.js";
1
+ import "./types-C0Wgm9zp.js";
2
2
  //#region src/auth/authorize.d.ts
3
3
  interface McpRuntimeOptions {
4
4
  /** Public MCP path OAuth resource/audience checks bind to when it differs from the request path. */
@@ -1,4 +1,4 @@
1
- import "./types-3CZPz364.cjs";
1
+ import "./types-C0Wgm9zp.cjs";
2
2
  //#region src/auth/authorize.d.ts
3
3
  interface McpRuntimeOptions {
4
4
  /** Public MCP path OAuth resource/audience checks bind to when it differs from the request path. */
@@ -1,7 +1,28 @@
1
1
  import { i as log, n as applyLogLevelFromEnv, o as parseSafeUrl, r as describeError, s as trimTrailingSlash, t as LOG_LEVEL_ENV_VAR, u as resolveMetricsConfig } from "./logger-Ctv5xUSD.js";
2
- import { t as version } from "./package-2ZppkCKf.js";
2
+ import { t as version } from "./package-DMs4EVwG.js";
3
3
  import "./metadata-path-CAkNcfyY.js";
4
4
  import { createLocalJWKSet, decodeProtectedHeader, errors, jwtVerify } from "jose";
5
+ //#region src/core/cors.ts
6
+ const EXPOSE_HEADERS = "WWW-Authenticate, Mcp-Session-Id, Mcp-Protocol-Version";
7
+ const ALLOW_HEADERS = "Authorization, Content-Type, Mcp-Session-Id, Mcp-Protocol-Version, Last-Event-ID";
8
+ /** Add permissive CORS to a built response, preserving its other headers. */
9
+ function withCors(response) {
10
+ response.headers.set("Access-Control-Allow-Origin", "*");
11
+ response.headers.set("Access-Control-Expose-Headers", EXPOSE_HEADERS);
12
+ return response;
13
+ }
14
+ function corsPreflightResponse(allowMethods) {
15
+ return new Response(null, {
16
+ status: 204,
17
+ headers: {
18
+ "Access-Control-Allow-Origin": "*",
19
+ "Access-Control-Allow-Methods": allowMethods,
20
+ "Access-Control-Allow-Headers": ALLOW_HEADERS,
21
+ "Access-Control-Max-Age": "86400"
22
+ }
23
+ });
24
+ }
25
+ //#endregion
5
26
  //#region src/core/http.ts
6
27
  const JSON_HEADERS = { "Content-Type": "application/json" };
7
28
  /** Strip the body from a built response, preserving status and headers, for HEAD. */
@@ -13,7 +34,7 @@ function headResponse(response) {
13
34
  });
14
35
  }
15
36
  function finalizeWireResponse(request, response) {
16
- return request.method === "HEAD" ? headResponse(response) : response;
37
+ return withCors(request.method === "HEAD" ? headResponse(response) : response);
17
38
  }
18
39
  function methodNotAllowed(allow) {
19
40
  return new Response(JSON.stringify({ error: "method not allowed" }), {
@@ -28,8 +49,7 @@ function methodNotAllowed(allow) {
28
49
  //#endregion
29
50
  //#region src/metrics/otlp.ts
30
51
  const SCOPE_NAME = "@lovable.dev/mcp-js";
31
- const TOOL_EVENT_NAME = "mcp.tool.invocation";
32
- const GATE_EVENT_NAME = "mcp.gate.rejection";
52
+ const EVENT_NAME = "mcp.tool.invocation";
33
53
  const SEVERITY_INFO = 9;
34
54
  function strAttr(key, value) {
35
55
  return {
@@ -44,9 +64,8 @@ function intAttr(key, value) {
44
64
  };
45
65
  }
46
66
  function toLogRecord(rec) {
47
- const eventName = rec.method === "authorize" ? GATE_EVENT_NAME : TOOL_EVENT_NAME;
48
67
  const attributes = [
49
- strAttr("event.name", eventName),
68
+ strAttr("event.name", EVENT_NAME),
50
69
  strAttr("mcp.method", rec.method),
51
70
  strAttr("mcp.outcome", rec.outcome),
52
71
  intAttr("mcp.duration_ms", rec.durationMs)
@@ -55,7 +74,6 @@ function toLogRecord(rec) {
55
74
  if (rec.reqBytes !== void 0) attributes.push(intAttr("mcp.request_size_bytes", rec.reqBytes));
56
75
  if (rec.resBytes !== void 0) attributes.push(intAttr("mcp.response_size_bytes", rec.resBytes));
57
76
  if (rec.httpMethod !== void 0) attributes.push(strAttr("http.request.method", rec.httpMethod));
58
- if (rec.protocol !== void 0) attributes.push(strAttr("mcp.protocol", rec.protocol));
59
77
  attributes.push(strAttr("mcp.stack", rec.stack));
60
78
  if (rec.endUserId !== void 0) attributes.push(strAttr("mcp.end_user_id", rec.endUserId));
61
79
  return {
@@ -63,7 +81,7 @@ function toLogRecord(rec) {
63
81
  observedTimeUnixNano: rec.timeUnixNano,
64
82
  severityNumber: SEVERITY_INFO,
65
83
  severityText: "INFO",
66
- body: { stringValue: eventName },
84
+ body: { stringValue: EVENT_NAME },
67
85
  attributes
68
86
  };
69
87
  }
@@ -153,13 +171,12 @@ var BaseMetricRecorder = class {
153
171
  }
154
172
  async emit(ev) {
155
173
  await this.applyLazyLogLevel();
156
- if (ev.outcome !== "auth_challenge") log.info(ev.method === "authorize" ? "gate.rejected" : "tool.invoked", {
174
+ if (ev.outcome !== "auth_challenge") log.info("tool.invoked", {
157
175
  tool: ev.tool,
158
176
  method: ev.method,
159
177
  outcome: ev.outcome,
160
178
  durationMs: ev.durationMs,
161
179
  stack: this.stack,
162
- ...ev.protocol !== void 0 && { protocol: ev.protocol },
163
180
  ...ev.errorText !== void 0 && { errorText: ev.errorText }
164
181
  });
165
182
  if (!this.config.enabled) return;
@@ -931,72 +948,4 @@ function createRequestAuthorizer(mcp, options = {}) {
931
948
  } };
932
949
  }
933
950
  //#endregion
934
- //#region src/core/cors.ts
935
- const EXPOSE_HEADERS = "WWW-Authenticate, MCP-Protocol-Version, Mcp-Session-Id";
936
- const ALLOW_HEADERS = [
937
- "Authorization",
938
- "Content-Type",
939
- "MCP-Protocol-Version",
940
- "Mcp-Method",
941
- "Mcp-Name",
942
- "Mcp-Session-Id",
943
- "Last-Event-ID"
944
- ];
945
- const MCP_PARAM_HEADER = /^mcp-param-[!#$%&'*+.^_`|~0-9A-Za-z-]+$/i;
946
- function appendVary(headers, value) {
947
- const values = new Set((headers.get("Vary") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean));
948
- values.add(value);
949
- headers.set("Vary", [...values].join(", "));
950
- }
951
- function addCorsHeaders(response, allowedOrigin, variesByOrigin) {
952
- if (allowedOrigin !== void 0) {
953
- response.headers.set("Access-Control-Allow-Origin", allowedOrigin);
954
- response.headers.set("Access-Control-Expose-Headers", EXPOSE_HEADERS);
955
- }
956
- if (variesByOrigin) appendVary(response.headers, "Origin");
957
- return response;
958
- }
959
- function allowedRequestHeaders(request) {
960
- const allowed = new Map(ALLOW_HEADERS.map((header) => [header.toLowerCase(), header]));
961
- for (const header of (request.headers.get("Access-Control-Request-Headers") ?? "").split(",")) {
962
- const normalized = header.trim();
963
- if (MCP_PARAM_HEADER.test(normalized)) allowed.set(normalized.toLowerCase(), normalized);
964
- }
965
- return [...allowed.values()].join(", ");
966
- }
967
- function evaluateCors(request, allowedOrigins) {
968
- const origin = request.headers.get("Origin");
969
- const allowAny = allowedOrigins === "any";
970
- const originAllowed = origin === null || origin === new URL(request.url).origin || allowedOrigins?.includes(origin) === true;
971
- if (!allowAny && !originAllowed) {
972
- const response = Response.json({ error: "origin not allowed" }, {
973
- status: 403,
974
- headers: { "Cache-Control": "no-store" }
975
- });
976
- appendVary(response.headers, "Origin");
977
- return {
978
- ok: false,
979
- response
980
- };
981
- }
982
- const allowedOrigin = allowAny ? "*" : origin ?? void 0;
983
- return {
984
- ok: true,
985
- withHeaders: (response) => addCorsHeaders(response, allowedOrigin, !allowAny),
986
- preflight: (allowMethods) => {
987
- const requestedHeaders = request.headers.get("Access-Control-Request-Headers");
988
- const response = new Response(null, {
989
- status: 204,
990
- headers: {
991
- "Access-Control-Allow-Methods": allowMethods,
992
- "Access-Control-Allow-Headers": allowedRequestHeaders(request),
993
- "Access-Control-Max-Age": "86400"
994
- }
995
- });
996
- if (requestedHeaders) appendVary(response.headers, "Access-Control-Request-Headers");
997
- return addCorsHeaders(response, allowedOrigin, !allowAny);
998
- }
999
- };
1000
- }
1001
- //#endregion
1002
- export { oauthConfigurationErrorResponse as a, createRecorderForRuntime as c, JSON_HEADERS as d, finalizeWireResponse as f, normalizeHttpMethod as i, createNoopRecorder as l, createRequestAuthorizer as n, assertResourcePathShape as o, methodNotAllowed as p, getOAuthRuntime as r, resolveProtectedResource as s, evaluateCors as t, nowMs as u };
951
+ export { resolveProtectedResource as a, nowMs as c, methodNotAllowed as d, corsPreflightResponse as f, assertResourcePathShape as i, JSON_HEADERS as l, getOAuthRuntime as n, createRecorderForRuntime as o, oauthConfigurationErrorResponse as r, createNoopRecorder as s, createRequestAuthorizer as t, finalizeWireResponse as u };
@@ -1,15 +1,20 @@
1
1
  #!/usr/bin/env node
2
- const require_schema = require("../schema-D3vClxb7.cjs");
3
- const require_package = require("../package-DAQNwT8T.cjs");
2
+ const require_package = require("../package-Xk8p8Q_E.cjs");
4
3
  const require_fs_errors = require("../fs-errors-CWNzOV75.cjs");
5
4
  let node_fs = require("node:fs");
6
5
  let node_path = require("node:path");
7
6
  let vite = require("vite");
8
7
  let node_crypto = require("node:crypto");
8
+ let _modelcontextprotocol_sdk_server_zod_compat_js = require("@modelcontextprotocol/sdk/server/zod-compat.js");
9
+ let _modelcontextprotocol_sdk_server_zod_json_schema_compat_js = require("@modelcontextprotocol/sdk/server/zod-json-schema-compat.js");
9
10
  //#region src/manifest/listing.ts
10
- function schemaToJsonSchema(definition, pipeStrategy) {
11
- if (!definition) return null;
12
- return require_schema.jsonSchemaFromDefinition(definition, pipeStrategy);
11
+ function shapeToJsonSchema(shape) {
12
+ if (!shape) return null;
13
+ try {
14
+ return (0, _modelcontextprotocol_sdk_server_zod_json_schema_compat_js.toJsonSchemaCompat)((0, _modelcontextprotocol_sdk_server_zod_compat_js.objectFromShape)(shape));
15
+ } catch {
16
+ return null;
17
+ }
13
18
  }
14
19
  function buildMcpListing(mcp) {
15
20
  return {
@@ -23,8 +28,8 @@ function buildMcpListing(mcp) {
23
28
  title: tool.title,
24
29
  description: tool.description,
25
30
  annotations: tool.annotations,
26
- inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
27
- outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
31
+ inputSchema: shapeToJsonSchema(tool.inputSchema),
32
+ outputSchema: shapeToJsonSchema(tool.outputSchema)
28
33
  }))
29
34
  };
30
35
  }
@@ -1,15 +1,20 @@
1
1
  #!/usr/bin/env node
2
- import { t as jsonSchemaFromDefinition } from "../schema-CW1jKvio.js";
3
- import { t as version } from "../package-2ZppkCKf.js";
2
+ import { t as version } from "../package-DMs4EVwG.js";
4
3
  import { t as isFileMissing } from "../fs-errors-PA2t1TIp.js";
5
4
  import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
6
5
  import { dirname, resolve } from "node:path";
7
6
  import { createServer, resolveConfig } from "vite";
8
7
  import { randomUUID } from "node:crypto";
8
+ import { objectFromShape } from "@modelcontextprotocol/sdk/server/zod-compat.js";
9
+ import { toJsonSchemaCompat } from "@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";
9
10
  //#region src/manifest/listing.ts
10
- function schemaToJsonSchema(definition, pipeStrategy) {
11
- if (!definition) return null;
12
- return jsonSchemaFromDefinition(definition, pipeStrategy);
11
+ function shapeToJsonSchema(shape) {
12
+ if (!shape) return null;
13
+ try {
14
+ return toJsonSchemaCompat(objectFromShape(shape));
15
+ } catch {
16
+ return null;
17
+ }
13
18
  }
14
19
  function buildMcpListing(mcp) {
15
20
  return {
@@ -23,8 +28,8 @@ function buildMcpListing(mcp) {
23
28
  title: tool.title,
24
29
  description: tool.description,
25
30
  annotations: tool.annotations,
26
- inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
27
- outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
31
+ inputSchema: shapeToJsonSchema(tool.inputSchema),
32
+ outputSchema: shapeToJsonSchema(tool.outputSchema)
28
33
  }))
29
34
  };
30
35
  }
@@ -1,30 +1,15 @@
1
1
  //#region src/auth/context.ts
2
- const NEVER_ABORTED = new AbortController().signal;
3
- /** The per-request context passed to every tool handler as its second argument. The
4
- * auth context lives in a private field so the accessors are the only way out; `getToken()` is the sole bearer escape hatch. */
2
+ /**
3
+ * The auth surface passed to every tool handler as its second argument. It wraps
4
+ * the verified per-request auth context in a private field, so the context and
5
+ * the bearer token inside it — can't be read, enumerated, spread, or
6
+ * `JSON.stringify`'d off the instance; the accessors below are the only way out.
7
+ * `getToken()` is the single intentional escape hatch for the raw bearer.
8
+ */
5
9
  var ToolContext = class {
6
10
  #auth;
7
- #signal;
8
- #client;
9
- #sendProgress;
10
- constructor(auth, request = {}) {
11
+ constructor(auth) {
11
12
  this.#auth = auth;
12
- this.#signal = request.signal ?? NEVER_ABORTED;
13
- this.#client = request.client ?? { protocol: "legacy" };
14
- this.#sendProgress = request.sendProgress;
15
- }
16
- /** Aborts when the client cancels the request or disconnects. */
17
- get signal() {
18
- return this.#signal;
19
- }
20
- /** What the client declared about itself on this request. Unverified input. */
21
- get client() {
22
- return this.#client;
23
- }
24
- /** Send a progress notification for this call. A no-op when the client
25
- * didn't request progress (no `progressToken` on the request). */
26
- async progress(update) {
27
- await this.#sendProgress?.(update);
28
13
  }
29
14
  /** Whether the in-flight tool call carries a verified auth context. */
30
15
  isAuthenticated() {
@@ -1,30 +1,15 @@
1
1
  //#region src/auth/context.ts
2
- const NEVER_ABORTED = new AbortController().signal;
3
- /** The per-request context passed to every tool handler as its second argument. The
4
- * auth context lives in a private field so the accessors are the only way out; `getToken()` is the sole bearer escape hatch. */
2
+ /**
3
+ * The auth surface passed to every tool handler as its second argument. It wraps
4
+ * the verified per-request auth context in a private field, so the context and
5
+ * the bearer token inside it — can't be read, enumerated, spread, or
6
+ * `JSON.stringify`'d off the instance; the accessors below are the only way out.
7
+ * `getToken()` is the single intentional escape hatch for the raw bearer.
8
+ */
5
9
  var ToolContext = class {
6
10
  #auth;
7
- #signal;
8
- #client;
9
- #sendProgress;
10
- constructor(auth, request = {}) {
11
+ constructor(auth) {
11
12
  this.#auth = auth;
12
- this.#signal = request.signal ?? NEVER_ABORTED;
13
- this.#client = request.client ?? { protocol: "legacy" };
14
- this.#sendProgress = request.sendProgress;
15
- }
16
- /** Aborts when the client cancels the request or disconnects. */
17
- get signal() {
18
- return this.#signal;
19
- }
20
- /** What the client declared about itself on this request. Unverified input. */
21
- get client() {
22
- return this.#client;
23
- }
24
- /** Send a progress notification for this call. A no-op when the client
25
- * didn't request progress (no `progressToken` on the request). */
26
- async progress(update) {
27
- await this.#sendProgress?.(update);
28
13
  }
29
14
  /** Whether the in-flight tool call carries a verified auth context. */
30
15
  isAuthenticated() {