@eventcatalog/core 5.0.0-beta.0 → 5.0.0-beta.10

package/dist/eventcatalog.config.d.ts

@@ -197,6 +197,38 @@ type McpConfig = {
     enabled?: boolean;
     auth?: McpAuthConfig;
 };
+/**
+ * The state EventCatalog keeps for features that need it (today, Studio's canvases). Features always work on a copy
+ * held in memory by the server, so storage doesn't slow them down: it's read when the server starts and written a
+ * moment after something changes (and as the server stops).
+ */
+type StorageConfig = 
+/** Kept only while the server runs: lost when it restarts or redeploys (the default) */
+{
+    type: 'memory';
+}
+/**
+ * One SQLite database file for the whole catalog, brought up to date (migrated) as `eventcatalog dev` and
+ * `eventcatalog start` start. 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/eventcatalog.db`)
+     * so it survives redeploys.
+     * @default '.eventcatalog/eventcatalog.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;
+};
 type GA4Config = {
     measurementId: string;
 };
@@ -257,6 +289,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 +313,13 @@ interface Config {
     theme?: CatalogTheme;
     auth?: AuthConfig;
     mcp?: McpConfig;
+    /** EventCatalog Studio: collaborative canvases (experimental) */
+    studio?: StudioConfig;
+    /**
+     * Where EventCatalog keeps state between restarts (e.g. Studio's canvases), for every feature that has some.
+     * @default { type: 'memory' }
+     */
+    storage?: StorageConfig;
     rss?: {
         enabled?: boolean;
         limit?: number;
@@ -410,6 +460,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;
@@ -418,4 +476,4 @@ interface Config {
     federation?: FederationConfig;
 }
 
-export type { Config, FederationRuleId, FederationRuleLevel, FederationRulesConfig, FederationSourceConfig };
+export type { Config, FederationRuleId, FederationRuleLevel, FederationRulesConfig, FederationSourceConfig, StorageConfig };

package/dist/eventcatalog.js

@@ -4,17 +4,18 @@ import {
 import "./chunk-CA4U2JP7.js";
 import {
   log_build_default
-} from "./chunk-LR7AGRHN.js";
+} from "./chunk-CRKJBDN7.js";
 import {
   getLicenseStatus,
   printLicenseStatus
-} from "./chunk-TQLRG35T.js";
+} from "./chunk-AWOO63ME.js";
 import "./chunk-ZAZHAVKB.js";
 import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "./chunk-AYNZXUB5.js";
+} from "./chunk-KHACCTW2.js";
+import "./chunk-WRNH5C3U.js";
 import "./chunk-5EPNFDT5.js";
 import "./chunk-A2RZR3U4.js";
 import "./chunk-R7Z5ALYI.js";
@@ -24,7 +25,6 @@ import {
 } from "./chunk-JJPB6EOZ.js";
 import "./chunk-SDZQJTJW.js";
 import "./chunk-352FGP6W.js";
-import "./chunk-WRNH5C3U.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
@@ -33,10 +33,10 @@ import {
 } from "./chunk-MDWB5HLO.js";
 import {
   generate
-} from "./chunk-CR6AK5LR.js";
+} from "./chunk-EM36OL6A.js";
 import {
   logger
-} from "./chunk-ZHKEARLJ.js";
+} from "./chunk-2LBDRHE4.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-36RYTYT5.js";
@@ -50,7 +50,8 @@ import {
 import {
   watch
 } from "./chunk-U63GDPPY.js";
-import "./chunk-WAIADKQE.js";
+import "./chunk-LJMXOEEC.js";
+import "./chunk-CPW6G62V.js";
 import {
   getAstroConfigPath
 } from "./chunk-VIJJ7JKH.js";
@@ -66,7 +67,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-TWN43V4T.js";
+} from "./chunk-IONYKKOY.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 start = process.env.EVENTCATALOG_START_PATH;
+if (start) {
+  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 + start).catch((error) => console.error('[eventcatalog] Could not start the server:', 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",
+      EVENTCATALOG_START_PATH: `${base}/_eventcatalog/start`
     },
     shouldFilterLine: createAstroLineFilter()
   });

package/dist/federation/federate.js

@@ -2,14 +2,14 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "../chunk-AYNZXUB5.js";
+} from "../chunk-KHACCTW2.js";
+import "../chunk-WRNH5C3U.js";
 import "../chunk-5EPNFDT5.js";
 import "../chunk-A2RZR3U4.js";
 import "../chunk-R7Z5ALYI.js";
 import "../chunk-JJPB6EOZ.js";
 import "../chunk-SDZQJTJW.js";
 import "../chunk-352FGP6W.js";
