playcademy 0.13.17 → 0.13.19

package/dist/index.js

@@ -2361,6 +2361,215 @@ var init_context = __esm({
   }
 });
 
+// src/lib/core/logger.ts
+import {
+  blue,
+  bold as bold2,
+  cyan,
+  dim as dim2,
+  gray,
+  green,
+  greenBright,
+  red,
+  yellow,
+  yellowBright
+} from "colorette";
+import { colorize } from "json-colorizer";
+function customTransform(text5) {
+  const highlightCode = (text6) => text6.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  return highlightCode(text5);
+}
+function formatTable(data, title) {
+  if (data.length === 0) return;
+  const keys = Object.keys(data[0]);
+  const rows = data.map((item) => keys.map((key) => String(item[key] ?? "")));
+  const widths = keys.map((key, i) => {
+    const headerWidth = key.length;
+    const dataWidth = Math.max(...rows.map((row) => row[i].length));
+    return Math.max(headerWidth, dataWidth);
+  });
+  const totalWidth = widths.reduce((sum, w) => sum + w + 3, -1);
+  const separator = "\u251C" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u253C") + "\u2524";
+  const topBorder = "\u250C" + "\u2500".repeat(totalWidth) + "\u2510";
+  const titleSeparator = "\u251C" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u252C") + "\u2524";
+  const bottomBorder = "\u2514" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u2534") + "\u2518";
+  console.log(topBorder);
+  if (title) {
+    const titleText = bold2(title);
+    const titlePadding = totalWidth - title.length - 1;
+    const titleRow = "\u2502 " + titleText + " ".repeat(titlePadding) + "\u2502";
+    console.log(titleRow);
+    console.log(titleSeparator);
+  }
+  const header = "\u2502 " + keys.map((key, i) => key.padEnd(widths[i])).join(" \u2502 ") + " \u2502";
+  console.log(header);
+  console.log(separator);
+  rows.forEach((row) => {
+    const dataRow = "\u2502 " + row.map((cell, i) => cell.padEnd(widths[i])).join(" \u2502 ") + " \u2502";
+    console.log(dataRow);
+  });
+  console.log(bottomBorder);
+}
+var logger;
+var init_logger = __esm({
+  "src/lib/core/logger.ts"() {
+    "use strict";
+    logger = {
+      table: (data, title) => {
+        formatTable(data, title);
+      },
+      /**
+       * Info message - general information
+       */
+      info: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${blue("\u2139")} ${bold2(customTransform(message))}`);
+      },
+      /**
+       * Admonition - highlighted note/tip/warning box (Docusaurus-style)
+       */
+      admonition: (type, title, lines, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        const configs = {
+          note: { color: green },
+          tip: { color: cyan },
+          info: { color: blue },
+          warning: { color: yellow }
+        };
+        const { color: color2 } = configs[type];
+        console.log(`${spaces}${color2("\u250C\u2500")} ${bold2(color2(title.toUpperCase()))}`);
+        if (lines && lines.length > 0) {
+          lines.forEach((line) => {
+            console.log(`${spaces}${color2("\u2502")} ${customTransform(line)}`);
+          });
+        }
+        console.log(`${spaces}${color2("\u2514\u2500")}`);
+      },
+      /**
+       * Dim message - less important information
+       */
+      dim: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${dim2(customTransform(message))}`);
+      },
+      /**
+       * Success message - operation completed successfully
+       */
+      success: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${green("\u2714")} ${bold2(customTransform(message))}`);
+      },
+      remark: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${bold2(yellowBright("\u2726"))} ${bold2(customTransform(message))}`);
+      },
+      /**
+       * Error message - operation failed
+       */
+      error: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.error(`${spaces}${red("\u2716")} ${customTransform(message)}`);
+      },
+      bold: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${bold2(customTransform(message))}`);
+      },
+      /**
+       * Warning message - something to be aware of
+       */
+      warn: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.warn(`${spaces}${yellow("\u26A0")} ${bold2(customTransform(message))}`);
+      },
+      /**
+       * Debug message - only shown when DEBUG env var is set
+       */
+      debug: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        if (process.env.DEBUG) {
+          console.log(gray("[DEBUG]"), `${spaces}${message}`);
+        }
+      },
+      /**
+       * Step message - shows progress through a process
+       */
+      step: (step, total, message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(spaces + cyan(`[${step}/${total}]`), customTransform(message));
+      },
+      /**
+       * Highlighted message - draws attention
+       */
+      highlight: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(bold2(`${spaces}${cyan(customTransform(message))}`));
+      },
+      /**
+       * Aside message - for side information
+       */
+      aside: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${bold2(customTransform(message))}`);
+      },
+      /**
+       * Data display - for structured data output
+       */
+      data: (label, value, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        if (value !== void 0) {
+          console.log(`${spaces}${dim2(label + ":")} ${bold2(value)}`);
+        } else {
+          console.log(`${spaces}${dim2(label)}`);
+        }
+      },
+      /**
+       * JSON output - pretty-printed JSON
+       */
+      json: (data, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        const jsonString = colorize(JSON.stringify(data, null, 2));
+        jsonString.split("\n").forEach((line) => {
+          console.log(`${spaces}${line}`);
+        });
+      },
+      /**
+       * New line
+       */
+      newLine: () => {
+        console.log();
+      },
+      /**
+       * Raw output - no formatting, useful for ASCII art or pre-formatted text
+       */
+      raw: (text5, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${text5}`);
+      },
+      /**
+       * Display a configuration error with helpful suggestions
+       */
+      configError: (error, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        const isConfigError = error && typeof error === "object" && "name" in error && error.name === "ConfigError";
+        if (isConfigError && "message" in error && "field" in error && "suggestion" in error) {
+          const configErr = error;
+          console.error(`${spaces}${red("\u2716")} ${bold2(configErr.message)}`);
+          if (configErr.field) {
+            console.error(`${spaces}  ${dim2("Field:")} ${configErr.field}`);
+          }
+          if (configErr.suggestion) {
+            console.error(`${spaces}  ${dim2("Fix:")} ${configErr.suggestion}`);
+          }
+        } else if (error instanceof Error) {
+          console.error(`${spaces}${red("\u2716")} ${bold2(error.message)}`);
+        } else {
+          console.error(`${spaces}${red("\u2716")} ${bold2(String(error))}`);
+        }
+      }
+    };
+  }
+});
+
 // src/lib/core/config.ts
 function normalizeEnvironment(env) {
   if (!env) return null;
@@ -2373,15 +2582,15 @@ function normalizeEnvironment(env) {
   }
   return null;
 }
-function ensureEnvironment(env, logger2) {
+function ensureEnvironment(env) {
   if (env) {
     const normalized = normalizeEnvironment(env);
     if (!normalized) {
-      logger2.newLine();
-      logger2.error(`Invalid environment: "${env}"`);
-      logger2.newLine();
-      logger2.info("Valid environments: staging, production");
-      logger2.newLine();
+      logger.newLine();
+      logger.error(`Invalid environment: "${env}"`);
+      logger.newLine();
+      logger.remark("Valid environments: staging, production");
+      logger.newLine();
       process.exit(1);
     }
     setCliContext({ environment: normalized });
@@ -2421,6 +2630,7 @@ var init_config = __esm({
     "use strict";
     init_constants2();
     init_context();
+    init_logger();
   }
 });
 
@@ -3373,215 +3583,6 @@ var init_config2 = __esm({
   }
 });
 
-// src/lib/core/logger.ts
-import {
-  blue,
-  bold as bold2,
-  cyan,
-  dim as dim2,
-  gray,
-  green,
-  greenBright,
-  red,
-  yellow,
-  yellowBright
-} from "colorette";
-import { colorize } from "json-colorizer";
-function customTransform(text5) {
-  const highlightCode = (text6) => text6.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
-  return highlightCode(text5);
-}
-function formatTable(data, title) {
-  if (data.length === 0) return;
-  const keys = Object.keys(data[0]);
-  const rows = data.map((item) => keys.map((key) => String(item[key] ?? "")));
-  const widths = keys.map((key, i) => {
-    const headerWidth = key.length;
-    const dataWidth = Math.max(...rows.map((row) => row[i].length));
-    return Math.max(headerWidth, dataWidth);
-  });
-  const totalWidth = widths.reduce((sum, w) => sum + w + 3, -1);
-  const separator = "\u251C" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u253C") + "\u2524";
-  const topBorder = "\u250C" + "\u2500".repeat(totalWidth) + "\u2510";
-  const titleSeparator = "\u251C" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u252C") + "\u2524";
-  const bottomBorder = "\u2514" + widths.map((w) => "\u2500".repeat(w + 2)).join("\u2534") + "\u2518";
-  console.log(topBorder);
-  if (title) {
-    const titleText = bold2(title);
-    const titlePadding = totalWidth - title.length - 1;
-    const titleRow = "\u2502 " + titleText + " ".repeat(titlePadding) + "\u2502";
-    console.log(titleRow);
-    console.log(titleSeparator);
-  }
-  const header = "\u2502 " + keys.map((key, i) => key.padEnd(widths[i])).join(" \u2502 ") + " \u2502";
-  console.log(header);
-  console.log(separator);
-  rows.forEach((row) => {
-    const dataRow = "\u2502 " + row.map((cell, i) => cell.padEnd(widths[i])).join(" \u2502 ") + " \u2502";
-    console.log(dataRow);
-  });
-  console.log(bottomBorder);
-}
-var logger;
-var init_logger = __esm({
-  "src/lib/core/logger.ts"() {
-    "use strict";
-    logger = {
-      table: (data, title) => {
-        formatTable(data, title);
-      },
-      /**
-       * Info message - general information
-       */
-      info: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${blue("\u2139")} ${bold2(customTransform(message))}`);
-      },
-      /**
-       * Admonition - highlighted note/tip/warning box (Docusaurus-style)
-       */
-      admonition: (type, title, lines, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        const configs = {
-          note: { color: green },
-          tip: { color: cyan },
-          info: { color: blue },
-          warning: { color: yellow }
-        };
-        const { color: color2 } = configs[type];
-        console.log(`${spaces}${color2("\u250C\u2500")} ${bold2(color2(title.toUpperCase()))}`);
-        if (lines && lines.length > 0) {
-          lines.forEach((line) => {
-            console.log(`${spaces}${color2("\u2502")} ${customTransform(line)}`);
-          });
-        }
-        console.log(`${spaces}${color2("\u2514\u2500")}`);
-      },
-      /**
-       * Dim message - less important information
-       */
-      dim: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${dim2(customTransform(message))}`);
-      },
-      /**
-       * Success message - operation completed successfully
-       */
-      success: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${green("\u2714")} ${bold2(customTransform(message))}`);
-      },
-      remark: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${bold2(yellowBright("\u2726"))} ${bold2(customTransform(message))}`);
-      },
-      /**
-       * Error message - operation failed
-       */
-      error: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.error(`${spaces}${red("\u2716")} ${customTransform(message)}`);
-      },
-      bold: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${bold2(customTransform(message))}`);
-      },
-      /**
-       * Warning message - something to be aware of
-       */
-      warn: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.warn(`${spaces}${yellow("\u26A0")} ${bold2(customTransform(message))}`);
-      },
-      /**
-       * Debug message - only shown when DEBUG env var is set
-       */
-      debug: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        if (process.env.DEBUG) {
-          console.log(gray("[DEBUG]"), `${spaces}${message}`);
-        }
-      },
-      /**
-       * Step message - shows progress through a process
-       */
-      step: (step, total, message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(spaces + cyan(`[${step}/${total}]`), customTransform(message));
-      },
-      /**
-       * Highlighted message - draws attention
-       */
-      highlight: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(bold2(`${spaces}${cyan(customTransform(message))}`));
-      },
-      /**
-       * Aside message - for side information
-       */
-      aside: (message, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${bold2(customTransform(message))}`);
-      },
-      /**
-       * Data display - for structured data output
-       */
-      data: (label, value, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        if (value !== void 0) {
-          console.log(`${spaces}${dim2(label + ":")} ${bold2(value)}`);
-        } else {
-          console.log(`${spaces}${dim2(label)}`);
-        }
-      },
-      /**
-       * JSON output - pretty-printed JSON
-       */
-      json: (data, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        const jsonString = colorize(JSON.stringify(data, null, 2));
-        jsonString.split("\n").forEach((line) => {
-          console.log(`${spaces}${line}`);
-        });
-      },
-      /**
-       * New line
-       */
-      newLine: () => {
-        console.log();
-      },
-      /**
-       * Raw output - no formatting, useful for ASCII art or pre-formatted text
-       */
-      raw: (text5, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        console.log(`${spaces}${text5}`);
-      },
-      /**
-       * Display a configuration error with helpful suggestions
-       */
-      configError: (error, indent = 0) => {
-        const spaces = "  ".repeat(indent);
-        const isConfigError = error && typeof error === "object" && "name" in error && error.name === "ConfigError";
-        if (isConfigError && "message" in error && "field" in error && "suggestion" in error) {
-          const configErr = error;
-          console.error(`${spaces}${red("\u2716")} ${bold2(configErr.message)}`);
-          if (configErr.field) {
-            console.error(`${spaces}  ${dim2("Field:")} ${configErr.field}`);
-          }
-          if (configErr.suggestion) {
-            console.error(`${spaces}  ${dim2("Fix:")} ${configErr.suggestion}`);
-          }
-        } else if (error instanceof Error) {
-          console.error(`${spaces}${red("\u2716")} ${bold2(error.message)}`);
-        } else {
-          console.error(`${spaces}${red("\u2716")} ${bold2(String(error))}`);
-        }
-      }
-    };
-  }
-});
-
 // src/lib/core/client.ts
 import { PlaycademyClient } from "@playcademy/sdk";
 async function createClient() {
@@ -4727,7 +4728,7 @@ async function setupPackageJson(workspace, gameName) {
     const slugifiedName = generateSlug(gameName);
     const packageContent = packageTemplate.replace("{{GAME_NAME}}", slugifiedName);
     writeFileSync2(pkgPath, packageContent);
-    logger.info("Created package.json");
+    logger.success("Created package.json");
     return true;
   }
 }
@@ -6397,7 +6398,7 @@ async function selectEnvironment(options) {
   const authenticatedEnvs = await getAuthenticatedEnvironments();
   if (authenticatedEnvs.length === 1) {
     environment = authenticatedEnvs[0];
-    logger.info(`Deploying to ${environment}`, 1);
+    logger.remark(`Deploying to ${environment}`, 1);
   } else if (authenticatedEnvs.length === 2 && !options.dryRun) {
     logger.newLine();
     environment = await select2({
@@ -7992,19 +7993,19 @@ function displayConfigPreview(config, logger2) {
   logger2.newLine();
   logger2.highlight("Dry Run");
   logger2.newLine();
-  logger2.info("Organization");
+  logger2.highlight("Organization");
   logger2.data("Name", config.organization.name, 1);
   logger2.data("Type", config.organization.type, 1);
   logger2.data("ID", config.organization.identifier, 1);
   logger2.newLine();
-  logger2.info("Course");
+  logger2.highlight("Course");
   logger2.data("Title", config.course.title, 1);
   logger2.data("Code", config.course.courseCode, 1);
   logger2.data("Subjects", config.course.subjects.join(", "), 1);
   logger2.data("Grades", config.course.grades.join(", "), 1);
   logger2.data("Level", config.course.level, 1);
   logger2.newLine();
-  logger2.info("Resource");
+  logger2.highlight("Resource");
   logger2.data("Title", config.resource.title, 1);
   logger2.data("Launch URL", config.resource.metadata.launchUrl, 1);
   logger2.newLine();
@@ -8246,7 +8247,7 @@ 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) => {
   const { email, password: password2, sso, env } = options;
-  const environment = ensureEnvironment(env, logger);
+  const environment = ensureEnvironment(env);
   const profileName = getProfileName();
   logger.newLine();
   const existingProfile = await getProfile(environment, profileName);
@@ -8437,14 +8438,14 @@ async function promptForPassword() {
 import { Command as Command4 } from "commander";
 var logoutCommand = new Command4("logout").description("Log out from Playcademy").argument("[profile]", "Profile name to logout from", "default").option("--env <environment>", "Environment to logout from (staging or production)").action(async (profileName, options) => {
   const { env } = options;
-  const environment = ensureEnvironment(env, logger);
+  const environment = ensureEnvironment(env);
   try {
     logger.newLine();
     const profile = await getProfile(environment, profileName);
     if (!profile) {
       logger.error(`Profile "${profileName}" not found in ${environment}`);
       logger.newLine();
-      logger.info("Use `playcademy profiles list` to see available profiles");
+      logger.remark("Use `playcademy profiles list` to see available profiles");
       logger.newLine();
       process.exit(1);
     }
@@ -8467,7 +8468,7 @@ var meCommand = new Command5("me").description("Display current user information
 ).action(async (options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const user = await runStep(
@@ -8525,7 +8526,7 @@ async function executeDeployment(plan, context2, environment) {
   return { game, backendDeployment };
 }
 async function runDeployment(options) {
-  const environment = ensureEnvironment(options.env, logger);
+  const environment = ensureEnvironment(options.env);
   await selectEnvironment({ env: environment, dryRun: options.dryRun });
   const context2 = await prepareDeploymentContext(options);
   displayCurrentConfiguration(context2);
@@ -8592,7 +8593,7 @@ import { Command as Command7 } from "commander";
 var deleteCommand = new Command7("delete").alias("rm").alias("remove").description("Delete a game").argument("[slug]", "Game slug to delete").option("-f, --force", "Skip confirmation prompt").option("--env <environment>", "Environment to delete game from (staging or production)").action(async (slug, options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const games2 = await runStep(
@@ -8601,7 +8602,9 @@ var deleteCommand = new Command7("delete").alias("rm").alias("remove").descripti
       (games3) => `Found ${games3.length} ${pluralize(games3.length, "game")} in ${environment}`
     );
     if (games2.length === 0) {
-      logger.info(`No games found in ${environment}`);
+      logger.newLine();
+      logger.remark(`No games found in ${environment}`);
+      logger.newLine();
       return;
     }
     logger.newLine();
@@ -8684,7 +8687,7 @@ import { Command as Command8 } from "commander";
 var listCommand = new Command8("list").alias("ls").description("List all games").option("--env <environment>", "Environment to list games from (staging or production)").action(async (options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const games2 = await runStep(
@@ -8693,7 +8696,7 @@ var listCommand = new Command8("list").alias("ls").description("List all games")
       (games3) => `Found ${games3.length} ${pluralize(games3.length, "game")} in ${environment}`
     );
     if (games2.length === 0) {
-      logger.info("No games found");
+      logger.remark("No games found");
       logger.newLine();
       return;
     }
@@ -8732,7 +8735,7 @@ var applyCommand = new Command10("apply").description("Apply for developer statu
 ).action(async (options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const currentStatus = await runStep(
@@ -8783,7 +8786,7 @@ var getStatusCommand = new Command11("status").description("Check your developer
 ).action(async (options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const status = await runStep(
@@ -9018,27 +9021,17 @@ async function runDbDiff() {
 }
 
 // src/commands/db/init.ts
-init_file_loader();
 init_constants2();
-import { readFileSync as readFileSync7, writeFileSync as writeFileSync9 } from "fs";
 import { input as input6 } from "@inquirer/prompts";
+init_writer();
+init_loader2();
+var sampleCustomRouteTemplate2 = loadTemplateString("api/sample-custom.ts");
+var sampleDatabaseRouteTemplate2 = loadTemplateString("api/sample-database.ts");
 async function runDbInit() {
   try {
     logger.newLine();
-    const configFile = await findFile(CONFIG_FILE_NAMES, {
-      searchUp: false,
-      maxLevels: 0
-    });
-    if (!configFile) {
-      logger.error("No playcademy.config file found");
-      logger.newLine();
-      logger.admonition("tip", "Getting Started", [
-        "Run `playcademy init` to create a config file first"
-      ]);
-      logger.newLine();
-      process.exit(1);
-    }
-    const config = await loadConfig(configFile.path);
+    const config = await loadConfig();
+    const configPath = await findConfigPath();
     logger.highlight("Add Database");
     logger.newLine();
     const dbDir = await input6({
@@ -9055,35 +9048,41 @@ async function runDbInit() {
     ensureRootGitignore();
     await scaffoldDatabaseSetup({ gameName: config.name });
     if (!config.integrations?.database) {
-      const configContent = readFileSync7(configFile.path, "utf-8");
-      const isJson = configFile.path.endsWith(".json");
-      let updatedContent;
-      if (isJson) {
-        const parsed = JSON.parse(configContent);
-        if (!parsed.integrations) parsed.integrations = {};
-        parsed.integrations.database = { directory: dbDir };
-        updatedContent = JSON.stringify(parsed, null, 4);
-      } else {
-        const dbConfig = `
-        database: { directory: '${dbDir}' },`;
-        if (configContent.includes("integrations:")) {
-          updatedContent = configContent.replace(/(integrations:\s*{)/, `$1${dbConfig}`);
-        } else {
-          const integrationsConfig = `
-    integrations: {${dbConfig}
-    },`;
-          updatedContent = configContent.replace(
-            /(\n\s*})(\s*)$/,
-            `${integrationsConfig}$1$2`
-          );
+      await updateConfigFile(configPath, {
+        integrations: {
+          ...config.integrations,
+          database: { directory: dbDir }
         }
-      }
-      writeFileSync9(configFile.path, updatedContent, "utf-8");
-      logger.success(`Updated ${configFile.path.split("/").pop()}`);
+      });
+      logger.success(`Updated ${configPath.split("/").pop()}`);
     }
     logger.newLine();
     logger.success("Database added!");
     logger.newLine();
+    if (!hasLocalCustomRoutes(getWorkspace(), config)) {
+      const apiDirectory = await input6({
+        message: "  \u2514\u2500 API routes directory:",
+        default: DEFAULT_API_ROUTES_DIRECTORY,
+        validate: (value) => {
+          if (!value || value.trim().length === 0) {
+            return "Directory name is required";
+          }
+          return validateApiDirectoryDoesNotExist(value);
+        }
+      });
+      await scaffoldApiDirectory(apiDirectory, [
+        { filename: "custom.ts", template: sampleCustomRouteTemplate2 },
+        { filename: "database.ts", template: sampleDatabaseRouteTemplate2 }
+      ]);
+      await updateConfigFile(configPath, {
+        integrations: {
+          ...config.integrations,
+          customRoutes: { directory: apiDirectory }
+        }
+      });
+      logger.success(`Added custom routes to ${configPath.split("/").pop()}`);
+      logger.newLine();
+    }
     await ensurePlaycademyTypes();
     logger.admonition("tip", "Next Steps", [
       "1. Install dependencies: `bun install`",
@@ -9320,7 +9319,8 @@ async function runKVClear(options = {}) {
         } else if (options.raw) {
           logger.raw("0");
         } else {
-          logger.info("No keys found in KV namespace");
+          logger.newLine();
+          logger.remark("No keys found in KV namespace");
           logger.newLine();
         }
         return;
@@ -9333,7 +9333,7 @@ async function runKVClear(options = {}) {
           default: false
         });
         if (!confirmed) {
-          logger.info("Cancelled");
+          logger.remark("Cancelled");
           logger.newLine();
           return;
         }
@@ -9573,7 +9573,12 @@ async function runKVGet(key, options = {}) {
 }
 
 // src/commands/kv/init.ts
+init_constants2();
+import { input as input7 } from "@inquirer/prompts";
 init_writer();
+init_loader2();
+var sampleCustomRouteTemplate3 = loadTemplateString("api/sample-custom.ts");
+var sampleKvRouteTemplate2 = loadTemplateString("api/sample-kv.ts");
 async function runKVInit() {
   try {
     logger.newLine();
@@ -9601,28 +9606,37 @@ async function runKVInit() {
     });
     logger.success("Added KV integration to config");
     logger.newLine();
+    if (!hasLocalCustomRoutes(getWorkspace(), config)) {
+      const apiDirectory = await input7({
+        message: "  \u2514\u2500 API routes directory:",
+        default: DEFAULT_API_ROUTES_DIRECTORY,
+        validate: (value) => {
+          if (!value || value.trim().length === 0) {
+            return "Directory name is required";
+          }
+          return validateApiDirectoryDoesNotExist(value);
+        }
+      });
+      await scaffoldApiDirectory(apiDirectory, [
+        { filename: "custom.ts", template: sampleCustomRouteTemplate3 },
+        { filename: "kv.ts", template: sampleKvRouteTemplate2 }
+      ]);
+      await updateConfigFile(configPath, {
+        integrations: {
+          ...config.integrations,
+          customRoutes: { directory: apiDirectory }
+        }
+      });
+      logger.success("Added custom routes to config");
+      logger.newLine();
+    }
     await ensurePlaycademyTypes();
-    logger.admonition("tip", "Usage Example", [
-      "Access KV in your API routes:",
-      "",
-      "```typescript",
-      "export async function GET(c: Context) {",
-      "    // Read from KV",
-      `    const data = await c.env.KV.get('user:123')`,
-      "",
-      "    // Write to KV",
-      `    await c.env.KV.put('user:123', JSON.stringify({ score: 100 }))`,
-      "",
-      "    // Delete from KV",
-      `    await c.env.KV.delete('user:123')`,
-      "",
-      "    return c.json({ success: true })",
-      "}",
-      "```"
+    logger.admonition("tip", "Next Steps", [
+      "1. Use `c.env.KV` in your API routes",
+      "2. Run `playcademy dev` to test locally",
+      "3. Run `playcademy deploy`"
     ]);
     logger.newLine();
-    logger.remark("Run `playcademy dev` to start using KV in local development");
-    logger.newLine();
   } catch (error) {
     logger.error(
       `Failed to add KV integration: ${error instanceof Error ? error.message : String(error)}`
@@ -9837,7 +9851,7 @@ async function runKVList(options = {}) {
         return;
       }
       if (keyNames.length === 0) {
-        logger.info("No keys found in KV namespace");
+        logger.remark("No keys found in KV namespace");
       } else {
         logger.success(`Found ${keyNames.length} ${pluralize(keyNames.length, "key")}`);
         logger.newLine();
@@ -9968,7 +9982,7 @@ async function runKVSeed(seedFile, options = {}) {
             default: false
           });
           if (!confirmed) {
-            logger.info("Cancelled");
+            logger.remark("Cancelled");
             logger.newLine();
             return;
           }
@@ -10218,7 +10232,7 @@ async function runKVStats(options = {}) {
         logger.raw(stats.totalKeys.toString());
       } else {
         if (stats.totalKeys === 0) {
-          logger.info("No keys found in KV namespace");
+          logger.remark("No keys found in KV namespace");
           logger.newLine();
           return;
         }
@@ -10401,7 +10415,7 @@ async function runBucketDelete(key, options = {}) {
 
 // src/commands/bucket/get.ts
 init_constants2();
-import { writeFileSync as writeFileSync10 } from "fs";
+import { writeFileSync as writeFileSync9 } from "fs";
 import { join as join31 } from "path";
 import { Miniflare as Miniflare12 } from "miniflare";
 async function runBucketGet(key, options = {}) {
@@ -10487,7 +10501,7 @@ async function runBucketGet(key, options = {}) {
       }
       if (options.output) {
         const buffer = await object.arrayBuffer();
-        writeFileSync10(options.output, Buffer.from(buffer));
+        writeFileSync9(options.output, Buffer.from(buffer));
         if (!options.raw) {
           logger.success(`Downloaded '${key}' to '${options.output}'`);
           logger.newLine();
@@ -10527,7 +10541,12 @@ async function runBucketGet(key, options = {}) {
 }
 
 // src/commands/bucket/init.ts
+init_constants2();
+import { input as input8 } from "@inquirer/prompts";
 init_writer();
+init_loader2();
+var sampleCustomRouteTemplate4 = loadTemplateString("api/sample-custom.ts");
+var sampleBucketRouteTemplate2 = loadTemplateString("api/sample-bucket.ts");
 async function runBucketInit() {
   try {
     logger.newLine();
@@ -10555,6 +10574,30 @@ async function runBucketInit() {
     });
     logger.success("Added bucket integration to config");
     logger.newLine();
+    if (!hasLocalCustomRoutes(getWorkspace(), config)) {
+      const apiDirectory = await input8({
+        message: "  \u2514\u2500 API routes directory:",
+        default: DEFAULT_API_ROUTES_DIRECTORY,
+        validate: (value) => {
+          if (!value || value.trim().length === 0) {
+            return "Directory name is required";
+          }
+          return validateApiDirectoryDoesNotExist(value);
+        }
+      });
+      await scaffoldApiDirectory(apiDirectory, [
+        { filename: "custom.ts", template: sampleCustomRouteTemplate4 },
+        { filename: "bucket.ts", template: sampleBucketRouteTemplate2 }
+      ]);
+      await updateConfigFile(configPath, {
+        integrations: {
+          ...config.integrations,
+          customRoutes: { directory: apiDirectory }
+        }
+      });
+      logger.success("Added custom routes to config");
+      logger.newLine();
+    }
     await ensurePlaycademyTypes();
     logger.admonition("tip", "Next Steps", [
       "1. Use `c.env.BUCKET` in your API routes to upload/download files",
@@ -10642,7 +10685,7 @@ async function runBucketList(options = {}) {
         return;
       }
       if (files.length === 0) {
-        logger.info("No files found in bucket");
+        logger.remark("No files found in bucket");
         if (options.prefix) {
           logger.newLine();
           logger.data("Prefix", options.prefix, 1);
@@ -10692,7 +10735,7 @@ function formatBytes(bytes) {
 
 // src/commands/bucket/put.ts
 init_constants2();
-import { readFileSync as readFileSync8, statSync as statSync2 } from "fs";
+import { readFileSync as readFileSync7, statSync as statSync2 } from "fs";
 import { join as join33 } from "path";
 import { Miniflare as Miniflare14 } from "miniflare";
 async function runBucketPut(key, filePath, options = {}) {
@@ -10737,7 +10780,7 @@ async function runBucketPut(key, filePath, options = {}) {
     let fileBuffer;
     let fileSize;
     try {
-      fileBuffer = readFileSync8(filePath);
+      fileBuffer = readFileSync7(filePath);
       fileSize = statSync2(filePath).size;
     } catch {
       if (!options.raw && !options.json) {
@@ -10831,19 +10874,19 @@ var bucketCommand = new Command16("bucket").description("Manage bucket storage i
   bucketCommand.help();
 });
 bucketCommand.command("init").description("Add bucket storage integration to your project").action(runBucketInit);
-bucketCommand.command("list").alias("ls").description("List files in local bucket (dev mode)").option("--prefix <prefix>", "Filter files by key prefix").option("--raw", "Output file keys one per line, no formatting").option("--json", "Output as JSON array").option("--remote", "Use remote bucket (not yet implemented)").option(
+bucketCommand.command("list").alias("ls").description("List files in local bucket").option("--prefix <prefix>", "Filter files by key prefix").option("--raw", "Output file keys one per line, no formatting").option("--json", "Output as JSON array").option("--remote", "Use remote bucket (not yet implemented)").option(
   "--env <environment>",
   "Environment to use with --remote: staging (default) or production"
 ).action(runBucketList);
-bucketCommand.command("get <key>").description("Download a file from local bucket (dev mode)").option("-o, --output <path>", "Output file path (required for binary files)").option("--raw", "Output file content to stdout").option("--json", "Output metadata as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
+bucketCommand.command("get <key>").description("Download a file from local bucket").option("-o, --output <path>", "Output file path (required for binary files)").option("--raw", "Output file content to stdout").option("--json", "Output metadata as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
   "--env <environment>",
   "Environment to use with --remote: staging (default) or production"
 ).action(runBucketGet);
-bucketCommand.command("put <key> <file>").description("Upload a file to local bucket (dev mode)").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
+bucketCommand.command("put <key> <file>").description("Upload a file to local bucket").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
   "--env <environment>",
   "Environment to use with --remote: staging (default) or production"
 ).action(runBucketPut);
-bucketCommand.command("delete <key>").alias("del").alias("rm").description("Delete a file from local bucket (dev mode)").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
+bucketCommand.command("delete <key>").alias("del").alias("rm").description("Delete a file from local bucket").option("--raw", "Output minimal confirmation").option("--json", "Output result as JSON").option("--remote", "Use remote bucket (not yet implemented)").option(
   "--env <environment>",
   "Environment to use with --remote: staging (default) or production"
 ).action(runBucketDelete);
@@ -10902,7 +10945,7 @@ import { bold as bold6 } from "colorette";
 import { Command as Command18 } from "commander";
 var removeCommand = new Command18("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, logger);
+  const environment = ensureEnvironment(env);
   try {
     logger.newLine();
     const profilesMap = await listProfiles();
@@ -10968,7 +11011,9 @@ var resetCommand = new Command19("reset").description(
       default: false
     });
     if (!confirmed) {
-      logger.info("Operation cancelled");
+      logger.newLine();
+      logger.remark("Operation cancelled");
+      logger.newLine();
       return;
     }
     let removedCount = 0;
@@ -11019,7 +11064,7 @@ var cleanupCommand = new Command21("cleanup").description("Remove TimeBack integ
 ).action(async (options) => {
   const { env } = options;
   try {
-    const environment = ensureEnvironment(env, logger);
+    const environment = ensureEnvironment(env);
     const client = await requireAuthenticatedClient();
     logger.newLine();
     const { game } = await getGameFromConfig(client);
@@ -11125,7 +11170,7 @@ var setupCommand = new Command23("setup").description("Set up TimeBack integrati
 ).action(async (options) => {
   const { env } = options;
   try {
-    ensureEnvironment(env, logger);
+    ensureEnvironment(env);
     logger.newLine();
     const config = await runStep(
       "Loading configuration",
@@ -11220,7 +11265,7 @@ var updateCommand = new Command24("update").description("Update TimeBack integra
 ).action(async (options) => {
   const { env } = options;
   try {
-    ensureEnvironment(env, logger);
+    ensureEnvironment(env);
     const config = await runStep(
       "Loading configuration",
       loadConfig,
@@ -11338,7 +11383,7 @@ var verifyCommand = new Command25("verify").description("Verify TimeBack integra
   "Environment to verify TimeBack integration in (staging or production)"
 ).action(async (options) => {
   const { env } = options;
-  const environment = ensureEnvironment(env, logger);
+  const environment = ensureEnvironment(env);
   try {
     const client = await requireAuthenticatedClient();
     logger.newLine();
@@ -11398,7 +11443,7 @@ import { Command as Command28 } from "commander";
 // src/commands/debug/bundle.ts
 init_src();
 init_constants2();
-import { writeFileSync as writeFileSync11 } from "fs";
+import { writeFileSync as writeFileSync10 } from "fs";
 import { join as join34 } from "path";
 import { Command as Command27 } from "commander";
 var bundleCommand = new Command27("bundle").description("Bundle and inspect the game 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) => {
@@ -11430,7 +11475,7 @@ var bundleCommand = new Command27("bundle").description("Bundle and inspect the
       (result) => `Bundled ${formatSize(result.code.length)}`
     );
     const outputPath = join34(workspace, options.output);
-    writeFileSync11(outputPath, bundle.code, "utf-8");
+    writeFileSync10(outputPath, bundle.code, "utf-8");
     logger.success(`Bundle saved to ${options.output}`);
     logger.newLine();
     logger.highlight("Bundle Analysis");

package/dist/templates/api/sample-bucket.ts.template

@@ -4,8 +4,6 @@
  * This route will be available at: https://<your-game-slug>.playcademy.gg/api/sample/bucket
  */
 
-import type { Context } from 'hono'
-
 interface FileInfo {
     key: string
     name: string

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.13.17",
+    "version": "0.13.19",
     "type": "module",
     "module": "./dist/index.js",
     "main": "./dist/index.js",