playcademy 0.17.2 → 0.17.4-alpha.1

package/dist/bin.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+import { green, red } from "colorette";
+
+// src/constants/paths.ts
+import { homedir } from "node:os";
+import { join } from "node:path";
+var WORKSPACE_NAME = ".playcademy";
+var CLI_DIRECTORIES = {
+  WORKSPACE: WORKSPACE_NAME,
+  DATABASE: join(WORKSPACE_NAME, "db"),
+  KV: join(WORKSPACE_NAME, "kv"),
+  BUCKET: join(WORKSPACE_NAME, "bucket")
+};
+var PLAYCADEMY_HOME = join(homedir(), ".playcademy");
+var CLI_USER_DIRECTORIES = {
+  CONFIG: PLAYCADEMY_HOME,
+  BIN: join(PLAYCADEMY_HOME, "bin"),
+  CACHE: join(PLAYCADEMY_HOME, "cache")
+};
+var CLI_DEFAULT_OUTPUTS = {
+  WORKER_BUNDLE: join(WORKSPACE_NAME, "worker-bundle.js")
+};
+
+// src/bin.ts
+var exe = process.platform === "win32" ? "playcademy.exe" : "playcademy";
+var locations = [join2(CLI_USER_DIRECTORIES.BIN, exe), join2(homedir2(), ".local", "bin", exe)];
+var binary = locations.find((p) => existsSync(p));
+if (binary) {
+  const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+  }
+  process.exit(result.status ?? 1);
+}
+var args = process.argv.slice(2);
+var command = args.length ? `playcademy ${args.join(" ")}` : "playcademy";
+var g = red("\u2502");
+console.error(
+  [
+    "",
+    g,
+    `${g}  The playcademy npm package doesn't include the CLI.`,
+    g,
+    `${g}  Install it separately:`,
+    g,
+    `${g}    ${green("curl -fsSL https://playcademy.net/cli | bash")}`,
+    g,
+    `${g}  Then re-run your command:`,
+    g,
+    `${g}    ${green(command)}`,
+    g,
+    ""
+  ].join("\n")
+);
+process.exit(127);

package/dist/cli.js

