syncorejs 0.2.2 → 0.2.3

package/dist/_vendor/core/cli.mjs

@@ -16,9 +16,10 @@ import WebSocket, { WebSocketServer } from "ws";
 import { SYNCORE_DEVTOOLS_MAX_SUPPORTED_PROTOCOL_VERSION, SYNCORE_DEVTOOLS_MIN_SUPPORTED_PROTOCOL_VERSION, SYNCORE_DEVTOOLS_PROTOCOL_VERSION, createPublicRuntimeId, createPublicTargetId } from "../devtools-protocol/index.js";
 //#region src/cli.ts
 function templateUsesConnectedClients(template) {
-	return template === "react-web" || template === "expo" || template === "next";
+	return template === "react-web" || template === "svelte" || template === "expo" || template === "next";
 }
-const COMBINED_DEV_COMMAND = "concurrently --kill-others-on-fail --names syncore,app --prefix-colors yellow,cyan \"bun run syncorejs:dev\" \"bun run dev:app\"";
+const loadedTypeScriptModules = /* @__PURE__ */ new Map();
+const COMBINED_DEV_COMMAND = "concurrently --kill-others-on-fail --names syncore,app --prefix-colors yellow,cyan \"npm run syncorejs:dev\" \"npm run dev:app\"";
 const program = new Command();
 const CORE_PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const DEVTOOLS_SESSION_FILE = path.join(".syncore", "devtools-session.json");
