@eventcatalog/core 5.0.0-beta.6 → 5.0.0-beta.8

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.6";
+var version = "5.0.0-beta.8";
 
 // 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));
   }
 };
 
@@ -403,6 +403,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 +526,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"
     })
   );
 };
@@ -769,6 +795,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 +866,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 +883,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 +898,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 +919,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 +1085,7 @@ var FieldsDatabase = class _FieldsDatabase {
       format,
       type,
       messageType,
-      message,
+      message: message2,
       producer,
       consumer,
       required,
@@ -1089,9 +1119,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 +1934,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 +1944,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 +1953,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 +2798,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 +3144,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 +3308,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;

package/dist/eventcatalog.config.d.ts

@@ -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;

package/dist/eventcatalog.js

@@ -4,11 +4,11 @@ import {
 import "./chunk-CA4U2JP7.js";
 import {
   log_build_default
-} from "./chunk-XMPFHLK4.js";
+} from "./chunk-4W55ZOOS.js";
 import {
   getLicenseStatus,
   printLicenseStatus
-} from "./chunk-PIYJM642.js";
+} from "./chunk-AWOO63ME.js";
 import "./chunk-ZAZHAVKB.js";
 import {
   FederationConflictError,
@@ -29,14 +29,15 @@ import {
   getProjectOutDir,
   isAuthEnabled,
   isIndexedSearchEnabled,
-  isOutputServer
-} from "./chunk-MDWB5HLO.js";
+  isOutputServer,
+  isStudioEnabled
+} from "./chunk-ENAG6UH7.js";
 import {
   generate
-} from "./chunk-DE3QHVJP.js";
+} from "./chunk-T4G3VVZ4.js";
 import {
   logger
-} from "./chunk-56CD2NH6.js";
+} from "./chunk-PU25TOOJ.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-36RYTYT5.js";
@@ -50,7 +51,7 @@ import {
 import {
   watch
 } from "./chunk-U63GDPPY.js";
-import "./chunk-QBP3BBSV.js";
+import "./chunk-C6T2AAFR.js";
 import {
   getAstroConfigPath
 } from "./chunk-VIJJ7JKH.js";
@@ -66,7 +67,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-L2IRFOE7.js";
+} from "./chunk-RDIZJ7UT.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile
@@ -79,7 +80,7 @@ import { join } from "path";
 import http from "http";
 import fs3 from "fs";
 import path2 from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath, pathToFileURL } from "url";
 import { createRequire } from "module";
 import boxen from "boxen";
 import updateNotifier from "update-notifier";
@@ -1028,15 +1029,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 = path2.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, 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/features.cjs

@@ -33,7 +33,8 @@ __export(features_exports, {
   getProjectOutDir: () => getProjectOutDir,
   isAuthEnabled: () => isAuthEnabled,
   isIndexedSearchEnabled: () => isIndexedSearchEnabled,
-  isOutputServer: () => isOutputServer
+  isOutputServer: () => isOutputServer,
+  isStudioEnabled: () => isStudioEnabled
 });
 module.exports = __toCommonJS(features_exports);
 
@@ -121,6 +122,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";
@@ -135,5 +140,6 @@ var isAuthEnabled = async () => {
   getProjectOutDir,
   isAuthEnabled,
   isIndexedSearchEnabled,
-  isOutputServer
+  isOutputServer,
+  isStudioEnabled
 });