playcademy 0.13.19 → 0.13.20

package/dist/utils.js

@@ -87,7 +87,8 @@ async function loadFile(filename, options = {}) {
     required = false,
     searchUp = false,
     maxLevels = 3,
-    parseJson = false
+    parseJson = false,
+    stripComments = false
   } = options;
   let fileResult;
   if (searchUp) {
@@ -116,8 +117,11 @@ async function loadFile(filename, options = {}) {
     return null;
   }
   try {
-    const content = await readFile(fileResult.path, "utf-8");
+    let content = await readFile(fileResult.path, "utf-8");
     if (parseJson) {
+      if (stripComments) {
+        content = stripJsonComments(content);
+      }
       return JSON.parse(content);
     }
     return content;
@@ -182,6 +186,11 @@ function getCurrentDirectoryName(fallback = "unknown-directory") {
 function getFileExtension(path2) {
   return path2.split(".").pop()?.toLowerCase();
 }
+function stripJsonComments(jsonc) {
+  let result = jsonc.replace(/\/\*[\s\S]*?\*\//g, "");
+  result = result.replace(/\/\/.*/g, "");
+  return result;
+}
 async function loadModule(filename, options = {}) {
   const { cwd = process.cwd(), required = false, searchUp = false, maxLevels = 3 } = options;
   let fileResult;
@@ -285,104 +294,230 @@ var init_file_loader = __esm({
   }
 });
 
-// src/lib/config/loader.ts
-init_file_loader();
-import { dirname as dirname2, resolve as resolve2 } from "path";
-
 // src/constants/api.ts
-var DEFAULT_API_ROUTES_DIRECTORY = "server/api";
+var DEFAULT_API_ROUTES_DIRECTORY;
+var init_api = __esm({
+  "src/constants/api.ts"() {
+    "use strict";
+    DEFAULT_API_ROUTES_DIRECTORY = "server/api";
+  }
+});
+
+// src/constants/config.ts
+var ENV_FILES, TSCONFIG_FILES;
+var init_config = __esm({
+  "src/constants/config.ts"() {
+    "use strict";
+    ENV_FILES = [
+      ".env",
+      // Loaded first
+      ".env.development",
+      // Overrides .env
+      ".env.local"
+      // Overrides all (highest priority)
+    ];
+    TSCONFIG_FILES = [
+      "tsconfig.app.json",
+      // Modern tooling (try first)
+      "tsconfig.json"
+      // Standard (fallback)
+    ];
+  }
+});
+
+// src/constants/database.ts
+var init_database = __esm({
+  "src/constants/database.ts"() {
+    "use strict";
+  }
+});
+
+// src/constants/http-server.ts
+var init_http_server = __esm({
+  "src/constants/http-server.ts"() {
+    "use strict";
+  }
+});
 
 // src/constants/paths.ts
 import { join } from "path";
-var WORKSPACE_NAME = ".playcademy";
-var CLI_DIRECTORIES = {
-  /** Root directory for CLI artifacts in workspace */
-  WORKSPACE: WORKSPACE_NAME,
-  /** Database directory within workspace */
-  DATABASE: join(WORKSPACE_NAME, "db"),
-  /** KV storage directory within workspace */
-  KV: join(WORKSPACE_NAME, "kv"),
-  /** Bucket storage directory within workspace */
-  BUCKET: join(WORKSPACE_NAME, "bucket")
-};
+var WORKSPACE_NAME, CLI_DIRECTORIES;
+var init_paths = __esm({
+  "src/constants/paths.ts"() {
+    "use strict";
+    WORKSPACE_NAME = ".playcademy";
+    CLI_DIRECTORIES = {
+      /** Root directory for CLI artifacts in workspace */
+      WORKSPACE: WORKSPACE_NAME,
+      /** Database directory within workspace */
+      DATABASE: join(WORKSPACE_NAME, "db"),
+      /** KV storage directory within workspace */
+      KV: join(WORKSPACE_NAME, "kv"),
+      /** Bucket storage directory within workspace */
+      BUCKET: join(WORKSPACE_NAME, "bucket")
+    };
+  }
+});
 
 // src/constants/ports.ts
-var DEFAULT_PORTS = {
-  /** Sandbox server (mock platform API) */
-  SANDBOX: 4321,
-  /** Backend dev server (game backend with HMR) */
-  BACKEND: 8788
-};
+var DEFAULT_PORTS;
+var init_ports = __esm({
+  "src/constants/ports.ts"() {
+    "use strict";
+    DEFAULT_PORTS = {
+      /** Sandbox server (mock platform API) */
+      SANDBOX: 4321,
+      /** Backend dev server (game backend with HMR) */
+      BACKEND: 8788
+    };
+  }
+});
 
 // src/constants/timeback.ts
-var CONFIG_FILE_NAMES = [
-  "playcademy.config.js",
-  "playcademy.config.json",
-  "playcademy.config.mjs"
-];
+var CONFIG_FILE_NAMES;
+var init_timeback = __esm({
+  "src/constants/timeback.ts"() {
+    "use strict";
+    CONFIG_FILE_NAMES = [
+      "playcademy.config.js",
+      "playcademy.config.json",
+      "playcademy.config.mjs"
+    ];
+  }
+});
+
+// ../constants/src/auth.ts
+var init_auth = __esm({
+  "../constants/src/auth.ts"() {
+    "use strict";
+  }
+});
+
+// ../constants/src/domains.ts
+var init_domains = __esm({
+  "../constants/src/domains.ts"() {
+    "use strict";
+  }
+});
+
+// ../constants/src/env-vars.ts
+var init_env_vars = __esm({
+  "../constants/src/env-vars.ts"() {
+    "use strict";
+  }
+});
 
 // ../constants/src/overworld.ts
-var ITEM_SLUGS = {
-  /** Primary platform currency */
-  PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
-  /** Experience points currency */
-  PLAYCADEMY_XP: "PLAYCADEMY_XP",
-  /** Core platform badges */
-  FOUNDING_MEMBER_BADGE: "FOUNDING_MEMBER_BADGE",
-  EARLY_ADOPTER_BADGE: "EARLY_ADOPTER_BADGE",
-  FIRST_GAME_BADGE: "FIRST_GAME_BADGE",
-  /** Example items */
-  COMMON_SWORD: "COMMON_SWORD",
-  SMALL_HEALTH_POTION: "SMALL_HEALTH_POTION",
-  SMALL_BACKPACK: "SMALL_BACKPACK",
-  /** Placeable items */
-  LAVA_LAMP: "LAVA_LAMP",
-  BOOMBOX: "BOOMBOX",
-  CABIN_BED: "CABIN_BED"
-};
-var CURRENCIES = {
-  /** Primary platform currency slug */
-  PRIMARY: ITEM_SLUGS.PLAYCADEMY_CREDITS,
-  /** Experience points slug */
-  XP: ITEM_SLUGS.PLAYCADEMY_XP
-};
-var BADGES = {
-  FOUNDING_MEMBER: ITEM_SLUGS.FOUNDING_MEMBER_BADGE,
-  EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
-  FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE
-};
-var CORE_GAME_UUIDS = {
-  /** Internal playground game for development and testing */
-  PLAYGROUND: "00000000-0000-0000-0000-000000000001"
-};
+var ITEM_SLUGS, CURRENCIES, BADGES, CORE_GAME_UUIDS;
+var init_overworld = __esm({
+  "../constants/src/overworld.ts"() {
+    "use strict";
+    ITEM_SLUGS = {
+      /** Primary platform currency */
+      PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
+      /** Experience points currency */
+      PLAYCADEMY_XP: "PLAYCADEMY_XP",
+      /** Core platform badges */
+      FOUNDING_MEMBER_BADGE: "FOUNDING_MEMBER_BADGE",
+      EARLY_ADOPTER_BADGE: "EARLY_ADOPTER_BADGE",
+      FIRST_GAME_BADGE: "FIRST_GAME_BADGE",
+      /** Example items */
+      COMMON_SWORD: "COMMON_SWORD",
+      SMALL_HEALTH_POTION: "SMALL_HEALTH_POTION",
+      SMALL_BACKPACK: "SMALL_BACKPACK",
+      /** Placeable items */
+      LAVA_LAMP: "LAVA_LAMP",
+      BOOMBOX: "BOOMBOX",
+      CABIN_BED: "CABIN_BED"
+    };
+    CURRENCIES = {
+      /** Primary platform currency slug */
+      PRIMARY: ITEM_SLUGS.PLAYCADEMY_CREDITS,
+      /** Experience points slug */
+      XP: ITEM_SLUGS.PLAYCADEMY_XP
+    };
+    BADGES = {
+      FOUNDING_MEMBER: ITEM_SLUGS.FOUNDING_MEMBER_BADGE,
+      EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
+      FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE
+    };
+    CORE_GAME_UUIDS = {
+      /** Internal playground game for development and testing */
+      PLAYGROUND: "00000000-0000-0000-0000-000000000001"
+    };
+  }
+});
+
+// ../constants/src/system.ts
+var init_system = __esm({
+  "../constants/src/system.ts"() {
+    "use strict";
+  }
+});
+
+// ../constants/src/timeback.ts
+var init_timeback2 = __esm({
+  "../constants/src/timeback.ts"() {
+    "use strict";
+  }
+});
+
+// ../constants/src/workers.ts
+var init_workers = __esm({
+  "../constants/src/workers.ts"() {
+    "use strict";
+  }
+});
+
+// ../constants/src/index.ts
+var init_src = __esm({
+  "../constants/src/index.ts"() {
+    "use strict";
+    init_auth();
+    init_domains();
+    init_env_vars();
+    init_overworld();
+    init_system();
+    init_timeback2();
+    init_workers();
+  }
+});
+
+// src/constants/urls.ts
+var init_urls = __esm({
+  "src/constants/urls.ts"() {
+    "use strict";
+    init_src();
+  }
+});
 
 // src/constants/index.ts
-var CLOUDFLARE_COMPATIBILITY_DATE = "2024-01-01";
+var CLOUDFLARE_COMPATIBILITY_DATE;
+var init_constants = __esm({
+  "src/constants/index.ts"() {
+    "use strict";
+    init_api();
+    init_config();
+    init_database();
+    init_http_server();
+    init_paths();
+    init_ports();
+    init_timeback();
+    init_urls();
+    CLOUDFLARE_COMPATIBILITY_DATE = "2024-01-01";
+  }
+});
 
-// src/lib/config/loader.ts
-var ConfigError = class extends Error {
-  constructor(message, field, suggestion) {
-    super(message);
-    this.field = field;
-    this.suggestion = suggestion;
-    this.name = "ConfigError";
-  }
-  /**
-   * Format a user-friendly error message with the field and suggestion
-   */
-  toString() {
-    let msg = `Configuration Error: ${this.message}`;
-    if (this.field) {
-      msg += `
-  Field: ${this.field}`;
-    }
-    if (this.suggestion) {
-      msg += `
-  Suggestion: ${this.suggestion}`;
-    }
-    return msg;
+// src/constants.ts
+var init_constants2 = __esm({
+  "src/constants.ts"() {
+    "use strict";
+    init_constants();
   }
-};
+});
+
+// src/lib/config/loader.ts
+import { dirname as dirname2, resolve as resolve2 } from "path";
 async function findConfigPath(configPath) {
   const { findFile: findFile2 } = await Promise.resolve().then(() => (init_file_loader(), file_loader_exports));
   if (configPath) {
@@ -565,89 +700,37 @@ function processConfigVariables(config) {
   };
   return processValue(processed);
 }
-
-// src/lib/dev/server.ts
-import { mkdir as mkdir2 } from "fs/promises";
-import { join as join9 } from "path";
-import { Log, LogLevel, Miniflare } from "miniflare";
-
-// ../utils/src/port.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { createServer } from "node:net";
-import { homedir } from "node:os";
-import { join as join2 } from "node:path";
-async function isPortAvailableOnHost(port, host) {
-  return new Promise((resolve4) => {
-    const server = createServer();
-    server.once("error", () => {
-      resolve4(false);
-    });
-    server.once("listening", () => {
-      server.close();
-      resolve4(true);
-    });
-    server.listen(port, host);
-  });
-}
-async function findAvailablePort(startPort = 4321) {
-  const [localhostAvailable, ipv4AllAvailable, ipv6AllAvailable] = await Promise.all([
-    isPortAvailableOnHost(startPort, "127.0.0.1"),
-    isPortAvailableOnHost(startPort, "0.0.0.0"),
-    isPortAvailableOnHost(startPort, "::")
-  ]);
-  if (localhostAvailable && ipv4AllAvailable && ipv6AllAvailable) {
-    return startPort;
-  }
-  return findAvailablePort(startPort + 1);
-}
-function getRegistryPath() {
-  const home = homedir();
-  const dir = join2(home, ".playcademy");
-  if (!existsSync2(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  return join2(dir, ".proc");
-}
-function readRegistry() {
-  const registryPath = getRegistryPath();
-  if (!existsSync2(registryPath)) {
-    return {};
-  }
-  try {
-    const content = readFileSync(registryPath, "utf-8");
-    return JSON.parse(content);
-  } catch {
-    return {};
-  }
-}
-function writeRegistry(registry) {
-  const registryPath = getRegistryPath();
-  writeFileSync(registryPath, JSON.stringify(registry, null, 2), "utf-8");
-}
-function getServerKey(type, port) {
-  return `${type}-${port}`;
-}
-function writeServerInfo(type, info) {
-  const registry = readRegistry();
-  const key = getServerKey(type, info.port);
-  registry[key] = info;
-  writeRegistry(registry);
-}
-function readServerInfo(type, projectRoot) {
-  const registry = readRegistry();
-  const servers = Object.entries(registry).filter(([key]) => key.startsWith(`${type}-`)).map(([, info]) => info);
-  if (servers.length === 0) {
-    return null;
-  }
-  if (projectRoot) {
-    const match = servers.find((s) => s.projectRoot === projectRoot);
-    return match || null;
+var ConfigError;
+var init_loader = __esm({
+  "src/lib/config/loader.ts"() {
+    "use strict";
+    init_file_loader();
+    init_constants2();
+    ConfigError = class extends Error {
+      constructor(message, field, suggestion) {
+        super(message);
+        this.field = field;
+        this.suggestion = suggestion;
+        this.name = "ConfigError";
+      }
+      /**
+       * Format a user-friendly error message with the field and suggestion
+       */
+      toString() {
+        let msg = `Configuration Error: ${this.message}`;
+        if (this.field) {
+          msg += `
+  Field: ${this.field}`;
+        }
+        if (this.suggestion) {
+          msg += `
+  Suggestion: ${this.suggestion}`;
+        }
+        return msg;
+      }
+    };
   }
-  return servers[0] || null;
-}
-
-// src/lib/core/client.ts
-import { PlaycademyClient } from "@playcademy/sdk";
+});
 
 // ../utils/src/package-manager.ts
 import { execSync } from "child_process";
@@ -701,16 +784,29 @@ function getInstallCommand(pm) {
       return "npm install";
   }
 }
+var init_package_manager = __esm({
+  "../utils/src/package-manager.ts"() {
+    "use strict";
+  }
+});
 
 // src/lib/core/context.ts
-var context = {};
 function getWorkspace() {
   return context.workspace || process.cwd();
 }
+var context;
+var init_context = __esm({
+  "src/lib/core/context.ts"() {
+    "use strict";
+    init_package_manager();
+    context = {};
+  }
+});
 
 // src/lib/core/logger.ts
 import {
   blue,
+  blueBright,
   bold,
   cyan,
   dim,
@@ -723,8 +819,10 @@ import {
 } from "colorette";
 import { colorize } from "json-colorizer";
 function customTransform(text) {
-  const highlightCode = (text2) => text2.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
-  return highlightCode(text);
+  let result = text;
+  result = result.replace(/`([^`]+)`/g, (_, code) => greenBright(code));
+  result = result.replace(/<([^>]+)>/g, (_, path2) => blueBright(path2));
+  return result;
 }
 function formatTable(data, title) {
   if (data.length === 0) return;
@@ -757,159 +855,195 @@ function formatTable(data, title) {
   });
   console.log(bottomBorder);
 }
-var logger = {
-  table: (data, title) => {
-    formatTable(data, title);
-  },
-  /**
-   * Info message - general information
-   */
-  info: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${blue("\u2139")} ${bold(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 } = configs[type];
-    console.log(`${spaces}${color("\u250C\u2500")} ${bold(color(title.toUpperCase()))}`);
-    if (lines && lines.length > 0) {
-      lines.forEach((line) => {
-        console.log(`${spaces}${color("\u2502")} ${customTransform(line)}`);
-      });
-    }
-    console.log(`${spaces}${color("\u2514\u2500")}`);
-  },
-  /**
-   * Dim message - less important information
-   */
-  dim: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${dim(customTransform(message))}`);
-  },
-  /**
-   * Success message - operation completed successfully
-   */
-  success: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${green("\u2714")} ${bold(customTransform(message))}`);
-  },
-  remark: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${bold(yellowBright("\u2726"))} ${bold(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}${bold(customTransform(message))}`);
-  },
-  /**
-   * Warning message - something to be aware of
-   */
-  warn: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.warn(`${spaces}${yellow("\u26A0")} ${bold(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(bold(`${spaces}${cyan(customTransform(message))}`));
-  },
-  /**
-   * Aside message - for side information
-   */
-  aside: (message, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${bold(customTransform(message))}`);
-  },
-  /**
-   * Data display - for structured data output
-   */
-  data: (label, value, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    if (value !== void 0) {
-      console.log(`${spaces}${dim(label + ":")} ${bold(value)}`);
-    } else {
-      console.log(`${spaces}${dim(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: (text, indent = 0) => {
-    const spaces = "  ".repeat(indent);
-    console.log(`${spaces}${text}`);
-  },
-  /**
-   * 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")} ${bold(configErr.message)}`);
-      if (configErr.field) {
-        console.error(`${spaces}  ${dim("Field:")} ${configErr.field}`);
-      }
-      if (configErr.suggestion) {
-        console.error(`${spaces}  ${dim("Fix:")} ${configErr.suggestion}`);
+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")} ${bold(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 } = configs[type];
+        console.log(`${spaces}${color("\u250C\u2500")} ${bold(color(title.toUpperCase()))}`);
+        if (lines && lines.length > 0) {
+          lines.forEach((line) => {
+            console.log(`${spaces}${color("\u2502")} ${customTransform(line)}`);
+          });
+        }
+        console.log(`${spaces}${color("\u2514\u2500")}`);
+      },
+      /**
+       * Dim message - less important information
+       */
+      dim: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${dim(customTransform(message))}`);
+      },
+      /**
+       * Success message - operation completed successfully
+       */
+      success: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${green("\u2714")} ${bold(customTransform(message))}`);
+      },
+      remark: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${bold(yellowBright("\u2726"))} ${bold(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}${bold(customTransform(message))}`);
+      },
+      /**
+       * Warning message - something to be aware of
+       */
+      warn: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.warn(`${spaces}${yellow("\u26A0")} ${bold(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(bold(`${spaces}${cyan(customTransform(message))}`));
+      },
+      /**
+       * Aside message - for side information
+       */
+      aside: (message, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${bold(customTransform(message))}`);
+      },
+      /**
+       * Data display - for structured data output
+       */
+      data: (label, value, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        if (value !== void 0) {
+          console.log(`${spaces}${dim(label + ":")} ${bold(value)}`);
+        } else {
+          console.log(`${spaces}${dim(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: (text, indent = 0) => {
+        const spaces = "  ".repeat(indent);
+        console.log(`${spaces}${text}`);
+      },
+      /**
+       * 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")} ${bold(configErr.message)}`);
+          if (configErr.field) {
+            console.error(`${spaces}  ${dim("Field:")} ${configErr.field}`);
+          }
+          if (configErr.suggestion) {
+            console.error(`${spaces}  ${dim("Fix:")} ${configErr.suggestion}`);
+          }
+        } else if (error instanceof Error) {
+          console.error(`${spaces}${red("\u2716")} ${bold(error.message)}`);
+        } else {
+          console.error(`${spaces}${red("\u2716")} ${bold(String(error))}`);
+        }
       }
-    } else if (error instanceof Error) {
-      console.error(`${spaces}${red("\u2716")} ${bold(error.message)}`);
-    } else {
-      console.error(`${spaces}${red("\u2716")} ${bold(String(error))}`);
-    }
+    };
   }
-};
+});
+
+// src/lib/core/config.ts
+var init_config2 = __esm({
+  "src/lib/core/config.ts"() {
+    "use strict";
+    init_constants2();
+    init_context();
+    init_logger();
+  }
+});
+
+// src/lib/auth/storage.ts
+var init_storage = __esm({
+  "src/lib/auth/storage.ts"() {
+    "use strict";
+    init_constants2();
+    init_config2();
+  }
+});
+
+// src/lib/core/client.ts
+import { PlaycademyClient } from "@playcademy/sdk";
+var init_client = __esm({
+  "src/lib/core/client.ts"() {
+    "use strict";
+    init_storage();
+    init_logger();
+    init_config2();
+  }
+});
 
 // src/lib/core/errors.ts
 function getErrorMessage(error) {
@@ -920,34 +1054,141 @@ function getErrorMessage(error) {
   }
   return "Unknown error";
 }
+var init_errors = __esm({
+  "src/lib/core/errors.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/uuid.ts
+var init_uuid = __esm({
+  "../utils/src/uuid.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/mime.ts
+var init_mime = __esm({
+  "../utils/src/mime.ts"() {
+    "use strict";
+  }
+});
 
 // ../utils/src/ansi.ts
-var isInteractive = typeof process !== "undefined" && process.stdout?.isTTY && !process.env.CI && process.env.TERM !== "dumb";
+var isInteractive;
+var init_ansi = __esm({
+  "../utils/src/ansi.ts"() {
+    "use strict";
+    isInteractive = typeof process !== "undefined" && process.stdout?.isTTY && !process.env.CI && process.env.TERM !== "dumb";
+  }
+});
 
 // ../utils/src/spinner.ts
-var SPINNER_FRAMES = [
-  10251,
-  10265,
-  10297,
-  10296,
-  10300,
-  10292,
-  10278,
-  10279,
-  10247,
-  10255
-].map((code) => String.fromCodePoint(code));
-var CHECK_MARK = String.fromCodePoint(10004);
-var CROSS_MARK = String.fromCodePoint(10006);
+var SPINNER_FRAMES, CHECK_MARK, CROSS_MARK;
+var init_spinner = __esm({
+  "../utils/src/spinner.ts"() {
+    "use strict";
+    init_ansi();
+    SPINNER_FRAMES = [
+      10251,
+      10265,
+      10297,
+      10296,
+      10300,
+      10292,
+      10278,
+      10279,
+      10247,
+      10255
+    ].map((code) => String.fromCodePoint(code));
+    CHECK_MARK = String.fromCodePoint(10004);
+    CROSS_MARK = String.fromCodePoint(10006);
+  }
+});
+
+// ../utils/src/log.ts
+var init_log = __esm({
+  "../utils/src/log.ts"() {
+    "use strict";
+    init_ansi();
+    init_spinner();
+  }
+});
+
+// ../utils/src/name.ts
+var init_name = __esm({
+  "../utils/src/name.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/string.ts
+function pluralize(count, singular, plural) {
+  return count === 1 ? singular : plural || `${singular}s`;
+}
+var init_string = __esm({
+  "../utils/src/string.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/lifecycle.ts
+var init_lifecycle = __esm({
+  "../utils/src/lifecycle.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/timezone.ts
+var init_timezone = __esm({
+  "../utils/src/timezone.ts"() {
+    "use strict";
+  }
+});
+
+// ../utils/src/slug.ts
+var init_slug = __esm({
+  "../utils/src/slug.ts"() {
+    "use strict";
+  }
+});
 
 // ../utils/src/pure/index.ts
-init_package_json();
+var init_pure = __esm({
+  "../utils/src/pure/index.ts"() {
+    "use strict";
+    init_uuid();
+    init_mime();
+    init_log();
+    init_name();
+    init_string();
+    init_lifecycle();
+    init_timezone();
+    init_package_json();
+    init_slug();
+  }
+});
+
+// ../utils/src/index.ts
+var init_src2 = __esm({
+  "../utils/src/index.ts"() {
+    "use strict";
+    init_pure();
+  }
+});
+
+// src/lib/config/timeback-derive.ts
+var init_timeback_derive = __esm({
+  "src/lib/config/timeback-derive.ts"() {
+    "use strict";
+    init_game();
+  }
+});
 
 // src/lib/templates/loader.ts
 import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
 import { dirname as dirname3, resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
-var currentDir = dirname3(fileURLToPath(import.meta.url));
 function loadTemplateString(filename) {
   const filenamesToTry = filename.endsWith(".template") ? [filename] : [filename, `${filename}.template`];
   const candidatePaths = filenamesToTry.flatMap((name) => [
@@ -963,6 +1204,49 @@ function loadTemplateString(filename) {
   }
   throw new Error(`Template not found: ${filename}. Searched: ${candidatePaths.join(", ")}`);
 }
+var currentDir;
+var init_loader2 = __esm({
+  "src/lib/templates/loader.ts"() {
+    "use strict";
+    currentDir = dirname3(fileURLToPath(import.meta.url));
+  }
+});
+
+// src/lib/config/generator.ts
+var init_generator = __esm({
+  "src/lib/config/generator.ts"() {
+    "use strict";
+    init_loader2();
+  }
+});
+
+// src/lib/config/writer.ts
+var init_writer = __esm({
+  "src/lib/config/writer.ts"() {
+    "use strict";
+  }
+});
+
+// src/lib/config/index.ts
+var init_config3 = __esm({
+  "src/lib/config/index.ts"() {
+    "use strict";
+    init_loader();
+    init_timeback_derive();
+    init_generator();
+    init_writer();
+  }
+});
+
+// src/lib/core/game.ts
+var init_game = __esm({
+  "src/lib/core/game.ts"() {
+    "use strict";
+    init_src2();
+    init_slug();
+    init_config3();
+  }
+});
 
 // src/lib/core/import.ts
 import { mkdtempSync, rmSync } from "fs";
@@ -998,13 +1282,135 @@ async function importTypescriptDefault(filePath, bundleOptions) {
   }
   return module;
 }
+var init_import = __esm({
+  "src/lib/core/import.ts"() {
+    "use strict";
+  }
+});
+
+// src/lib/core/index.ts
+var init_core = __esm({
+  "src/lib/core/index.ts"() {
+    "use strict";
+    init_client();
+    init_config2();
+    init_context();
+    init_errors();
+    init_game();
+    init_import();
+    init_logger();
+  }
+});
+
+// src/utils.ts
+init_loader();
+init_loader();
+init_loader();
+
+// src/lib/dev/server.ts
+init_src();
+import { mkdir as mkdir2 } from "fs/promises";
+import { join as join12 } from "path";
+import { Log, LogLevel, Miniflare } from "miniflare";
+
+// ../utils/src/port.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { join as join2 } from "node:path";
+async function isPortAvailableOnHost(port, host) {
+  return new Promise((resolve4) => {
+    const server = createServer();
+    let resolved = false;
+    const cleanup = (result) => {
+      if (resolved) return;
+      resolved = true;
+      try {
+        server.close();
+      } catch {
+      }
+      resolve4(result);
+    };
+    const timeout = setTimeout(() => cleanup(true), 100);
+    server.once("error", (err) => {
+      clearTimeout(timeout);
+      if (err.code === "EAFNOSUPPORT" || err.code === "EADDRNOTAVAIL") {
+        cleanup(true);
+      } else {
+        cleanup(false);
+      }
+    });
+    server.once("listening", () => {
+      clearTimeout(timeout);
+      cleanup(true);
+    });
+    server.listen(port, host).unref();
+  });
+}
+async function findAvailablePort(startPort = 4321) {
+  if (await isPortAvailableOnHost(startPort, "0.0.0.0")) {
+    return startPort;
+  } else {
+    return findAvailablePort(startPort + 1);
+  }
+}
+function getRegistryPath() {
+  const home = homedir();
+  const dir = join2(home, ".playcademy");
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  return join2(dir, ".proc");
+}
+function readRegistry() {
+  const registryPath = getRegistryPath();
+  if (!existsSync2(registryPath)) {
+    return {};
+  }
+  try {
+    const content = readFileSync(registryPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+function writeRegistry(registry) {
+  const registryPath = getRegistryPath();
+  writeFileSync(registryPath, JSON.stringify(registry, null, 2), "utf-8");
+}
+function getServerKey(type, port) {
+  return `${type}-${port}`;
+}
+function writeServerInfo(type, info) {
+  const registry = readRegistry();
+  const key = getServerKey(type, info.port);
+  registry[key] = info;
+  writeRegistry(registry);
+}
+function readServerInfo(type, projectRoot) {
+  const registry = readRegistry();
+  const servers = Object.entries(registry).filter(([key]) => key.startsWith(`${type}-`)).map(([, info]) => info);
+  if (servers.length === 0) {
+    return null;
+  }
+  if (projectRoot) {
+    const match = servers.find((s) => s.projectRoot === projectRoot);
+    return match || null;
+  }
+  return servers[0] || null;
+}
+
+// src/lib/dev/server.ts
+init_constants2();
+init_loader();
+init_core();
 
 // src/lib/deploy/bundle.ts
 import { existsSync as existsSync5 } from "fs";
 import { join as join6 } from "path";
 
 // ../edge-play/src/entry.ts
-var entry_default = "/**\n * Game Backend Entry Point\n *\n * This file is the main entry point for deployed game backends.\n * It creates a Hono app and registers all enabled integration routes.\n *\n * Bundled with esbuild and deployed to Cloudflare Workers (or AWS Lambda).\n * Config is injected at build time via esbuild's `define` option.\n */\n\nimport { Hono } from 'hono'\nimport { cors } from 'hono/cors'\n\nimport { PlaycademyClient } from '@playcademy/sdk/server'\n\nimport { ENV_VARS } from './constants'\nimport { registerBuiltinRoutes } from './register-routes'\n\nimport type { PlaycademyConfig } from '@playcademy/sdk/server'\nimport type { HonoEnv } from './types'\n\n/**\n * Config injected at build time by esbuild\n *\n * The `declare const` tells TypeScript \"this exists at runtime, trust me.\"\n * During bundling, esbuild's `define` option does literal text replacement:\n *\n * Example bundling:\n *   Source:  if (PLAYCADEMY_CONFIG.integrations.timeback) { ... }\n *   Define:  { 'PLAYCADEMY_CONFIG': JSON.stringify({ integrations: { timeback: {...} } }) }\n *   Output:  if ({\"integrations\":{\"timeback\":{...}}}.integrations.timeback) { ... }\n *\n * This enables tree-shaking: if timeback is not configured, those code paths are removed.\n * The bundled Worker only includes the routes that are actually enabled.\n */\ndeclare const PLAYCADEMY_CONFIG: PlaycademyConfig & {\n    customRoutes?: Array<{ path: string; file: string }>\n}\n\n// XXX: Polyfill process global for SDK compatibility\n// SDK code may reference process.env without importing it\n// @ts-expect-error - Adding global for Worker environment\nglobalThis.process = {\n    env: {}, // Populated per-request from Worker env bindings\n    cwd: () => '/',\n}\n\nconst app = new Hono<HonoEnv>()\n\n// TODO: Harden CORS in production - restrict to trusted origins:\n// - Game's assetBundleBase (for hosted games)\n// - Game's externalUrl (for external games)\n// - Platform frontend domains (hub.playcademy.com, hub.dev.playcademy.net)\n// This would require passing game metadata through env bindings during deployment\napp.use(\n    '*',\n    cors({\n        origin: '*', // Permissive for now\n        allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],\n        allowHeaders: ['Content-Type', 'Authorization'],\n    }),\n)\n\nlet sdkPromise: Promise<PlaycademyClient> | null = null\n\napp.use('*', async (c, next) => {\n    // Populate process.env from Worker bindings for SDK compatibility\n    globalThis.process.env = {\n        [ENV_VARS.PLAYCADEMY_API_KEY]: c.env.PLAYCADEMY_API_KEY,\n        [ENV_VARS.GAME_ID]: c.env.GAME_ID,\n        [ENV_VARS.PLAYCADEMY_BASE_URL]: c.env.PLAYCADEMY_BASE_URL,\n    }\n\n    // Set config for all routes\n    c.set('config', PLAYCADEMY_CONFIG)\n    c.set('customRoutes', PLAYCADEMY_CONFIG.customRoutes || [])\n\n    await next()\n})\n\n// Initialize SDK lazily on first request\napp.use('*', async (c, next) => {\n    if (!sdkPromise) {\n        sdkPromise = PlaycademyClient.init({\n            apiKey: c.env[ENV_VARS.PLAYCADEMY_API_KEY],\n            gameId: c.env[ENV_VARS.GAME_ID],\n            baseUrl: c.env[ENV_VARS.PLAYCADEMY_BASE_URL],\n            config: PLAYCADEMY_CONFIG,\n        })\n    }\n\n    c.set('sdk', await sdkPromise)\n    await next()\n})\n\n/**\n * Register built-in integration routes based on enabled integrations\n *\n * This function conditionally imports and registers routes like:\n * - POST /api/integrations/timeback/end-activity (if timeback enabled)\n * - GET /api/health (always included)\n *\n * Uses dynamic imports for tree-shaking: if an integration is not enabled,\n * its route code is completely removed from the bundle.\n */\nawait registerBuiltinRoutes(app, PLAYCADEMY_CONFIG.integrations)\n\nexport default app\n";
+var entry_default = "/**\n * Game Backend Entry Point\n *\n * This file is the main entry point for deployed game backends.\n * It creates a Hono app and registers all enabled integration routes.\n *\n * Bundled with esbuild and deployed to Cloudflare Workers (or AWS Lambda).\n * Config is injected at build time via esbuild's `define` option.\n */\n\nimport { Hono } from 'hono'\n\nimport { registerCors, registerEnvSetup, registerSdkInit } from './entry/middleware'\nimport { setupProcessGlobal } from './entry/setup'\nimport { registerBuiltinRoutes } from './register-routes'\n\nimport type { RuntimeConfig } from './entry/types'\nimport type { HonoEnv } from './types'\n\n/**\n * Config injected at build time by esbuild\n *\n * The `declare const` tells TypeScript \"this exists at runtime, trust me.\"\n * During bundling, esbuild's `define` option does literal text replacement:\n *\n * Example bundling:\n *   Source:  if (PLAYCADEMY_CONFIG.integrations.timeback) { ... }\n *   Define:  { 'PLAYCADEMY_CONFIG': JSON.stringify({ integrations: { timeback: {...} } }) }\n *   Output:  if ({\"integrations\":{\"timeback\":{...}}}.integrations.timeback) { ... }\n *\n * This enables tree-shaking: if timeback is not configured, those code paths are removed.\n * The bundled Worker only includes the routes that are actually enabled.\n */\ndeclare const PLAYCADEMY_CONFIG: RuntimeConfig\n\n// Setup process global polyfill for SDK compatibility\nsetupProcessGlobal()\n\n// Create Hono app\nconst app = new Hono<HonoEnv>()\n\n// Register middleware\nregisterCors(app)\nregisterEnvSetup(app, PLAYCADEMY_CONFIG)\nregisterSdkInit(app, PLAYCADEMY_CONFIG)\n\n// Register built-in integration routes based on enabled integrations\n// This function conditionally imports and registers routes like:\n// - GET /api (always included)\n// - GET /api/health (always included)\n// - POST /api/integrations/timeback/end-activity (if timeback enabled)\n//\n// Uses dynamic imports for tree-shaking: if an integration is not enabled,\n// its route code is completely removed from the bundle.\nawait registerBuiltinRoutes(app, PLAYCADEMY_CONFIG.integrations)\n\nexport default app\n";
 
 // ../utils/src/path.ts
 import fs from "node:fs";
@@ -1220,6 +1626,9 @@ function getMonorepoRoot() {
   return memoizedRoot;
 }
 
+// src/lib/deploy/bundle.ts
+init_constants2();
+
 // src/lib/build/plugins.ts
 function textLoaderPlugin() {
   return {
@@ -1253,8 +1662,12 @@ function textLoaderPlugin() {
   };
 }
 
+// src/lib/deploy/bundle.ts
+init_core();
+
 // src/lib/dev/routes.ts
 init_file_loader();
+init_core();
 import { mkdir, writeFile } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join5, relative } from "path";
@@ -1454,7 +1867,7 @@ async function bundleBackend(config, options = {}) {
   const { customRouteData, customRoutesDir } = await discoverCustomRoutes(config);
   const bundleConfig = {
     ...config,
-    customRoutes: customRouteData
+    __routeMetadata: customRouteData
   };
   const entryCode = generateEntryCode(customRouteData, customRoutesDir);
   const paths = resolveEmbeddedSourcePaths();
@@ -1504,8 +1917,19 @@ function generateEntryCode(customRoutes, customRoutesDir) {
 // src/lib/init/prompts.ts
 import { checkbox, confirm, input, select } from "@inquirer/prompts";
 import { bold as bold3, cyan as cyan2 } from "colorette";
+init_constants2();
+
+// src/lib/init/scaffold.ts
+init_constants2();
+init_core();
+init_loader2();
 
 // src/lib/init/database.ts
+init_log();
+init_slug();
+init_core();
+init_logger();
+init_loader2();
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { join as join7 } from "path";
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -1530,7 +1954,9 @@ var sampleBucketRouteTemplate = loadTemplateString("api/sample-bucket.ts");
 var playcademyGitignoreTemplate = loadTemplateString("playcademy-gitignore");
 
 // src/lib/init/display.ts
-import { blueBright } from "colorette";
+init_package_manager();
+init_context();
+init_logger();
 
 // src/lib/init/kv.ts
 function hasKVSetup(config) {
@@ -1544,57 +1970,292 @@ function hasBucketSetup(config) {
 
 // src/lib/init/types.ts
 init_file_loader();
+init_package_manager();
+init_string();
+init_constants2();
+init_loader();
+init_core();
 import { execSync as execSync2 } from "child_process";
-import { writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname4, join as join8 } from "path";
+import { writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname4, join as join11 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/lib/deploy/backend.ts
+init_src2();
+init_constants2();
+init_core();
+import { existsSync as existsSync7 } from "node:fs";
+import { join as join8 } from "node:path";
+
+// src/lib/integrations/timeback.ts
+init_src2();
+init_core();
+
+// src/lib/integrations/utils.ts
+init_string();
+
+// src/lib/deploy/schema.ts
+init_core();
+
+// src/lib/deploy/secrets.ts
+init_core();
+init_logger();
+
+// src/lib/deploy/utils.ts
+init_src();
+
+// src/lib/deploy/backend.ts
+function getCustomRoutesDirectory(projectPath, config) {
+  const customRoutes = config?.integrations?.customRoutes;
+  const customRoutesDir = typeof customRoutes === "object" && customRoutes.directory || DEFAULT_API_ROUTES_DIRECTORY;
+  return join8(projectPath, customRoutesDir);
+}
+function hasLocalCustomRoutes(projectPath, config) {
+  const customRoutesDir = getCustomRoutesDirectory(projectPath, config);
+  return existsSync7(customRoutesDir);
+}
+
+// src/lib/secrets/env.ts
+init_file_loader();
+init_constants2();
+import { existsSync as existsSync8 } from "fs";
+import { join as join9 } from "path";
+function parseEnvFile(contents) {
+  const secrets = {};
+  for (const line of contents.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+    const match = trimmed.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+    if (match) {
+      const [, key, value] = match;
+      if (!key || !value) {
+        continue;
+      }
+      const unquoted = value.replace(/^["']|["']$/g, "");
+      secrets[key] = unquoted;
+    }
+  }
+  return secrets;
+}
+async function readEnvFile(workspace) {
+  let secrets = {};
+  for (const filename of ENV_FILES) {
+    try {
+      const contents = await loadFile(filename, { cwd: workspace, searchUp: false });
+      if (contents) {
+        const fileSecrets = parseEnvFile(contents);
+        secrets = { ...secrets, ...fileSecrets };
+      }
+    } catch {
+      continue;
+    }
+  }
+  return secrets;
+}
+function getLoadedEnvFiles(workspace) {
+  return ENV_FILES.filter((filename) => existsSync8(join9(workspace, filename)));
+}
+function hasEnvFile(workspace) {
+  return ENV_FILES.some((filename) => existsSync8(join9(workspace, filename)));
+}
+
+// src/lib/init/types.ts
+init_loader2();
+
+// src/lib/init/tsconfig.ts
+init_file_loader();
+init_constants2();
+import { existsSync as existsSync9, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { join as join10 } from "path";
+function hasPlaycademyEnv(config) {
+  return config.include?.includes("playcademy-env.d.ts") ?? false;
+}
+function addPlaycademyEnv(config) {
+  if (!config.include) {
+    config.include = [];
+  }
+  config.include.push("playcademy-env.d.ts");
+}
+function updateExistingIncludeArray(content) {
+  const includeRegex = /"include"\s*:\s*\[([^\]]*)\]/;
+  const match = content.match(includeRegex);
+  if (!match || !match[1]) {
+    return null;
+  }
+  const fullMatch = match[0];
+  const arrayContents = match[1];
+  if (arrayContents.includes("playcademy-env.d.ts")) {
+    return content;
+  }
+  const trimmedContents = arrayContents.trim();
+  const newEntry = '"playcademy-env.d.ts"';
+  let newArrayContents;
+  if (trimmedContents === "") {
+    newArrayContents = newEntry;
+  } else if (arrayContents.includes("\n")) {
+    newArrayContents = `${arrayContents},
+        ${newEntry}
+    `;
+  } else {
+    newArrayContents = `${trimmedContents}, ${newEntry}`;
+  }
+  const newIncludeArray = `"include": [${newArrayContents}]`;
+  return content.replace(fullMatch, newIncludeArray);
+}
+function addNewIncludeProperty(content) {
+  const closingBraceMatch = content.match(/\n(\s*)\}(\s*)$/);
+  if (!closingBraceMatch || closingBraceMatch.index === void 0) {
+    return null;
+  }
+  const propertyMatch = content.match(/\n(\s+)"/);
+  const propertyIndent = propertyMatch ? propertyMatch[1] : "    ";
+  const insertPosition = closingBraceMatch.index;
+  const beforeClosing = content.slice(0, insertPosition).trim();
+  const needsComma = beforeClosing.endsWith("]") || beforeClosing.endsWith("}") || beforeClosing.endsWith('"');
+  const comma = needsComma ? "," : "";
+  const includeEntry = `${comma}
+${propertyIndent}"include": ["playcademy-env.d.ts"]`;
+  const updatedContent = content.slice(0, insertPosition) + includeEntry + content.slice(insertPosition);
+  return updatedContent;
+}
+function addToIncludeArrayPreservingComments(content) {
+  return updateExistingIncludeArray(content) || addNewIncludeProperty(content);
+}
+async function ensureTsconfigIncludes(workspace) {
+  for (const filename of TSCONFIG_FILES) {
+    const configPath = join10(workspace, filename);
+    if (!existsSync9(configPath)) {
+      continue;
+    }
+    try {
+      const config = await loadFile(configPath, {
+        parseJson: true,
+        stripComments: true
+      });
+      if (!config) continue;
+      if (config.references && filename !== "tsconfig.json") {
+        continue;
+      }
+      if (hasPlaycademyEnv(config)) {
+        return filename;
+      }
+      try {
+        const rawContent = readFileSync4(configPath, "utf-8");
+        const updatedContent = addToIncludeArrayPreservingComments(rawContent);
+        if (updatedContent && updatedContent !== rawContent) {
+          writeFileSync3(configPath, updatedContent);
+          return filename;
+        }
+      } catch {
+      }
+      addPlaycademyEnv(config);
+      writeFileSync3(configPath, JSON.stringify(config, null, 4) + "\n");
+      return filename;
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+// src/lib/init/types.ts
 var playcademyEnvTemplate = loadTemplateString("playcademy-env.d.ts");
-async function ensurePlaycademyTypes() {
+function detectBackendFeatures(workspace, config) {
+  return {
+    hasDB: hasDatabaseSetup(),
+    hasKV: hasKVSetup(config),
+    hasBucket: hasBucketSetup(config),
+    hasRoutes: hasLocalCustomRoutes(workspace, config),
+    hasSecrets: hasEnvFile(workspace)
+  };
+}
+function hasAnyBackend(features) {
+  return Object.values(features).some(Boolean);
+}
+async function setupPlaycademyDependencies(workspace) {
+  const playcademyDir = join11(workspace, CLI_DIRECTORIES.WORKSPACE);
+  const playcademyPkgPath = join11(playcademyDir, "package.json");
+  const __dirname = dirname4(fileURLToPath2(import.meta.url));
+  const cliPkg = await loadPackageJson({ cwd: __dirname, searchUp: true, required: true });
+  const workersTypesVersion = cliPkg?.devDependencies?.["@cloudflare/workers-types"] || "latest";
+  const honoVersion = cliPkg?.dependencies?.hono || "latest";
+  const playcademyPkg = {
+    private: true,
+    dependencies: { hono: honoVersion },
+    devDependencies: { "@cloudflare/workers-types": workersTypesVersion }
+  };
+  writeFileSync4(playcademyPkgPath, JSON.stringify(playcademyPkg, null, 4) + "\n");
+  const pm = detectPackageManager(workspace);
+  const installCmd = getInstallCommand(pm);
+  execSync2(installCmd, {
+    cwd: playcademyDir,
+    stdio: ["ignore", "ignore", "ignore"]
+  });
+}
+function generateBindingsTypeString(features) {
+  const bindings = [];
+  if (features.hasKV) bindings.push("        KV: KVNamespace");
+  if (features.hasDB) bindings.push("        DB: D1Database");
+  if (features.hasBucket) bindings.push("        BUCKET: R2Bucket");
+  return bindings.length > 0 ? "\n" + bindings.join("\n") : "";
+}
+async function generateSecretsTypeString(workspace, verbose = false) {
+  try {
+    const envSecrets = await readEnvFile(workspace);
+    const secretKeys = Object.keys(envSecrets);
+    if (secretKeys.length === 0) {
+      if (verbose) logger.success("No secrets in <.env> files");
+      return "\n        secrets: Record<string, string>";
+    }
+    if (verbose) {
+      const loadedFiles = getLoadedEnvFiles(workspace);
+      const fileList = loadedFiles.map((f) => `<${f}>`).join(", ");
+      logger.success(
+        `Loaded ${secretKeys.length} ${pluralize(secretKeys.length, "secret")} from ${fileList}`
+      );
+    }
+    const secretTypes = secretKeys.map((key) => `            ${key}: string`).join("\n");
+    return `
+        secrets: {
+${secretTypes}
+            [key: string]: string
+        }`;
+  } catch {
+    return "\n        secrets: Record<string, string>";
+  }
+}
+async function ensurePlaycademyTypes(options = {}) {
+  const { verbose = false } = options;
   try {
     const workspace = getWorkspace();
     const config = await loadConfig();
-    const hasDB = hasDatabaseSetup();
-    const hasKV = hasKVSetup(config);
-    const hasBucket = hasBucketSetup(config);
-    if (!hasDB && !hasKV && !hasBucket) {
+    const features = detectBackendFeatures(workspace, config);
+    if (!hasAnyBackend(features)) {
+      if (verbose) {
+        logger.dim("No backend functionality detected");
+      }
       return;
     }
-    const playcademyDir = join8(workspace, CLI_DIRECTORIES.WORKSPACE);
-    const playcademyPkgPath = join8(playcademyDir, "package.json");
-    const __dirname = dirname4(fileURLToPath2(import.meta.url));
-    const cliPkg = await loadPackageJson({ cwd: __dirname, searchUp: true, required: true });
-    const workersTypesVersion = cliPkg?.devDependencies?.["@cloudflare/workers-types"] || "latest";
-    const honoVersion = cliPkg?.dependencies?.hono || "latest";
-    const playcademyPkg = {
-      private: true,
-      dependencies: {
-        hono: honoVersion
-      },
-      devDependencies: {
-        "@cloudflare/workers-types": workersTypesVersion
-      }
-    };
-    writeFileSync3(playcademyPkgPath, JSON.stringify(playcademyPkg, null, 4) + "\n");
-    const pm = detectPackageManager(workspace);
-    const installCmd = getInstallCommand(pm);
-    execSync2(installCmd, {
-      cwd: playcademyDir,
-      stdio: ["ignore", "ignore", "ignore"]
-    });
-    const bindings = [];
-    if (hasKV) {
-      bindings.push("        KV: KVNamespace");
+    await setupPlaycademyDependencies(workspace);
+    if (verbose) {
+      logger.success(`Installed packages in <${CLI_DIRECTORIES.WORKSPACE}>`);
     }
-    if (hasDB) {
-      bindings.push("        DB: D1Database");
+    const bindingsStr = generateBindingsTypeString(features);
+    const secretsStr = await generateSecretsTypeString(workspace, verbose);
+    let envContent = playcademyEnvTemplate.replace("{{BINDINGS}}", bindingsStr);
+    envContent = envContent.replace("{{SECRETS}}", secretsStr);
+    const envPath = join11(workspace, "playcademy-env.d.ts");
+    writeFileSync4(envPath, envContent);
+    if (verbose) {
+      logger.success(`Generated <playcademy-env.d.ts>`);
     }
-    if (hasBucket) {
-      bindings.push("        BUCKET: R2Bucket");
+    const tsConfigFilename = await ensureTsconfigIncludes(workspace);
+    if (verbose) {
+      logger.success(`Updated <${tsConfigFilename}>`);
     }
-    const bindingsStr = bindings.length > 0 ? "\n" + bindings.join("\n") : "";
-    const envContent = playcademyEnvTemplate.replace("{{BINDINGS}}", bindingsStr);
-    const envPath = join8(workspace, "playcademy-env.d.ts");
-    writeFileSync3(envPath, envContent);
+    logger.newLine();
   } catch (error) {
     logger.warn(
       `Failed to generate TypeScript types: ${error instanceof Error ? error.message : String(error)}`
@@ -1603,6 +2264,8 @@ async function ensurePlaycademyTypes() {
 }
 
 // src/lib/init/gitignore.ts
+init_core();
+init_loader2();
 var rootGitignoreTemplate = loadTemplateString("gitignore");
 
 // src/lib/dev/server.ts
@@ -1629,9 +2292,19 @@ async function startDevServer(options) {
   const kvDir = hasKV ? await ensureKvDirectory() : void 0;
   const hasBucket = hasBucketSetup(config);
   const bucketDir = hasBucket ? await ensureBucketDirectory() : void 0;
+  const workspace = getWorkspace();
+  const envSecrets = await readEnvFile(workspace);
   const log2 = logger2 ? new FilteredLog(LogLevel.INFO) : new Log(LogLevel.NONE);
-  const sandboxInfo = readServerInfo("sandbox", getWorkspace());
+  const sandboxInfo = readServerInfo("sandbox", workspace);
   const baseUrl = platformUrl ?? sandboxInfo?.url ?? process.env.PLAYCADEMY_BASE_URL ?? `http://localhost:${DEFAULT_PORTS.SANDBOX}`;
+  const bindings = {
+    PLAYCADEMY_API_KEY: process.env.PLAYCADEMY_API_KEY || "dev-api-key",
+    GAME_ID: CORE_GAME_UUIDS.PLAYGROUND,
+    PLAYCADEMY_BASE_URL: baseUrl
+  };
+  for (const [key, value] of Object.entries(envSecrets)) {
+    bindings[`secrets_${key}`] = value;
+  }
   const mf = new Miniflare({
     port,
     log: log2,
@@ -1642,11 +2315,7 @@ async function startDevServer(options) {
         contents: bundle.code
       }
     ],
-    bindings: {
-      PLAYCADEMY_API_KEY: process.env.PLAYCADEMY_API_KEY || "dev-api-key",
-      GAME_ID: CORE_GAME_UUIDS.PLAYGROUND,
-      PLAYCADEMY_BASE_URL: baseUrl
-    },
+    bindings,
     d1Databases: hasDatabase ? ["DB"] : [],
     d1Persist: dbDir,
     kvNamespaces: hasKV ? ["KV"] : [],
@@ -1662,7 +2331,7 @@ async function startDevServer(options) {
   return { server: mf, port };
 }
 async function ensureDatabaseDirectory() {
-  const dbDir = join9(getWorkspace(), CLI_DIRECTORIES.DATABASE);
+  const dbDir = join12(getWorkspace(), CLI_DIRECTORIES.DATABASE);
   try {
     await mkdir2(dbDir, { recursive: true });
   } catch (error) {
@@ -1671,7 +2340,7 @@ async function ensureDatabaseDirectory() {
   return dbDir;
 }
 async function ensureKvDirectory() {
-  const kvDir = join9(getWorkspace(), CLI_DIRECTORIES.KV);
+  const kvDir = join12(getWorkspace(), CLI_DIRECTORIES.KV);
   try {
     await mkdir2(kvDir, { recursive: true });
   } catch (error) {
@@ -1680,7 +2349,7 @@ async function ensureKvDirectory() {
   return kvDir;
 }
 async function ensureBucketDirectory() {
-  const bucketDir = join9(getWorkspace(), CLI_DIRECTORIES.BUCKET);
+  const bucketDir = join12(getWorkspace(), CLI_DIRECTORIES.BUCKET);
   try {
     await mkdir2(bucketDir, { recursive: true });
   } catch (error) {
@@ -1703,7 +2372,9 @@ async function writeBackendServerInfo(port) {
 }
 
 // src/lib/dev/reload.ts
-import { join as join10, relative as relative2 } from "path";
+init_constants2();
+init_core();
+import { join as join13, relative as relative2 } from "path";
 import chokidar from "chokidar";
 import { bold as bold4, cyan as cyan3, dim as dim3, green as green2 } from "colorette";
 function formatTime() {
@@ -1720,9 +2391,9 @@ function startHotReload(onReload, options = {}) {
   const customRoutesConfig = options.config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
   const watchPaths = [
-    join10(workspace, customRoutesDir),
-    join10(workspace, "playcademy.config.js"),
-    join10(workspace, "playcademy.config.json")
+    join13(workspace, customRoutesDir),
+    join13(workspace, "playcademy.config.js"),
+    join13(workspace, "playcademy.config.json")
   ];
   const watcher = chokidar.watch(watchPaths, {
     persistent: true,
@@ -1760,6 +2431,9 @@ function startHotReload(onReload, options = {}) {
   watcher.on("unlink", createReloadHandler("removed"));
   return watcher;
 }
+
+// src/utils.ts
+init_import();
 export {
   findConfigPath as findPlaycademyConfigPath,
   importTypescriptDefault,