playcademy 0.14.21 → 0.14.23

package/dist/constants.d.ts

@@ -8,14 +8,6 @@ export { GAME_WORKER_DOMAINS, PLAYCADEMY_BASE_URLS, PLAYCADEMY_DOMAINS } from '@
  * Used when integrations.customRoutes.directory is not specified in config
  */
 declare const DEFAULT_API_ROUTES_DIRECTORY: string;
-/**
- * Server root directory (fixed location)
- */
-declare const SERVER_ROOT_DIRECTORY = "server";
-/**
- * Server library/utilities directory (fixed location)
- */
-declare const SERVER_LIB_DIRECTORY: string;
 /**
  * Auth routes subdirectory name within API directory (fixed structure)
  */
@@ -126,6 +118,14 @@ declare const ENV_FILES: readonly [".env", ".env.development", ".env.local"];
  * Safe to commit to version control with placeholder values
  */
 declare const ENV_EXAMPLE_FILE = ".env.example";
+/**
+ * Standard TypeScript config filename
+ */
+declare const TSCONFIG_JSON = "tsconfig.json";
+/**
+ * Vite/modern tooling TypeScript config filename
+ */
+declare const TSCONFIG_APP_JSON = "tsconfig.app.json";
 /**
  * TypeScript config files to check (in priority order)
  *
@@ -134,6 +134,13 @@ declare const ENV_EXAMPLE_FILE = ".env.example";
  * 2. tsconfig.json      ← Standard TypeScript config - fallback
  */
 declare const TSCONFIG_FILES: readonly ["tsconfig.app.json", "tsconfig.json"];
+/**
+ * Entries that should be in the tsconfig include array for Playcademy projects
+ *
+ * - playcademy-env.d.ts: Type definitions generated by the CLI
+ * - server: Server-side TypeScript code directory
+ */
+declare const TSCONFIG_REQUIRED_INCLUDES: readonly ["playcademy-env.d.ts", "server"];
 
 /**
  * Database-related constants
@@ -282,9 +289,28 @@ declare const DEFAULT_PORTS: {
     readonly BACKEND: 8788;
 };
 
+/**
+ * Server directory structure constants
+ *
+ * Centralized path constants for server-related directories.
+ * Uses path.join() for cross-platform compatibility.
+ */
+/**
+ * Server root directory (fixed location)
+ */
+declare const SERVER_ROOT_DIRECTORY = "server";
+/**
+ * Server library/utilities directory (fixed location)
+ */
+declare const SERVER_LIB_DIRECTORY: string;
+/**
+ * Public assets directory (fixed location)
+ */
+declare const PUBLIC_DIRECTORY = "public";
+
 /**
  * Config file names to search for
  */
 declare const CONFIG_FILE_NAMES: string[];
 
