@lovable.dev/mcp-js 0.16.0 → 0.19.0

package/dist/index.cjs

@@ -31,9 +31,6 @@ module.exports = __toCommonJS(src_exports);
 // src/metrics/config.ts
 var DEFAULT_METRICS_ENDPOINT = "https://api.lovable.dev/v1/app-mcp-usage";
 var METRICS_API_KEY_ENV_VAR = "LOVABLE_API_KEY";
-var METRICS_SAMPLE_RATE = 1;
-var METRICS_FLUSH_INTERVAL_MS = 5e3;
-var METRICS_MAX_BATCH_SIZE = 50;
 function assertMetricsEndpoint(endpoint) {
   let url;
   try {
@@ -53,10 +50,7 @@ function resolveMetricsConfig(config = true) {
     enabled: options.enabled ?? true,
     endpoint,
     headers: options.headers ?? {},
-    apiKeyEnvVar: METRICS_API_KEY_ENV_VAR,
-    sampleRate: METRICS_SAMPLE_RATE,
-    flushIntervalMs: METRICS_FLUSH_INTERVAL_MS,
-    maxBatchSize: METRICS_MAX_BATCH_SIZE
+    apiKeyEnvVar: METRICS_API_KEY_ENV_VAR
   });
 }
 
@@ -319,16 +313,17 @@ var LEVEL_RANK = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
 function isLogLevel(value) {
   return typeof value === "string" && value in LEVEL_RANK;
 }
+var LOG_LEVEL_ENV_VAR = "LOVABLE_MCP_LOG_LEVEL";
 function readEnvLevel() {
   try {
-    const raw = typeof process !== "undefined" ? process.env?.["LOVABLE_MCP_LOG_LEVEL"] : void 0;
+    const raw = typeof process !== "undefined" ? process.env?.[LOG_LEVEL_ENV_VAR] : void 0;
     const normalized = raw?.trim().toLowerCase();
     return isLogLevel(normalized) ? normalized : void 0;
   } catch {
     return void 0;
   }
 }
-var currentLevel = readEnvLevel() ?? "silent";
+var currentLevel = readEnvLevel() ?? "debug";
 function setLogLevel(level) {
   currentLevel = level;
 }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { e as McpDefinitionInput, d as McpDefinition, Z as ZodRawShape, l as ToolDefinition, M as McpAuthConfig } from './types-COY42xux.js';
-export { A as AudioContent, C as ContentAnnotations, a as ContentBlock, E as EmbeddedBlobResource, b as EmbeddedResource, c as EmbeddedTextResource, I as ImageContent, J as JwtClaims, f as MetricsConfig, g as MetricsOptions, R as ResourceLink, h as ResourceLinkIcon, T as TextContent, i as ToolAnnotations, j as ToolContent, k as ToolContext, m as ToolHandlerResult, n as ZodSchema } from './types-COY42xux.js';
+import { e as McpDefinitionInput, d as McpDefinition, Z as ZodRawShape, l as ToolDefinition, M as McpAuthConfig } from './types-CPkhCRxc.js';
+export { A as AudioContent, C as ContentAnnotations, a as ContentBlock, E as EmbeddedBlobResource, b as EmbeddedResource, c as EmbeddedTextResource, I as ImageContent, J as JwtClaims, f as MetricsConfig, g as MetricsOptions, R as ResourceLink, h as ResourceLinkIcon, T as TextContent, i as ToolAnnotations, j as ToolContent, k as ToolContext, m as ToolHandlerResult, n as ZodSchema } from './types-CPkhCRxc.js';
 import 'zod';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { e as McpDefinitionInput, d as McpDefinition, Z as ZodRawShape, l as ToolDefinition, M as McpAuthConfig } from './types-COY42xux.js';
