playcademy 0.14.33 → 0.14.34

package/dist/index.js

@@ -712,6 +712,7 @@ var GAME_WORKER_DOMAINS = {
   production: "playcademy.gg",
   staging: "staging.playcademy.gg"
 };
+var LOG_COLLECTOR_URL = "https://logs.playcademy.gg";
 
 // ../constants/src/overworld.ts
 var ITEM_SLUGS = {
@@ -3959,7 +3960,7 @@ import { join as join12 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.32",
+  version: "0.14.33",
   type: "module",
   exports: {
     ".": {
@@ -4022,7 +4023,8 @@ var package_default2 = {
     "json-colorizer": "^3.0.1",
     jszip: "^3.10.1",
     miniflare: "^4.20251008.0",
-    open: "^10.2.0"
+    open: "^10.2.0",
+    ws: "^8.18.3"
   },
   devDependencies: {
     "@cloudflare/workers-types": "^4.20251011.0",
@@ -4032,6 +4034,7 @@ var package_default2 = {
     "@playcademy/timeback": "workspace:*",
     "@playcademy/utils": "workspace:*",
     "@types/bun": "latest",
+    "@types/ws": "^8.18.1",
     bumpp: "^10.2.3",
     rollup: "^4.50.2",
     "rollup-plugin-dts": "^6.2.3"
@@ -9421,8 +9424,155 @@ async function uploadFilesLocal(files, prefix, uploadFn) {
   return files.length;
 }
 
+// src/lib/logs/display.ts
+import { blue as blue3, bold as bold7, cyan as cyan7, dim as dim9, gray as gray2, green as green7, red as red5, yellow as yellow5 } from "colorette";
+var LEVEL_COLORS = {
+  log: gray2,
+  info: blue3,
+  warn: yellow5,
+  error: red5,
+  debug: dim9
+};
+var OUTCOME_COLORS = {
+  ok: green7,
+  exception: red5,
+  exceededCpu: red5,
+  exceededMemory: red5,
+  canceled: yellow5,
+  scriptNotFound: red5,
+  unknown: gray2
+};
+function formatTime2(timestamp5) {
+  const date = new Date(timestamp5);
+  return date.toLocaleTimeString("en-US", {
+    hour: "numeric",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: true
+  });
+}
+var HTTP_STATUS_TEXT = {
+  200: "OK",
+  201: "Created",
+  204: "No Content",
+  301: "Moved Permanently",
+  302: "Found",
+  304: "Not Modified",
+  400: "Bad Request",
+  401: "Unauthorized",
+  403: "Forbidden",
+  404: "Not Found",
+  405: "Method Not Allowed",
+  409: "Conflict",
+  422: "Unprocessable Entity",
+  429: "Too Many Requests",
+  500: "Internal Server Error",
+  502: "Bad Gateway",
+  503: "Service Unavailable",
+  504: "Gateway Timeout"
+};
+function formatStatus(status) {
+  const text5 = HTTP_STATUS_TEXT[status] ?? "";
+  const colorFn = status >= 500 ? red5 : status >= 400 ? yellow5 : status >= 300 ? blue3 : status >= 200 ? green7 : gray2;
+  const boldCode = colorFn(bold7(String(status)));
+  return text5 ? `${boldCode} ${colorFn(text5)}` : boldCode;
+}
+function stripLogPrefix(message) {
+  const prefixPattern = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z?\s*)?(LOG|INFO|WARN|ERROR|DEBUG)\s*/i;
+  return message.replace(prefixPattern, "");
+}
+function formatValue(value) {
+  if (typeof value === "string") return stripLogPrefix(value);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (value === null) return "null";
+  if (value === void 0) return "undefined";
+  try {
+    return JSON.stringify(value, null, 2);
+  } catch {
+    return String(value);
+  }
+}
+function displayLogEntry(entry) {
+  const time = dim9(formatTime2(entry.timestamp));
+  const outcomeColor = OUTCOME_COLORS[entry.outcome] ?? gray2;
+  const outcome = outcomeColor(entry.outcome.toUpperCase());
+  if (entry.request) {
+    const method = cyan7(bold7(entry.request.method));
+    const urlObj = new URL(entry.request.url);
+    const url = urlObj.pathname + urlObj.search;
+    const status = entry.response?.status;
+    let statusPart = "";
+    if (status) {
+      statusPart = formatStatus(status);
+      if (entry.outcome !== "ok") {
+        statusPart += ` ${outcome}`;
+      }
+    } else {
+      statusPart = outcome;
+    }
+    logger.raw(`${time} ${method} ${url} ${statusPart}`);
+  }
+  for (const log2 of entry.logs) {
+    const levelColor = LEVEL_COLORS[log2.level] ?? gray2;
+    const level = levelColor(bold7(log2.level.toUpperCase()));
+    const message = log2.message.map(formatValue).join(" ");
+    logger.raw(`${time} ${level} ${message}`);
+  }
+  for (const exception of entry.exceptions) {
+    const level = red5(bold7("ERROR"));
+    logger.raw(`${time} ${level} ${exception.name}: ${exception.message}`);
+  }
+}
+
+// src/lib/logs/stream.ts
+import WebSocket from "ws";
+function buildLogStreamUrl(options) {
+  const { workerId, token, history } = options;
+  const wsBaseUrl = LOG_COLLECTOR_URL.replace("https://", "wss://");
+  const url = new URL(`${wsBaseUrl}/logs/${workerId}/stream`);
+  url.searchParams.set("token", token);
+  if (history) url.searchParams.set("history", "true");
+  return url.toString();
+}
+async function connectToLogStream(config) {
+  const { url, slug, environment } = config;
+  const ws = new WebSocket(url);
+  ws.on("open", () => {
+    logger.success(`Connected to ${environment} logs for "${slug}"`);
+    logger.newLine();
+    logger.dim("Press ctrl+c to stop", 1);
+    logger.newLine();
+  });
+  ws.on("message", (data) => {
+    try {
+      const entry = JSON.parse(data.toString());
+      displayLogEntry(entry);
+    } catch {
+      logger.raw(data.toString());
+    }
+  });
+  ws.on("error", (error) => {
+    logger.newLine();
+    logger.error(`WebSocket error: ${error.message}`);
+    process.exit(1);
+  });
+  ws.on("close", (code, reason) => {
+    logger.newLine();
+    if (code !== 1e3) {
+      logger.warn(`Connection closed: ${code} ${reason.toString()}`);
+    }
+    process.exit(0);
+  });
+  process.on("SIGINT", () => {
+    logger.newLine();
+    ws.close(1e3, "User interrupted");
+  });
+  await new Promise(() => {
+  });
+}
+
 // src/lib/timeback/display.ts
-import { bold as bold7, greenBright as greenBright2, redBright as redBright2 } from "colorette";
+import { bold as bold8, greenBright as greenBright2, redBright as redBright2 } from "colorette";
 function displayIntegrationDetails(integration) {
   logger.highlight("Verified Course");
   logger.newLine();
@@ -9459,9 +9609,9 @@ function displayIntegrationList(integrations, statusByCourseId, options) {
     if (showStatusColumn) {
       if (options?.staticLabel) {
         const coloredLabel = options.staticLabelColor ? options.staticLabelColor(options.staticLabel) : greenBright2(options.staticLabel);
-        statusText = bold7(coloredLabel);
+        statusText = bold8(coloredLabel);
       } else if (statusByCourseId && integration.courseId in statusByCourseId) {
-        statusText = statusByCourseId[integration.courseId] ? bold7(greenBright2(successLabel)) : bold7(redBright2(failureLabel));
+        statusText = statusByCourseId[integration.courseId] ? bold8(greenBright2(successLabel)) : bold8(redBright2(failureLabel));
       }
     }
     const row = {
@@ -9495,7 +9645,7 @@ function displayCleanupWarning(integrations, gameName, logger2) {
 }
 
 // src/lib/timeback/setup.ts
-import { bold as bold8 } from "colorette";
+import { bold as bold9 } from "colorette";
 function displaySetupDryRun(derivedRequest, env, logger2) {
   logger2.highlight("TimeBack Setup [DRY RUN]");
   logger2.newLine();
@@ -9525,7 +9675,7 @@ function displaySetupDryRun(derivedRequest, env, logger2) {
   logger2.admonition("tip", "Ready for setup", [
     "Your Timeback configuration has been validated!",
     "",
-    `Run without \`--dry-run\` to create ${bold8(`${derivedRequest.courses.length} course(s)`)} in ${bold8(env || "staging")}`
+    `Run without \`--dry-run\` to create ${bold9(`${derivedRequest.courses.length} course(s)`)} in ${bold9(env || "staging")}`
   ]);
   logger2.newLine();
 }
@@ -9631,7 +9781,7 @@ function displayVerificationSummary(result, options) {
 }
 
 // src/lib/domains/display.ts
-import { cyanBright, gray as gray2, greenBright as greenBright3, redBright as redBright3, yellowBright as yellowBright2 } from "colorette";
+import { cyanBright, gray as gray3, greenBright as greenBright3, redBright as redBright3, yellowBright as yellowBright2 } from "colorette";
 function colorizeStatus(status) {
   switch (status) {
     case "active":
@@ -9648,7 +9798,7 @@ function colorizeStatus(status) {
     case "pending_deletion":
       return redBright3(status);
     default:
-      return gray2(status);
+      return gray3(status);
   }
 }
 function displayDomainStatus(hostname, domain) {
@@ -9906,7 +10056,7 @@ initCommand.addCommand(configCommand);
 // src/commands/login.ts
 import { userInfo } from "os";
 import { input as input4, password, select as select6 } from "@inquirer/prompts";
-import { bold as bold9, dim as dim9, whiteBright } from "colorette";
+import { bold as bold10, dim as dim10, whiteBright } from "colorette";
 import { Command as Command3 } from "commander";
 import open from "open";
 var loginCommand = new Command3("login").description("Authenticate with Playcademy").option("-e, --email <email>", "Email address (for email/password auth)").option("-p, --password <password>", "Password (for email/password auth)").option("--sso", "Use Timeback SSO authentication").option("--env <environment>", "Environment to login to (staging or production)").action(async (options) => {
@@ -9920,12 +10070,12 @@ var loginCommand = new Command3("login").description("Authenticate with Playcade
     const otherEnv = environment === "staging" ? "production" : "staging";
     const otherProfile = await getProfile(otherEnv, profileName);
     logger.admonition("note", "Hello again", [
-      bold9("You're already logged in"),
+      bold10("You're already logged in"),
       "",
-      dim9("Email: ") + bold9(email2),
-      dim9("Environment: ") + bold9(environment),
-      dim9("Profile: ") + bold9(profileName),
-      ...otherProfile ? [dim9("Other Profile: ") + bold9(otherEnv)] : []
+      dim10("Email: ") + bold10(email2),
+      dim10("Environment: ") + bold10(environment),
+      dim10("Profile: ") + bold10(profileName),
+      ...otherProfile ? [dim10("Other Profile: ") + bold10(otherEnv)] : []
     ]);
     logger.newLine();
     return;
@@ -10057,7 +10207,7 @@ async function handleSsoLogin(environment, profileName) {
     logger.admonition("warning", "Your API Key", [
       "Save this key securely - it will not be shown again!",
       "",
-      whiteBright(bold9(apiKeyResult.apiKey))
+      whiteBright(bold10(apiKeyResult.apiKey))
     ]);
     logger.newLine();
     await runStep(
@@ -10123,9 +10273,53 @@ var logoutCommand = new Command4("logout").description("Log out from Playcademy"
   }
 });
 
-// src/commands/me/index.ts
+// src/commands/logs/index.ts
 import { Command as Command5 } from "commander";
-var meCommand = new Command5("me").description("Display current user information").option(
+import { ApiError as ApiError4 } from "@playcademy/sdk/internal";
+async function runLogs(slugArg, options) {
+  try {
+    logger.newLine();
+    const environment = ensureEnvironment(options.env);
+    let slug;
+    if (slugArg) {
+      slug = slugArg;
+    } else {
+      try {
+        await findConfigPath();
+        const config = await loadConfig();
+        slug = getSlugFromConfig(config);
+      } catch {
+        logger.error("No slug provided and no config file found");
+        logger.newLine();
+        process.exit(1);
+      }
+    }
+    const client = await requireAuthenticatedClient();
+    let token;
+    let workerId;
+    try {
+      const result = await client.dev.games.logs.getToken(slug, environment);
+      token = result.token;
+      workerId = result.workerId;
+    } catch (error) {
+      if (error instanceof ApiError4 && error.status === 404) {
+        logger.error(`Project not found: "${slug}"`);
+        logger.newLine();
+        process.exit(1);
+      }
+      throw error;
+    }
+    const url = buildLogStreamUrl({ workerId, token, history: options.history });
+    await connectToLogStream({ url, slug, environment });
+  } catch (error) {
+    logAndExit(error, { prefix: "Failed to stream logs" });
+  }
+}
+var logsCommand = new Command5("logs").description("Stream real-time logs from a deployed app").argument("[slug]", "Game slug (uses config file if not provided)").option("--env <environment>", "Environment (production or staging)").option("--history", "Include recent log history (default: false)").action(runLogs);
+
+// src/commands/me/index.ts
+import { Command as Command6 } from "commander";
+var meCommand = new Command6("me").description("Display current user information").option(
   "--env <environment>",
   "Environment to check user information from (staging or production)"
 ).action(async (options) => {
@@ -10165,21 +10359,21 @@ var meCommand = new Command5("me").description("Display current user information
 
 // src/commands/update/index.ts
 import { execSync as execSync8 } from "child_process";
-import { bold as bold10 } from "colorette";
-import { Command as Command6 } from "commander";
+import { bold as bold11 } from "colorette";
+import { Command as Command7 } from "commander";
 var updateCommands = {
   bun: "bun install -g playcademy@latest",
   npm: "npm install -g playcademy@latest",
   pnpm: "pnpm add -g playcademy@latest",
   yarn: "yarn global add playcademy@latest"
 };
-var updateCommand = new Command6("update").description("Update the Playcademy CLI to the latest version").action(async () => {
+var updateCommand = new Command7("update").description("Update the Playcademy CLI to the latest version").action(async () => {
   const runnerPath = executorIsPackageRunner();
   if (runnerPath) {
     const runnerName = getPackageRunnerName(runnerPath);
     logger.newLine();
     logger.admonition("info", "Package Runner Detected", [
-      `You are running the CLI via package runner (${bold10(runnerName)}).`,
+      `You are running the CLI via package runner (${bold11(runnerName)}).`,
       "",
       "Package runners use the latest version of the CLI by default, but may cache older versions.",
       `To ensure you run the package's latest version: \`${runnerName} playcademy@latest\``
@@ -10205,7 +10399,7 @@ var updateCommand = new Command6("update").description("Update the Playcademy CL
 });
 
 // src/commands/deploy/index.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 async function executeDeployment(plan, context2, environment) {
   const result = await deployGame(context2, plan.shouldUploadBuild, plan.shouldDeployBackend);
   const game = result.game;
@@ -10267,7 +10461,7 @@ async function runDeployment(options) {
     reportDeploymentSuccess(result, context2);
   }
 }
-var deployCommand = new Command7("deploy").description("Deploy your project to Playcademy").option("-c, --config <path>", "Path to configuration file").option("-n, --name <name>", "Display name").option("-d, --description <desc>", "App description").option("-e, --emoji <emoji>", "App emoji").option("-b, --build <path>", "Path to zip file").option("--env <environment>", "Deployment environment (production or staging)").option("--backend", "Deploy backend (API routes + database + integrations)").option("--no-backend", "Skip backend deployment").option("--force-backend", "Force backend deployment even if no changes detected").option("--dry-run", "Validate configuration without deploying").option("-v, --verbose", "Show verbose output").option("--debug", "Show debug information (change detection, hashes, etc.)").action(async (options) => {
+var deployCommand = new Command8("deploy").description("Deploy your project to Playcademy").option("-c, --config <path>", "Path to configuration file").option("-n, --name <name>", "Display name").option("-d, --description <desc>", "App description").option("-e, --emoji <emoji>", "App emoji").option("-b, --build <path>", "Path to zip file").option("--env <environment>", "Deployment environment (production or staging)").option("--backend", "Deploy backend (API routes + database + integrations)").option("--no-backend", "Skip backend deployment").option("--force-backend", "Force backend deployment even if no changes detected").option("--dry-run", "Validate configuration without deploying").option("-v, --verbose", "Show verbose output").option("--debug", "Show debug information (change detection, hashes, etc.)").action(async (options) => {
   try {
     await runDeployment(options);
   } catch (error) {
@@ -10281,12 +10475,12 @@ var deployCommand = new Command7("deploy").description("Deploy your project to P
 });
 
 // src/commands/projects/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/commands/projects/delete.ts
 import { confirm as confirm7, input as input5, select as select7 } from "@inquirer/prompts";
-import { Command as Command8 } from "commander";
-var deleteCommand = new Command8("delete").alias("rm").alias("remove").description("Delete a project").argument("[slug]", "Project slug to delete").option("-f, --force", "Skip confirmation prompt").option("--env <environment>", "Environment to delete project from (staging or production)").action(async (slug, options) => {
+import { Command as Command9 } from "commander";
+var deleteCommand = new Command9("delete").alias("rm").alias("remove").description("Delete a project").argument("[slug]", "Project slug to delete").option("-f, --force", "Skip confirmation prompt").option("--env <environment>", "Environment to delete project from (staging or production)").action(async (slug, options) => {
   const { env } = options;
   try {
     const environment = ensureEnvironment(env);
@@ -10378,8 +10572,8 @@ var deleteCommand = new Command8("delete").alias("rm").alias("remove").descripti
 });
 
 // src/commands/projects/list.ts
-import { Command as Command9 } from "commander";
-var listCommand = new Command9("list").alias("ls").description("List your projects").option("--env <environment>", "Environment to list projects from (staging or production)").action(async (options) => {
+import { Command as Command10 } from "commander";
+var listCommand = new Command10("list").alias("ls").description("List your projects").option("--env <environment>", "Environment to list projects from (staging or production)").action(async (options) => {
   const { env } = options;
   try {
     const environment = ensureEnvironment(env);
@@ -10413,16 +10607,16 @@ var listCommand = new Command9("list").alias("ls").description("List your projec
 });
 
 // src/commands/projects/index.ts
-var projectsCommand = new Command10("projects").description("Manage deployed projects");
+var projectsCommand = new Command11("projects").description("Manage deployed projects");
 projectsCommand.addCommand(listCommand);
 projectsCommand.addCommand(deleteCommand);
 
 // src/commands/dev/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/commands/dev/apply.ts
-import { Command as Command11 } from "commander";
-var applyCommand = new Command11("apply").description("Apply for developer status").option(
+import { Command as Command12 } from "commander";
+var applyCommand = new Command12("apply").description("Apply for developer status").option(
   "--env <environment>",
   "Environment to apply for developer status in (staging or production)"
 ).action(async (options) => {
@@ -10473,8 +10667,8 @@ var applyCommand = new Command11("apply").description("Apply for developer statu
 });
 
 // src/commands/dev/get-status.ts
-import { Command as Command12 } from "commander";
-var getStatusCommand = new Command12("status").description("Check your developer status").option(
+import { Command as Command13 } from "commander";
+var getStatusCommand = new Command13("status").description("Check your developer status").option(
   "--env <environment>",
   "Environment to check developer status from (staging or production)"
 ).action(async (options) => {
@@ -10517,7 +10711,7 @@ var getStatusCommand = new Command12("status").description("Check your developer
 });
 
 // package.json
-var version2 = "0.14.32";
+var version2 = "0.14.33";
 
 // src/commands/dev/server.ts
 function setupCleanupHandlers(workspace, getServer) {
@@ -10603,12 +10797,12 @@ async function runDevServer(options) {
 }
 
 // src/commands/dev/index.ts
-var devCommand = new Command13("dev").description("Start local backend development server").option("-p, --port <port>", "Backend server port", String(DEFAULT_PORTS.BACKEND)).option("--no-reload", "Disable hot reload").option("--no-logger", "Disable HTTP request logging").option("-q, --quiet", "Quiet mode").action(runDevServer);
+var devCommand = new Command14("dev").description("Start local backend development server").option("-p, --port <port>", "Backend server port", String(DEFAULT_PORTS.BACKEND)).option("--no-reload", "Disable hot reload").option("--no-logger", "Disable HTTP request logging").option("-q, --quiet", "Quiet mode").action(runDevServer);
 devCommand.addCommand(applyCommand);
 devCommand.addCommand(getStatusCommand);
 
 // src/commands/api/index.ts
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 
 // src/commands/api/init.ts
 import { input as input6 } from "@inquirer/prompts";
@@ -10697,19 +10891,19 @@ async function runApiInit() {
 }
 
 // src/commands/api/index.ts
-var apiCommand = new Command14("api").description("Custom API routes management");
+var apiCommand = new Command15("api").description("Custom API routes management");
 apiCommand.command("init").description("Add custom API routes to your project").action(runApiInit);
 
 // src/commands/auth/index.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 
 // src/commands/auth/add.ts
 init_file_loader();
 import { writeFileSync as writeFileSync14 } from "fs";
 import { join as join35 } from "path";
-import { bold as bold11 } from "colorette";
-import { Command as Command15 } from "commander";
-var addAuthCommand = new Command15("add").description("Add an authentication provider to your project").argument("<provider>", "Provider to add: email | github | google").addHelpText(
+import { bold as bold12 } from "colorette";
+import { Command as Command16 } from "commander";
+var addAuthCommand = new Command16("add").description("Add an authentication provider to your project").argument("<provider>", "Provider to add: email | github | google").addHelpText(
   "after",
   `
 Examples:
@@ -10775,16 +10969,16 @@ Examples:
         PLACEHOLDER_APP_URL
       ).replace("{provider}", provider);
       logger.admonition("tip", "Next Steps", [
-        bold11(`1. Add callback URL to your ${providerDisplayName} OAuth app:`),
+        bold12(`1. Add callback URL to your ${providerDisplayName} OAuth app:`),
         "",
         `   <${callbackUrl}>`,
         "",
-        bold11("2. Add credentials to <.env> (for local development):"),
+        bold12("2. Add credentials to <.env> (for local development):"),
         "",
         `   \`${provider.toUpperCase()}_CLIENT_ID=[your-id]\``,
         `   \`${provider.toUpperCase()}_CLIENT_SECRET=[your-secret]\``,
         "",
-        bold11("3. Set production secrets (for deployment):"),
+        bold12("3. Set production secrets (for deployment):"),
         "",
         `   \`playcademy secret set ${provider.toUpperCase()}_CLIENT_ID=[your-id]\``,
         `   \`playcademy secret set ${provider.toUpperCase()}_CLIENT_SECRET=[your-secret]\``
@@ -10799,9 +10993,9 @@ Examples:
 
 // src/commands/auth/init.ts
 import { confirm as confirm8 } from "@inquirer/prompts";
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 var sampleCustomRouteTemplate2 = loadTemplateString("api/sample-custom.ts");
-var initAuthCommand = new Command16("init").description("Add authentication to your project").action(async () => {
+var initAuthCommand = new Command17("init").description("Add authentication to your project").action(async () => {
   try {
     logger.newLine();
     const configPath = await requireConfigFile();
@@ -10903,14 +11097,14 @@ var initAuthCommand = new Command16("init").description("Add authentication to y
 });
 
 // src/commands/auth/index.ts
-var authCommand = new Command17("auth").description("Manage authentication for your project").action(() => {
+var authCommand = new Command18("auth").description("Manage authentication for your project").action(() => {
   authCommand.help();
 });
 authCommand.addCommand(initAuthCommand);
 authCommand.addCommand(addAuthCommand);
 
 // src/commands/db/index.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 
 // src/commands/db/diff.ts
 async function runDbDiff() {
@@ -11028,7 +11222,7 @@ async function runDbInit() {
 import { existsSync as existsSync25 } from "fs";
 import { join as join36 } from "path";
 import { confirm as confirm9, input as input8 } from "@inquirer/prompts";
-import { bold as bold12, redBright as redBright4, underline as underline3 } from "colorette";
+import { bold as bold13, redBright as redBright4, underline as underline3 } from "colorette";
 import { Miniflare as Miniflare2 } from "miniflare";
 async function runDbResetRemote(options) {
   const environment = ensureEnvironment(options.env);
@@ -11046,9 +11240,9 @@ async function runDbResetRemote(options) {
   const game = await client.games.fetch(deployedGame.gameId);
   logger.newLine();
   logger.admonition("warning", "DESTRUCTIVE OPERATION", [
-    `Are you sure you want to ${redBright4(underline3(bold12("DELETE ALL DATA")))} in your ${environment} database?`,
+    `Are you sure you want to ${redBright4(underline3(bold13("DELETE ALL DATA")))} in your ${environment} database?`,
     `All tables will be dropped and recreated from schema.`,
-    `This action is irreversible and ${underline3(bold12("cannot be undone"))}.`
+    `This action is irreversible and ${underline3(bold13("cannot be undone"))}.`
   ]);
   logger.newLine();
   const confirmed = await confirm9({
@@ -11215,7 +11409,7 @@ async function runDbSchema(options = {}) {
 import { existsSync as existsSync26 } from "fs";
 import { join as join37 } from "path";
 import { confirm as confirm10, input as input9 } from "@inquirer/prompts";
-import { bold as bold13, dim as dim10, redBright as redBright5, underline as underline4 } from "colorette";
+import { bold as bold14, dim as dim11, redBright as redBright5, underline as underline4 } from "colorette";
 import { Miniflare as Miniflare3 } from "miniflare";
 async function runDbResetRemote2(gameSlug, environment) {
   const client = await requireAuthenticatedClient();
@@ -11259,8 +11453,8 @@ async function runDbSeedRemote(seedFile, options) {
   logger.newLine();
   if (willReset) {
     logger.admonition("warning", "Remote Database Seeding", [
-      `Are you sure you want to ${redBright5(underline4(bold13("DELETE ALL DATA")))} in your ${environment} database?`,
-      `This action is irreversible and ${underline4(bold13("cannot be undone"))}.`,
+      `Are you sure you want to ${redBright5(underline4(bold14("DELETE ALL DATA")))} in your ${environment} database?`,
+      `This action is irreversible and ${underline4(bold14("cannot be undone"))}.`,
       `Run this command with \`--no-reset\` if you want to seed without resetting.`
     ]);
   } else {
@@ -11345,7 +11539,7 @@ async function runDbSeedRemote(seedFile, options) {
       displaySeedLogs(seedResult.logs, "error");
     }
     logger.newLine();
-    logger.error(`Seeding failed ${dim10(`[${Math.round(duration)}ms]`)}`);
+    logger.error(`Seeding failed ${dim11(`[${Math.round(duration)}ms]`)}`);
     logger.newLine();
     process.exit(1);
   }
@@ -11355,7 +11549,7 @@ async function runDbSeedRemote(seedFile, options) {
   }
   logger.newLine();
   logger.success(
-    `${capitalize(environment)} database seeded ${dim10(`[${Math.round(duration)}ms]`)}`
+    `${capitalize(environment)} database seeded ${dim11(`[${Math.round(duration)}ms]`)}`
   );
   logger.newLine();
 }
@@ -11440,7 +11634,7 @@ async function runDbSeed(options = {}) {
 }
 
 // src/commands/db/index.ts
-var dbCommand = new Command18("db").description("Database management commands");
+var dbCommand = new Command19("db").description("Database management commands");
 dbCommand.command("init").description("Add database to your project").action(runDbInit);
 dbCommand.command("reset").description("Reset database").option("--remote", "Reset remote deployed database").option("--env <environment>", "Environment: staging (default) or production").option("-f, --force", "Skip confirmation prompt (local only)").option("--debug", "Enable debug mode").action(
   (options) => runDbReset({
@@ -11463,7 +11657,7 @@ dbCommand.command("diff").description("Show schema changes since last deployment
 dbCommand.command("schema").description("Print full schema SQL that would be pushed after reset").option("--raw", "Output raw SQL only (for piping to files)").option("--full", "Show full schema hash").action((options) => runDbSchema({ raw: options.raw, full: options.full }));
 
 // src/commands/kv/index.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 
 // src/commands/kv/clear.ts
 import { join as join38 } from "path";
@@ -12400,7 +12594,7 @@ async function runKVStats(options = {}) {
 }
 
 // src/commands/kv/index.ts
-var kvCommand = new Command19("kv").description("Manage KV storage integration").action(() => {
+var kvCommand = new Command20("kv").description("Manage KV storage integration").action(() => {
   kvCommand.help();
 });
 kvCommand.command("init").description("Add KV storage integration to your project").action(runKVInit);
@@ -12438,7 +12632,7 @@ kvCommand.command("seed <file>").description("Seed KV namespace with key-value p
 ).action(runKVSeed);
 
 // src/commands/bucket/index.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 
 // src/commands/bucket/bulk.ts
 import { existsSync as existsSync27, statSync as statSync3 } from "fs";
@@ -13250,7 +13444,7 @@ async function runBucketPut(key, filePath, options = {}) {
 }
 
 // src/commands/bucket/index.ts
-var bucketCommand = new Command20("bucket").description("Manage bucket storage integration").action(() => {
+var bucketCommand = new Command21("bucket").description("Manage bucket storage integration").action(() => {
   bucketCommand.help();
 });
 bucketCommand.command("init").description("Add bucket storage integration to your project").action(runBucketInit);
@@ -13284,7 +13478,7 @@ bucketCommand.command("bulk <directory>").description(
 ).action(runBucketBulk);
 
 // src/commands/domain/index.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 
 // src/commands/domain/add.ts
 import { underline as underline5 } from "colorette";
@@ -13480,19 +13674,19 @@ async function runDomainVerify(hostname, options) {
 }
 
 // src/commands/domain/index.ts
-var domainCommand = new Command21("domain").description("Custom domain management");
+var domainCommand = new Command22("domain").description("Custom domain management");
 domainCommand.command("add <hostname>").description("Add a custom domain to your project").option("--env <env>", "Environment (staging or production)", "staging").action(runDomainAdd);
 domainCommand.command("list").description("List custom domains for your project").option("--env <env>", "Environment (staging or production)", "staging").option("--json", "Output as JSON").option("--raw", "Output hostnames only").alias("ls").action(runDomainList);
 domainCommand.command("verify <hostname>").description("Check custom domain validation status").option("--env <env>", "Environment (staging or production)", "staging").option("--json", "Output as JSON").option("--refresh", "Re-trigger domain validation", false).alias("status").action(runDomainVerify);
 domainCommand.command("delete <hostname>").description("Remove a custom domain").option("--env <env>", "Environment (staging or production)", "staging").option("-f, --force", "Skip confirmation prompt").alias("rm").alias("remove").action(runDomainDelete);
 
 // src/commands/secret/index.ts
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 
 // src/commands/secret/delete.ts
 import { confirm as confirm14 } from "@inquirer/prompts";
-import { Command as Command22 } from "commander";
-var deleteCommand2 = new Command22("delete").description("Delete a project secret").argument("<key>", "Secret key to delete").option("--env <environment>", "Environment (staging or production)").option("-f, --force", "Skip confirmation").option("--no-deploy", "Skip deployment prompt").action(async (key, options) => {
+import { Command as Command23 } from "commander";
+var deleteCommand2 = new Command23("delete").description("Delete a project secret").argument("<key>", "Secret key to delete").option("--env <environment>", "Environment (staging or production)").option("-f, --force", "Skip confirmation").option("--no-deploy", "Skip deployment prompt").action(async (key, options) => {
   const { env, deploy: shouldPromptDeploy = true } = options;
   try {
     const environment = ensureEnvironment(env);
@@ -13564,8 +13758,8 @@ var deleteCommand2 = new Command22("delete").description("Delete a project secre
 });
 
 // src/commands/secret/list.ts
-import { Command as Command23 } from "commander";
-var listCommand2 = new Command23("list").description("List project secret keys").option("--env <environment>", "Environment (staging or production)").action(async (options) => {
+import { Command as Command24 } from "commander";
+var listCommand2 = new Command24("list").description("List project secret keys").option("--env <environment>", "Environment (staging or production)").action(async (options) => {
   const { env } = options;
   try {
     const environment = ensureEnvironment(env);
@@ -13613,8 +13807,8 @@ var listCommand2 = new Command23("list").description("List project secret keys")
 
 // src/commands/secret/set.ts
 import { confirm as confirm15 } from "@inquirer/prompts";
-import { Command as Command24 } from "commander";
-var setCommand = new Command24("set").description("Set or update a project secret").argument("<key>", "Secret key (e.g., STRIPE_KEY)").argument("<value>", "Secret value").option("--env <environment>", "Environment (staging or production)").option("--no-deploy", "Skip deployment prompt").action(async (key, value, options) => {
+import { Command as Command25 } from "commander";
+var setCommand = new Command25("set").description("Set or update a project secret").argument("<key>", "Secret key (e.g., STRIPE_KEY)").argument("<value>", "Secret value").option("--env <environment>", "Environment (staging or production)").option("--no-deploy", "Skip deployment prompt").action(async (key, value, options) => {
   const { env, deploy: shouldPromptDeploy = true } = options;
   try {
     const environment = ensureEnvironment(env);
@@ -13674,11 +13868,11 @@ var setCommand = new Command24("set").description("Set or update a project secre
 });
 
 // src/commands/secret/index.ts
-var secretCommand = new Command25("secrets").description("Manage project secrets").addCommand(setCommand).addCommand(listCommand2).addCommand(deleteCommand2);
+var secretCommand = new Command26("secrets").description("Manage project secrets").addCommand(setCommand).addCommand(listCommand2).addCommand(deleteCommand2);
 
 // src/commands/types/index.ts
-import { Command as Command26 } from "commander";
-var typesCommand = new Command26("types").description("Generate TypeScript type definitions").action(async () => {
+import { Command as Command27 } from "commander";
+var typesCommand = new Command27("types").description("Generate TypeScript type definitions").action(async () => {
   try {
     logger.newLine();
     await runStep(
@@ -13693,10 +13887,10 @@ var typesCommand = new Command26("types").description("Generate TypeScript type
 });
 
 // src/commands/profiles/index.ts
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 
 // src/commands/profiles/list.ts
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 async function listProfilesAction() {
   try {
     const profilesMap = await listProfiles();
@@ -13738,12 +13932,12 @@ async function listProfilesAction() {
     process.exit(1);
   }
 }
-var listCommand3 = new Command27("list").alias("ls").description("List all stored authentication profiles").action(listProfilesAction);
+var listCommand3 = new Command28("list").alias("ls").description("List all stored authentication profiles").action(listProfilesAction);
 
 // src/commands/profiles/remove.ts
-import { bold as bold14 } from "colorette";
-import { Command as Command28 } from "commander";
-var removeCommand = new Command28("remove").alias("rm").description('Remove an authentication profile (defaults to "default")').argument("[name]", "Profile name to remove", "default").option("--env <environment>", "Environment to remove profile from (staging or production)").action(async (name, options) => {
+import { bold as bold15 } from "colorette";
+import { Command as Command29 } from "commander";
+var removeCommand = new Command29("remove").alias("rm").description('Remove an authentication profile (defaults to "default")').argument("[name]", "Profile name to remove", "default").option("--env <environment>", "Environment to remove profile from (staging or production)").action(async (name, options) => {
   const { env } = options;
   const environment = ensureEnvironment(env);
   try {
@@ -13757,7 +13951,7 @@ var removeCommand = new Command28("remove").alias("rm").description('Remove an a
     }
     await removeProfile(environment, name);
     logger.admonition("note", "Removed!", [
-      `Profile ${bold14(name)} removed from ${environment}`,
+      `Profile ${bold15(name)} removed from ${environment}`,
       environment === "production" ? `To re-authenticate run \`playcademy login --env ${environment}\`` : "To re-authenticate run `playcademy login`"
     ]);
     logger.newLine();
@@ -13768,8 +13962,8 @@ var removeCommand = new Command28("remove").alias("rm").description('Remove an a
 
 // src/commands/profiles/reset.ts
 import { confirm as confirm16 } from "@inquirer/prompts";
-import { Command as Command29 } from "commander";
-var resetCommand = new Command29("reset").description(
+import { Command as Command30 } from "commander";
+var resetCommand = new Command30("reset").description(
   "Remove all authentication profiles across all environments (requires confirmation)"
 ).alias("clear").action(async () => {
   try {
@@ -13845,18 +14039,18 @@ var resetCommand = new Command29("reset").description(
 });
 
 // src/commands/profiles/index.ts
-var profilesCommand = new Command30("profiles").description("Manage authentication profiles").action(listProfilesAction);
+var profilesCommand = new Command31("profiles").description("Manage authentication profiles").action(listProfilesAction);
 profilesCommand.addCommand(listCommand3);
 profilesCommand.addCommand(removeCommand);
 profilesCommand.addCommand(resetCommand);
 
 // src/commands/timeback/index.ts
-import { Command as Command36 } from "commander";
+import { Command as Command37 } from "commander";
 
 // src/commands/timeback/cleanup.ts
 import { confirm as confirm17 } from "@inquirer/prompts";
-import { Command as Command31 } from "commander";
-var cleanupCommand = new Command31("cleanup").description("Remove TimeBack integration from your project").option(
+import { Command as Command32 } from "commander";
+var cleanupCommand = new Command32("cleanup").description("Remove TimeBack integration from your project").option(
   "--env <environment>",
   "Environment to remove TimeBack integration from (staging or production)"
 ).action(async (options) => {
@@ -13908,8 +14102,8 @@ var cleanupCommand = new Command31("cleanup").description("Remove TimeBack integ
 });
 
 // src/commands/timeback/init.ts
-import { Command as Command32 } from "commander";
-var initCommand2 = new Command32("init").description("Add TimeBack integration to your project").action(async () => {
+import { Command as Command33 } from "commander";
+var initCommand2 = new Command33("init").description("Add TimeBack integration to your project").action(async () => {
   try {
     logger.newLine();
     const configPath = await requireConfigFile();
@@ -13958,8 +14152,8 @@ var initCommand2 = new Command32("init").description("Add TimeBack integration t
 });
 
 // src/commands/timeback/setup.ts
-import { Command as Command33 } from "commander";
-var setupCommand = new Command33("setup").description("Set up TimeBack integration for your project").option("--dry-run", "Validate configuration without creating resources").option("--verbose, -v", "Output detailed information").option(
+import { Command as Command34 } from "commander";
+var setupCommand = new Command34("setup").description("Set up TimeBack integration for your project").option("--dry-run", "Validate configuration without creating resources").option("--verbose, -v", "Output detailed information").option(
   "--env <environment>",
   "Environment to set up TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -14043,8 +14237,8 @@ var setupCommand = new Command33("setup").description("Set up TimeBack integrati
 });
 
 // src/commands/timeback/update.ts
-import { Command as Command34 } from "commander";
-var updateCommand2 = new Command34("update").description("Update TimeBack integration configuration for your project").option("--verbose, -v", "Output detailed information").option(
+import { Command as Command35 } from "commander";
+var updateCommand2 = new Command35("update").description("Update TimeBack integration configuration for your project").option("--verbose, -v", "Output detailed information").option(
   "--env <environment>",
   "Environment to update TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -14104,8 +14298,8 @@ var updateCommand2 = new Command34("update").description("Update TimeBack integr
 });
 
 // src/commands/timeback/verify.ts
-import { Command as Command35 } from "commander";
-var verifyCommand = new Command35("verify").description("Verify TimeBack integration for your project").option("--verbose, -v", "Output detailed resource information").option(
+import { Command as Command36 } from "commander";
+var verifyCommand = new Command36("verify").description("Verify TimeBack integration for your project").option("--verbose, -v", "Output detailed resource information").option(
   "--env <environment>",
   "Environment to verify TimeBack integration in (staging or production)"
 ).action(async (options) => {
@@ -14150,7 +14344,7 @@ var verifyCommand = new Command35("verify").description("Verify TimeBack integra
 });
 
 // src/commands/timeback/index.ts
-var timebackCommand = new Command36("timeback").description(
+var timebackCommand = new Command37("timeback").description(
   "TimeBack integration management"
 );
 timebackCommand.addCommand(initCommand2);
@@ -14160,13 +14354,13 @@ timebackCommand.addCommand(verifyCommand);
 timebackCommand.addCommand(cleanupCommand);
 
 // src/commands/debug/index.ts
-import { Command as Command38 } from "commander";
+import { Command as Command39 } from "commander";
 
 // src/commands/debug/bundle.ts
 import { writeFileSync as writeFileSync16 } from "fs";
 import { join as join51 } from "path";
-import { Command as Command37 } from "commander";
-var bundleCommand = new Command37("bundle").description("Bundle and inspect the project backend worker code (for debugging)").option("-o, --output <path>", "Output file path", CLI_DEFAULT_OUTPUTS.WORKER_BUNDLE).option("--minify", "Minify the output").option("--sourcemap", "Include source maps").action(async (options) => {
+import { Command as Command38 } from "commander";
+var bundleCommand = new Command38("bundle").description("Bundle and inspect the project backend worker code (for debugging)").option("-o, --output <path>", "Output file path", CLI_DEFAULT_OUTPUTS.WORKER_BUNDLE).option("--minify", "Minify the output").option("--sourcemap", "Include source maps").action(async (options) => {
   try {
     const workspace = getWorkspace();
     logger.newLine();
@@ -14235,15 +14429,15 @@ var bundleCommand = new Command37("bundle").description("Bundle and inspect the
 });
 
 // src/commands/debug/index.ts
-var debugCommand = new Command38("debug").description("Debug and inspect project builds").addCommand(bundleCommand);
+var debugCommand = new Command39("debug").description("Debug and inspect project builds").addCommand(bundleCommand);
 
 // src/commands/vite/index.ts
-import { Command as Command39 } from "commander";
+import { Command as Command40 } from "commander";
 
 // src/commands/vite/config.ts
 import path3 from "node:path";
 import { confirm as confirm18 } from "@inquirer/prompts";
-import { dim as dim11 } from "colorette";
+import { dim as dim12 } from "colorette";
 async function runViteConfig() {
   try {
     logger.newLine();
@@ -14285,7 +14479,7 @@ async function runViteConfig() {
     const devCommand2 = getRunCommand(pm, "dev");
     const buildCommand = getRunCommand(pm, "build");
     logger.admonition("tip", "Next Steps", [
-      `1. Configure options in <vite.config.ts> ${dim11("(optional)")}`,
+      `1. Configure options in <vite.config.ts> ${dim12("(optional)")}`,
       `2. Run \`${devCommand2}\` to start development`,
       `3. Run \`${buildCommand}\` to build your project`,
       "",
@@ -14302,7 +14496,7 @@ async function runViteConfig() {
 }
 
 // src/commands/vite/index.ts
-var viteCommand = new Command39("vite").description("Vite plugin management");
+var viteCommand = new Command40("vite").description("Vite plugin management");
 viteCommand.command("config").description("Add Vite plugin to your project").action(runViteConfig);
 
 // src/index.ts
@@ -14332,6 +14526,7 @@ program.addCommand(typesCommand);
 program.addCommand(viteCommand);
 program.addCommand(projectsCommand);
 program.addCommand(deployCommand);
+program.addCommand(logsCommand);
 program.addCommand(timebackCommand);
 program.addCommand(debugCommand);
 program.addCommand(updateCommand);
@@ -14350,6 +14545,7 @@ export {
   analyzeChanges,
   applyEngineSelection,
   buildCustomRouteImportStatements,
+  buildLogStreamUrl,
   buildStatusByCourseId,
   bundleBackend,
   bundleSeedWorker,
@@ -14360,6 +14556,7 @@ export {
   collectFiles,
   compareIntegrationKeys,
   confirmDeploymentPlan,
+  connectToLogStream,
   createClient,
   createProjectDirectory,
   createSeedWorkerEntry,
@@ -14377,6 +14574,7 @@ export {
   displayDomainValidationRecords,
   displayIntegrationDetails,
   displayIntegrationList,
+  displayLogEntry,
   displayMissingCourseRequirementsAndExit,
   displayResourcesStatus,
   displaySeedLogs,