-export { AUTH_API_SUBDIRECTORY, AUTH_CONFIG_FILE, AUTH_PROVIDER_NAMES, BETTER_AUTH_VERSION, BUCKET_ALWAYS_SKIP, CALLBACK_PATH, CALLBACK_PORT, CLI_DEFAULT_OUTPUTS, CLI_DIRECTORIES, CLI_FILES, CLI_USER_DIRECTORIES, CLOUDFLARE_BINDINGS, CLOUDFLARE_COMPATIBILITY_DATE, CONFIG_FILE_NAMES, DB_FILES, DEFAULT_API_ROUTES_DIRECTORY, DEFAULT_DATABASE_DIRECTORY, DEFAULT_PORTS, DRIZZLE_CONFIG_FILES, ENV_EXAMPLE_FILE, ENV_FILES, GODOT_BUILD_DIRECTORIES, GODOT_BUILD_OUTPUTS, GODOT_EXECUTABLE_PATTERNS, GODOT_EXPORT_PRESETS_FILE, GODOT_PROJECT_FILE, GODOT_WEB_PLATFORM, MINIFLARE_D1_DIRECTORY, OAUTH_CALLBACK_URL_PATTERN, PLACEHOLDER_GAME_URL, PLAYCADEMY_AUTH_VERSION, SAMPLE_API_SUBDIRECTORY, SAMPLE_BUCKET_FILENAME, SAMPLE_CUSTOM_FILENAME, SAMPLE_DATABASE_FILENAME, SAMPLE_KV_FILENAME, SCHEMA_SUBDIRECTORY, SERVER_LIB_DIRECTORY, SERVER_ROOT_DIRECTORY, SSO_AUTH_TIMEOUT_MS, TSCONFIG_FILES, WORKSPACE_NAME };
+export { AUTH_API_SUBDIRECTORY, AUTH_CONFIG_FILE, AUTH_PROVIDER_NAMES, BETTER_AUTH_VERSION, BUCKET_ALWAYS_SKIP, CALLBACK_PATH, CALLBACK_PORT, CLI_DEFAULT_OUTPUTS, CLI_DIRECTORIES, CLI_FILES, CLI_USER_DIRECTORIES, CLOUDFLARE_BINDINGS, CLOUDFLARE_COMPATIBILITY_DATE, CONFIG_FILE_NAMES, DB_FILES, DEFAULT_API_ROUTES_DIRECTORY, DEFAULT_DATABASE_DIRECTORY, DEFAULT_PORTS, DRIZZLE_CONFIG_FILES, ENV_EXAMPLE_FILE, ENV_FILES, GODOT_BUILD_DIRECTORIES, GODOT_BUILD_OUTPUTS, GODOT_EXECUTABLE_PATTERNS, GODOT_EXPORT_PRESETS_FILE, GODOT_PROJECT_FILE, GODOT_WEB_PLATFORM, MINIFLARE_D1_DIRECTORY, OAUTH_CALLBACK_URL_PATTERN, PLACEHOLDER_GAME_URL, PLAYCADEMY_AUTH_VERSION, PUBLIC_DIRECTORY, SAMPLE_API_SUBDIRECTORY, SAMPLE_BUCKET_FILENAME, SAMPLE_CUSTOM_FILENAME, SAMPLE_DATABASE_FILENAME, SAMPLE_KV_FILENAME, SCHEMA_SUBDIRECTORY, SERVER_LIB_DIRECTORY, SERVER_ROOT_DIRECTORY, SSO_AUTH_TIMEOUT_MS, TSCONFIG_APP_JSON, TSCONFIG_FILES, TSCONFIG_JSON, TSCONFIG_REQUIRED_INCLUDES, WORKSPACE_NAME };

package/dist/constants.js

@@ -1,8 +1,14 @@
 // src/constants/api.ts
+import { join as join2 } from "node:path";
+
+// src/constants/server.ts
 import { join } from "node:path";
-var DEFAULT_API_ROUTES_DIRECTORY = join("server", "api");
 var SERVER_ROOT_DIRECTORY = "server";
-var SERVER_LIB_DIRECTORY = join("server", "lib");
+var SERVER_LIB_DIRECTORY = join(SERVER_ROOT_DIRECTORY, "lib");
+var PUBLIC_DIRECTORY = "public";
+
+// src/constants/api.ts
+var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 var AUTH_API_SUBDIRECTORY = "auth";
 var SAMPLE_API_SUBDIRECTORY = "sample";
 var SAMPLE_CUSTOM_FILENAME = "custom.ts";
@@ -143,12 +149,20 @@ var ENV_FILES = [
   // Overrides all (highest priority)
 ];
 var ENV_EXAMPLE_FILE = ".env.example";
+var TSCONFIG_JSON = "tsconfig.json";
+var TSCONFIG_APP_JSON = "tsconfig.app.json";
 var TSCONFIG_FILES = [
-  "tsconfig.app.json",
+  TSCONFIG_APP_JSON,
   // Modern tooling (try first)
-  "tsconfig.json"
+  TSCONFIG_JSON
   // Standard (fallback)
 ];