-export { A as AudioContent, C as ContentAnnotations, a as ContentBlock, E as EmbeddedBlobResource, b as EmbeddedResource, c as EmbeddedTextResource, I as ImageContent, J as JwtClaims, f as MetricsConfig, g as MetricsOptions, R as ResourceLink, h as ResourceLinkIcon, T as TextContent, i as ToolAnnotations, j as ToolContent, k as ToolContext, m as ToolHandlerResult, n as ZodSchema } from './types-COY42xux.js';
+import { e as McpDefinitionInput, d as McpDefinition, Z as ZodRawShape, l as ToolDefinition, M as McpAuthConfig } from './types-CPkhCRxc.js';
+export { A as AudioContent, C as ContentAnnotations, a as ContentBlock, E as EmbeddedBlobResource, b as EmbeddedResource, c as EmbeddedTextResource, I as ImageContent, J as JwtClaims, f as MetricsConfig, g as MetricsOptions, R as ResourceLink, h as ResourceLinkIcon, T as TextContent, i as ToolAnnotations, j as ToolContent, k as ToolContext, m as ToolHandlerResult, n as ZodSchema } from './types-CPkhCRxc.js';
 import 'zod';
 
 /**

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   parseSafeUrl,
   resolveMetricsConfig,
   setLogLevel
-} from "./chunk-DCWYK4CA.js";
+} from "./chunk-H37EB22A.js";
 
 // src/core/define.ts
 function assertUniqueNames(mcp) {

package/dist/protocols/mcp/index.cjs

@@ -36,16 +36,17 @@ var LEVEL_RANK = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
 function isLogLevel(value) {
   return typeof value === "string" && value in LEVEL_RANK;
 }
+var LOG_LEVEL_ENV_VAR = "LOVABLE_MCP_LOG_LEVEL";
 function readEnvLevel() {
   try {
-    const raw = typeof process !== "undefined" ? process.env?.["LOVABLE_MCP_LOG_LEVEL"] : void 0;
+    const raw = typeof process !== "undefined" ? process.env?.[LOG_LEVEL_ENV_VAR] : void 0;
     const normalized = raw?.trim().toLowerCase();
     return isLogLevel(normalized) ? normalized : void 0;
   } catch {
     return void 0;
   }
 }
-var currentLevel = readEnvLevel() ?? "silent";
+var currentLevel = readEnvLevel() ?? "debug";
 function enabled(level) {
   return LEVEL_RANK[level] <= LEVEL_RANK[currentLevel];
 }
@@ -72,222 +73,15 @@ function describeError(err) {
   return { value: String(err) };
 }
 
-// src/metrics/config.ts
-var DEFAULT_METRICS_ENDPOINT = "https://api.lovable.dev/v1/app-mcp-usage";
-var METRICS_API_KEY_ENV_VAR = "LOVABLE_API_KEY";
-var METRICS_SAMPLE_RATE = 1;
-var METRICS_FLUSH_INTERVAL_MS = 5e3;
-var METRICS_MAX_BATCH_SIZE = 50;
-function assertMetricsEndpoint(endpoint) {
-  let url;
-  try {
-    url = new URL(endpoint);
-  } catch {
-    throw new Error(`@lovable.dev/mcp-js: metrics.endpoint must be an absolute URL, got ${JSON.stringify(endpoint)}`);
-  }
-  if (url.protocol !== "https:" && url.protocol !== "http:") {
-    throw new Error(`@lovable.dev/mcp-js: metrics.endpoint must be http(s), got ${JSON.stringify(endpoint)}`);
-  }
-}
-function resolveMetricsConfig(config = true) {
-  const options = typeof config === "boolean" ? { enabled: config } : config;
-  const endpoint = options.endpoint ?? DEFAULT_METRICS_ENDPOINT;
-  assertMetricsEndpoint(endpoint);
-  return Object.freeze({
-    enabled: options.enabled ?? true,
-    endpoint,
-    headers: options.headers ?? {},
-    apiKeyEnvVar: METRICS_API_KEY_ENV_VAR,
-    sampleRate: METRICS_SAMPLE_RATE,
-    flushIntervalMs: METRICS_FLUSH_INTERVAL_MS,
-    maxBatchSize: METRICS_MAX_BATCH_SIZE
-  });
-}
-
-// package.json
-var version = "0.16.0";
-
-// src/metrics/otlp.ts
-var SCOPE_NAME = "@lovable.dev/mcp-js";
-var EVENT_NAME = "mcp.tool.invocation";
-var SEVERITY_INFO = 9;
-function strAttr(key, value) {
-  return { key, value: { stringValue: value } };
-}
-function intAttr(key, value) {
-  return { key, value: { intValue: String(Math.round(value)) } };
-}
-function toLogRecord(rec) {
-  const attributes = [
-    strAttr("event.name", EVENT_NAME),
-    strAttr("mcp.method", rec.method),
-    strAttr("mcp.outcome", rec.outcome),
-    intAttr("mcp.duration_ms", rec.durationMs)
-  ];
-  if (rec.tool !== null)
-    attributes.push(strAttr("mcp.tool", rec.tool));
-  if (rec.reqBytes !== void 0)
-    attributes.push(intAttr("mcp.request_size_bytes", rec.reqBytes));
-  if (rec.resBytes !== void 0)
-    attributes.push(intAttr("mcp.response_size_bytes", rec.resBytes));
-  return {
-    timeUnixNano: rec.timeUnixNano,
-    observedTimeUnixNano: rec.timeUnixNano,
-    severityNumber: SEVERITY_INFO,
-    severityText: "INFO",
-    body: { stringValue: EVENT_NAME },
-    attributes
-  };
-}
-function buildLogsPayload(records, server) {
-  return JSON.stringify({
-    resourceLogs: [
-      {
-        resource: {
-          attributes: [
-            strAttr("service.name", server.name),
-            strAttr("service.version", server.version),
-            strAttr("telemetry.sdk.name", SCOPE_NAME),
-            strAttr("telemetry.sdk.version", version),
-            strAttr("telemetry.sdk.language", "webjs")
-          ]
-        },
-        scopeLogs: [
-          {
-            scope: { name: SCOPE_NAME, version },
-            logRecords: records.map(toLogRecord)
-          }
-        ]
-      }
-    ]
-  });
-}
-function nowUnixNano() {
-  return `${Date.now()}000000`;
-}
-
-// src/metrics/recorder.ts
+// src/metrics/impl/base.ts
 function nowMs() {
   return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
 }
-function reportInvocation(recorder, ev) {
-  log.info("tool.invoked", { tool: ev.tool, method: ev.method, outcome: ev.outcome, durationMs: ev.durationMs });
-  recorder.record(ev);
-}
-var NOOP_RECORDER = {
-  record() {
-  },
-  async flush() {
-  }
-};
+var NOOP_RECORDER = { async emit() {
+} };
 function createNoopRecorder() {
   return NOOP_RECORDER;
 }
-function readRuntimeEnv(name) {
-  try {
-    const denoEnv = globalThis.Deno?.env;
-    const value = denoEnv?.get?.(name);
-    if (value)
-      return value;
-  } catch {
-  }
-  try {
-    if (typeof process !== "undefined") {
-      const value = process.env?.[name];
-      if (value)
-        return value;
-    }
-  } catch {
-  }
-  return void 0;
-}
-function probeWaitUntil() {
-  const fn = globalThis.EdgeRuntime?.waitUntil;
-  return typeof fn === "function" ? fn.bind(globalThis.EdgeRuntime) : void 0;
-}
-function createMetricsRecorder(ctx, deps = {}) {
-  const { config, server } = ctx;
-  if (!config.enabled)
-    return NOOP_RECORDER;
-  const doFetch = deps.fetch ?? globalThis.fetch;
-  if (!doFetch) {
-    log.warn("metrics.disabled_no_fetch", { endpoint: config.endpoint });
-    return NOOP_RECORDER;
-  }
-  const usesLovableEndpoint = config.endpoint === DEFAULT_METRICS_ENDPOINT;
-  const apiKey = usesLovableEndpoint ? (deps.getApiKey ?? (() => readRuntimeEnv(config.apiKeyEnvVar)))() : void 0;
-  if (usesLovableEndpoint && !apiKey) {
-    log.warn("metrics.disabled_no_api_key", { envVar: config.apiKeyEnvVar, endpoint: config.endpoint });
-    return NOOP_RECORDER;
-  }
-  const waitUntil = deps.waitUntil ?? probeWaitUntil();
-  const buffer = [];
-  let timer;
-  const schedule = (p) => {
-    if (waitUntil) {
-      try {
-        waitUntil(p);
-        return;
-      } catch (err) {
-        log.warn("metrics.wait_until_failed", describeError(err));
-      }
-    }
-    void p.catch(() => {
-    });
-  };
-  const headers = {};
-  if (!usesLovableEndpoint) {
-    for (const [key, value] of Object.entries(config.headers)) {
-      if (key.toLowerCase() !== "content-type")
-        headers[key] = value;
-    }
-  }
-  headers["content-type"] = "application/json";
-  if (apiKey)
-    headers.authorization = `Bearer ${apiKey}`;
-  const flush = async () => {
-    if (buffer.length === 0)
-      return;
-    const records = buffer.splice(0, buffer.length);
-    const dropped = records.length;
-    try {
-      const res = await doFetch(config.endpoint, {
-        method: "POST",
-        headers,
-        body: buildLogsPayload(records, server),
-        keepalive: true
-      });
-      if (!res.ok) {
-        log.warn("metrics.flush_rejected", { status: res.status, dropped, endpoint: config.endpoint });
-      }
-    } catch (err) {
-      log.warn("metrics.flush_failed", { ...describeError(err), dropped, endpoint: config.endpoint });
-    }
-  };
-  const ensureTimer = () => {
-    if (timer !== void 0)
-      return;
-    timer = setInterval(() => schedule(flush()), config.flushIntervalMs);
-    timer.unref?.();
-  };
-  return {
-    record(ev) {
-      if (config.sampleRate < 1 && Math.random() >= config.sampleRate)
-        return;
-      buffer.push({ ...ev, timeUnixNano: nowUnixNano() });
-      ensureTimer();
-      if (buffer.length >= config.maxBatchSize)
-        schedule(flush());
-    },
-    flush
-  };
-}
-function createRecorderForRuntime(mcp) {
-  const config = resolveMetricsConfig(mcp.metrics);
-  if (!config.enabled)
-    return createNoopRecorder();
-  return createMetricsRecorder({ config, server: { name: mcp.name, version: mcp.version } });
-}
 
 // src/core/promise.ts
 function cachedPromise(load, label) {
@@ -709,10 +503,10 @@ function assertRequiredScopes(auth, context) {
     throw new OAuthTokenError(403, "insufficient_scope", "Additional OAuth scope is required");
   }
 }
-function createRequestAuthorizer(mcp, options = {}, recorder) {
+function createRequestAuthorizer(mcp, options = {}) {
   const runtime = getOAuthRuntime(mcp, options);
   return {
-    async authorize(request) {
+    async authorize(request, recorder) {
       if (runtime.kind === "unconfigured")
         return { ok: true };
       const startedAt = nowMs();
@@ -728,7 +522,7 @@ function createRequestAuthorizer(mcp, options = {}, recorder) {
       } catch (err) {
         if (err instanceof OAuthConfigurationError) {
           log.error("auth.config_error", { ...describeError(err), outcome: "500" });
-          recorder?.record({
+          await recorder?.emit({
             tool: null,
             method: "authorize",
             outcome: "auth_config_error",
@@ -839,7 +633,7 @@ function adaptToolToSdkCallback(tool, auth, recorder) {
     try {
       result = await tool.handler(args, new ToolContext(auth));
     } catch {
-      reportInvocation(recorder, {
+      await recorder.emit({
         tool: tool.name,
         method: "tools/call",
         outcome: "handler_error",
@@ -848,7 +642,7 @@ function adaptToolToSdkCallback(tool, auth, recorder) {
       return { content: [{ type: "text", text: "tool execution failed" }], isError: true };
     }
     if (result == null) {
-      reportInvocation(recorder, {
+      await recorder.emit({
         tool: tool.name,
         method: "tools/call",
         outcome: "handler_error",
@@ -856,7 +650,7 @@ function adaptToolToSdkCallback(tool, auth, recorder) {
       });
       return { content: [{ type: "text", text: `tool "${tool.name}" returned no result` }], isError: true };
     }
-    reportInvocation(recorder, {
+    await recorder.emit({
       tool: tool.name,
       method: "tools/call",
       outcome: result.isError ? "tool_error" : "ok",
@@ -865,10 +659,10 @@ function adaptToolToSdkCallback(tool, auth, recorder) {
     return { content: result.content ?? [], structuredContent: result.structuredContent, isError: result.isError };
   };
 }
-function createMcpProtocolHandler(mcp, options = {}, recorder = createRecorderForRuntime(mcp)) {
-  const authorizer = createRequestAuthorizer(mcp, options, recorder);
-  const handle = async (request) => {
-    const authResult = await authorizer.authorize(request);
+function createMcpProtocolHandler(mcp, options = {}) {
+  const authorizer = createRequestAuthorizer(mcp, options);
+  const handle = async (request, recorder) => {
+    const authResult = await authorizer.authorize(request, recorder);
     if (!authResult.ok)
       return authResult.response;
     try {
@@ -895,7 +689,7 @@ function createMcpProtocolHandler(mcp, options = {}, recorder = createRecorderFo
       await server.connect(transport);
       return await transport.handleRequest(request);
     } catch (err) {
-      recorder.record({ tool: null, method: "transport", outcome: "transport_error", durationMs: 0 });
+      await recorder.emit({ tool: null, method: "transport", outcome: "transport_error", durationMs: 0 });
       log.error("mcp.transport_error", { ...describeError(err), outcome: "500 internal error" });
       return Response.json(
         { jsonrpc: "2.0", id: null, error: { code: -32603, message: "internal error" } },
@@ -903,10 +697,10 @@ function createMcpProtocolHandler(mcp, options = {}, recorder = createRecorderFo
       );
     }
   };
-  return async (request) => {
+  return async (request, recorder = createNoopRecorder()) => {
     if (request.method === "OPTIONS")
       return corsPreflightResponse("GET, POST, DELETE, OPTIONS");
-    return withCors(await handle(request));
+    return withCors(await handle(request, recorder));
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/protocols/mcp/index.d.cts

@@ -1,15 +1,16 @@
 import { M as McpRuntimeOptions } from '../../authorize-BMeXd_Sh.js';
-import { d as McpDefinition } from '../../types-COY42xux.js';
-import { M as MetricsRecorder } from '../../recorder-qlzUKFxG.js';
+import { d as McpDefinition } from '../../types-CPkhCRxc.js';
+import { M as MetricsRecorder } from '../../base-C9rhAHZ0.js';
 import 'zod';
 
-type McpProtocolHandler = (request: Request) => Promise<Response>;
+type McpProtocolHandler = (request: Request, recorder?: MetricsRecorder) => Promise<Response>;
 /**
  * Build a Web-Standard request handler that serves the MCP protocol over
  * streamable HTTP. A fresh `McpServer` + transport is constructed per
  * request — the transport is stateless, so this is cheap and there is no
- * cross-request state to leak.
+ * cross-request state to leak. The per-request `recorder` is supplied by the
+ * caller (the stack handler) so telemetry reads the runtime env in-flight.
  */