-import "../chunk-WRNH5C3U.js";
 import "../chunk-RFIXKATC.js";
 export {
   FederationConflictError,

package/dist/generate.cjs

@@ -112,7 +112,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.0.0-beta.0";
+var version = "5.0.0-beta.10";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-CR6AK5LR.js";
-import "./chunk-ZHKEARLJ.js";
-import "./chunk-TWN43V4T.js";
+} from "./chunk-EM36OL6A.js";
+import "./chunk-2LBDRHE4.js";
+import "./chunk-IONYKKOY.js";
 import "./chunk-RFIXKATC.js";
 export {
   generate

package/dist/runtime-dependencies/@hocuspocus__provider.mjs

@@ -0,0 +1,3 @@
+export * from "@hocuspocus/provider";
+import * as dependency from "@hocuspocus/provider";
+export default dependency.default;

package/dist/runtime-dependencies/@hocuspocus__server.mjs

@@ -0,0 +1,3 @@
+export * from "@hocuspocus/server";
+import * as dependency from "@hocuspocus/server";
+export default dependency.default;

package/dist/runtime-dependencies/@mcp-b__webmcp-local-relay.mjs

@@ -0,0 +1,3 @@
+export * from "@mcp-b/webmcp-local-relay";
+import * as dependency from "@mcp-b/webmcp-local-relay";
+export default dependency.default;

package/dist/runtime-dependencies/@mcp-b__webmcp-polyfill.mjs

@@ -0,0 +1,3 @@
+export * from "@mcp-b/webmcp-polyfill";
+import * as dependency from "@mcp-b/webmcp-polyfill";
+export default dependency.default;

package/dist/runtime-dependencies/manifest.json

@@ -34,7 +34,11 @@
   "@heroicons/react/24/outline/RectangleGroupIcon": "@heroicons__react__24__outline__RectangleGroupIcon.mjs",
   "@heroicons/react/24/outline/ServerIcon": "@heroicons__react__24__outline__ServerIcon.mjs",
   "@heroicons/react/24/solid": "@heroicons__react__24__solid.mjs",
+  "@hocuspocus/provider": "@hocuspocus__provider.mjs",
+  "@hocuspocus/server": "@hocuspocus__server.mjs",
   "@iconify-json/logos": "@iconify-json__logos.mjs",
+  "@mcp-b/webmcp-local-relay": "@mcp-b__webmcp-local-relay.mjs",
+  "@mcp-b/webmcp-polyfill": "@mcp-b__webmcp-polyfill.mjs",
   "@mermaid-js/layout-elk": "@mermaid-js__layout-elk.mjs",
   "@mermaid-js/layout-elk/dist/mermaid-layout-elk.core.mjs": "@mermaid-js__layout-elk__dist__mermaid-layout-elk.core.mjs.mjs",
   "@modelcontextprotocol/ext-apps": "@modelcontextprotocol__ext-apps.mjs",
@@ -107,6 +111,7 @@
   "react-dom": "react-dom.mjs",
   "react-dom/client": "react-dom__client.mjs",
   "react-dom/server": "react-dom__server.mjs",
+  "react-hotkeys-hook": "react-hotkeys-hook.mjs",
   "react-markdown": "react-markdown.mjs",
   "react-syntax-highlighter": "react-syntax-highlighter.mjs",
   "react-syntax-highlighter/dist/cjs/styles/prism": "react-syntax-highlighter__dist__cjs__styles__prism.mjs",
@@ -132,7 +137,6 @@
   "rimraf": "rimraf.mjs",
   "semver": "semver.mjs",
   "set-cookie-parser": "set-cookie-parser.mjs",
-  "shelljs": "shelljs.mjs",
   "sonner": "sonner.mjs",
   "sql.js": "sql.js.mjs",
   "tailwindcss": "tailwindcss.mjs",
@@ -140,6 +144,9 @@
   "unist-util-visit": "unist-util-visit.mjs",
   "update-notifier": "update-notifier.mjs",
   "uuid": "uuid.mjs",
+  "y-protocols": "y-protocols.mjs",
+  "y-protocols/awareness": "y-protocols__awareness.mjs",
+  "yjs": "yjs.mjs",
   "zod": "zod.mjs",
   "zod/v4": "zod__v4.mjs"
 }

package/dist/runtime-dependencies/react-hotkeys-hook.mjs

@@ -0,0 +1,3 @@
+export * from "react-hotkeys-hook";
+import * as dependency from "react-hotkeys-hook";
+export default dependency.default;

