@holo-js/cli 0.1.8 → 0.2.0

package/dist/{chunk-O6AXHL7Z.mjs → chunk-2DKQKZML.mjs}

@@ -7,6 +7,7 @@ import {
   GENERATED_BROADCAST_PATH,
   GENERATED_BROADCAST_TYPES_PATH,
   GENERATED_CHANNELS_PATH,
+  GENERATED_CHANNEL_IMPORTER_PATH,
   GENERATED_COMMANDS_PATH,
   GENERATED_CONFIG_TYPES_PATH,
   GENERATED_EVENTS_PATH,
@@ -32,7 +33,7 @@ import {
   isRecord,
   makeProjectRelativePath,
   normalizeScaffoldOptionalPackages
-} from "./chunk-R6BWRY3E.mjs";
+} from "./chunk-ILU426CF.mjs";
 
 // src/templates.ts
 import { dirname, relative, resolve } from "path";
@@ -415,31 +416,10 @@ function renderNuxtHostedAuthCallbackRoute(spec) {
 }
 function renderNuxtHostedAuthLogoutRoute(spec) {
   return [
-    "import { provider } from '@holo-js/auth'",
     `import { ${spec.logoutFunction} } from '${spec.packageName}'`,
-    "import { createError, sendRedirect } from 'h3'",
     "",
     "export default defineEventHandler(async (event) => {",
-    "  let currentProvider: string | null",
-    "  try {",
-    "    currentProvider = await provider()",
-    "  } catch {",
-    "    return await sendRedirect(event, '/', 303)",
-    "  }",
-    "",
-    `  if (currentProvider !== '${spec.provider}') {`,
-    "    return await sendRedirect(event, '/', 303)",
-    "  }",
-    "",
-    `  const { data, error } = await ${spec.logoutFunction}(event)`,
-    "  if (error) {",
-    "    throw createError({",
-    "      statusCode: error.status,",
-    "      statusMessage: error.message,",
-    "    })",
-    "  }",
-    "",
-    "  return await sendRedirect(event, data.url, 303)",
+    `  return await ${spec.logoutFunction}(event)`,
     "})",
     ""
   ].join("\n");
@@ -529,17 +509,24 @@ function renderNextHoloHelper() {
     ""
   ].join("\n");
 }