@@ -17,8 +17,8 @@ function getPackageVersionFromData(pkg, fallback = "0.0.0") {
 }
 function getPackageNameVersionFromData(pkg) {
   const name = getPackageNameFromData(pkg);
-  const version2 = getPackageVersionFromData(pkg);
-  return `${name}@${version2}`;
+  const version = getPackageVersionFromData(pkg);
+  return `${name}@${version}`;
 }
 function hasDependencyInData(pkg, packageName) {
   if (!pkg) {
@@ -56,15 +56,15 @@ import { readFile } from "fs/promises";
 import { dirname, parse, resolve } from "path";
 function findFilePath(filename, startDir, maxLevels = 3) {
   const filenames = Array.isArray(filename) ? filename : [filename];
-  let currentDir2 = resolve(startDir);
+  let currentDir = resolve(startDir);
   let levelsSearched = 0;
   while (levelsSearched <= maxLevels) {
     for (const fname of filenames) {
-      const filePath = resolve(currentDir2, fname);
+      const filePath = resolve(currentDir, fname);
       if (existsSync(filePath)) {
         return {
           path: filePath,
-          dir: currentDir2,
+          dir: currentDir,
           filename: fname
         };
       }
@@ -72,15 +72,15 @@ function findFilePath(filename, startDir, maxLevels = 3) {
     if (levelsSearched >= maxLevels) {
       break;
     }
-    const parentDir = dirname(currentDir2);
-    if (parentDir === currentDir2) {
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
       break;
     }
-    const parsed = parse(currentDir2);
-    if (parsed.root === currentDir2) {
+    const parsed = parse(currentDir);
+    if (parsed.root === currentDir) {
       break;
     }
-    currentDir2 = parentDir;
+    currentDir = parentDir;
     levelsSearched++;
   }
   return null;
@@ -248,11 +248,11 @@ function scanDirectory(dir, options = {}) {
     }
     throw new Error(`Directory not found: ${dir}`);
   }
-  function scan(currentDir2, basePath = "") {
+  function scan(currentDir, basePath = "") {
     try {
-      const entries = readdirSync(currentDir2);
+      const entries = readdirSync(currentDir);
       for (const entry of entries) {
-        const fullPath = resolve(currentDir2, entry);
+        const fullPath = resolve(currentDir, entry);
         const relativePath = basePath ? `${basePath}/${entry}` : entry;
         const stat = statSync(fullPath);
         if (stat.isDirectory()) {
@@ -674,7 +674,7 @@ function setupGlobalErrorHandlers() {
 // src/lib/init/run.ts
 import { execSync as execSync5 } from "child_process";
 import { writeFileSync as writeFileSync10 } from "fs";
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 import { confirm as confirm5 } from "@inquirer/prompts";
 
 // ../utils/src/ansi.ts
@@ -1189,20 +1189,22 @@ var GODOT_BUILD_OUTPUTS = {
 };
 
 // src/constants/paths.ts
-import { join as join6 } from "path";
+import { homedir } from "node:os";
+import { join as join6 } from "node:path";
 var WORKSPACE_NAME = ".playcademy";
 var CLI_DIRECTORIES = {
-  /** Root directory for CLI artifacts in workspace */
   WORKSPACE: WORKSPACE_NAME,
-  /** Database directory within workspace */
   DATABASE: join6(WORKSPACE_NAME, "db"),
-  /** KV storage directory within workspace */
   KV: join6(WORKSPACE_NAME, "kv"),
-  /** Bucket storage directory within workspace */
   BUCKET: join6(WORKSPACE_NAME, "bucket")
 };
+var PLAYCADEMY_HOME = join6(homedir(), ".playcademy");
+var CLI_USER_DIRECTORIES = {
+  CONFIG: PLAYCADEMY_HOME,
+  BIN: join6(PLAYCADEMY_HOME, "bin"),
+  CACHE: join6(PLAYCADEMY_HOME, "cache")
+};
 var CLI_DEFAULT_OUTPUTS = {
-  /** Default worker bundle output for debug command */
   WORKER_BUNDLE: join6(WORKSPACE_NAME, "worker-bundle.js")
 };
 
@@ -1693,7 +1695,7 @@ var ConfigError = class extends Error {
     return msg;
   }
 };
-async function findConfigPath(configPath) {
+async function findConfigPath(configPath, options) {
   const { findFile: findFile2 } = await Promise.resolve().then(() => (init_file_loader(), file_loader_exports));
   if (configPath) {
     const fullPath = resolve3(configPath);
@@ -1720,7 +1722,11 @@ async function findConfigPath(configPath) {
     }
     return result2.path;
   }
-  const result = await findFile2(CONFIG_FILE_NAMES, { searchUp: true, maxLevels: 3 });
+  const result = await findFile2(CONFIG_FILE_NAMES, {
+    searchUp: true,
+    maxLevels: 3,
+    cwd: options?.searchFrom ?? process.cwd()
+  });
   if (!result) {
     throw new ConfigError(
       "No Playcademy config file found in this directory or any parent directory",
@@ -1737,13 +1743,13 @@ async function loadConfigFile(path2) {
   const module = await import(`${path2}?t=${Date.now()}`);
   return module.default || module;
 }
-async function loadConfig(configPath) {
-  const result = await loadConfigWithPath(configPath);
+async function loadConfig(configPath, options) {
+  const result = await loadConfigWithPath(configPath, options);
   return result.config;
 }
-async function loadConfigWithPath(configPath) {
+async function loadConfigWithPath(configPath, options) {
   try {
-    const actualPath = configPath ? resolve3(configPath) : await findConfigPath();
+    const actualPath = configPath ? resolve3(configPath) : await findConfigPath(void 0, options);
     const config = await loadConfigFile(actualPath);
     if (!config || typeof config !== "object") {
       throw new ConfigError(
@@ -2149,16 +2155,26 @@ var init_constants = __esm2(() => {
 init_constants();
 
 // src/lib/templates/loader.ts
-import { existsSync as existsSync5, readFileSync } from "fs";
-import { dirname as dirname3, resolve as resolve4 } from "path";
-import { fileURLToPath } from "url";
-var currentDir = dirname3(fileURLToPath(import.meta.url));
+import { existsSync as existsSync5, readFileSync } from "node:fs";
+import { dirname as dirname3, resolve as resolve4 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/lib/templates/bundle.ts
+var TEMPLATE_BUNDLE = null;
+
+// src/lib/templates/loader.ts
 function loadTemplateString(filename) {
+  if (TEMPLATE_BUNDLE) {
+    const content = TEMPLATE_BUNDLE[filename] ?? TEMPLATE_BUNDLE[`${filename}.template`];
+    if (content != null) return content;
+    throw new Error(
+      `Template not found in bundle: ${filename}. Available: ${Object.keys(TEMPLATE_BUNDLE).join(", ")}`
+    );
+  }
+  const currentDir = dirname3(fileURLToPath(import.meta.url));
   const filenamesToTry = filename.endsWith(".template") ? [filename] : [filename, `${filename}.template`];
   const candidatePaths = filenamesToTry.flatMap((name) => [
-    // Dev (TS sources): ../../templates from src/lib/templates
     resolve4(currentDir, "../../templates", name),
-    // Bundled build (single-file output): templates relative to dist root
     resolve4(currentDir, "templates", name)
   ]);
   for (const candidate of candidatePaths) {
@@ -2993,99 +3009,11 @@ async function setupPackageJson(workspace) {
 }
 
 // src/lib/init/database.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
-import { join as join13 } from "path";
-
-// package.json with { type: 'json' }
-var package_default2 = {
-  name: "playcademy",
-  version: "0.17.1",
-  type: "module",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.js"
-    },
-    "./cli": {
-      types: "./dist/cli.d.ts",
-      import: "./dist/cli.js",
-      require: "./dist/cli.js"
-    },
-    "./db": {
-      types: "./dist/db.d.ts",
-      import: "./dist/db.js",
-      require: "./dist/db.js"
-    },
-    "./utils": {
-      types: "./dist/utils.d.ts",
-      import: "./dist/utils.js"
-    },
-    "./constants": {
-      types: "./dist/constants.d.ts",
-      import: "./dist/constants.js"
-    },
-    "./types": {
-      types: "./dist/index.d.ts"
-    },
-    "./version": {
-      types: "./dist/version.d.ts",
-      import: "./dist/version.js"
-    }
-  },
-  main: "./dist/index.js",
-  module: "./dist/index.js",
-  bin: {
-    playcademy: "./dist/index.js"
-  },
-  files: [
-    "dist"
-  ],
-  scripts: {
-    build: "bun build.ts",
-    dev: "PLAYCADEMY_BASE_URL=http://localhost:5174 bun src/index.ts",
-    pub: "bun publish.ts"
-  },
-  dependencies: {
-    "@inquirer/prompts": "^7.8.6",
-    "@playcademy/sdk": "workspace:*",
-    chokidar: "^4.0.3",
-    colorette: "^2.0.20",
-    commander: "^14.0.1",
-    dedent: "^1.6.0",
-    "drizzle-kit": "^0.31.5",
-    "drizzle-orm": "^0.44.6",
-    esbuild: "^0.25.10",
-    giget: "^2.0.0",
-    hono: "^4.9.9",
-    "json-colorizer": "^3.0.1",
-    jszip: "^3.10.1",
-    miniflare: "^4.20251008.0",
-    open: "^10.2.0",
-    ws: "^8.18.3"
-  },
-  devDependencies: {
-    "@cloudflare/workers-types": "^4.20251011.0",
-    "@inquirer/core": "^10.3.0",
-    "@playcademy/constants": "workspace:*",
-    "@playcademy/data": "workspace:*",
-    "@playcademy/edge-play": "workspace:*",
-    "@playcademy/timeback": "workspace:*",
-    "@playcademy/types": "workspace:*",
-    "@playcademy/utils": "workspace:*",
-    "@types/bun": "latest",
-    "@types/ws": "^8.18.1",
-    bumpp: "^10.2.3",
-    rollup: "^4.50.2",
-    "rollup-plugin-dts": "^6.2.3"
-  },
-  peerDependencies: {
-    typescript: "^5"
-  }
-};
+import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join13 } from "node:path";
 
 // src/version.ts
-var version = package_default2.version;
+var cliVersion = false ? "0.0.0-dev" : "0.17.4-alpha.1";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -3133,8 +3061,9 @@ async function setupPackageJson2(workspace, appName) {
     "drizzle-orm": "^0.42.0",
     "better-sqlite3": "^12.0.0"
   };
+  const playcademyDevDepRange = cliVersion === "0.0.0-dev" ? "latest" : `^${cliVersion}`;
   const dbDevDeps = {
-    playcademy: `^${version}`,
+    playcademy: playcademyDevDepRange,
     "drizzle-kit": "^0.30.0",
     "@types/better-sqlite3": "^7.6.0",
     tsx: "^4.20.6"
@@ -3163,7 +3092,7 @@ async function setupPackageJson2(workspace, appName) {
     return true;
   } else {
     const slugifiedName = generateSlug(appName);
-    const packageContent = packageTemplate.replace("{{APP_NAME}}", slugifiedName).replace("{{PLAYCADEMY_VERSION}}", version);
+    const packageContent = packageTemplate.replace("{{APP_NAME}}", slugifiedName).replace("^{{PLAYCADEMY_VERSION}}", playcademyDevDepRange);
     writeFileSync6(pkgPath, packageContent);
     logger.success("Created package.json");
     return true;
@@ -3476,11 +3405,10 @@ async function selectConfigFormat(hasPackageJson2) {
 }
 
 // src/lib/init/types.ts
-init_file_loader();
-import { execSync as execSync4 } from "child_process";
-import { existsSync as existsSync15, writeFileSync as writeFileSync9 } from "fs";
-import { dirname as dirname5, join as join17 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { execSync as execSync4 } from "node:child_process";
+import { existsSync as existsSync15, readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "node:fs";
+import { dirname as dirname5, join as join17, resolve as resolve7 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/lib/deploy/backend.ts
 import { existsSync as existsSync13 } from "node:fs";
@@ -3638,13 +3566,31 @@ function detectBackendFeatures(workspace, config) {
 function hasAnyBackend(features) {
   return Object.values(features).some(Boolean);
 }
+function getDepVersions() {
+  if (true) {
+    return { honoVersion: "^4.9.9", workersTypesVersion: "^4.20251011.0" };
+  }
+  try {
+    const pkgPath = resolve7(
+      dirname5(fileURLToPath2(import.meta.url)),
+      "..",
+      "..",
+      "..",
+      "package.json"
+    );
+    const pkg = JSON.parse(readFileSync9(pkgPath, "utf8"));
+    return {
+      honoVersion: pkg.dependencies?.hono ?? "latest",
+      workersTypesVersion: pkg.devDependencies?.["@cloudflare/workers-types"] ?? "latest"
+    };
+  } catch {
+    return { honoVersion: "latest", workersTypesVersion: "latest" };
+  }
+}
 async function setupPlaycademyDependencies(workspace) {
   const playcademyDir = join17(workspace, CLI_DIRECTORIES.WORKSPACE);
   const playcademyPkgPath = join17(playcademyDir, "package.json");
-  const __dirname = dirname5(fileURLToPath2(import.meta.url));
-  const cliPkg = await loadPackageJson({ cwd: __dirname, searchUp: true, required: true });
-  const workersTypesVersion = cliPkg?.devDependencies?.["@cloudflare/workers-types"] || "latest";
-  const honoVersion = cliPkg?.dependencies?.hono || "latest";
+  const { honoVersion, workersTypesVersion } = getDepVersions();
   const playcademyPkg = {
     private: true,
     dependencies: { hono: honoVersion },
@@ -3918,7 +3864,7 @@ async function runInit(options = {}) {
       timebackCourses: timebackConfig ?? void 0
     };
     const configContent = configFormat === "js" ? generateJsConfig(configOptions) : generateJsonConfig(configOptions);
-    const configPath = resolve7(getWorkspace(), configFileName);
+    const configPath = resolve8(getWorkspace(), configFileName);
     writeFileSync10(configPath, configContent, "utf8");
     await formatConfigWithPrettier(configPath);
     if (database || auth || kv || bucket) {

package/dist/constants.d.ts

@@ -274,42 +274,25 @@ declare const SSO_AUTH_TIMEOUT_MS = 30000;
  * Path constants for CLI directories and files
  */
 declare const WORKSPACE_NAME = ".playcademy";
-/**
- * CLI workspace directories (local to project)
- */
 declare const CLI_DIRECTORIES: {
-    /** Root directory for CLI artifacts in workspace */
     readonly WORKSPACE: ".playcademy";
-    /** Database directory within workspace */
     readonly DATABASE: string;
-    /** KV storage directory within workspace */
     readonly KV: string;
-    /** Bucket storage directory within workspace */
     readonly BUCKET: string;
 };
-/**
- * CLI user directories (in home directory)
- */
 declare const CLI_USER_DIRECTORIES: {
-    /** User config directory for auth, games store, etc. */
-    readonly CONFIG: ".playcademy";
+    readonly CONFIG: string;
+    readonly BIN: string;
+    readonly CACHE: string;
 };
-/**
- * Default output paths
- */
+declare function nativeBinaryPath(name: string): string;
+declare function cacheVersionDir(version: string): string;
 declare const CLI_DEFAULT_OUTPUTS: {
-    /** Default worker bundle output for debug command */
     readonly WORKER_BUNDLE: string;
 };
-/**
- * CLI file names
- */
 declare const CLI_FILES: {
-    /** Auth store file in user config directory */
     readonly AUTH_STORE: "auth.json";
-    /** Games deployment info store */
     readonly GAMES_STORE: "games.json";
-    /** Initial database file (before miniflare) */
     readonly INITIAL_DATABASE: "initial.sqlite";
 };
 
@@ -357,4 +340,4 @@ declare const CONFIG_FILE_NAMES: string[];
  */
 declare const DOCS_URL = "https://docs.dev.playcademy.net/platform";
 
-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, DEFAULT_TEMPLATE_REF, DOCS_URL, DRIZZLE_CONFIG_FILES, ENV_EXAMPLE_FILE, ENV_FILES, GODOT_ADDON_URL, 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_APP_URL, PLAYCADEMY_AUTH_VERSION, PUBLIC_DIRECTORY, QUEUE_NAME_PREFIX, SAMPLE_API_SUBDIRECTORY, SAMPLE_BUCKET_FILENAME, SAMPLE_CUSTOM_FILENAME, SAMPLE_DATABASE_FILENAME, SAMPLE_KV_FILENAME, SCHEMA_SUBDIRECTORY, SELF_WORKER_NAME_BINDING, SERVER_LIB_DIRECTORY, SERVER_ROOT_DIRECTORY, SSO_AUTH_TIMEOUT_MS, TEMPLATE_RENAME_FILES, TEMPLATE_REPOS, TSCONFIG_APP_JSON, TSCONFIG_FILES, TSCONFIG_JSON, TSCONFIG_REQUIRED_INCLUDES, 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, DEFAULT_TEMPLATE_REF, DOCS_URL, DRIZZLE_CONFIG_FILES, ENV_EXAMPLE_FILE, ENV_FILES, GODOT_ADDON_URL, 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_APP_URL, PLAYCADEMY_AUTH_VERSION, PUBLIC_DIRECTORY, QUEUE_NAME_PREFIX, SAMPLE_API_SUBDIRECTORY, SAMPLE_BUCKET_FILENAME, SAMPLE_CUSTOM_FILENAME, SAMPLE_DATABASE_FILENAME, SAMPLE_KV_FILENAME, SCHEMA_SUBDIRECTORY, SELF_WORKER_NAME_BINDING, SERVER_LIB_DIRECTORY, SERVER_ROOT_DIRECTORY, SSO_AUTH_TIMEOUT_MS, TEMPLATE_RENAME_FILES, TEMPLATE_REPOS, TSCONFIG_APP_JSON, TSCONFIG_FILES, TSCONFIG_JSON, TSCONFIG_REQUIRED_INCLUDES, WORKSPACE_NAME, cacheVersionDir, nativeBinaryPath };

package/dist/constants.js

@@ -183,32 +183,34 @@ var CALLBACK_PATH = "/callback";
 var SSO_AUTH_TIMEOUT_MS = 3e4;
 
 // src/constants/paths.ts
-import { join as join5 } from "path";
+import { homedir } from "node:os";
+import { join as join5 } from "node:path";
 var WORKSPACE_NAME = ".playcademy";
 var CLI_DIRECTORIES = {
-  /** Root directory for CLI artifacts in workspace */
   WORKSPACE: WORKSPACE_NAME,
-  /** Database directory within workspace */
   DATABASE: join5(WORKSPACE_NAME, "db"),
-  /** KV storage directory within workspace */
   KV: join5(WORKSPACE_NAME, "kv"),
-  /** Bucket storage directory within workspace */
   BUCKET: join5(WORKSPACE_NAME, "bucket")
 };
+var PLAYCADEMY_HOME = join5(homedir(), ".playcademy");
 var CLI_USER_DIRECTORIES = {
-  /** User config directory for auth, games store, etc. */
-  CONFIG: ".playcademy"
+  CONFIG: PLAYCADEMY_HOME,
+  BIN: join5(PLAYCADEMY_HOME, "bin"),
+  CACHE: join5(PLAYCADEMY_HOME, "cache")
 };
+function nativeBinaryPath(name) {
+  const ext = process.platform === "win32" ? ".exe" : "";
+  return join5(CLI_USER_DIRECTORIES.BIN, `${name}${ext}`);
+}
+function cacheVersionDir(version) {
+  return join5(CLI_USER_DIRECTORIES.CACHE, `v${version}`);
+}
 var CLI_DEFAULT_OUTPUTS = {
-  /** Default worker bundle output for debug command */
   WORKER_BUNDLE: join5(WORKSPACE_NAME, "worker-bundle.js")
 };
 var CLI_FILES = {
-  /** Auth store file in user config directory */
   AUTH_STORE: "auth.json",
-  /** Games deployment info store */
   GAMES_STORE: "games.json",
-  /** Initial database file (before miniflare) */
   INITIAL_DATABASE: "initial.sqlite"
 };
 
@@ -439,5 +441,7 @@ export {
   TSCONFIG_FILES,
   TSCONFIG_JSON,
   TSCONFIG_REQUIRED_INCLUDES,
-  WORKSPACE_NAME
+  WORKSPACE_NAME,
+  cacheVersionDir,
+  nativeBinaryPath
 };

package/dist/db.js

@@ -124,28 +124,27 @@ var GODOT_BUILD_OUTPUTS = {
 };
 
 // src/constants/paths.ts
-import { join as join5 } from "path";
+import { homedir } from "node:os";
+import { join as join5 } from "node:path";
 var WORKSPACE_NAME = ".playcademy";
 var CLI_DIRECTORIES = {
-  /** Root directory for CLI artifacts in workspace */
   WORKSPACE: WORKSPACE_NAME,
-  /** Database directory within workspace */
   DATABASE: join5(WORKSPACE_NAME, "db"),
-  /** KV storage directory within workspace */
   KV: join5(WORKSPACE_NAME, "kv"),
-  /** Bucket storage directory within workspace */
   BUCKET: join5(WORKSPACE_NAME, "bucket")
 };
+var PLAYCADEMY_HOME = join5(homedir(), ".playcademy");
+var CLI_USER_DIRECTORIES = {
+  CONFIG: PLAYCADEMY_HOME,
+  BIN: join5(PLAYCADEMY_HOME, "bin"),
+  CACHE: join5(PLAYCADEMY_HOME, "cache")
+};
 var CLI_DEFAULT_OUTPUTS = {
-  /** Default worker bundle output for debug command */
   WORKER_BUNDLE: join5(WORKSPACE_NAME, "worker-bundle.js")
 };
 var CLI_FILES = {
-  /** Auth store file in user config directory */
   AUTH_STORE: "auth.json",
-  /** Games deployment info store */
   GAMES_STORE: "games.json",
-  /** Initial database file (before miniflare) */
   INITIAL_DATABASE: "initial.sqlite"
 };
 
@@ -1262,11 +1261,6 @@ init_file_loader();
 // src/lib/config/loader.ts
 init_file_loader();
 
-// src/lib/templates/loader.ts
-import { dirname, resolve } from "path";
-import { fileURLToPath } from "url";
-var currentDir = dirname(fileURLToPath(import.meta.url));
-
 // src/lib/core/import.ts
 import { mkdtempSync, rmSync } from "fs";
 import { tmpdir } from "os";

package/dist/index.d.ts

@@ -1191,10 +1191,10 @@ interface BundleOptions {
 }
 /**
  * Resolved paths for bundling embedded sources
- * Used to support both monorepo development and published package scenarios
+ * Used to support monorepo development and the published `playcademy` npm package (dist/).
  */
 interface EmbeddedSourcePaths {
-    /** Whether we're running from a published package (vs monorepo dev) */
+    /** True when running from installed npm package (dist/ has embedded sources), not monorepo dev */
     isBuiltPackage: boolean;
     /** Path to edge-play sources (embedded or monorepo) */
     edgePlaySrc: string;
@@ -1202,7 +1202,7 @@ interface EmbeddedSourcePaths {
     constantsEntry: string;
     /** User's workspace node_modules */
     workspaceNodeModules: string;
-    /** CLI's node_modules (monorepo root in dev, same as workspace in published) */
+    /** Resolution roots: monorepo root in dev; playcademy package or .playcademy deps when published/binary */
     cliNodeModules: string;
 }