package/dist/runtime-dependencies/y-protocols.mjs

@@ -0,0 +1,3 @@
+export * from "y-protocols";
+import * as dependency from "y-protocols";
+export default dependency.default;

package/dist/runtime-dependencies/y-protocols__awareness.mjs

@@ -0,0 +1,3 @@
+export * from "y-protocols/awareness";
+import * as dependency from "y-protocols/awareness";
+export default dependency.default;

package/dist/runtime-dependencies/yjs.mjs

@@ -0,0 +1,3 @@
+export * from "yjs";
+import * as dependency from "yjs";
+export default dependency.default;

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.0.0-beta.0";
+var version = "5.0.0-beta.10";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-ZHKEARLJ.js";
-import "../chunk-TWN43V4T.js";
+} from "../chunk-2LBDRHE4.js";
+import "../chunk-IONYKKOY.js";
 export {
   logger
 };

package/dist/utils/license-status.cjs

@@ -37,10 +37,11 @@ __export(license_status_exports, {
 });
 module.exports = __toCommonJS(license_status_exports);
 var import_boxen = __toESM(require("boxen"), 1);
+var import_picocolors = __toESM(require("picocolors"), 1);
 var import_license2 = require("@eventcatalog/license");
 
 // eventcatalog/src/utils/trial.ts
-var TRIAL_LENGTH_DAYS = 90;
+var TRIAL_LENGTH_DAYS = 60;
 var LICENSE_FAQ_URL = "https://www.eventcatalog.dev/license-faq";
 var LICENSE_RENEW_URL = "https://eventcatalog.cloud";
 var DAY_IN_MS = 24 * 60 * 60 * 1e3;
@@ -159,75 +160,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_picocolors.default.bold, dim: import_picocolors.default.dim, link: (text) => import_picocolors.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"
     })
   );
 };

package/dist/utils/license-status.d.cts

@@ -15,14 +15,23 @@ declare const getLicenseAnalytics: (license?: LicenseStatus, tsd?: unknown) => {
     licenseExpiry: number | undefined;
     trialExpiry: number | undefined;
 };
+type Row = [label: string, value: string];
 /**
- * The license (or trial) box for the terminal. Undefined when there's nothing to show.
+ * What the license box says: a headline, the facts as aligned rows ("Licensed to  acme"), and links on their own
+ * rows, so it can be read at a glance. `text` is the box's content without colours.
  */
-declare const getLicenseStatusMessage: (license: LicenseStatus, tsd: unknown, now?: number) => {
+type LicenseStatusMessage = {
     title: string;
-    color: string;
+    color: 'green' | 'yellow';
+    headline: string;
+    rows: Row[];
+    links: Row[];
     text: string;
-} | undefined;
+};
+/**
+ * The license (or trial) box for the terminal. Undefined when there's nothing to show.
+ */
+declare const getLicenseStatusMessage: (license: LicenseStatus, tsd: unknown, now?: number) => LicenseStatusMessage | undefined;
 declare const printLicenseStatus: (license: LicenseStatus, tsd: unknown) => void;
 
-export { LicenseStatus, getLicenseAnalytics, getLicenseStatus, getLicenseStatusMessage, printLicenseStatus };
+export { LicenseStatus, type LicenseStatusMessage, getLicenseAnalytics, getLicenseStatus, getLicenseStatusMessage, printLicenseStatus };

package/dist/utils/license-status.d.ts

@@ -15,14 +15,23 @@ declare const getLicenseAnalytics: (license?: LicenseStatus, tsd?: unknown) => {
     licenseExpiry: number | undefined;
     trialExpiry: number | undefined;
 };
+type Row = [label: string, value: string];
 /**
- * The license (or trial) box for the terminal. Undefined when there's nothing to show.
+ * What the license box says: a headline, the facts as aligned rows ("Licensed to  acme"), and links on their own
+ * rows, so it can be read at a glance. `text` is the box's content without colours.
  */
-declare const getLicenseStatusMessage: (license: LicenseStatus, tsd: unknown, now?: number) => {
+type LicenseStatusMessage = {
     title: string;
-    color: string;
+    color: 'green' | 'yellow';
+    headline: string;
+    rows: Row[];
+    links: Row[];
     text: string;
-} | undefined;
+};
+/**
+ * The license (or trial) box for the terminal. Undefined when there's nothing to show.
+ */
+declare const getLicenseStatusMessage: (license: LicenseStatus, tsd: unknown, now?: number) => LicenseStatusMessage | undefined;
 declare const printLicenseStatus: (license: LicenseStatus, tsd: unknown) => void;
 
