@lovable.dev/mcp-js 0.15.0 → 0.16.0

package/dist/protocols/rest/index.cjs

@@ -82,6 +82,223 @@ 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
+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() {
+  }
+};
+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) {
   let settled = false;
@@ -510,12 +727,13 @@ function assertRequiredScopes(auth, context) {
     throw new OAuthTokenError(403, "insufficient_scope", "Additional OAuth scope is required");
   }
 }
-function createRequestAuthorizer(mcp, options = {}) {
+function createRequestAuthorizer(mcp, options = {}, recorder) {
   const runtime = getOAuthRuntime(mcp, options);
   return {
     async authorize(request) {
       if (runtime.kind === "unconfigured")
         return { ok: true };
+      const startedAt = nowMs();
       const token = parseBearerToken(request);
       if (!token) {
         log.info("auth.no_bearer_token", { outcome: "401" });
@@ -528,6 +746,12 @@ function createRequestAuthorizer(mcp, options = {}) {
       } catch (err) {
         if (err instanceof OAuthConfigurationError) {
           log.error("auth.config_error", { ...describeError(err), outcome: "500" });
+          recorder?.record({
+            tool: null,
+            method: "authorize",
+            outcome: "auth_config_error",
+            durationMs: nowMs() - startedAt
+          });
           return { ok: false, response: oauthConfigurationErrorResponse() };
         }
         if (err instanceof OAuthTokenError) {
@@ -604,9 +828,9 @@ function buildMcpListing(mcp) {
     }))
   };
 }
-function createListToolsHandler(mcp, options = {}) {
+function createListToolsHandler(mcp, options = {}, recorder = createRecorderForRuntime(mcp)) {
   assertRestResourceBinding(mcp, options);
-  const authorizer = createRequestAuthorizer(mcp, options);
+  const authorizer = createRequestAuthorizer(mcp, options, recorder);
   const handle = async (request) => {
     const authResult = await authorizer.authorize(request);
     if (!authResult.ok)
@@ -669,214 +893,6 @@ var ToolContext = class {
   }
 };
 
-// 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.15.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
-function nowMs() {
-  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
-}
-var NOOP_RECORDER = {
-  record() {
-  },
-  async flush() {
-  }
-};
-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)
-    return NOOP_RECORDER;
-  const usesLovableEndpoint = config.endpoint === DEFAULT_METRICS_ENDPOINT;
-  const apiKey = usesLovableEndpoint ? (deps.getApiKey ?? (() => readRuntimeEnv(config.apiKeyEnvVar)))() : void 0;
-  if (usesLovableEndpoint && !apiKey) {
-    log.debug("metrics.disabled_no_api_key", { envVar: config.apiKeyEnvVar });
-    return NOOP_RECORDER;
-  }
-  const waitUntil = deps.waitUntil ?? probeWaitUntil();
-  const buffer = [];
-  let timer;
-  const schedule = (p) => {
-    if (waitUntil) {
-      try {
-        waitUntil(p);
-        return;
-      } catch {
-      }
-    }
-    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);
-    try {
-      const res = await doFetch(config.endpoint, {
-        method: "POST",
-        headers,
-        body: buildLogsPayload(records, server),
-        keepalive: true
-      });
-      if (!res.ok)
-        log.debug("metrics.flush_rejected", { status: res.status });
-    } catch (err) {
-      log.debug("metrics.flush_failed", describeError(err));
-    }
-  };
-  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/protocols/rest/invoke-tool.ts
 var MAX_REFLECTED_TOOL_NAME = 256;
 function safeReflectName(name) {
@@ -892,7 +908,7 @@ function isEmptyArgs(value) {
 }
 function createInvokeToolHandler(mcp, options = {}, recorder = createRecorderForRuntime(mcp)) {
   assertRestResourceBinding(mcp, options);
-  const authorizer = createRequestAuthorizer(mcp, options);
+  const authorizer = createRequestAuthorizer(mcp, options, recorder);
   const handle = async (request, toolName) => {
     const authResult = await authorizer.authorize(request);
     if (!authResult.ok)
@@ -950,20 +966,30 @@ function createInvokeToolHandler(mcp, options = {}, recorder = createRecorderFor
     try {
       result = await tool.handler(args, new ToolContext(authResult.auth));
     } catch {
-      recorder.record({ tool: tool.name, method: "tools/call", outcome: "handler_error", durationMs: nowMs() - start });
+      reportInvocation(recorder, {
+        tool: tool.name,
+        method: "tools/call",
+        outcome: "handler_error",
+        durationMs: nowMs() - start
+      });
       return new Response(JSON.stringify({ error: "handler threw", tool: toolName }), {
         status: 500,
         headers: JSON_HEADERS
       });
     }
     if (result == null) {
-      recorder.record({ tool: tool.name, method: "tools/call", outcome: "handler_error", durationMs: nowMs() - start });
+      reportInvocation(recorder, {
+        tool: tool.name,
+        method: "tools/call",
+        outcome: "handler_error",
+        durationMs: nowMs() - start
+      });
       return new Response(JSON.stringify({ error: `tool "${toolName}" returned no result` }), {
         status: 500,
         headers: JSON_HEADERS
       });
     }
-    recorder.record({
+    reportInvocation(recorder, {
       tool: tool.name,
       method: "tools/call",
       outcome: result.isError ? "tool_error" : "ok",

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

@@ -1,10 +1,10 @@
 import { M as McpRuntimeOptions } from '../../authorize-BMeXd_Sh.js';
 import { d as McpDefinition } from '../../types-COY42xux.js';
-import { M as MetricsRecorder } from '../../recorder-B-eJU4Qu.js';
+import { M as MetricsRecorder } from '../../recorder-qlzUKFxG.js';
 import 'zod';
 
 type RestListToolsHandler = (request: Request) => Promise<Response>;
-declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions): RestListToolsHandler;
+declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): RestListToolsHandler;
 
 type RestInvokeToolHandler = (request: Request, toolName: string) => Promise<Response>;
 declare function createInvokeToolHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): RestInvokeToolHandler;

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

@@ -1,10 +1,10 @@
 import { M as McpRuntimeOptions } from '../../authorize-BMeXd_Sh.js';
 import { d as McpDefinition } from '../../types-COY42xux.js';
-import { M as MetricsRecorder } from '../../recorder-B-eJU4Qu.js';
+import { M as MetricsRecorder } from '../../recorder-qlzUKFxG.js';
 import 'zod';
 
 type RestListToolsHandler = (request: Request) => Promise<Response>;
-declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions): RestListToolsHandler;
+declare function createListToolsHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): RestListToolsHandler;
 
 type RestInvokeToolHandler = (request: Request, toolName: string) => Promise<Response>;
 declare function createInvokeToolHandler(mcp: McpDefinition, options?: McpRuntimeOptions, recorder?: MetricsRecorder): RestInvokeToolHandler;

package/dist/protocols/rest/index.js

@@ -1,15 +1,14 @@
 import {
   createInvokeToolHandler
-} from "../../chunk-T2RED2TG.js";
+} from "../../chunk-W2EZWPJ5.js";
 import {
   createListToolsHandler
-} from "../../chunk-VNRQPA4K.js";
-import "../../chunk-XQSTN54Y.js";
-import "../../chunk-P3F324UC.js";
-import "../../chunk-G4XA7IJM.js";
-import "../../chunk-QC3DXQTH.js";
+} from "../../chunk-I5CAQUQI.js";
+import "../../chunk-MA5H6PSF.js";
+import "../../chunk-H6BKTNJY.js";
+import "../../chunk-DCWYK4CA.js";
 import "../../chunk-6DXGZZA4.js";
-import "../../chunk-LWHVXXKQ.js";
+import "../../chunk-SKSKC747.js";
 export {
   createInvokeToolHandler,
   createListToolsHandler

package/dist/{recorder-B-eJU4Qu.d.ts → recorder-qlzUKFxG.d.ts}

@@ -1,10 +1,10 @@
-type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error";
+type InvocationOutcome = "ok" | "tool_error" | "handler_error" | "transport_error" | "auth_config_error";
 /** One recorded MCP call. Carries no arguments or response payloads — only the
  *  tool name, the JSON-RPC method, the result class, timing, and byte sizes. */
 interface InvocationRecord {
-    /** Tool name for `tools/call`; `null` for list/initialize and transport faults. */
+    /** Tool name for `tools/call`; `null` for list/initialize, transport faults, and auth-config failures. */
     tool: string | null;
-    /** JSON-RPC method, e.g. `tools/call`. */
+    /** JSON-RPC method, e.g. `tools/call`; `authorize` for auth-config failures. */
     method: string;
     outcome: InvocationOutcome;
     durationMs: number;