+var TSCONFIG_REQUIRED_INCLUDES = [
+  "playcademy-env.d.ts",
+  // Generated type definitions
+  "server"
+  // Server-side code
+];
 
 // src/constants/bucket.ts
 var BUCKET_ALWAYS_SKIP = [".git", ".DS_Store", ".gitignore", ...ENV_FILES];
@@ -166,8 +180,8 @@ var CLOUDFLARE_BINDINGS = {
 var MINIFLARE_D1_DIRECTORY = "miniflare-D1DatabaseObject";
 
 // src/constants/database.ts
-import { join as join2 } from "path";
-var DEFAULT_DATABASE_DIRECTORY = join2("server", "db");
+import { join as join3 } from "path";
+var DEFAULT_DATABASE_DIRECTORY = join3("server", "db");
 var SCHEMA_SUBDIRECTORY = "schema";
 var DB_FILES = {
   /** Index file name */
@@ -184,7 +198,7 @@ var DB_FILES = {
 var DRIZZLE_CONFIG_FILES = ["drizzle.config.ts", "drizzle.config.js"];
 
 // src/constants/godot.ts
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 var GODOT_PROJECT_FILE = "project.godot";
 var GODOT_EXPORT_PRESETS_FILE = "export_presets.cfg";
 var GODOT_WEB_PLATFORM = 'platform="Web"';
@@ -192,13 +206,13 @@ var GODOT_BUILD_DIRECTORIES = {
   /** Root build directory (cleared before each export) */
   ROOT: "build",
   /** Web export subdirectory */
-  WEB: join3("build", "web")
+  WEB: join4("build", "web")
 };
 var GODOT_BUILD_OUTPUTS = {
   /** Exported web build entry point */
-  INDEX_HTML: join3("build", "web", "index.html"),
+  INDEX_HTML: join4("build", "web", "index.html"),
   /** Packaged zip file (created by Godot export) */
-  ZIP: join3("build", "web_playcademy.zip")
+  ZIP: join4("build", "web_playcademy.zip")
 };
 var GODOT_EXECUTABLE_PATTERNS = {
   /** macOS app bundle suffix */
@@ -221,17 +235,17 @@ var CALLBACK_PATH = "/callback";
 var SSO_AUTH_TIMEOUT_MS = 3e4;
 
 // src/constants/paths.ts
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 var WORKSPACE_NAME = ".playcademy";
 var CLI_DIRECTORIES = {
   /** Root directory for CLI artifacts in workspace */
   WORKSPACE: WORKSPACE_NAME,
   /** Database directory within workspace */
-  DATABASE: join4(WORKSPACE_NAME, "db"),
+  DATABASE: join5(WORKSPACE_NAME, "db"),
   /** KV storage directory within workspace */
-  KV: join4(WORKSPACE_NAME, "kv"),
+  KV: join5(WORKSPACE_NAME, "kv"),
   /** Bucket storage directory within workspace */
-  BUCKET: join4(WORKSPACE_NAME, "bucket")
+  BUCKET: join5(WORKSPACE_NAME, "bucket")
 };
 var CLI_USER_DIRECTORIES = {
   /** User config directory for auth, games store, etc. */
@@ -239,7 +253,7 @@ var CLI_USER_DIRECTORIES = {
 };
 var CLI_DEFAULT_OUTPUTS = {
   /** Default worker bundle output for debug command */
-  WORKER_BUNDLE: join4(WORKSPACE_NAME, "worker-bundle.js")
+  WORKER_BUNDLE: join5(WORKSPACE_NAME, "worker-bundle.js")
 };
 var CLI_FILES = {
   /** Auth store file in user config directory */
@@ -348,6 +362,7 @@ export {
   PLAYCADEMY_AUTH_VERSION,
   PLAYCADEMY_BASE_URLS,
   PLAYCADEMY_DOMAINS,
+  PUBLIC_DIRECTORY,
   SAMPLE_API_SUBDIRECTORY,
   SAMPLE_BUCKET_FILENAME,
   SAMPLE_CUSTOM_FILENAME,
@@ -357,6 +372,9 @@ export {
   SERVER_LIB_DIRECTORY,
   SERVER_ROOT_DIRECTORY,
   SSO_AUTH_TIMEOUT_MS,
+  TSCONFIG_APP_JSON,
   TSCONFIG_FILES,
+  TSCONFIG_JSON,
+  TSCONFIG_REQUIRED_INCLUDES,
   WORKSPACE_NAME
 };

package/dist/db.js

@@ -1430,12 +1430,18 @@ var init_file_loader = __esm({
 
 // src/lib/db/path.ts
 import { copyFileSync, existsSync, mkdirSync, readdirSync, unlinkSync } from "fs";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 
 // src/constants/api.ts
+import { join as join2 } from "node:path";
+
+// src/constants/server.ts
 import { join } from "node:path";
-var DEFAULT_API_ROUTES_DIRECTORY = join("server", "api");
-var SERVER_LIB_DIRECTORY = join("server", "lib");
+var SERVER_ROOT_DIRECTORY = "server";
+var SERVER_LIB_DIRECTORY = join(SERVER_ROOT_DIRECTORY, "lib");
+
+// src/constants/api.ts
+var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 
 // ../../package.json
 var package_default = {
@@ -1576,40 +1582,40 @@ var CLOUDFLARE_BINDINGS = {
 var MINIFLARE_D1_DIRECTORY = "miniflare-D1DatabaseObject";
 
 // src/constants/database.ts
-import { join as join2 } from "path";
-var DEFAULT_DATABASE_DIRECTORY = join2("server", "db");
+import { join as join3 } from "path";
+var DEFAULT_DATABASE_DIRECTORY = join3("server", "db");
 
 // src/constants/godot.ts
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 var GODOT_BUILD_DIRECTORIES = {
   /** Root build directory (cleared before each export) */
   ROOT: "build",
   /** Web export subdirectory */
-  WEB: join3("build", "web")
+  WEB: join4("build", "web")
 };
 var GODOT_BUILD_OUTPUTS = {
   /** Exported web build entry point */
-  INDEX_HTML: join3("build", "web", "index.html"),
+  INDEX_HTML: join4("build", "web", "index.html"),
   /** Packaged zip file (created by Godot export) */
-  ZIP: join3("build", "web_playcademy.zip")
+  ZIP: join4("build", "web_playcademy.zip")
 };
 
 // src/constants/paths.ts
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 var WORKSPACE_NAME = ".playcademy";
 var CLI_DIRECTORIES = {
   /** Root directory for CLI artifacts in workspace */
   WORKSPACE: WORKSPACE_NAME,
   /** Database directory within workspace */
-  DATABASE: join4(WORKSPACE_NAME, "db"),
+  DATABASE: join5(WORKSPACE_NAME, "db"),
   /** KV storage directory within workspace */
-  KV: join4(WORKSPACE_NAME, "kv"),
+  KV: join5(WORKSPACE_NAME, "kv"),
   /** Bucket storage directory within workspace */
-  BUCKET: join4(WORKSPACE_NAME, "bucket")
+  BUCKET: join5(WORKSPACE_NAME, "bucket")
 };
 var CLI_DEFAULT_OUTPUTS = {
   /** Default worker bundle output for debug command */
-  WORKER_BUNDLE: join4(WORKSPACE_NAME, "worker-bundle.js")
+  WORKER_BUNDLE: join5(WORKSPACE_NAME, "worker-bundle.js")
 };
 var CLI_FILES = {
   /** Auth store file in user config directory */
@@ -1660,11 +1666,11 @@ var ensureDirectoryExists = (dir) => {
   }
 };
 var findMiniflareDatabase = (dbDir) => {
-  const miniflareDir = join5(dbDir, MINIFLARE_D1_DIRECTORY);
+  const miniflareDir = join6(dbDir, MINIFLARE_D1_DIRECTORY);
   if (!existsSync(miniflareDir)) return null;
   const sqliteFiles = readdirSync(miniflareDir).filter((file) => file.endsWith(".sqlite"));
   if (sqliteFiles.length === 0) return null;
-  return join5(miniflareDir, sqliteFiles[0]);
+  return join6(miniflareDir, sqliteFiles[0]);
 };
 var migrateInitialDbToTarget = (initialPath, targetPath) => {
   if (!existsSync(initialPath)) return;
@@ -1672,7 +1678,7 @@ var migrateInitialDbToTarget = (initialPath, targetPath) => {
   unlinkSync(initialPath);
 };
 function getDevDbPath() {
-  const initialDbPath = join5(DB_DIRECTORY, INITIAL_DB_NAME);
+  const initialDbPath = join6(DB_DIRECTORY, INITIAL_DB_NAME);
   ensureDirectoryExists(DB_DIRECTORY);
   const miniflareDbPath = findMiniflareDatabase(DB_DIRECTORY);
   if (miniflareDbPath) {
@@ -1736,7 +1742,7 @@ async function bundleSeedWorker(seedFilePath, projectPath) {
 // src/lib/db/reset.ts
 import { execSync as execSync2 } from "child_process";
 import { rmSync as rmSync2 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 
 // ../utils/src/ansi.ts
 var colors = {
@@ -1965,7 +1971,7 @@ init_package_json();
 // ../utils/src/package-manager.ts
 import { execSync } from "child_process";
 import { existsSync as existsSync2 } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 function isCommandAvailable(command) {
   try {
     execSync(`command -v ${command}`, { stdio: "ignore" });
@@ -1975,16 +1981,16 @@ function isCommandAvailable(command) {
   }
 }
 function detectPackageManager(cwd = process.cwd()) {
-  if (existsSync2(join6(cwd, "bun.lock")) || existsSync2(join6(cwd, "bun.lockb"))) {
+  if (existsSync2(join7(cwd, "bun.lock")) || existsSync2(join7(cwd, "bun.lockb"))) {
     return "bun";
   }
-  if (existsSync2(join6(cwd, "pnpm-lock.yaml"))) {
+  if (existsSync2(join7(cwd, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
-  if (existsSync2(join6(cwd, "yarn.lock"))) {
+  if (existsSync2(join7(cwd, "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync2(join6(cwd, "package-lock.json"))) {
+  if (existsSync2(join7(cwd, "package-lock.json"))) {
     return "npm";
   }
   return detectByCommandAvailability();
@@ -2960,12 +2966,12 @@ var currentDir = dirname(fileURLToPath(import.meta.url));
 // src/lib/core/import.ts
 import { mkdtempSync, rmSync } from "fs";
 import { tmpdir } from "os";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 import { pathToFileURL } from "url";
 import * as esbuild from "esbuild";
 async function importTypescriptFile(filePath, bundleOptions) {
-  const tempDir = mkdtempSync(join7(tmpdir(), "playcademy-import-"));
-  const outFile = join7(tempDir, "bundle.mjs");
+  const tempDir = mkdtempSync(join8(tmpdir(), "playcademy-import-"));
+  const outFile = join8(tempDir, "bundle.mjs");
   try {
     await esbuild.build({
       entryPoints: [filePath],
@@ -2988,7 +2994,7 @@ async function importTypescriptFile(filePath, bundleOptions) {
 // src/lib/db/reset.ts
 async function resetDatabase(workspace, mf, options = { debug: false }) {
   const { debug } = options;
-  const dbDir = join8(workspace, CLI_DIRECTORIES.DATABASE);
+  const dbDir = join9(workspace, CLI_DIRECTORIES.DATABASE);
   await runStep(
     "Resetting database...",
     async () => {