-export { LicenseStatus, getLicenseAnalytics, getLicenseStatus, getLicenseStatusMessage, printLicenseStatus };
+export { LicenseStatus, type LicenseStatusMessage, getLicenseAnalytics, getLicenseStatus, getLicenseStatusMessage, printLicenseStatus };

package/dist/utils/license-status.js

@@ -3,7 +3,7 @@ import {
   getLicenseStatus,
   getLicenseStatusMessage,
   printLicenseStatus
-} from "../chunk-TQLRG35T.js";
+} from "../chunk-AWOO63ME.js";
 export {
   getLicenseAnalytics,
   getLicenseStatus,

package/eventcatalog/astro.config.mjs

@@ -27,6 +27,8 @@ import expressiveCode from 'astro-expressive-code';
 // preprocessors and the rehype plugin below load those same package defaults.
 import expressiveCodeConfig from './ec.config.mjs';
 import ecstudioWatcher from './integrations/ecstudio-watcher.mjs';
+import storage from './integrations/storage.mjs';
+import studioServer from './integrations/studio-server.mjs';
 import eventCatalogIntegration from './src/features/integrations/eventcatalog-features.ts';
 import eventCatalogRuntime, { getDevServerFileSystem, packageDirectory } from './integrations/eventcatalog-runtime.mjs';
 import config from './src/utils/eventcatalog-config/source.ts';
@@ -139,6 +141,9 @@ export default defineConfig({
     catalogAssets({ projectDirectory, generatedDirectory: join(runtimeDirectory, 'public') }),
     effectiveOutput !== 'server' && compress && (await loadAstroCompressIntegration(projectDirectory)),
     ecstudioWatcher(),
+    // Before Studio: its database is opened and migrated first
+    storage(),
+    studioServer(),
     eventCatalogIntegration(),
     linkValidation(config.linkValidation),
   ].filter(Boolean),

package/eventcatalog/integrations/storage.mjs

@@ -0,0 +1,20 @@
+import { startStorage } from '../src/features/storage/database.ts';
+
+// The state EventCatalog keeps (`storage` in eventcatalog.config.js): as the dev server starts, its database is opened
+// and brought up to date (migrated), whether or not a feature that uses it is opened. `eventcatalog start` does the
+// same through /_eventcatalog/start.
+export default function storage() {
+  return {
+    name: 'eventcatalog-storage',
+    hooks: {
+      'astro:server:setup': async ({ logger }) => {
+        try {
+          const file = await startStorage();
+          if (file) logger.info(`Database ready (${file})`);
+        } catch (error) {
+          logger.error(`Could not open the database: ${error.message}`);
+        }
+      },
+    },
+  };
+}

package/eventcatalog/integrations/studio-server.mjs

@@ -0,0 +1,32 @@
+import { getStudioRuntime } from '../src/features/studio/server/runtime.ts';
+import { isDatabaseTooNew } from '../src/features/storage/migrations.ts';
+import config from '../src/utils/eventcatalog-config/source.ts';
+import { isCanvasEnabled } from '../src/utils/feature.ts';
+
+// Collaborative canvases: the collaboration WebSocket (Yjs over Hocuspocus), on the dev server's port.
+// The runtime is shared with server code (e.g. MCP tools) through globalThis.
+export default function studioServer() {
+  return {
+    name: 'eventcatalog-studio-server',
+    hooks: {
+      'astro:server:setup': async ({ server, logger }) => {
+        if (!isCanvasEnabled() || !server.httpServer) return;
+        const runtime = getStudioRuntime();
+        const projectDirectory = process.env.PROJECT_DIR || process.cwd();
+        // Canvases are loaded from storage before anyone can open one
+        try {
+          await runtime.useStorage(config.storage, projectDirectory);
+        } catch (error) {
+          // Not kept in memory instead (changes would quietly stop being saved): Studio's pages say why
+          if (isDatabaseTooNew(error)) return logger.error(`Studio isn't available: ${error.message}`);
+          logger.error(`Could not use the Studio storage configured, keeping canvases in memory: ${error.message}`);
+          await runtime.useStorage({ type: 'memory' }, projectDirectory);
+        }
+        runtime.attach(server.httpServer);
+        const { type, location } = runtime.storage;
+        const kept = type === 'memory' ? 'kept in memory until the server restarts' : `stored in ${location}`;
+        logger.info(`Collaboration server ready at /_eventcatalog/studio (canvases ${kept})`);
+      },
+    },
+  };
+}