@lovable.dev/mcp-js 0.22.1 → 0.22.2-rc.1

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 (87) hide show
  1. package/dist/authorize-CumVyk7p.d.cts +27 -0
  2. package/dist/authorize-D6p4-9_D.d.ts +27 -0
  3. package/dist/base-DCe0kP79.d.cts +29 -0
  4. package/dist/base-DCe0kP79.d.ts +29 -0
  5. package/dist/cli/extract-manifest.cjs +116 -201
  6. package/dist/cli/extract-manifest.d.cts +1 -1
  7. package/dist/cli/extract-manifest.d.ts +1 -1
  8. package/dist/cli/extract-manifest.js +117 -156
  9. package/dist/content-D5LJAHyM.js +12 -0
  10. package/dist/content-NCYIGgOb.cjs +17 -0
  11. package/dist/context-BweeEcoA.cjs +56 -0
  12. package/dist/context-CIpPzN7P.js +51 -0
  13. package/dist/cors-C2n2LxrC.js +830 -0
  14. package/dist/cors-Cga2PWEg.cjs +913 -0
  15. package/dist/forwarded--h4efJy-.js +43 -0
  16. package/dist/forwarded-Pi8Hs5Ps.cjs +48 -0
  17. package/dist/fs-errors-CWNzOV75.cjs +11 -0
  18. package/dist/fs-errors-PA2t1TIp.js +6 -0
  19. package/dist/index.cjs +129 -329
  20. package/dist/index.d.cts +26 -26
  21. package/dist/index.d.ts +26 -26
  22. package/dist/index.js +118 -177
  23. package/dist/{io-D4srzRKc.d.ts → io-CfSPxeBN.d.ts} +6 -4
  24. package/dist/io-DPYvBqET.d.cts +15 -0
  25. package/dist/list-tools-07OV14rK.cjs +57 -0
  26. package/dist/list-tools-B4TTPEl1.d.cts +8 -0
  27. package/dist/list-tools-I8Hvub9P.js +46 -0
  28. package/dist/list-tools-bh6-eqZM.d.ts +8 -0
  29. package/dist/logger-2OXtfiIW.js +141 -0
  30. package/dist/logger-BqPOa_E1.cjs +194 -0
  31. package/dist/mcp-B6z5Givq.js +123 -0
  32. package/dist/mcp-DLv_c1O5.cjs +128 -0
  33. package/dist/metadata-path-CAkNcfyY.js +12 -0
  34. package/dist/metadata-path-zd7NSNoa.cjs +17 -0
  35. package/dist/package-CxQcGWdU.cjs +9 -0
  36. package/dist/package-xS6mk-b_.js +4 -0
  37. package/dist/paths-IS65L6TA.js +7 -0
  38. package/dist/paths-OP318a6c.cjs +18 -0
  39. package/dist/protocols/mcp/index.cjs +3 -750
  40. package/dist/protocols/mcp/index.d.cts +6 -7
  41. package/dist/protocols/mcp/index.d.ts +6 -7
  42. package/dist/protocols/mcp/index.js +2 -12
  43. package/dist/protocols/oauth-metadata.cjs +48 -539
  44. package/dist/protocols/oauth-metadata.d.cts +5 -6
  45. package/dist/protocols/oauth-metadata.d.ts +5 -6
  46. package/dist/protocols/oauth-metadata.js +52 -10
  47. package/dist/protocols/rest/index.cjs +5 -843
  48. package/dist/protocols/rest/index.d.cts +7 -10
  49. package/dist/protocols/rest/index.d.ts +7 -10
  50. package/dist/protocols/rest/index.js +3 -16
  51. package/dist/rest-CggWx00c.js +117 -0
  52. package/dist/rest-DxhK7-3b.cjs +122 -0
  53. package/dist/stacks/supabase/index.cjs +76 -1318
  54. package/dist/stacks/supabase/index.d.cts +29 -30
  55. package/dist/stacks/supabase/index.d.ts +29 -30
  56. package/dist/stacks/supabase/index.js +73 -89
  57. package/dist/stacks/supabase/vite.cjs +258 -287
  58. package/dist/stacks/supabase/vite.d.cts +24 -24
  59. package/dist/stacks/supabase/vite.d.ts +24 -24
  60. package/dist/stacks/supabase/vite.js +252 -252
  61. package/dist/stacks/tanstack/index.cjs +42 -1272
  62. package/dist/stacks/tanstack/index.d.cts +8 -9
  63. package/dist/stacks/tanstack/index.d.ts +8 -9
  64. package/dist/stacks/tanstack/index.js +36 -41
  65. package/dist/stacks/tanstack/vite.cjs +223 -312
  66. package/dist/stacks/tanstack/vite.d.cts +80 -81
  67. package/dist/stacks/tanstack/vite.d.ts +80 -81
  68. package/dist/stacks/tanstack/vite.js +216 -282
  69. package/dist/types-BYdYYTjk.d.cts +321 -0
  70. package/dist/types-BYdYYTjk.d.ts +321 -0
  71. package/package.json +4 -4
  72. package/dist/authorize-BMeXd_Sh.d.ts +0 -25
  73. package/dist/base-CM-KCpp6.d.ts +0 -28
  74. package/dist/chunk-5HVSJCKE.js +0 -114
  75. package/dist/chunk-6DXGZZA4.js +0 -6
  76. package/dist/chunk-6QFZYYUV.js +0 -11
  77. package/dist/chunk-6SZOFKGH.js +0 -58
  78. package/dist/chunk-H37EB22A.js +0 -125
  79. package/dist/chunk-IFDWUM7L.js +0 -741
  80. package/dist/chunk-IXZIFYO6.js +0 -79
  81. package/dist/chunk-MA5H6PSF.js +0 -46
  82. package/dist/chunk-TJN33K5U.js +0 -141
  83. package/dist/chunk-UQK5UO6C.js +0 -26
  84. package/dist/chunk-XQWJN6DC.js +0 -14
  85. package/dist/chunk-Y3ZFPEQH.js +0 -8
  86. package/dist/chunk-ZQXSWTPU.js +0 -6
  87. package/dist/types-qqrmJ736.d.ts +0 -321