@@ -27,6 +28,7 @@ const VALID_SYNCORE_TEMPLATES = [
 	"minimal",
 	"node",
 	"react-web",
+	"svelte",
 	"expo",
 	"electron",
 	"next"
@@ -131,7 +133,7 @@ async function runCodegen(cwd) {
 	const componentsManifestPath = path.join(cwd, "syncore", "components.ts");
 	await mkdir(generatedDir, { recursive: true });
 	const functionImportExtension = await resolveFunctionImportExtension(cwd);
-	const hasComponentsManifest = await fileExists(componentsManifestPath);
+	const hasComponentsManifest = await hasNonEmptyComponentsManifest(componentsManifestPath);
 	const files = await listTypeScriptFiles(functionsDir);
 	const functionEntries = [];
 	for (const file of files) {
@@ -246,6 +248,24 @@ async function runCodegen(cwd) {
 		`export default resolvedComponents;`,
 		``
 	].join("\n");
+	const runtimeSource = [
+		`/**`,
+		` * Generated local runtime bundle for Syncore CLI and Node adapters.`,
+		` *`,
+		` * THIS CODE IS AUTOMATICALLY GENERATED.`,
+		` *`,
+		` * To regenerate, run \`npx syncorejs dev\` or \`npx syncorejs codegen\`.`,
+		` * @module`,
+		` */`,
+		``,
+		`import schema from "./schema${functionImportExtension}";`,
+		`import { functions } from "./functions${functionImportExtension}";`,
+		...hasComponentsManifest ? [`import { resolvedComponents } from "./components${functionImportExtension}";`] : [`const resolvedComponents = [] as const;`],
+		``,
+		`export { functions, schema };`,
+		`export const components = resolvedComponents;`,
+		``
+	].join("\n");
 	const serverSource = [
 		`/**`,
 		` * Generated utilities for implementing Syncore query, mutation, and action functions.`,
@@ -341,11 +361,18 @@ async function runCodegen(cwd) {
 		`};`,
 		``
 	].join("\n");
-	await writeFile(path.join(generatedDir, "api.ts"), apiSource);
-	await writeFile(path.join(generatedDir, "components.ts"), componentsSource);
-	await writeFile(path.join(generatedDir, "functions.ts"), functionsSource);
-	await writeFile(path.join(generatedDir, "schema.ts"), schemaSource);
-	await writeFile(path.join(generatedDir, "server.ts"), serverSource);
+	await writeGeneratedFile(path.join(generatedDir, "api.ts"), apiSource);
+	await writeGeneratedFile(path.join(generatedDir, "components.ts"), componentsSource);
+	await writeGeneratedFile(path.join(generatedDir, "functions.ts"), functionsSource);
+	await writeGeneratedFile(path.join(generatedDir, "runtime.ts"), runtimeSource);
+	await writeGeneratedFile(path.join(generatedDir, "schema.ts"), schemaSource);
+	await writeGeneratedFile(path.join(generatedDir, "server.ts"), serverSource);
+}
+async function writeGeneratedFile(filePath, source) {
+	try {
+		if (await readFile(filePath, "utf8") === source) return;
+	} catch {}
+	await writeFile(filePath, source);
 }
 async function scaffoldProject(cwd, options) {
 	const files = buildTemplateFiles(options.template);
@@ -423,16 +450,12 @@ export const create = mutation({
 
 import { createBrowserWorkerRuntime } from "syncorejs/browser";
 import schema from "../syncore/_generated/schema";
-import { resolvedComponents } from "../syncore/_generated/components";
 import { functions } from "../syncore/_generated/functions";
 
 void createBrowserWorkerRuntime({
   endpoint: self,
   schema,
-  functions,
-  components: resolvedComponents,
-  databaseName: "syncore-app",
-  persistenceMode: "opfs"
+  functions
 });
 `
 			}, {
@@ -455,15 +478,11 @@ export function AppSyncoreProvider({ children }: { children: ReactNode }) {
 				path: path.join("lib", "syncore.ts"),
 				content: `import { createExpoSyncoreBootstrap } from "syncorejs/expo";
 import schema from "../syncore/_generated/schema";
-import { resolvedComponents } from "../syncore/_generated/components";
 import { functions } from "../syncore/_generated/functions";
 
 export const syncore = createExpoSyncoreBootstrap({
   schema,
-  functions,
-  components: resolvedComponents,
-  databaseName: "syncore-app.db",
-  storageDirectoryName: "syncore-app-storage"
+  functions
 });
 `
 			});
@@ -475,18 +494,12 @@ export const syncore = createExpoSyncoreBootstrap({
 
 import { createBrowserWorkerRuntime } from "syncorejs/browser";
 import schema from "../syncore/_generated/schema";
-import { resolvedComponents } from "../syncore/_generated/components";
 import { functions } from "../syncore/_generated/functions";
 
 void createBrowserWorkerRuntime({
   endpoint: self,
   schema,
-  functions,
-  components: resolvedComponents,
-  databaseName: "syncore-app",
-  persistenceDatabaseName: "syncore-app",
-  locateFile: () => "/sql-wasm.wasm",
-  platform: "browser-worker"
+  functions
 });
 `
 			}, {
@@ -518,7 +531,6 @@ export function AppSyncoreProvider({ children }: { children: ReactNode }) {
 import { withNodeSyncoreClient } from "syncorejs/node";
 import { api } from "./syncore/_generated/api.ts";
 import schema from "./syncore/_generated/schema.ts";
-import { resolvedComponents } from "./syncore/_generated/components.ts";
 import { functions } from "./syncore/_generated/functions.ts";
 
 await withNodeSyncoreClient(
@@ -526,8 +538,7 @@ await withNodeSyncoreClient(
     databasePath: path.join(process.cwd(), ".syncore", "syncore.db"),
     storageDirectory: path.join(process.cwd(), ".syncore", "storage"),
     schema,
-    functions,
-    components: resolvedComponents
+    functions
   },
   async (client) => {
     await client.mutation(api.tasks.create, { text: "Run locally" });
@@ -544,7 +555,6 @@ await withNodeSyncoreClient(
 import { app } from "electron";
 import { createNodeSyncoreRuntime } from "syncorejs/node";
 import schema from "../syncore/_generated/schema.js";
-import { resolvedComponents } from "../syncore/_generated/components.js";
 import { functions } from "../syncore/_generated/functions.js";
 
 export function createAppSyncoreRuntime() {
@@ -554,10 +564,53 @@ export function createAppSyncoreRuntime() {
     storageDirectory: path.join(userDataDirectory, "storage"),
     schema,
     functions,
-    components: resolvedComponents,
     platform: "electron-main"
   });
 }
+`
+			});
+			break;
+		case "svelte":
+			files.push({
+				path: path.join("src", "syncore.worker.ts"),
+				content: `/// <reference lib="webworker" />
+
+import { createBrowserWorkerRuntime } from "syncorejs/browser";
+import schema from "../syncore/_generated/schema";
+import { functions } from "../syncore/_generated/functions";
+
+void createBrowserWorkerRuntime({
+  endpoint: self,
+  schema,
+  functions
+});
+`
+			}, {
+				path: path.join("src", "SyncoreProvider.svelte"),
+				content: `<script lang="ts">
+  import { onDestroy } from "svelte";
+  import type { Snippet } from "svelte";
+  import { createBrowserWorkerClient } from "syncorejs/browser";
+  import { setSyncoreClient } from "syncorejs/svelte";
+
+  interface Props {
+    children?: Snippet;
+  }
+
+  const { children }: Props = $props();
+
+  const managed = createBrowserWorkerClient({
+    workerUrl: new URL("./syncore.worker.ts", import.meta.url)
+  });
+
+  setSyncoreClient(managed.client);
+
+  onDestroy(() => {
+    void managed.dispose();
+  });
+<\/script>
+
+{@render children?.()}
 `
 			});
 			break;
@@ -606,7 +659,8 @@ async function detectProjectTemplate(cwd) {
 	if ("expo" in dependencies || "react-native" in dependencies) return "expo";
 	if ("electron" in dependencies) return "electron";
 	if ("next" in dependencies) return "next";
-	if ("vite" in dependencies || "@vitejs/plugin-react" in dependencies || await fileExists(path.join(cwd, "src", "main.tsx")) && "react" in dependencies) return "react-web";
+	if ("svelte" in dependencies || "@sveltejs/vite-plugin-svelte" in dependencies || "@sveltejs/kit" in dependencies || await fileExists(path.join(cwd, "src", "SyncoreProvider.svelte"))) return "svelte";
+	if ("vite" in dependencies || "@vitejs/plugin-react" in dependencies || await fileExists(path.join(cwd, "src", "syncore.worker.ts")) || await fileExists(path.join(cwd, "src", "syncore-provider.tsx")) || await fileExists(path.join(cwd, "src", "main.tsx")) && "react" in dependencies) return "react-web";
 	if (packageJson) return "node";
 	return "minimal";
 }
@@ -621,7 +675,16 @@ async function readPackageJson(cwd) {
 }
 async function ensurePackageScripts(cwd, template) {
 	const packageJsonPath = path.join(cwd, "package.json");
-	if (!await fileExists(packageJsonPath)) return;
+	if (!await fileExists(packageJsonPath)) {
+		await writeFile(packageJsonPath, `${JSON.stringify({
+			type: "module",
+			scripts: {
+				"syncorejs:dev": "syncorejs dev",
+				"syncorejs:codegen": "syncorejs codegen"
+			}
+		}, null, 2)}\n`);
+		return;
+	}
 	const packageJson = await readPackageJson(cwd);
 	if (!packageJson) return;
 	const nextPackageJson = {
@@ -654,7 +717,7 @@ function maybeAddManagedDevScripts(packageJson, template) {
 	scripts.dev = combinedDevCommand();
 }
 function supportsManagedCombinedDev(template) {
-	return template === "next" || template === "react-web" || template === "electron";
+	return template === "next" || template === "react-web" || template === "svelte" || template === "electron";
 }
 function combinedDevCommand() {
 	return COMBINED_DEV_COMMAND;
@@ -703,7 +766,7 @@ async function importJsonlIntoProject(cwd, tableName, sourcePath) {
 			try {
 				parsed = JSON.parse(line);
 			} catch (error) {
-				throw new Error(`Invalid JSON on line ${lineNumber} of ${sourcePath}: ${formatError(error)}`);
+				throw new Error(`Invalid JSON on line ${lineNumber} of ${sourcePath}: ${formatError(error)}`, { cause: error });
 			}
 			if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`Line ${lineNumber} of ${sourcePath} must contain a JSON object.`);
 			const payload = { ...parsed };
@@ -911,8 +974,7 @@ async function loadProjectSchema(cwd) {
 }
 async function loadDefaultExport(filePath) {
 	if (!await fileExists(filePath)) throw new Error(`Missing file: ${path.relative(process.cwd(), filePath)}`);
-	const moduleUrl = pathToFileURL(filePath).href;
-	const loaded = await tsImport(moduleUrl, { parentURL: import.meta.url });
+	const loaded = await loadTypeScriptModule(filePath);
 	if (!("default" in loaded)) throw new Error(`File ${path.relative(process.cwd(), filePath)} must have a default export.`);
 	const resolvedDefault = unwrapDefaultExport(loaded.default);
 	if (resolvedDefault === void 0) throw new Error(`File ${path.relative(process.cwd(), filePath)} exported undefined.`);
@@ -920,14 +982,30 @@ async function loadDefaultExport(filePath) {
 }
 async function loadNamedExport(filePath, exportName) {
 	if (!await fileExists(filePath)) throw new Error(`Missing file: ${path.relative(process.cwd(), filePath)}`);
-	const moduleUrl = pathToFileURL(filePath).href;
-	const loaded = await tsImport(moduleUrl, { parentURL: import.meta.url });
+	const loaded = await loadTypeScriptModule(filePath);
 	const defaultExport = loaded.default && typeof loaded.default === "object" && exportName in loaded.default ? loaded.default[exportName] : void 0;
 	if (!(exportName in loaded) && defaultExport === void 0) throw new Error(`File ${path.relative(process.cwd(), filePath)} must export ${exportName}.`);
 	const resolvedValue = unwrapDefaultExport(loaded[exportName] ?? defaultExport);
 	if (resolvedValue === void 0) throw new Error(`File ${path.relative(process.cwd(), filePath)} exported undefined for ${exportName}.`);
 	return resolvedValue;
 }
+async function hasNonEmptyComponentsManifest(filePath) {
+	if (!await fileExists(filePath)) return false;
+	const source = await readFile(filePath, "utf8");
+	return !/defineComponents\s*\(\s*\{\s*\}\s*\)/.test(source);
+}
+async function loadTypeScriptModule(filePath) {
+	const fileStat = await stat(filePath);
+	const cached = loadedTypeScriptModules.get(filePath);
+	if (cached && cached.mtimeMs === fileStat.mtimeMs) return await cached.loaded;
+	const moduleUrl = pathToFileURL(filePath).href;
+	const loaded = tsImport(moduleUrl, { parentURL: import.meta.url });
+	loadedTypeScriptModules.set(filePath, {
+		mtimeMs: fileStat.mtimeMs,
+		loaded
+	});
+	return await loaded;
+}
 async function loadProjectFunctions(cwd) {
 	const filePath = path.join(cwd, "syncore", "_generated", "functions.ts");
 	if (!await fileExists(filePath)) await runCodegen(cwd);
@@ -936,17 +1014,62 @@ async function loadProjectFunctions(cwd) {
 	return functions;
 }
 async function loadProjectResolvedComponents(cwd) {
+	const componentsManifestPath = path.join(cwd, "syncore", "components.ts");
+	if (await fileExists(componentsManifestPath)) {
+		const source = await readFile(componentsManifestPath, "utf8");
+		if (/defineComponents\s*\(\s*\{\s*\}\s*\)/.test(source)) return [];
+	}
 	const filePath = path.join(cwd, "syncore", "_generated", "components.ts");
 	if (!await fileExists(filePath)) await runCodegen(cwd);
 	const components = await loadNamedExport(filePath, "resolvedComponents");
 	if (!Array.isArray(components)) throw new Error("syncore/_generated/components.ts must export resolvedComponents.");
 	return components;
 }
+async function loadProjectRuntime(cwd) {
+	const filePath = path.join(cwd, "syncore", "_generated", "runtime.ts");
+	if (!await fileExists(filePath)) await runCodegen(cwd);
+	const loaded = await loadTypeScriptModule(filePath);
+	const schema = unwrapDefaultExport(loaded.schema);
+	const functions = unwrapDefaultExport(loaded.functions);
+	const components = unwrapDefaultExport(loaded.components);
+	if (!schema || typeof schema !== "object" || typeof schema.tableNames !== "function") throw new Error("syncore/_generated/runtime.ts must export a composed Syncore schema.");
+	if (!functions || typeof functions !== "object") throw new Error("syncore/_generated/runtime.ts must export a functions registry.");
+	if (!Array.isArray(components)) throw new Error("syncore/_generated/runtime.ts must export resolved components.");
+	return {
+		schema,
+		functions,
+		components
+	};
+}
+var HubExternalChangeSignal = class {
+	publishToHub;
+	listeners = /* @__PURE__ */ new Set();
+	constructor(publishToHub) {
+		this.publishToHub = publishToHub;
+	}
+	subscribe(listener) {
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	publish(event) {
+		return this.publishToHub(event);
+	}
+	receive(event) {
+		for (const listener of this.listeners) listener(event);
+	}
+	close() {
+		this.listeners.clear();
+	}
+};
 var HubSqliteDriver = class {
+	databasePath;
 	database;
 	transactionDepth = 0;
-	constructor(filename) {
-		this.database = new DatabaseSync(filename);
+	constructor(databasePath) {
+		this.databasePath = databasePath;
+		this.database = new DatabaseSync(databasePath);
 		this.database.exec("PRAGMA foreign_keys = ON;");
 		this.database.exec("PRAGMA journal_mode = WAL;");
 	}
@@ -999,6 +1122,7 @@ var HubSqliteDriver = class {
 	}
 };
 var HubFileStorageAdapter = class {
+	directory;
 	constructor(directory) {
 		this.directory = directory;
 	}
@@ -1112,14 +1236,10 @@ const hubDevtoolsSqlSupport = {
 		}
 	}
 };
-async function createProjectTargetBackend(cwd) {
+async function createProjectTargetBackend(cwd, externalChangeSignal) {
 	const projectTarget = resolveProjectTargetConfig(await loadProjectConfig(cwd));
 	if (!projectTarget) return null;
-	const [schema, functions, components] = await Promise.all([
-		loadProjectSchema(cwd),
-		loadProjectFunctions(cwd),
-		loadProjectResolvedComponents(cwd)
-	]);
+	const { schema, functions, components } = await loadProjectRuntime(cwd);
 	const databasePath = path.resolve(cwd, projectTarget.databasePath);
 	const storageDirectory = path.resolve(cwd, projectTarget.storageDirectory);
 	await mkdir(path.dirname(databasePath), { recursive: true });
@@ -1131,9 +1251,10 @@ async function createProjectTargetBackend(cwd) {
 		components,
 		driver,
 		storage: new HubFileStorageAdapter(storageDirectory),
-		platform: "project"
+		platform: "project",
+		...externalChangeSignal ? { externalChangeSignal } : {}
 	});
-	await runtime.prepareForDirectAccess();
+	await runtime.start();
 	const commandHandler = createDevtoolsCommandHandler({
 		driver,
 		schema,
@@ -1158,9 +1279,11 @@ async function createProjectTargetBackend(cwd) {
 			platform: "project",
 			sessionLabel: "Project Target",
 			targetKind: "project",
+			runtimeRole: "project-target",
 			storageProtocol: "file",
 			databaseLabel: path.basename(databasePath),
-			storageIdentity: `file::${databasePath}`
+			storageIdentity: `file::${databasePath}`,
+			capabilities: createProjectDevtoolsCapabilities()
 		},
 		handleCommand: commandHandler,
 		subscribe(subscriptionId, payload, listener) {
@@ -1175,6 +1298,24 @@ async function createProjectTargetBackend(cwd) {
 		}
 	};
 }
+function createProjectDevtoolsCapabilities() {
+	return {
+		sql: {
+			read: true,
+			write: true,
+			live: true
+		},
+		data: {
+			browse: true,
+			mutate: true,
+			importExport: true
+		},
+		scheduler: {
+			read: true,
+			edit: true
+		}
+	};
+}
 function normalizeStorageInput(input) {
 	if (typeof input === "string") return Buffer.from(input);
 	if (input instanceof Uint8Array) return input;
@@ -1297,16 +1438,24 @@ function formatError(error) {
 }
 async function isLocalPortInUse(port) {
 	return await new Promise((resolve) => {
+		let settled = false;
 		const socket = connect({
 			host: "127.0.0.1",
 			port
 		});
+		const finish = (inUse) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timeout);
+			socket.destroy();
+			resolve(inUse);
+		};
+		const timeout = setTimeout(() => finish(false), 100);
 		socket.once("connect", () => {
-			socket.end();
-			resolve(true);
+			finish(true);
 		});
 		socket.once("error", () => {
-			resolve(false);
+			finish(false);
 		});
 	});
 }
@@ -1348,12 +1497,6 @@ async function startDevHub(options) {
 		return await readDevtoolsSessionState(options.cwd) ?? sessionState;
 	}
 	await writeDevtoolsSessionState(options.cwd, sessionState);
-	let projectTargetBackend = null;
-	try {
-		projectTargetBackend = await createProjectTargetBackend(options.cwd);
-	} catch (error) {
-		console.warn(`Project target fallback unavailable: ${formatError(error)}`);
-	}
 	const httpServer = createServer((_request, response) => {
 		response.writeHead(200, { "content-type": "application/json" });
 		response.end(JSON.stringify({
@@ -1368,6 +1511,14 @@ async function startDevHub(options) {
 	const socketRuntimeIds = /* @__PURE__ */ new Map();
 	const dashboardSockets = /* @__PURE__ */ new Set();
 	const dashboardSubscriptions = /* @__PURE__ */ new Map();
+	let relayExternalChange = () => {};
+	const projectTargetExternalChangeSignal = new HubExternalChangeSignal((event) => relayExternalChange(PROJECT_TARGET_RUNTIME_ID, runtimeHellos.get(PROJECT_TARGET_RUNTIME_ID)?.storageIdentity ?? "", event));
+	let projectTargetBackend = null;
+	try {
+		projectTargetBackend = await createProjectTargetBackend(options.cwd, projectTargetExternalChangeSignal);
+	} catch (error) {
+		console.warn(`Project target fallback unavailable: ${formatError(error)}`);
+	}
 	const hello = {
 		type: "hello",
 		protocolVersion: SYNCORE_DEVTOOLS_PROTOCOL_VERSION,
@@ -1380,12 +1531,30 @@ async function startDevHub(options) {
 		runtimeHellos.set(PROJECT_TARGET_RUNTIME_ID, projectTargetBackend.hello);
 		runtimeEvents.set(PROJECT_TARGET_RUNTIME_ID, []);
 	}
+	relayExternalChange = (sourceRuntimeId, storageIdentity, event) => {
+		if (!storageIdentity) return;
+		const message = {
+			type: "external.change",
+			runtimeId: sourceRuntimeId,
+			storageIdentity,
+			event
+		};
+		for (const [runtimeId, runtimeHello] of runtimeHellos) {
+			if (runtimeId === sourceRuntimeId || runtimeHello.storageIdentity !== storageIdentity) continue;
+			if (runtimeId === PROJECT_TARGET_RUNTIME_ID) {
+				projectTargetExternalChangeSignal.receive(event);
+				continue;
+			}
+			const targetSocket = runtimeSockets.get(runtimeId);
+			if (targetSocket?.readyState === WebSocket.OPEN) targetSocket.send(JSON.stringify(message));
+		}
+	};
 	const appendHubLog = async (event) => {
 		const runtimeHello = runtimeHellos.get(event.runtimeId);
-		const clientRuntimeIds = [...runtimeHellos.values()].filter((hello) => hello.runtimeId !== "syncore-dev-hub" && hello.targetKind !== "project").map((hello) => hello.runtimeId).sort();
-		const clientTargetKeys = [...runtimeHellos.values()].filter((hello) => hello.runtimeId !== "syncore-dev-hub" && hello.targetKind !== "project").map((hello) => hello.storageIdentity ?? `runtime::${hello.runtimeId}`).sort();
+		const clientRuntimeIds = [...runtimeHellos.values()].filter((hello) => hello.runtimeId !== "syncore-dev-hub").map((hello) => hello.runtimeId).sort();
+		const clientTargetKeys = [...runtimeHellos.values()].filter((hello) => hello.runtimeId !== "syncore-dev-hub").map((hello) => hello.storageIdentity ?? `runtime::${hello.runtimeId}`).sort();
 		const targetIdentity = runtimeHello?.storageIdentity ?? `runtime::${event.runtimeId}`;
-		const targetId = event.runtimeId === "syncore-dev-hub" ? "all" : runtimeHello?.targetKind === "project" ? "project" : createPublicTargetId(targetIdentity, clientTargetKeys);
+		const targetId = event.runtimeId === "syncore-dev-hub" ? "all" : createPublicTargetId(targetIdentity, clientTargetKeys);
 		const publicRuntimeId = event.runtimeId === "syncore-dev-hub" ? void 0 : createPublicRuntimeId(event.runtimeId, clientRuntimeIds);
 		const category = event.type === "query.executed" ? "query" : event.type === "mutation.committed" ? "mutation" : event.type === "action.completed" ? "action" : "system";
 		const message = event.type === "log" ? event.message : event.type === "query.executed" || event.type === "mutation.committed" || event.type === "action.completed" ? event.functionName : event.type;
@@ -1438,6 +1607,11 @@ async function startDevHub(options) {
 				socket.send(JSON.stringify({ type: "pong" }));
 				return;
 			}
+			if (message.type === "external.change") {
+				const storageIdentity = runtimeHellos.get(message.runtimeId)?.storageIdentity ?? message.storageIdentity;
+				if (storageIdentity && storageIdentity === message.storageIdentity) relayExternalChange(message.runtimeId, storageIdentity, message.event);
+				return;
+			}
 			if (message.type === "command") {
 				if (!isAuthorizedDashboardClient) return;
 				const targetRuntimeId = message.targetRuntimeId;
@@ -1539,8 +1713,8 @@ async function startDevHub(options) {
 			if (message.type === "event" && message.event.type === "runtime.disconnected") runtimeHellos.delete(message.event.runtimeId);
 			if (message.type === "event" && message.event.runtimeId !== "syncore-dev-hub") {
 				const history = runtimeEvents.get(message.event.runtimeId) ?? [];
-				history.unshift(message.event);
-				runtimeEvents.set(message.event.runtimeId, history.slice(0, 200));
+				history.push(message.event);
+				runtimeEvents.set(message.event.runtimeId, history.slice(-200));
 				if (message.event.type === "runtime.disconnected") runtimeEvents.delete(message.event.runtimeId);
 				appendHubLog(message.event);
 			} else if (message.type === "event") appendHubLog(message.event);
@@ -1795,6 +1969,6 @@ function toSearchValue(value) {
 	return stableStringify(value);
 }
 //#endregion
-export { SYNCORE_MIGRATION_SNAPSHOT_FILE_NAME, VALID_SYNCORE_TEMPLATES, applyProjectMigrations, detectProjectTemplate, fileExists, formatError, getNextMigrationNumber, hasSyncoreProject, importJsonlIntoProject, isLocalPortInUse, loadProjectComponentsManifest, loadProjectConfig, loadProjectFunctions, loadProjectResolvedComponents, loadProjectRootSchema, loadProjectSchema, logScaffoldResult, readPackageJson, readStoredSnapshot, resolveDefaultSeedFile, resolvePortFromEnv, resolveProjectTargetConfig, resolveRequestedTemplate, runCodegen, runDevProjectBootstrap, runSyncoreCli, scaffoldProject, slugify, startDevHub, templateUsesConnectedClients, writeStoredSnapshot };
+export { SYNCORE_MIGRATION_SNAPSHOT_FILE_NAME, VALID_SYNCORE_TEMPLATES, applyProjectMigrations, detectProjectTemplate, fileExists, formatError, getNextMigrationNumber, hasSyncoreProject, importJsonlIntoProject, isLocalPortInUse, loadProjectComponentsManifest, loadProjectConfig, loadProjectFunctions, loadProjectResolvedComponents, loadProjectRootSchema, loadProjectRuntime, loadProjectSchema, logScaffoldResult, readPackageJson, readStoredSnapshot, resolveDefaultSeedFile, resolvePortFromEnv, resolveProjectTargetConfig, resolveRequestedTemplate, runCodegen, runDevProjectBootstrap, runSyncoreCli, scaffoldProject, slugify, startDevHub, templateUsesConnectedClients, writeStoredSnapshot };
 
 //# sourceMappingURL=cli.mjs.map