@playcademy/vite-plugin 0.1.38 → 0.2.0

package/dist/index.js

@@ -40990,105 +40990,6 @@ function closeBundleHook(context) {
 // src/hooks/config.ts
 import { DEFAULT_PORTS } from "playcademy/constants";
 
-// ../utils/src/port.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { createServer } from "node:net";
-import { homedir } from "node:os";
-import { join } from "node:path";
-async function isPortAvailableOnHost(port, host) {
-  return new Promise((resolve) => {
-    const server = createServer();
-    let resolved = false;
-    const cleanup = (result) => {
-      if (resolved)
-        return;
-      resolved = true;
-      try {
-        server.close();
-      } catch {}
-      resolve(result);
-    };
-    const timeout = setTimeout(() => cleanup(true), 100);
-    server.once("error", (err2) => {
-      clearTimeout(timeout);
-      if (err2.code === "EAFNOSUPPORT" || err2.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 = join(home, ".playcademy");
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  return join(dir, ".proc");
-}
-function readRegistry() {
-  const registryPath = getRegistryPath();
-  if (!existsSync(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, info2) {
-  const registry = readRegistry();
-  const key = getServerKey(type, info2.port);
-  registry[key] = info2;
-  writeRegistry(registry);
-}
-function cleanupServerInfo(type, projectRoot, pid) {
-  const registry = readRegistry();
-  const keysToRemove = [];
-  for (const [key, info2] of Object.entries(registry)) {
-    if (key.startsWith(`${type}-`)) {
-      let matches = true;
-      if (projectRoot && info2.projectRoot !== projectRoot) {
-        matches = false;
-      }
-      if (pid !== undefined && info2.pid !== pid) {
-        matches = false;
-      }
-      if (matches) {
-        keysToRemove.push(key);
-      }
-    }
-  }
-  for (const key of keysToRemove) {
-    delete registry[key];
-  }
-  if (keysToRemove.length > 0) {
-    writeRegistry(registry);
-  }
-}
-
 // src/config/proxy.ts
 function createProxyConfig(existingProxy, backendPort) {
   if (existingProxy["/api"]) {
@@ -41122,7 +41023,8 @@ function createViteConfig(userConfig, backendPort) {
 // src/hooks/config.ts
 async function configHook(userConfig, context) {
   process.noDeprecation = true;
-  context.backendPort = await findAvailablePort(DEFAULT_PORTS.BACKEND);
+  context.backendPort = DEFAULT_PORTS.BACKEND;
+  context.sandboxPort = DEFAULT_PORTS.SANDBOX;
   return createViteConfig(userConfig, context.backendPort);
 }
 
@@ -41141,8 +41043,12 @@ var serverState = {
   backend: null,
   viteServer: null,
   currentMode: "platform",
-  timebackRoleOverride: null
+  timebackRoleOverride: null,
+  platformRoleOverride: null
 };
+function getSandboxRef() {
+  return serverState.sandbox;
+}
 function hasActiveServers() {
   return !!(serverState.backend || serverState.sandbox);
 }
@@ -41164,6 +41070,12 @@ function getTimebackRoleOverride() {
 function setTimebackRoleOverride(role) {
   serverState.timebackRoleOverride = role;
 }
+function getPlatformRoleOverride() {
+  return serverState.platformRoleOverride;
+}
+function setPlatformRoleOverride(role) {
+  serverState.platformRoleOverride = role;
+}
 
 // src/server/cleanup.ts
 async function cleanupServers() {
@@ -41172,23 +41084,29 @@ async function cleanupServers() {
       await serverState.backend.server.dispose();
       serverState.backend.stopHotReload();
       serverState.backend.cleanup();
+      await new Promise((resolve) => setTimeout(resolve, 100));
     } catch {}
     serverState.backend = null;
   }
   if (serverState.sandbox) {
     try {
-      serverState.sandbox.cleanup();
+      await serverState.sandbox.cleanup();
     } catch {}
     serverState.sandbox = null;
   }
 }
 
-// src/server/hotkeys/cycle-timeback-role.ts
-var import_picocolors2 = __toESM(require_picocolors(), 1);
+// src/server/config-watcher.ts
+import fs8 from "node:fs";
+import path6 from "node:path";
+import { CONFIG_FILE_NAMES } from "playcademy/constants";
 
-// src/types/internal.ts
-var TIMEBACK_ROLES = ["student", "parent", "teacher", "administrator"];
-// src/server/hotkeys/cycle-timeback-role.ts
+// src/server/recreate-sandbox.ts
+var import_picocolors6 = __toESM(require_picocolors(), 1);
+
+// ../utils/src/vite-logger.ts
+var import_picocolors2 = __toESM(require_picocolors(), 1);
+var { bold, cyan, dim } = import_picocolors2.default;
 function formatTimestamp() {
   const now = new Date;
   const hours = now.getHours();
@@ -41196,32 +41114,19 @@ function formatTimestamp() {
   const seconds = now.getSeconds().toString().padStart(2, "0");
   const ampm = hours >= 12 ? "PM" : "AM";
   const displayHours = hours % 12 || 12;
-  return import_picocolors2.default.dim(`${displayHours}:${minutes}:${seconds} ${ampm}`);
+  return dim(`${displayHours}:${minutes}:${seconds} ${ampm}`);
 }
-function cycleTimebackRole(logger) {
-  const currentRole = getTimebackRoleOverride() ?? "student";
-  const currentIndex = TIMEBACK_ROLES.indexOf(currentRole);
-  const nextIndex = (currentIndex + 1) % TIMEBACK_ROLES.length;
-  const nextRole = TIMEBACK_ROLES[nextIndex];
-  setTimebackRoleOverride(nextRole);
-  logger.info(`${formatTimestamp()} ${import_picocolors2.default.cyan(import_picocolors2.default.bold("[playcademy]"))} ${import_picocolors2.default.dim("(timeback)")} ${import_picocolors2.default.red(currentRole)} → ${import_picocolors2.default.green(nextRole)}`);
-  if (getViteServerRef()) {
-    getViteServerRef()?.ws.send({ type: "full-reload", path: "*" });
-  } else {
-    logger.warn(`${formatTimestamp()} ${import_picocolors2.default.red(import_picocolors2.bold("[playcademy]"))} ${import_picocolors2.dim("(timeback)")} ${import_picocolors2.yellow("Cannot cycle TimeBack role: no Vite server reference")}`);
+function createLogPrefix(entity, domain) {
+  const timestamp = formatTimestamp();
+  const label = bold(cyan(`[${entity}]`));
+  if (domain) {
+    return `${timestamp} ${label} ${dim(`(${domain})`)}`;
   }
+  return `${timestamp} ${label}`;
 }
-var cycleTimebackRoleHotkey = (options) => ({
-  key: "t",
-  description: "cycle TimeBack role",
-  action: () => cycleTimebackRole(options.viteConfig.logger)
-});
-
-// src/server/hotkeys/recreate-database.ts
-var import_picocolors7 = __toESM(require_picocolors(), 1);
 
 // src/lib/sandbox/server.ts
-var import_picocolors6 = __toESM(require_picocolors(), 1);
+var import_picocolors5 = __toESM(require_picocolors(), 1);
 import { DEFAULT_PORTS as DEFAULT_PORTS2 } from "playcademy/constants";
 
 // ../sandbox/dist/server.js
@@ -41258,20 +41163,24 @@ import { Http2ServerRequest as Http2ServerRequest2 } from "http2";
 import { Http2ServerRequest } from "http2";
 import { Readable } from "stream";
 import crypto2 from "crypto";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { homedir } from "node:os";
+import { join as join2 } from "node:path";
 import fs5 from "node:fs";
 import fs3 from "node:fs";
 import fs22 from "node:fs";
-import { dirname, isAbsolute, join as join22 } from "node:path";
+import { dirname, isAbsolute, join as join3 } from "node:path";
 import path2 from "path";
 import { stdout } from "process";
 import { createPublicKey as createPublicKey2, createVerify, verify as verify3 } from "crypto";
 import { request as request2 } from "https";
 import { pipeline } from "stream";
 import { readdir as readdir2, readFile as readFile2, stat } from "node:fs/promises";
-import { join as join4, relative } from "node:path";
+import { join as join5, relative } from "node:path";
 import { createHash } from "node:crypto";
 import { readdir, readFile } from "node:fs/promises";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 import crypto6 from "node:crypto";
 import * as crypto7 from "node:crypto";
 var __create2 = Object.create;
@@ -45601,7 +45510,7 @@ var require_node22 = __commonJS2((exports) => {
       return path3;
     }
     exports2.normalize = normalize;
-    function join222(aRoot, aPath) {
+    function join22(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -45633,7 +45542,7 @@ var require_node22 = __commonJS2((exports) => {
       }
       return joined;
     }
-    exports2.join = join222;
+    exports2.join = join22;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -45806,7 +45715,7 @@ var require_node22 = __commonJS2((exports) => {
             parsed.path = parsed.path.substring(0, index2 + 1);
           }
         }
-        sourceURL = join222(urlGenerate(parsed), sourceURL);
+        sourceURL = join22(urlGenerate(parsed), sourceURL);
       }
       return normalize(sourceURL);
     }
@@ -49532,16 +49441,16 @@ If you have no idea what this means or what Pirates is, let me explain: Pirates
       return walkForTsConfig(parentDirectory, readdirSync);
     }
     exports2.walkForTsConfig = walkForTsConfig;
-    function loadTsconfig(configFilePath, existsSync22, readFileSync2) {
-      if (existsSync22 === undefined) {
-        existsSync22 = fs32.existsSync;
+    function loadTsconfig(configFilePath, existsSync3, readFileSync2) {
+      if (existsSync3 === undefined) {
+        existsSync3 = fs32.existsSync;
       }
       if (readFileSync2 === undefined) {
         readFileSync2 = function(filename) {
           return fs32.readFileSync(filename, "utf8");
         };
       }
-      if (!existsSync22(configFilePath)) {
+      if (!existsSync3(configFilePath)) {
         return;
       }
       var configString = readFileSync2(configFilePath);
@@ -49557,27 +49466,27 @@ If you have no idea what this means or what Pirates is, let me explain: Pirates
         var base = undefined;
         if (Array.isArray(extendedConfig)) {
           base = extendedConfig.reduce(function(currBase, extendedConfigElement) {
-            return mergeTsconfigs(currBase, loadTsconfigFromExtends(configFilePath, extendedConfigElement, existsSync22, readFileSync2));
+            return mergeTsconfigs(currBase, loadTsconfigFromExtends(configFilePath, extendedConfigElement, existsSync3, readFileSync2));
           }, {});
         } else {
-          base = loadTsconfigFromExtends(configFilePath, extendedConfig, existsSync22, readFileSync2);
+          base = loadTsconfigFromExtends(configFilePath, extendedConfig, existsSync3, readFileSync2);
         }
         return mergeTsconfigs(base, config2);
       }
       return config2;
     }
     exports2.loadTsconfig = loadTsconfig;
-    function loadTsconfigFromExtends(configFilePath, extendedConfigValue, existsSync22, readFileSync2) {
+    function loadTsconfigFromExtends(configFilePath, extendedConfigValue, existsSync3, readFileSync2) {
       var _a;
       if (typeof extendedConfigValue === "string" && extendedConfigValue.indexOf(".json") === -1) {
         extendedConfigValue += ".json";
       }
       var currentDir = path3.dirname(configFilePath);
       var extendedConfigPath = path3.join(currentDir, extendedConfigValue);
-      if (extendedConfigValue.indexOf("/") !== -1 && extendedConfigValue.indexOf(".") !== -1 && !existsSync22(extendedConfigPath)) {
+      if (extendedConfigValue.indexOf("/") !== -1 && extendedConfigValue.indexOf(".") !== -1 && !existsSync3(extendedConfigPath)) {
         extendedConfigPath = path3.join(currentDir, "node_modules", extendedConfigValue);
       }
-      var config2 = loadTsconfig(extendedConfigPath, existsSync22, readFileSync2) || {};
+      var config2 = loadTsconfig(extendedConfigPath, existsSync3, readFileSync2) || {};
       if ((_a = config2.compilerOptions) === null || _a === undefined ? undefined : _a.baseUrl) {
         var extendsDir = path3.dirname(extendedConfigValue);
         config2.compilerOptions.baseUrl = path3.join(extendsDir, config2.compilerOptions.baseUrl);
@@ -76048,7 +75957,7 @@ globstar while`, file, fr, pattern, pr2, swallowee);
           return new SQL2([new StringChunk2(str)]);
         }
         sql22.raw = raw2;
-        function join32(chunks, separator) {
+        function join42(chunks, separator) {
           const result = [];
           for (const [i3, chunk] of chunks.entries()) {
             if (i3 > 0 && separator !== undefined) {
@@ -76058,7 +75967,7 @@ globstar while`, file, fr, pattern, pr2, swallowee);
           }
           return new SQL2(result);
         }
-        sql22.join = join32;
+        sql22.join = join42;
         function identifier(value) {
           return new Name2(value);
         }
@@ -78888,7 +78797,7 @@ params: ${params}`);
             const tableName = getTableLikeName2(table62);
             for (const item of extractUsedTable(table62))
               this.usedTables.add(item);
-            if (typeof tableName === "string" && this.config.joins?.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins?.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (!this.isPartialSelect) {
@@ -79746,7 +79655,7 @@ params: ${params}`);
         createJoin(joinType) {
           return (table62, on2) => {
             const tableName = getTableLikeName2(table62);
-            if (typeof tableName === "string" && this.config.joins.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (typeof on2 === "function") {
@@ -79792,10 +79701,10 @@ params: ${params}`);
                 const fromFields = this.getTableLikeFields(this.config.from);
                 fields[tableName] = fromFields;
               }
-              for (const join32 of this.config.joins) {
-                const tableName2 = getTableLikeName2(join32.table);
-                if (typeof tableName2 === "string" && !is2(join32.table, SQL2)) {
-                  const fromFields = this.getTableLikeFields(join32.table);
+              for (const join42 of this.config.joins) {
+                const tableName2 = getTableLikeName2(join42.table);
+                if (typeof tableName2 === "string" && !is2(join42.table, SQL2)) {
+                  const fromFields = this.getTableLikeFields(join42.table);
                   fields[tableName2] = fromFields;
                 }
               }
@@ -83370,7 +83279,7 @@ ORDER BY
             const tableName = getTableLikeName2(table62);
             for (const item of extractUsedTable2(table62))
               this.usedTables.add(item);
-            if (typeof tableName === "string" && this.config.joins?.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins?.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (!this.isPartialSelect) {
@@ -83811,7 +83720,7 @@ ORDER BY
         createJoin(joinType) {
           return (table62, on2) => {
             const tableName = getTableLikeName2(table62);
-            if (typeof tableName === "string" && this.config.joins.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (typeof on2 === "function") {
@@ -87418,7 +87327,7 @@ ${withStyle.errorWarning(`We've found duplicated view name across ${source_defau
             const tableName = getTableLikeName2(table62);
             for (const item of extractUsedTable3(table62))
               this.usedTables.add(item);
-            if (typeof tableName === "string" && this.config.joins?.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins?.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (!this.isPartialSelect) {
@@ -91460,7 +91369,7 @@ AND
             const tableName = getTableLikeName2(table62);
             for (const item of extractUsedTable4(table62))
               this.usedTables.add(item);
-            if (typeof tableName === "string" && this.config.joins?.some((join32) => join32.alias === tableName)) {
+            if (typeof tableName === "string" && this.config.joins?.some((join42) => join42.alias === tableName)) {
               throw new Error(`Alias "${tableName}" is already used in this query`);
             }
             if (!this.isPartialSelect) {
@@ -162051,10 +161960,10 @@ var require_colorette = __commonJS2((exports) => {
     black,
     red,
     green,
-    yellow: yellow2,
+    yellow,
     blue,
     magenta,
-    cyan,
+    cyan: cyan2,
     white,
     gray,
     bgBlack,
@@ -162104,7 +162013,7 @@ var require_colorette = __commonJS2((exports) => {
   exports.blueBright = blueBright;
   exports.bold = bold2;
   exports.createColors = createColors;
-  exports.cyan = cyan;
+  exports.cyan = cyan2;
   exports.cyanBright = cyanBright;
   exports.dim = dim2;
   exports.gray = gray;
@@ -162123,7 +162032,7 @@ var require_colorette = __commonJS2((exports) => {
   exports.underline = underline;
   exports.white = white;
   exports.whiteBright = whiteBright;
-  exports.yellow = yellow2;
+  exports.yellow = yellow;
   exports.yellowBright = yellowBright;
 });
 var require_dist22 = __commonJS2((exports) => {
@@ -175066,7 +174975,7 @@ function hasTimebackCredentials() {
   return false;
 }
 function hasTimebackFullConfig() {
-  return hasTimebackCredentials() && !!(config.timeback.courseId && config.timeback.studentId);
+  return hasTimebackCredentials() && !!(config.timeback.courseId && config.timeback.timebackId);
 }
 function requireTimebackCredentials() {
   if (hasTimebackCredentials())
@@ -175120,11 +175029,36 @@ function configureTimeback(options) {
     config.timeback.courseId = options.courseId;
     process.env.SANDBOX_TIMEBACK_COURSE_ID = options.courseId;
   }
-  if (options.studentId) {
-    config.timeback.studentId = options.studentId;
-    process.env.SANDBOX_TIMEBACK_STUDENT_ID = options.studentId;
+  if (options.timebackId) {
+    config.timeback.timebackId = options.timebackId;
+    process.env.SANDBOX_TIMEBACK_STUDENT_ID = options.timebackId;
+    const isMockMode = options.timebackId === "mock";
+    process.env.SANDBOX_TIMEBACK_MOCK_MODE = isMockMode ? "true" : "false";
+  }
+  if (options.organization) {
+    config.timeback.organization = options.organization;
+    process.env.SANDBOX_TIMEBACK_ORG_ID = options.organization.id;
+    if (options.organization.name) {
+      process.env.SANDBOX_TIMEBACK_ORG_NAME = options.organization.name;
+    }
+    if (options.organization.type) {
+      process.env.SANDBOX_TIMEBACK_ORG_TYPE = options.organization.type;
+    }
+  }
+  if (options.role) {
+    config.timeback.role = options.role;
+    process.env.SANDBOX_TIMEBACK_ROLE = options.role;
   }
 }
+function getTimebackDisplayMode() {
+  const { timebackId, mode } = config.timeback;
+  if (!timebackId)
+    return null;
+  if (timebackId === "mock" || !hasTimebackCredentials()) {
+    return "mock";
+  }
+  return mode;
+}
 function setEmbeddedMode(embedded) {
   config.embedded = embedded;
   process.env.PLAYCADEMY_EMBEDDED = embedded ? "1" : undefined;
@@ -175143,12 +175077,199 @@ var config = {
     clientSecret: process.env.TIMEBACK_API_CLIENT_SECRET,
     authUrl: process.env.TIMEBACK_API_AUTH_URL,
     courseId: process.env.SANDBOX_TIMEBACK_COURSE_ID,
-    studentId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
+    timebackId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
   }
 };
 process.env.BETTER_AUTH_SECRET = config.auth.betterAuthSecret;
 process.env.GAME_JWT_SECRET = config.auth.gameJwtSecret;
 process.env.PUBLIC_IS_LOCAL = "true";
+var now = new Date;
+var DEMO_USER_IDS = {
+  player: "00000000-0000-0000-0000-000000000001",
+  developer: "00000000-0000-0000-0000-000000000002",
+  admin: "00000000-0000-0000-0000-000000000003",
+  pendingDeveloper: "00000000-0000-0000-0000-000000000004",
+  unverifiedPlayer: "00000000-0000-0000-0000-000000000005"
+};
+var DEMO_USERS = {
+  admin: {
+    id: DEMO_USER_IDS.admin,
+    name: "Admin User",
+    username: "admin_user",
+    email: "admin@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "admin",
+    developerStatus: "approved",
+    createdAt: now,
+    updatedAt: now
+  },
+  player: {
+    id: DEMO_USER_IDS.player,
+    name: "Player User",
+    username: "player_user",
+    email: "player@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "player",
+    developerStatus: "none",
+    createdAt: now,
+    updatedAt: now
+  },
+  developer: {
+    id: DEMO_USER_IDS.developer,
+    name: "Developer User",
+    username: "developer_user",
+    email: "developer@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "developer",
+    developerStatus: "approved",
+    createdAt: now,
+    updatedAt: now
+  },
+  pendingDeveloper: {
+    id: DEMO_USER_IDS.pendingDeveloper,
+    name: "Pending Developer",
+    username: "pending_dev",
+    email: "pending@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "developer",
+    developerStatus: "pending",
+    createdAt: now,
+    updatedAt: now
+  },
+  unverifiedPlayer: {
+    id: DEMO_USER_IDS.unverifiedPlayer,
+    name: "Unverified Player",
+    username: "unverified_player",
+    email: "unverified@playcademy.com",
+    emailVerified: false,
+    image: null,
+    role: "player",
+    developerStatus: "none",
+    createdAt: now,
+    updatedAt: now
+  }
+};
+var DEMO_USER = DEMO_USERS.player;
+var DEMO_TOKENS = {
+  "sandbox-demo-token": DEMO_USERS.player,
+  "sandbox-admin-token": DEMO_USERS.admin,
+  "sandbox-player-token": DEMO_USERS.player,
+  "sandbox-developer-token": DEMO_USERS.developer,
+  "sandbox-pending-dev-token": DEMO_USERS.pendingDeveloper,
+  "sandbox-unverified-token": DEMO_USERS.unverifiedPlayer,
+  "mock-game-token-for-local-dev": DEMO_USERS.player
+};
+var DEMO_TOKEN = "sandbox-demo-token";
+var MOCK_GAME_ID = "mock-game-id-from-template";
+var DEMO_ITEM_IDS = {
+  playcademyCredits: "10000000-0000-0000-0000-000000000001",
+  foundingMemberBadge: "10000000-0000-0000-0000-000000000002",
+  earlyAdopterBadge: "10000000-0000-0000-0000-000000000003",
+  firstGameBadge: "10000000-0000-0000-0000-000000000004",
+  commonSword: "10000000-0000-0000-0000-000000000005",
+  smallHealthPotion: "10000000-0000-0000-0000-000000000006",
+  smallBackpack: "10000000-0000-0000-0000-000000000007"
+};
+var PLAYCADEMY_CREDITS_ID = DEMO_ITEM_IDS.playcademyCredits;
+var SAMPLE_ITEMS = [
+  {
+    id: PLAYCADEMY_CREDITS_ID,
+    slug: "PLAYCADEMY_CREDITS",
+    gameId: null,
+    displayName: "PLAYCADEMY credits",
+    description: "The main currency used across PLAYCADEMY.",
+    type: "currency",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/playcademy-credit.png",
+    metadata: {
+      rarity: "common"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS.foundingMemberBadge,
+    slug: "FOUNDING_MEMBER_BADGE",
+    gameId: null,
+    displayName: "Founding Member Badge",
+    description: "Reserved for founding core team of the PLAYCADEMY platform.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: null,
+    metadata: {
+      rarity: "legendary"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS.earlyAdopterBadge,
+    slug: "EARLY_ADOPTER_BADGE",
+    gameId: null,
+    displayName: "Early Adopter Badge",
+    description: "Awarded to users who joined during the beta phase.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: null,
+    metadata: {
+      rarity: "epic"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS.firstGameBadge,
+    slug: "FIRST_GAME_BADGE",
+    gameId: null,
+    displayName: "First Game Played",
+    description: "Awarded for playing your first game in the Playcademy platform.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/first-game-badge.png",
+    metadata: {
+      rarity: "uncommon"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS.commonSword,
+    slug: "COMMON_SWORD",
+    gameId: null,
+    displayName: "Common Sword",
+    description: "A basic sword, good for beginners.",
+    type: "unlock",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/common-sword.png",
+    metadata: undefined
+  },
+  {
+    id: DEMO_ITEM_IDS.smallHealthPotion,
+    slug: "SMALL_HEALTH_POTION",
+    gameId: null,
+    displayName: "Small Health Potion",
+    description: "Restores a small amount of health.",
+    type: "other",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/small-health-potion.png",
+    metadata: undefined
+  },
+  {
+    id: DEMO_ITEM_IDS.smallBackpack,
+    slug: "SMALL_BACKPACK",
+    gameId: null,
+    displayName: "Small Backpack",
+    description: "Increases your inventory capacity by 5 slots.",
+    type: "upgrade",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/small-backpack.png",
+    metadata: undefined
+  }
+];
+var SAMPLE_INVENTORY = [
+  {
+    id: "20000000-0000-0000-0000-000000000001",
+    userId: DEMO_USER.id,
+    itemId: PLAYCADEMY_CREDITS_ID,
+    quantity: 1000
+  }
+];
 var RequestError = class extends Error {
   constructor(message3, options) {
     super(message3, options);
@@ -175684,9 +175805,99 @@ var serve = (options, listeningListener) => {
   });
   return server;
 };
+function getRegistryPath() {
+  const home = homedir();
+  const dir = join2(home, ".playcademy");
+  if (!existsSync2(dir)) {
+    mkdirSync2(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, info2) {
+  const registry = readRegistry();
+  const key = getServerKey(type, info2.port);
+  registry[key] = info2;
+  writeRegistry(registry);
+}
+function cleanupServerInfo(type, projectRoot, pid) {
+  const registry = readRegistry();
+  const keysToRemove = [];
+  for (const [key, info2] of Object.entries(registry)) {
+    if (key.startsWith(`${type}-`)) {
+      let matches = true;
+      if (projectRoot && info2.projectRoot !== projectRoot) {
+        matches = false;
+      }
+      if (pid !== undefined && info2.pid !== pid) {
+        matches = false;
+      }
+      if (matches) {
+        keysToRemove.push(key);
+      }
+    }
+  }
+  for (const key of keysToRemove) {
+    delete registry[key];
+  }
+  if (keysToRemove.length > 0) {
+    writeRegistry(registry);
+  }
+}
+async function isPortInUse(port) {
+  return new Promise((resolve2) => {
+    const server = createServer();
+    server.once("error", () => {
+      resolve2(true);
+    });
+    server.once("listening", () => {
+      server.close();
+      resolve2(false);
+    });
+    server.listen(port);
+  });
+}
+async function waitForPort(port, timeoutMs = 5000) {
+  const start2 = Date.now();
+  while (await isPortInUse(port)) {
+    if (Date.now() - start2 > timeoutMs) {
+      throw new Error(`Port ${port} is already in use.
+Stop the other server or specify a different port with --port <number>.`);
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 100));
+  }
+}
+async function requirePortAvailable(port, timeoutMs = 100) {
+  const start2 = Date.now();
+  while (await isPortInUse(port)) {
+    if (Date.now() - start2 > timeoutMs) {
+      throw new Error(`Port ${port} is already in use.
+Stop the other server or specify a different port with --port <number>.`);
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 50));
+  }
+}
 var package_default = {
   name: "@playcademy/sandbox",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "Local development server for Playcademy game development",
   type: "module",
   exports: {
@@ -175701,6 +175912,10 @@ var package_default = {
     "./config": {
       import: "./dist/config.js",
       types: "./dist/config.d.ts"
+    },
+    "./constants": {
+      import: "./dist/constants.js",
+      types: "./dist/constants.d.ts"
     }
   },
   bin: {
@@ -178130,7 +178345,7 @@ function sql(strings, ...params) {
     return new SQL([new StringChunk(str)]);
   }
   sql22.raw = raw2;
-  function join5(chunks, separator) {
+  function join22(chunks, separator) {
     const result = [];
     for (const [i22, chunk] of chunks.entries()) {
       if (i22 > 0 && separator !== undefined) {
@@ -178140,7 +178355,7 @@ function sql(strings, ...params) {
     }
     return new SQL(result);
   }
-  sql22.join = join5;
+  sql22.join = join22;
   function identifier(value) {
     return new Name(value);
   }
@@ -181053,7 +181268,7 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
     return (table, on) => {
       const baseTableName = this.tableName;
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins?.some((join5) => join5.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins?.some((join22) => join22.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (!this.isPartialSelect) {
@@ -181558,7 +181773,7 @@ class PgUpdateBase extends QueryPromise {
   createJoin(joinType) {
     return (table, on) => {
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins.some((join5) => join5.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins.some((join22) => join22.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (typeof on === "function") {
@@ -181608,10 +181823,10 @@ class PgUpdateBase extends QueryPromise {
           const fromFields = this.getTableLikeFields(this.config.from);
           fields[tableName] = fromFields;
         }
-        for (const join5 of this.config.joins) {
-          const tableName2 = getTableLikeName(join5.table);
-          if (typeof tableName2 === "string" && !is(join5.table, SQL)) {
-            const fromFields = this.getTableLikeFields(join5.table);
+        for (const join22 of this.config.joins) {
+          const tableName2 = getTableLikeName(join22.table);
+          if (typeof tableName2 === "string" && !is(join22.table, SQL)) {
+            const fromFields = this.getTableLikeFields(join22.table);
             fields[tableName2] = fromFields;
           }
         }
@@ -182732,217 +182947,59 @@ var notificationsRelations = relations(notifications, ({ one }) => ({
     references: [users.id]
   })
 }));
-var now = new Date;
-var DEMO_USER_IDS = {
-  admin: "00000000-0000-0000-0000-000000000001",
-  player: "00000000-0000-0000-0000-000000000002",
-  developer: "00000000-0000-0000-0000-000000000003",
-  pendingDeveloper: "00000000-0000-0000-0000-000000000004",
-  unverifiedPlayer: "00000000-0000-0000-0000-000000000005"
-};
-var DEMO_USERS = {
-  admin: {
-    id: DEMO_USER_IDS.admin,
-    name: "Admin User",
-    username: "admin_user",
-    email: "admin@playcademy.com",
-    emailVerified: true,
-    image: null,
-    role: "admin",
-    developerStatus: "approved",
-    createdAt: now,
-    updatedAt: now
-  },
-  player: {
-    id: DEMO_USER_IDS.player,
-    name: "Player User",
-    username: "player_user",
-    email: "player@playcademy.com",
-    emailVerified: true,
-    image: null,
-    role: "player",
-    developerStatus: "none",
-    createdAt: now,
-    updatedAt: now
-  },
-  developer: {
-    id: DEMO_USER_IDS.developer,
-    name: "Developer User",
-    username: "developer_user",
-    email: "developer@playcademy.com",
-    emailVerified: true,
-    image: null,
-    role: "developer",
-    developerStatus: "approved",
-    createdAt: now,
-    updatedAt: now
-  },
-  pendingDeveloper: {
-    id: DEMO_USER_IDS.pendingDeveloper,
-    name: "Pending Developer",
-    username: "pending_dev",
-    email: "pending@playcademy.com",
-    emailVerified: true,
-    image: null,
-    role: "developer",
-    developerStatus: "pending",
-    createdAt: now,
-    updatedAt: now
-  },
-  unverifiedPlayer: {
-    id: DEMO_USER_IDS.unverifiedPlayer,
-    name: "Unverified Player",
-    username: "unverified_player",
-    email: "unverified@playcademy.com",
-    emailVerified: false,
-    image: null,
-    role: "player",
-    developerStatus: "none",
-    createdAt: now,
-    updatedAt: now
+function extractBearerToken(authHeader) {
+  if (!authHeader?.startsWith("Bearer ")) {
+    return null;
   }
-};
-var DEMO_USER = DEMO_USERS.admin;
-var DEMO_TOKENS = {
-  "sandbox-demo-token": DEMO_USERS.admin,
-  "sandbox-admin-token": DEMO_USERS.admin,
-  "sandbox-player-token": DEMO_USERS.player,
-  "sandbox-developer-token": DEMO_USERS.developer,
-  "sandbox-pending-dev-token": DEMO_USERS.pendingDeveloper,
-  "sandbox-unverified-token": DEMO_USERS.unverifiedPlayer,
-  "mock-game-token-for-local-dev": DEMO_USERS.admin
-};
-var MOCK_GAME_ID = "mock-game-id-from-template";
-var DEMO_ITEM_IDS = {
-  playcademyCredits: "10000000-0000-0000-0000-000000000001",
-  foundingMemberBadge: "10000000-0000-0000-0000-000000000002",
-  earlyAdopterBadge: "10000000-0000-0000-0000-000000000003",
-  firstGameBadge: "10000000-0000-0000-0000-000000000004",
-  commonSword: "10000000-0000-0000-0000-000000000005",
-  smallHealthPotion: "10000000-0000-0000-0000-000000000006",
-  smallBackpack: "10000000-0000-0000-0000-000000000007"
-};
-var PLAYCADEMY_CREDITS_ID = DEMO_ITEM_IDS.playcademyCredits;
-var SAMPLE_ITEMS = [
-  {
-    id: PLAYCADEMY_CREDITS_ID,
-    slug: "PLAYCADEMY_CREDITS",
-    gameId: null,
-    displayName: "PLAYCADEMY credits",
-    description: "The main currency used across PLAYCADEMY.",
-    type: "currency",
-    isPlaceable: false,
-    imageUrl: "http://playcademy-sandbox.local/playcademy-credit.png",
-    metadata: {
-      rarity: "common"
-    }
-  },
-  {
-    id: DEMO_ITEM_IDS.foundingMemberBadge,
-    slug: "FOUNDING_MEMBER_BADGE",
-    gameId: null,
-    displayName: "Founding Member Badge",
-    description: "Reserved for founding core team of the PLAYCADEMY platform.",
-    type: "badge",
-    isPlaceable: false,
-    imageUrl: null,
-    metadata: {
-      rarity: "legendary"
+  return authHeader.substring(7);
+}
+function parseSandboxToken(token) {
+  try {
+    const parts2 = token.split(".");
+    if (parts2.length !== 3 || parts2[2] !== "sandbox") {
+      return null;
     }
-  },
-  {
-    id: DEMO_ITEM_IDS.earlyAdopterBadge,
-    slug: "EARLY_ADOPTER_BADGE",
-    gameId: null,
-    displayName: "Early Adopter Badge",
-    description: "Awarded to users who joined during the beta phase.",
-    type: "badge",
-    isPlaceable: false,
-    imageUrl: null,
-    metadata: {
-      rarity: "epic"
+    const header = JSON.parse(atob(parts2[0]));
+    if (header.typ !== "sandbox") {
+      return null;
     }
-  },
-  {
-    id: DEMO_ITEM_IDS.firstGameBadge,
-    slug: "FIRST_GAME_BADGE",
-    gameId: null,
-    displayName: "First Game Played",
-    description: "Awarded for playing your first game in the Playcademy platform.",
-    type: "badge",
-    isPlaceable: false,
-    imageUrl: "http://playcademy-sandbox.local/first-game-badge.png",
-    metadata: {
-      rarity: "uncommon"
+    const payload = JSON.parse(atob(parts2[1]));
+    if (!payload.uid || !payload.sub) {
+      return null;
     }
-  },
-  {
-    id: DEMO_ITEM_IDS.commonSword,
-    slug: "COMMON_SWORD",
-    gameId: null,
-    displayName: "Common Sword",
-    description: "A basic sword, good for beginners.",
-    type: "unlock",
-    isPlaceable: false,
-    imageUrl: "http://playcademy-sandbox.local/common-sword.png",
-    metadata: undefined
-  },
-  {
-    id: DEMO_ITEM_IDS.smallHealthPotion,
-    slug: "SMALL_HEALTH_POTION",
-    gameId: null,
-    displayName: "Small Health Potion",
-    description: "Restores a small amount of health.",
-    type: "other",
-    isPlaceable: false,
-    imageUrl: "http://playcademy-sandbox.local/small-health-potion.png",
-    metadata: undefined
-  },
-  {
-    id: DEMO_ITEM_IDS.smallBackpack,
-    slug: "SMALL_BACKPACK",
-    gameId: null,
-    displayName: "Small Backpack",
-    description: "Increases your inventory capacity by 5 slots.",
-    type: "upgrade",
-    isPlaceable: false,
-    imageUrl: "http://playcademy-sandbox.local/small-backpack.png",
-    metadata: undefined
-  }
-];
-var SAMPLE_INVENTORY = [
-  {
-    id: "20000000-0000-0000-0000-000000000001",
-    userId: DEMO_USER.id,
-    itemId: PLAYCADEMY_CREDITS_ID,
-    quantity: 1000
-  }
-];
-function extractBearerToken(authHeader) {
-  if (!authHeader?.startsWith("Bearer ")) {
+    return {
+      userId: payload.uid,
+      gameSlug: payload.sub
+    };
+  } catch {
     return null;
   }
-  return authHeader.substring(7);
 }
-function parseJwtUserId(token) {
+function parseJwtClaims(token) {
   try {
     const parts2 = token.split(".");
     if (parts2.length === 3 && parts2[1]) {
       const payload = JSON.parse(atob(parts2[1]));
-      return payload.uid || null;
+      if (payload.uid) {
+        return {
+          userId: payload.uid,
+          gameId: payload.sub
+        };
+      }
     }
-  } catch (error2) {
-    console.warn("[Auth] Failed to decode JWT token:", error2);
-  }
+  } catch {}
   return null;
 }
-function resolveUserId(token) {
+function resolveAuth(token) {
   const demoUser = DEMO_TOKENS[token];
-  if (demoUser) {
-    return demoUser.id;
-  }
+  if (demoUser)
+    return { userId: demoUser.id };
   if (token.includes(".")) {
-    return parseJwtUserId(token);
+    const sandboxClaims = parseSandboxToken(token);
+    if (sandboxClaims) {
+      return sandboxClaims;
+    }
+    return parseJwtClaims(token);
   }
   return null;
 }
@@ -182957,6 +183014,18 @@ async function fetchUserFromDatabase(db, userId) {
     throw error2;
   }
 }
+async function resolveGameIdFromSlug(db, slug) {
+  try {
+    const game = await db.query.games.findFirst({
+      where: eq(games.slug, slug),
+      columns: { id: true }
+    });
+    return game?.id || null;
+  } catch (error2) {
+    console.error("[Auth] Error looking up game by slug:", error2);
+    return null;
+  }
+}
 function isPublicRoute(path4, exceptions) {
   return exceptions.some((exception) => {
     if (path4 === exception)
@@ -182978,11 +183047,11 @@ async function authenticateRequest(c3) {
       shouldReturn404: true
     };
   }
-  let targetUserId;
+  let claims;
   if (apiKey && !bearerToken) {
-    targetUserId = DEMO_USERS.admin.id;
+    claims = { userId: DEMO_USERS.admin.id };
   } else {
-    const resolved = resolveUserId(token);
+    const resolved = resolveAuth(token);
     if (!resolved) {
       return {
         success: false,
@@ -182990,26 +183059,22 @@ async function authenticateRequest(c3) {
         shouldReturn404: true
       };
     }
-    targetUserId = resolved;
+    claims = resolved;
   }
   const db = c3.get("db");
   if (!db) {
     console.error("[Auth] Database not available in context");
-    return {
-      success: false,
-      error: "Internal server error",
-      shouldReturn404: false
-    };
+    return { success: false, error: "Internal server error", shouldReturn404: false };
   }
-  const user = await fetchUserFromDatabase(db, targetUserId);
+  const user = await fetchUserFromDatabase(db, claims.userId);
   if (!user) {
-    return {
-      success: false,
-      error: "User not found or token invalid",
-      shouldReturn404: true
-    };
+    return { success: false, error: "User not found or token invalid", shouldReturn404: true };
   }
-  return { success: true, user };
+  let gameId = claims.gameId;
+  if (!gameId && claims.gameSlug) {
+    gameId = await resolveGameIdFromSlug(db, claims.gameSlug) ?? undefined;
+  }
+  return { success: true, user, gameId };
 }
 function setupAuth(options = {}) {
   const { exceptions = [] } = options;
@@ -183021,6 +183086,8 @@ function setupAuth(options = {}) {
       const result = await authenticateRequest(c3);
       if (result.success) {
         c3.set("user", result.user);
+        if (result.gameId)
+          c3.set("gameId", result.gameId);
         await next();
         return;
       }
@@ -188861,31 +188928,31 @@ function getDatabase() {
 }
 
 class DatabasePathManager {
-  static DEFAULT_DB_SUBPATH = join22("@playcademy", "vite-plugin", "node_modules", ".playcademy", "sandbox.db");
+  static DEFAULT_DB_SUBPATH = join3("@playcademy", "vite-plugin", "node_modules", ".playcademy", "sandbox.db");
   static findNodeModulesPath() {
     let currentDir = process.cwd();
     while (currentDir !== dirname(currentDir)) {
-      const nodeModulesPath = join22(currentDir, "node_modules");
+      const nodeModulesPath = join3(currentDir, "node_modules");
       if (fs22.existsSync(nodeModulesPath)) {
         return nodeModulesPath;
       }
       currentDir = dirname(currentDir);
     }
-    return join22(process.cwd(), "node_modules");
+    return join3(process.cwd(), "node_modules");
   }
   static resolveDatabasePath(customPath) {
     if (customPath) {
       if (customPath === ":memory:")
         return ":memory:";
-      return isAbsolute(customPath) ? customPath : join22(process.cwd(), customPath);
+      return isAbsolute(customPath) ? customPath : join3(process.cwd(), customPath);
     }
-    return join22(this.findNodeModulesPath(), this.DEFAULT_DB_SUBPATH);
+    return join3(this.findNodeModulesPath(), this.DEFAULT_DB_SUBPATH);
   }
   static ensureDatabaseDirectory(dbPath) {
     if (dbPath === ":memory:")
       return;
     const dirPath = dirname(dbPath);
-    const absolutePath = isAbsolute(dirPath) ? dirPath : join22(process.cwd(), dirPath);
+    const absolutePath = isAbsolute(dirPath) ? dirPath : join3(process.cwd(), dirPath);
     try {
       if (!fs22.existsSync(absolutePath)) {
         fs22.mkdirSync(absolutePath, { recursive: true });
@@ -189196,7 +189263,51 @@ var init_overworld = __esm3(() => {
     FIRST_GAME: ITEM_SLUGS2.FIRST_GAME_BADGE
   };
 });
-var init_timeback = () => {};
+var TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY";
+var TIMEBACK_ORG_NAME = "Playcademy Studios";
+var TIMEBACK_ORG_TYPE = "department";
+var TIMEBACK_COURSE_DEFAULTS;
+var TIMEBACK_RESOURCE_DEFAULTS;
+var TIMEBACK_COMPONENT_DEFAULTS;
+var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS;
+var init_timeback = __esm3(() => {
+  TIMEBACK_COURSE_DEFAULTS = {
+    gradingScheme: "STANDARD",
+    level: {
+      elementary: "Elementary",
+      middle: "Middle",
+      high: "High",
+      ap: "AP"
+    },
+    goals: {
+      dailyXp: 50,
+      dailyLessons: 3
+    },
+    metrics: {
+      totalXp: 1000,
+      totalLessons: 50
+    }
+  };
+  TIMEBACK_RESOURCE_DEFAULTS = {
+    vendorId: "playcademy",
+    roles: ["primary"],
+    importance: "primary",
+    metadata: {
+      type: "interactive",
+      toolProvider: "Playcademy",
+      instructionalMethod: "exploratory",
+      language: "en-US"
+    }
+  };
+  TIMEBACK_COMPONENT_DEFAULTS = {
+    sortOrder: 1,
+    prerequisiteCriteria: "ALL"
+  };
+  TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
+    sortOrder: 1,
+    lessonType: "quiz"
+  };
+});
 var init_workers = () => {};
 var init_src2 = __esm3(() => {
   init_auth();
@@ -189237,7 +189348,6 @@ var HTTP_DEFAULTS;
 var AUTH_DEFAULTS;
 var CACHE_DEFAULTS;
 var CONFIG_DEFAULTS;
-var DEFAULT_PLAYCADEMY_ORGANIZATION_ID;
 var PLAYCADEMY_DEFAULTS;
 var RESOURCE_DEFAULTS;
 var HTTP_STATUS;
@@ -189384,54 +189494,26 @@ var init_constants = __esm3(() => {
   CONFIG_DEFAULTS = {
     fileNames: ["timeback.config.js", "timeback.config.json"]
   };
-  DEFAULT_PLAYCADEMY_ORGANIZATION_ID = process.env.TIMEBACK_ORG_SOURCE_ID || "PLAYCADEMY";
   PLAYCADEMY_DEFAULTS = {
-    organization: DEFAULT_PLAYCADEMY_ORGANIZATION_ID,
+    organization: TIMEBACK_ORG_SOURCED_ID,
     launchBaseUrls: PLAYCADEMY_BASE_URLS
   };
   RESOURCE_DEFAULTS = {
     organization: {
-      name: "Playcademy Studios",
-      type: "department"
+      name: TIMEBACK_ORG_NAME,
+      type: TIMEBACK_ORG_TYPE
     },
     course: {
-      gradingScheme: "STANDARD",
-      level: {
-        elementary: "Elementary",
-        middle: "Middle",
-        high: "High",
-        ap: "AP"
-      },
-      metadata: {
-        goals: {
-          dailyXp: 50,
-          dailyLessons: 3
-        },
-        metrics: {
-          totalXp: 1000,
-          totalLessons: 50
-        }
-      }
-    },
-    component: {
-      sortOrder: 1,
-      prerequisiteCriteria: "ALL"
-    },
-    resource: {
-      vendorId: "playcademy",
-      roles: ["primary"],
-      importance: "primary",
+      gradingScheme: TIMEBACK_COURSE_DEFAULTS.gradingScheme,
+      level: TIMEBACK_COURSE_DEFAULTS.level,
       metadata: {
-        type: "interactive",
-        toolProvider: "Playcademy",
-        instructionalMethod: "exploratory",
-        language: "en-US"
+        goals: TIMEBACK_COURSE_DEFAULTS.goals,
+        metrics: TIMEBACK_COURSE_DEFAULTS.metrics
       }
     },
-    componentResource: {
-      sortOrder: 1,
-      lessonType: "quiz"
-    }
+    component: TIMEBACK_COMPONENT_DEFAULTS,
+    resource: TIMEBACK_RESOURCE_DEFAULTS,
+    componentResource: TIMEBACK_COMPONENT_RESOURCE_DEFAULTS
   };
   HTTP_STATUS = {
     CLIENT_ERROR_MIN: 400,
@@ -195440,7 +195522,8 @@ class TimebackClient {
         courseId: enrollment.course.id,
         status: "active",
         grades,
-        subjects
+        subjects,
+        school: enrollment.school
       };
     });
     this.cacheManager.setEnrollments(studentId, enrollments);
@@ -195511,7 +195594,51 @@ var init_overworld2 = __esm4(() => {
     FIRST_GAME: ITEM_SLUGS3.FIRST_GAME_BADGE
   };
 });
-var init_timeback2 = () => {};
+var TIMEBACK_ORG_SOURCED_ID2 = "PLAYCADEMY";
+var TIMEBACK_ORG_NAME2 = "Playcademy Studios";
+var TIMEBACK_ORG_TYPE2 = "department";
+var TIMEBACK_COURSE_DEFAULTS2;
+var TIMEBACK_RESOURCE_DEFAULTS2;
+var TIMEBACK_COMPONENT_DEFAULTS2;
+var TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2;
+var init_timeback2 = __esm4(() => {
+  TIMEBACK_COURSE_DEFAULTS2 = {
+    gradingScheme: "STANDARD",
+    level: {
+      elementary: "Elementary",
+      middle: "Middle",
+      high: "High",
+      ap: "AP"
+    },
+    goals: {
+      dailyXp: 50,
+      dailyLessons: 3
+    },
+    metrics: {
+      totalXp: 1000,
+      totalLessons: 50
+    }
+  };
+  TIMEBACK_RESOURCE_DEFAULTS2 = {
+    vendorId: "playcademy",
+    roles: ["primary"],
+    importance: "primary",
+    metadata: {
+      type: "interactive",
+      toolProvider: "Playcademy",
+      instructionalMethod: "exploratory",
+      language: "en-US"
+    }
+  };
+  TIMEBACK_COMPONENT_DEFAULTS2 = {
+    sortOrder: 1,
+    prerequisiteCriteria: "ALL"
+  };
+  TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2 = {
+    sortOrder: 1,
+    lessonType: "quiz"
+  };
+});
 var init_workers2 = () => {};
 var init_src3 = __esm4(() => {
   init_auth2();
@@ -195543,7 +195670,6 @@ var HTTP_DEFAULTS2;
 var AUTH_DEFAULTS2;
 var CACHE_DEFAULTS2;
 var CONFIG_DEFAULTS2;
-var DEFAULT_PLAYCADEMY_ORGANIZATION_ID2;
 var PLAYCADEMY_DEFAULTS2;
 var RESOURCE_DEFAULTS2;
 var HTTP_STATUS2;
@@ -195690,54 +195816,26 @@ var init_constants2 = __esm4(() => {
   CONFIG_DEFAULTS2 = {
     fileNames: ["timeback.config.js", "timeback.config.json"]
   };
-  DEFAULT_PLAYCADEMY_ORGANIZATION_ID2 = process.env.TIMEBACK_ORG_SOURCE_ID || "PLAYCADEMY";
   PLAYCADEMY_DEFAULTS2 = {
-    organization: DEFAULT_PLAYCADEMY_ORGANIZATION_ID2,
+    organization: TIMEBACK_ORG_SOURCED_ID2,
     launchBaseUrls: PLAYCADEMY_BASE_URLS2
   };
   RESOURCE_DEFAULTS2 = {
     organization: {
-      name: "Playcademy Studios",
-      type: "department"
+      name: TIMEBACK_ORG_NAME2,
+      type: TIMEBACK_ORG_TYPE2
     },
     course: {
-      gradingScheme: "STANDARD",
-      level: {
-        elementary: "Elementary",
-        middle: "Middle",
-        high: "High",
-        ap: "AP"
-      },
-      metadata: {
-        goals: {
-          dailyXp: 50,
-          dailyLessons: 3
-        },
-        metrics: {
-          totalXp: 1000,
-          totalLessons: 50
-        }
-      }
-    },
-    component: {
-      sortOrder: 1,
-      prerequisiteCriteria: "ALL"
-    },
-    resource: {
-      vendorId: "playcademy",
-      roles: ["primary"],
-      importance: "primary",
+      gradingScheme: TIMEBACK_COURSE_DEFAULTS2.gradingScheme,
+      level: TIMEBACK_COURSE_DEFAULTS2.level,
       metadata: {
-        type: "interactive",
-        toolProvider: "Playcademy",
-        instructionalMethod: "exploratory",
-        language: "en-US"
+        goals: TIMEBACK_COURSE_DEFAULTS2.goals,
+        metrics: TIMEBACK_COURSE_DEFAULTS2.metrics
       }
     },
-    componentResource: {
-      sortOrder: 1,
-      lessonType: "quiz"
-    }
+    component: TIMEBACK_COMPONENT_DEFAULTS2,
+    resource: TIMEBACK_RESOURCE_DEFAULTS2,
+    componentResource: TIMEBACK_COMPONENT_RESOURCE_DEFAULTS2
   };
   HTTP_STATUS2 = {
     CLIENT_ERROR_MIN: 400,
@@ -196079,66 +196177,87 @@ function buildResourceMetadata({
   return metadata2;
 }
 init_src();
-async function fetchEnrollmentsForUser(timebackId) {
-  const db = getDatabase();
-  const isLocal = process.env.PUBLIC_IS_LOCAL === "true";
-  if (isLocal) {
-    const allIntegrations = await db.query.gameTimebackIntegrations.findMany();
-    return allIntegrations.map((integration) => ({
-      gameId: integration.gameId,
-      grade: integration.grade,
-      subject: integration.subject,
-      courseId: integration.courseId
-    }));
+async function fetchStudentFromOneRoster(timebackId) {
+  log2.debug("[OneRoster] Fetching student profile", { timebackId });
+  try {
+    const client2 = await getTimebackClient();
+    const user = await client2.oneroster.users.get(timebackId);
+    const primaryRoleEntry = user.roles.find((r22) => r22.roleType === "primary");
+    const role = primaryRoleEntry?.role ?? user.roles[0]?.role ?? "student";
+    const orgMap = new Map;
+    if (user.primaryOrg) {
+      orgMap.set(user.primaryOrg.sourcedId, {
+        id: user.primaryOrg.sourcedId,
+        name: user.primaryOrg.name ?? null,
+        type: user.primaryOrg.type || "school",
+        isPrimary: true
+      });
+    }
+    for (const r22 of user.roles) {
+      if (r22.org && !orgMap.has(r22.org.sourcedId)) {
+        orgMap.set(r22.org.sourcedId, {
+          id: r22.org.sourcedId,
+          name: null,
+          type: "school",
+          isPrimary: false
+        });
+      }
+    }
+    const organizations = Array.from(orgMap.values());
+    return { role, organizations };
+  } catch (error2) {
+    log2.warn("[OneRoster] Failed to fetch student, using defaults", { error: error2, timebackId });
+    return { role: "student", organizations: [] };
   }
-  log2.debug("[timeback-enrollments] Fetching student enrollments from TimeBack", { timebackId });
+}
+async function fetchEnrollmentsFromEduBridge(timebackId) {
+  const db = getDatabase();
+  log2.debug("[EduBridge] Fetching student enrollments", { timebackId });
   try {
     const client2 = await getTimebackClient();
-    const classes = await client2.getEnrollments(timebackId);
-    const courseIds = classes.map((cls) => cls.courseId).filter((id) => Boolean(id));
-    if (courseIds.length === 0) {
+    const enrollments = await client2.getEnrollments(timebackId);
+    const courseIds = enrollments.map((e2) => e2.courseId).filter((id) => Boolean(id));
+    if (courseIds.length === 0)
       return [];
-    }
+    const courseToSchool = new Map(enrollments.filter((e2) => e2.school?.id).map((e2) => [e2.courseId, e2.school.id]));
     const integrations = await db.query.gameTimebackIntegrations.findMany({
       where: inArray(gameTimebackIntegrations.courseId, courseIds)
     });
-    return integrations.map((integration) => ({
-      gameId: integration.gameId,
-      grade: integration.grade,
-      subject: integration.subject,
-      courseId: integration.courseId
+    return integrations.map((i32) => ({
+      gameId: i32.gameId,
+      grade: i32.grade,
+      subject: i32.subject,
+      courseId: i32.courseId,
+      orgId: courseToSchool.get(i32.courseId)
     }));
   } catch (error2) {
-    log2.warn("[timeback-enrollments] Failed to fetch TimeBack enrollments:", {
-      error: error2,
-      timebackId
-    });
+    log2.warn("[EduBridge] Failed to fetch enrollments", { error: error2, timebackId });
     return [];
   }
 }
-async function fetchUserRole(timebackId) {
-  log2.debug("[timeback] Fetching user role from TimeBack", { timebackId });
-  try {
-    const client2 = await getTimebackClient();
-    const user = await client2.oneroster.users.get(timebackId);
-    const primaryRole = user.roles.find((r22) => r22.roleType === "primary");
-    const role = primaryRole?.role ?? user.roles[0]?.role ?? "student";
-    log2.debug("[timeback] Resolved user role", { timebackId, role });
-    return role;
-  } catch (error2) {
-    log2.warn("[timeback] Failed to fetch user role, defaulting to student:", {
-      error: error2,
-      timebackId
-    });
-    return "student";
-  }
+function filterEnrollmentsByGame(enrollments, gameId) {
+  return enrollments.filter((e2) => e2.gameId === gameId).map(({ gameId: _42, ...rest }) => rest);
 }
-async function fetchUserTimebackData(timebackId) {
-  const [role, enrollments] = await Promise.all([
-    fetchUserRole(timebackId),
-    fetchEnrollmentsForUser(timebackId)
+function filterOrganizationsByEnrollments(organizations, enrollments) {
+  const enrollmentOrgIds = new Set(enrollments.map((e2) => e2.orgId).filter(Boolean));
+  if (enrollmentOrgIds.size === 0)
+    return [];
+  return organizations.filter((o42) => enrollmentOrgIds.has(o42.id));
+}
+async function fetchUserTimebackData(timebackId, gameId) {
+  const [{ role, organizations: allOrganizations }, allEnrollments] = await Promise.all([
+    fetchStudentFromOneRoster(timebackId),
+    fetchEnrollmentsFromEduBridge(timebackId)
   ]);
-  return { role, enrollments };
+  const enrollments = gameId ? filterEnrollmentsByGame(allEnrollments, gameId) : allEnrollments;
+  const organizations = gameId ? filterOrganizationsByEnrollments(allOrganizations, enrollments) : allOrganizations;
+  log2.debug("[Timeback] Fetched student data", {
+    timebackId,
+    role,
+    enrollments: enrollments.map((e2) => `${e2.subject}:${e2.grade}`),
+    organizations: organizations.map((o42) => `${o42.name ?? o42.id} (${o42.type})`)
+  });
+  return { id: timebackId, role, enrollments, organizations };
 }
 var AchievementCompletionType;
 ((AchievementCompletionType2) => {
@@ -198546,7 +198665,7 @@ async function scanAssetDirectory(distPath) {
   async function scanFiles(dir, baseDir = dir) {
     const entries = await readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join3(dir, entry.name);
+      const fullPath = join4(dir, entry.name);
       if (entry.isDirectory()) {
         await scanFiles(fullPath, baseDir);
       } else {
@@ -198912,7 +199031,7 @@ class CloudflareProvider {
     async function scanDirectory(dir) {
       const entries = await readdir2(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = join4(dir, entry.name);
+        const fullPath = join5(dir, entry.name);
         if (entry.isDirectory()) {
           if (await scanDirectory(fullPath))
             return true;
@@ -198934,7 +199053,7 @@ class CloudflareProvider {
   async resolveAssetBasePath(dirPath) {
     const entries = await readdir2(dirPath, { withFileTypes: true });
     if (entries.length === 1 && entries[0]?.isDirectory()) {
-      const unwrappedPath = join4(dirPath, entries[0].name);
+      const unwrappedPath = join5(dirPath, entries[0].name);
       log2.debug("[CloudflareProvider] Unwrapping wrapper directory", {
         wrapper: entries[0].name
       });
@@ -198945,7 +199064,7 @@ class CloudflareProvider {
   async uploadFilesToR2(dir, baseDir, bucketName) {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join4(dir, entry.name);
+      const fullPath = join5(dir, entry.name);
       if (entry.isDirectory()) {
         await this.uploadFilesToR2(fullPath, baseDir, bucketName);
       } else {
@@ -199422,29 +199541,46 @@ async function seedCurrencies(db) {
     });
   }
 }
-var customLogger;
-function setLogger(logger3) {
-  customLogger = logger3;
+function generateMockStudentId(userId) {
+  return `mock-student-${userId.slice(-8)}`;
 }
-function getLogger() {
-  if (customLogger) {
-    return customLogger;
+function generateTimebackId(userId, isPrimaryUser = false) {
+  const timebackId = config.timeback.timebackId;
+  if (!timebackId) {
+    return null;
   }
-  return {
-    info: (msg) => console.log(msg),
-    warn: (msg) => console.warn(msg),
-    error: (msg) => console.error(msg)
-  };
+  if (timebackId === "mock") {
+    return generateMockStudentId(userId);
+  }
+  return isPrimaryUser ? timebackId : generateMockStudentId(userId);
 }
-var logger3 = {
-  info: (msg) => {
-    if (customLogger || !config.embedded) {
-      getLogger().info(msg);
+async function seedTimebackIntegrations(db, gameId, courses) {
+  const now2 = new Date;
+  let seededCount = 0;
+  for (const course of courses) {
+    const courseId = course.courseId || `mock-${course.subject.toLowerCase()}-g${course.grade}`;
+    try {
+      const existing = await db.query.gameTimebackIntegrations.findFirst({
+        where: (table14, { and: and3, eq: eq3 }) => and3(eq3(table14.gameId, gameId), eq3(table14.grade, course.grade), eq3(table14.subject, course.subject))
+      });
+      if (existing) {
+        continue;
+      }
+      await db.insert(gameTimebackIntegrations).values({
+        gameId,
+        courseId,
+        grade: course.grade,
+        subject: course.subject,
+        totalXp: course.totalXp ?? 1000,
+        lastVerifiedAt: now2
+      });
+      seededCount++;
+    } catch (error2) {
+      console.error(`❌ Error seeding Timeback integration for ${course.subject}:${course.grade}:`, error2);
     }
-  },
-  warn: (msg) => getLogger().warn(msg),
-  error: (msg) => getLogger().error(msg)
-};
+  }
+  return seededCount;
+}
 async function seedCoreGames(db) {
   const now2 = new Date;
   const coreGames = [
@@ -199477,7 +199613,9 @@ async function seedCurrentProjectGame(db, project) {
       where: (games3, { eq: eq3 }) => eq3(games3.slug, project.slug)
     });
     if (existingGame) {
-      logger3.info(`\uD83C\uDFAE Game "${project.displayName}" (${project.slug}) already exists`);
+      if (project.timebackCourses && project.timebackCourses.length > 0) {
+        await seedTimebackIntegrations(db, existingGame.id, project.timebackCourses);
+      }
       return existingGame;
     }
     const gameRecord = {
@@ -199497,6 +199635,12 @@ async function seedCurrentProjectGame(db, project) {
       updatedAt: now2
     };
     const [newGame] = await db.insert(games).values(gameRecord).returning();
+    if (!newGame) {
+      throw new Error("Failed to create game record");
+    }
+    if (project.timebackCourses && project.timebackCourses.length > 0) {
+      await seedTimebackIntegrations(db, newGame.id, project.timebackCourses);
+    }
     return newGame;
   } catch (error2) {
     console.error("❌ Error seeding project game:", error2);
@@ -199553,23 +199697,14 @@ async function seedSpriteTemplates(db) {
     }
   }
 }
-function resolveStudentId(studentId) {
-  if (!studentId)
-    return null;
-  if (studentId === "mock")
-    return `mock-student-${crypto.randomUUID().slice(0, 8)}`;
-  return studentId;
-}
-function getAdminTimebackId() {
-  return resolveStudentId(config.timeback.studentId);
-}
 async function seedDemoData(db) {
   try {
-    const adminTimebackId = getAdminTimebackId();
-    for (const [role, user] of Object.entries(DEMO_USERS)) {
+    const primaryUserId = DEMO_USERS.player.id;
+    for (const user of Object.values(DEMO_USERS)) {
+      const isPrimaryUser = user.id === primaryUserId;
       const userValues = {
         ...user,
-        timebackId: role === "admin" ? adminTimebackId : null
+        timebackId: generateTimebackId(user.id, isPrimaryUser)
       };
       await db.insert(users).values(userValues).onConflictDoNothing();
     }
@@ -199590,7 +199725,7 @@ async function seedDemoData(db) {
     console.error("❌ Error seeding demo data:", error2);
     throw error2;
   }
-  return DEMO_USERS.admin;
+  return DEMO_USERS.player;
 }
 async function checkIfNeedsSeeding(db) {
   try {
@@ -199626,6 +199761,10 @@ async function setupServerDatabase(processedOptions, project) {
 }
 init_src();
 var import_json_colorizer = __toESM2(require_dist22(), 1);
+var customLogger;
+function setLogger(logger3) {
+  customLogger = logger3;
+}
 function processServerOptions(port, options) {
   const {
     verbose = false,
@@ -199674,6 +199813,10 @@ async function startRealtimeServer(realtimeOptions, betterAuthSecret) {
   if (!realtimeOptions.enabled) {
     return null;
   }
+  if (!realtimeOptions.port) {
+    return null;
+  }
+  await waitForPort(realtimeOptions.port);
   if (typeof Bun === "undefined") {
     try {
       return Promise.resolve().then(() => (init_sandbox(), exports_sandbox)).then(({ createSandboxRealtimeServer: createSandboxRealtimeServer2 }) => createSandboxRealtimeServer2({
@@ -204929,12 +205072,32 @@ async function getUserMe(ctx) {
       log2.error(`[API /users/me] User not found in DB for valid token ID: ${user.id}`);
       throw ApiError.notFound("User not found");
     }
+    const timeback3 = userData.timebackId ? await fetchUserTimebackData(userData.timebackId, ctx.gameId) : undefined;
+    if (ctx.gameId) {
+      return {
+        id: userData.id,
+        name: userData.name,
+        role: userData.role,
+        username: userData.username,
+        email: userData.email,
+        timeback: timeback3
+      };
+    }
     const timebackAccount = await db.query.accounts.findFirst({
       where: and(eq(accounts.userId, user.id), eq(accounts.providerId, "timeback"))
     });
-    const timeback3 = userData.timebackId ? await fetchUserTimebackData(userData.timebackId) : undefined;
     return {
-      ...userData,
+      id: userData.id,
+      name: userData.name,
+      username: userData.username,
+      email: userData.email,
+      emailVerified: userData.emailVerified,
+      image: userData.image,
+      role: userData.role,
+      developerStatus: userData.developerStatus,
+      characterCreated: userData.characterCreated,
+      createdAt: userData.createdAt,
+      updatedAt: userData.updatedAt,
       hasTimebackAccount: !!timebackAccount,
       timeback: timeback3
     };
@@ -204945,15 +205108,104 @@ async function getUserMe(ctx) {
     throw ApiError.internal("Internal server error", error2);
   }
 }
+init_src();
+function shouldMockTimeback() {
+  return config.timeback.timebackId === "mock";
+}
+function getMockStudentProfile() {
+  const { organization: org, role } = config.timeback;
+  return {
+    role: role ?? "student",
+    organizations: [
+      {
+        id: org?.id ?? "PLAYCADEMY",
+        name: org?.name ?? "Playcademy Studios",
+        type: org?.type ?? "department",
+        isPrimary: true
+      }
+    ]
+  };
+}
+async function getMockEnrollments(db) {
+  const allIntegrations = await db.query.gameTimebackIntegrations.findMany();
+  return allIntegrations.map((i4) => ({
+    gameId: i4.gameId,
+    grade: i4.grade,
+    subject: i4.subject,
+    courseId: i4.courseId
+  }));
+}
+async function getMockTimebackData(db, timebackId, gameId) {
+  const { role, organizations } = getMockStudentProfile();
+  const allEnrollments = await getMockEnrollments(db);
+  const enrollments = gameId ? allEnrollments.filter((e2) => e2.gameId === gameId).map(({ gameId: _5, ...rest }) => rest) : allEnrollments;
+  log2.debug("[Timeback] Sandbox is using mock data", {
+    timebackId,
+    role,
+    enrollments: enrollments.map((e2) => `${e2.subject}:${e2.grade}`),
+    organizations: organizations.map((o5) => `${o5.name ?? o5.id}`)
+  });
+  return { id: timebackId, role, enrollments, organizations };
+}
+async function buildMockUserResponse(db, user, gameId) {
+  const timeback3 = user.timebackId ? await getMockTimebackData(db, user.timebackId, gameId) : undefined;
+  if (gameId) {
+    return {
+      id: user.id,
+      name: user.name,
+      role: user.role,
+      username: user.username,
+      email: user.email,
+      timeback: timeback3
+    };
+  }
+  const timebackAccount = await db.query.accounts.findFirst({
+    where: and(eq(accounts.userId, user.id), eq(accounts.providerId, "timeback"))
+  });
+  return {
+    id: user.id,
+    name: user.name,
+    username: user.username,
+    email: user.email,
+    emailVerified: user.emailVerified,
+    image: user.image,
+    role: user.role,
+    developerStatus: user.developerStatus,
+    characterCreated: user.characterCreated,
+    createdAt: user.createdAt,
+    updatedAt: user.updatedAt,
+    hasTimebackAccount: !!timebackAccount,
+    timeback: timeback3
+  };
+}
 var usersRouter = new Hono2;
 usersRouter.get("/me", async (c3) => {
-  const ctx = {
-    user: c3.get("user"),
-    params: {},
-    url: new URL(c3.req.url),
-    request: c3.req.raw
-  };
+  const user = c3.get("user");
+  const gameId = c3.get("gameId");
+  if (!user) {
+    const error2 = ApiError.unauthorized("Valid session or bearer token required");
+    return c3.json(createErrorResponse(error2), error2.statusCode);
+  }
   try {
+    if (shouldMockTimeback()) {
+      const db = c3.get("db");
+      const userData2 = await db.query.users.findFirst({
+        where: eq(users.id, user.id)
+      });
+      if (!userData2) {
+        const error2 = ApiError.notFound("User not found");
+        return c3.json(createErrorResponse(error2), error2.statusCode);
+      }
+      const response = await buildMockUserResponse(db, userData2, gameId);
+      return c3.json(response);
+    }
+    const ctx = {
+      user,
+      params: {},
+      url: new URL(c3.req.url),
+      request: c3.req.raw,
+      gameId
+    };
     const userData = await getUserMe(ctx);
     return c3.json(userData);
   } catch (error2) {
@@ -210203,7 +210455,7 @@ async function getTodayTimeBackXp(ctx) {
       throw error2;
     if (error2 instanceof InvalidTimezoneError)
       throw ApiError.badRequest(error2.message);
-    log2.error("[timeback] getTodayTimeBackXp failed", { error: error2 });
+    log2.error("[Timeback] getTodayTimeBackXp failed", { error: error2 });
     throw ApiError.internal("Failed to get today's TimeBack XP", error2);
   }
 }
@@ -210219,7 +210471,7 @@ async function getTotalTimeBackXp(ctx) {
       totalXp: Number(result[0]?.totalXp) || 0
     };
   } catch (error2) {
-    log2.error("[timeback] getTotalTimeBackXp failed", { error: error2 });
+    log2.error("[Timeback] getTotalTimeBackXp failed", { error: error2 });
     throw ApiError.internal("Failed to get total TimeBack XP", error2);
   }
 }
@@ -210269,7 +210521,7 @@ async function updateTodayTimeBackXp(ctx) {
   } catch (error2) {
     if (error2 instanceof ApiError)
       throw error2;
-    log2.error("[timeback] updateTodayTimeBackXp failed", { error: error2 });
+    log2.error("[Timeback] updateTodayTimeBackXp failed", { error: error2 });
     throw ApiError.internal("Failed to update today's TimeBack XP", error2);
   }
 }
@@ -210304,7 +210556,7 @@ async function getTimeBackXpHistory(ctx) {
       }))
     };
   } catch (error2) {
-    log2.error("[timeback] getTimeBackXpHistory failed", { error: error2 });
+    log2.error("[Timeback] getTimeBackXpHistory failed", { error: error2 });
     throw ApiError.internal("Failed to get TimeBack XP history", error2);
   }
 }
@@ -210319,7 +210571,7 @@ async function getStudentEnrollments(ctx) {
     throw ApiError.badRequest("Missing timebackId parameter");
   }
   log2.debug("[API] Getting student enrollments", { userId: user.id, timebackId });
-  const enrollments = await fetchEnrollmentsForUser(timebackId);
+  const enrollments = await fetchEnrollmentsFromEduBridge(timebackId);
   log2.info("[API] Retrieved student enrollments", {
     userId: user.id,
     timebackId,
@@ -210519,13 +210771,23 @@ timebackRouter.post("/end-activity", async (c3) => {
 });
 timebackRouter.get("/enrollments/:timebackId", async (c3) => {
   const timebackId = c3.req.param("timebackId");
-  const ctx = {
-    user: c3.get("user"),
-    params: { timebackId },
-    url: new URL(c3.req.url),
-    request: c3.req.raw
-  };
+  const user = c3.get("user");
+  if (!user) {
+    const error2 = ApiError.unauthorized("Must be logged in to get enrollments");
+    return c3.json(createErrorResponse(error2), error2.statusCode);
+  }
   try {
+    if (shouldMockTimeback()) {
+      const db = c3.get("db");
+      const enrollments2 = await getMockEnrollments(db);
+      return c3.json({ enrollments: enrollments2 });
+    }
+    const ctx = {
+      user,
+      params: { timebackId },
+      url: new URL(c3.req.url),
+      request: c3.req.raw
+    };
     const result = await getStudentEnrollments(ctx);
     return c3.json(result);
   } catch (error2) {
@@ -210833,6 +211095,7 @@ function registerRoutes(app) {
 }
 var version3 = package_default.version;
 async function startServer(port, project, options = {}) {
+  await waitForPort(port);
   const processedOptions = processServerOptions(port, options);
   const db = await setupServerDatabase(processedOptions, project);
   const app = createApp(db, {
@@ -210845,50 +211108,75 @@ async function startServer(port, project, options = {}) {
   return {
     main: mainServer,
     realtime: realtimeServer,
+    timebackMode: getTimebackDisplayMode(),
+    setRole: (role) => {
+      config.timeback.role = role;
+    },
     stop: () => {
-      if (mainServer.close)
-        mainServer.close();
-      if (realtimeServer?.stop)
-        realtimeServer.stop();
+      return new Promise((resolve2) => {
+        if (realtimeServer?.stop)
+          realtimeServer.stop();
+        if (mainServer.close) {
+          mainServer.close(() => resolve2());
+        } else {
+          resolve2();
+        }
+      });
     }
   };
 }
 
 // src/lib/logging/adapter.ts
-var import_picocolors3 = __toESM(require_picocolors(), 1);
-function formatTimestamp2() {
-  const now2 = new Date;
-  const hours = now2.getHours();
-  const minutes = now2.getMinutes().toString().padStart(2, "0");
-  const seconds = now2.getSeconds().toString().padStart(2, "0");
-  const ampm = hours >= 12 ? "PM" : "AM";
-  const displayHours = hours % 12 || 12;
-  return import_picocolors3.dim(`${displayHours}:${minutes}:${seconds} ${ampm}`);
-}
-function createLoggerAdapter(prefix2) {
-  const formattedPrefix = import_picocolors3.dim(`(${prefix2})`);
-  const label = import_picocolors3.cyan(import_picocolors3.bold("[playcademy]"));
+function createLoggerAdapter(domain) {
   return {
-    info: (msg) => console.log(`${formatTimestamp2()} ${label} ${formattedPrefix} ${msg}`),
-    warn: (msg) => console.warn(`${formatTimestamp2()} ${label} ${formattedPrefix} ${msg}`),
-    error: (msg) => console.error(`${formatTimestamp2()} ${label} ${formattedPrefix} ${msg}`)
+    info: (msg) => console.log(`${createLogPrefix("playcademy", domain)} ${msg}`),
+    warn: (msg) => console.warn(`${createLogPrefix("playcademy", domain)} ${msg}`),
+    error: (msg) => console.error(`${createLogPrefix("playcademy", domain)} ${msg}`)
   };
 }
 // src/lib/logging/utils.ts
-var import_picocolors4 = __toESM(require_picocolors(), 1);
-function printBanner(viteConfig, servers, projectInfo, pluginVersion) {
+var import_picocolors3 = __toESM(require_picocolors(), 1);
+
+// ../utils/src/string.ts
+function pluralize(count2, singular, plural) {
+  return count2 === 1 ? singular : plural || `${singular}s`;
+}
+
+// src/lib/logging/utils.ts
+function createBackendBannerOptions(backendPort, vitePort) {
+  if (!backendPort)
+    return;
+  return { port: backendPort, vitePort };
+}
+function createTimebackBannerOptions(timebackMode, courseCount) {
+  if (!timebackMode || !courseCount)
+    return;
+  return { courseCount, mode: timebackMode };
+}
+function printBanner(viteConfig, options) {
   const INDENT = " ".repeat(2);
+  const { version: version4, gameName, sandbox, backend, realtimePort, timeback } = options;
   viteConfig.logger.info("");
-  viteConfig.logger.info(`${INDENT}${import_picocolors4.green(import_picocolors4.bold("PLAYCADEMY"))} ${import_picocolors4.green(`v${pluginVersion}`)}`);
+  viteConfig.logger.info(`${INDENT}${import_picocolors3.green(import_picocolors3.bold("PLAYCADEMY"))} ${import_picocolors3.green(`v${version4}`)}`);
   viteConfig.logger.info("");
-  viteConfig.logger.info(`${INDENT}${import_picocolors4.green("➜")}  ${import_picocolors4.bold("Game:")}     ${import_picocolors4.cyan(projectInfo.slug)}`);
-  viteConfig.logger.info(`${INDENT}${import_picocolors4.green("➜")}  ${import_picocolors4.bold("Sandbox:")}  ${import_picocolors4.cyan(`http://localhost:${import_picocolors4.bold(servers.sandbox.toString())}/api`)}`);
-  if (servers.backend) {
-    const backendUrl = servers.vite ? `http://localhost:${import_picocolors4.bold(servers.vite.toString())}/api ${import_picocolors4.dim(`(via ${servers.backend})`)}` : `http://localhost:${import_picocolors4.bold(servers.backend.toString())}/api`;
-    viteConfig.logger.info(`${INDENT}${import_picocolors4.green("➜")}  ${import_picocolors4.bold("Backend:")}  ${import_picocolors4.cyan(backendUrl)}`);
+  if (gameName) {
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Game:")}     ${import_picocolors3.cyan(gameName)}`);
+  }
+  if (sandbox?.enabled) {
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Sandbox:")}  ${import_picocolors3.cyan(`http://localhost:${import_picocolors3.bold(sandbox.port.toString())}/api`)}`);
+  } else if (sandbox) {
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Sandbox:")}  ${import_picocolors3.cyan("Disabled")}`);
+  }
+  if (backend) {
+    const backendUrl = backend.vitePort ? `http://localhost:${import_picocolors3.bold(backend.vitePort.toString())}/api ${import_picocolors3.dim(`(via ${backend.port})`)}` : `http://localhost:${import_picocolors3.bold(backend.port.toString())}/api`;
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Backend:")}  ${import_picocolors3.cyan(backendUrl)}`);
   }
-  if (servers.realtime) {
-    viteConfig.logger.info(`${INDENT}${import_picocolors4.green("➜")}  ${import_picocolors4.bold("Realtime:")} ${import_picocolors4.cyan(`ws://localhost:${import_picocolors4.bold(servers.realtime.toString())}`)}`);
+  if (realtimePort) {
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Realtime:")} ${import_picocolors3.cyan(`ws://localhost:${import_picocolors3.bold(realtimePort.toString())}`)}`);
+  }
+  if (timeback && timeback.courseCount > 0) {
+    const label = `${timeback.courseCount} ${pluralize(timeback.courseCount, "course")} ${import_picocolors3.dim(`(${timeback.mode})`)}`;
+    viteConfig.logger.info(`${INDENT}${import_picocolors3.green("➜")}  ${import_picocolors3.bold("Timeback:")} ${import_picocolors3.cyan(label)}`);
   }
   viteConfig.logger.info("");
 }
@@ -210896,13 +211184,29 @@ function printBanner(viteConfig, servers, projectInfo, pluginVersion) {
 import fs6 from "node:fs";
 import path5 from "node:path";
 import { loadPlaycademyConfig } from "playcademy/utils";
-async function extractProjectInfo(viteConfig) {
+function extractTimebackCourses(config2, timebackOptions) {
+  const courses = config2?.integrations?.timeback?.courses;
+  if (!courses || courses.length === 0)
+    return;
+  return courses.map((course) => {
+    const key = `${course.subject}:${course.grade}`;
+    const overrideId = timebackOptions?.courses?.[key];
+    const courseId = overrideId && overrideId !== "mock" ? overrideId : undefined;
+    return {
+      subject: course.subject,
+      grade: course.grade,
+      courseId,
+      totalXp: course.totalXp,
+      masterableUnits: course.masterableUnits
+    };
+  });
+}
+async function extractProjectInfo(viteConfig, timebackOptions) {
   const projectRoot = viteConfig.root;
   const directoryName = path5.basename(projectRoot);
-  let configName;
+  let config2 = null;
   try {
-    const config2 = await loadPlaycademyConfig();
-    configName = config2?.name;
+    config2 = await loadPlaycademyConfig();
   } catch {}
   let packageJson = {};
   try {
@@ -210912,7 +211216,7 @@ async function extractProjectInfo(viteConfig) {
       packageJson = JSON.parse(packageJsonContent);
     }
   } catch {}
-  const name3 = configName || (typeof packageJson.name === "string" ? packageJson.name : "");
+  const name3 = config2?.name || packageJson.name || "";
   let slug = name3;
   if (slug.includes("/")) {
     slug = slug.split("/")[1] || slug;
@@ -210924,20 +211228,42 @@ async function extractProjectInfo(viteConfig) {
   return {
     slug,
     displayName,
-    version: (typeof packageJson.version === "string" ? packageJson.version : null) || "dev",
-    description: typeof packageJson.description === "string" ? packageJson.description : undefined
+    version: packageJson.version || "dev",
+    description: packageJson.description,
+    timebackCourses: extractTimebackCourses(config2, timebackOptions)
   };
 }
 
 // src/lib/sandbox/timeback.ts
-var import_picocolors5 = __toESM(require_picocolors(), 1);
-function getEffectiveTimebackId(timeback) {
-  if (timeback?.timebackId)
-    return timeback.timebackId;
-  if (timeback?.courses && Object.keys(timeback.courses).length > 0)
-    return "mock";
-  return;
-}
+var import_picocolors4 = __toESM(require_picocolors(), 1);
+// ../constants/src/overworld.ts
+var ITEM_SLUGS4 = {
+  PLAYCADEMY_CREDITS: "PLAYCADEMY_CREDITS",
+  PLAYCADEMY_XP: "PLAYCADEMY_XP",
+  FOUNDING_MEMBER_BADGE: "FOUNDING_MEMBER_BADGE",
+  EARLY_ADOPTER_BADGE: "EARLY_ADOPTER_BADGE",
+  FIRST_GAME_BADGE: "FIRST_GAME_BADGE",
+  COMMON_SWORD: "COMMON_SWORD",
+  SMALL_HEALTH_POTION: "SMALL_HEALTH_POTION",
+  SMALL_BACKPACK: "SMALL_BACKPACK",
+  LAVA_LAMP: "LAVA_LAMP",
+  BOOMBOX: "BOOMBOX",
+  CABIN_BED: "CABIN_BED"
+};
+var CURRENCIES4 = {
+  PRIMARY: ITEM_SLUGS4.PLAYCADEMY_CREDITS,
+  XP: ITEM_SLUGS4.PLAYCADEMY_XP
+};
+var BADGES4 = {
+  FOUNDING_MEMBER: ITEM_SLUGS4.FOUNDING_MEMBER_BADGE,
+  EARLY_ADOPTER: ITEM_SLUGS4.EARLY_ADOPTER_BADGE,
+  FIRST_GAME: ITEM_SLUGS4.FIRST_GAME_BADGE
+};
+// ../constants/src/timeback.ts
+var TIMEBACK_ORG_SOURCED_ID3 = "PLAYCADEMY";
+var TIMEBACK_ORG_NAME3 = "Playcademy Studios";
+var TIMEBACK_ORG_TYPE3 = "department";
+// src/lib/sandbox/timeback.ts
 function detectTimebackOptions() {
   if (process.env.TIMEBACK_LOCAL === "true") {
     return {
@@ -210945,7 +211271,7 @@ function detectTimebackOptions() {
       onerosterApiUrl: process.env.TIMEBACK_ONEROSTER_API_URL,
       caliperApiUrl: process.env.TIMEBACK_CALIPER_API_URL,
       courseId: process.env.SANDBOX_TIMEBACK_COURSE_ID,
-      studentId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
+      timebackId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
     };
   }
   if (process.env.TIMEBACK_API_CLIENT_ID) {
@@ -210957,7 +211283,7 @@ function detectTimebackOptions() {
       clientSecret: process.env.TIMEBACK_API_CLIENT_SECRET,
       authUrl: process.env.TIMEBACK_API_AUTH_URL,
       courseId: process.env.SANDBOX_TIMEBACK_COURSE_ID,
-      studentId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
+      timebackId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
     };
   }
   return;
@@ -210971,59 +211297,77 @@ function hasTimebackCredentials2() {
   }
   return !!(config2.onerosterApiUrl && config2.clientId && config2.clientSecret && config2.authUrl);
 }
-function validateTimebackConfig(viteConfig, timeback) {
-  if (!timeback?.courses)
+function validateTimebackConfig(viteConfig, timeback2) {
+  if (!timeback2?.courses)
     return;
-  const realCourses = Object.entries(timeback.courses).filter(([, value]) => value !== "mock");
+  const realCourses = Object.entries(timeback2.courses).filter(([, value]) => value !== "mock");
   if (realCourses.length > 0 && !hasTimebackCredentials2()) {
     const courseList = realCourses.map(([key]) => key).join(", ");
     viteConfig.logger.warn("");
-    viteConfig.logger.warn(import_picocolors5.default.yellow(`⚠️  TimeBack: Real course IDs for ${import_picocolors5.default.bold(courseList)} but credentials missing.`));
-    viteConfig.logger.warn(import_picocolors5.default.dim(`   Required: TIMEBACK_API_CLIENT_ID, TIMEBACK_API_CLIENT_SECRET, TIMEBACK_API_AUTH_URL, TIMEBACK_ONEROSTER_API_URL`));
-    viteConfig.logger.warn(import_picocolors5.default.dim(`   Or use 'mock' for local testing.`));
+    viteConfig.logger.warn(import_picocolors4.default.yellow(`⚠️  TimeBack: Real course IDs for ${import_picocolors4.default.bold(courseList)} but credentials missing.`));
+    viteConfig.logger.warn(import_picocolors4.default.dim(`   Required: TIMEBACK_API_CLIENT_ID, TIMEBACK_API_CLIENT_SECRET, TIMEBACK_API_AUTH_URL, TIMEBACK_ONEROSTER_API_URL`));
+    viteConfig.logger.warn(import_picocolors4.default.dim(`   Or use 'mock' for local testing.`));
     viteConfig.logger.warn("");
   }
 }
-function generateTimebackJson(timeback) {
-  if (!timeback?.courses || Object.keys(timeback.courses).length === 0) {
-    return;
+function resolveOrganization(orgConfig) {
+  if (!orgConfig || orgConfig === "mock") {
+    return {
+      id: TIMEBACK_ORG_SOURCED_ID3,
+      name: TIMEBACK_ORG_NAME3,
+      type: TIMEBACK_ORG_TYPE3
+    };
+  }
+  return {
+    id: orgConfig.id ?? TIMEBACK_ORG_SOURCED_ID3,
+    name: orgConfig.name ?? TIMEBACK_ORG_NAME3,
+    type: orgConfig.type ?? TIMEBACK_ORG_TYPE3
+  };
+}
+function resolveOrganizations(orgConfig) {
+  const org = resolveOrganization(orgConfig);
+  return [
+    {
+      id: org.id,
+      name: org.name ?? null,
+      type: org.type ?? TIMEBACK_ORG_TYPE3,
+      isPrimary: true
+    }
+  ];
+}
+function generateTimebackJson(context) {
+  if (!context?.baseCourses || context.baseCourses.length === 0) {
+    return "null";
   }
+  const { baseCourses, overrides } = context;
   const enrollments = [];
-  for (const [key, value] of Object.entries(timeback.courses)) {
-    const parts2 = key.split(":");
-    const subject = parts2[0];
-    const gradeStr = parts2[1];
-    const grade = gradeStr ? parseInt(gradeStr, 10) : NaN;
-    if (!subject || isNaN(grade))
+  for (const course of baseCourses) {
+    const key = `${course.subject}:${course.grade}`;
+    const override = overrides?.courses?.[key];
+    if (override === null)
       continue;
-    const courseId = value === "mock" ? `mock-${subject.toLowerCase()}-g${grade}` : value;
-    enrollments.push({ subject, grade, courseId });
+    const courseId = override && override !== "mock" ? override : `mock-${course.subject.toLowerCase()}-g${course.grade}`;
+    enrollments.push({
+      subject: course.subject,
+      grade: course.grade,
+      courseId
+    });
   }
   if (enrollments.length === 0) {
-    return;
+    return "null";
   }
   const roleOverride = getTimebackRoleOverride();
-  const role = roleOverride ?? timeback.role ?? "student";
-  return JSON.stringify({ role, enrollments });
+  const role = roleOverride ?? overrides?.role ?? "student";
+  const organizations = resolveOrganizations(overrides?.organization);
+  return JSON.stringify({ role, enrollments, organizations });
 }
 
 // src/lib/sandbox/server.ts
-function printSandboxInfo(viteConfig, apiPort, realtimePort, projectInfo, realtimeEnabled) {
-  viteConfig.logger.info("");
-  viteConfig.logger.info(`  ${import_picocolors6.default.green(import_picocolors6.default.bold("PLAYCADEMY"))} ${import_picocolors6.default.green(`v${version3}`)}`);
-  viteConfig.logger.info("");
-  viteConfig.logger.info(`  ${import_picocolors6.default.green("➜")}  ${import_picocolors6.default.bold("Game:")}     ${import_picocolors6.default.cyan(projectInfo.slug)}`);
-  viteConfig.logger.info(`  ${import_picocolors6.default.green("➜")}  ${import_picocolors6.default.bold("Sandbox:")}  ${import_picocolors6.default.cyan(`http://localhost:${import_picocolors6.default.bold(apiPort.toString())}/api`)}`);
-  if (realtimeEnabled) {
-    viteConfig.logger.info(`  ${import_picocolors6.default.green("➜")}  ${import_picocolors6.default.bold("Realtime:")} ${import_picocolors6.default.cyan(`ws://localhost:${import_picocolors6.default.bold(realtimePort.toString())}`)}`);
-  }
-  viteConfig.logger.info("");
-}
 async function startSandbox(viteConfig, autoStart = true, options = {}) {
   const {
+    port = DEFAULT_PORTS2.SANDBOX,
     verbose = false,
     customUrl,
-    quiet = false,
     recreateDb = false,
     seed = true,
     memoryOnly = false,
@@ -211031,16 +211375,17 @@ async function startSandbox(viteConfig, autoStart = true, options = {}) {
     realtimeEnabled = false,
     realtimePort,
     logLevel = "info",
-    timebackId
+    timebackOptions
   } = options;
+  const timebackDisabled = timebackOptions === false;
   if (!autoStart || viteConfig.command !== "serve") {
     const baseUrl = customUrl ?? `http://localhost:${DEFAULT_PORTS2.SANDBOX}`;
     const deriveRealtimeUrl = (url) => {
       try {
         const u4 = new URL(url);
-        const port = Number(u4.port || (u4.protocol === "https:" ? 443 : 80));
+        const port2 = Number(u4.port || (u4.protocol === "https:" ? 443 : 80));
         const wsProto = u4.protocol === "https:" ? "wss:" : "ws:";
-        return `${wsProto}//${u4.hostname}:${port + 1}`;
+        return `${wsProto}//${u4.hostname}:${port2 + 1}`;
       } catch {
         return "ws://localhost:4322";
       }
@@ -211055,57 +211400,49 @@ async function startSandbox(viteConfig, autoStart = true, options = {}) {
     };
   }
   try {
-    const sandboxPort = await findAvailablePort(DEFAULT_PORTS2.SANDBOX);
-    const baseUrl = `http://localhost:${sandboxPort}`;
-    const projectInfo = await extractProjectInfo(viteConfig);
-    let timebackOptions = detectTimebackOptions();
-    if (timebackId) {
-      timebackOptions = {
-        ...timebackOptions,
-        studentId: timebackId
-      };
-    }
-    const finalRealtimePort = realtimePort ?? await findAvailablePort(sandboxPort + 1);
+    const baseUrl = `http://localhost:${port}`;
+    const effectiveTimebackOptions = timebackDisabled ? undefined : timebackOptions || undefined;
+    const projectInfo = await extractProjectInfo(viteConfig, effectiveTimebackOptions);
+    let sandboxTimebackOptions = detectTimebackOptions();
+    const effectiveTimebackId = timebackDisabled ? undefined : effectiveTimebackOptions?.id ?? sandboxTimebackOptions?.timebackId ?? (projectInfo.timebackCourses?.length ? "mock" : undefined);
+    if (effectiveTimebackId) {
+      sandboxTimebackOptions = {
+        ...sandboxTimebackOptions,
+        timebackId: effectiveTimebackId,
+        organization: resolveOrganization(effectiveTimebackOptions?.organization),
+        role: effectiveTimebackOptions?.role
+      };
+    }
+    const finalRealtimePort = realtimePort ?? port + 1;
     const realtimeUrl = `ws://localhost:${finalRealtimePort}`;
-    const server = await startServer(sandboxPort, projectInfo, {
+    const server = await startServer(port, projectInfo, {
       verbose,
-      quiet,
+      quiet: true,
       seed,
       memoryOnly,
       databasePath,
       recreateDb,
       logLevel,
       realtime: { enabled: realtimeEnabled, port: finalRealtimePort },
-      timeback: timebackOptions,
+      timeback: sandboxTimebackOptions,
       logger: createLoggerAdapter("sandbox")
     });
-    writeServerInfo("sandbox", {
-      pid: process.pid,
-      port: sandboxPort,
-      url: baseUrl,
-      startedAt: Date.now(),
-      projectRoot: viteConfig.root
-    });
-    if (!quiet) {
-      setTimeout(() => {
-        printSandboxInfo(viteConfig, sandboxPort, finalRealtimePort, projectInfo, realtimeEnabled);
-      }, 100);
-    }
     return {
       baseUrl,
       realtimeUrl,
-      port: sandboxPort,
+      port,
       realtimePort: realtimeEnabled ? finalRealtimePort : undefined,
       project: projectInfo,
-      cleanup: () => {
-        cleanupServerInfo("sandbox", viteConfig.root, process.pid);
+      timebackMode: server.timebackMode,
+      setRole: server.setRole,
+      cleanup: async () => {
         if (server && typeof server.stop === "function") {
-          server.stop();
+          await server.stop();
         }
       }
     };
   } catch (error2) {
-    viteConfig.logger.error(import_picocolors6.default.red(`[Playcademy] Failed to start sandbox: ${error2}`));
+    viteConfig.logger.error(import_picocolors5.default.red(`[Playcademy] Failed to start sandbox: ${error2}`));
     return {
       baseUrl: `http://localhost:${DEFAULT_PORTS2.SANDBOX}`,
       realtimeUrl: "ws://localhost:4322",
@@ -211116,216 +211453,212 @@ async function startSandbox(viteConfig, autoStart = true, options = {}) {
     };
   }
 }
-// src/shells/shell-no-badge.html
-var shell_no_badge_default = `<!doctype html>
-<html lang="en">
-    <head>
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>Playcademy - Development</title>
-        <script type="importmap">
-            {
-                "imports": {
-                    "@playcademy/sdk": "https://esm.sh/@playcademy/sdk@latest"
-                }
-            }
-        </script>
-        <style>
-            * {
-                margin: 0;
-                padding: 0;
-                box-sizing: border-box;
-            }
-
-            body {
-                font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-                height: 100vh;
-                overflow: hidden;
-            }
-
-            .game-container {
-                width: 100vw;
-                height: 100vh;
-                position: relative;
-                overflow: hidden;
-            }
-
-            .game-frame {
-                position: absolute;
-                inset: 0;
-                border: none;
-                width: 100%;
-                height: 100%;
-            }
-
-            .loading {
-                position: absolute;
-                inset: 0;
-                display: flex;
-                align-items: center;
-                justify-content: center;
-                color: #666;
-                font-size: 1rem;
-                background-color: #fafafa;
-            }
-
-            .error {
-                position: absolute;
-                inset: 0;
-                display: flex;
-                flex-direction: column;
-                align-items: center;
-                justify-content: center;
-                color: #d32f2f;
-                background-color: #ffebee;
-            }
-
-            .hidden {
-                display: none;
-            }
-        </style>
-    </head>
-    <body>
-        <div class="game-container">
-            <div class="loading" id="loading">Loading your game...</div>
-
-            <div class="error hidden" id="error">
-                <div>❌ Failed to load game</div>
-                <div
-                    style="margin-top: 0.5rem; font-size: 0.9rem; opacity: 0.8"
-                    id="errorMessage"
-                ></div>
-            </div>
-
-            <iframe class="game-frame hidden" id="gameFrame" src="/"></iframe>
-        </div>
-
-        <script type="module">
-            import { MessageEvents, messaging } from '@playcademy/sdk'
-
-            const loading = document.getElementById('loading')
-            const error = document.getElementById('error')
-            const errorMessage = document.getElementById('errorMessage')
-            const gameFrame = document.getElementById('gameFrame')
-
-            const logIfDebug = (...args) => {
-                if (window.PLAYCADEMY_DEBUG) {
-                    console.log('[PlaycademyDevShell]', ...args)
-                }
-            }
-
-            logIfDebug('[PlaycademyDevShell] Initialized')
-
-            async function checkSandboxConnection() {
-                try {
-                    const response = await fetch('{{SANDBOX_URL}}/api/users/me', {
-                        headers: {
-                            Authorization: 'Bearer sandbox-demo-token',
-                        },
-                    })
-
-                    if (response.ok) {
-                        logIfDebug('[PlaycademyDevShell] Sandbox API connection successful')
-                    } else {
-                        throw new Error('Sandbox API not available')
-                    }
-                } catch (err) {
-                    logIfDebug('[PlaycademyDevShell] Sandbox connection failed:', err)
-                }
-            }
-
-            // Load the game iframe
-            function loadGame() {
-                let handshakeInterval = null
-                let handshakeTimeout = null
-
-                const initPayload = {
-                    baseUrl: '{{SANDBOX_URL}}',
-                    gameUrl: '{{GAME_URL}}' || undefined,
-                    token: 'sandbox-demo-token',
-                    gameId: '{{GAME_ID}}',
-                    realtimeUrl: '{{REALTIME_URL}}',
-                }
-
-                const sendInit = () => {
-                    if (!gameFrame.contentWindow) return
-
-                    messaging.send(MessageEvents.INIT, initPayload, {
-                        target: gameFrame.contentWindow,
-                        origin: '*',
-                    })
-                }
-
-                const stopHandshake = () => {
-                    if (handshakeInterval) {
-                        clearInterval(handshakeInterval)
-                        handshakeInterval = null
-                    }
-                    if (handshakeTimeout) {
-                        clearTimeout(handshakeTimeout)
-                        handshakeTimeout = null
-                    }
-                }
-
-                gameFrame.onload = () => {
-                    loading.classList.add('hidden')
-                    gameFrame.classList.remove('hidden')
-
-                    logIfDebug('[PlaycademyDevShell] Game iframe loaded, beginning init handshake')
-
-                    // Begin handshake: send immediately, then every 300ms
-                    sendInit()
-                    handshakeInterval = setInterval(sendInit, 300)
-
-                    // Stop handshake after 10 seconds
-                    handshakeTimeout = setTimeout(() => {
-                        stopHandshake()
-                        logIfDebug('[PlaycademyDevShell] Init handshake timeout reached')
-                    }, 10000)
-                }
-
-                gameFrame.onerror = () => {
-                    loading.classList.add('hidden')
-                    error.classList.remove('hidden')
-                    errorMessage.textContent = 'Game iframe failed to load'
-                    logIfDebug('[PlaycademyDevShell] Game iframe failed to load')
-                    stopHandshake()
-                }
-
-                // Listen for READY message to stop handshake
-                messaging.listen(MessageEvents.READY, () => {
-                    logIfDebug('[PlaycademyDevShell] Received READY from game, stopping handshake')
-                    stopHandshake()
-                })
-
-                gameFrame.src = '/'
-            }
-
-            window.addEventListener('message', event => {
-                if (event.source === gameFrame.contentWindow) {
-                    const { type, ...payload } = event.data || {}
-                    if (type && type.startsWith('PLAYCADEMY_')) {
-                        logIfDebug(
-                            '[PlaycademyDevShell] Received message from game:',
-                            type,
-                            payload,
-                        )
-                        // Bridge the message to the local context using CustomEvent
-                        messaging.send(type, payload)
-                    }
-                }
-            })
+// ../sandbox/dist/constants.js
+var now2 = new Date;
+var DEMO_USER_IDS2 = {
+  player: "00000000-0000-0000-0000-000000000001",
+  developer: "00000000-0000-0000-0000-000000000002",
+  admin: "00000000-0000-0000-0000-000000000003",
+  pendingDeveloper: "00000000-0000-0000-0000-000000000004",
+  unverifiedPlayer: "00000000-0000-0000-0000-000000000005"
+};
+var DEMO_USERS2 = {
+  admin: {
+    id: DEMO_USER_IDS2.admin,
+    name: "Admin User",
+    username: "admin_user",
+    email: "admin@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "admin",
+    developerStatus: "approved",
+    createdAt: now2,
+    updatedAt: now2
+  },
+  player: {
+    id: DEMO_USER_IDS2.player,
+    name: "Player User",
+    username: "player_user",
+    email: "player@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "player",
+    developerStatus: "none",
+    createdAt: now2,
+    updatedAt: now2
+  },
+  developer: {
+    id: DEMO_USER_IDS2.developer,
+    name: "Developer User",
+    username: "developer_user",
+    email: "developer@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "developer",
+    developerStatus: "approved",
+    createdAt: now2,
+    updatedAt: now2
+  },
+  pendingDeveloper: {
+    id: DEMO_USER_IDS2.pendingDeveloper,
+    name: "Pending Developer",
+    username: "pending_dev",
+    email: "pending@playcademy.com",
+    emailVerified: true,
+    image: null,
+    role: "developer",
+    developerStatus: "pending",
+    createdAt: now2,
+    updatedAt: now2
+  },
+  unverifiedPlayer: {
+    id: DEMO_USER_IDS2.unverifiedPlayer,
+    name: "Unverified Player",
+    username: "unverified_player",
+    email: "unverified@playcademy.com",
+    emailVerified: false,
+    image: null,
+    role: "player",
+    developerStatus: "none",
+    createdAt: now2,
+    updatedAt: now2
+  }
+};
+var DEMO_USER2 = DEMO_USERS2.player;
+var DEMO_TOKENS2 = {
+  "sandbox-demo-token": DEMO_USERS2.player,
+  "sandbox-admin-token": DEMO_USERS2.admin,
+  "sandbox-player-token": DEMO_USERS2.player,
+  "sandbox-developer-token": DEMO_USERS2.developer,
+  "sandbox-pending-dev-token": DEMO_USERS2.pendingDeveloper,
+  "sandbox-unverified-token": DEMO_USERS2.unverifiedPlayer,
+  "mock-game-token-for-local-dev": DEMO_USERS2.player
+};
+var DEMO_ITEM_IDS2 = {
+  playcademyCredits: "10000000-0000-0000-0000-000000000001",
+  foundingMemberBadge: "10000000-0000-0000-0000-000000000002",
+  earlyAdopterBadge: "10000000-0000-0000-0000-000000000003",
+  firstGameBadge: "10000000-0000-0000-0000-000000000004",
+  commonSword: "10000000-0000-0000-0000-000000000005",
+  smallHealthPotion: "10000000-0000-0000-0000-000000000006",
+  smallBackpack: "10000000-0000-0000-0000-000000000007"
+};
+var PLAYCADEMY_CREDITS_ID2 = DEMO_ITEM_IDS2.playcademyCredits;
+var SAMPLE_ITEMS2 = [
+  {
+    id: PLAYCADEMY_CREDITS_ID2,
+    slug: "PLAYCADEMY_CREDITS",
+    gameId: null,
+    displayName: "PLAYCADEMY credits",
+    description: "The main currency used across PLAYCADEMY.",
+    type: "currency",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/playcademy-credit.png",
+    metadata: {
+      rarity: "common"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS2.foundingMemberBadge,
+    slug: "FOUNDING_MEMBER_BADGE",
+    gameId: null,
+    displayName: "Founding Member Badge",
+    description: "Reserved for founding core team of the PLAYCADEMY platform.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: null,
+    metadata: {
+      rarity: "legendary"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS2.earlyAdopterBadge,
+    slug: "EARLY_ADOPTER_BADGE",
+    gameId: null,
+    displayName: "Early Adopter Badge",
+    description: "Awarded to users who joined during the beta phase.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: null,
+    metadata: {
+      rarity: "epic"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS2.firstGameBadge,
+    slug: "FIRST_GAME_BADGE",
+    gameId: null,
+    displayName: "First Game Played",
+    description: "Awarded for playing your first game in the Playcademy platform.",
+    type: "badge",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/first-game-badge.png",
+    metadata: {
+      rarity: "uncommon"
+    }
+  },
+  {
+    id: DEMO_ITEM_IDS2.commonSword,
+    slug: "COMMON_SWORD",
+    gameId: null,
+    displayName: "Common Sword",
+    description: "A basic sword, good for beginners.",
+    type: "unlock",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/common-sword.png",
+    metadata: undefined
+  },
+  {
+    id: DEMO_ITEM_IDS2.smallHealthPotion,
+    slug: "SMALL_HEALTH_POTION",
+    gameId: null,
+    displayName: "Small Health Potion",
+    description: "Restores a small amount of health.",
+    type: "other",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/small-health-potion.png",
+    metadata: undefined
+  },
+  {
+    id: DEMO_ITEM_IDS2.smallBackpack,
+    slug: "SMALL_BACKPACK",
+    gameId: null,
+    displayName: "Small Backpack",
+    description: "Increases your inventory capacity by 5 slots.",
+    type: "upgrade",
+    isPlaceable: false,
+    imageUrl: "http://playcademy-sandbox.local/small-backpack.png",
+    metadata: undefined
+  }
+];
+var SAMPLE_INVENTORY2 = [
+  {
+    id: "20000000-0000-0000-0000-000000000001",
+    userId: DEMO_USER2.id,
+    itemId: PLAYCADEMY_CREDITS_ID2,
+    quantity: 1000
+  }
+];
 
-            // Initialize
-            checkSandboxConnection()
-            loadGame()
-        </script>
-    </body>
-</html>
-`;
+// src/lib/sandbox/token.ts
+var ROLE_TO_USER_ID = {
+  player: DEMO_USER_IDS2.player,
+  developer: DEMO_USER_IDS2.developer,
+  admin: DEMO_USER_IDS2.admin
+};
+function createSandboxGameToken(gameSlug, role = "player") {
+  const header = { alg: "none", typ: "sandbox" };
+  const payload = {
+    sub: gameSlug,
+    uid: ROLE_TO_USER_ID[role],
+    iat: Math.floor(Date.now() / 1000)
+  };
+  const encode3 = (obj) => btoa(JSON.stringify(obj));
+  return `${encode3(header)}.${encode3(payload)}.sandbox`;
+}
 
-// src/shells/shell-with-corner-badge.html
-var shell_with_corner_badge_default = `<!doctype html>
+// src/shells/shell.html
+var shell_default = `<!doctype html>
 <html lang="en">
     <head>
         <meta charset="UTF-8" />
@@ -211385,16 +211718,16 @@ var shell_with_corner_badge_default = `<!doctype html>
         <script type="module">
             import { MessageEvents, messaging } from '@playcademy/sdk'
 
-            // Config (injected by vite plugin)
             const CONFIG = {
                 sandboxUrl: '{{SANDBOX_URL}}',
                 gameId: '{{GAME_ID}}',
+                gameToken: '{{GAME_TOKEN}}',
                 gameUrl: '{{GAME_URL}}' || undefined,
                 realtimeUrl: '{{REALTIME_URL}}',
                 timebackJson: '{{TIMEBACK_DATA}}',
+                hideBadge: '{{HIDE_BADGE}}' === 'true',
             }
 
-            // Parse timeback data (role + enrollments)
             const timeback = (() => {
                 try {
                     return JSON.parse(CONFIG.timebackJson)
@@ -211403,18 +211736,19 @@ var shell_with_corner_badge_default = `<!doctype html>
                 }
             })()
 
-            // Elements
             const badge = document.getElementById('badge')
             const frame = document.getElementById('frame')
 
-            // Debug logging
+            if (CONFIG.hideBadge) {
+                badge.classList.add('hidden')
+            }
+
             const log = (...args) => window.PLAYCADEMY_DEBUG && console.log('[DevShell]', ...args)
 
-            // Check sandbox connection
             async function checkSandbox() {
                 try {
                     const res = await fetch(\`\${CONFIG.sandboxUrl}/api/users/me\`, {
-                        headers: { Authorization: 'Bearer sandbox-demo-token' },
+                        headers: { Authorization: \`Bearer \${CONFIG.gameToken}\` },
                     })
                     if (!res.ok) throw new Error('Sandbox unavailable')
                     badge.classList.remove('offline')
@@ -211428,14 +211762,13 @@ var shell_with_corner_badge_default = `<!doctype html>
                 }
             }
 
-            // Init handshake with game iframe
             function initHandshake(timebackData) {
                 const payload = {
                     baseUrl: CONFIG.sandboxUrl,
                     gameUrl: CONFIG.gameUrl,
                     gameId: CONFIG.gameId,
                     realtimeUrl: CONFIG.realtimeUrl,
-                    token: 'sandbox-demo-token',
+                    token: CONFIG.gameToken,
                     timeback: timebackData,
                 }
 
@@ -211474,7 +211807,6 @@ var shell_with_corner_badge_default = `<!doctype html>
                 frame.src = '/'
             }
 
-            // Bridge messages from game to shell context
             window.addEventListener('message', e => {
                 if (e.source !== frame.contentWindow) return
                 const { type, ...payload } = e.data || {}
@@ -211484,7 +211816,6 @@ var shell_with_corner_badge_default = `<!doctype html>
                 }
             })
 
-            // Start
             checkSandbox().then(() => initHandshake(timeback))
         </script>
     </body>
@@ -211492,10 +211823,11 @@ var shell_with_corner_badge_default = `<!doctype html>
 `;
 
 // src/server/middleware.ts
-function generateLoaderHTML(sandboxUrl, gameId, realtimeUrl, options, gameUrl) {
-  const shell = options.showBadge ? shell_with_corner_badge_default : shell_no_badge_default;
-  const timebackJson = generateTimebackJson(options.timeback) ?? "null";
-  return shell.replace(/{{SANDBOX_URL}}/g, sandboxUrl).replace(/{{GAME_ID}}/g, gameId).replace(/{{REALTIME_URL}}/g, realtimeUrl).replace(/{{GAME_URL}}/g, gameUrl || "").replace(/{{TIMEBACK_DATA}}/g, timebackJson);
+function generateLoaderHTML(sandboxUrl, gameSlug, realtimeUrl, options, gameUrl) {
+  const timebackJson = generateTimebackJson(options.timeback);
+  const platformRole = getPlatformRoleOverride() ?? "player";
+  const gameToken = createSandboxGameToken(gameSlug, platformRole);
+  return shell_default.replace(/{{SANDBOX_URL}}/g, sandboxUrl).replace(/{{GAME_ID}}/g, gameSlug).replace(/{{GAME_TOKEN}}/g, gameToken).replace(/{{REALTIME_URL}}/g, realtimeUrl).replace(/{{GAME_URL}}/g, gameUrl || "").replace(/{{TIMEBACK_DATA}}/g, timebackJson).replace(/{{HIDE_BADGE}}/g, String(options.hideBadge));
 }
 function devServerMiddleware(server, sandbox, gameUrl, options) {
   server.middlewares.use("/", (req, res, next) => {
@@ -211517,69 +211849,166 @@ function devServerMiddleware(server, sandbox, gameUrl, options) {
   });
 }
 
-// src/server/hotkeys/recreate-database.ts
-var { bold: bold4, cyan: cyan3, dim: dim4, green: green2, red, yellow: yellow2 } = import_picocolors7.default;
-function formatTimestamp3() {
-  const now2 = new Date;
-  const hours = now2.getHours();
-  const minutes = now2.getMinutes().toString().padStart(2, "0");
-  const seconds = now2.getSeconds().toString().padStart(2, "0");
-  const ampm = hours >= 12 ? "PM" : "AM";
-  const displayHours = hours % 12 || 12;
-  return dim4(`${displayHours}:${minutes}:${seconds} ${ampm}`);
-}
-async function recreateSandboxDatabase(options) {
+// src/server/recreate-sandbox.ts
+async function recreateSandbox(options) {
+  const { viteConfig, platformModeOptions } = options;
   const currentMode = getCurrentMode();
   const viteServer = getViteServerRef();
+  const prefix2 = createLogPrefix("playcademy", "sandbox");
   if (!viteServer) {
-    options.viteConfig.logger.error(`${formatTimestamp3()} ${red(bold4("[playcademy]"))} ${dim4("(sandbox)")} ${red("Cannot recreate sandbox database: no Vite server reference")}`);
-    return;
+    viteConfig.logger.error(`${prefix2} ${import_picocolors6.red("Cannot recreate sandbox database: no Vite server reference")}`);
+    return { success: false, error: "No Vite server reference" };
   }
   if (currentMode !== "platform") {
-    options.viteConfig.logger.warn(`${formatTimestamp3()} ${yellow2(bold4("[playcademy]"))} ${dim4("(sandbox)")} ${yellow2("can only recreate sandbox database in platform mode (m + enter)")}`);
-    return;
+    viteConfig.logger.warn(`${prefix2} ${import_picocolors6.yellow("can only recreate sandbox database in platform mode (m + enter)")}`);
+    return { success: false, error: "Not in platform mode" };
   }
-  options.viteConfig.logger.info(`${formatTimestamp3()} ${cyan3(bold4("[playcademy]"))} ${dim4("(sandbox)")} recreating database...`);
+  viteConfig.logger.info(`${prefix2} recreating database...`);
   if (serverState.sandbox) {
     serverState.sandbox.cleanup();
     serverState.sandbox = null;
   }
   await new Promise((resolve2) => setTimeout(resolve2, 100));
-  const sandbox = await startSandbox(options.viteConfig, options.platformModeOptions.startSandbox, {
-    verbose: options.platformModeOptions.verbose,
-    logLevel: options.platformModeOptions.logLevel,
-    customUrl: options.platformModeOptions.sandboxUrl,
-    quiet: true,
+  const timebackDisabled = platformModeOptions.timeback === false;
+  const timebackOptions = platformModeOptions.timeback || undefined;
+  const sandbox = await startSandbox(viteConfig, platformModeOptions.startSandbox, {
+    port: platformModeOptions.sandboxPort,
+    verbose: platformModeOptions.verbose,
+    logLevel: platformModeOptions.logLevel,
+    customUrl: platformModeOptions.sandboxUrl,
     recreateDb: true,
-    seed: options.platformModeOptions.seed,
-    memoryOnly: options.platformModeOptions.memoryOnly,
-    databasePath: options.platformModeOptions.databasePath,
-    realtimeEnabled: options.platformModeOptions.realtimeEnabled,
-    realtimePort: options.platformModeOptions.realtimePort,
-    timebackId: getEffectiveTimebackId(options.platformModeOptions.timeback)
+    seed: platformModeOptions.seed,
+    memoryOnly: platformModeOptions.memoryOnly,
+    databasePath: platformModeOptions.databasePath,
+    realtimeEnabled: platformModeOptions.realtimeEnabled,
+    realtimePort: platformModeOptions.realtimePort,
+    timebackOptions: timebackDisabled ? false : platformModeOptions.timeback
   });
   serverState.sandbox = sandbox;
   if (sandbox.project && serverState.backend) {
     const gameUrl = `http://localhost:${serverState.backend.port}`;
     devServerMiddleware(viteServer, sandbox, gameUrl, {
-      showBadge: options.platformModeOptions.showBadge,
-      timeback: options.platformModeOptions.timeback
+      hideBadge: platformModeOptions.hideBadge,
+      timeback: timebackDisabled ? undefined : {
+        baseCourses: sandbox.project.timebackCourses ?? [],
+        overrides: timebackOptions
+      }
     });
   }
-  options.viteConfig.logger.info(`${formatTimestamp3()} ${cyan3(bold4("[playcademy]"))} ${dim4("(sandbox)")} ${green2("database recreated")}`);
+  viteConfig.logger.info(`${prefix2} ${import_picocolors6.green("database recreated")}`);
+  return { success: true };
+}
+
+// src/server/config-watcher.ts
+var DEBOUNCE_MS = 500;
+var VITE_CONFIG_NAMES = ["vite.config.ts", "vite.config.js", "vite.config.mjs"];
+var debounceTimer = null;
+function findExistingFiles(projectRoot, fileNames) {
+  return fileNames.map((name3) => path6.join(projectRoot, name3)).filter((file) => fs8.existsSync(file));
+}
+function createChangeHandler(server, viteConfig, platformModeOptions, watchedFiles) {
+  return async (changedPath) => {
+    const isWatchedFile = watchedFiles.some((file) => path6.resolve(changedPath) === path6.resolve(file));
+    if (!isWatchedFile)
+      return;
+    if (getCurrentMode() !== "platform")
+      return;
+    if (debounceTimer)
+      clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(async () => {
+      await recreateSandbox({
+        viteConfig,
+        platformModeOptions
+      });
+      server.ws.send({ type: "full-reload" });
+    }, DEBOUNCE_MS);
+  };
+}
+function setupConfigWatcher(server, viteConfig, platformModeOptions) {
+  const projectRoot = viteConfig.root;
+  const playcademyConfigs = findExistingFiles(projectRoot, CONFIG_FILE_NAMES);
+  const viteConfigs = findExistingFiles(projectRoot, VITE_CONFIG_NAMES);
+  const allConfigFiles = [...playcademyConfigs, ...viteConfigs];
+  if (allConfigFiles.length === 0)
+    return;
+  for (const configFile of allConfigFiles) {
+    server.watcher.add(configFile);
+  }
+  server.watcher.on("change", createChangeHandler(server, viteConfig, platformModeOptions, allConfigFiles));
+}
+
+// src/server/hotkeys/cycle-platform-role.ts
+var import_picocolors7 = __toESM(require_picocolors(), 1);
+
+// src/types/internal.ts
+var TIMEBACK_ROLES = ["student", "parent", "teacher", "administrator"];
+var PLATFORM_ROLES = ["player", "developer", "admin"];
+// src/server/hotkeys/cycle-platform-role.ts
+function cyclePlatformRole(logger) {
+  const currentRole = getPlatformRoleOverride() ?? "player";
+  const currentIndex = PLATFORM_ROLES.indexOf(currentRole);
+  const nextIndex = (currentIndex + 1) % PLATFORM_ROLES.length;
+  const nextRole = PLATFORM_ROLES[nextIndex];
+  const prefix2 = createLogPrefix("playcademy", "user");
+  setPlatformRoleOverride(nextRole);
+  logger.info(`${prefix2} ${import_picocolors7.red(currentRole)} → ${import_picocolors7.green(nextRole)}`);
+  if (getViteServerRef()) {
+    getViteServerRef()?.ws.send({ type: "full-reload", path: "*" });
+  } else {
+    logger.warn(`${prefix2} ${import_picocolors7.yellow("Cannot cycle platform role: no Vite server reference")}`);
+  }
+}
+var cyclePlatformRoleHotkey = (options) => ({
+  key: "p",
+  description: `${import_picocolors7.cyan(import_picocolors7.bold("[playcademy]"))} cycle platform role`,
+  action: () => cyclePlatformRole(options.viteConfig.logger)
+});
+
+// src/server/hotkeys/cycle-timeback-role.ts
+var import_picocolors8 = __toESM(require_picocolors(), 1);
+var { bold: bold4, cyan: cyan4, green: green4, red: red3, yellow: yellow3 } = import_picocolors8.default;
+function cycleTimebackRole(logger) {
+  const currentRole = getTimebackRoleOverride() ?? "student";
+  const currentIndex = TIMEBACK_ROLES.indexOf(currentRole);
+  const nextIndex = (currentIndex + 1) % TIMEBACK_ROLES.length;
+  const nextRole = TIMEBACK_ROLES[nextIndex];
+  setTimebackRoleOverride(nextRole);
+  getSandboxRef()?.setRole?.(nextRole);
+  const prefix2 = createLogPrefix("playcademy", "timeback");
+  logger.info(`${prefix2} ${red3(currentRole)} → ${green4(nextRole)}`);
+  if (getViteServerRef()) {
+    getViteServerRef()?.ws.send({ type: "full-reload", path: "*" });
+  } else {
+    logger.warn(`${prefix2} ${yellow3("Cannot cycle TimeBack role: no Vite server reference")}`);
+  }
+}
+var cycleTimebackRoleHotkey = (options) => ({
+  key: "t",
+  description: `${cyan4(bold4("[playcademy]"))} cycle Timeback role`,
+  action: () => cycleTimebackRole(options.viteConfig.logger)
+});
+
+// src/server/hotkeys/recreate-database.ts
+var import_picocolors9 = __toESM(require_picocolors(), 1);
+var { bold: bold5, cyan: cyan5 } = import_picocolors9.default;
+async function recreateSandboxDatabase(options) {
+  await recreateSandbox({
+    viteConfig: options.viteConfig,
+    platformModeOptions: options.platformModeOptions
+  });
 }
 var recreateDatabaseHotkey = (options) => ({
   key: "d",
-  description: "recreate sandbox database",
+  description: `${cyan5(bold5("[playcademy]"))} recreate sandbox database`,
   action: () => recreateSandboxDatabase(options)
 });
 
 // src/server/hotkeys/toggle-mode.ts
-var import_picocolors10 = __toESM(require_picocolors(), 1);
+var import_picocolors11 = __toESM(require_picocolors(), 1);
 // package.json
 var package_default2 = {
   name: "@playcademy/vite-plugin",
-  version: "0.1.37",
+  version: "0.2.0",
   type: "module",
   exports: {
     ".": {
@@ -211598,6 +212027,7 @@ var package_default2 = {
     pub: "bun publish.ts"
   },
   dependencies: {
+    "@playcademy/utils": "workspace:*",
     archiver: "^7.0.1",
     picocolors: "^1.1.1",
     playcademy: "workspace:*"
@@ -211622,27 +212052,29 @@ import {
 } from "playcademy/utils";
 
 // src/lib/backend/hot-reload.ts
-var import_picocolors8 = __toESM(require_picocolors(), 1);
-function formatChangedPath(changedPath) {
-  if (!changedPath)
-    return;
-  if (changedPath.includes("/api/")) {
-    return changedPath.substring(changedPath.indexOf("/api/"));
-  }
-  return changedPath;
-}
+var import_picocolors10 = __toESM(require_picocolors(), 1);
+import path7 from "node:path";
 function createHotReloadCallbacks(viteConfig) {
+  const formatPath = (changedPath) => {
+    if (!changedPath)
+      return;
+    if (changedPath.startsWith(viteConfig.root)) {
+      return path7.relative(viteConfig.root, changedPath);
+    }
+    return changedPath;
+  };
+  const prefix2 = createLogPrefix("playcademy", "backend");
   return {
     onSuccess: (changedPath) => {
-      const relativePath = formatChangedPath(changedPath);
+      const relativePath = formatPath(changedPath);
       if (relativePath) {
-        viteConfig.logger.info(`${import_picocolors8.dim("(backend)")} ${import_picocolors8.green("hmr update")} ${import_picocolors8.dim(relativePath)}`, { timestamp: true });
+        viteConfig.logger.info(`${prefix2} ${import_picocolors10.green("hmr update")} ${import_picocolors10.dim(relativePath)}`);
       } else {
-        viteConfig.logger.info("backend reloaded", { timestamp: true });
+        viteConfig.logger.info(`${prefix2} reloaded`);
       }
     },
     onError: (error2) => {
-      viteConfig.logger.error(`backend reload failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
+      viteConfig.logger.error(`${prefix2} reload failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
     }
   };
 }
@@ -211679,78 +212111,101 @@ function setupHotReload(serverRef, options) {
   return () => watcher.close();
 }
 async function setupCliDevServer(options) {
-  const { preferredPort, viteConfig, platformUrl, configPath } = options;
+  const { port, viteConfig, platformUrl, configPath } = options;
   const config2 = await tryLoadConfig(viteConfig, configPath);
   if (!config2)
     return null;
   if (!needsCliDevServer(config2))
     return null;
   try {
-    const port = await findAvailablePort(preferredPort);
-    const serverOptions = { port, config: config2, platformUrl, viteConfig };
+    const serverOptions = {
+      port,
+      config: config2,
+      platformUrl,
+      viteConfig
+    };
     const serverRef = { current: await startServer2(serverOptions) };
     const stopHotReload = setupHotReload(serverRef, serverOptions);
     return {
       server: serverRef.current.server,
       port: serverRef.current.port,
       stopHotReload,
-      cleanup: () => cleanupServerInfo("backend", viteConfig.root, process.pid)
+      cleanup: () => {}
     };
   } catch (error2) {
-    viteConfig.logger.error(`Failed to start game backend: ${error2 instanceof Error ? error2.message : String(error2)}`);
+    const message3 = error2 instanceof Error ? error2.message : String(error2);
+    viteConfig.logger.error(`Failed to start game backend: ${message3}`);
     return null;
   }
 }
 // src/server/platform-mode.ts
+var BANNER_PRINTED = false;
+function isCycleableRole(role) {
+  return TIMEBACK_ROLES.includes(role);
+}
 async function configurePlatformMode(server, viteConfig, options) {
+  const timebackDisabled = options.timeback === false;
+  const timebackOptions = options.timeback || undefined;
+  if (timebackOptions?.role && isCycleableRole(timebackOptions.role)) {
+    setTimebackRoleOverride(timebackOptions.role);
+  }
   const sandbox = await startSandbox(viteConfig, options.startSandbox, {
+    port: options.sandboxPort,
     verbose: options.verbose,
     logLevel: options.logLevel,
     customUrl: options.sandboxUrl,
-    quiet: true,
     recreateDb: options.recreateDb,
     seed: options.seed,
     memoryOnly: options.memoryOnly,
     databasePath: options.databasePath,
     realtimeEnabled: options.realtimeEnabled,
     realtimePort: options.realtimePort,
-    timebackId: getEffectiveTimebackId(options.timeback)
+    timebackOptions: timebackDisabled ? false : options.timeback
   });
   serverState.sandbox = sandbox;
   const backend = await setupCliDevServer({
-    preferredPort: options.preferredBackendPort,
+    port: options.backendPort,
     viteConfig,
     platformUrl: sandbox.baseUrl,
     configPath: options.configPath
   });
   serverState.backend = backend;
   if (sandbox.project) {
-    validateTimebackConfig(viteConfig, options.timeback);
+    if (!timebackDisabled) {
+      validateTimebackConfig(viteConfig, timebackOptions);
+    }
     const gameUrl = backend ? `http://localhost:${backend.port}` : undefined;
+    const timebackContext = timebackDisabled ? undefined : {
+      baseCourses: sandbox.project.timebackCourses ?? [],
+      overrides: timebackOptions
+    };
     devServerMiddleware(server, sandbox, gameUrl, {
-      showBadge: options.showBadge,
-      timeback: options.timeback
+      hideBadge: options.hideBadge,
+      timeback: timebackContext
+    });
+  }
+  if (!BANNER_PRINTED) {
+    server.httpServer?.once("listening", () => {
+      setTimeout(async () => {
+        const projectInfo = await extractProjectInfo(viteConfig, timebackOptions);
+        printBanner(viteConfig, {
+          version: package_default2.version,
+          gameName: projectInfo.slug,
+          sandbox: { port: sandbox.port, enabled: true },
+          backend: createBackendBannerOptions(backend?.port, server.config.server.port),
+          realtimePort: sandbox.realtimePort,
+          timeback: createTimebackBannerOptions(sandbox.timebackMode, projectInfo.timebackCourses?.length)
+        });
+        BANNER_PRINTED = true;
+      }, 100);
     });
   }
-  server.httpServer?.once("listening", () => {
-    setTimeout(async () => {
-      const projectInfo = await extractProjectInfo(viteConfig);
-      const vitePort = server.config.server.port;
-      printBanner(viteConfig, {
-        sandbox: sandbox.port,
-        backend: backend?.port,
-        realtime: sandbox.realtimePort,
-        vite: vitePort
-      }, projectInfo, package_default2.version);
-    }, 100);
-  });
 }
 
 // src/server/standalone-mode.ts
-var import_picocolors9 = __toESM(require_picocolors(), 1);
 async function configureStandaloneMode(server, viteConfig, options) {
   const backend = await setupCliDevServer({
-    preferredPort: options.preferredPort,
+    port: options.backendPort,
     viteConfig,
     platformUrl: undefined,
     configPath: options.configPath
@@ -211762,33 +212217,23 @@ async function configureStandaloneMode(server, viteConfig, options) {
   serverState.backend = backend;
   server.httpServer?.once("listening", () => {
     setTimeout(() => {
-      viteConfig.logger.info("");
-      viteConfig.logger.info(`  ${import_picocolors9.default.green(import_picocolors9.default.bold("PLAYCADEMY"))} ${import_picocolors9.default.green(`v${package_default2.version}`)}`);
-      viteConfig.logger.info("");
-      viteConfig.logger.info(`  ${import_picocolors9.default.green("➜")}  ${import_picocolors9.default.bold("Backend:")}  ${import_picocolors9.default.cyan(`http://localhost:${backend.port}`)}`);
-      viteConfig.logger.info(`  ${import_picocolors9.default.green("➜")}  ${import_picocolors9.default.bold("Sandbox:")}  ${import_picocolors9.default.cyan("Disabled")}`);
-      viteConfig.logger.info("");
+      printBanner(viteConfig, {
+        version: package_default2.version,
+        sandbox: { enabled: false },
+        backend: { port: backend.port }
+      });
     }, 100);
   });
 }
 
 // src/server/hotkeys/toggle-mode.ts
-var { bold: bold5, cyan: cyan4, dim: dim6, green: green4, red: red2 } = import_picocolors10.default;
-function formatTimestamp4() {
-  const now2 = new Date;
-  const hours = now2.getHours();
-  const minutes = now2.getMinutes().toString().padStart(2, "0");
-  const seconds = now2.getSeconds().toString().padStart(2, "0");
-  const ampm = hours >= 12 ? "PM" : "AM";
-  const displayHours = hours % 12 || 12;
-  return dim6(`${displayHours}:${minutes}:${seconds} ${ampm}`);
-}
 async function toggleMode(options) {
   const currentMode = getCurrentMode();
   const newMode = currentMode === "platform" ? "standalone" : "platform";
   const viteServer = getViteServerRef();
+  const prefix2 = createLogPrefix("playcademy");
   if (!viteServer) {
-    options.viteConfig.logger.error(`${formatTimestamp4()} ${red2(bold5("[playcademy]"))} ${red2("Cannot toggle mode: no Vite server reference")}`);
+    options.viteConfig.logger.error(`${prefix2} ${import_picocolors11.red("Cannot toggle mode: no Vite server reference")}`);
     return;
   }
   await cleanupServers();
@@ -211796,17 +212241,17 @@ async function toggleMode(options) {
   setCurrentMode(newMode);
   if (newMode === "standalone") {
     await configureStandaloneMode(viteServer, options.viteConfig, {
-      preferredPort: options.platformModeOptions.preferredBackendPort,
+      backendPort: options.platformModeOptions.backendPort,
       configPath: options.platformModeOptions.configPath
     });
   } else {
     await configurePlatformMode(viteServer, options.viteConfig, options.platformModeOptions);
   }
-  options.viteConfig.logger.info(`${formatTimestamp4()} ${cyan4(bold5("[playcademy]"))} ${green4("switched to")} ${green4(bold5(newMode))} ${green4("mode")}`);
+  options.viteConfig.logger.info(`${prefix2} ${import_picocolors11.green("switched to")} ${import_picocolors11.green(import_picocolors11.bold(newMode))} ${import_picocolors11.green("mode")}`);
 }
 var toggleModeHotkey = (options) => ({
   key: "m",
-  description: "toggle platform/standalone mode",
+  description: `${import_picocolors11.cyan(import_picocolors11.bold("[playcademy]"))} toggle platform/standalone mode`,
   action: () => toggleMode(options)
 });
 
@@ -211815,6 +212260,7 @@ function getHotkeys(options) {
   return [
     toggleModeHotkey(options),
     recreateDatabaseHotkey(options),
+    cyclePlatformRoleHotkey(options),
     cycleTimebackRoleHotkey(options)
   ];
 }
@@ -211847,11 +212293,12 @@ async function configureServerHook(server, context) {
   setupProcessShutdownHandlers();
   if (hasActiveServers()) {
     await cleanupServers();
-    await new Promise((resolve2) => setTimeout(resolve2, 100));
   }
-  const preferredPort = context.backendPort ?? DEFAULT_PORTS3.BACKEND;
+  const backendPort = context.backendPort ?? DEFAULT_PORTS3.BACKEND;
+  const sandboxPort = context.sandboxPort ?? DEFAULT_PORTS3.SANDBOX;
   const platformModeOptions = {
     startSandbox: context.options.startSandbox,
+    sandboxPort,
     verbose: context.options.verbose,
     logLevel: context.options.logLevel,
     sandboxUrl: context.options.sandboxUrl,
@@ -211861,18 +212308,19 @@ async function configureServerHook(server, context) {
     databasePath: context.options.databasePath,
     realtimeEnabled: context.options.realtimeEnabled,
     realtimePort: context.options.realtimePort,
-    showBadge: context.options.showBadge,
-    preferredBackendPort: preferredPort,
+    hideBadge: context.options.hideBadge,
+    backendPort,
     configPath: context.options.configPath,
     timeback: context.options.timeback
   };
   if (context.options.mode === "standalone") {
     await configureStandaloneMode(server, context.viteConfig, {
-      preferredPort,
+      backendPort,
       configPath: context.options.configPath
     });
   } else {
     await configurePlatformMode(server, context.viteConfig, platformModeOptions);
+    setupConfigWatcher(server, context.viteConfig, platformModeOptions);
   }
   const originalBindCLIShortcuts = server.bindCLIShortcuts?.bind(server);
   if (originalBindCLIShortcuts) {
@@ -211892,12 +212340,12 @@ async function configureServerHook(server, context) {
 }
 
 // src/hooks/write-bundle.ts
-import path6 from "node:path";
+import path8 from "node:path";
 async function writeBundleHook(context) {
   if (!context.viteConfig) {
     throw new Error("[Playcademy] Vite config not resolved before writeBundle");
   }
-  const outDir = context.viteConfig.build.outDir || path6.join(process.cwd(), "dist");
+  const outDir = context.viteConfig.build.outDir || path8.join(process.cwd(), "dist");
   try {
     await generatePlaycademyManifest(context.viteConfig, outDir, context.buildOutputs);
     if (context.options.autoZip) {
@@ -211916,7 +212364,7 @@ async function writeBundleHook(context) {
 function resolveOptions(options) {
   const exportOptions = options.export ?? {};
   const sandboxOptions = options.sandbox ?? {};
-  const shellOptions = options.shell ?? {};
+  const displayOptions = options.display ?? {};
   const realtimeOptions = sandboxOptions.realtime ?? {};
   return {
     configPath: options.configPath,
@@ -211932,7 +212380,7 @@ function resolveOptions(options) {
     databasePath: sandboxOptions.databasePath,
     realtimeEnabled: realtimeOptions.enabled ?? false,
     realtimePort: realtimeOptions.port,
-    showBadge: shellOptions.showBadge ?? true,
+    hideBadge: displayOptions.hideBadge ?? false,
     timeback: options.timeback
   };
 }
@@ -211941,6 +212389,7 @@ function createPluginContext(options) {
     options: resolveOptions(options),
     viteConfig: null,
     backendPort: null,
+    sandboxPort: null,
     buildOutputs: {}
   };
 }