@@ -1,25 +0,0 @@
1
- interface McpRuntimeOptions {
2
- /**
3
- * Public MCP protocol path. REST companion handlers pass this so OAuth
4
- * resource/audience checks bind to `/mcp`, not internal `/.mcp/*` RPC URLs.
5
- */
6
- resourcePath?: string;
7
- /**
8
- * Host-relative path of the SDK-served protected-resource metadata document.
9
- * The Vite plugin injects it into every emitted handler when it generates the
10
- * PRM route, so the 401 challenge advertises the same path the route serves.
11
- * Its presence is the signal that the SDK owns the PRM document, so it is
12
- * mutually exclusive with `auth.protectedResourceMetadataUrl` (which points at
13
- * an externally hosted document). Defaults to the well-known path when absent.
14
- */
15
- metadataPath?: string;
16
- /**
17
- * Derive the request origin (and thus the advertised `resource`/metadata URLs)
18
- * from `X-Forwarded-Host` rather than the rewritten `Host`. Stack adapters read
19
- * this before invoking the handler, so the OAuth runtime never sees it; safe
20
- * only behind a proxy that overwrites the header (see `core/forwarded.ts`).
21
- */
22
- trustForwardedHost?: boolean;
23
- }
24
-
25
- export type { McpRuntimeOptions as M };
@@ -1,28 +0,0 @@
1
- type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "auth_config_error";
2
- /** One recorded MCP call. Carries no arguments or response payloads — only the
3
- * tool name, the JSON-RPC method, the result class, timing, and byte sizes.
4
- * `errorText` is the sole exception: it is logged locally for debugging and
5
- * deliberately never included in the OTLP payload (see `emit` / `buildLogsPayload`). */
6
- interface InvocationRecord {
7
- /** Tool name for `tools/call`; `null` for list/initialize, transport faults, and auth-config failures. */
8
- tool: string | null;
9
- /** JSON-RPC method, e.g. `tools/call`; `authorize` for auth-config failures. */
10
- method: string;
11
- outcome: InvocationOutcome;
12
- durationMs: number;
13
- reqBytes?: number;
14
- resBytes?: number;
15
- /** The app end-user that made the call (the access token `sub`), or
16
- * `undefined` when the request is unauthenticated. Not a Lovable identity. */
17
- endUserId?: string;
18
- /** The `tool_error` message (text content of an `isError` result). Local log
19
- * only — never sent to the collector, so it stays on-box for the operator. */
20
- errorText?: string;
21
- }
22
- /** A per-request telemetry recorder. `emit` logs the invocation and sends it as a
23
- * single OTLP POST, awaited so it lands before the request ends. */
24
- interface MetricsRecorder {
25
- emit(ev: InvocationRecord): Promise<void>;
26
- }
27
-
28
- export type { MetricsRecorder as M };
@@ -1,114 +0,0 @@
1
- import {
2
- extractTextContent
3
- } from "./chunk-6QFZYYUV.js";
4
- import {
5
- ToolContext
6
- } from "./chunk-MA5H6PSF.js";
7
- import {
8
- corsPreflightResponse,
9
- createNoopRecorder,
10
- createRequestAuthorizer,
11
- nowMs,
12
- withCors
13
- } from "./chunk-IFDWUM7L.js";
14
- import {
15
- describeError,
16
- log
17
- } from "./chunk-H37EB22A.js";
18
-
19
- // src/protocols/mcp/protocol.ts
20
- import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
21
- import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
22
- function adaptToolToSdkCallback(tool, auth, recorder) {
23
- const endUserId = auth?.principal.sub;
24
- return async (first) => {
25
- const args = tool.inputSchema ? first ?? {} : {};
26
- const start = nowMs();
27
- let result;
28
- try {
29
- result = await tool.handler(args, new ToolContext(auth));
30
- } catch {
31
- await recorder.emit({
32
- tool: tool.name,
33
- method: "tools/call",
34
- outcome: "handler_error",
35
- durationMs: nowMs() - start,
36
- endUserId
37
- });
38
- return { content: [{ type: "text", text: "tool execution failed" }], isError: true };
39
- }
40
- if (result == null) {
41
- await recorder.emit({
42
- tool: tool.name,
43
- method: "tools/call",
44
- outcome: "handler_error",
45
- durationMs: nowMs() - start,
46
- endUserId
47
- });
48
- return { content: [{ type: "text", text: `tool "${tool.name}" returned no result` }], isError: true };
49
- }
50
- await recorder.emit({
51
- tool: tool.name,
52
- method: "tools/call",
53
- outcome: result.isError ? "tool_error" : "ok",
54
- durationMs: nowMs() - start,
55
- errorText: result.isError ? extractTextContent(result.content) : void 0,
56
- endUserId
57
- });
58
- return { content: result.content ?? [], structuredContent: result.structuredContent, isError: result.isError };
59
- };
60
- }
61
- function createMcpProtocolHandler(mcp, options = {}) {
62
- const authorizer = createRequestAuthorizer(mcp, options);
63
- const handle = async (request, recorder) => {
64
- const authResult = await authorizer.authorize(request, recorder);
65
- if (!authResult.ok)
66
- return authResult.response;
67
- try {
68
- const server = new McpServer(
69
- { name: mcp.name, version: mcp.version, title: mcp.title },
70
- { instructions: mcp.instructions }
71
- );
72
- for (const tool of mcp.tools) {
73
- server.registerTool(
74
- tool.name,
75
- {
76
- title: tool.title,
77
- description: tool.description,
78
- inputSchema: tool.inputSchema,
79
- outputSchema: tool.outputSchema,
80
- annotations: tool.annotations
81
- },
82
- adaptToolToSdkCallback(tool, authResult.auth, recorder)
83
- );
84
- }
85
- const transport = new WebStandardStreamableHTTPServerTransport({
86
- sessionIdGenerator: void 0
87
- });
88
- await server.connect(transport);
89
- return await transport.handleRequest(request);
90
- } catch (err) {
91
- await recorder.emit({
92
- tool: null,
93
- method: "transport",
94
- outcome: "transport_error",
95
- durationMs: 0,
96
- endUserId: authResult.auth?.principal.sub
97
- });
98
- log.error("mcp.transport_error", { ...describeError(err), outcome: "500 internal error" });
99
- return Response.json(
100
- { jsonrpc: "2.0", id: null, error: { code: -32603, message: "internal error" } },
101
- { status: 500 }
102
- );
103
- }
104
- };
105
- return async (request, recorder = createNoopRecorder()) => {
106
- if (request.method === "OPTIONS")
107
- return corsPreflightResponse("GET, POST, DELETE, OPTIONS");
108
- return withCors(await handle(request, recorder));
109
- };
110
- }
111
-
112
- export {
113
- createMcpProtocolHandler
114
- };
@@ -1,6 +0,0 @@
1
- // src/auth/metadata-path.ts
2
- var OAUTH_PROTECTED_RESOURCE_METADATA_PATH = "/.well-known/oauth-protected-resource";
3
-
4
- export {
5
- OAUTH_PROTECTED_RESOURCE_METADATA_PATH
6
- };
@@ -1,11 +0,0 @@
1
- // src/core/content.ts
2
- function extractTextContent(content) {
3
- if (!content)
4
- return void 0;
5
- const text = content.filter((block) => block.type === "text").map((block) => block.text).join("\n").trim();
6
- return text.length > 0 ? text : void 0;
7
- }
8
-
9
- export {
10
- extractTextContent
11
- };
@@ -1,58 +0,0 @@
1
- import {
2
- assertRestResourceBinding,
3
- corsPreflightResponse,
4
- createNoopRecorder,
5
- createRequestAuthorizer,
6
- headResponse,
7
- methodNotAllowed,
8
- withCors
9
- } from "./chunk-IFDWUM7L.js";
10
-
11
- // src/protocols/rest/list-tools.ts
12
- import { objectFromShape } from "@modelcontextprotocol/sdk/server/zod-compat.js";
13
- import { toJsonSchemaCompat } from "@modelcontextprotocol/sdk/server/zod-json-schema-compat.js";
14
- function shapeToJsonSchema(shape) {
15
- if (!shape)
16
- return null;
17
- try {
18
- return toJsonSchemaCompat(objectFromShape(shape));
19
- } catch {
20
- return null;
21
- }
22
- }
23
- function buildMcpListing(mcp) {
24
- return {
25
- server: { name: mcp.name, version: mcp.version, title: mcp.title },
26
- tools: mcp.tools.map((tool) => ({
27
- name: tool.name,
28
- title: tool.title,
29
- description: tool.description,
30
- annotations: tool.annotations,
31
- inputSchema: shapeToJsonSchema(tool.inputSchema),
32
- outputSchema: shapeToJsonSchema(tool.outputSchema)
33
- }))
34
- };
35
- }
36
- function createListToolsHandler(mcp, options = {}) {
37
- assertRestResourceBinding(mcp, options);
38
- const authorizer = createRequestAuthorizer(mcp, options);
39
- const handle = async (request, recorder) => {
40
- const authResult = await authorizer.authorize(request, recorder);
41
- if (!authResult.ok)
42
- return authResult.response;
43
- if (request.method !== "GET" && request.method !== "HEAD")
44
- return methodNotAllowed("GET, HEAD, OPTIONS");
45
- const response = Response.json(buildMcpListing(mcp));
46
- return request.method === "HEAD" ? headResponse(response) : response;
47
- };
48
- return async (request, recorder = createNoopRecorder()) => {
49
- if (request.method === "OPTIONS")
50
- return corsPreflightResponse("GET, HEAD, OPTIONS");
51
- return withCors(await handle(request, recorder));
52
- };
53
- }
54
-
55
- export {
56
- buildMcpListing,
57
- createListToolsHandler
58
- };
@@ -1,125 +0,0 @@
1
- // src/core/logger.ts
2
- var LEVEL_RANK = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
3
- function isLogLevel(value) {
4
- return typeof value === "string" && value in LEVEL_RANK;
5
- }
6
- var LOG_LEVEL_ENV_VAR = "LOVABLE_MCP_LOG_LEVEL";
7
- function readEnvLevel() {
8
- try {
9
- const raw = typeof process !== "undefined" ? process.env?.[LOG_LEVEL_ENV_VAR] : void 0;
10
- const normalized = raw?.trim().toLowerCase();
11
- return isLogLevel(normalized) ? normalized : void 0;
12
- } catch {
13
- return void 0;
14
- }
15
- }
16
- var currentLevel = readEnvLevel() ?? "debug";
17
- function setLogLevel(level) {
18
- currentLevel = level;
19
- }
20
- function parseLogLevel(raw) {
21
- const normalized = raw?.trim().toLowerCase();
22
- return isLogLevel(normalized) ? normalized : void 0;
23
- }
24
- function applyLogLevelFromEnv(raw) {
25
- setLogLevel(parseLogLevel(raw) ?? "debug");
26
- }
27
- function enabled(level) {
28
- return LEVEL_RANK[level] <= LEVEL_RANK[currentLevel];
29
- }
30
- function emit(level, method, event, fields) {
31
- if (!enabled(level))
32
- return;
33
- const message = `[mcp-js] ${event}`;
34
- if (fields)
35
- console[method](message, fields);
36
- else
37
- console[method](message);
38
- }
39
- var log = {
40
- error: (event, fields) => emit("error", "error", event, fields),
41
- warn: (event, fields) => emit("warn", "warn", event, fields),
42
- info: (event, fields) => emit("info", "info", event, fields),
43
- debug: (event, fields) => emit("debug", "debug", event, fields)
44
- };
45
- function describeError(err) {
46
- if (err instanceof Error) {
47
- const code = err.code;
48
- return { name: err.name, message: err.message, ...typeof code === "string" ? { code } : {} };
49
- }
50
- return { value: String(err) };
51
- }
52
-
53
- // src/metrics/config.ts
54
- var DEFAULT_METRICS_ENDPOINT = "https://api.lovable.dev/v1/app-mcp-usage";
55
- var METRICS_API_KEY_ENV_VAR = "LOVABLE_API_KEY";
56
- function assertMetricsEndpoint(endpoint) {
57
- let url;
58
- try {
59
- url = new URL(endpoint);
60
- } catch {
61
- throw new Error(`@lovable.dev/mcp-js: metrics.endpoint must be an absolute URL, got ${JSON.stringify(endpoint)}`);
62
- }
63
- if (url.protocol !== "https:" && url.protocol !== "http:") {
64
- throw new Error(`@lovable.dev/mcp-js: metrics.endpoint must be http(s), got ${JSON.stringify(endpoint)}`);
65
- }
66
- }
67
- function resolveMetricsConfig(config = true) {
68
- const options = typeof config === "boolean" ? { enabled: config } : config;
69
- const endpoint = options.endpoint ?? DEFAULT_METRICS_ENDPOINT;
70
- assertMetricsEndpoint(endpoint);
71
- return Object.freeze({
72
- enabled: options.enabled ?? true,
73
- endpoint,
74
- headers: options.headers ?? {},
75
- apiKeyEnvVar: METRICS_API_KEY_ENV_VAR
76
- });
77
- }
78
-
79
- // src/core/url.ts
80
- function trimTrailingSlash(value) {
81
- return value.replace(/\/+$/, "");
82
- }
83
- function isLocalHTTPHost(hostname) {
84
- return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
85
- }
86
- function urlSafetyProblem(url) {
87
- const isAllowedHTTP = url.protocol === "http:" && isLocalHTTPHost(url.hostname);
88
- if (url.protocol !== "https:" && !isAllowedHTTP) {
89
- return "must use https://, except localhost development URLs";
90
- }
91
- if (url.username || url.password) {
92
- return "must not include credentials";
93
- }
94
- if (url.search || url.hash) {
95
- return "must not include query or fragment";
96
- }
97
- return void 0;
98
- }
99
-
100
- // src/core/validation.ts
101
- function parseSafeUrl(subject, raw, ErrorClass = Error) {
102
- let url;
103
- try {
104
- url = new URL(raw);
105
- } catch {
106
- throw new ErrorClass(`${subject} must be an absolute URL`);
107
- }
108
- const problem = urlSafetyProblem(url);
109
- if (problem) {
110
- throw new ErrorClass(`${subject} ${problem}`);
111
- }
112
- return url;
113
- }
114
-
115
- export {
116
- DEFAULT_METRICS_ENDPOINT,
117
- resolveMetricsConfig,
118
- trimTrailingSlash,
119
- parseSafeUrl,
120
- LOG_LEVEL_ENV_VAR,
121
- setLogLevel,
122
- applyLogLevelFromEnv,
123
- log,
124
- describeError
125
- };