@holo-js/cli 0.1.8 → 0.2.0

package/dist/{chunk-SABHUOON.mjs → chunk-KWRIBHC3.mjs}

@@ -1,7 +1,7 @@
 import {
   loadProjectConfig,
   resolveGeneratedSchemaPath
-} from "./chunk-DFKX4YT4.mjs";
+} from "./chunk-ONKESAQA.mjs";
 import {
   loadGeneratedProjectRegistry,
   relativeImportPath,
@@ -11,11 +11,16 @@ import {
   renderFrameworkRunner,
   renderGeneratedModelTypes,
   renderNextBroadcastAuthRoute,
+  renderNextBroadcastConfigRoute,
   renderNextGeneratedBroadcastAuthRoute,
+  renderNextGeneratedBroadcastConfigRoute,
+  renderNextGeneratedRealtimeDefinitions,
   renderNextHoloHelper,
   renderNextManagedHostedAuthRouteFiles,
-  renderSvelteHoloHelper
-} from "./chunk-O6AXHL7Z.mjs";
+  renderNextRuntimeBootstrap,
+  renderSvelteHoloHelper,
+  renderSvelteViteConfig
+} from "./chunk-2DKQKZML.mjs";
 import {
   AUTH_CONFIG_FILE_NAMES,
   AUTH_SOCIAL_PROVIDER_PACKAGE_NAMES,
@@ -40,11 +45,11 @@ import {
   resolveFirstExistingPath,
   sanitizePackageName,
   writeTextFile
-} from "./chunk-R6BWRY3E.mjs";
+} from "./chunk-ILU426CF.mjs";
 
 // src/project/scaffold.ts
 import { mkdir as mkdir3, readdir as readdir2 } from "fs/promises";
-import { dirname as dirname2, extname as extname2, resolve as resolve4 } from "path";
+import { dirname as dirname2, extname as extname2, relative, resolve as resolve4, sep } from "path";
 import { loadConfigDirectory as loadConfigDirectory2 } from "@holo-js/config";
 
 // src/project/scaffold/config-renderers.ts
