playcademy 0.27.0 → 0.27.1-beta.10

package/dist/bucket.d.ts

@@ -109,6 +109,34 @@ interface IntegrationsConfig {
     /** Queues (optional) */
     queues?: Record<string, QueueConfig | boolean>;
 }
+/**
+ * Developer dashboard configuration.
+ *
+ * The dashboard is a separate app in the game's repo, deployed as a sibling
+ * worker with `playcademy dashboard deploy`. Auth and session plumbing are
+ * platform-managed; the dashboard app itself is just a static SPA build.
+ */
+interface DashboardConfig {
+    /** Path to the dashboard app, relative to the config file (default: './dashboard') */
+    directory?: string;
+    /** Build command run inside the dashboard directory (defaults to the workspace package manager's build script) */
+    buildCommand?: string[];
+    /** Path to the dashboard build output, relative to the dashboard directory (default: 'dist') */
+    buildPath?: string;
+    /** Colors for the platform-managed login/invite page (hex); unset uses the built-in palette */
+    theme?: DashboardThemeConfig;
+}
+/**
+ * Login-page theming. Two seeds — a primary (button, focus, background
+ * wash) and a secondary accent — the platform derives the full palette
+ * from. Either may be omitted to keep that half of the built-in palette.
+ */
+interface DashboardThemeConfig {
+    /** Primary color as a hex string, e.g. '#e0245e' */
+    primary?: string;
+    /** Secondary/accent color as a hex string, e.g. '#ffd166' */
+    secondary?: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -130,6 +158,8 @@ interface PlaycademyConfig {
     externalUrl?: string;
     /** Game platform */
     platform?: 'web' | 'godot';
+    /** Developer dashboard app (optional) — `true` uses defaults */
+    dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
 }

package/dist/bucket.js

@@ -22,62 +22,12 @@ var init_file_loader = __esm({
 import { existsSync } from "fs";
 import { join as join8 } from "path";
 
-// ../constants/src/timeback.ts
-var TIMEBACK_ROUTES = {
-  END_ACTIVITY: "/integrations/timeback/end-activity",
-  GET_XP: "/integrations/timeback/xp",
-  GET_MASTERY: "/integrations/timeback/mastery",
-  GET_HIGHEST_GRADE_MASTERED: "/integrations/timeback/highest-grade-mastered",
-  HEARTBEAT: "/integrations/timeback/heartbeat",
-  ADVANCE_COURSE: "/integrations/timeback/advance-course",
-  UNENROLL_COURSE: "/integrations/timeback/unenroll-course"
-};
-var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
-  xp: 1,
-  mastery: 0,
-  score: 2
-};
-var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
-  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
-  mastery: 0,
-  time: 60,
-  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
-};
-
-// ../constants/src/cloudflare.ts
-var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
-
-// ../edge-play/src/constants.ts
+// ../edge-play/src/lib/constants.ts
 var ASSET_PREFIX = "_assets/";
 var MANIFEST_KEY = "_manifest.json";
 var ASSET_ROUTE_PREFIX = "/api/assets/";
-var ROUTES = {
-  /** Route index (lists available routes) */
-  INDEX: "/api",
-  /** Health check endpoint */
-  HEALTH: "/api/health",
-  /**
-   * Built-in content-addressable asset serving.
-   *
-   * Serves files from the game's BUCKET (R2) binding under their
-   * content-hashed keys, with immutable caching. Registered in the
-   * terminal tier so a game's own `server/api/assets/[...path].ts`
-   * route supersedes it.
-   */
-  ASSETS: `${ASSET_ROUTE_PREFIX}*`,
-  /** TimeBack integration routes */
-  TIMEBACK: {
-    END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
-    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
-    GET_MASTERY: `/api${TIMEBACK_ROUTES.GET_MASTERY}`,
-    GET_HIGHEST_GRADE_MASTERED: `/api${TIMEBACK_ROUTES.GET_HIGHEST_GRADE_MASTERED}`,
-    HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`,
-    ADVANCE_COURSE: `/api${TIMEBACK_ROUTES.ADVANCE_COURSE}`,
-    UNENROLL_COURSE: `/api${TIMEBACK_ROUTES.UNENROLL_COURSE}`
-  }
-};
 
-// src/lib/bundle/backend.ts
+// src/lib/bundle/game-backend.ts
 import { join as join6 } from "node:path";
 
 // src/constants/api.ts
@@ -85,11 +35,11 @@ import { join as join2 } from "node:path";
 
 // src/constants/server.ts
 import { join } from "node:path";
-var SERVER_ROOT_DIRECTORY = "server";
-var SERVER_LIB_DIRECTORY = join(SERVER_ROOT_DIRECTORY, "lib");
+var GAME_SERVER_ROOT_DIRECTORY = "server";
+var GAME_SERVER_LIB_DIRECTORY = join(GAME_SERVER_ROOT_DIRECTORY, "lib");
 
 // src/constants/api.ts
-var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
+var GAME_API_ROUTES_DIRECTORY = join2(GAME_SERVER_ROOT_DIRECTORY, "api");
 
 // ../better-auth/package.json
 var package_default = {
@@ -200,6 +150,22 @@ var CLI_DEFAULT_OUTPUTS = {
   WORKER_BUNDLE: join5(WORKSPACE_NAME, "worker-bundle.js")
 };
 
+// ../constants/src/timeback.ts
+var TIMEBACK_GAME_METRIC_DECIMAL_PLACES = {
+  xp: 1,
+  mastery: 0,
+  score: 2
+};
+var TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE = {
+  xp: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.xp,
+  mastery: 0,
+  time: 60,
+  score: 0.5 / 10 ** TIMEBACK_GAME_METRIC_DECIMAL_PLACES.score
+};
+
+// ../constants/src/cloudflare.ts
+var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
+
 // src/lib/core/client.ts
 import { PlaycademyClient } from "@playcademy/sdk/internal";
 
@@ -309,6 +275,17 @@ var TIMEBACK_DISCREPANCY_QUEUE_WINDOWS = [
   "custom"
 ];
 var TIMEBACK_DISCREPANCY_QUEUE_METRICS = ["xp", "mastery", "time", "score"];
+var PLAYCADEMY_SUPPORTED_QTI_INTERACTION_TYPES = [
+  "choice",
+  "inline-choice",
+  "text-entry",
+  "order",
+  "match",
+  "hottext"
+];
+var PLAYCADEMY_SUPPORTED_QTI_INTERACTION_TYPE_SET = new Set(
+  PLAYCADEMY_SUPPORTED_QTI_INTERACTION_TYPES
+);
 var TIMEBACK_DISCREPANCY_QUEUE_WINDOW_VALUES = new Set(TIMEBACK_DISCREPANCY_QUEUE_WINDOWS);
 var TIMEBACK_DISCREPANCY_QUEUE_METRIC_VALUES = new Set(TIMEBACK_DISCREPANCY_QUEUE_METRICS);
 
@@ -327,11 +304,13 @@ import {
 // src/lib/core/transpile.ts
 import * as esbuild2 from "esbuild";
 
-// src/lib/bundle/backend.ts
-function getCustomRoutesDirectory(projectPath, config) {
+// src/lib/bundle/game-backend.ts
+function resolveGameRoutesDir(config) {
   const customRoutes = config?.integrations?.customRoutes;
-  const customRoutesDir = typeof customRoutes === "object" && customRoutes.directory || DEFAULT_API_ROUTES_DIRECTORY;
-  return join6(projectPath, customRoutesDir);
+  return typeof customRoutes === "object" && customRoutes.directory || GAME_API_ROUTES_DIRECTORY;
+}
+function getGameRoutesDirectory(projectPath, config) {
+  return join6(projectPath, resolveGameRoutesDir(config));
 }
 
 // src/lib/bucket/local.ts
@@ -354,7 +333,7 @@ async function openLocalBucket() {
 // src/lib/bucket/dev.ts
 var ASSET_DEV_ROUTE_PREFIX = ASSET_ROUTE_PREFIX;
 function hasCustomAssetsRoute(projectRoot, config) {
-  const routesDir = getCustomRoutesDirectory(projectRoot, config);
+  const routesDir = getGameRoutesDirectory(projectRoot, config);
   return existsSync(join8(routesDir, "assets")) || existsSync(join8(routesDir, "assets.ts"));
 }
 function openLocalAssetBucket() {