@base44-preview/cli 0.1.1-pr.555.067c6ae → 0.1.1-pr.555.6305311

package/dist/cli/index.js

@@ -163944,10 +163944,10 @@ var require_view = __commonJS((exports, module) => {
   var debug = require_src4()("express:view");
   var path18 = __require("node:path");
   var fs28 = __require("node:fs");
-  var dirname21 = path18.dirname;
+  var dirname22 = path18.dirname;
   var basename7 = path18.basename;
   var extname2 = path18.extname;
-  var join27 = path18.join;
+  var join28 = path18.join;
   var resolve12 = path18.resolve;
   module.exports = View;
   function View(name2, options8) {
@@ -163983,7 +163983,7 @@ var require_view = __commonJS((exports, module) => {
     for (var i5 = 0;i5 < roots.length && !path19; i5++) {
       var root2 = roots[i5];
       var loc = resolve12(root2, name2);
-      var dir = dirname21(loc);
+      var dir = dirname22(loc);
       var file2 = basename7(loc);
       path19 = this.resolve(dir, file2);
     }
@@ -164009,12 +164009,12 @@ var require_view = __commonJS((exports, module) => {
   };
   View.prototype.resolve = function resolve13(dir, file2) {
     var ext = this.ext;
-    var path19 = join27(dir, file2);
+    var path19 = join28(dir, file2);
     var stat2 = tryStat(path19);
     if (stat2 && stat2.isFile()) {
       return path19;
     }
-    path19 = join27(dir, basename7(file2, ext), "index" + ext);
+    path19 = join28(dir, basename7(file2, ext), "index" + ext);
     stat2 = tryStat(path19);
     if (stat2 && stat2.isFile()) {
       return path19;
@@ -167709,7 +167709,7 @@ var require_send = __commonJS((exports, module) => {
   var Stream2 = __require("stream");
   var util2 = __require("util");
   var extname2 = path18.extname;
-  var join27 = path18.join;
+  var join28 = path18.join;
   var normalize2 = path18.normalize;
   var resolve12 = path18.resolve;
   var sep = path18.sep;
@@ -167881,7 +167881,7 @@ var require_send = __commonJS((exports, module) => {
         return res;
       }
       parts = path19.split(sep);
-      path19 = normalize2(join27(root2, path19));
+      path19 = normalize2(join28(root2, path19));
     } else {
       if (UP_PATH_REGEXP.test(path19)) {
         debug('malicious path "%s"', path19);
@@ -168021,7 +168021,7 @@ var require_send = __commonJS((exports, module) => {
           return self2.onStatError(err);
         return self2.error(404);
       }
-      var p4 = join27(path19, self2._index[i5]);
+      var p4 = join28(path19, self2._index[i5]);
       debug('stat "%s"', p4);
       fs28.stat(p4, function(err2, stat2) {
         if (err2)
@@ -214616,7 +214616,7 @@ var require_buffer_list = __commonJS((exports, module) => {
       }
     }, {
       key: "join",
-      value: function join27(s5) {
+      value: function join28(s5) {
         if (this.length === 0)
           return "";
         var p4 = this.head;
@@ -234018,7 +234018,7 @@ function normalizeBase44Env() {
 loadProjectEnvFiles();
 
 // src/cli/index.ts
-import { dirname as dirname25, join as join30 } from "node:path";
+import { dirname as dirname26, join as join31 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 
 // ../../node_modules/@clack/core/dist/index.mjs
@@ -243757,6 +243757,10 @@ var RealtimeHandlerConfigSchema = exports_external.object({
   name: exports_external.string().min(1),
   entry: exports_external.string().min(1)
 });
+var RealtimeHandlerSchemaFileSchema = exports_external.object({
+  inbound: exports_external.unknown().optional(),
+  outbound: exports_external.unknown().optional()
+});
 var DeployRealtimeHandlerResponseSchema = exports_external.object({
   status: exports_external.enum(["deployed", "unchanged"]),
   handler_name: exports_external.string().optional()
@@ -243764,7 +243768,8 @@ var DeployRealtimeHandlerResponseSchema = exports_external.object({
 var RealtimeHandlerSchema = RealtimeHandlerConfigSchema.extend({
   entryPath: exports_external.string().min(1),
   filePaths: exports_external.array(exports_external.string()).min(1),
-  source: ResourceSourceSchema
+  source: ResourceSourceSchema,
+  messageSchema: exports_external.unknown().optional()
 });
 
 // src/core/resources/realtime-handler/api.ts
@@ -243783,7 +243788,7 @@ async function deploySingleRealtimeHandler(name2, payload) {
   return result.data;
 }
 // src/core/resources/realtime-handler/config.ts
-import { basename as basename4, dirname as dirname8, relative as relative3 } from "node:path";
+import { basename as basename4, dirname as dirname8, join as join10, relative as relative3 } from "node:path";
 async function readRealtimeHandler(entryFile, realtimeDir) {
   const handlerDir = dirname8(entryFile);
   const filePaths = await globby("**/*.ts", {
@@ -243801,12 +243806,25 @@ async function readRealtimeHandler(entryFile, realtimeDir) {
     });
   }
   const entry = basename4(entryFile);
+  const schemaPath = join10(handlerDir, "schema.jsonc");
+  let messageSchema;
+  if (await pathExists(schemaPath)) {
+    const parsed = await readJsonFile(schemaPath);
+    const result = RealtimeHandlerSchemaFileSchema.safeParse(parsed);
+    if (result.success) {
+      messageSchema = {
+        inbound: result.data.inbound,
+        outbound: result.data.outbound
+      };
+    }
+  }
   return {
     name: name2,
     entry,
     entryPath: entryFile,
     filePaths,
-    source: { type: "project" }
+    source: { type: "project" },
+    messageSchema
   };
 }
 async function readAllRealtimeHandlers(realtimeDir) {
@@ -243925,7 +243943,14 @@ class ProjectConfigReader {
   }
   async readProjectResources(configPath, project) {
     const configDir = dirname10(configPath);
-    const [entities, functions, realtimeHandlers, agents, connectors, authConfig] = await Promise.all([
+    const [
+      entities,
+      functions,
+      realtimeHandlers,
+      agents,
+      connectors,
+      authConfig
+    ] = await Promise.all([
       entityResource.readAll(join11(configDir, project.entitiesDir)),
       functionResource.readAll(join11(configDir, project.functionsDir)),
       realtimeHandlerResource.readAll(join11(configDir, project.realtimeDir)),
@@ -243933,7 +243958,14 @@ class ProjectConfigReader {
       connectorResource.readAll(join11(configDir, project.connectorsDir)),
       authConfigResource.readAll(join11(configDir, project.authDir))
     ]);
-    return { entities, functions, realtimeHandlers, agents, connectors, authConfig };
+    return {
+      entities,
+      functions,
+      realtimeHandlers,
+      agents,
+      connectors,
+      authConfig
+    };
   }
   assertPluginProjectDoesNotLoadPlugins(project, configPath) {
     if (project.plugin && project.plugins.length > 0) {
@@ -244322,7 +244354,15 @@ async function createArchive(pathToArchive, targetArchivePath) {
 }
 // src/core/project/deploy.ts
 function hasResourcesToDeploy(projectData) {
-  const { project, entities, functions, realtimeHandlers, agents, connectors, authConfig } = projectData;
+  const {
+    project,
+    entities,
+    functions,
+    realtimeHandlers,
+    agents,
+    connectors,
+    authConfig
+  } = projectData;
   const hasSite = Boolean(project.site?.outputDirectory);
   const hasEntities = entities.length > 0;
   const hasFunctions = functions.length > 0;
@@ -244333,7 +244373,15 @@ function hasResourcesToDeploy(projectData) {
   return hasEntities || hasFunctions || hasRealtimeHandlers || hasAgents || hasConnectors || hasAuthConfig || hasSite;
 }
 async function deployAll(projectData, options) {
-  const { project, entities, functions, realtimeHandlers, agents, connectors, authConfig } = projectData;
+  const {
+    project,
+    entities,
+    functions,
+    realtimeHandlers,
+    agents,
+    connectors,
+    authConfig
+  } = projectData;
   await entityResource.push(entities);
   await deployFunctionsSequentially(functions, {
     onStart: options?.onFunctionStart,
@@ -253285,125 +253333,12 @@ function getFunctionsCommand() {
   return new Command("functions").description("Manage backend functions").addCommand(getDeployCommand()).addCommand(getDeleteCommand()).addCommand(getListCommand()).addCommand(getPullCommand());
 }
 
-// src/cli/commands/realtime/deploy.ts
-function parseNames3(args) {
-  return args.flatMap((arg) => arg.split(",")).map((n2) => n2.trim()).filter(Boolean);
-}
-function resolveHandlersToDeploy(names, allHandlers) {
-  if (names.length === 0)
-    return allHandlers;
-  const notFound = names.filter((n2) => !allHandlers.some((h2) => h2.name === n2));
-  if (notFound.length > 0) {
-    throw new InvalidInputError(`Realtime handler${notFound.length > 1 ? "s" : ""} not found in project: ${notFound.join(", ")}`);
-  }
-  return allHandlers.filter((h2) => names.includes(h2.name));
-}
-function formatDeployResult2(result, log) {
-  const label = result.name.padEnd(25);
-  if (result.status === "deployed") {
-    const timing = result.durationMs ? theme.styles.dim(` (${(result.durationMs / 1000).toFixed(1)}s)`) : "";
-    log.success(`${label} deployed${timing}`);
-  } else if (result.status === "unchanged") {
-    log.success(`${label} unchanged`);
-  } else {
-    log.error(`${label} error: ${result.error}`);
-  }
-}
-function buildDeploySummary2(results) {
-  const deployed = results.filter((r) => r.status === "deployed").length;
-  const unchanged = results.filter((r) => r.status === "unchanged").length;
-  const failed = results.filter((r) => r.status === "error").length;
-  const parts = [];
-  if (deployed > 0)
-    parts.push(`${deployed} deployed`);
-  if (unchanged > 0)
-    parts.push(`${unchanged} unchanged`);
-  if (failed > 0)
-    parts.push(`${failed} error${failed !== 1 ? "s" : ""}`);
-  return parts.join(", ") || "No realtime handlers deployed";
-}
-async function deployRealtimeAction({ log }, names) {
-  const { realtimeHandlers } = await readProjectConfig();
-  const toDeploy = resolveHandlersToDeploy(names, realtimeHandlers);
-  if (toDeploy.length === 0) {
-    return {
-      outroMessage: "No realtime handlers found. Create handlers in the 'realtime' directory."
-    };
-  }
-  log.info(`Found ${toDeploy.length} ${toDeploy.length === 1 ? "realtime handler" : "realtime handlers"} to deploy`);
-  let completed = 0;
-  const total = toDeploy.length;
-  const results = await deployRealtimeHandlersSequentially(toDeploy, {
-    onStart: (startNames) => {
-      const label = startNames.length === 1 ? startNames[0] : `${startNames.length} realtime handlers`;
-      log.step(theme.styles.dim(`[${completed + 1}/${total}] Deploying ${label}...`));
-    },
-    onResult: (result) => {
-      completed++;
-      formatDeployResult2(result, log);
-    }
-  });
-  const hasFailures = results.some((r) => r.status === "error");
-  if (hasFailures) {
-    log.message(buildDeploySummary2(results));
-    throw new CLIExitError(1);
-  }
-  return { outroMessage: buildDeploySummary2(results) };
-}
-function getDeployCommand2() {
-  return new Base44Command("deploy").description("Deploy realtime handlers to Base44").argument("[names...]", "Handler names to deploy (deploys all if omitted)").action(async (ctx, rawNames) => {
-    const names = parseNames3(rawNames);
-    return deployRealtimeAction(ctx, names);
-  });
-}
-
-// src/cli/commands/realtime/new.ts
-import { join as join22 } from "node:path";
-function buildHandlerScaffold(handlerName) {
-  return `import { RealtimeHandler, type Conn } from "base44";
-
-export class ${handlerName} extends RealtimeHandler {
-  handleConnect(conn: Conn) {
-    console.log("Connected:", conn.userId);
-  }
-  handleMessage(conn: Conn, msg: unknown) {
-    console.log("Message:", msg);
-  }
-  handleTick() {}
-  handleClose(conn: Conn) {}
-}
-`;
-}
-async function newRealtimeHandlerAction(_ctx, handlerName) {
-  const { project: project2 } = await readProjectConfig();
-  const realtimeDir = join22(project2.root, project2.realtimeDir);
-  const handlerDir = join22(realtimeDir, handlerName);
-  if (await pathExists(handlerDir)) {
-    throw new InvalidInputError(`Realtime handler "${handlerName}" already exists at ${handlerDir}`);
-  }
-  const entryPath = join22(handlerDir, "entry.ts");
-  await writeFile(entryPath, buildHandlerScaffold(handlerName));
-  return {
-    outroMessage: `Created realtime handler "${handlerName}" at ${entryPath}`
-  };
-}
-function getNewCommand() {
-  return new Base44Command("new").description("Create a new realtime handler scaffold").argument("<HandlerName>", "Name of the realtime handler class").action(async (ctx, handlerName) => {
-    return newRealtimeHandlerAction(ctx, handlerName);
-  });
-}
-
-// src/cli/commands/realtime/index.ts
-function getRealtimeCommand() {
-  return new Command("realtime").description("Manage realtime handlers").addCommand(getNewCommand()).addCommand(getDeployCommand2());
-}
-
 // src/cli/commands/project/create.ts
 import { basename as basename5, resolve as resolve7 } from "node:path";
 var import_kebabCase = __toESM(require_kebabCase(), 1);
 
 // src/cli/commands/project/scaffold-shared.ts
-import { join as join23 } from "node:path";
+import { join as join22 } from "node:path";
 var DEFAULT_TEMPLATE_ID = "backend-only";
 async function getTemplateById(templateId) {
   const templates = await listTemplates();
@@ -253462,7 +253397,7 @@ async function completeProjectSetup({
         updateMessage("Building project...");
         await execa({ cwd: resolvedPath, shell: true })`${buildCommand}`;
         updateMessage("Deploying site...");
-        return await deploySite(join23(resolvedPath, outputDirectory));
+        return await deploySite(join22(resolvedPath, outputDirectory));
       }, {
         successMessage: theme.colors.base44Orange("Site deployed successfully"),
         errorMessage: "Failed to deploy site"
@@ -253633,7 +253568,15 @@ async function deployAction({ isNonInteractive, log }, options = {}) {
       outroMessage: "No resources found to deploy"
     };
   }
-  const { project: project2, entities, functions, realtimeHandlers, agents, connectors, authConfig } = projectData;
+  const {
+    project: project2,
+    entities,
+    functions,
+    realtimeHandlers,
+    agents,
+    connectors,
+    authConfig
+  } = projectData;
   const summaryLines = [];
   if (entities.length > 0) {
     summaryLines.push(`  - ${entities.length} ${entities.length === 1 ? "entity" : "entities"}`);
@@ -253695,7 +253638,7 @@ ${summaryLines.join(`
   }
   return { outroMessage: "App deployed successfully" };
 }
-function getDeployCommand3() {
+function getDeployCommand2() {
   return new Base44Command("deploy").description("Deploy all project resources (entities, functions, agents, connectors, and site)").option("-y, --yes", "Skip confirmation prompt").action(deployAction);
 }
 async function handleOAuthConnectors(connectorResults, isNonInteractive, options, log) {
@@ -253935,6 +253878,48 @@ function formatEntry(entry) {
   const message = entry.message.trim();
   return `${time3} ${level} ${message}`;
 }
+function entryKey(entry) {
+  return `${entry.time} ${entry.message}`;
+}
+function selectNewEntries(entries, state) {
+  const fresh = entries.filter((e2) => {
+    if (e2.time < state.lastTime)
+      return false;
+    if (e2.time === state.lastTime && state.boundaryKeys.has(entryKey(e2))) {
+      return false;
+    }
+    return true;
+  });
+  if (fresh.length === 0)
+    return { fresh, nextState: state };
+  const newMax = fresh.reduce((max, e2) => e2.time > max ? e2.time : max, state.lastTime);
+  const boundaryKeys = newMax === state.lastTime ? new Set(state.boundaryKeys) : new Set;
+  for (const e2 of fresh) {
+    if (e2.time === newMax)
+      boundaryKeys.add(entryKey(e2));
+  }
+  return { fresh, nextState: { lastTime: newMax, boundaryKeys } };
+}
+function writeFollowLine(entry, jsonMode) {
+  const line = jsonMode ? JSON.stringify(entry) : formatEntry(entry);
+  process.stdout.write(`${line}
+`);
+}
+async function followLogs(functionNames, options, availableFunctionNames, jsonMode) {
+  let state = { lastTime: "", boundaryKeys: new Set };
+  let first = true;
+  while (true) {
+    const pollOptions = first ? options : { ...options, since: state.lastTime };
+    const entries = await fetchLogsForFunctions(functionNames, pollOptions, availableFunctionNames);
+    const { fresh, nextState } = selectNewEntries(entries, state);
+    state = nextState;
+    fresh.sort((a2, b) => a2.time.localeCompare(b.time));
+    for (const entry of fresh)
+      writeFollowLine(entry, jsonMode);
+    first = false;
+    await new Promise((resolve8) => setTimeout(resolve8, 2000));
+  }
+}
 function formatLogs(entries, env3) {
   if (entries.length === 0) {
     if (env3 === "prod") {
@@ -254016,6 +254001,16 @@ async function logsAction(ctx, options) {
       outroMessage: localProjectRoot ? "No functions found in this project." : "No functions found in this app."
     };
   }
+  if (options.follow) {
+    if (options.until) {
+      throw new InvalidInputError("--until cannot be combined with --follow (a stream has no end).");
+    }
+    if (options.order) {
+      throw new InvalidInputError("--order cannot be combined with --follow (a live tail always streams oldest to newest).");
+    }
+    options.order = "asc";
+    return followLogs(functionNames, options, availableFunctionNames, ctx.jsonMode);
+  }
   let entries = await fetchLogsForFunctions(functionNames, options, availableFunctionNames);
   const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
   if (limit !== undefined && entries.length > limit) {
@@ -254031,7 +254026,7 @@ async function logsAction(ctx, options) {
   };
 }
 function getLogsCommand() {
-  return new Base44Command("logs").description("Fetch function logs for this app").option("--function <names>", "Filter by function name(s), comma-separated. If omitted, fetches logs for all project functions").option("--since <datetime>", "Show logs from this time. ISO datetime or relative shorthand (e.g. 1h, 30m, 2d)", normalizeDatetime).option("--until <datetime>", "Show logs until this time. ISO datetime or relative shorthand (e.g. 1h, 30m, 2d)", normalizeDatetime).addOption(new Option("--level <level>", "Filter by log level").choices([...LogLevelSchema.options]).hideHelp()).option("-n, --limit <n>", "Results per page (1-1000, default: 50)").addOption(new Option("--order <order>", "Sort order").choices(["asc", "desc"])).addOption(new Option("--env <env>", "Which deployment to read logs from: preview (current draft) or prod (published). Default: preview").choices([...LogEnvSchema.options])).action(logsAction);
+  return new Base44Command("logs").description("Fetch function logs for this app").option("--function <names>", "Filter by function name(s), comma-separated. If omitted, fetches logs for all project functions").option("--since <datetime>", "Show logs from this time. ISO datetime or relative shorthand (e.g. 1h, 30m, 2d)", normalizeDatetime).option("--until <datetime>", "Show logs until this time. ISO datetime or relative shorthand (e.g. 1h, 30m, 2d)", normalizeDatetime).addOption(new Option("--level <level>", "Filter by log level").choices([...LogLevelSchema.options]).hideHelp()).option("-n, --limit <n>", "Results per page (1-1000, default: 50)").option("-f, --follow", "Stream new logs as they arrive").addOption(new Option("--order <order>", "Sort order").choices(["asc", "desc"])).addOption(new Option("--env <env>", "Which deployment to read logs from: preview (current draft) or prod (published). Default: preview").choices([...LogEnvSchema.options])).action(logsAction);
 }
 
 // src/cli/commands/project/scaffold.ts
@@ -254088,6 +254083,127 @@ Examples:
   $ base44 scaffold my-app --app-id app_123  Scaffolds the current dir, named "my-app"`).action(scaffoldAction);
 }
 
+// src/cli/commands/realtime/deploy.ts
+function parseNames3(args) {
+  return args.flatMap((arg) => arg.split(",")).map((n2) => n2.trim()).filter(Boolean);
+}
+function resolveHandlersToDeploy(names, allHandlers) {
+  if (names.length === 0)
+    return allHandlers;
+  const notFound = names.filter((n2) => !allHandlers.some((h2) => h2.name === n2));
+  if (notFound.length > 0) {
+    throw new InvalidInputError(`Realtime handler${notFound.length > 1 ? "s" : ""} not found in project: ${notFound.join(", ")}`);
+  }
+  return allHandlers.filter((h2) => names.includes(h2.name));
+}
+function formatDeployResult2(result, log) {
+  const label = result.name.padEnd(25);
+  if (result.status === "deployed") {
+    const timing = result.durationMs ? theme.styles.dim(` (${(result.durationMs / 1000).toFixed(1)}s)`) : "";
+    log.success(`${label} deployed${timing}`);
+  } else if (result.status === "unchanged") {
+    log.success(`${label} unchanged`);
+  } else {
+    log.error(`${label} error: ${result.error}`);
+  }
+}
+function buildDeploySummary2(results) {
+  const deployed = results.filter((r) => r.status === "deployed").length;
+  const unchanged = results.filter((r) => r.status === "unchanged").length;
+  const failed = results.filter((r) => r.status === "error").length;
+  const parts = [];
+  if (deployed > 0)
+    parts.push(`${deployed} deployed`);
+  if (unchanged > 0)
+    parts.push(`${unchanged} unchanged`);
+  if (failed > 0)
+    parts.push(`${failed} error${failed !== 1 ? "s" : ""}`);
+  return parts.join(", ") || "No realtime handlers deployed";
+}
+async function deployRealtimeAction({ log }, names) {
+  const { realtimeHandlers } = await readProjectConfig();
+  const toDeploy = resolveHandlersToDeploy(names, realtimeHandlers);
+  if (toDeploy.length === 0) {
+    return {
+      outroMessage: "No realtime handlers found. Create handlers in the 'realtime' directory."
+    };
+  }
+  log.info(`Found ${toDeploy.length} ${toDeploy.length === 1 ? "realtime handler" : "realtime handlers"} to deploy`);
+  let completed = 0;
+  const total = toDeploy.length;
+  const results = await deployRealtimeHandlersSequentially(toDeploy, {
+    onStart: (startNames) => {
+      const label = startNames.length === 1 ? startNames[0] : `${startNames.length} realtime handlers`;
+      log.step(theme.styles.dim(`[${completed + 1}/${total}] Deploying ${label}...`));
+    },
+    onResult: (result) => {
+      completed++;
+      formatDeployResult2(result, log);
+    }
+  });
+  const hasFailures = results.some((r) => r.status === "error");
+  if (hasFailures) {
+    log.message(buildDeploySummary2(results));
+    throw new CLIExitError(1);
+  }
+  return { outroMessage: buildDeploySummary2(results) };
+}
+function getDeployCommand3() {
+  return new Base44Command("deploy").description("Deploy realtime handlers to Base44").argument("[names...]", "Handler names to deploy (deploys all if omitted)").action(async (ctx, rawNames) => {
+    const names = parseNames3(rawNames);
+    return deployRealtimeAction(ctx, names);
+  });
+}
+
+// src/cli/commands/realtime/new.ts
+import { dirname as dirname19, join as join23 } from "node:path";
+function buildHandlerScaffold(handlerName) {
+  return `import { RealtimeHandler, type Conn } from "@base44/sdk";
+
+interface State {
+  // shared state broadcast to all clients
+}
+
+interface Message {
+  // messages sent from clients
+}
+
+export class ${handlerName} extends RealtimeHandler<State, Message> {
+  handleConnect(conn: Conn) {
+    console.log("Connected:", conn.userId);
+  }
+  handleMessage(conn: Conn, msg: Message) {
+    console.log("Message:", msg);
+  }
+  handleTick() {}
+  handleClose(conn: Conn) {}
+}
+`;
+}
+async function newRealtimeHandlerAction(_ctx, handlerName) {
+  const { project: project2 } = await readProjectConfig();
+  const realtimeDir = join23(dirname19(project2.configPath), project2.realtimeDir);
+  const handlerDir = join23(realtimeDir, handlerName);
+  if (await pathExists(handlerDir)) {
+    throw new InvalidInputError(`Realtime handler "${handlerName}" already exists at ${handlerDir}`);
+  }
+  const entryPath = join23(handlerDir, "entry.ts");
+  await writeFile(entryPath, buildHandlerScaffold(handlerName));
+  return {
+    outroMessage: `Created realtime handler "${handlerName}" at ${entryPath}`
+  };
+}
+function getNewCommand() {
+  return new Base44Command("new").description("Create a new realtime handler scaffold").argument("<HandlerName>", "Name of the realtime handler class").action(async (ctx, handlerName) => {
+    return newRealtimeHandlerAction(ctx, handlerName);
+  });
+}
+
+// src/cli/commands/realtime/index.ts
+function getRealtimeCommand() {
+  return new Command("realtime").description("Manage realtime handlers").addCommand(getNewCommand()).addCommand(getDeployCommand3());
+}
+
 // src/core/resources/sandbox/schema.ts
 var FileErrorSchema = exports_external.object({
   code: exports_external.string(),
@@ -254559,6 +254675,7 @@ function getSiteCommand() {
 // src/core/types/generator.ts
 var import_common_tags = __toESM(require_lib2(), 1);
 var import_json_schema_to_typescript = __toESM(require_src3(), 1);
+import { join as join26 } from "node:path";
 var HEADER2 = import_common_tags.stripIndent`
   // Auto-generated by Base44 CLI - DO NOT EDIT
   // Regenerate with: base44 types generate
@@ -254567,24 +254684,43 @@ var EMPTY_TEMPLATE = import_common_tags.stripIndent`
   // Auto-generated by Base44 CLI - DO NOT EDIT
   // Regenerate with: base44 types
   //
-  // No entities, functions, agents, or connectors found in project.
-  // Add resources to base44/entities/, base44/functions/, base44/agents/, or base44/connectors/
+  // No entities, functions, agents, connectors, or realtime handlers found in project.
+  // Add resources to base44/entities/, base44/functions/, base44/agents/, base44/connectors/, or base44/realtime/
   // and run \`base44 types generate\` again.
 
   declare module '@base44/sdk' {
     // No types to augment - add resources and regenerate
   }
 `;
+var SDK_PACKAGE_NAMES = ["@base44/sdk", "@base44-preview/sdk"];
+async function detectSdkPackageName(projectRoot) {
+  try {
+    const pkg = await readJsonFile(join26(projectRoot, "package.json"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    for (const name2 of SDK_PACKAGE_NAMES) {
+      if (name2 in deps)
+        return name2;
+    }
+  } catch {}
+  return "@base44/sdk";
+}
 async function generateTypesFile(input) {
   const content = await generateContent(input);
   await writeFile(getTypesOutputPath(input.projectRoot), content);
 }
 async function generateContent(input) {
-  const { entities, functions, agents, connectors } = input;
-  if (!entities.length && !functions.length && !agents.length && !connectors.length) {
+  const { entities, functions, agents, connectors, realtimeHandlers } = input;
+  const sdkPackage = await detectSdkPackageName(input.projectRoot);
+  if (!entities.length && !functions.length && !agents.length && !connectors.length && !realtimeHandlers.length) {
     return EMPTY_TEMPLATE;
   }
-  const entityInterfaces = await Promise.all(entities.map((e8) => compileEntity(e8)));
+  const [entityInterfaces, realtimeRegistryEntries] = await Promise.all([
+    Promise.all(entities.map((e8) => compileEntity(e8))),
+    Promise.all(realtimeHandlers.map((h5) => compileRealtimeHandler(h5)))
+  ]);
   const registryEntries = [
     [
       "EntityTypeRegistry",
@@ -254592,16 +254728,28 @@ async function generateContent(input) {
     ],
     ["FunctionNameRegistry", functions.map((f7) => `"${f7.name}": true;`)],
     ["AgentNameRegistry", agents.map((a5) => `"${a5.name}": true;`)],
-    ["ConnectorTypeRegistry", connectors.map((c8) => `"${c8.type}": true;`)]
+    ["ConnectorTypeRegistry", connectors.map((c8) => `"${c8.type}": true;`)],
+    [
+      "RealtimeHandlerNameRegistry",
+      realtimeHandlers.map((h5) => `"${h5.name}": true;`)
+    ],
+    [
+      "RealtimeHandlerRegistry",
+      realtimeHandlers.filter((h5) => h5.messageSchema).map((h5, _10, _arr) => {
+        const idx = realtimeHandlers.indexOf(h5);
+        return `"${h5.name}": ${realtimeRegistryEntries[idx]};`;
+      })
+    ]
   ];
   const registries2 = registryEntries.filter(([, entries]) => entries.length > 0).map(([name2, entries]) => registry2(name2, entries));
   return [
     HEADER2,
+    "export {};",
     entityInterfaces.join(`
 
 `),
     import_common_tags.source`
-      declare module '@base44/sdk' {
+      declare module '${sdkPackage}' {
         ${registries2.join(`
 
 `)}
@@ -254629,6 +254777,32 @@ async function compileEntity(entity2) {
     throw new TypeGenerationError(`Failed to generate types for entity "${name2}"`, name2, error48);
   }
 }
+async function compileRealtimeHandler(handler) {
+  const { messageSchema } = handler;
+  if (!messageSchema)
+    return "{ inbound: unknown; outbound: unknown }";
+  const compileSchema = async (schema11, typeName) => {
+    if (!schema11)
+      return "unknown";
+    try {
+      const ts8 = await import_json_schema_to_typescript.compile(schema11, typeName, {
+        bannerComment: "",
+        additionalProperties: false,
+        strictIndexSignatures: true
+      });
+      const match = ts8.match(/\{([\s\S]*)\}/);
+      return match ? `{
+${match[1]}}` : "unknown";
+    } catch {
+      return "unknown";
+    }
+  };
+  const [inbound, outbound] = await Promise.all([
+    compileSchema(messageSchema.inbound, `${handler.name}Inbound`),
+    compileSchema(messageSchema.outbound, `${handler.name}Outbound`)
+  ]);
+  return `{ inbound: ${inbound}; outbound: ${outbound} }`;
+}
 function registry2(name2, entries) {
   return import_common_tags.source`
     interface ${name2} {
@@ -254641,10 +254815,10 @@ function toPascalCase(name2) {
   return name2.split(/[-_\s]+/).map((w8) => w8.charAt(0).toUpperCase() + w8.slice(1)).join("");
 }
 // src/core/types/update-project.ts
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 var TYPES_INCLUDE_PATH = `${PROJECT_SUBDIR}/${TYPES_OUTPUT_SUBDIR}/*.d.ts`;
 async function updateProjectConfig(projectRoot) {
-  const tsconfigPath = join26(projectRoot, "tsconfig.json");
+  const tsconfigPath = join27(projectRoot, "tsconfig.json");
   if (!await pathExists(tsconfigPath)) {
     return false;
   }
@@ -254668,14 +254842,15 @@ var TYPES_FILE_PATH = "base44/.types/types.d.ts";
 async function generateTypesAction({
   runTask: runTask2
 }) {
-  const { entities, functions, agents, connectors, project: project2 } = await readProjectConfig();
+  const { entities, functions, agents, connectors, realtimeHandlers, project: project2 } = await readProjectConfig();
   await runTask2("Generating types", async () => {
     await generateTypesFile({
       projectRoot: project2.root,
       entities,
       functions,
       agents,
-      connectors
+      connectors,
+      realtimeHandlers
     });
   });
   const tsconfigUpdated = await updateProjectConfig(project2.root);
@@ -254695,7 +254870,7 @@ function getTypesCommand() {
 // src/cli/dev/dev-server/main.ts
 var import_cors = __toESM(require_lib4(), 1);
 var import_express6 = __toESM(require_express(), 1);
-import { dirname as dirname23, join as join29 } from "node:path";
+import { dirname as dirname24, join as join30 } from "node:path";
 
 // ../../node_modules/get-port/index.js
 import net from "node:net";
@@ -257053,9 +257228,9 @@ class NodeFsHandler {
     if (this.fsw.closed) {
       return;
     }
-    const dirname22 = sp2.dirname(file2);
+    const dirname23 = sp2.dirname(file2);
     const basename8 = sp2.basename(file2);
-    const parent = this.fsw._getWatchedDir(dirname22);
+    const parent = this.fsw._getWatchedDir(dirname23);
     let prevStats = stats;
     if (parent.has(basename8))
       return;
@@ -257082,7 +257257,7 @@ class NodeFsHandler {
             prevStats = newStats2;
           }
         } catch (error48) {
-          this.fsw._remove(dirname22, basename8);
+          this.fsw._remove(dirname23, basename8);
         }
       } else if (parent.has(basename8)) {
         const at13 = newStats.atimeMs;
@@ -258115,8 +258290,8 @@ async function createDevServer(options8) {
     broadcastEntityEvent(io6, appId, entityName, event);
   };
   const base44ConfigWatcher = new WatchBase44({
-    functions: join29(dirname23(project2.configPath), project2.functionsDir),
-    entities: join29(dirname23(project2.configPath), project2.entitiesDir)
+    functions: join30(dirname24(project2.configPath), project2.functionsDir),
+    entities: join30(dirname24(project2.configPath), project2.entitiesDir)
   }, devLogger);
   base44ConfigWatcher.on("change", async (name2) => {
     try {
@@ -258458,7 +258633,7 @@ function createProgram(context) {
   program2.addCommand(getCreateCommand());
   program2.addCommand(getScaffoldCommand());
   program2.addCommand(getDashboardCommand());
-  program2.addCommand(getDeployCommand3());
+  program2.addCommand(getDeployCommand2());
   program2.addCommand(getLinkCommand());
   program2.addCommand(getEjectCommand());
   program2.addCommand(getEntitiesPushCommand());
@@ -258482,7 +258657,7 @@ var import_detect_agent = __toESM(require_dist5(), 1);
 import { release, type } from "node:os";
 
 // ../../node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
-import { dirname as dirname24, posix, sep } from "path";
+import { dirname as dirname25, posix, sep } from "path";
 function createModulerModifier() {
   const getModuleFromFileName = createGetModuleFromFilename();
   return async (frames) => {
@@ -258491,7 +258666,7 @@ function createModulerModifier() {
     return frames;
   };
 }
-function createGetModuleFromFilename(basePath = process.argv[1] ? dirname24(process.argv[1]) : process.cwd(), isWindows5 = sep === "\\") {
+function createGetModuleFromFilename(basePath = process.argv[1] ? dirname25(process.argv[1]) : process.cwd(), isWindows5 = sep === "\\") {
   const normalizedBase = isWindows5 ? normalizeWindowsPath2(basePath) : basePath;
   return (filename) => {
     if (!filename)
@@ -262680,9 +262855,9 @@ function addCommandInfoToErrorReporter(program2, errorReporter) {
   });
 }
 // src/cli/index.ts
-var __dirname4 = dirname25(fileURLToPath6(import.meta.url));
+var __dirname4 = dirname26(fileURLToPath6(import.meta.url));
 async function runCLI(options8) {
-  ensureNpmAssets(join30(__dirname4, "../assets"));
+  ensureNpmAssets(join31(__dirname4, "../assets"));
   const errorReporter = new ErrorReporter;
   errorReporter.registerProcessErrorHandlers();
   const jsonMode = process.argv.includes("--json");
@@ -262721,4 +262896,4 @@ export {
   CLIExitError
 };
 
-//# debugId=C07D776F1F23BE1C64756E2164756E21
+//# debugId=8333EEB4A43A09C964756E2164756E21