-declare function createMcpProtocolHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): McpProtocolHandler;
+declare function createMcpProtocolHandler(mcp: McpDefinition, options?: McpRuntimeOptions): McpProtocolHandler;
 
 export { type McpProtocolHandler, createMcpProtocolHandler };

package/dist/protocols/mcp/index.d.ts

@@ -1,15 +1,16 @@
 import { M as McpRuntimeOptions } from '../../authorize-BMeXd_Sh.js';
-import { d as McpDefinition } from '../../types-COY42xux.js';
-import { M as MetricsRecorder } from '../../recorder-qlzUKFxG.js';
+import { d as McpDefinition } from '../../types-CPkhCRxc.js';
+import { M as MetricsRecorder } from '../../base-C9rhAHZ0.js';
 import 'zod';
 
-type McpProtocolHandler = (request: Request) => Promise<Response>;
+type McpProtocolHandler = (request: Request, recorder?: MetricsRecorder) => Promise<Response>;
 /**
  * Build a Web-Standard request handler that serves the MCP protocol over
  * streamable HTTP. A fresh `McpServer` + transport is constructed per
  * request — the transport is stateless, so this is cheap and there is no
- * cross-request state to leak.
+ * cross-request state to leak. The per-request `recorder` is supplied by the
+ * caller (the stack handler) so telemetry reads the runtime env in-flight.
  */