-function renderNextCurrentAuthRoute() {
-  return renderNextRouteBridge("../../../../.holo-js/generated/next/auth-user-route", ["GET"]);
+function renderNextRuntimeBootstrap() {
+  return [
+    "import { dirname, resolve } from 'node:path'",
+    "import { fileURLToPath } from 'node:url'",
+    "import { createNextHoloHelpers } from '@holo-js/adapter-next/runtime'",
+    "",
+    "const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../..')",
+    "const holo = createNextHoloHelpers({ projectRoot })",
+    "",
+    "await holo.getApp()",
+    ""
+  ].join("\n");
 }
-function renderNextGeneratedCurrentAuthRoute() {
+function renderNextCurrentAuthRoute() {
   return [
     "import auth, { check, isAuthError, provider, user } from '@holo-js/auth'",
-    "import { holo } from './holo'",
     "",
     "export async function GET(request: Request) {",
-    "  await holo.getApp()",
-    "",
     "  const guard = new URL(request.url).searchParams.get('guard') ?? undefined",
     "  try {",
     "    const guardAuth = guard ? auth.guard(guard) : undefined",
@@ -624,30 +611,13 @@ function renderNextHostedAuthLogoutRoute(spec) {
 }
 function renderNextGeneratedHostedAuthLogoutRoute(spec) {
   return [
-    "import { provider } from '@holo-js/auth'",
     `import { ${spec.logoutFunction} } from '${spec.packageName}'`,
     "import { holo } from './holo'",
     "",
     "export async function POST(request: Request) {",
     "  await holo.getApp()",
     "",
-    "  let currentProvider: string | null",
-    "  try {",
-    "    currentProvider = await provider()",
-    "  } catch {",
-    "    return Response.redirect(new URL('/', request.url), 303)",
-    "  }",
-    "",
-    `  if (currentProvider !== '${spec.provider}') {`,
-    "    return Response.redirect(new URL('/', request.url), 303)",
-    "  }",
-    "",
-    `  const { data, error } = await ${spec.logoutFunction}(request)`,
-    "  if (error) {",
-    "    return Response.json({ data, error }, { status: error.status })",
-    "  }",
-    "",
-    "  return Response.redirect(data.url, 303)",
+    `  return await ${spec.logoutFunction}(request)`,
     "}",
     ""
   ].join("\n");
@@ -679,47 +649,94 @@ function renderNextGeneratedStorageRoute() {
 function renderNextBroadcastAuthRoute() {
   return renderNextRouteBridge("../../../.holo-js/generated/next/broadcast-auth-route", ["POST"]);
 }
+function renderNextBroadcastConfigRoute() {
+  return renderNextRouteBridge("../../../.holo-js/generated/next/broadcast-config-route", ["GET"]);
+}
+function renderNextGeneratedBroadcastConfigRoute() {
+  return [
+    "import { renderBroadcastClientConfigResponse } from '@holo-js/broadcast/client-config'",
+    "import { holo } from './holo'",
+    "",
+    "export async function GET() {",
+    "  const app = await holo.getApp()",
+    "  return renderBroadcastClientConfigResponse(app.config.broadcast)",
+    "}",
+    ""
+  ].join("\n");
+}
 function renderNextGeneratedBroadcastAuthRoute() {
   return [
     "import { renderBroadcastAuthResponse } from '@holo-js/broadcast/auth'",
+    "import { importBroadcastChannelModule } from '../channel-importer'",
     "import { holo } from './holo'",
     "",
     "export async function POST(request: Request) {",
     "  const app = await holo.getApp()",
     "  const auth = await holo.getAuth()",
+    "  const connection = app.config.broadcast.connections[app.config.broadcast.default]",
+    "  const signing = connection?.driver === 'holo' && 'key' in connection && 'secret' in connection",
+    "    ? {",
+    "        appKey: connection.key,",
+    "        appSecret: connection.secret,",
+    "      }",
+    "    : {}",
     "",
     "  return await renderBroadcastAuthResponse(request, {",
-    "    resolveUser: async () => await auth?.user(),",
+    "    ...signing,",
+    "    resolveUser: async (_request, context) => {",
+    "      const guardAuth = context.guard ? auth?.guard(context.guard) : undefined",
+    "      return guardAuth ? await guardAuth.user() : await auth?.user()",
+    "    },",
     "    channelAuth: {",
     "      registry: {",
     "        projectRoot: app.projectRoot,",
     "        channels: app.registry?.channels ?? [],",
     "      },",
+    "      importModule: importBroadcastChannelModule,",
     "    },",
     "  })",
     "}",
     ""
   ].join("\n");
 }
+function renderNextGeneratedRealtimeDefinitions(importPaths = []) {
+  const imports = importPaths.map((importPath, index) => `import * as realtimeModule${index} from ${JSON.stringify(importPath)}`);
+  const values = importPaths.map((_importPath, index) => `...Object.values(realtimeModule${index})`);
+  return [
+    ...imports,
+    "",
+    `export const realtimeDefinitions = [${values.join(", ")}] as const`,
+    ""
+  ].join("\n");
+}
 function renderNextManagedRouteFiles(options = {}) {
   return [
     { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
-    ...options.authEnabled ? [{ path: ".holo-js/generated/next/auth-user-route.ts", contents: renderNextGeneratedCurrentAuthRoute() }] : [],
+    { path: ".holo-js/generated/next/bootstrap.mjs", contents: renderNextRuntimeBootstrap() },
     ...options.storageEnabled ? [{ path: ".holo-js/generated/next/storage-route.ts", contents: renderNextGeneratedStorageRoute() }] : [],
-    ...options.broadcastAuthEnabled ? [{ path: ".holo-js/generated/next/broadcast-auth-route.ts", contents: renderNextGeneratedBroadcastAuthRoute() }] : []
+    ...options.broadcastEnabled ? [{ path: ".holo-js/generated/next/broadcast-config-route.ts", contents: renderNextGeneratedBroadcastConfigRoute() }] : [],
+    ...options.broadcastAuthEnabled ? [{ path: ".holo-js/generated/next/broadcast-auth-route.ts", contents: renderNextGeneratedBroadcastAuthRoute() }] : [],
+    ...options.realtimeEnabled ? [{ path: ".holo-js/generated/next/realtime-definitions.ts", contents: renderNextGeneratedRealtimeDefinitions() }] : []
   ];
 }
 function renderNextManagedHostedAuthRouteFiles(features) {
-  return getRequestedHostedAuthProviders(features).flatMap((provider) => {
-    const spec = HOSTED_AUTH_PROVIDERS[provider];
-    return [
-      { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
-      { path: `.holo-js/generated/next/auth-${provider}-login-route.ts`, contents: renderNextGeneratedHostedAuthLoginRoute(spec) },
-      { path: `.holo-js/generated/next/auth-${provider}-register-route.ts`, contents: renderNextGeneratedHostedAuthRegisterRoute(spec) },
-      { path: `.holo-js/generated/next/auth-${provider}-callback-route.ts`, contents: renderNextGeneratedHostedAuthCallbackRoute(spec) },
-      { path: `.holo-js/generated/next/auth-${provider}-logout-route.ts`, contents: renderNextGeneratedHostedAuthLogoutRoute(spec) }
-    ];
-  });
+  const providers = getRequestedHostedAuthProviders(features);
+  if (providers.length === 0) {
+    return [];
+  }
+  return [
+    { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
+    { path: ".holo-js/generated/next/bootstrap.mjs", contents: renderNextRuntimeBootstrap() },
+    ...providers.flatMap((provider) => {
+      const spec = HOSTED_AUTH_PROVIDERS[provider];
+      return [
+        { path: `.holo-js/generated/next/auth-${provider}-login-route.ts`, contents: renderNextGeneratedHostedAuthLoginRoute(spec) },
+        { path: `.holo-js/generated/next/auth-${provider}-register-route.ts`, contents: renderNextGeneratedHostedAuthRegisterRoute(spec) },
+        { path: `.holo-js/generated/next/auth-${provider}-callback-route.ts`, contents: renderNextGeneratedHostedAuthCallbackRoute(spec) },
+        { path: `.holo-js/generated/next/auth-${provider}-logout-route.ts`, contents: renderNextGeneratedHostedAuthLogoutRoute(spec) }
+      ];
+    })
+  ];
 }
 function renderSvelteManagedRuntimeFiles() {
   return [
@@ -756,7 +773,7 @@ function renderSvelteServerUserHooks() {
     ""
   ].join("\n");
 }
-function renderSvelteViteConfig(_storageEnabled) {
+function renderSvelteViteConfig(_storageEnabled, realtimeEnabled = false) {
   const externals = [
     "      '@holo-js/adapter-sveltekit',",
     "      '@holo-js/auth',",
@@ -784,6 +801,7 @@ function renderSvelteViteConfig(_storageEnabled) {
     "      '@holo-js/queue',",
     "      '@holo-js/queue-db',",
     "      '@holo-js/queue-redis',",
+    "      '@holo-js/realtime',",
     "      '@holo-js/security',",
     "      '@holo-js/session',",
     "      '@holo-js/storage',",
@@ -797,10 +815,11 @@ function renderSvelteViteConfig(_storageEnabled) {
   ];
   return [
     "import { sveltekit } from '@sveltejs/kit/vite'",
+    ...realtimeEnabled ? ["import { holoSvelteKitRealtime } from '@holo-js/adapter-sveltekit/vite'"] : [],
     "import { defineConfig } from 'vite'",
     "",
     "export default defineConfig({",
-    "  plugins: [sveltekit()],",
+    `  plugins: [${realtimeEnabled ? "holoSvelteKitRealtime(), " : ""}sveltekit()],`,
     "  server: {",
     "    fs: {",
     "      allow: ['.holo-js/generated'],",
@@ -919,28 +938,11 @@ function renderSvelteHostedAuthCallbackRoute(spec) {
 }
 function renderSvelteHostedAuthLogoutRoute(spec) {
   return [
-    "import { redirect, type RequestEvent } from '@sveltejs/kit'",
-    "import { provider } from '@holo-js/auth'",
+    "import { type RequestEvent } from '@sveltejs/kit'",
     `import { ${spec.logoutFunction} } from '${spec.packageName}'`,
     "",
     "export async function POST(event: RequestEvent) {",
-    "  let currentProvider: string | null",
-    "  try {",
-    "    currentProvider = await provider()",
-    "  } catch {",
-    "    throw redirect(303, '/')",
-    "  }",
-    "",
-    `  if (currentProvider !== '${spec.provider}') {`,
-    "    throw redirect(303, '/')",
-    "  }",
-    "",
-    `  const { data, error } = await ${spec.logoutFunction}(event)`,
-    "  if (error) {",
-    "    return Response.json({ data, error }, { status: error.status })",
-    "  }",
-    "",
-    "  throw redirect(303, data.url)",
+    `  return await ${spec.logoutFunction}(event)`,
     "}",
     ""
   ].join("\n");
@@ -951,8 +953,7 @@ function renderSvelteHostedAuthRouteFiles(provider) {
     { path: `src/routes/api/auth/${provider}/login/+server.ts`, contents: renderSvelteHostedAuthLoginRoute(spec) },
     { path: `src/routes/api/auth/${provider}/register/+server.ts`, contents: renderSvelteHostedAuthRegisterRoute(spec) },
     { path: `src/routes/api/auth/${provider}/callback/+server.ts`, contents: renderSvelteHostedAuthCallbackRoute(spec) },
-    { path: `src/routes/api/auth/${provider}/logout/+server.ts`, contents: renderSvelteHostedAuthLogoutRoute(spec) },
-    ...renderSvelteManagedRuntimeFiles()
+    { path: `src/routes/api/auth/${provider}/logout/+server.ts`, contents: renderSvelteHostedAuthLogoutRoute(spec) }
   ];
 }
 function renderAuthProviderRouteFiles(framework, features) {
@@ -971,7 +972,7 @@ function renderAuthRouteFiles(framework) {
     return [
       { path: "app/api/auth/user/route.ts", contents: renderNextCurrentAuthRoute() },
       { path: ".holo-js/generated/next/holo.ts", contents: renderNextHoloHelper() },
-      { path: ".holo-js/generated/next/auth-user-route.ts", contents: renderNextGeneratedCurrentAuthRoute() }
+      { path: ".holo-js/generated/next/bootstrap.mjs", contents: renderNextRuntimeBootstrap() }
     ];
   }
   if (framework === "nuxt") {
@@ -979,14 +980,14 @@ function renderAuthRouteFiles(framework) {
       { path: "server/api/auth/user.get.ts", contents: renderNuxtCurrentAuthRoute() }
     ];
   }
-  return [
-    ...renderSvelteManagedRuntimeFiles()
-  ];
+  return [];
 }
 function renderFrameworkFiles(options) {
   const optionalPackages = normalizeScaffoldOptionalPackages(options.optionalPackages);
   const storageEnabled = optionalPackages.includes("storage");
   const authEnabled = optionalPackages.includes("auth");
+  const broadcastEnabled = optionalPackages.includes("broadcast");
+  const realtimeEnabled = optionalPackages.includes("realtime");
   if (options.framework === "nuxt") {
     return [
       { path: "app/app.vue", contents: renderNuxtAppVue(options.projectName) },
@@ -1003,12 +1004,13 @@ function renderFrameworkFiles(options) {
       { path: "app/page.tsx", contents: renderNextPage(options.projectName) },
       ...authEnabled ? [{ path: "app/api/auth/user/route.ts", contents: renderNextCurrentAuthRoute() }] : [],
       ...storageEnabled ? [{ path: "app/storage/[[...path]]/route.ts", contents: renderNextStorageRoute() }] : [],
-      ...renderNextManagedRouteFiles({ authEnabled, storageEnabled })
+      ...broadcastEnabled ? [{ path: "app/broadcasting/config/route.ts", contents: renderNextBroadcastConfigRoute() }] : [],
+      ...renderNextManagedRouteFiles({ authEnabled, broadcastEnabled, storageEnabled, realtimeEnabled })
     ];
   }
   return [
     { path: "svelte.config.js", contents: renderSvelteConfig() },
-    { path: "vite.config.ts", contents: renderSvelteViteConfig(storageEnabled) },
+    { path: "vite.config.ts", contents: renderSvelteViteConfig(storageEnabled, realtimeEnabled) },
     { path: "src/hooks.ts", contents: renderSvelteUserHooks() },
     { path: "src/hooks.server.ts", contents: renderSvelteServerUserHooks() },
     { path: "src/app.html", contents: renderSvelteAppHtml() },
@@ -1029,6 +1031,7 @@ function renderFrameworkRunner(options) {
     "const manifestPath = fileURLToPath(new URL('./project.json', import.meta.url))",
     "const projectRoot = resolve(dirname(manifestPath), '../..')",
     "const runtimeSchemaPath = resolve(projectRoot, '.holo-js/generated/schema.mjs')",
+    "const nextRuntimeBootstrapPath = resolve(projectRoot, '.holo-js/generated/next/bootstrap.mjs')",
     "const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))",
     "const framework = String(manifest.framework ?? '')",
     `const commandName = ${JSON.stringify(commandName)}`,
@@ -1248,8 +1251,18 @@ function renderFrameworkRunner(options) {
     "  while (true) {",
     "    const stderrLines = []",
     "    const childEnv = { ...process.env }",
-    "    if (existsSync(runtimeSchemaPath)) {",
-    "      const preload = `--import=${pathToFileURL(runtimeSchemaPath).href}`",
+    "    if (mode === 'build') {",
+    "      childEnv.HOLO_INTERNAL_FRAMEWORK_BUILD = '1'",
+    "    }",
+    "    const preloads = [runtimeSchemaPath]",
+    "    if (framework === 'next') {",
+    "      preloads.push(nextRuntimeBootstrapPath)",
+    "    }",
+    "    const preloadOptions = preloads",
+    "      .filter(path => existsSync(path))",
+    "      .map(path => `--import=${pathToFileURL(path).href}`)",
+    "    if (preloadOptions.length > 0) {",
+    "      const preload = preloadOptions.join(' ')",
     "      childEnv.NODE_OPTIONS = childEnv.NODE_OPTIONS",
     "        ? `${childEnv.NODE_OPTIONS} ${preload}`",
     "        : preload",
@@ -1313,13 +1326,13 @@ function renderFrameworkRunner(options) {
 // src/project/registry.ts
 import { constants as fsConstants } from "fs";
 import { access, mkdir as mkdir2, readFile as readFile2, readdir as readdir2, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname3, extname, join, resolve as resolve3 } from "path";
+import { dirname as dirname3, extname as extname2, join, resolve as resolve3 } from "path";
 import { loadConfigDirectory } from "@holo-js/config";
 import { DEFAULT_HOLO_PROJECT_PATHS, renderGeneratedSchemaRuntimeModule } from "@holo-js/db";
 
 // src/project/registry-svelte.ts
-import { mkdir, readdir, readFile, rm, writeFile } from "fs/promises";
-import { dirname as dirname2, resolve as resolve2 } from "path";
+import { mkdir, readdir, readFile, rm, stat, writeFile } from "fs/promises";
+import { dirname as dirname2, extname, relative as relative2, resolve as resolve2, sep } from "path";
 function renderManagedSvelteHooksModule() {
   return [
     "// Generated by holo prepare. Do not edit.",
@@ -1373,7 +1386,10 @@ function renderManagedSvelteServerHooksModule(features) {
     "import { adapterSvelteKitInternals, runWithSvelteKitRequestEvent } from '@holo-js/adapter-sveltekit'",
     "import { sequence } from '@sveltejs/kit/hooks'",
     ...features.authEnabled ? ["import auth, { check, isAuthError, provider, user } from '@holo-js/auth'"] : [],
-    ...features.broadcastEnabled ? ["import { renderBroadcastAuthResponse } from '@holo-js/broadcast/auth'"] : [],
+    ...features.broadcastEnabled ? [
+      "import { renderBroadcastAuthResponse } from '@holo-js/broadcast/auth'",
+      "import { renderBroadcastClientConfigResponse } from '@holo-js/broadcast/client-config'"
+    ] : [],
     ...features.storageEnabled ? ["import { createPublicStorageResponse } from '@holo-js/storage'"] : [],
     ...features.clerkEnabled ? ["import { completeClerkAuth, loginWithClerk, logoutWithClerk, registerWithClerk } from '@holo-js/auth-clerk'"] : [],
     ...features.workosEnabled ? ["import { completeWorkosAuth, loginWithWorkos, logoutWithWorkos, registerWithWorkos } from '@holo-js/auth-workos'"] : [],
@@ -1384,7 +1400,7 @@ function renderManagedSvelteServerHooksModule(features) {
   const routeHandlers = [
     ...features.authEnabled ? ["handleHoloCurrentAuthRoute"] : [],
     ...features.storageEnabled ? ["handleHoloStorageRoute"] : [],
-    ...features.broadcastEnabled ? ["handleHoloBroadcastAuthRoute"] : [],
+    ...features.broadcastEnabled ? ["handleHoloBroadcastConfigRoute", "handleHoloBroadcastAuthRoute"] : [],
     ...features.clerkEnabled ? [
       "handleHoloClerkLoginRoute",
       "handleHoloClerkRegisterRoute",
@@ -1477,14 +1493,33 @@ function renderManagedSvelteServerHooksModule(features) {
       ""
     ] : [],
     ...features.broadcastEnabled ? [
+      "async function handleHoloBroadcastConfigRoute(event: RequestEvent, app: HoloApp): Promise<Response | undefined> {",
+      "  if (!isRoute(event, 'GET', ['/broadcasting/config'])) {",
+      "    return undefined",
+      "  }",
+      "",
+      "  return renderBroadcastClientConfigResponse(app.config.broadcast)",
+      "}",
+      "",
       "async function handleHoloBroadcastAuthRoute(event: RequestEvent, app: HoloApp): Promise<Response | undefined> {",
       "  if (!isRoute(event, 'POST', ['/broadcasting/auth'])) {",
       "    return undefined",
       "  }",
       "",
       "  const auth = await holo.getAuth()",
+      "  const connection = app.config.broadcast.connections[app.config.broadcast.default]",
+      "  const signing = connection?.driver === 'holo' && 'key' in connection && 'secret' in connection",
+      "    ? {",
+      "        appKey: connection.key,",
+      "        appSecret: connection.secret,",
+      "      }",
+      "    : {}",
       "  return await renderBroadcastAuthResponse(event.request, {",
-      "    resolveUser: async () => await auth?.user(),",
+      "    ...signing,",
+      "    resolveUser: async (_request, context) => {",
+      "      const guardAuth = context.guard ? auth?.guard(context.guard) : undefined",
+      "      return guardAuth ? await guardAuth.user() : await auth?.user()",
+      "    },",
       "    channelAuth: {",
       "      registry: {",
       "        projectRoot: app.projectRoot,",
@@ -1612,23 +1647,7 @@ function renderSvelteHostedAuthHookRoutes(providerName, functionSuffix) {
     "    return undefined",
     "  }",
     "",
-    "  let currentProvider: string | null",
-    "  try {",
-    "    currentProvider = await provider()",
-    "  } catch {",
-    "    return redirectResponse(event, '/')",
-    "  }",
-    "",
-    `  if (currentProvider !== '${providerName}') {`,
-    "    return redirectResponse(event, '/')",
-    "  }",
-    "",
-    `  const { data, error } = await logoutWith${functionSuffix}(event)`,
-    "  if (error) {",
-    "    return Response.json({ data, error }, { status: error.status })",
-    "  }",
-    "",
-    "  return redirectResponse(event, data.url)",
+    `  return await logoutWith${functionSuffix}(event)`,
     "}",
     ""
   ];
@@ -1701,6 +1720,9 @@ async function unlinkIfPresent(path) {
 async function pathExists(path) {
   return await readFileIfPresent(path) !== void 0;
 }
+async function directoryExists(path) {
+  return await stat(path).then((entry) => entry.isDirectory(), () => false);
+}
 var SVELTE_HOOKS_OVERRIDE_BLOCK = [
   "    files: {",
   "      hooks: {",
@@ -1861,17 +1883,43 @@ async function directoryContainsText(path, pattern) {
   }
   return false;
 }
+var realtimeDefinitionExtensions = /* @__PURE__ */ new Set([".ts", ".mts", ".cts", ".js", ".mjs", ".cjs"]);
+async function collectRealtimeDefinitionFiles(root) {
+  const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
+  const files = await Promise.all(entries.map(async (entry) => {
+    const entryPath = resolve2(root, entry.name);
+    if (entry.isDirectory()) {
+      return await collectRealtimeDefinitionFiles(entryPath);
+    }
+    return realtimeDefinitionExtensions.has(extname(entry.name)) ? [entryPath] : [];
+  }));
+  return files.flat().sort((left, right) => left.localeCompare(right));
+}
+async function renderNextRealtimeDefinitions(projectRoot) {
+  const generatedRoot = resolve2(projectRoot, ".holo-js/generated/next");
+  const files = await collectRealtimeDefinitionFiles(resolve2(projectRoot, "server/realtime"));
+  const importPaths = files.map((filePath) => {
+    const withoutExtension = filePath.slice(0, -extname(filePath).length);
+    const importPath = relative2(generatedRoot, withoutExtension).split(sep).join("/");
+    return importPath.startsWith(".") ? importPath : `./${importPath}`;
+  });
+  return renderNextGeneratedRealtimeDefinitions(importPaths);
+}
 async function ensureNextManagedRoutes(projectRoot) {
   const authEnabled = await pathExists(resolve2(projectRoot, "app/api/auth/user/route.ts"));
   const storageEnabled = await pathExists(resolve2(projectRoot, "app/storage/[[...path]]/route.ts"));
+  const broadcastEnabled = await pathExists(resolve2(projectRoot, "app/broadcasting/config/route.ts"));
   const broadcastAuthEnabled = await pathExists(resolve2(projectRoot, "app/broadcasting/auth/route.ts"));
+  const realtimeEnabled = await directoryExists(resolve2(projectRoot, "server/realtime"));
   const clerkEnabled = await pathExists(resolve2(projectRoot, "app/api/auth/clerk/login/route.ts"));
   const workosEnabled = await pathExists(resolve2(projectRoot, "app/api/auth/workos/login/route.ts"));
   const files = [
     ...renderNextManagedRouteFiles({
       authEnabled,
+      broadcastEnabled,
       storageEnabled,
-      broadcastAuthEnabled
+      broadcastAuthEnabled,
+      realtimeEnabled
     }),
     ...renderNextManagedHostedAuthRouteFiles({
       clerk: clerkEnabled,
@@ -1881,6 +1929,12 @@ async function ensureNextManagedRoutes(projectRoot) {
   for (const file of files) {
     await writeFileIfChanged(resolve2(projectRoot, file.path), file.contents);
   }
+  if (realtimeEnabled) {
+    await writeFileIfChanged(
+      resolve2(projectRoot, ".holo-js/generated/next/realtime-definitions.ts"),
+      await renderNextRealtimeDefinitions(projectRoot)
+    );
+  }
   await removeLegacyManagedHoloHelper(resolve2(projectRoot, "server/holo.ts"), renderNextHoloHelper());
 }
 function isRecord2(value) {
@@ -2115,8 +2169,8 @@ function renderAugmentationInterface(name, members) {
   ];
 }
 function renderGeneratedBroadcastTypes(broadcast, channels) {
-  const typedBroadcastEntries = broadcast.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
-  const typedChannelEntries = channels.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
+  const typedBroadcastEntries = broadcast.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
+  const typedChannelEntries = channels.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
   const broadcastImportNameByName = new Map(typedBroadcastEntries.map((entry, index) => [entry.name, `holoBroadcastModule${index}`]));
   const channelImportNameByPattern = new Map(typedChannelEntries.map((entry, index) => [entry.pattern, `holoChannelModule${index}`]));
   const broadcastNeedsDefinitionType = broadcast.some((entry) => !broadcastImportNameByName.get(entry.name) || !entry.exportName);
@@ -2198,6 +2252,7 @@ function renderGeneratedBroadcastManifest(registry) {
       `      name: ${JSON.stringify(entry.pattern)},`,
       `      pattern: ${JSON.stringify(entry.pattern)},`,
       `      type: ${JSON.stringify(entry.type)},`,
+      ...typeof entry.guard === "undefined" ? [] : [`      guard: ${JSON.stringify(entry.guard)},`],
       `      params: ${JSON.stringify(entry.params)},`,
       `      whispers: ${JSON.stringify(entry.whispers)},`
     ];
@@ -2223,6 +2278,7 @@ function renderGeneratedBroadcastManifest(registry) {
     "type GeneratedBroadcastManifestChannel = {",
     "  readonly name: string",
     "  readonly pattern: string",
+    "  readonly guard?: string",
     "  readonly type: 'private' | 'presence'",
     "  readonly params: readonly string[]",
     "  readonly whispers: readonly string[]",
@@ -2251,9 +2307,33 @@ function renderGeneratedBroadcastManifest(registry) {
     ""
   ].join("\n");
 }
+function renderGeneratedChannelImporter(channels) {
+  const importableChannels = channels.filter((entry) => [".ts", ".mts", ".cts", ".js", ".mjs", ".cjs"].includes(extname2(entry.sourcePath)));
+  const imports = importableChannels.map((entry, index) => {
+    return `import * as holoChannelModule${index} from '${relativeImportPath(GENERATED_CHANNEL_IMPORTER_PATH, entry.sourcePath)}'`;
+  });
+  const cases = importableChannels.flatMap((entry, index) => [
+    `  if (normalizedPath.endsWith(${JSON.stringify(`/${entry.sourcePath}`)})) {`,
+    `    return holoChannelModule${index}`,
+    "  }"
+  ]);
+  return [
+    "// Generated by holo prepare. Do not edit.",
+    "",
+    ...imports,
+    ...imports.length > 0 ? [""] : [],
+    "export async function importBroadcastChannelModule(absolutePath: string): Promise<unknown> {",
+    "  const normalizedPath = absolutePath.replaceAll('\\\\', '/')",
+    ...cases,
+    "",
+    '  throw new Error(`[@holo-js/broadcast] Broadcast channel module "${absolutePath}" was not generated for this app.`)',
+    "}",
+    ""
+  ].join("\n");
+}
 function renderGeneratedEventTypes(events, listeners) {
-  const typedEventEntries = events.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
-  const typedListenerEntries = listeners.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
+  const typedEventEntries = events.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
+  const typedListenerEntries = listeners.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
   const eventImportNameByName = new Map(typedEventEntries.map((entry, index) => [entry.name, `holoEventModule${index}`]));
   const listenerImportNameById = new Map(typedListenerEntries.map((entry, index) => [entry.id, `holoListenerModule${index}`]));
   const needsEventDefinitionType = events.some((entry) => !eventImportNameByName.get(entry.name) || !entry.exportName);
@@ -2306,7 +2386,7 @@ function renderGeneratedEventTypes(events, listeners) {
   ].join("\n");
 }
 function renderGeneratedQueueTypes(jobs) {
-  const typedJobs = jobs.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
+  const typedJobs = jobs.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
   const typeImportNameByJob = new Map(
     typedJobs.map((entry, index) => {
       return [entry.name, `holoQueueJobModule${index}`];
@@ -2342,7 +2422,23 @@ function renderGeneratedQueueTypes(jobs) {
     ""
   ].join("\n");
 }
-function renderGeneratedAuthTypes(guards) {
+function getAuthProviderModelNames(auth) {
+  if (!auth) {
+    return [];
+  }
+  return [...new Set(Object.values(auth.guards).map((guard) => auth.providers[guard.provider]?.model).filter((model) => typeof model === "string" && model.length > 0))].sort((left, right) => left.localeCompare(right));
+}
+function renderGeneratedAuthTypes(auth, models = []) {
+  const guards = auth?.guards ?? {};
+  const modelByName = new Map(models.map((model) => [model.name, model]));
+  const userModels = getAuthProviderModelNames(auth).map((modelName) => modelByName.get(modelName)).filter((model) => Boolean(model));
+  const userTableNames = [...new Set(userModels.map((model) => model.tableName))];
+  const userType = userModels.length > 0 ? userTableNames.map((tableName) => `InferSelect<GeneratedSchemaTable<${JSON.stringify(tableName)}>>`).join(" | ") : void 0;
+  const imports = userType ? [
+    "import type { AuthUserLike } from '@holo-js/auth'",
+    "import type { GeneratedSchemaTable, InferSelect } from '@holo-js/db'",
+    ""
+  ] : [];
   const members = Object.entries(guards).sort(([left], [right]) => left.localeCompare(right)).filter((entry) => {
     return entry[1].driver === "session" || entry[1].driver === "token";
   }).map(([name, guard]) => {
@@ -2359,12 +2455,14 @@ function renderGeneratedAuthTypes(guards) {
     "// Generated by holo prepare. Do not edit.",
     "",
     "import '@holo-js/auth'",
+    ...imports,
     "",
     "declare global {",
     "  // eslint-disable-next-line @typescript-eslint/no-namespace",
     "  namespace HoloAuth {",
     "    interface TypeRegistry {",
     ...guardsMember,
+    ...userType ? [`      user: (${userType}) & AuthUserLike`] : [],
     "    }",
     "  }",
     "}",
@@ -2411,8 +2509,8 @@ function renderGeneratedAuthorizationRegistry(registry) {
   ].join("\n");
 }
 function renderGeneratedAuthorizationTypes(authorizationPolicies, authorizationAbilities, guardNames) {
-  const typedPolicyEntries = authorizationPolicies.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
-  const typedAbilityEntries = authorizationAbilities.filter((entry) => [".ts", ".mts", ".cts"].includes(extname(entry.sourcePath)));
+  const typedPolicyEntries = authorizationPolicies.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
+  const typedAbilityEntries = authorizationAbilities.filter((entry) => [".ts", ".mts", ".cts"].includes(extname2(entry.sourcePath)));
   const policyImportNameByName = new Map(typedPolicyEntries.map((entry, index) => [entry.name, `holoAuthorizationPolicyModule${index}`]));
   const abilityImportNameByName = new Map(typedAbilityEntries.map((entry, index) => [entry.name, `holoAuthorizationAbilityModule${index}`]));
   const usesHoloAuthUser = authorizationPolicies.length > 0 || authorizationAbilities.length > 0 || guardNames.length > 0;
@@ -2504,7 +2602,7 @@ async function resolveGeneratedTsconfigBase(_projectRoot) {
   return "../../tsconfig.json";
 }
 function getConfigExtensionPriority(fileName) {
-  const extension = extname(fileName);
+  const extension = extname2(fileName);
   const index = CONFIG_EXTENSION_PRIORITY.indexOf(extension);
   return index >= 0 ? index : Number.MAX_SAFE_INTEGER;
 }
@@ -2516,7 +2614,7 @@ async function collectProjectConfigEntries(projectRoot) {
     if (!entry.isFile()) {
       continue;
     }
-    const extension = extname(entry.name);
+    const extension = extname2(entry.name);
     if (!SUPPORTED_CONFIG_EXTENSIONS.has(extension)) {
       continue;
     }
@@ -2613,9 +2711,10 @@ async function writeGeneratedProjectRegistry(projectRoot, registry) {
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_LISTENERS_PATH), renderGeneratedModule("listeners", nextRegistry.listeners));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_BROADCAST_PATH), renderGeneratedModule("broadcast", nextRegistry.broadcast));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_CHANNELS_PATH), renderGeneratedModule("channels", nextRegistry.channels));
+  await writeFileIfChanged2(resolve3(projectRoot, GENERATED_CHANNEL_IMPORTER_PATH), renderGeneratedChannelImporter(nextRegistry.channels));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_BROADCAST_MANIFEST_PATH), renderGeneratedBroadcastManifest(nextRegistry));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_BROADCAST_TYPES_PATH), renderGeneratedBroadcastTypes(nextRegistry.broadcast, nextRegistry.channels));
-  await writeFileIfChanged2(resolve3(projectRoot, GENERATED_AUTH_TYPES_PATH), renderGeneratedAuthTypes(loadedConfig?.auth?.guards ?? {}));
+  await writeFileIfChanged2(resolve3(projectRoot, GENERATED_AUTH_TYPES_PATH), renderGeneratedAuthTypes(loadedConfig?.auth, nextRegistry.models));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_CONFIG_TYPES_PATH), renderGeneratedConfigTypes(projectRoot, configEntries));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_EVENT_TYPES_PATH), renderGeneratedEventTypes(nextRegistry.events, nextRegistry.listeners));
   await writeFileIfChanged2(resolve3(projectRoot, GENERATED_QUEUE_TYPES_PATH), renderGeneratedQueueTypes(nextRegistry.jobs));
@@ -2697,9 +2796,14 @@ export {
   resolveNameInfo,
   resolveArtifactPath,
   renderNextHoloHelper,
+  renderNextRuntimeBootstrap,
   renderNextBroadcastAuthRoute,
+  renderNextBroadcastConfigRoute,
+  renderNextGeneratedBroadcastConfigRoute,
   renderNextGeneratedBroadcastAuthRoute,
+  renderNextGeneratedRealtimeDefinitions,
   renderNextManagedHostedAuthRouteFiles,
+  renderSvelteViteConfig,
   renderSvelteHoloHelper,
   renderAuthProviderRouteFiles,
   renderAuthRouteFiles,