drizzle-cube 0.3.15 → 0.3.17

package/dist/adapters/express/index.cjs

@@ -1 +1,7 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("express"),q=require("cors"),o=require("../compiler-mAJDpIQx.cjs");function R(f){const{cubes:d,drizzle:j,schema:x,extractSecurityContext:y,engineType:g,cors:h,basePath:l="/cubejs-api/v1",jsonLimit:b="10mb",cache:Q}=f;if(!d||d.length===0)throw new Error("At least one cube must be provided in the cubes array");const u=p.Router();h&&u.use(q(h)),u.use(p.json({limit:b})),u.use(p.urlencoded({extended:!0,limit:b}));const a=new o.SemanticLayerCompiler({drizzle:j,schema:x,engineType:g,cache:Q});return d.forEach(t=>{a.registerCube(t)}),u.post(`${l}/load`,async(t,r)=>{try{const e=t.body.query||t.body,s=await y(t,r),n=a.validateQuery(e);if(!n.isValid)return r.status(400).json(o.formatErrorResponse(`Query validation failed: ${n.errors.join(", ")}`,400));const i=t.headers["x-cache-control"]==="no-cache",c=await a.executeMultiCubeQuery(e,s,{skipCache:i});r.json(o.formatCubeResponse(e,c,a))}catch(e){console.error("Query execution error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),u.get(`${l}/load`,async(t,r)=>{try{const e=t.query.query;if(!e)return r.status(400).json(o.formatErrorResponse("Query parameter is required",400));let s;try{s=JSON.parse(e)}catch{return r.status(400).json(o.formatErrorResponse("Invalid JSON in query parameter",400))}const n=await y(t,r),i=a.validateQuery(s);if(!i.isValid)return r.status(400).json(o.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=t.headers["x-cache-control"]==="no-cache",m=await a.executeMultiCubeQuery(s,n,{skipCache:c});r.json(o.formatCubeResponse(s,m,a))}catch(e){console.error("Query execution error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),u.post(`${l}/batch`,async(t,r)=>{try{const{queries:e}=t.body;if(!e||!Array.isArray(e))return r.status(400).json(o.formatErrorResponse('Request body must contain a "queries" array',400));if(e.length===0)return r.status(400).json(o.formatErrorResponse("Queries array cannot be empty",400));const s=await y(t,r),n=t.headers["x-cache-control"]==="no-cache",i=await o.handleBatchRequest(e,s,a,{skipCache:n});r.json(i)}catch(e){console.error("Batch execution error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"Batch execution failed",500))}}),u.get(`${l}/meta`,(t,r)=>{try{const e=a.getMetadata();r.json(o.formatMetaResponse(e))}catch(e){console.error("Metadata error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"Failed to fetch metadata",500))}}),u.post(`${l}/sql`,async(t,r)=>{try{const e=t.body,s=await y(t,r),n=a.validateQuery(e);if(!n.isValid)return r.status(400).json(o.formatErrorResponse(`Query validation failed: ${n.errors.join(", ")}`,400));const i=e.measures?.[0]||e.dimensions?.[0];if(!i)return r.status(400).json(o.formatErrorResponse("No measures or dimensions specified",400));const c=i.split(".")[0],m=await a.generateSQL(c,e,s);r.json(o.formatSqlResponse(e,m))}catch(e){console.error("SQL generation error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),u.get(`${l}/sql`,async(t,r)=>{try{const e=t.query.query;if(!e)return r.status(400).json(o.formatErrorResponse("Query parameter is required",400));const s=JSON.parse(e),n=await y(t,r),i=a.validateQuery(s);if(!i.isValid)return r.status(400).json(o.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=s.measures?.[0]||s.dimensions?.[0];if(!c)return r.status(400).json(o.formatErrorResponse("No measures or dimensions specified",400));const m=c.split(".")[0],C=await a.generateSQL(m,s,n);r.json(o.formatSqlResponse(s,C))}catch(e){console.error("SQL generation error:",e),r.status(500).json(o.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),u.post(`${l}/dry-run`,async(t,r)=>{try{const e=t.body.query||t.body,s=await y(t,r),n=await o.handleDryRun(e,s,a);r.json(n)}catch(e){console.error("Dry-run error:",e),r.status(400).json({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),u.get(`${l}/dry-run`,async(t,r)=>{try{const e=t.query.query;if(!e)return r.status(400).json({error:"Query parameter is required",valid:!1});const s=JSON.parse(e),n=await y(t,r),i=await o.handleDryRun(s,n,a);r.json(i)}catch(e){console.error("Dry-run error:",e),r.status(400).json({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),u.post(`${l}/explain`,async(t,r)=>{try{const e=t.body.query||t.body,s=t.body.options||{},n=await y(t,r),i=a.validateQuery(e);if(!i.isValid)return r.status(400).json({error:`Query validation failed: ${i.errors.join(", ")}`});const c=await a.explainQuery(e,n,s);r.json(c)}catch(e){console.error("Explain error:",e),r.status(500).json({error:e instanceof Error?e.message:"Explain query failed"})}}),u.use((t,r,e,s)=>{console.error("Express adapter error:",t),e.headersSent||e.status(500).json(o.formatErrorResponse(t,500))}),u}function E(f,d){const j=R(d);return f.use("/",j),f}function v(f){const d=p();return E(d,f)}exports.createCubeApp=v;exports.createCubeRouter=R;exports.mountCubeRoutes=E;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("express"),M=require("cors"),r=require("../mcp-transport-weiPD7j5.cjs");function S(f){const{cubes:m,drizzle:E,schema:$,extractSecurityContext:d,engineType:I,cors:g,basePath:p="/cubejs-api/v1",jsonLimit:x="10mb",cache:P,mcp:h={enabled:!0}}=f;if(!m||m.length===0)throw new Error("At least one cube must be provided in the cubes array");const u=R.Router();g&&u.use(M(g)),u.use(R.json({limit:x})),u.use(R.urlencoded({extended:!0,limit:x}));const c=new r.SemanticLayerCompiler({drizzle:E,schema:$,engineType:I,cache:P});if(m.forEach(o=>{c.registerCube(o)}),u.post(`${p}/load`,async(o,t)=>{try{const e=o.body.query||o.body,s=await d(o,t),n=c.validateQuery(e);if(!n.isValid)return t.status(400).json(r.formatErrorResponse(`Query validation failed: ${n.errors.join(", ")}`,400));const a=o.headers["x-cache-control"]==="no-cache",i=await c.executeMultiCubeQuery(e,s,{skipCache:a});t.json(r.formatCubeResponse(e,i,c))}catch(e){console.error("Query execution error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),u.get(`${p}/load`,async(o,t)=>{try{const e=o.query.query;if(!e)return t.status(400).json(r.formatErrorResponse("Query parameter is required",400));let s;try{s=JSON.parse(e)}catch{return t.status(400).json(r.formatErrorResponse("Invalid JSON in query parameter",400))}const n=await d(o,t),a=c.validateQuery(s);if(!a.isValid)return t.status(400).json(r.formatErrorResponse(`Query validation failed: ${a.errors.join(", ")}`,400));const i=o.headers["x-cache-control"]==="no-cache",y=await c.executeMultiCubeQuery(s,n,{skipCache:i});t.json(r.formatCubeResponse(s,y,c))}catch(e){console.error("Query execution error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),u.post(`${p}/batch`,async(o,t)=>{try{const{queries:e}=o.body;if(!e||!Array.isArray(e))return t.status(400).json(r.formatErrorResponse('Request body must contain a "queries" array',400));if(e.length===0)return t.status(400).json(r.formatErrorResponse("Queries array cannot be empty",400));const s=await d(o,t),n=o.headers["x-cache-control"]==="no-cache",a=await r.handleBatchRequest(e,s,c,{skipCache:n});t.json(a)}catch(e){console.error("Batch execution error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"Batch execution failed",500))}}),u.get(`${p}/meta`,(o,t)=>{try{const e=c.getMetadata();t.json(r.formatMetaResponse(e))}catch(e){console.error("Metadata error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"Failed to fetch metadata",500))}}),u.post(`${p}/sql`,async(o,t)=>{try{const e=o.body,s=await d(o,t),n=c.validateQuery(e);if(!n.isValid)return t.status(400).json(r.formatErrorResponse(`Query validation failed: ${n.errors.join(", ")}`,400));const a=e.measures?.[0]||e.dimensions?.[0];if(!a)return t.status(400).json(r.formatErrorResponse("No measures or dimensions specified",400));const i=a.split(".")[0],y=await c.generateSQL(i,e,s);t.json(r.formatSqlResponse(e,y))}catch(e){console.error("SQL generation error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),u.get(`${p}/sql`,async(o,t)=>{try{const e=o.query.query;if(!e)return t.status(400).json(r.formatErrorResponse("Query parameter is required",400));const s=JSON.parse(e),n=await d(o,t),a=c.validateQuery(s);if(!a.isValid)return t.status(400).json(r.formatErrorResponse(`Query validation failed: ${a.errors.join(", ")}`,400));const i=s.measures?.[0]||s.dimensions?.[0];if(!i)return t.status(400).json(r.formatErrorResponse("No measures or dimensions specified",400));const y=i.split(".")[0],C=await c.generateSQL(y,s,n);t.json(r.formatSqlResponse(s,C))}catch(e){console.error("SQL generation error:",e),t.status(500).json(r.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),u.post(`${p}/dry-run`,async(o,t)=>{try{const e=o.body.query||o.body,s=await d(o,t),n=await r.handleDryRun(e,s,c);t.json(n)}catch(e){console.error("Dry-run error:",e),t.status(400).json({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),u.get(`${p}/dry-run`,async(o,t)=>{try{const e=o.query.query;if(!e)return t.status(400).json({error:"Query parameter is required",valid:!1});const s=JSON.parse(e),n=await d(o,t),a=await r.handleDryRun(s,n,c);t.json(a)}catch(e){console.error("Dry-run error:",e),t.status(400).json({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),u.post(`${p}/explain`,async(o,t)=>{try{const e=o.body.query||o.body,s=o.body.options||{},n=await d(o,t),a=c.validateQuery(e);if(!a.isValid)return t.status(400).json({error:`Query validation failed: ${a.errors.join(", ")}`});const i=await c.explainQuery(e,n,s);t.json(i)}catch(e){console.error("Explain error:",e),t.status(500).json({error:e instanceof Error?e.message:"Explain query failed"})}}),h.enabled!==!1){const o=h.basePath??"/mcp";u.post(`${o}`,async(t,e)=>{const s=r.validateOriginHeader(t.headers.origin,h.allowedOrigins?{allowedOrigins:h.allowedOrigins}:{});if(!s.valid)return e.status(403).json(r.buildJsonRpcError(null,-32600,s.reason));const n=t.headers.accept;if(!r.validateAcceptHeader(n))return e.status(400).json(r.buildJsonRpcError(null,-32600,"Accept header must include both application/json and text/event-stream"));const a=r.negotiateProtocol(t.headers);if(!a.ok)return e.status(426).json({error:"Unsupported MCP protocol version",supported:a.supported});const i=r.parseJsonRpc(t.body);if(!i)return e.status(400).json(r.buildJsonRpcError(null,-32600,"Invalid JSON-RPC 2.0 request"));const y=r.wantsEventStream(n),C=i.method==="initialize";try{const l=await r.dispatchMcpMethod(i.method,i.params,{semanticLayer:c,extractSecurityContext:d,rawRequest:t,rawResponse:e,negotiatedProtocol:a.negotiated});if(r.isNotification(i))return e.status(202).end();const j=C&&l&&typeof l=="object"&&"sessionId"in l?l.sessionId:void 0;j&&e.setHeader(r.MCP_SESSION_ID_HEADER,j);const v=r.buildJsonRpcResult(i.id??null,l);if(y){const b=r.primeEventId();return e.status(200),e.setHeader("Content-Type","text/event-stream"),e.setHeader("Cache-Control","no-cache"),e.setHeader("Connection","keep-alive"),e.write(`id: ${b}
+
+`),e.write(r.serializeSseEvent(v,b)),e.end()}return e.json(v)}catch(l){if(r.isNotification(i))return console.error("MCP notification processing error:",l),e.status(202).end();console.error("MCP RPC error:",l);const j=l?.code??-32603,v=l?.data,b=l.message||"MCP request failed",w=r.buildJsonRpcError(i.id??null,j,b,v);if(y){const Q=r.primeEventId();return e.status(200),e.setHeader("Content-Type","text/event-stream"),e.setHeader("Cache-Control","no-cache"),e.setHeader("Connection","keep-alive"),e.write(`id: ${Q}
+
+`),e.write(r.serializeSseEvent(w,Q)),e.end()}return e.status(200).json(w)}}),u.get(`${o}`,async(t,e)=>{const s=r.primeEventId();e.status(200),e.setHeader("Content-Type","text/event-stream"),e.setHeader("Cache-Control","no-cache"),e.setHeader("Connection","keep-alive"),e.write(r.serializeSseEvent({jsonrpc:"2.0",method:"mcp/ready",params:{protocol:"streamable-http"}},s,15e3));const n=setInterval(()=>{e.write(`: keep-alive
+
+`)},15e3);t.on("close",()=>{clearInterval(n)})}),u.delete(`${o}`,(t,e)=>e.status(405).json({error:"Session termination not supported"}))}return u.use((o,t,e,s)=>{console.error("Express adapter error:",o),e.headersSent||e.status(500).json(r.formatErrorResponse(o,500))}),u}function q(f,m){const E=S(m);return f.use("/",E),f}function H(f){const m=R();return q(m,f)}exports.createCubeApp=H;exports.createCubeRouter=S;exports.mountCubeRoutes=q;

package/dist/adapters/express/index.d.ts

@@ -4,6 +4,7 @@ import { SemanticQuery, SecurityContext, DatabaseExecutor, DrizzleDatabase, Cube
 import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
 import { MySql2Database } from 'drizzle-orm/mysql2';
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { MCPOptions } from '../utils';
 export interface ExpressAdapterOptions {
     /**
      * Array of cube definitions to register
@@ -66,6 +67,12 @@ export interface ExpressAdapterOptions {
      * When provided, query results will be cached using the specified provider
      */
     cache?: CacheConfig;
+    /**
+     * MCP (AI-Ready) endpoint configuration
+     * Enables AI agents to discover and query your data
+     * @default { enabled: true }
+     */
+    mcp?: MCPOptions;
 }
 /**
  * Create Express router for Cube.js-compatible API

package/dist/adapters/express/index.js

@@ -1,51 +1,52 @@
-import h, { Router as E } from "express";
-import R from "cors";
-import { S, d as a, f as x, h as $, a as L, b as Q, c as g } from "../compiler-DdcGVWIl.js";
-function N(f) {
+import R, { Router as L } from "express";
+import A from "cors";
+import { S as J, o as c, f as M, h as D, a as _, b as P, c as H, v as V, d as C, e as z, n as B, p as T, w as F, g as U, k as I, M as G, l as K, m as w, s as Q } from "../mcp-transport-Dew98Fh6.js";
+function W(f) {
   const {
-    cubes: d,
-    drizzle: p,
-    schema: v,
+    cubes: m,
+    drizzle: g,
+    schema: N,
     extractSecurityContext: l,
-    engineType: C,
-    cors: j,
+    engineType: k,
+    cors: E,
     basePath: y = "/cubejs-api/v1",
-    jsonLimit: b = "10mb",
-    cache: q
+    jsonLimit: S = "10mb",
+    cache: O,
+    mcp: h = { enabled: !0 }
   } = f;
-  if (!d || d.length === 0)
+  if (!m || m.length === 0)
     throw new Error("At least one cube must be provided in the cubes array");
-  const c = E();
-  j && c.use(R(j)), c.use(h.json({ limit: b })), c.use(h.urlencoded({ extended: !0, limit: b }));
-  const s = new S({
-    drizzle: p,
-    schema: v,
-    engineType: C,
-    cache: q
+  const u = L();
+  E && u.use(A(E)), u.use(R.json({ limit: S })), u.use(R.urlencoded({ extended: !0, limit: S }));
+  const i = new J({
+    drizzle: g,
+    schema: N,
+    engineType: k,
+    cache: O
   });
-  return d.forEach((r) => {
-    s.registerCube(r);
-  }), c.post(`${y}/load`, async (r, t) => {
+  if (m.forEach((r) => {
+    i.registerCube(r);
+  }), u.post(`${y}/load`, async (r, t) => {
     try {
-      const e = r.body.query || r.body, o = await l(r, t), n = s.validateQuery(e);
-      if (!n.isValid)
-        return t.status(400).json(a(
-          `Query validation failed: ${n.errors.join(", ")}`,
+      const e = r.body.query || r.body, o = await l(r, t), a = i.validateQuery(e);
+      if (!a.isValid)
+        return t.status(400).json(c(
+          `Query validation failed: ${a.errors.join(", ")}`,
           400
         ));
-      const i = r.headers["x-cache-control"] === "no-cache", u = await s.executeMultiCubeQuery(e, o, { skipCache: i });
-      t.json(x(e, u, s));
+      const s = r.headers["x-cache-control"] === "no-cache", n = await i.executeMultiCubeQuery(e, o, { skipCache: s });
+      t.json(M(e, n, i));
     } catch (e) {
-      console.error("Query execution error:", e), t.status(500).json(a(
+      console.error("Query execution error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "Query execution failed",
         500
       ));
     }
-  }), c.get(`${y}/load`, async (r, t) => {
+  }), u.get(`${y}/load`, async (r, t) => {
     try {
       const e = r.query.query;
       if (!e)
-        return t.status(400).json(a(
+        return t.status(400).json(c(
           "Query parameter is required",
           400
         ));
@@ -53,117 +54,117 @@ function N(f) {
       try {
         o = JSON.parse(e);
       } catch {
-        return t.status(400).json(a(
+        return t.status(400).json(c(
           "Invalid JSON in query parameter",
           400
         ));
       }
-      const n = await l(r, t), i = s.validateQuery(o);
-      if (!i.isValid)
-        return t.status(400).json(a(
-          `Query validation failed: ${i.errors.join(", ")}`,
+      const a = await l(r, t), s = i.validateQuery(o);
+      if (!s.isValid)
+        return t.status(400).json(c(
+          `Query validation failed: ${s.errors.join(", ")}`,
           400
         ));
-      const u = r.headers["x-cache-control"] === "no-cache", m = await s.executeMultiCubeQuery(o, n, { skipCache: u });
-      t.json(x(o, m, s));
+      const n = r.headers["x-cache-control"] === "no-cache", p = await i.executeMultiCubeQuery(o, a, { skipCache: n });
+      t.json(M(o, p, i));
     } catch (e) {
-      console.error("Query execution error:", e), t.status(500).json(a(
+      console.error("Query execution error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "Query execution failed",
         500
       ));
     }
-  }), c.post(`${y}/batch`, async (r, t) => {
+  }), u.post(`${y}/batch`, async (r, t) => {
     try {
       const { queries: e } = r.body;
       if (!e || !Array.isArray(e))
-        return t.status(400).json(a(
+        return t.status(400).json(c(
           'Request body must contain a "queries" array',
           400
         ));
       if (e.length === 0)
-        return t.status(400).json(a(
+        return t.status(400).json(c(
           "Queries array cannot be empty",
           400
         ));
-      const o = await l(r, t), n = r.headers["x-cache-control"] === "no-cache", i = await $(e, o, s, { skipCache: n });
-      t.json(i);
+      const o = await l(r, t), a = r.headers["x-cache-control"] === "no-cache", s = await D(e, o, i, { skipCache: a });
+      t.json(s);
     } catch (e) {
-      console.error("Batch execution error:", e), t.status(500).json(a(
+      console.error("Batch execution error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "Batch execution failed",
         500
       ));
     }
-  }), c.get(`${y}/meta`, (r, t) => {
+  }), u.get(`${y}/meta`, (r, t) => {
     try {
-      const e = s.getMetadata();
-      t.json(L(e));
+      const e = i.getMetadata();
+      t.json(_(e));
     } catch (e) {
-      console.error("Metadata error:", e), t.status(500).json(a(
+      console.error("Metadata error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "Failed to fetch metadata",
         500
       ));
     }
-  }), c.post(`${y}/sql`, async (r, t) => {
+  }), u.post(`${y}/sql`, async (r, t) => {
     try {
-      const e = r.body, o = await l(r, t), n = s.validateQuery(e);
-      if (!n.isValid)
-        return t.status(400).json(a(
-          `Query validation failed: ${n.errors.join(", ")}`,
+      const e = r.body, o = await l(r, t), a = i.validateQuery(e);
+      if (!a.isValid)
+        return t.status(400).json(c(
+          `Query validation failed: ${a.errors.join(", ")}`,
           400
         ));
-      const i = e.measures?.[0] || e.dimensions?.[0];
-      if (!i)
-        return t.status(400).json(a(
+      const s = e.measures?.[0] || e.dimensions?.[0];
+      if (!s)
+        return t.status(400).json(c(
           "No measures or dimensions specified",
           400
         ));
-      const u = i.split(".")[0], m = await s.generateSQL(u, e, o);
-      t.json(Q(e, m));
+      const n = s.split(".")[0], p = await i.generateSQL(n, e, o);
+      t.json(P(e, p));
     } catch (e) {
-      console.error("SQL generation error:", e), t.status(500).json(a(
+      console.error("SQL generation error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "SQL generation failed",
         500
       ));
     }
-  }), c.get(`${y}/sql`, async (r, t) => {
+  }), u.get(`${y}/sql`, async (r, t) => {
     try {
       const e = r.query.query;
       if (!e)
-        return t.status(400).json(a(
+        return t.status(400).json(c(
           "Query parameter is required",
           400
         ));
-      const o = JSON.parse(e), n = await l(r, t), i = s.validateQuery(o);
-      if (!i.isValid)
-        return t.status(400).json(a(
-          `Query validation failed: ${i.errors.join(", ")}`,
+      const o = JSON.parse(e), a = await l(r, t), s = i.validateQuery(o);
+      if (!s.isValid)
+        return t.status(400).json(c(
+          `Query validation failed: ${s.errors.join(", ")}`,
           400
         ));
-      const u = o.measures?.[0] || o.dimensions?.[0];
-      if (!u)
-        return t.status(400).json(a(
+      const n = o.measures?.[0] || o.dimensions?.[0];
+      if (!n)
+        return t.status(400).json(c(
           "No measures or dimensions specified",
           400
         ));
-      const m = u.split(".")[0], w = await s.generateSQL(m, o, n);
-      t.json(Q(o, w));
+      const p = n.split(".")[0], x = await i.generateSQL(p, o, a);
+      t.json(P(o, x));
     } catch (e) {
-      console.error("SQL generation error:", e), t.status(500).json(a(
+      console.error("SQL generation error:", e), t.status(500).json(c(
         e instanceof Error ? e.message : "SQL generation failed",
         500
       ));
     }
-  }), c.post(`${y}/dry-run`, async (r, t) => {
+  }), u.post(`${y}/dry-run`, async (r, t) => {
     try {
-      const e = r.body.query || r.body, o = await l(r, t), n = await g(e, o, s);
-      t.json(n);
+      const e = r.body.query || r.body, o = await l(r, t), a = await H(e, o, i);
+      t.json(a);
     } catch (e) {
       console.error("Dry-run error:", e), t.status(400).json({
         error: e instanceof Error ? e.message : "Dry-run validation failed",
         valid: !1
       });
     }
-  }), c.get(`${y}/dry-run`, async (r, t) => {
+  }), u.get(`${y}/dry-run`, async (r, t) => {
     try {
       const e = r.query.query;
       if (!e)
@@ -171,42 +172,118 @@ function N(f) {
           error: "Query parameter is required",
           valid: !1
         });
-      const o = JSON.parse(e), n = await l(r, t), i = await g(o, n, s);
-      t.json(i);
+      const o = JSON.parse(e), a = await l(r, t), s = await H(o, a, i);
+      t.json(s);
     } catch (e) {
       console.error("Dry-run error:", e), t.status(400).json({
         error: e instanceof Error ? e.message : "Dry-run validation failed",
         valid: !1
       });
     }
-  }), c.post(`${y}/explain`, async (r, t) => {
+  }), u.post(`${y}/explain`, async (r, t) => {
     try {
-      const e = r.body.query || r.body, o = r.body.options || {}, n = await l(r, t), i = s.validateQuery(e);
-      if (!i.isValid)
+      const e = r.body.query || r.body, o = r.body.options || {}, a = await l(r, t), s = i.validateQuery(e);
+      if (!s.isValid)
         return t.status(400).json({
-          error: `Query validation failed: ${i.errors.join(", ")}`
+          error: `Query validation failed: ${s.errors.join(", ")}`
         });
-      const u = await s.explainQuery(e, n, o);
-      t.json(u);
+      const n = await i.explainQuery(e, a, o);
+      t.json(n);
     } catch (e) {
       console.error("Explain error:", e), t.status(500).json({
         error: e instanceof Error ? e.message : "Explain query failed"
       });
     }
-  }), c.use((r, t, e, o) => {
-    console.error("Express adapter error:", r), e.headersSent || e.status(500).json(a(r, 500));
-  }), c;
+  }), h.enabled !== !1) {
+    const r = h.basePath ?? "/mcp";
+    u.post(`${r}`, async (t, e) => {
+      const o = V(
+        t.headers.origin,
+        h.allowedOrigins ? { allowedOrigins: h.allowedOrigins } : {}
+      );
+      if (!o.valid)
+        return e.status(403).json(C(null, -32600, o.reason));
+      const a = t.headers.accept;
+      if (!z(a))
+        return e.status(400).json(C(null, -32600, "Accept header must include both application/json and text/event-stream"));
+      const s = B(t.headers);
+      if (!s.ok)
+        return e.status(426).json({
+          error: "Unsupported MCP protocol version",
+          supported: s.supported
+        });
+      const n = T(t.body);
+      if (!n)
+        return e.status(400).json(C(null, -32600, "Invalid JSON-RPC 2.0 request"));
+      const p = F(a), x = n.method === "initialize";
+      try {
+        const d = await U(
+          n.method,
+          n.params,
+          {
+            semanticLayer: i,
+            extractSecurityContext: l,
+            rawRequest: t,
+            rawResponse: e,
+            negotiatedProtocol: s.negotiated
+          }
+        );
+        if (I(n))
+          return e.status(202).end();
+        const j = x && d && typeof d == "object" && "sessionId" in d ? d.sessionId : void 0;
+        j && e.setHeader(G, j);
+        const v = K(n.id ?? null, d);
+        if (p) {
+          const b = w();
+          return e.status(200), e.setHeader("Content-Type", "text/event-stream"), e.setHeader("Cache-Control", "no-cache"), e.setHeader("Connection", "keep-alive"), e.write(`id: ${b}
+
+`), e.write(Q(v, b)), e.end();
+        }
+        return e.json(v);
+      } catch (d) {
+        if (I(n))
+          return console.error("MCP notification processing error:", d), e.status(202).end();
+        console.error("MCP RPC error:", d);
+        const j = d?.code ?? -32603, v = d?.data, b = d.message || "MCP request failed", q = C(n.id ?? null, j, b, v);
+        if (p) {
+          const $ = w();
+          return e.status(200), e.setHeader("Content-Type", "text/event-stream"), e.setHeader("Cache-Control", "no-cache"), e.setHeader("Connection", "keep-alive"), e.write(`id: ${$}
+
+`), e.write(Q(q, $)), e.end();
+        }
+        return e.status(200).json(q);
+      }
+    }), u.get(`${r}`, async (t, e) => {
+      const o = w();
+      e.status(200), e.setHeader("Content-Type", "text/event-stream"), e.setHeader("Cache-Control", "no-cache"), e.setHeader("Connection", "keep-alive"), e.write(Q({
+        jsonrpc: "2.0",
+        method: "mcp/ready",
+        params: { protocol: "streamable-http" }
+      }, o, 15e3));
+      const a = setInterval(() => {
+        e.write(`: keep-alive
+
+`);
+      }, 15e3);
+      t.on("close", () => {
+        clearInterval(a);
+      });
+    }), u.delete(`${r}`, (t, e) => e.status(405).json({ error: "Session termination not supported" }));
+  }
+  return u.use((r, t, e, o) => {
+    console.error("Express adapter error:", r), e.headersSent || e.status(500).json(c(r, 500));
+  }), u;
 }
-function M(f, d) {
-  const p = N(d);
-  return f.use("/", p), f;
+function X(f, m) {
+  const g = W(m);
+  return f.use("/", g), f;
 }
-function J(f) {
-  const d = h();
-  return M(d, f);
+function te(f) {
+  const m = R();
+  return X(m, f);
 }
 export {
-  J as createCubeApp,
-  N as createCubeRouter,
-  M as mountCubeRoutes
+  te as createCubeApp,
+  W as createCubeRouter,
+  X as mountCubeRoutes
 };

package/dist/adapters/fastify/index.cjs

@@ -1 +1,7 @@
-"use strict";var w=Object.create;var E=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty;var L=(u,s,g,b)=>{if(s&&typeof s=="object"||typeof s=="function")for(let y of j(s))!P.call(u,y)&&y!==g&&E(u,y,{get:()=>s[y],enumerable:!(b=S(s,y))||b.enumerable});return u};var M=(u,s,g)=>(g=u!=null?w($(u)):{},L(s||!u||!u.__esModule?E(g,"default",{value:u,enumerable:!0}):g,u));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../compiler-mAJDpIQx.cjs"),h=function(s,g,b){const{cubes:y,drizzle:q,schema:x,extractSecurityContext:p,engineType:C,cors:R,basePath:l="/cubejs-api/v1",bodyLimit:f=10485760,cache:v}=g;if(!y||y.length===0)return b(new Error("At least one cube must be provided in the cubes array"));R&&s.register(import("@fastify/cors"),R),s.addHook("onRequest",async(r,t)=>{r.method==="POST"&&(r.body=void 0)});const n=new a.SemanticLayerCompiler({drizzle:q,schema:x,engineType:C,cache:v});y.forEach(r=>{n.registerCube(r)}),s.post(`${l}/load`,{bodyLimit:f,schema:{body:{type:"object",additionalProperties:!0}}},async(r,t)=>{try{const e=r.body,o=e.query||e,i=await p(r),c=n.validateQuery(o);if(!c.isValid)return t.status(400).send(a.formatErrorResponse(`Query validation failed: ${c.errors.join(", ")}`,400));const d=r.headers["x-cache-control"]==="no-cache",m=await n.executeMultiCubeQuery(o,i,{skipCache:d});return a.formatCubeResponse(o,m,n)}catch(e){return r.log.error(e,"Query execution error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),s.get(`${l}/load`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,t)=>{try{const{query:e}=r.query;let o;try{o=JSON.parse(e)}catch{return t.status(400).send(a.formatErrorResponse("Invalid JSON in query parameter",400))}const i=await p(r),c=n.validateQuery(o);if(!c.isValid)return t.status(400).send(a.formatErrorResponse(`Query validation failed: ${c.errors.join(", ")}`,400));const d=r.headers["x-cache-control"]==="no-cache",m=await n.executeMultiCubeQuery(o,i,{skipCache:d});return a.formatCubeResponse(o,m,n)}catch(e){return r.log.error(e,"Query execution error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),s.post(`${l}/batch`,{bodyLimit:f,schema:{body:{type:"object",required:["queries"],properties:{queries:{type:"array",items:{type:"object"}}}}}},async(r,t)=>{try{const{queries:e}=r.body;if(!e||!Array.isArray(e))return t.status(400).send(a.formatErrorResponse('Request body must contain a "queries" array',400));if(e.length===0)return t.status(400).send(a.formatErrorResponse("Queries array cannot be empty",400));const o=await p(r),i=r.headers["x-cache-control"]==="no-cache";return await a.handleBatchRequest(e,o,n,{skipCache:i})}catch(e){return r.log.error(e,"Batch execution error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"Batch execution failed",500))}}),s.get(`${l}/meta`,async(r,t)=>{try{const e=n.getMetadata();return a.formatMetaResponse(e)}catch(e){return r.log.error(e,"Metadata error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"Failed to fetch metadata",500))}}),s.post(`${l}/sql`,{bodyLimit:f,schema:{body:{type:"object",additionalProperties:!0}}},async(r,t)=>{try{const e=r.body,o=await p(r),i=n.validateQuery(e);if(!i.isValid)return t.status(400).send(a.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=e.measures?.[0]||e.dimensions?.[0];if(!c)return t.status(400).send(a.formatErrorResponse("No measures or dimensions specified",400));const d=c.split(".")[0],m=await n.generateSQL(d,e,o);return a.formatSqlResponse(e,m)}catch(e){return r.log.error(e,"SQL generation error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),s.get(`${l}/sql`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,t)=>{try{const{query:e}=r.query,o=JSON.parse(e),i=await p(r),c=n.validateQuery(o);if(!c.isValid)return t.status(400).send(a.formatErrorResponse(`Query validation failed: ${c.errors.join(", ")}`,400));const d=o.measures?.[0]||o.dimensions?.[0];if(!d)return t.status(400).send(a.formatErrorResponse("No measures or dimensions specified",400));const m=d.split(".")[0],Q=await n.generateSQL(m,o,i);return a.formatSqlResponse(o,Q)}catch(e){return r.log.error(e,"SQL generation error"),t.status(500).send(a.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),s.post(`${l}/dry-run`,{bodyLimit:f,schema:{body:{type:"object",additionalProperties:!0}}},async(r,t)=>{try{const e=r.body,o=e.query||e,i=await p(r);return await a.handleDryRun(o,i,n)}catch(e){return r.log.error(e,"Dry-run error"),t.status(400).send({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),s.get(`${l}/dry-run`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,t)=>{try{const{query:e}=r.query,o=JSON.parse(e),i=await p(r);return await a.handleDryRun(o,i,n)}catch(e){return r.log.error(e,"Dry-run error"),t.status(400).send({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),s.post(`${l}/explain`,{bodyLimit:f,schema:{body:{type:"object",additionalProperties:!0}}},async(r,t)=>{try{const e=r.body,o=e.query||e,i=e.options||{},c=await p(r),d=n.validateQuery(o);return d.isValid?await n.explainQuery(o,c,i):t.status(400).send({error:`Query validation failed: ${d.errors.join(", ")}`})}catch(e){return r.log.error(e,"Explain error"),t.status(500).send({error:e instanceof Error?e.message:"Explain query failed"})}}),s.setErrorHandler(async(r,t,e)=>{t.log.error(r,"Fastify cube adapter error"),e.statusCode<400&&e.status(500);const o=r instanceof Error?r:String(r);return a.formatErrorResponse(o,e.statusCode)}),b()};async function N(u,s){await u.register(h,s)}function A(u){const s=require("fastify")({logger:!0});return s.register(h,u),s}exports.createCubeApp=A;exports.cubePlugin=h;exports.registerCubeRoutes=N;
+"use strict";var N=Object.create;var Q=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var J=Object.getOwnPropertyNames;var k=Object.getPrototypeOf,A=Object.prototype.hasOwnProperty;var L=(d,n,g,f)=>{if(n&&typeof n=="object"||typeof n=="function")for(let y of J(n))!A.call(d,y)&&y!==g&&Q(d,y,{get:()=>n[y],enumerable:!(f=O(n,y))||f.enumerable});return d};var D=(d,n,g)=>(g=d!=null?N(k(d)):{},L(n||!d||!d.__esModule?Q(g,"default",{value:d,enumerable:!0}):g,d));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../mcp-transport-weiPD7j5.cjs"),x=function(n,g,f){const{cubes:y,drizzle:$,schema:j,extractSecurityContext:m,engineType:I,cors:q,basePath:h="/cubejs-api/v1",bodyLimit:b=10485760,cache:M,mcp:v={enabled:!0}}=g;if(!y||y.length===0)return f(new Error("At least one cube must be provided in the cubes array"));q&&n.register(import("@fastify/cors"),q),n.addHook("onRequest",async(r,o)=>{r.method==="POST"&&(r.body=void 0)});const u=new t.SemanticLayerCompiler({drizzle:$,schema:j,engineType:I,cache:M});if(y.forEach(r=>{u.registerCube(r)}),n.post(`${h}/load`,{bodyLimit:b,schema:{body:{type:"object",additionalProperties:!0}}},async(r,o)=>{try{const e=r.body,s=e.query||e,a=await m(r),i=u.validateQuery(s);if(!i.isValid)return o.status(400).send(t.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=r.headers["x-cache-control"]==="no-cache",l=await u.executeMultiCubeQuery(s,a,{skipCache:c});return t.formatCubeResponse(s,l,u)}catch(e){return r.log.error(e,"Query execution error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),n.get(`${h}/load`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,o)=>{try{const{query:e}=r.query;let s;try{s=JSON.parse(e)}catch{return o.status(400).send(t.formatErrorResponse("Invalid JSON in query parameter",400))}const a=await m(r),i=u.validateQuery(s);if(!i.isValid)return o.status(400).send(t.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=r.headers["x-cache-control"]==="no-cache",l=await u.executeMultiCubeQuery(s,a,{skipCache:c});return t.formatCubeResponse(s,l,u)}catch(e){return r.log.error(e,"Query execution error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"Query execution failed",500))}}),n.post(`${h}/batch`,{bodyLimit:b,schema:{body:{type:"object",required:["queries"],properties:{queries:{type:"array",items:{type:"object"}}}}}},async(r,o)=>{try{const{queries:e}=r.body;if(!e||!Array.isArray(e))return o.status(400).send(t.formatErrorResponse('Request body must contain a "queries" array',400));if(e.length===0)return o.status(400).send(t.formatErrorResponse("Queries array cannot be empty",400));const s=await m(r),a=r.headers["x-cache-control"]==="no-cache";return await t.handleBatchRequest(e,s,u,{skipCache:a})}catch(e){return r.log.error(e,"Batch execution error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"Batch execution failed",500))}}),n.get(`${h}/meta`,async(r,o)=>{try{const e=u.getMetadata();return t.formatMetaResponse(e)}catch(e){return r.log.error(e,"Metadata error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"Failed to fetch metadata",500))}}),n.post(`${h}/sql`,{bodyLimit:b,schema:{body:{type:"object",additionalProperties:!0}}},async(r,o)=>{try{const e=r.body,s=await m(r),a=u.validateQuery(e);if(!a.isValid)return o.status(400).send(t.formatErrorResponse(`Query validation failed: ${a.errors.join(", ")}`,400));const i=e.measures?.[0]||e.dimensions?.[0];if(!i)return o.status(400).send(t.formatErrorResponse("No measures or dimensions specified",400));const c=i.split(".")[0],l=await u.generateSQL(c,e,s);return t.formatSqlResponse(e,l)}catch(e){return r.log.error(e,"SQL generation error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),n.get(`${h}/sql`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,o)=>{try{const{query:e}=r.query,s=JSON.parse(e),a=await m(r),i=u.validateQuery(s);if(!i.isValid)return o.status(400).send(t.formatErrorResponse(`Query validation failed: ${i.errors.join(", ")}`,400));const c=s.measures?.[0]||s.dimensions?.[0];if(!c)return o.status(400).send(t.formatErrorResponse("No measures or dimensions specified",400));const l=c.split(".")[0],w=await u.generateSQL(l,s,a);return t.formatSqlResponse(s,w)}catch(e){return r.log.error(e,"SQL generation error"),o.status(500).send(t.formatErrorResponse(e instanceof Error?e.message:"SQL generation failed",500))}}),n.post(`${h}/dry-run`,{bodyLimit:b,schema:{body:{type:"object",additionalProperties:!0}}},async(r,o)=>{try{const e=r.body,s=e.query||e,a=await m(r);return await t.handleDryRun(s,a,u)}catch(e){return r.log.error(e,"Dry-run error"),o.status(400).send({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),n.get(`${h}/dry-run`,{schema:{querystring:{type:"object",properties:{query:{type:"string"}},required:["query"]}}},async(r,o)=>{try{const{query:e}=r.query,s=JSON.parse(e),a=await m(r);return await t.handleDryRun(s,a,u)}catch(e){return r.log.error(e,"Dry-run error"),o.status(400).send({error:e instanceof Error?e.message:"Dry-run validation failed",valid:!1})}}),n.post(`${h}/explain`,{bodyLimit:b,schema:{body:{type:"object",additionalProperties:!0}}},async(r,o)=>{try{const e=r.body,s=e.query||e,a=e.options||{},i=await m(r),c=u.validateQuery(s);return c.isValid?await u.explainQuery(s,i,a):o.status(400).send({error:`Query validation failed: ${c.errors.join(", ")}`})}catch(e){return r.log.error(e,"Explain error"),o.status(500).send({error:e instanceof Error?e.message:"Explain query failed"})}}),v.enabled!==!1){const r=v.basePath??"/mcp";n.post(`${r}`,{bodyLimit:b,schema:{body:{type:"object",additionalProperties:!0}}},async(o,e)=>{const s=t.validateOriginHeader(o.headers.origin,v.allowedOrigins?{allowedOrigins:v.allowedOrigins}:{});if(!s.valid)return e.status(403).send(t.buildJsonRpcError(null,-32600,s.reason));const a=o.headers.accept;if(!t.validateAcceptHeader(a))return e.status(400).send(t.buildJsonRpcError(null,-32600,"Accept header must include both application/json and text/event-stream"));const i=t.negotiateProtocol(o.headers);if(!i.ok)return e.status(426).send({error:"Unsupported MCP protocol version",supported:i.supported});const c=t.parseJsonRpc(o.body);if(!c)return e.status(400).send(t.buildJsonRpcError(null,-32600,"Invalid JSON-RPC 2.0 request"));const l=t.wantsEventStream(a),w=c.method==="initialize";try{const p=await t.dispatchMcpMethod(c.method,c.params,{semanticLayer:u,extractSecurityContext:m,rawRequest:o,rawResponse:e,negotiatedProtocol:i.negotiated});if(t.isNotification(c))return e.status(202).send();const R=w&&p&&typeof p=="object"&&"sessionId"in p?p.sessionId:void 0;R&&e.header(t.MCP_SESSION_ID_HEADER,R);const E=t.buildJsonRpcResult(c.id??null,p);if(l){const C=t.primeEventId();e.header("Content-Type","text/event-stream").header("Cache-Control","no-cache").header("Connection","keep-alive").send(`id: ${C}
+
+${t.serializeSseEvent(E,C)}`);return}return e.send(E)}catch(p){if(t.isNotification(c))return o.log.error(p,"MCP notification processing error"),e.status(202).send();o.log.error(p,"MCP RPC error");const R=p?.code??-32603,E=p?.data,C=p.message||"MCP request failed",S=t.buildJsonRpcError(c.id??null,R,C,E);if(l){const P=t.primeEventId();e.header("Content-Type","text/event-stream").header("Cache-Control","no-cache").header("Connection","keep-alive").send(`id: ${P}
+
+${t.serializeSseEvent(S,P)}`);return}return e.send(S)}}),n.get(`${r}`,async(o,e)=>{const s=t.primeEventId();e.raw.writeHead(200,{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive"}),e.raw.write(t.serializeSseEvent({jsonrpc:"2.0",method:"mcp/ready",params:{protocol:"streamable-http"}},s,15e3));const a=setInterval(()=>{e.raw.write(`: keep-alive
+
+`)},15e3);o.raw.on("close",()=>{clearInterval(a)})}),n.delete(`${r}`,async(o,e)=>e.status(405).send({error:"Session termination not supported"}))}n.setErrorHandler(async(r,o,e)=>{o.log.error(r,"Fastify cube adapter error"),e.statusCode<400&&e.status(500);const s=r instanceof Error?r:String(r);return t.formatErrorResponse(s,e.statusCode)}),f()};async function z(d,n){await d.register(x,n)}function H(d){const n=require("fastify")({logger:!0});return n.register(x,d),n}exports.createCubeApp=H;exports.cubePlugin=x;exports.registerCubeRoutes=z;

package/dist/adapters/fastify/index.d.ts

@@ -4,6 +4,7 @@ import { SemanticQuery, SecurityContext, DatabaseExecutor, DrizzleDatabase, Cube
 import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
 import { MySql2Database } from 'drizzle-orm/mysql2';
 import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import { MCPOptions } from '../utils';
 export interface FastifyAdapterOptions {
     /**
      * Array of cube definitions to register
@@ -65,6 +66,12 @@ export interface FastifyAdapterOptions {
      * When provided, query results will be cached using the specified provider
      */
     cache?: CacheConfig;
+    /**
+     * MCP (AI-Ready) endpoint configuration
+     * Enables AI agents to discover and query your data
+     * @default { enabled: true }
+     */
+    mcp?: MCPOptions;
 }
 /**
  * Fastify plugin for Cube.js-compatible API