-declare function createMcpProtocolHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): McpProtocolHandler;
+declare function createMcpProtocolHandler(mcp: McpDefinition, options?: McpRuntimeOptions): McpProtocolHandler;
 
 export { type McpProtocolHandler, createMcpProtocolHandler };

package/dist/protocols/mcp/index.js

@@ -1,11 +1,11 @@
 import {
   createMcpProtocolHandler
-} from "../../chunk-EZQVUNXB.js";
+} from "../../chunk-CLXKPZZE.js";
 import "../../chunk-MA5H6PSF.js";
-import "../../chunk-H6BKTNJY.js";
-import "../../chunk-DCWYK4CA.js";
+import "../../chunk-5FX6IIQ6.js";
+import "../../chunk-H37EB22A.js";
 import "../../chunk-6DXGZZA4.js";
-import "../../chunk-SKSKC747.js";
+import "../../chunk-CDZ7MBXC.js";
 export {
   createMcpProtocolHandler
 };

package/dist/protocols/oauth-metadata.cjs

@@ -41,16 +41,17 @@ var LEVEL_RANK = { silent: 0, error: 1, warn: 2, info: 3, debug: 4 };
 function isLogLevel(value) {
   return typeof value === "string" && value in LEVEL_RANK;
 }
+var LOG_LEVEL_ENV_VAR = "LOVABLE_MCP_LOG_LEVEL";
 function readEnvLevel() {
   try {
-    const raw = typeof process !== "undefined" ? process.env?.["LOVABLE_MCP_LOG_LEVEL"] : void 0;
+    const raw = typeof process !== "undefined" ? process.env?.[LOG_LEVEL_ENV_VAR] : void 0;
     const normalized = raw?.trim().toLowerCase();
     return isLogLevel(normalized) ? normalized : void 0;
   } catch {
     return void 0;
   }
 }
