@eventcatalog/core 5.0.0-beta.7 → 5.0.0-beta.9

package/dist/eventcatalog.cjs

@@ -181,7 +181,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.0.0-beta.7";
+var version = "5.0.0-beta.9";
 
 // src/constants.ts
 var VERSION = version;
@@ -191,8 +191,8 @@ var getTimestamp = () => {
   const now = /* @__PURE__ */ new Date();
   return now.toLocaleTimeString("en-US", { hour12: false });
 };
-var formatMessage = (tag, message, tagColor) => {
-  return `${import_picocolors.default.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message}`;
+var formatMessage = (tag, message2, tagColor) => {
+  return `${import_picocolors.default.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message2}`;
 };
 var logger = {
   welcome: () => {
@@ -208,28 +208,28 @@ var logger = {
     );
     console.log();
   },
-  info: (message, tag = "info") => {
-    console.log(formatMessage(tag, message, import_picocolors.default.blue));
+  info: (message2, tag = "info") => {
+    console.log(formatMessage(tag, message2, import_picocolors.default.blue));
   },
-  success: (message, tag = "success") => {
-    console.log(formatMessage(tag, message, import_picocolors.default.green));
+  success: (message2, tag = "success") => {
+    console.log(formatMessage(tag, message2, import_picocolors.default.green));
   },
-  error: (message, tag = "error") => {
-    console.log(formatMessage(tag, message, import_picocolors.default.red));
+  error: (message2, tag = "error") => {
+    console.log(formatMessage(tag, message2, import_picocolors.default.red));
   },
-  warning: (message, tag = "warn") => {
-    console.log(formatMessage(tag, message, import_picocolors.default.yellow));
+  warning: (message2, tag = "warn") => {
+    console.log(formatMessage(tag, message2, import_picocolors.default.yellow));
   },
-  line: (message = "") => {
-    console.log(message);
+  line: (message2 = "") => {
+    console.log(message2);
   },
-  diagnostic: (severity, message, rule, attributes = []) => {
+  diagnostic: (severity, message2, rule, attributes = []) => {
     const isError = severity === "error";
     const color = isError ? import_picocolors.default.red : import_picocolors.default.yellow;
     const icon = isError ? "\u2716" : "\u26A0";
-    const label = `${icon} ${severity.padEnd(7)} ${message}`;
+    const label = `${icon} ${severity.padEnd(7)} ${message2}`;
     const ruleSpacing = " ".repeat(Math.max(2, 72 - label.length));
-    console.log(`  ${color(icon)} ${color(severity.padEnd(7))} ${message}${ruleSpacing}${import_picocolors.default.gray(rule)}`);
+    console.log(`  ${color(icon)} ${color(severity.padEnd(7))} ${message2}${ruleSpacing}${import_picocolors.default.gray(rule)}`);
     for (const attribute of attributes) {
       console.log(`             - ${import_picocolors.default.dim(`${attribute.label}:`)} ${attribute.value}`);
     }
@@ -243,8 +243,8 @@ var logger = {
     const warningCount = `${warnings} warning${warnings === 1 ? "" : "s"}`;
     console.log(color(`${icon} ${problems} (${errorCount}, ${warningCount})`));
   },
-  dim: (message) => {
-    console.log(import_picocolors.default.dim(message));
+  dim: (message2) => {
+    console.log(import_picocolors.default.dim(message2));
   }
 };
 
@@ -304,7 +304,23 @@ var generate = async (PROJECT_DIRECTORY) => {
 
 // src/analytics/analytics.js
 var import_os = __toESM(require("os"), 1);
-async function raiseEvent(eventData) {
+
+// src/analytics/telemetry.ts
+var TELEMETRY_REQUEST_TIMEOUT_MS = 2e3;
+var isOptOutEnvValue = (value) => {
+  if (typeof value !== "string") return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized === "1" || normalized === "true";
+};
+var isTelemetryDisabled = (config, env) => {
+  if (isOptOutEnvValue(env.EVENTCATALOG_TELEMETRY_DISABLED)) return true;
+  if (isOptOutEnvValue(env.DO_NOT_TRACK)) return true;
+  return config?.telemetry === false;
+};
+
+// src/analytics/analytics.js
+async function raiseEvent(eventData, config) {
+  if (isTelemetryDisabled(config, process.env)) return;
   if (typeof eventData?.command !== "string" || typeof eventData?.cId !== "string") return;
   const url = "https://queue.simpleanalyticscdn.com/events";
   const userAgent = `@eventcatalog/eventcatalog@${VERSION} (${import_os.default.platform()}; ${import_os.default.arch()}; Node/${process.version})`;
@@ -326,7 +342,8 @@ async function raiseEvent(eventData) {
     const response = await fetch(url, {
       method: "POST",
       headers,
-      body: JSON.stringify(payload)
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(TELEMETRY_REQUEST_TIMEOUT_MS)
     });
     if (!response.ok) {
       throw new Error(`Failed to raise analytics event: ${response.status}`);
@@ -403,6 +420,7 @@ function serializeCounts(counts) {
 
 // src/utils/license-status.ts
 var import_boxen = __toESM(require("boxen"), 1);
+var import_picocolors2 = __toESM(require("picocolors"), 1);
 var import_license2 = require("@eventcatalog/license");
 
 // eventcatalog/src/utils/trial.ts
@@ -525,75 +543,100 @@ var getLicenseAnalytics = (license = { state: "none" }, tsd) => ({
 });
 var formatDate = (date) => date.toLocaleDateString(void 0, { dateStyle: "medium" });
 var formatDays = (days) => `${days} ${days === 1 ? "day" : "days"}`;
-var getTrialLine = (tsd, now) => {
+var PLAIN = { bold: (text) => text, dim: (text) => text, link: (text) => text };
+var COLOURS = { bold: import_picocolors2.default.bold, dim: import_picocolors2.default.dim, link: (text) => import_picocolors2.default.cyan(text) };
+var render = ({ headline, rows, links }, colours) => {
+  const width = Math.max(0, ...[...rows, ...links].map(([label]) => label.length));
+  const row = ([label, value]) => `${colours.dim(label.padEnd(width))}  ${value}`;
+  return [
+    colours.bold(headline),
+    ...rows.length ? ["", ...rows.map(row)] : [],
+    ...links.length ? ["", ...links.map(([label, url]) => row([label, colours.link(url)]))] : []
+  ].join("\n");
+};
+var message = (content) => ({
+  ...content,
+  text: render(content, PLAIN)
+});
+var getTrialRow = (tsd, now) => {
   const trial = getTrialStatus(tsd, now);
   if (!trial) return;
-  return trial.ended ? `Your ${TRIAL_LENGTH_DAYS}-day EventCatalog trial ended on ${formatDate(trial.endsAt)}.` : `${formatDays(trial.daysLeft)} left of your ${TRIAL_LENGTH_DAYS}-day EventCatalog trial (ends ${formatDate(trial.endsAt)}).`;
+  return [
+    "Trial",
+    trial.ended ? `Ended ${formatDate(trial.endsAt)}` : `${formatDays(trial.daysLeft)} left of ${TRIAL_LENGTH_DAYS} (ends ${formatDate(trial.endsAt)})`
+  ];
 };
 var getLicenseStatusMessage = (license, tsd, now = Date.now()) => {
+  const licensing = ["Licensing", LICENSE_FAQ_URL];
+  const renew = ["Renew", LICENSE_RENEW_URL];
+  const licensedTo = "org" in license && license.org ? [["Licensed to", license.org]] : [];
   if (license.state === "licensed") {
     const daysLeft = Math.max(0, Math.ceil((license.expiresAt.getTime() - now) / DAY_IN_MS2));
-    const licensedTo = license.org ? `Licensed to ${license.org}` : "Licensed";
     if (daysLeft < LICENSE_REMINDER_DAYS) {
-      return {
-        title: "EventCatalog Commercial License",
+      return message({
+        title: "EventCatalog license",
         color: "yellow",
-        text: [
-          licensedTo,
-          `Your license expires in ${formatDays(daysLeft)}, on ${formatDate(license.expiresAt)}.`,
-          `Renew it to keep using EventCatalog commercially: ${LICENSE_RENEW_URL}`
-        ].join("\n")
-      };
+        headline: `Your commercial license expires in ${formatDays(daysLeft)}`,
+        rows: [...licensedTo, ["Expires", formatDate(license.expiresAt)]],
+        links: [renew]
+      });
     }
-    return {
-      title: "EventCatalog Commercial License",
+    return message({
+      title: "EventCatalog license",
       color: "green",
-      text: `${licensedTo}
-Valid until ${formatDate(license.expiresAt)} (${formatDays(daysLeft)} left)`
-    };
+      headline: "Commercial license active",
+      rows: [...licensedTo, ["Valid until", `${formatDate(license.expiresAt)} (${formatDays(daysLeft)} left)`]],
+      links: []
+    });
   }
   if (license.state === "plan") return;
-  const trialLine = getTrialLine(tsd, now);
+  const trialRow = getTrialRow(tsd, now);
+  const trialRows = trialRow ? [trialRow] : [];
   if (license.state === "none") {
-    if (!trialLine) return;
-    const ended = getTrialStatus(tsd, now)?.ended;
-    return {
+    const trial = getTrialStatus(tsd, now);
+    if (!trial || !trialRow) return;
+    return message({
       title: "EventCatalog trial",
-      color: ended ? "yellow" : "green",
-      text: `${trialLine}
-Learn about licensing: ${LICENSE_FAQ_URL}`
-    };
+      color: trial.ended ? "yellow" : "green",
+      headline: trial.ended ? "Your EventCatalog trial has ended" : `You're on the ${TRIAL_LENGTH_DAYS}-day EventCatalog trial`,
+      rows: trialRows,
+      links: trial.ended ? [["Get a license", LICENSE_RENEW_URL], licensing] : [licensing]
+    });
   }
   if (license.state === "expired") {
-    const expiredOn = license.expiresAt ? `expired on ${formatDate(license.expiresAt)} (${formatDays(Math.floor((now - license.expiresAt.getTime()) / DAY_IN_MS2))} ago)` : "has expired";
-    return {
-      title: "EventCatalog License Expired",
+    const expiredOn = license.expiresAt ? [
+      [
+        "Expired",
+        `${formatDate(license.expiresAt)} (${formatDays(Math.floor((now - license.expiresAt.getTime()) / DAY_IN_MS2))} ago)`
+      ]
+    ] : [];
+    return message({
+      title: "EventCatalog license",
       color: "yellow",
-      text: [
-        `Your EventCatalog commercial license${license.org ? ` for ${license.org}` : ""} ${expiredOn}.`,
-        `Renew it to keep using EventCatalog commercially: ${LICENSE_RENEW_URL}`,
-        trialLine,
-        `Learn about licensing: ${LICENSE_FAQ_URL}`
-      ].filter(Boolean).join("\n")
-    };
+      headline: "Your commercial license has expired",
+      rows: [...licensedTo, ...expiredOn, ...trialRows],
+      links: [renew, licensing]
+    });
   }
-  return {
+  return message({
     title: "EventCatalog license",
     color: "yellow",
-    text: [`Your license.jwt could not be verified: ${license.reason}.`, trialLine, `Learn about licensing: ${LICENSE_FAQ_URL}`].filter(Boolean).join("\n")
-  };
+    headline: "Your license.jwt couldn't be verified",
+    rows: [["Reason", license.reason.charAt(0).toUpperCase() + license.reason.slice(1)], ...trialRows],
+    links: [licensing]
+  });
 };
 var printLicenseStatus = (license, tsd) => {
-  const message = getLicenseStatusMessage(license, tsd);
-  if (!message) return;
+  const status = getLicenseStatusMessage(license, tsd);
+  if (!status) return;
   console.log(
-    (0, import_boxen.default)(message.text, {
-      padding: 1,
+    (0, import_boxen.default)(render(status, COLOURS), {
+      padding: { top: 1, bottom: 1, left: 2, right: 2 },
       margin: 1,
       borderStyle: "round",
-      borderColor: message.color,
-      title: message.title,
-      titleAlignment: "center"
+      borderColor: status.color,
+      title: status.title,
+      titleAlignment: "left"
     })
   );
 };
@@ -653,50 +696,69 @@ var toCloudResourceCounts = (counts) => ({
   customPages: counts.customPages || 0,
   customApis: counts.customApis || 0
 });
-var reportCloudResourceInventory = async (configFile, resourceCounts) => {
+var getEnabledCloudAnalytics = (configFile) => {
   const analytics = configFile.cloud?.analytics;
-  if (!analytics?.enabled || !analytics.trackingId || !analytics.writeKey) return;
+  if (!analytics?.enabled || !analytics.trackingId || !analytics.writeKey) return null;
+  return analytics;
+};
+var reportCloudResourceInventory = async (configFile, resourceCounts) => {
+  const analytics = getEnabledCloudAnalytics(configFile);
+  if (!analytics) return;
   const endpoint = analytics.endpoint || CLOUD_ANALYTICS_ENDPOINT;
-  await fetch(endpoint, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "X-EventCatalog-Analytics-Key": analytics.writeKey
-    },
-    body: JSON.stringify({
-      trackingId: analytics.trackingId,
-      event: "catalog.resource_inventory_reported",
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      counts: toCloudResourceCounts(resourceCounts)
-    })
-  });
+  try {
+    await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-EventCatalog-Analytics-Key": analytics.writeKey
+      },
+      body: JSON.stringify({
+        trackingId: analytics.trackingId,
+        event: "catalog.resource_inventory_reported",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        counts: toCloudResourceCounts(resourceCounts)
+      }),
+      signal: AbortSignal.timeout(TELEMETRY_REQUEST_TIMEOUT_MS)
+    });
+  } catch {
+  }
 };
 var main = async (projectDir, { command = "build", license } = {}) => {
   try {
     await verifyRequiredFieldsAreInCatalogConfigFile(projectDir);
     const configFile = await getEventCatalogConfigFile(projectDir);
+    if (isTelemetryDisabled(configFile, process.env)) {
+      if (getEnabledCloudAnalytics(configFile)) {
+        const resourceCounts2 = await countResources(projectDir);
+        await reportCloudResourceInventory(configFile, resourceCounts2);
+      }
+      return;
+    }
     const { cId, tsd, organizationName, generators = [] } = configFile;
     const generatorNames = generators.length > 0 ? generators.map((generator) => generator[0]) : ["none"];
     const features = await getFeatures(configFile);
     const resourceCounts = await countResources(projectDir);
     const contentHash = await hashCatalogContent(projectDir);
     await reportCloudResourceInventory(configFile, resourceCounts);
-    await raiseEvent({
-      command,
-      org: organizationName,
-      cId,
-      // Trial start date (unix ms) from eventcatalog.config.js
-      tsd,
-      // Commercial license or trial, and when each expires (unix ms)
-      ...getLicenseAnalytics(license, tsd),
-      // CI redeploys and human-run builds are different signals; tag rather than suppress
-      ci: process.env.CI ? "true" : "false",
-      contentHash,
-      generators: generatorNames.toString(),
-      features: Object.keys(features).map((feature) => `${feature}:${features[feature]}`).join(","),
-      directorySources: serializeDirectorySources(configFile),
-      resources: serializeCounts(resourceCounts)
-    });
+    await raiseEvent(
+      {
+        command,
+        org: organizationName,
+        cId,
+        // Trial start date (unix ms) from eventcatalog.config.js
+        tsd,
+        // Commercial license or trial, and when each expires (unix ms)
+        ...getLicenseAnalytics(license, tsd),
+        // CI redeploys and human-run builds are different signals; tag rather than suppress
+        ci: process.env.CI ? "true" : "false",
+        contentHash,
+        generators: generatorNames.toString(),
+        features: Object.keys(features).map((feature) => `${feature}:${features[feature]}`).join(","),
+        directorySources: serializeDirectorySources(configFile),
+        resources: serializeCounts(resourceCounts)
+      },
+      configFile
+    );
   } catch (error) {
   }
 };
@@ -769,6 +831,10 @@ var isOutputServer = async () => {
   const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
   return config?.output === "server";
 };
+var isStudioEnabled = async () => {
+  const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
+  return config?.output === "server" && config?.studio?.enabled === true;
+};
 var isIndexedSearchEnabled = async () => {
   const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
   return config?.search?.type === "indexed";
@@ -836,13 +902,13 @@ var message_channels_to_service_channels_default = async (dir2) => {
       absolute: true
     }
   );
-  const messagesWithChannels = messages.reduce((acc, message) => {
-    const file = import_node_fs5.default.readFileSync(message, "utf8");
+  const messagesWithChannels = messages.reduce((acc, message2) => {
+    const file = import_node_fs5.default.readFileSync(message2, "utf8");
     const { data } = (0, import_gray_matter3.default)(file);
     if (data.channels?.length > 0) {
       acc.push({
         ...data,
-        path: message
+        path: message2
       });
     }
     return acc;
@@ -853,9 +919,9 @@ var message_channels_to_service_channels_default = async (dir2) => {
   const servicesWithChannels = services.reduce((acc, service) => {
     const file = import_node_fs5.default.readFileSync(service, "utf8");
     const { data } = (0, import_gray_matter3.default)(file);
-    const isSending = data.sends?.some((send) => messagesWithChannels.some((message) => message.id === send.id));
+    const isSending = data.sends?.some((send) => messagesWithChannels.some((message2) => message2.id === send.id));
     const isReceiving = data.receives?.some(
-      (receive) => messagesWithChannels.some((message) => message.id === receive.id)
+      (receive) => messagesWithChannels.some((message2) => message2.id === receive.id)
     );
     if (isSending || isReceiving) {
       acc.push({
@@ -868,16 +934,16 @@ var message_channels_to_service_channels_default = async (dir2) => {
   for (const service of servicesWithChannels) {
     const file = import_node_fs5.default.readFileSync(service.path, "utf8");
     const { data } = (0, import_gray_matter3.default)(file);
-    const messagesTheServiceSendsThatNeedUpdating = data.sends?.filter((send) => messagesWithChannels.some((message) => message.id === send.id)) ?? [];
-    const messagesTheServiceReceivesThatNeedUpdating = data.receives?.filter((receive) => messagesWithChannels.some((message) => message.id === receive.id)) ?? [];
+    const messagesTheServiceSendsThatNeedUpdating = data.sends?.filter((send) => messagesWithChannels.some((message2) => message2.id === send.id)) ?? [];
+    const messagesTheServiceReceivesThatNeedUpdating = data.receives?.filter((receive) => messagesWithChannels.some((message2) => message2.id === receive.id)) ?? [];
     if (messagesTheServiceSendsThatNeedUpdating.length > 0 || messagesTheServiceReceivesThatNeedUpdating.length > 0) {
       const newSends = (data.sends ?? []).map((send) => {
-        const match = messagesWithChannels.find((message) => message.id === send.id);
+        const match = messagesWithChannels.find((message2) => message2.id === send.id);
         if (!match) return send;
         return { ...send, to: (match.channels ?? []).filter((channel) => channel !== null) };
       });
       const newReceives = (data.receives ?? []).map((receive) => {
-        const match = messagesWithChannels.find((message) => message.id === receive.id);
+        const match = messagesWithChannels.find((message2) => message2.id === receive.id);
         if (!match) return receive;
         return { ...receive, from: (match.channels ?? []).filter((channel) => channel !== null) };
       });
@@ -889,11 +955,11 @@ var message_channels_to_service_channels_default = async (dir2) => {
       import_node_fs5.default.writeFileSync(service.path, import_gray_matter3.default.stringify(file, newData));
     }
   }
-  for (const message of messagesWithChannels) {
-    const file = import_node_fs5.default.readFileSync(message.path, "utf8");
+  for (const message2 of messagesWithChannels) {
+    const file = import_node_fs5.default.readFileSync(message2.path, "utf8");
     const parsed = (0, import_gray_matter3.default)(file);
     const { channels, ...newData } = parsed.data;
-    import_node_fs5.default.writeFileSync(message.path, import_gray_matter3.default.stringify(parsed.content, newData));
+    import_node_fs5.default.writeFileSync(message2.path, import_gray_matter3.default.stringify(parsed.content, newData));
   }
   console.log("\u2714 Channels migrated to new services API");
 };
@@ -1055,7 +1121,7 @@ var FieldsDatabase = class _FieldsDatabase {
       format,
       type,
       messageType,
-      message,
+      message: message2,
       producer,
       consumer,
       required,
@@ -1089,9 +1155,9 @@ var FieldsDatabase = class _FieldsDatabase {
       conditions.push(`f.message_type IN (${types2.map(() => "?").join(", ")})`);
       bindings.push(...types2);
     }
-    if (message) {
+    if (message2) {
       conditions.push(`f.message_id = ?`);
-      bindings.push(message);
+      bindings.push(message2);
     }
     if (required) {
       conditions.push(`f.required = 1`);
@@ -1904,8 +1970,8 @@ var KNOWN_EVENTCATALOG_COLLECTIONS = /* @__PURE__ */ new Set([
 var EMPTY_COLLECTION_MESSAGE = /^The collection ("(?:\\.|[^"\\])*") does not exist or is empty\. Please check your content config file for errors\.$/;
 var ANSI_PATTERN = /\u001B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
 var ASTRO_CONTENT_WARN_PREFIX = /^[^[\]]*\[WARN\]\s+\[content\](?:\s+\[[^\]]+\])*\s*$/;
-function collectionNameFromEmptyWarning(message) {
-  const match = message.match(EMPTY_COLLECTION_MESSAGE);
+function collectionNameFromEmptyWarning(message2) {
+  const match = message2.match(EMPTY_COLLECTION_MESSAGE);
   if (!match) return null;
   try {
     const name = JSON.parse(match[1]);
@@ -1914,8 +1980,8 @@ function collectionNameFromEmptyWarning(message) {
     return null;
   }
 }
-function isIntentionalEmptyCollectionMessage(message) {
-  const name = collectionNameFromEmptyWarning(message);
+function isIntentionalEmptyCollectionMessage(message2) {
+  const name = collectionNameFromEmptyWarning(message2);
   return name !== null && KNOWN_EVENTCATALOG_COLLECTIONS.has(name);
 }
 function isIntentionalEmptyCollectionLine(line) {
@@ -1923,8 +1989,8 @@ function isIntentionalEmptyCollectionLine(line) {
   const marker = 'The collection "';
   const start = plain.indexOf(marker);
   if (start === -1) return false;
-  const message = plain.slice(start).trim();
-  if (!isIntentionalEmptyCollectionMessage(message)) return false;
+  const message2 = plain.slice(start).trim();
+  if (!isIntentionalEmptyCollectionMessage(message2)) return false;
   const before = plain.slice(0, start).trim();
   return before.length === 0 || ASTRO_CONTENT_WARN_PREFIX.test(before);
 }
@@ -2768,8 +2834,8 @@ var federateCatalog = async (projectDirectory, options = {}) => {
         generated: resolved.generated
       });
     } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      throw new Error(`Failed to federate source "${source.id}": ${message}`, { cause: error });
+      const message2 = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to federate source "${source.id}": ${message2}`, { cause: error });
     }
   }
   const outDir = import_node_path19.default.join(projectDirectory, "federated");
@@ -3114,10 +3180,10 @@ Upgrade now: npm i @eventcatalog/core@beta`;
   if (!installedVersion) return;
   const pkg = { name: "@eventcatalog/core", version: installedVersion };
   const notifier = (0, import_update_notifier.default)({ pkg, updateCheckInterval: 0 });
-  const message = getEventCatalogUpdateMessage(installedVersion, notifier.update?.latest);
-  if (message) {
+  const message2 = getEventCatalogUpdateMessage(installedVersion, notifier.update?.latest);
+  if (message2) {
     console.log(
-      (0, import_boxen2.default)(message, {
+      (0, import_boxen2.default)(message2, {
         padding: 1,
         margin: 1,
         align: "center",
@@ -3278,15 +3344,33 @@ var previewCatalog = async ({ command }) => {
     shouldFilterLine: createAstroLineFilter()
   });
 };
+var SERVER_BOOTSTRAP = `
+const entry = await import(process.argv[1]);
+const { server } = entry.startServer();
+globalThis[Symbol.for('eventcatalog.http-server')] = server.server;
+const wake = process.env.EVENTCATALOG_STUDIO_WAKE_PATH;
+if (wake) {
+  server.server.once('listening', () => {
+    // Where the server listens (HOST can be one address only); loopback when it listens on every address
+    const { address, port } = server.server.address();
+    const host = ['0.0.0.0', '::'].includes(address) ? '127.0.0.1' : address.includes(':') ? '[' + address + ']' : address;
+    fetch('http://' + host + ':' + port + wake).catch((error) => console.error('[studio] Could not start Studio:', error.message));
+  });
+}
+`;
 var startServerCatalog = async () => {
   const serverEntryPath = import_node_path21.default.join(dir, "dist", "server", "entry.mjs");
+  const config = await getEventCatalogConfigFile(dir);
+  const base = (config?.base || "/").replace(/\/$/, "");
   await runCommandWithFilteredOutput({
     command: process.execPath,
-    args: [serverEntryPath],
+    args: ["--input-type=module", "-e", SERVER_BOOTSTRAP, (0, import_node_url2.pathToFileURL)(serverEntryPath).href],
     cwd: dir,
     env: {
       PROJECT_DIR: dir,
-      CATALOG_DIR: core
+      CATALOG_DIR: core,
+      ASTRO_NODE_AUTOSTART: "disabled",
+      ...await isStudioEnabled() && { EVENTCATALOG_STUDIO_WAKE_PATH: `${base}/_eventcatalog/studio/wake` }
     },
     shouldFilterLine: createAstroLineFilter()
   });

package/dist/eventcatalog.config.d.cts

@@ -197,6 +197,40 @@ type McpConfig = {
     enabled?: boolean;
     auth?: McpAuthConfig;
 };
+/**
+ * Where EventCatalog Studio keeps canvases. People and agents always work on the copy held in memory by the
+ * server, so storage doesn't slow editing down: it's read when the server starts and written a moment after a
+ * canvas changes (and as the server stops).
+ */
+type StudioStorageConfig = 
+/** Kept only while the server runs: canvases are lost when it restarts or redeploys (the default) */
+{
+    type: 'memory';
+}
+/** A SQLite database file. Uses Node.js's built-in SQLite, so needs Node.js 22.13 or later. */
+ | {
+    type: 'sqlite';
+    /**
+     * The database file, relative to the catalog. In a container, put it on a volume (e.g. `/data/studio.db`)
+     * so canvases survive redeploys.
+     * @default '.eventcatalog/studio.db'
+     */
+    path?: string;
+};
+type StudioConfig = {
+    /**
+     * Turns Studio on in production (`output: 'server'`, served with `eventcatalog start`). It's on in the dev server
+     * unless this is `false`, which turns it off everywhere. Experimental. With authentication on, only signed-in people
+     * can open canvases, and they're shown by the name and picture they signed in with.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Where canvases are kept between restarts.
+     * @default { type: 'memory' }
+     */
+    storage?: StudioStorageConfig;
+};
 type GA4Config = {
     measurementId: string;
 };
@@ -257,6 +291,17 @@ interface Config {
     };
     security?: {
         checkOrigin?: boolean;
+        /**
+         * Hosts to trust in a proxy's X-Forwarded-Host and X-Forwarded-Proto headers (server output), e.g. when deployed
+         * behind Fly.io, Railway or a load balancer that serves HTTPS. Without it, form posts (like starting a canvas in
+         * Studio) fail the origin check. Passed to Astro's `security.allowedDomains`.
+         * @example [{ hostname: 'catalog.example.com', protocol: 'https' }]
+         */
+        allowedDomains?: {
+            hostname?: string;
+            protocol?: string;
+            port?: string;
+        }[];
     };
     /**
      * Theme for the catalog UI.
@@ -270,6 +315,8 @@ interface Config {
     theme?: CatalogTheme;
     auth?: AuthConfig;
     mcp?: McpConfig;
+    /** EventCatalog Studio: collaborative canvases (experimental) */
+    studio?: StudioConfig;
     rss?: {
         enabled?: boolean;
         limit?: number;
@@ -410,6 +457,14 @@ interface Config {
     queries?: {
         tableConfiguration?: TableConfiguration;
     };
+    /**
+     * Anonymous telemetry for `eventcatalog dev` and `eventcatalog build`.
+     * On by default. Set to false to opt out.
+     * `EVENTCATALOG_TELEMETRY_DISABLED` or `DO_NOT_TRACK` set to `1` or `true` also opts out.
+     * `cloud.analytics` stays its own opt-in for EventCatalog Cloud.
+     * @default true
+     */
+    telemetry?: boolean;
     cloud?: EventCatalogCloudConfig;
     integrations?: IntegrationsConfig;
     scalarConfiguration?: ScalarConfiguration;