@@ -59,7 +64,7 @@ import { loadConfigDirectory } from "@holo-js/config";
 // package.json
 var package_default = {
   name: "@holo-js/cli",
-  version: "0.1.8",
+  version: "0.2.0",
   description: "Holo-JS Framework - project creation, discovery, and operational CLI",
   type: "module",
   license: "MIT",
@@ -86,6 +91,8 @@ var package_default = {
     "test:integration": "HOLO_CLI_INCLUDE_INTEGRATION=1 vitest --run tests/cli.test.ts"
   },
   dependencies: {
+    "@clack/prompts": "catalog:",
+    "@holo-js/cache-db": "catalog:",
     "@holo-js/config": "catalog:",
     "@holo-js/core": "catalog:",
     "@holo-js/db": "catalog:",
@@ -109,49 +116,51 @@ var package_default = {
 // src/generated/workspaceCatalog.ts
 var WORKSPACE_CATALOG = Object.freeze({
   "@clerk/backend": "^3.4.7",
+  "@clack/prompts": "^1.5.1",
   "@eslint/js": "^9.17.0",
-  "@holo-js/adapter-next": "^0.1.8",
-  "@holo-js/adapter-nuxt": "^0.1.8",
-  "@holo-js/adapter-sveltekit": "^0.1.8",
-  "@holo-js/auth": "^0.1.8",
-  "@holo-js/auth-clerk": "^0.1.8",
-  "@holo-js/auth-social": "^0.1.8",
-  "@holo-js/auth-social-apple": "^0.1.8",
-  "@holo-js/auth-social-discord": "^0.1.8",
-  "@holo-js/auth-social-facebook": "^0.1.8",
-  "@holo-js/auth-social-github": "^0.1.8",
-  "@holo-js/auth-social-google": "^0.1.8",
-  "@holo-js/auth-social-linkedin": "^0.1.8",
-  "@holo-js/auth-workos": "^0.1.8",
-  "@holo-js/authorization": "^0.1.8",
-  "@holo-js/broadcast": "^0.1.8",
-  "@holo-js/cache": "^0.1.8",
-  "@holo-js/cache-db": "^0.1.8",
-  "@holo-js/cache-redis": "^0.1.8",
-  "@holo-js/cli": "^0.1.8",
-  "@holo-js/config": "^0.1.8",
-  "@holo-js/core": "^0.1.8",
-  "@holo-js/db": "^0.1.8",
-  "@holo-js/db-mysql": "^0.1.8",
-  "@holo-js/db-postgres": "^0.1.8",
-  "@holo-js/db-sqlite": "^0.1.8",
-  "@holo-js/events": "^0.1.8",
-  "@holo-js/flux": "^0.1.8",
-  "@holo-js/flux-react": "^0.1.8",
-  "@holo-js/flux-svelte": "^0.1.8",
-  "@holo-js/flux-vue": "^0.1.8",
-  "@holo-js/forms": "^0.1.8",
-  "@holo-js/mail": "^0.1.8",
-  "@holo-js/media": "^0.1.8",
-  "@holo-js/notifications": "^0.1.8",
-  "@holo-js/queue": "^0.1.8",
-  "@holo-js/queue-db": "^0.1.8",
-  "@holo-js/queue-redis": "^0.1.8",
-  "@holo-js/security": "^0.1.8",
-  "@holo-js/session": "^0.1.8",
-  "@holo-js/storage": "^0.1.8",
-  "@holo-js/storage-s3": "^0.1.8",
-  "@holo-js/validation": "^0.1.8",
+  "@holo-js/adapter-next": "^0.2.0",
+  "@holo-js/adapter-nuxt": "^0.2.0",
+  "@holo-js/adapter-sveltekit": "^0.2.0",
+  "@holo-js/auth": "^0.2.0",
+  "@holo-js/auth-clerk": "^0.2.0",
+  "@holo-js/auth-social": "^0.2.0",
+  "@holo-js/auth-social-apple": "^0.2.0",
+  "@holo-js/auth-social-discord": "^0.2.0",
+  "@holo-js/auth-social-facebook": "^0.2.0",
+  "@holo-js/auth-social-github": "^0.2.0",
+  "@holo-js/auth-social-google": "^0.2.0",
+  "@holo-js/auth-social-linkedin": "^0.2.0",
+  "@holo-js/auth-workos": "^0.2.0",
+  "@holo-js/authorization": "^0.2.0",
+  "@holo-js/broadcast": "^0.2.0",
+  "@holo-js/cache": "^0.2.0",
+  "@holo-js/cache-db": "^0.2.0",
+  "@holo-js/cache-redis": "^0.2.0",
+  "@holo-js/cli": "^0.2.0",
+  "@holo-js/config": "^0.2.0",
+  "@holo-js/core": "^0.2.0",
+  "@holo-js/db": "^0.2.0",
+  "@holo-js/db-mysql": "^0.2.0",
+  "@holo-js/db-postgres": "^0.2.0",
+  "@holo-js/db-sqlite": "^0.2.0",
+  "@holo-js/events": "^0.2.0",
+  "@holo-js/flux": "^0.2.0",
+  "@holo-js/flux-react": "^0.2.0",
+  "@holo-js/flux-svelte": "^0.2.0",
+  "@holo-js/flux-vue": "^0.2.0",
+  "@holo-js/forms": "^0.2.0",
+  "@holo-js/mail": "^0.2.0",
+  "@holo-js/media": "^0.2.0",
+  "@holo-js/notifications": "^0.2.0",
+  "@holo-js/queue": "^0.2.0",
+  "@holo-js/queue-db": "^0.2.0",
+  "@holo-js/queue-redis": "^0.2.0",
+  "@holo-js/realtime": "^0.2.0",
+  "@holo-js/security": "^0.2.0",
+  "@holo-js/session": "^0.2.0",
+  "@holo-js/storage": "^0.2.0",
+  "@holo-js/storage-s3": "^0.2.0",
+  "@holo-js/validation": "^0.2.0",
   "@nuxt/kit": "^4.4.4",
   "@nuxt/module-builder": "^1.0.2",
   "@sveltejs/adapter-node": "^5.5.4",
@@ -168,7 +177,7 @@ var WORKSPACE_CATALOG = Object.freeze({
   "@vitest/coverage-v8": "^4.1.5",
   "better-sqlite3": "^11.7.0",
   "bullmq": "^5.71.0",
-  "create-holo-js": "^0.1.8",
+  "create-holo-js": "^0.2.0",
   "esbuild": "^0.27.4",
   "eslint": "^9.17.0",
   "fast-check": "^4.5.3",
@@ -181,6 +190,7 @@ var WORKSPACE_CATALOG = Object.freeze({
   "nodemailer": "^6.10.1",
   "nuxt": "^4.4.4",
   "pg": "^8.13.0",
+  "playwright": "^1.57.0",
   "react": "^19.2.6",
   "react-dom": "^19.2.6",
   "react-test-renderer": "^19.2.6",
@@ -386,6 +396,9 @@ async function projectHasEventsScaffold(projectRoot) {
   const listenersRoot = resolve(projectRoot, project.config.paths.listeners);
   return await pathExists(eventsRoot) || await pathExists(listenersRoot);
 }
+async function projectHasRealtimeScaffold(projectRoot) {
+  return await pathExists(resolve(projectRoot, "server/realtime"));
+}
 async function syncManagedDriverDependencies(projectRoot, registry) {
   const loaded = await loadConfigDirectory(projectRoot, {
     preferCache: false,
@@ -405,6 +418,7 @@ async function syncManagedDriverDependencies(projectRoot, registry) {
   const requiredPackages = /* @__PURE__ */ new Set();
   const hasAuthorizationScaffold = await projectHasAuthorizationScaffold(projectRoot);
   const hasEventsScaffold = await projectHasEventsScaffold(projectRoot);
+  const hasRealtimeScaffold = await projectHasRealtimeScaffold(projectRoot);
   const {
     packageJsonPath,
     parsed,
@@ -468,8 +482,23 @@ async function syncManagedDriverDependencies(projectRoot, registry) {
   if (notificationsConfigured) {
     requiredPackages.add("@holo-js/notifications");
   }
-  if (broadcastConfigured || registryHasBroadcastDefinitions(discoveredRegistry)) {
+  if (broadcastConfigured || registryHasBroadcastDefinitions(discoveredRegistry) || hasRealtimeScaffold) {
     requiredPackages.add("@holo-js/broadcast");
+    requiredPackages.add("@holo-js/flux");
+    const framework = detectProjectFrameworkFromPackageJson(dependencies, devDependencies);
+    if (framework === "next") {
+      requiredPackages.add("@holo-js/flux-react");
+      requiredPackages.add("@holo-js/adapter-next");
+    } else if (framework === "nuxt") {
+      requiredPackages.add("@holo-js/flux-vue");
+      requiredPackages.add("@holo-js/adapter-nuxt");
+    } else if (framework === "sveltekit") {
+      requiredPackages.add("@holo-js/flux-svelte");
+      requiredPackages.add("@holo-js/adapter-sveltekit");
+    }
+  }
+  if (hasRealtimeScaffold) {
+    requiredPackages.add("@holo-js/realtime");
   }
   if (registryHasAuthorizationDefinitions(discoveredRegistry) || hasAuthorizationScaffold) {
     requiredPackages.add("@holo-js/authorization");
@@ -512,12 +541,17 @@ async function syncManagedDriverDependencies(projectRoot, registry) {
     "@holo-js/cache-db",
     "@holo-js/cache-redis",
     "@holo-js/events",
+    "@holo-js/flux",
+    "@holo-js/flux-react",
+    "@holo-js/flux-svelte",
+    "@holo-js/flux-vue",
     "@holo-js/mail",
     "@holo-js/media",
     "@holo-js/notifications",
     "@holo-js/queue",
     "@holo-js/queue-db",
     "@holo-js/queue-redis",
+    "@holo-js/realtime",
     "@holo-js/security",
     "@holo-js/session",
     "@holo-js/storage",
@@ -615,57 +649,30 @@ async function upsertEventsPackageDependency(projectRoot) {
   await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
   return true;
 }
-async function upsertNotificationsPackageDependency(projectRoot) {
+async function upsertManagedPackageDependency(projectRoot, packageName) {
   const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
-  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/notifications", dependencies, devDependencies);
-  const currentVersion = dependencies["@holo-js/notifications"];
-  const currentDevVersion = devDependencies["@holo-js/notifications"];
+  const nextVersion = resolveManagedHoloPackageVersion(packageName, dependencies, devDependencies);
+  const currentVersion = dependencies[packageName];
+  const currentDevVersion = devDependencies[packageName];
   if (currentVersion === nextVersion && typeof currentDevVersion === "undefined") {
     return false;
   }
-  dependencies["@holo-js/notifications"] = nextVersion;
-  delete devDependencies["@holo-js/notifications"];
+  dependencies[packageName] = nextVersion;
+  delete devDependencies[packageName];
   await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
   return true;
 }
+async function upsertNotificationsPackageDependency(projectRoot) {
+  return await upsertManagedPackageDependency(projectRoot, "@holo-js/notifications");
+}
 async function upsertMailPackageDependency(projectRoot) {
-  const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
-  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/mail", dependencies, devDependencies);
-  const currentVersion = dependencies["@holo-js/mail"];
-  const currentDevVersion = devDependencies["@holo-js/mail"];
-  if (currentVersion === nextVersion && typeof currentDevVersion === "undefined") {
-    return false;
-  }
-  dependencies["@holo-js/mail"] = nextVersion;
-  delete devDependencies["@holo-js/mail"];
-  await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
-  return true;
+  return await upsertManagedPackageDependency(projectRoot, "@holo-js/mail");
 }
 async function upsertMediaPackageDependency(projectRoot) {
-  const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
-  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/media", dependencies, devDependencies);
-  const currentVersion = dependencies["@holo-js/media"];
-  const currentDevVersion = devDependencies["@holo-js/media"];
-  if (currentVersion === nextVersion && typeof currentDevVersion === "undefined") {
-    return false;
-  }
-  dependencies["@holo-js/media"] = nextVersion;
-  delete devDependencies["@holo-js/media"];
-  await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
-  return true;
+  return await upsertManagedPackageDependency(projectRoot, "@holo-js/media");
 }
 async function upsertSecurityPackageDependency(projectRoot) {
-  const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
-  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/security", dependencies, devDependencies);
-  const currentVersion = dependencies["@holo-js/security"];
-  const currentDevVersion = devDependencies["@holo-js/security"];
-  if (currentVersion === nextVersion && typeof currentDevVersion === "undefined") {
-    return false;
-  }
-  dependencies["@holo-js/security"] = nextVersion;
-  delete devDependencies["@holo-js/security"];
-  await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
-  return true;
+  return await upsertManagedPackageDependency(projectRoot, "@holo-js/security");
 }
 async function upsertCachePackageDependencies(projectRoot, driver = "file") {
   const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
@@ -838,15 +845,19 @@ async function upsertAuthPackageDependencies(projectRoot, features = {}) {
   return true;
 }
 async function upsertAuthorizationPackageDependency(projectRoot) {
+  return await upsertManagedPackageDependency(projectRoot, "@holo-js/authorization");
+}
+async function upsertRealtimePackageDependency(projectRoot) {
+  const broadcastResult = await upsertBroadcastPackageDependencies(projectRoot);
   const { packageJsonPath, parsed, dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
-  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/authorization", dependencies, devDependencies);
-  const currentVersion = dependencies["@holo-js/authorization"];
-  const currentDevVersion = devDependencies["@holo-js/authorization"];
+  const nextVersion = resolveManagedHoloPackageVersion("@holo-js/realtime", dependencies, devDependencies);
+  const currentVersion = dependencies["@holo-js/realtime"];
+  const currentDevVersion = devDependencies["@holo-js/realtime"];
   if (currentVersion === nextVersion && typeof currentDevVersion === "undefined") {
-    return false;
+    return broadcastResult.updated;
   }
-  dependencies["@holo-js/authorization"] = nextVersion;
-  delete devDependencies["@holo-js/authorization"];
+  dependencies["@holo-js/realtime"] = nextVersion;
+  delete devDependencies["@holo-js/realtime"];
   await writePackageJsonDependencyState(packageJsonPath, parsed, dependencies, devDependencies);
   return true;
 }
@@ -1296,40 +1307,6 @@ function renderBroadcastEnvFiles() {
     example
   };
 }
-function renderNuxtBroadcastAuthRoute() {
-  return [
-    "import { defineEventHandler, getHeaders, getRequestURL, readRawBody } from 'h3'",
-    "import { renderBroadcastAuthResponse } from '@holo-js/broadcast/auth'",
-    "import { holo } from '#imports'",
-    "",
-    "export default defineEventHandler(async (event) => {",
-    "  const app = await holo.getApp()",
-    "  const auth = await holo.getAuth()",
-    "  const headers = new Headers()",
-    "  for (const [key, value] of Object.entries(getHeaders(event))) {",
-    "    if (typeof value === 'string') {",
-    "      headers.set(key, value)",
-    "    }",
-    "  }",
-    "  const request = new Request(getRequestURL(event), {",
-    "    method: event.method,",
-    "    headers,",
-    "    body: await readRawBody(event),",
-    "  })",
-    "",
-    "  return await renderBroadcastAuthResponse(request, {",
-    "    resolveUser: async () => await auth?.user(),",
-    "    channelAuth: {",
-    "      registry: {",
-    "        projectRoot: app.projectRoot,",
-    "        channels: app.registry?.channels ?? [],",
-    "      },",
-    "    },",
-    "  })",
-    "})",
-    ""
-  ].join("\n");
-}
 async function syncBroadcastAuthSupportAfterAuthInstall(projectRoot) {
   const { dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
   const framework = detectProjectFrameworkFromPackageJson(dependencies, devDependencies);
@@ -1376,17 +1353,6 @@ async function syncBroadcastAuthSupportAfterAuthInstall(projectRoot) {
       createdBroadcastAuthRoute
     };
   }
-  if (framework === "nuxt") {
-    const authRoutePath = resolve2(projectRoot, "server/routes/broadcasting/auth.post.ts");
-    if (!await pathExists(authRoutePath)) {
-      await writeTextFile(authRoutePath, renderNuxtBroadcastAuthRoute());
-      createdBroadcastAuthRoute = true;
-    }
-    return {
-      updatedBroadcastConfig,
-      createdBroadcastAuthRoute
-    };
-  }
   if (framework === "sveltekit") {
     const holoHelperPath = resolve2(projectRoot, ".holo-js/generated/sveltekit/holo.ts");
     await writeTextFile(holoHelperPath, renderSvelteHoloHelper());
@@ -2422,7 +2388,7 @@ function renderScaffoldPackageJson(options) {
   if (optionalPackages.includes("mail")) {
     dependencies["@holo-js/mail"] = `^${HOLO_PACKAGE_VERSION}`;
   }
-  if (optionalPackages.includes("broadcast")) {
+  if (optionalPackages.includes("broadcast") || optionalPackages.includes("realtime")) {
     dependencies["@holo-js/broadcast"] = `^${HOLO_PACKAGE_VERSION}`;
     dependencies["@holo-js/flux"] = `^${HOLO_PACKAGE_VERSION}`;
     if (options.framework === "next") {
@@ -2433,6 +2399,9 @@ function renderScaffoldPackageJson(options) {
       dependencies["@holo-js/flux-svelte"] = `^${HOLO_PACKAGE_VERSION}`;
     }
   }
+  if (optionalPackages.includes("realtime")) {
+    dependencies["@holo-js/realtime"] = `^${HOLO_PACKAGE_VERSION}`;
+  }
   if (optionalPackages.includes("security")) {
     dependencies["@holo-js/security"] = `^${HOLO_PACKAGE_VERSION}`;
   }
@@ -2493,6 +2462,7 @@ async function scaffoldProject(projectRoot, options) {
   const notificationsEnabled = optionalPackages.includes("notifications");
   const mailEnabled = optionalPackages.includes("mail");
   const broadcastEnabled = optionalPackages.includes("broadcast");
+  const realtimeEnabled = optionalPackages.includes("realtime");
   const securityEnabled = optionalPackages.includes("security");
   const cacheEnabled = optionalPackages.includes("cache");
   const broadcastEnvFiles = broadcastEnabled ? renderBroadcastEnvFiles() : void 0;
@@ -2521,6 +2491,9 @@ async function scaffoldProject(projectRoot, options) {
     await mkdir2(resolve3(projectRoot, "server/broadcast"), { recursive: true });
     await mkdir2(resolve3(projectRoot, "server/channels"), { recursive: true });
   }
+  if (realtimeEnabled) {
+    await mkdir2(resolve3(projectRoot, "server/realtime"), { recursive: true });
+  }
   await mkdir2(resolve3(projectRoot, "server/db/factories"), { recursive: true });
   await mkdir2(resolve3(projectRoot, "server/db/migrations"), { recursive: true });
   await mkdir2(resolve3(projectRoot, "server/db/seeders"), { recursive: true });
@@ -2638,6 +2611,69 @@ async function resolveExistingModelPath(modelsRoot, modelName) {
   }
   return void 0;
 }
+function injectSvelteRealtimeVitePlugin(viteConfigContents) {
+  if (/\bholoSvelteKitRealtime\b/.test(viteConfigContents)) {
+    return void 0;
+  }
+  const adapterImportPattern = /import\s*\{([^}]*)\}\s*from\s*(['"])@holo-js\/adapter-sveltekit\/vite\2/;
+  const svelteKitImportPattern = /(import\s*\{[^}]*\bsveltekit\b[^}]*\}\s*from\s*(['"])@sveltejs\/kit\/vite\2)/;
+  const existingAdapterImport = adapterImportPattern.exec(viteConfigContents);
+  let withImport = viteConfigContents;
+  if (existingAdapterImport) {
+    const imports = existingAdapterImport[1]?.split(",").map((value) => value.trim()).filter(Boolean) ?? [];
+    withImport = viteConfigContents.replace(adapterImportPattern, `import { ${["holoSvelteKitRealtime", ...imports].join(", ")} } from ${existingAdapterImport[2]}@holo-js/adapter-sveltekit/vite${existingAdapterImport[2]}`);
+  } else {
+    withImport = viteConfigContents.replace(
+      svelteKitImportPattern,
+      [
+        "$1",
+        "import { holoSvelteKitRealtime } from '@holo-js/adapter-sveltekit/vite'"
+      ].join("\n")
+    );
+  }
+  if (withImport === viteConfigContents && !existingAdapterImport) {
+    return {
+      error: "Unable to add holoSvelteKitRealtime() to vite.config.ts because the SvelteKit Vite import could not be found."
+    };
+  }
+  const withPlugin = withImport.replace(/plugins\s*:\s*\[([\s\S]*?)\]/, (_match, plugins) => {
+    const separator = plugins.trim() ? " " : "";
+    return `plugins: [holoSvelteKitRealtime(),${separator}${plugins}]`;
+  });
+  if (withPlugin === withImport) {
+    if (/\bplugins\s*:\s*(?!\[)|\bplugins\s*(?:,|})/.test(withImport)) {
+      return {
+        error: "Unable to add holoSvelteKitRealtime() to vite.config.ts because the plugins option is not an inline array."
+      };
+    }
+    return {
+      error: "Unable to add holoSvelteKitRealtime() to vite.config.ts because no plugins array was found."
+    };
+  }
+  return withPlugin;
+}
+var realtimeDefinitionExtensions = /* @__PURE__ */ new Set([".ts", ".mts", ".cts", ".js", ".mjs", ".cjs"]);
+async function collectRealtimeDefinitionFiles(root) {
+  const entries = await readdir2(root, { withFileTypes: true }).catch(() => []);
+  const files = await Promise.all(entries.map(async (entry) => {
+    const entryPath = resolve4(root, entry.name);
+    if (entry.isDirectory()) {
+      return await collectRealtimeDefinitionFiles(entryPath);
+    }
+    return realtimeDefinitionExtensions.has(extname2(entry.name)) ? [entryPath] : [];
+  }));
+  return files.flat().sort((left, right) => left.localeCompare(right));
+}
+async function renderNextRealtimeDefinitions(projectRoot) {
+  const generatedRoot = resolve4(projectRoot, ".holo-js/generated/next");
+  const files = await collectRealtimeDefinitionFiles(resolve4(projectRoot, "server/realtime"));
+  const importPaths = files.map((filePath) => {
+    const withoutExtension = filePath.slice(0, -extname2(filePath).length);
+    const importPath = relative(generatedRoot, withoutExtension).split(sep).join("/");
+    return importPath.startsWith(".") ? importPath : `./${importPath}`;
+  });
+  return renderNextGeneratedRealtimeDefinitions(importPaths);
+}
 async function resolveExistingAuthMigrationFiles(migrationsRoot) {
   const entries = await readdir2(migrationsRoot).catch(() => []);
   const resolved = /* @__PURE__ */ new Map();
@@ -2934,6 +2970,49 @@ async function installEventsIntoProject(projectRoot) {
     createdListenersDirectory: !listenersDirectoryExists
   };
 }
+async function installRealtimeIntoProject(projectRoot) {
+  await loadProjectConfig(projectRoot, { required: true });
+  const realtimeRoot = resolve4(projectRoot, "server/realtime");
+  const realtimeDirectoryExists = await pathExists(realtimeRoot);
+  const { dependencies, devDependencies } = await readPackageJsonDependencyState(projectRoot);
+  const framework = detectProjectFrameworkFromPackageJson(dependencies, devDependencies);
+  let createdFrameworkSetup = false;
+  await mkdir3(realtimeRoot, { recursive: true });
+  if (framework === "next") {
+    const routes = [
+      { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
+      { path: ".holo-js/generated/next/bootstrap.mjs", contents: renderNextRuntimeBootstrap() },
+      { path: ".holo-js/generated/next/realtime-definitions.ts", contents: await renderNextRealtimeDefinitions(projectRoot) }
+    ];
+    for (const route of routes) {
+      const routePath = resolve4(projectRoot, route.path);
+      if (!await pathExists(routePath)) {
+        createdFrameworkSetup = true;
+      }
+      await writeTextFile(routePath, route.contents);
+    }
+  } else if (framework === "sveltekit") {
+    const viteConfigPath = resolve4(projectRoot, "vite.config.ts");
+    if (await pathExists(viteConfigPath)) {
+      const existingViteConfig = await readTextFile(viteConfigPath);
+      const viteConfigContents = existingViteConfig ? injectSvelteRealtimeVitePlugin(existingViteConfig) : void 0;
+      if (typeof viteConfigContents === "string") {
+        createdFrameworkSetup = true;
+        await writeTextFile(viteConfigPath, viteConfigContents);
+      } else if (viteConfigContents) {
+        throw new Error(viteConfigContents.error);
+      }
+    } else {
+      createdFrameworkSetup = true;
+      await writeTextFile(viteConfigPath, renderSvelteViteConfig(false, true));
+    }
+  }
+  return {
+    updatedPackageJson: await upsertRealtimePackageDependency(projectRoot),
+    createdRealtimeDirectory: !realtimeDirectoryExists,
+    createdFrameworkSetup
+  };
+}
 async function installNotificationsIntoProject(projectRoot) {
   const project = await loadProjectConfig(projectRoot);
   const migrationsRoot = resolve4(projectRoot, project.config.paths.migrations);
@@ -3013,7 +3092,7 @@ async function installMediaIntoProject(projectRoot) {
   if (!mediaConfigPath) {
     await writeTextFile(resolve4(projectRoot, "config/media.ts"), renderMediaConfig());
   }
-  const { createMediaTableMigration } = await import("./media-migrations-76KFHA2U.mjs");
+  const { createMediaTableMigration } = await import("./media-migrations-BFEL7NFG.mjs");
   const migrationFilePath = await createMediaTableMigration(projectRoot, {
     skipIfExists: true
   });
@@ -3129,10 +3208,17 @@ async function installBroadcastIntoProject(projectRoot) {
   let createdFrameworkSetup = false;
   if (framework === "next") {
     const holoHelperPath = resolve4(projectRoot, ".holo-js/generated/next/holo.ts");
+    const broadcastConfigRoutePath = resolve4(projectRoot, "app/broadcasting/config/route.ts");
+    const generatedBroadcastConfigRoutePath = resolve4(projectRoot, ".holo-js/generated/next/broadcast-config-route.ts");
     if (!await pathExists(holoHelperPath)) {
       await writeTextFile(holoHelperPath, renderNextHoloHelper());
       createdFrameworkSetup = true;
     }
+    if (!await pathExists(broadcastConfigRoutePath)) {
+      await writeTextFile(broadcastConfigRoutePath, renderNextBroadcastConfigRoute());
+      createdFrameworkSetup = true;
+    }
+    await writeTextFile(generatedBroadcastConfigRoutePath, renderNextGeneratedBroadcastConfigRoute());
   } else if (framework === "sveltekit") {
     const holoHelperPath = resolve4(projectRoot, ".holo-js/generated/sveltekit/holo.ts");
     if (!await pathExists(holoHelperPath)) {
@@ -3209,6 +3295,7 @@ export {
   installAuthorizationIntoProject,
   installQueueIntoProject,
   installEventsIntoProject,
+  installRealtimeIntoProject,
   installNotificationsIntoProject,
   publishAuthNotificationsIntoProject,
   installMailIntoProject,

package/dist/{chunk-57SJ566R.mjs → chunk-LBJAJLKU.mjs}

@@ -1,6 +1,6 @@
 import {
   readTextFile
-} from "./chunk-R6BWRY3E.mjs";
+} from "./chunk-ILU426CF.mjs";
 
 // src/fs-utils.ts
 import { stat } from "fs/promises";

package/dist/{chunk-BAFQ2GOA.mjs → chunk-LXGQCG56.mjs}

@@ -1,6 +1,6 @@
 import {
   fileExists
-} from "./chunk-57SJ566R.mjs";
+} from "./chunk-LBJAJLKU.mjs";
 
 // src/migrations.ts
 import { join } from "path";

package/dist/{chunk-DFKX4YT4.mjs → chunk-ONKESAQA.mjs}

@@ -1,6 +1,6 @@
 import {
   loadGeneratedProjectRegistry
-} from "./chunk-O6AXHL7Z.mjs";
+} from "./chunk-2DKQKZML.mjs";
 import {
   APP_CONFIG_FILE_NAMES,
   DATABASE_CONFIG_FILE_NAMES,
@@ -8,7 +8,7 @@ import {
   isModulePackage,
   pathExists,
   resolveFirstExistingPath
-} from "./chunk-R6BWRY3E.mjs";
+} from "./chunk-ILU426CF.mjs";
 
 // src/project/config.ts
 import { createHash } from "crypto";