playcademy 0.12.6 → 0.12.8

package/dist/db.js

@@ -629,6 +629,9 @@ import { dirname, resolve } from "path";
 import { fileURLToPath } from "url";
 var currentDir = dirname(fileURLToPath(import.meta.url));
 
+// src/lib/core/import.ts
+import * as esbuild from "esbuild";
+
 // src/lib/db/reset.ts
 function resetDatabase() {
   const dbPath = getDevDbPath();

package/dist/index.js

@@ -3610,6 +3610,46 @@ var init_errors = __esm({
   }
 });
 
+// src/lib/core/import.ts
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join as join3 } from "path";
+import { pathToFileURL } from "url";
+import * as esbuild from "esbuild";
+async function importTypescriptFile(filePath, bundleOptions) {
+  const tempDir = mkdtempSync(join3(tmpdir(), "playcademy-import-"));
+  const outFile = join3(tempDir, "bundle.mjs");
+  try {
+    await esbuild.build({
+      entryPoints: [filePath],
+      outfile: outFile,
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: false,
+      minify: false,
+      ...bundleOptions
+    });
+    const module = await import(pathToFileURL(outFile).href);
+    return module;
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+async function importTypescriptDefault(filePath, bundleOptions) {
+  const module = await importTypescriptFile(filePath, bundleOptions);
+  if (module && typeof module === "object" && "default" in module) {
+    return module.default;
+  }
+  return module;
+}
+var init_import = __esm({
+  "src/lib/core/import.ts"() {
+    "use strict";
+  }
+});
+
 // src/lib/core/index.ts
 var core_exports = {};
 __export(core_exports, {
@@ -3628,6 +3668,8 @@ __export(core_exports, {
   getWebBaseUrl: () => getWebBaseUrl,
   getWorkspace: () => getWorkspace,
   hasPackageJson: () => hasPackageJson,
+  importTypescriptDefault: () => importTypescriptDefault,
+  importTypescriptFile: () => importTypescriptFile,
   logAndExit: () => logAndExit,
   logger: () => logger,
   normalizeEnvironment: () => normalizeEnvironment,
@@ -3642,6 +3684,7 @@ var init_core = __esm({
     init_context();
     init_errors();
     init_game();
+    init_import();
     init_logger();
   }
 });
@@ -4476,7 +4519,7 @@ init_core();
 // src/lib/db/path.ts
 init_constants2();
 import { copyFileSync, existsSync as existsSync5, mkdirSync, readdirSync as readdirSync2, unlinkSync } from "fs";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import Database from "better-sqlite3";
 var DB_DIRECTORY = CLI_DIRECTORIES.DATABASE;
 var INITIAL_DB_NAME = CLI_FILES.INITIAL_DATABASE;
@@ -4490,11 +4533,11 @@ var createEmptyDatabase = (path2) => {
   db.close();
 };
 var findMiniflareDatabase = (dbDir) => {
-  const miniflareDir = join3(dbDir, "miniflare-D1DatabaseObject");
+  const miniflareDir = join4(dbDir, "miniflare-D1DatabaseObject");
   if (!existsSync5(miniflareDir)) return null;
   const sqliteFiles = readdirSync2(miniflareDir).filter((file) => file.endsWith(".sqlite"));
   if (sqliteFiles.length === 0) return null;
-  return join3(miniflareDir, sqliteFiles[0]);
+  return join4(miniflareDir, sqliteFiles[0]);
 };
 var migrateInitialDbToTarget = (initialPath, targetPath) => {
   if (!existsSync5(initialPath)) return;
@@ -4502,7 +4545,7 @@ var migrateInitialDbToTarget = (initialPath, targetPath) => {
   unlinkSync(initialPath);
 };
 function getDevDbPath() {
-  const initialDbPath = join3(DB_DIRECTORY, INITIAL_DB_NAME);
+  const initialDbPath = join4(DB_DIRECTORY, INITIAL_DB_NAME);
   ensureDirectoryExists(DB_DIRECTORY);
   const miniflareDbPath = findMiniflareDatabase(DB_DIRECTORY);
   if (miniflareDbPath) {
@@ -4562,7 +4605,7 @@ init_src();
 init_constants2();
 init_core();
 import { existsSync as existsSync10 } from "node:fs";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 // src/lib/init/database.ts
 init_log();
@@ -4572,7 +4615,7 @@ init_core();
 init_logger();
 init_loader2();
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
 var dbSchemaUsersTemplate = loadTemplateString("database/db-schema-users.ts");
 var dbSchemaScoresTemplate = loadTemplateString("database/db-schema-scores.ts");
@@ -4586,7 +4629,7 @@ function normalizeGitignoreEntry(entry) {
   return entry.replace(/^\/+/, "").replace(/\/+$/, "");
 }
 function ensureGitignoreEntries(workspace) {
-  const gitignorePath = join4(workspace, ".gitignore");
+  const gitignorePath = join5(workspace, ".gitignore");
   if (!existsSync6(gitignorePath)) {
     writeFileSync2(gitignorePath, rootGitignoreTemplate);
     return;
@@ -4616,31 +4659,31 @@ async function scaffoldDatabaseSetup(options) {
   await runStep(
     "Configuring database...",
     async () => {
-      const dbDir = join4(workspace, "db");
-      const schemaDir = join4(dbDir, "schema");
+      const dbDir = join5(workspace, "db");
+      const schemaDir = join5(dbDir, "schema");
       if (!existsSync6(dbDir)) {
         mkdirSync2(dbDir, { recursive: true });
       }
       if (!existsSync6(schemaDir)) {
         mkdirSync2(schemaDir, { recursive: true });
       }
-      const usersSchemaPath = join4(schemaDir, "users.ts");
+      const usersSchemaPath = join5(schemaDir, "users.ts");
       writeFileSync2(usersSchemaPath, dbSchemaUsersTemplate);
-      const scoresSchemaPath = join4(schemaDir, "scores.ts");
+      const scoresSchemaPath = join5(schemaDir, "scores.ts");
       writeFileSync2(scoresSchemaPath, dbSchemaScoresTemplate);
-      const schemaIndexPath = join4(schemaDir, "index.ts");
+      const schemaIndexPath = join5(schemaDir, "index.ts");
       writeFileSync2(schemaIndexPath, dbSchemaIndexTemplate);
-      const dbIndexPath = join4(dbDir, "index.ts");
+      const dbIndexPath = join5(dbDir, "index.ts");
       writeFileSync2(dbIndexPath, dbIndexTemplate);
-      const dbTypesPath = join4(dbDir, "types.ts");
+      const dbTypesPath = join5(dbDir, "types.ts");
       writeFileSync2(dbTypesPath, dbTypesTemplate);
-      const drizzleConfigPath = join4(workspace, "drizzle.config.ts");
+      const drizzleConfigPath = join5(workspace, "drizzle.config.ts");
       writeFileSync2(drizzleConfigPath, drizzleConfigTemplate);
-      const playcademyDir = join4(workspace, CLI_DIRECTORIES.WORKSPACE);
+      const playcademyDir = join5(workspace, CLI_DIRECTORIES.WORKSPACE);
       if (!existsSync6(playcademyDir)) {
         mkdirSync2(playcademyDir, { recursive: true });
       }
-      const playcademyGitignorePath = join4(playcademyDir, ".gitignore");
+      const playcademyGitignorePath = join5(playcademyDir, ".gitignore");
       writeFileSync2(playcademyGitignorePath, playcademyGitignoreTemplate);
       ensureGitignoreEntries(workspace);
       packagesUpdated = await setupPackageJson(workspace, options.gameName);
@@ -4650,7 +4693,7 @@ async function scaffoldDatabaseSetup(options) {
   return packagesUpdated;
 }
 async function setupPackageJson(workspace, gameName) {
-  const pkgPath = join4(workspace, "package.json");
+  const pkgPath = join5(workspace, "package.json");
   const dbDeps = {
     "drizzle-orm": "^0.42.0",
     "better-sqlite3": "^12.0.0"
@@ -4690,8 +4733,8 @@ async function setupPackageJson(workspace, gameName) {
 }
 function hasDatabaseSetup() {
   const workspace = getWorkspace();
-  const drizzleConfigPath = join4(workspace, "drizzle.config.ts");
-  const drizzleConfigJsPath = join4(workspace, "drizzle.config.js");
+  const drizzleConfigPath = join5(workspace, "drizzle.config.ts");
+  const drizzleConfigJsPath = join5(workspace, "drizzle.config.js");
   return existsSync6(drizzleConfigPath) || existsSync6(drizzleConfigJsPath);
 }
 
@@ -4825,7 +4868,7 @@ var integrationChangeDetectors = {
 
 // src/lib/deploy/bundle.ts
 import { existsSync as existsSync7 } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // ../edge-play/src/entry.ts
 var entry_default = "/**\n * Game Backend Entry Point\n *\n * This file is the main entry point for deployed game backends.\n * It creates a Hono app and registers all enabled integration routes.\n *\n * Bundled with esbuild and deployed to Cloudflare Workers (or AWS Lambda).\n * Config is injected at build time via esbuild's `define` option.\n */\n\nimport { Hono } from 'hono'\nimport { cors } from 'hono/cors'\n\nimport { PlaycademyClient } from '@playcademy/sdk/server'\n\nimport { ENV_VARS } from './constants'\nimport { registerBuiltinRoutes } from './register-routes'\n\nimport type { PlaycademyConfig } from '@playcademy/sdk/server'\nimport type { HonoEnv } from './types'\n\n/**\n * Config injected at build time by esbuild\n *\n * The `declare const` tells TypeScript \"this exists at runtime, trust me.\"\n * During bundling, esbuild's `define` option does literal text replacement:\n *\n * Example bundling:\n *   Source:  if (PLAYCADEMY_CONFIG.integrations.timeback) { ... }\n *   Define:  { 'PLAYCADEMY_CONFIG': JSON.stringify({ integrations: { timeback: {...} } }) }\n *   Output:  if ({\"integrations\":{\"timeback\":{...}}}.integrations.timeback) { ... }\n *\n * This enables tree-shaking: if timeback is not configured, those code paths are removed.\n * The bundled Worker only includes the routes that are actually enabled.\n */\ndeclare const PLAYCADEMY_CONFIG: PlaycademyConfig & {\n    customRoutes?: Array<{ path: string; file: string }>\n}\n\n// XXX: Polyfill process global for SDK compatibility\n// SDK code may reference process.env without importing it\n// @ts-expect-error - Adding global for Worker environment\nglobalThis.process = {\n    env: {}, // Populated per-request from Worker env bindings\n    cwd: () => '/',\n}\n\nconst app = new Hono<HonoEnv>()\n\n// TODO: Harden CORS in production - restrict to trusted origins:\n// - Game's assetBundleBase (for hosted games)\n// - Game's externalUrl (for external games)\n// - Platform frontend domains (hub.playcademy.com, hub.dev.playcademy.net)\n// This would require passing game metadata through env bindings during deployment\napp.use(\n    '*',\n    cors({\n        origin: '*', // Permissive for now\n        allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],\n        allowHeaders: ['Content-Type', 'Authorization'],\n    }),\n)\n\nlet sdkPromise: Promise<PlaycademyClient> | null = null\n\napp.use('*', async (c, next) => {\n    // Populate process.env from Worker bindings for SDK compatibility\n    globalThis.process.env = {\n        [ENV_VARS.PLAYCADEMY_API_KEY]: c.env.PLAYCADEMY_API_KEY,\n        [ENV_VARS.GAME_ID]: c.env.GAME_ID,\n        [ENV_VARS.PLAYCADEMY_BASE_URL]: c.env.PLAYCADEMY_BASE_URL,\n    }\n\n    // Set config for all routes\n    c.set('config', PLAYCADEMY_CONFIG)\n    c.set('customRoutes', PLAYCADEMY_CONFIG.customRoutes || [])\n\n    await next()\n})\n\n// Initialize SDK lazily on first request\napp.use('*', async (c, next) => {\n    if (!sdkPromise) {\n        sdkPromise = PlaycademyClient.init({\n            apiKey: c.env[ENV_VARS.PLAYCADEMY_API_KEY],\n            gameId: c.env[ENV_VARS.GAME_ID],\n            baseUrl: c.env[ENV_VARS.PLAYCADEMY_BASE_URL],\n            config: PLAYCADEMY_CONFIG,\n        })\n    }\n\n    c.set('sdk', await sdkPromise)\n    await next()\n})\n\n/**\n * Register built-in integration routes based on enabled integrations\n *\n * This function conditionally imports and registers routes like:\n * - POST /api/integrations/timeback/end-activity (if timeback enabled)\n * - GET /api/health (always included)\n *\n * Uses dynamic imports for tree-shaking: if an integration is not enabled,\n * its route code is completely removed from the bundle.\n */\nawait registerBuiltinRoutes(app, PLAYCADEMY_CONFIG.integrations)\n\nexport default app\n";
@@ -5051,8 +5094,8 @@ init_constants2();
 function textLoaderPlugin() {
   return {
     name: "text-loader",
-    setup(build) {
-      build.onLoad({ filter: /edge-play\/src\/entry\.ts$/ }, async (args) => {
+    setup(build2) {
+      build2.onLoad({ filter: /edge-play\/src\/entry\.ts$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text5 = await fs2.readFile(args.path, "utf8");
         return {
@@ -5060,7 +5103,7 @@ function textLoaderPlugin() {
           loader: "js"
         };
       });
-      build.onLoad({ filter: /edge-play\/src\/routes\/root\.html$/ }, async (args) => {
+      build2.onLoad({ filter: /edge-play\/src\/routes\/root\.html$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text5 = await fs2.readFile(args.path, "utf8");
         return {
@@ -5068,7 +5111,7 @@ function textLoaderPlugin() {
           loader: "js"
         };
       });
-      build.onLoad({ filter: /templates\/sample-route\.ts$/ }, async (args) => {
+      build2.onLoad({ filter: /templates\/sample-route\.ts$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text5 = await fs2.readFile(args.path, "utf8");
         return {
@@ -5087,8 +5130,8 @@ init_core();
 init_file_loader();
 init_core();
 import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
-import { tmpdir } from "os";
-import { join as join5, relative } from "path";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join6, relative } from "path";
 
 // src/lib/deploy/hash.ts
 init_file_loader();
@@ -5136,7 +5179,7 @@ async function discoverRoutes(apiDir) {
   const routes = await Promise.all(
     files.map(async (file) => {
       const routePath = filePathToRoutePath(file);
-      const absolutePath = join5(apiDir, file);
+      const absolutePath = join6(apiDir, file);
       const relativePath = relative(getWorkspace(), absolutePath);
       const methods = await detectExportedMethods(absolutePath);
       return {
@@ -5181,8 +5224,8 @@ async function transpileRoute(filePath) {
   if (isBun() || !filePath.endsWith(".ts")) {
     return filePath;
   }
-  const esbuild = await import("esbuild");
-  const result = await esbuild.build({
+  const esbuild2 = await import("esbuild");
+  const result = await esbuild2.build({
     entryPoints: [filePath],
     write: false,
     format: "esm",
@@ -5196,10 +5239,10 @@ async function transpileRoute(filePath) {
   if (!result.outputFiles?.[0]) {
     throw new Error("Transpilation failed: no output");
   }
-  const tempDir = join5(tmpdir(), "playcademy-dev");
+  const tempDir = join6(tmpdir2(), "playcademy-dev");
   await mkdir2(tempDir, { recursive: true });
   const hash = hashContent(filePath).slice(0, 12);
-  const jsPath = join5(tempDir, `${hash}.mjs`);
+  const jsPath = join6(tempDir, `${hash}.mjs`);
   await writeFile2(jsPath, result.outputFiles[0].text);
   return jsPath;
 }
@@ -5227,7 +5270,7 @@ async function discoverCustomRoutes(config) {
   const workspace = getWorkspace();
   const customRoutesConfig = config.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  const customRoutes = await discoverRoutes(join6(workspace, customRoutesDir));
+  const customRoutes = await discoverRoutes(join7(workspace, customRoutesDir));
   const customRouteData = customRoutes.map((r) => ({
     path: r.path,
     file: r.file,
@@ -5239,15 +5282,15 @@ async function discoverCustomRoutes(config) {
 function resolveEmbeddedSourcePaths() {
   const workspace = getWorkspace();
   const distDir = new URL(".", import.meta.url).pathname;
-  const embeddedEdgeSrc = join6(distDir, "edge-play", "src");
+  const embeddedEdgeSrc = join7(distDir, "edge-play", "src");
   const isBuiltPackage = existsSync7(embeddedEdgeSrc);
   const monorepoRoot = getMonorepoRoot();
-  const monorepoEdgeSrc = join6(monorepoRoot, "packages/edge-play/src");
+  const monorepoEdgeSrc = join7(monorepoRoot, "packages/edge-play/src");
   const edgePlaySrc = isBuiltPackage ? embeddedEdgeSrc : monorepoEdgeSrc;
-  const cliPackageRoot = isBuiltPackage ? join6(distDir, "../../..") : join6(monorepoRoot, "packages/cli");
-  const cliNodeModules = isBuiltPackage ? join6(cliPackageRoot, "node_modules") : monorepoRoot;
-  const workspaceNodeModules = join6(workspace, "node_modules");
-  const constantsEntry = isBuiltPackage ? join6(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join6(monorepoRoot, "packages", "constants", "src", "index.ts");
+  const cliPackageRoot = isBuiltPackage ? join7(distDir, "../../..") : join7(monorepoRoot, "packages/cli");
+  const cliNodeModules = isBuiltPackage ? join7(cliPackageRoot, "node_modules") : monorepoRoot;
+  const workspaceNodeModules = join7(workspace, "node_modules");
+  const constantsEntry = isBuiltPackage ? join7(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join7(monorepoRoot, "packages", "constants", "src", "index.ts");
   return {
     isBuiltPackage,
     edgePlaySrc,
@@ -5307,16 +5350,16 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
       // │ Example: import * as route from '@game-api/hello.ts'            │
       // │ Resolves to: /user-project/server/api/hello.ts                  │
       // └─────────────────────────────────────────────────────────────────┘
-      "@game-api": join6(workspace, customRoutesDir),
+      "@game-api": join7(workspace, customRoutesDir),
       // ┌─ Node.js polyfills for Cloudflare Workers ──────────────────────┐
       // │ Workers don't have fs, path, os, etc. Redirect to polyfills     │
       // │ that throw helpful errors if user code tries to use them.       │
       // └─────────────────────────────────────────────────────────────────┘
-      fs: join6(edgePlaySrc, "polyfills.js"),
-      "fs/promises": join6(edgePlaySrc, "polyfills.js"),
-      path: join6(edgePlaySrc, "polyfills.js"),
-      os: join6(edgePlaySrc, "polyfills.js"),
-      process: join6(edgePlaySrc, "polyfills.js")
+      fs: join7(edgePlaySrc, "polyfills.js"),
+      "fs/promises": join7(edgePlaySrc, "polyfills.js"),
+      path: join7(edgePlaySrc, "polyfills.js"),
+      os: join7(edgePlaySrc, "polyfills.js"),
+      process: join7(edgePlaySrc, "polyfills.js")
     },
     // ──── Build Plugins ────
     plugins: [textLoaderPlugin()],
@@ -5327,7 +5370,7 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
   };
 }
 async function bundleBackend(config, options = {}) {
-  const esbuild = await import("esbuild");
+  const esbuild2 = await import("esbuild");
   const { customRouteData, customRoutesDir } = await discoverCustomRoutes(config);
   const bundleConfig = {
     ...config,
@@ -5342,7 +5385,7 @@ async function bundleBackend(config, options = {}) {
     customRoutesDir,
     options
   );
-  const result = await esbuild.build(buildConfig);
+  const result = await esbuild2.build(buildConfig);
   if (!result.outputFiles?.[0]) {
     throw new Error("Backend bundling failed: no output");
   }
@@ -5382,7 +5425,7 @@ function generateEntryCode(customRoutes, customRoutesDir) {
 init_core();
 import { existsSync as existsSync9 } from "fs";
 import { createRequire } from "module";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 
 // src/lib/init/prompts.ts
 init_constants3();
@@ -5395,7 +5438,7 @@ init_src();
 init_core();
 init_loader2();
 import { existsSync as existsSync8, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { join as join7, resolve as resolve6 } from "path";
+import { join as join8, resolve as resolve6 } from "path";
 var sampleRouteTemplate = loadTemplateString("api/sample-route.ts");
 var sampleRouteWithDbTemplate = loadTemplateString("api/sample-route-with-db.ts");
 async function scaffoldApiDirectory(apiDirectory, sampleRouteTemplate2) {
@@ -5405,7 +5448,7 @@ async function scaffoldApiDirectory(apiDirectory, sampleRouteTemplate2) {
     async () => {
       if (!existsSync8(apiPath)) {
         mkdirSync3(apiPath, { recursive: true });
-        writeFileSync3(join7(apiPath, "hello.ts"), sampleRouteTemplate2, "utf-8");
+        writeFileSync3(join8(apiPath, "hello.ts"), sampleRouteTemplate2, "utf-8");
       }
     },
     "API directory scaffolded"
@@ -5637,7 +5680,7 @@ async function getSchemaInfo(previousSchemaSnapshot) {
   if (!hasDatabaseSetup()) {
     return null;
   }
-  const schemaPath = join8(workspace, "db/schema/index.ts");
+  const schemaPath = join9(workspace, "db/schema/index.ts");
   if (!existsSync9(schemaPath)) {
     return null;
   }
@@ -5645,8 +5688,7 @@ async function getSchemaInfo(previousSchemaSnapshot) {
     const require2 = createRequire(import.meta.url);
     const drizzleKitApi = require2("drizzle-kit/api");
     const { generateSQLiteDrizzleJson, generateSQLiteMigration } = drizzleKitApi;
-    const schemaModule = await import(schemaPath);
-    const currentSchema = schemaModule.default || schemaModule;
+    const currentSchema = await importTypescriptDefault(schemaPath);
     const nextJson = await generateSQLiteDrizzleJson(currentSchema);
     const prevJson = previousSchemaSnapshot ? previousSchemaSnapshot : await generateSQLiteDrizzleJson({});
     const migrationStatements = await generateSQLiteMigration(prevJson, nextJson);
@@ -5688,7 +5730,7 @@ var CUSTOM_ROUTES_EXTENSIONS_WITH_DOT = [".ts", ".js", ".mjs", ".cjs"];
 function getCustomRoutesDirectory(projectPath, config) {
   const customRoutes = config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutes === "object" && customRoutes.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  return join9(projectPath, customRoutesDir);
+  return join10(projectPath, customRoutesDir);
 }
 function hasLocalCustomRoutes(projectPath, config) {
   const customRoutesDir = getCustomRoutesDirectory(projectPath, config);
@@ -5700,7 +5742,7 @@ async function getCustomRoutesHash(projectPath, config) {
 }
 async function getCustomRoutesSize(projectPath, config) {
   const { stat: stat3, readdir } = await import("node:fs/promises");
-  const { join: join19 } = await import("node:path");
+  const { join: join20 } = await import("node:path");
   const customRoutesDir = getCustomRoutesDirectory(projectPath, config);
   if (!existsSync10(customRoutesDir)) {
     return null;
@@ -5709,7 +5751,7 @@ async function getCustomRoutesSize(projectPath, config) {
   async function calculateDirSize(dir) {
     const entries = await readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join19(dir, entry.name);
+      const fullPath = join20(dir, entry.name);
       if (entry.isDirectory()) {
         await calculateDirSize(fullPath);
       } else if (entry.isFile()) {
@@ -5932,14 +5974,14 @@ function formatDelta(bytes) {
   return `${arrow} ${value.toFixed(2)} ${unit}`;
 }
 function displayDeploymentDiff(options) {
-  const { diff, noChanges, build, backend, integrations } = options;
+  const { diff, noChanges, build: build2, backend, integrations } = options;
   if (noChanges) {
     logger.remark("No changes detected");
     logger.newLine();
     return;
   }
   const hasConfigChanges = Object.keys(diff).length > 0;
-  const buildChanged = build?.changed === true;
+  const buildChanged = build2?.changed === true;
   const backendChanged = backend?.changed === true;
   const customRoutesChanged = backend?.customRoutesChanged === true;
   const forceBackend = backend?.forced;
@@ -5985,8 +6027,8 @@ function displayDeploymentDiff(options) {
   if (buildChanged) {
     logger.bold("Frontend", 1);
     let buildInfo;
-    const previousSize = build?.previousSize;
-    const currentSize = build?.currentSize;
+    const previousSize = build2?.previousSize;
+    const currentSize = build2?.currentSize;
     if (previousSize !== void 0 && currentSize !== void 0) {
       const oldSize = formatSize(previousSize);
       const newSize = formatSize(currentSize);
@@ -6079,10 +6121,10 @@ import { dim as dim4 } from "colorette";
 init_file_loader();
 init_constants2();
 init_core();
-import { join as join10, relative as relative2 } from "path";
+import { join as join11, relative as relative2 } from "path";
 function findSingleBuildZip() {
   const workspace = getWorkspace();
-  const playcademyDir = join10(workspace, CLI_DIRECTORIES.WORKSPACE);
+  const playcademyDir = join11(workspace, CLI_DIRECTORIES.WORKSPACE);
   const zipFiles = findFilesByExtension(playcademyDir, "zip");
   if (zipFiles.length === 1) {
     return zipFiles[0] ? relative2(workspace, zipFiles[0]) : null;
@@ -6918,12 +6960,12 @@ init_constants2();
 import { existsSync as existsSync12 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function getGamesStorePath() {
-  return join11(homedir2(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.GAMES_STORE);
+  return join12(homedir2(), CLI_USER_DIRECTORIES.CONFIG, CLI_FILES.GAMES_STORE);
 }
 async function ensureConfigDir() {
-  const configDir = join11(homedir2(), CLI_USER_DIRECTORIES.CONFIG);
+  const configDir = join12(homedir2(), CLI_USER_DIRECTORIES.CONFIG);
   await mkdir3(configDir, { recursive: true });
 }
 async function loadGameStore() {
@@ -7414,12 +7456,12 @@ async function saveDeploymentState(game, backendDeployment, context2) {
 init_constants2();
 init_core();
 import { existsSync as existsSync14 } from "fs";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 function hasCustomRoutes(config) {
   const workspace = getWorkspace();
   const customRoutesConfig = config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  return existsSync14(join12(workspace, customRoutesDir));
+  return existsSync14(join13(workspace, customRoutesDir));
 }
 function needsBackend(config) {
   return !!config?.integrations || hasCustomRoutes(config);
@@ -7470,13 +7512,13 @@ init_constants2();
 init_core();
 import { existsSync as existsSync15, readFileSync as readFileSync4, unlinkSync as unlinkSync2 } from "fs";
 import { mkdir as mkdir4, unlink, writeFile as writeFile4 } from "fs/promises";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 function getDevServerPidPath() {
-  return join13(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
+  return join14(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
 }
 async function createDevServerPidFile() {
   const pidPath = getDevServerPidFile();
-  const pidDir = join13(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
+  const pidDir = join14(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
   await mkdir4(pidDir, { recursive: true });
   await writeFile4(pidPath, process.pid.toString());
 }
@@ -7516,7 +7558,7 @@ function getDevServerPidFile() {
 // src/lib/dev/reload.ts
 init_constants2();
 init_core();
-import { join as join14, relative as relative3 } from "path";
+import { join as join15, relative as relative3 } from "path";
 import chokidar from "chokidar";
 import { bold as bold4, cyan as cyan3, dim as dim6, green as green3 } from "colorette";
 function formatTime() {
@@ -7533,9 +7575,9 @@ function startHotReload(onReload, options = {}) {
   const customRoutesConfig = options.config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
   const watchPaths = [
-    join14(workspace, customRoutesDir),
-    join14(workspace, "playcademy.config.js"),
-    join14(workspace, "playcademy.config.json")
+    join15(workspace, customRoutesDir),
+    join15(workspace, "playcademy.config.js"),
+    join15(workspace, "playcademy.config.json")
   ];
   const watcher = chokidar.watch(watchPaths, {
     persistent: true,
@@ -7579,7 +7621,7 @@ init_src2();
 init_constants2();
 init_core();
 import { mkdir as mkdir5 } from "fs/promises";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 import { Miniflare } from "miniflare";
 async function startDevServer(options) {
   const {
@@ -7593,7 +7635,7 @@ async function startDevServer(options) {
     sourcemap: false,
     minify: false
   });
-  const dbDir = join15(getWorkspace(), CLI_DIRECTORIES.DATABASE);
+  const dbDir = join16(getWorkspace(), CLI_DIRECTORIES.DATABASE);
   try {
     await mkdir5(dbDir, { recursive: true });
   } catch (error) {
@@ -8637,6 +8679,7 @@ async function runDbDiff() {
     const previousSnapshot = deployedGameInfo?.schemaSnapshot;
     const schemaInfo = await getSchemaInfo(previousSnapshot);
     if (!schemaInfo) {
+      logger.newLine();
       logger.success("No schema changes detected");
       logger.newLine();
       logger.remark("Nothing to do");
@@ -8739,14 +8782,14 @@ init_src2();
 init_src();
 init_constants2();
 import { spawn } from "child_process";
-import { existsSync as existsSync16, rmSync } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync16, rmSync as rmSync2 } from "fs";
+import { join as join17 } from "path";
 import { confirm as confirm6 } from "@inquirer/prompts";
 import { Miniflare as Miniflare2 } from "miniflare";
 async function runDbReset() {
   try {
     const workspace = getWorkspace();
-    const dbDir = join16(workspace, CLI_DIRECTORIES.DATABASE);
+    const dbDir = join17(workspace, CLI_DIRECTORIES.DATABASE);
     if (!existsSync16(dbDir)) {
       logger.warn("No database found to reset");
       logger.newLine();
@@ -8776,7 +8819,7 @@ async function runDbReset() {
     runStep(
       "Deleting database...",
       async () => {
-        rmSync(dbDir, { recursive: true, force: true });
+        rmSync2(dbDir, { recursive: true, force: true });
       },
       "Database deleted"
     );
@@ -8851,7 +8894,7 @@ async function runDbReset() {
 init_package_manager();
 import { execSync as execSync4 } from "child_process";
 import { existsSync as existsSync17 } from "fs";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 async function runDbSeed(options) {
   const workspace = getWorkspace();
   try {
@@ -8860,7 +8903,7 @@ async function runDbSeed(options) {
       logger.newLine();
     }
     if (options.file) {
-      const seedPath = join17(workspace, options.file);
+      const seedPath = join18(workspace, options.file);
       if (!existsSync17(seedPath)) {
         logger.error(`Seed file not found: ${options.file}`);
         logger.newLine();
@@ -9437,7 +9480,7 @@ import { Command as Command26 } from "commander";
 init_src();
 init_constants2();
 import { writeFileSync as writeFileSync8 } from "fs";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 import { Command as Command25 } from "commander";
 var bundleCommand = new Command25("bundle").description("Bundle and inspect the game backend worker code (for debugging)").option("-o, --output <path>", "Output file path", CLI_DEFAULT_OUTPUTS.WORKER_BUNDLE).option("--minify", "Minify the output").option("--sourcemap", "Include source maps").action(async (options) => {
   try {
@@ -9467,7 +9510,7 @@ var bundleCommand = new Command25("bundle").description("Bundle and inspect the
       }),
       (result) => `Bundled ${formatSize(result.code.length)}`
     );
-    const outputPath = join18(workspace, options.output);
+    const outputPath = join19(workspace, options.output);
     writeFileSync8(outputPath, bundle.code, "utf-8");
     logger.success(`Bundle saved to ${options.output}`);
     logger.newLine();
@@ -9612,6 +9655,8 @@ export {
   hashContent,
   hashDirectory,
   hashFile,
+  importTypescriptDefault,
+  importTypescriptFile,
   integrationChangeDetectors,
   isDevServerRunning,
   listProfiles,

package/dist/utils.d.ts

@@ -1,6 +1,7 @@
 import { OrganizationConfig, CourseConfig, ComponentConfig, ResourceConfig, ComponentResourceConfig } from '@playcademy/timeback/types';
 import { Miniflare } from 'miniflare';
 import * as chokidar from 'chokidar';
+import * as esbuild from 'esbuild';
 
 /**
  * @fileoverview Server SDK Type Definitions
@@ -125,4 +126,44 @@ interface HotReloadOptions {
  */
 declare function startHotReload(onReload: () => Promise<void>, options?: HotReloadOptions): chokidar.FSWatcher;
 
-export { findConfigPath as findPlaycademyConfigPath, loadConfig as loadPlaycademyConfig, startDevServer as startPlaycademyDevServer, startHotReload as startPlaycademyHotReload, validateConfig as validatePlaycademyConfig };
+/**
+ * Import utilities for Node-safe TypeScript file loading
+ */
+
+/**
+ * Import a TypeScript file in a Node-safe way
+ *
+ * This utility compiles TypeScript files to ESM using esbuild and imports them dynamically.
+ * This is necessary because Node.js doesn't support importing .ts files directly.
+ *
+ * @param filePath - Absolute path to the TypeScript file to import
+ * @param bundleOptions - Optional esbuild options to customize the build
+ * @returns The imported module
+ *
+ * @example
+ * ```ts
+ * const schema = await importTypescriptFile('/path/to/schema.ts')
+ * const exported = schema.default || schema
+ * ```
+ */
+declare function importTypescriptFile(filePath: string, bundleOptions?: Partial<esbuild.BuildOptions>): Promise<unknown>;
+/**
+ * Import a TypeScript file and extract its default export
+ *
+ * Convenience wrapper around importTypescriptFile that automatically
+ * extracts the default export if available, otherwise returns the module itself.
+ *
+ * @param filePath - Absolute path to the TypeScript file to import
+ * @param bundleOptions - Optional esbuild options to customize the build
+ * @returns The default export or the entire module
+ *
+ * @example
+ * ```ts
+ * const schema = await importTypescriptDefault('/path/to/schema.ts')
+ * // If schema.ts has `export default`, returns that
+ * // Otherwise returns the entire module object
+ * ```
+ */
+declare function importTypescriptDefault(filePath: string, bundleOptions?: Partial<esbuild.BuildOptions>): Promise<unknown>;
+
+export { findConfigPath as findPlaycademyConfigPath, importTypescriptDefault, importTypescriptFile, loadConfig as loadPlaycademyConfig, startDevServer as startPlaycademyDevServer, startHotReload as startPlaycademyHotReload, validateConfig as validatePlaycademyConfig };

package/dist/utils.js

@@ -564,7 +564,7 @@ function processConfigVariables(config) {
 
 // src/lib/dev/server.ts
 import { mkdir as mkdir3 } from "fs/promises";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import { Miniflare } from "miniflare";
 
 // src/lib/core/client.ts
@@ -816,9 +816,44 @@ import { dirname as dirname3, resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
 var currentDir = dirname3(fileURLToPath(import.meta.url));
 
+// src/lib/core/import.ts
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { pathToFileURL } from "url";
+import * as esbuild from "esbuild";
+async function importTypescriptFile(filePath, bundleOptions) {
+  const tempDir = mkdtempSync(join(tmpdir(), "playcademy-import-"));
+  const outFile = join(tempDir, "bundle.mjs");
+  try {
+    await esbuild.build({
+      entryPoints: [filePath],
+      outfile: outFile,
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: false,
+      minify: false,
+      ...bundleOptions
+    });
+    const module = await import(pathToFileURL(outFile).href);
+    return module;
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+async function importTypescriptDefault(filePath, bundleOptions) {
+  const module = await importTypescriptFile(filePath, bundleOptions);
+  if (module && typeof module === "object" && "default" in module) {
+    return module.default;
+  }
+  return module;
+}
+
 // src/lib/deploy/bundle.ts
 import { existsSync as existsSync2 } from "fs";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 
 // ../edge-play/src/entry.ts
 var entry_default = "/**\n * Game Backend Entry Point\n *\n * This file is the main entry point for deployed game backends.\n * It creates a Hono app and registers all enabled integration routes.\n *\n * Bundled with esbuild and deployed to Cloudflare Workers (or AWS Lambda).\n * Config is injected at build time via esbuild's `define` option.\n */\n\nimport { Hono } from 'hono'\nimport { cors } from 'hono/cors'\n\nimport { PlaycademyClient } from '@playcademy/sdk/server'\n\nimport { ENV_VARS } from './constants'\nimport { registerBuiltinRoutes } from './register-routes'\n\nimport type { PlaycademyConfig } from '@playcademy/sdk/server'\nimport type { HonoEnv } from './types'\n\n/**\n * Config injected at build time by esbuild\n *\n * The `declare const` tells TypeScript \"this exists at runtime, trust me.\"\n * During bundling, esbuild's `define` option does literal text replacement:\n *\n * Example bundling:\n *   Source:  if (PLAYCADEMY_CONFIG.integrations.timeback) { ... }\n *   Define:  { 'PLAYCADEMY_CONFIG': JSON.stringify({ integrations: { timeback: {...} } }) }\n *   Output:  if ({\"integrations\":{\"timeback\":{...}}}.integrations.timeback) { ... }\n *\n * This enables tree-shaking: if timeback is not configured, those code paths are removed.\n * The bundled Worker only includes the routes that are actually enabled.\n */\ndeclare const PLAYCADEMY_CONFIG: PlaycademyConfig & {\n    customRoutes?: Array<{ path: string; file: string }>\n}\n\n// XXX: Polyfill process global for SDK compatibility\n// SDK code may reference process.env without importing it\n// @ts-expect-error - Adding global for Worker environment\nglobalThis.process = {\n    env: {}, // Populated per-request from Worker env bindings\n    cwd: () => '/',\n}\n\nconst app = new Hono<HonoEnv>()\n\n// TODO: Harden CORS in production - restrict to trusted origins:\n// - Game's assetBundleBase (for hosted games)\n// - Game's externalUrl (for external games)\n// - Platform frontend domains (hub.playcademy.com, hub.dev.playcademy.net)\n// This would require passing game metadata through env bindings during deployment\napp.use(\n    '*',\n    cors({\n        origin: '*', // Permissive for now\n        allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],\n        allowHeaders: ['Content-Type', 'Authorization'],\n    }),\n)\n\nlet sdkPromise: Promise<PlaycademyClient> | null = null\n\napp.use('*', async (c, next) => {\n    // Populate process.env from Worker bindings for SDK compatibility\n    globalThis.process.env = {\n        [ENV_VARS.PLAYCADEMY_API_KEY]: c.env.PLAYCADEMY_API_KEY,\n        [ENV_VARS.GAME_ID]: c.env.GAME_ID,\n        [ENV_VARS.PLAYCADEMY_BASE_URL]: c.env.PLAYCADEMY_BASE_URL,\n    }\n\n    // Set config for all routes\n    c.set('config', PLAYCADEMY_CONFIG)\n    c.set('customRoutes', PLAYCADEMY_CONFIG.customRoutes || [])\n\n    await next()\n})\n\n// Initialize SDK lazily on first request\napp.use('*', async (c, next) => {\n    if (!sdkPromise) {\n        sdkPromise = PlaycademyClient.init({\n            apiKey: c.env[ENV_VARS.PLAYCADEMY_API_KEY],\n            gameId: c.env[ENV_VARS.GAME_ID],\n            baseUrl: c.env[ENV_VARS.PLAYCADEMY_BASE_URL],\n            config: PLAYCADEMY_CONFIG,\n        })\n    }\n\n    c.set('sdk', await sdkPromise)\n    await next()\n})\n\n/**\n * Register built-in integration routes based on enabled integrations\n *\n * This function conditionally imports and registers routes like:\n * - POST /api/integrations/timeback/end-activity (if timeback enabled)\n * - GET /api/health (always included)\n *\n * Uses dynamic imports for tree-shaking: if an integration is not enabled,\n * its route code is completely removed from the bundle.\n */\nawait registerBuiltinRoutes(app, PLAYCADEMY_CONFIG.integrations)\n\nexport default app\n";
@@ -1041,8 +1076,8 @@ function getMonorepoRoot() {
 function textLoaderPlugin() {
   return {
     name: "text-loader",
-    setup(build) {
-      build.onLoad({ filter: /edge-play\/src\/entry\.ts$/ }, async (args) => {
+    setup(build2) {
+      build2.onLoad({ filter: /edge-play\/src\/entry\.ts$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text = await fs2.readFile(args.path, "utf8");
         return {
@@ -1050,7 +1085,7 @@ function textLoaderPlugin() {
           loader: "js"
         };
       });
-      build.onLoad({ filter: /edge-play\/src\/routes\/root\.html$/ }, async (args) => {
+      build2.onLoad({ filter: /edge-play\/src\/routes\/root\.html$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text = await fs2.readFile(args.path, "utf8");
         return {
@@ -1058,7 +1093,7 @@ function textLoaderPlugin() {
           loader: "js"
         };
       });
-      build.onLoad({ filter: /templates\/sample-route\.ts$/ }, async (args) => {
+      build2.onLoad({ filter: /templates\/sample-route\.ts$/ }, async (args) => {
         const fs2 = await import("fs/promises");
         const text = await fs2.readFile(args.path, "utf8");
         return {
@@ -1073,8 +1108,8 @@ function textLoaderPlugin() {
 // src/lib/dev/routes.ts
 init_file_loader();
 import { mkdir, writeFile } from "fs/promises";
-import { tmpdir } from "os";
-import { join, relative } from "path";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join2, relative } from "path";
 
 // src/lib/deploy/hash.ts
 import { createHash } from "crypto";
@@ -1093,7 +1128,7 @@ async function discoverRoutes(apiDir) {
   const routes = await Promise.all(
     files.map(async (file) => {
       const routePath = filePathToRoutePath(file);
-      const absolutePath = join(apiDir, file);
+      const absolutePath = join2(apiDir, file);
       const relativePath = relative(getWorkspace(), absolutePath);
       const methods = await detectExportedMethods(absolutePath);
       return {
@@ -1138,8 +1173,8 @@ async function transpileRoute(filePath) {
   if (isBun() || !filePath.endsWith(".ts")) {
     return filePath;
   }
-  const esbuild = await import("esbuild");
-  const result = await esbuild.build({
+  const esbuild2 = await import("esbuild");
+  const result = await esbuild2.build({
     entryPoints: [filePath],
     write: false,
     format: "esm",
@@ -1153,10 +1188,10 @@ async function transpileRoute(filePath) {
   if (!result.outputFiles?.[0]) {
     throw new Error("Transpilation failed: no output");
   }
-  const tempDir = join(tmpdir(), "playcademy-dev");
+  const tempDir = join2(tmpdir2(), "playcademy-dev");
   await mkdir(tempDir, { recursive: true });
   const hash = hashContent(filePath).slice(0, 12);
-  const jsPath = join(tempDir, `${hash}.mjs`);
+  const jsPath = join2(tempDir, `${hash}.mjs`);
   await writeFile(jsPath, result.outputFiles[0].text);
   return jsPath;
 }
@@ -1167,7 +1202,7 @@ async function discoverCustomRoutes(config) {
   const workspace = getWorkspace();
   const customRoutesConfig = config.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  const customRoutes = await discoverRoutes(join2(workspace, customRoutesDir));
+  const customRoutes = await discoverRoutes(join3(workspace, customRoutesDir));
   const customRouteData = customRoutes.map((r) => ({
     path: r.path,
     file: r.file,
@@ -1179,15 +1214,15 @@ async function discoverCustomRoutes(config) {
 function resolveEmbeddedSourcePaths() {
   const workspace = getWorkspace();
   const distDir = new URL(".", import.meta.url).pathname;
-  const embeddedEdgeSrc = join2(distDir, "edge-play", "src");
+  const embeddedEdgeSrc = join3(distDir, "edge-play", "src");
   const isBuiltPackage = existsSync2(embeddedEdgeSrc);
   const monorepoRoot = getMonorepoRoot();
-  const monorepoEdgeSrc = join2(monorepoRoot, "packages/edge-play/src");
+  const monorepoEdgeSrc = join3(monorepoRoot, "packages/edge-play/src");
   const edgePlaySrc = isBuiltPackage ? embeddedEdgeSrc : monorepoEdgeSrc;
-  const cliPackageRoot = isBuiltPackage ? join2(distDir, "../../..") : join2(monorepoRoot, "packages/cli");
-  const cliNodeModules = isBuiltPackage ? join2(cliPackageRoot, "node_modules") : monorepoRoot;
-  const workspaceNodeModules = join2(workspace, "node_modules");
-  const constantsEntry = isBuiltPackage ? join2(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join2(monorepoRoot, "packages", "constants", "src", "index.ts");
+  const cliPackageRoot = isBuiltPackage ? join3(distDir, "../../..") : join3(monorepoRoot, "packages/cli");
+  const cliNodeModules = isBuiltPackage ? join3(cliPackageRoot, "node_modules") : monorepoRoot;
+  const workspaceNodeModules = join3(workspace, "node_modules");
+  const constantsEntry = isBuiltPackage ? join3(embeddedEdgeSrc, "..", "..", "constants", "src", "index.ts") : join3(monorepoRoot, "packages", "constants", "src", "index.ts");
   return {
     isBuiltPackage,
     edgePlaySrc,
@@ -1247,16 +1282,16 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
       // │ Example: import * as route from '@game-api/hello.ts'            │
       // │ Resolves to: /user-project/server/api/hello.ts                  │
       // └─────────────────────────────────────────────────────────────────┘
-      "@game-api": join2(workspace, customRoutesDir),
+      "@game-api": join3(workspace, customRoutesDir),
       // ┌─ Node.js polyfills for Cloudflare Workers ──────────────────────┐
       // │ Workers don't have fs, path, os, etc. Redirect to polyfills     │
       // │ that throw helpful errors if user code tries to use them.       │
       // └─────────────────────────────────────────────────────────────────┘
-      fs: join2(edgePlaySrc, "polyfills.js"),
-      "fs/promises": join2(edgePlaySrc, "polyfills.js"),
-      path: join2(edgePlaySrc, "polyfills.js"),
-      os: join2(edgePlaySrc, "polyfills.js"),
-      process: join2(edgePlaySrc, "polyfills.js")
+      fs: join3(edgePlaySrc, "polyfills.js"),
+      "fs/promises": join3(edgePlaySrc, "polyfills.js"),
+      path: join3(edgePlaySrc, "polyfills.js"),
+      os: join3(edgePlaySrc, "polyfills.js"),
+      process: join3(edgePlaySrc, "polyfills.js")
     },
     // ──── Build Plugins ────
     plugins: [textLoaderPlugin()],
@@ -1267,7 +1302,7 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
   };
 }
 async function bundleBackend(config, options = {}) {
-  const esbuild = await import("esbuild");
+  const esbuild2 = await import("esbuild");
   const { customRouteData, customRoutesDir } = await discoverCustomRoutes(config);
   const bundleConfig = {
     ...config,
@@ -1282,7 +1317,7 @@ async function bundleBackend(config, options = {}) {
     customRoutesDir,
     options
   );
-  const result = await esbuild.build(buildConfig);
+  const result = await esbuild2.build(buildConfig);
   if (!result.outputFiles?.[0]) {
     throw new Error("Backend bundling failed: no output");
   }
@@ -1320,13 +1355,13 @@ function generateEntryCode(customRoutes, customRoutesDir) {
 
 // src/lib/dev/pid.ts
 import { mkdir as mkdir2, unlink, writeFile as writeFile2 } from "fs/promises";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 function getDevServerPidPath() {
-  return join3(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
+  return join4(getWorkspace(), CLI_DIRECTORIES.WORKSPACE, CLI_FILES.DEV_SERVER_PID);
 }
 async function createDevServerPidFile() {
   const pidPath = getDevServerPidFile();
-  const pidDir = join3(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
+  const pidDir = join4(getWorkspace(), CLI_DIRECTORIES.WORKSPACE);
   await mkdir2(pidDir, { recursive: true });
   await writeFile2(pidPath, process.pid.toString());
 }
@@ -1347,7 +1382,7 @@ async function startDevServer(options) {
     sourcemap: false,
     minify: false
   });
-  const dbDir = join4(getWorkspace(), CLI_DIRECTORIES.DATABASE);
+  const dbDir = join5(getWorkspace(), CLI_DIRECTORIES.DATABASE);
   try {
     await mkdir3(dbDir, { recursive: true });
   } catch (error) {
@@ -1378,7 +1413,7 @@ async function startDevServer(options) {
 }
 
 // src/lib/dev/reload.ts
-import { join as join5, relative as relative2 } from "path";
+import { join as join6, relative as relative2 } from "path";
 import chokidar from "chokidar";
 import { bold as bold3, cyan as cyan2, dim as dim3, green as green2 } from "colorette";
 function formatTime() {
@@ -1395,9 +1430,9 @@ function startHotReload(onReload, options = {}) {
   const customRoutesConfig = options.config?.integrations?.customRoutes;
   const customRoutesDir = typeof customRoutesConfig === "object" && customRoutesConfig.directory || DEFAULT_API_ROUTES_DIRECTORY;
   const watchPaths = [
-    join5(workspace, customRoutesDir),
-    join5(workspace, "playcademy.config.js"),
-    join5(workspace, "playcademy.config.json")
+    join6(workspace, customRoutesDir),
+    join6(workspace, "playcademy.config.js"),
+    join6(workspace, "playcademy.config.json")
   ];
   const watcher = chokidar.watch(watchPaths, {
     persistent: true,
@@ -1437,6 +1472,8 @@ function startHotReload(onReload, options = {}) {
 }
 export {
   findConfigPath as findPlaycademyConfigPath,
+  importTypescriptDefault,
+  importTypescriptFile,
   loadConfig as loadPlaycademyConfig,
   startDevServer as startPlaycademyDevServer,
   startHotReload as startPlaycademyHotReload,

package/package.json

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