-var currentLevel = readEnvLevel() ?? "silent";
+var currentLevel = readEnvLevel() ?? "debug";
 function enabled(level) {
   return LEVEL_RANK[level] <= LEVEL_RANK[currentLevel];
 }

package/dist/protocols/oauth-metadata.d.cts

@@ -1,5 +1,5 @@
 import { M as McpRuntimeOptions } from '../authorize-BMeXd_Sh.js';
-import { d as McpDefinition } from '../types-COY42xux.js';
+import { d as McpDefinition } from '../types-CPkhCRxc.js';
 import 'zod';
 
 type OAuthProtectedResourceMetadataHandler = (request: Request) => Promise<Response>;

package/dist/protocols/oauth-metadata.d.ts

@@ -1,5 +1,5 @@
 import { M as McpRuntimeOptions } from '../authorize-BMeXd_Sh.js';
-import { d as McpDefinition } from '../types-COY42xux.js';
+import { d as McpDefinition } from '../types-CPkhCRxc.js';
 import 'zod';
 
 type OAuthProtectedResourceMetadataHandler = (request: Request) => Promise<Response>;

package/dist/protocols/oauth-metadata.js

@@ -1,10 +1,10 @@
 import {
   createOAuthProtectedResourceMetadataHandler
-} from "../chunk-T24Z753F.js";
-import "../chunk-H6BKTNJY.js";
-import "../chunk-DCWYK4CA.js";
+} from "../chunk-UEOBGHXF.js";
+import "../chunk-5FX6IIQ6.js";
+import "../chunk-H37EB22A.js";
 import "../chunk-6DXGZZA4.js";
-import "../chunk-SKSKC747.js";
+import "../chunk-CDZ7MBXC.js";
 export {
   createOAuthProtectedResourceMetadataHandler
 };