playcademy 0.19.0 → 0.19.1-beta.10

package/dist/cli.js

@@ -1065,7 +1065,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.5",
+  version: "0.0.6-beta.10",
   type: "module",
   exports: {
     "./server": {
@@ -3016,7 +3016,7 @@ import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as re
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.19.0";
+var cliVersion = false ? "0.0.0-dev" : "0.19.1-beta.10";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");

package/dist/constants.d.ts

@@ -67,19 +67,12 @@ declare const BUCKET_ALWAYS_SKIP: readonly [".git", ".DS_Store", ".gitignore", "
 
 /**
  * Cloudflare-related constants
- */
-/**
- * Cloudflare Workers compatibility date
- * Must stay on or after 2024-09-23 so nodejs_compat uses the modern v2 path.
- */
-declare const CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
-/**
- * Compatibility flags enabled for Playcademy backend workers.
  *
- * Keep local dev and deployed backends aligned so libraries like Better Auth
- * and Sentry see the same Worker runtime capabilities.
+ * Worker runtime pins (`CLOUDFLARE_COMPATIBILITY_DATE`,
+ * `BACKEND_COMPATIBILITY_FLAGS`) live in `@playcademy/constants` so every
+ * package that deploys or emulates workers (CLI, cloudflare, sdk, api-core)
+ * agrees on a single source of truth. Import them from there directly.
  */
-declare const BACKEND_COMPATIBILITY_FLAGS: readonly ["nodejs_compat"];
 /**
  * Cloudflare binding names for local development (Miniflare)
  */
@@ -351,4 +344,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, BACKEND_COMPATIBILITY_FLAGS, 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, HOOKS_FILE, 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 };
+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, 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, HOOKS_FILE, 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

@@ -20,7 +20,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.5",
+  version: "0.0.6-beta.10",
   type: "module",
   exports: {
     "./server": {
@@ -101,8 +101,6 @@ var TSCONFIG_REQUIRED_INCLUDES = [
 var BUCKET_ALWAYS_SKIP = [".git", ".DS_Store", ".gitignore", ...ENV_FILES];
 
 // src/constants/cloudflare.ts
-var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
-var BACKEND_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 var CLOUDFLARE_BINDINGS = {
   /** R2 bucket binding name */
   BUCKET: "BUCKET",
@@ -390,7 +388,6 @@ export {
   AUTH_API_SUBDIRECTORY,
   AUTH_CONFIG_FILE,
   AUTH_PROVIDER_NAMES,
-  BACKEND_COMPATIBILITY_FLAGS,
   BETTER_AUTH_VERSION,
   BUCKET_ALWAYS_SKIP,
   CALLBACK_PATH,
@@ -400,7 +397,6 @@ export {
   CLI_FILES,
   CLI_USER_DIRECTORIES,
   CLOUDFLARE_BINDINGS,
-  CLOUDFLARE_COMPATIBILITY_DATE,
   CONFIG_FILE_NAMES,
   DB_FILES,
   DEFAULT_API_ROUTES_DIRECTORY,

package/dist/db.js

@@ -36,7 +36,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.5",
+  version: "0.0.6-beta.10",
   type: "module",
   exports: {
     "./server": {

package/dist/index.d.ts

@@ -615,6 +615,8 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
+    /** Cloudflare Worker compatibility date (YYYY-MM-DD) */
+    compatibilityDate?: string;
     /** Optional Cloudflare Worker compatibility flags */
     compatibilityFlags?: string[];
 }
@@ -1061,6 +1063,7 @@ interface DeploymentContext {
     minify: boolean;
     verbose: boolean;
     debug: boolean;
+    compatibilityDate?: string;
 }
 /**
  * Analysis of what changed in an update
@@ -1193,6 +1196,8 @@ interface BundleOptions {
     sourcemap?: boolean;
     /** Minify output (default: false) */
     minify?: boolean;
+    /** Override the Worker compatibility date used for compat-aware bundling */
+    compatibilityDate?: string;
 }
 /**
  * Metadata describing the sealed backend runtime artifact.

package/dist/index.js

@@ -326,7 +326,7 @@ var SAMPLE_BUCKET_FILENAME = "bucket.ts";
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.5",
+  version: "0.0.6-beta.10",
   type: "module",
   exports: {
     "./server": {
@@ -400,8 +400,6 @@ var TSCONFIG_REQUIRED_INCLUDES = [
 var BUCKET_ALWAYS_SKIP = [".git", ".DS_Store", ".gitignore", ...ENV_FILES];
 
 // src/constants/cloudflare.ts
-var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
-var BACKEND_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 var CLOUDFLARE_BINDINGS = {
   /** R2 bucket binding name */
   BUCKET: "BUCKET",
@@ -674,7 +672,8 @@ var BADGES = {
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
-  GET_XP: "/integrations/timeback/xp"
+  GET_XP: "/integrations/timeback/xp",
+  HEARTBEAT: "/integrations/timeback/heartbeat"
 };
 var TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY";
 var TIMEBACK_ORG_NAME = "Playcademy Studios";
@@ -724,6 +723,8 @@ var WORKER_NAMING = {
   STAGING_SUFFIX: "-staging"
 };
 var SECRETS_PREFIX = "secrets_";
+var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
+var BACKEND_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 
 // src/constants/urls.ts
 var DOCS_URL = "https://docs.dev.playcademy.net/platform";
@@ -4017,7 +4018,7 @@ import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as rea
 import { join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.19.0";
+var cliVersion = false ? "0.0.0-dev" : "0.19.1-beta.10";
 
 // src/lib/init/database.ts
 var drizzleConfigTemplate = loadTemplateString("database/drizzle-config.ts");
@@ -6401,7 +6402,8 @@ var ROUTES = {
   /** TimeBack integration routes */
   TIMEBACK: {
     END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
-    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`
+    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+    HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`
   }
 };
 
@@ -9515,7 +9517,10 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
       // └─────────────────────────────────────────────────────────────────────┘
       "@game-server": join32(workspace, "server")
     },
-    plugins: [createBackendNodeCompatPlugin(), createForbiddenRuntimeImportsPlugin(workspace)],
+    plugins: [
+      createBackendNodeCompatPlugin({ compatibilityDate: options.compatibilityDate }),
+      createForbiddenRuntimeImportsPlugin(workspace)
+    ],
     external: []
     // Native workerd builtins are externalized via the compat plugin
   };
@@ -10964,7 +10969,7 @@ import {
 // ../data/src/domains/user/table.ts
 import { relations } from "drizzle-orm";
 import { boolean, pgEnum, pgTable, text, timestamp, uniqueIndex } from "drizzle-orm/pg-core";
-var userRoleEnum = pgEnum("user_role", ["admin", "player", "developer"]);
+var userRoleEnum = pgEnum("user_role", ["admin", "player", "developer", "teacher"]);
 var developerStatusEnum = pgEnum("developer_status", ["none", "pending", "approved"]);
 var users = pgTable("user", {
   id: text("id").primaryKey().$defaultFn(() => crypto.randomUUID()),
@@ -11504,6 +11509,7 @@ async function prepareDeploymentContext(options) {
     minify: options.minify ?? true,
     verbose: options.verbose ?? false,
     debug: options.debug ?? false,
+    compatibilityDate: options.compatibilityDate,
     localSecrets,
     remoteSecretKeys
   };
@@ -11529,7 +11535,10 @@ async function detectIntegrationMetadataChanges(context2) {
 async function bundleAndHash(context2) {
   try {
     await ensurePlaycademyTypes();
-    const bundle = await bundleBackend(context2.fullConfig, { minify: context2.minify });
+    const bundle = await bundleBackend(context2.fullConfig, {
+      minify: context2.minify,
+      compatibilityDate: context2.compatibilityDate
+    });
     const bundleHash = hashContent(bundle.code);
     const [serverSize, dbSize] = await Promise.all([
       getDirectorySize(join37(context2.projectPath, SERVER_ROOT_DIRECTORY)),
@@ -11644,6 +11653,7 @@ async function calculateDeploymentPlan(context2, changes) {
     deployBackend,
     forceBackend
   } = context2;
+  const compatibilityDateOverride = Boolean(context2.compatibilityDate) && deployBackend;
   if (!gameAlreadyDeployed) {
     const needsBackend3 = hasLocalCustomRoutes(projectPath, context2.fullConfig) || Boolean(context2.fullConfig?.integrations);
     const shouldDeployBackend2 = deployBackend && needsBackend3;
@@ -11660,7 +11670,7 @@ async function calculateDeploymentPlan(context2, changes) {
   const configHasChanges = changes.config;
   const secretsHaveChanges = changes.secrets !== void 0;
   const noChanges = !buildHasChanges && !backendHasChanges && !configHasChanges && !secretsHaveChanges;
-  if (noChanges && !forceBackend) {
+  if (noChanges && !forceBackend && !compatibilityDateOverride) {
     return {
       action: "no-changes",
       gameType: config.gameType ?? "hosted",
@@ -11673,7 +11683,7 @@ async function calculateDeploymentPlan(context2, changes) {
   const shouldUpdateGame = buildHasChanges || configHasChanges;
   const shouldUploadBuild = buildHasChanges;
   const needsBackend2 = hasLocalCustomRoutes(projectPath, context2.fullConfig) || Boolean(context2.fullConfig?.integrations);
-  const shouldDeployBackend = deployBackend && (backendHasChanges || forceBackend || shouldUploadBuild && needsBackend2);
+  const shouldDeployBackend = deployBackend && (backendHasChanges || forceBackend || compatibilityDateOverride || shouldUploadBuild && needsBackend2);
   return {
     action: "update-existing",
     gameType: config.gameType ?? "hosted",
@@ -11854,7 +11864,10 @@ async function deployGame(context2, shouldUploadBuild, shouldDeployBackend) {
     await ensurePlaycademyTypes();
     const bundle = await runStep(
       "Bundling backend",
-      async () => context2.currentBackendBundle ?? bundleBackend(fullConfig, { minify: context2.minify }),
+      async () => context2.currentBackendBundle ?? bundleBackend(fullConfig, {
+        minify: context2.minify,
+        compatibilityDate: context2.compatibilityDate
+      }),
       "Backend bundled"
     );
     const deploymentPrep = await runStep(
@@ -11898,6 +11911,7 @@ async function deployGame(context2, shouldUploadBuild, shouldDeployBackend) {
       ...bundle,
       bindings: Object.keys(deploymentPrep.bindings).length > 0 ? deploymentPrep.bindings : void 0,
       schema: deploymentPrep.schemaInfo || void 0,
+      compatibilityDate: context2.compatibilityDate ?? CLOUDFLARE_COMPATIBILITY_DATE,
       compatibilityFlags: [...BACKEND_COMPATIBILITY_FLAGS]
     };
     const [serverSize, dbSize] = await Promise.all([
@@ -11927,7 +11941,8 @@ async function deployGame(context2, shouldUploadBuild, shouldDeployBackend) {
     );
     backendBundle = {
       code: stubCode,
-      config: fullConfig || { name: "stub" }
+      config: fullConfig || { name: "stub" },
+      ...context2.compatibilityDate ? { compatibilityDate: context2.compatibilityDate } : {}
     };
   }
   let game;

package/dist/runtime/backend-runtime/index.js

@@ -213,7 +213,8 @@ var init_timeback = __esm({
     "use strict";
     TIMEBACK_ROUTES = {
       END_ACTIVITY: "/integrations/timeback/end-activity",
-      GET_XP: "/integrations/timeback/xp"
+      GET_XP: "/integrations/timeback/xp",
+      HEARTBEAT: "/integrations/timeback/heartbeat"
     };
   }
 });
@@ -257,7 +258,8 @@ var init_constants = __esm({
       /** TimeBack integration routes */
       TIMEBACK: {
         END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
-        GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`
+        GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+        HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`
       }
     };
   }
@@ -311,7 +313,11 @@ function getBuiltinRoutes() {
 }
 function getTimebackRoutes(config) {
   if (config?.integrations?.timeback) {
-    return [{ path: ROUTES.TIMEBACK.END_ACTIVITY, methods: ["POST"] }];
+    return [
+      { path: ROUTES.TIMEBACK.END_ACTIVITY, methods: ["POST"] },
+      { path: ROUTES.TIMEBACK.GET_XP, methods: ["GET"] },
+      { path: ROUTES.TIMEBACK.HEARTBEAT, methods: ["POST"] }
+    ];
   }
   return [];
 }
@@ -344,9 +350,9 @@ var init_routes = __esm({
 // ../edge-play/src/entry/metadata.ts
 function getRuntimeMetadata() {
   return {
-    cliVersion: true ? "0.19.0" : "0.0.0-dev",
-    sdkVersion: true ? "0.4.0" : "0.0.0-dev",
-    buildId: true ? "4086a66aa2f8" : "dev-source"
+    cliVersion: true ? "0.19.1-beta.10" : "0.0.0-dev",
+    sdkVersion: true ? "0.5.0-beta.1" : "0.0.0-dev",
+    buildId: true ? "68aee00c09c6" : "dev-source"
   };
 }
 var init_metadata = __esm({
@@ -546,11 +552,7 @@ var init_lib = __esm({
   }
 });
 
-// ../edge-play/src/routes/integrations/timeback/end-activity.ts
-var end_activity_exports = {};
-__export(end_activity_exports, {
-  POST: () => POST
-});
+// ../edge-play/src/routes/integrations/timeback/shared.ts
 function getConfig(c) {
   const config = c.get("config");
   const timebackConfig = config?.integrations?.timeback;
@@ -574,6 +576,17 @@ function enrichActivityData(params) {
 function isActivityDataInput(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+var init_shared = __esm({
+  "../edge-play/src/routes/integrations/timeback/shared.ts"() {
+    "use strict";
+  }
+});
+
+// ../edge-play/src/routes/integrations/timeback/end-activity.ts
+var end_activity_exports = {};
+__export(end_activity_exports, {
+  POST: () => POST
+});
 async function POST(c) {
   try {
     const user = c.get("playcademyUser");
@@ -585,7 +598,17 @@ async function POST(c) {
       console.error("[TimeBack End Activity] Error:", message);
       return c.json(buildErrorResponse(c, message, message), 400);
     }
-    const { activityData, scoreData, timingData, xpEarned, masteredUnits, extensions } = await c.req.json();
+    const {
+      runId,
+      resumeId,
+      activityData,
+      scoreData,
+      timingData,
+      sessionTimingData,
+      xpEarned,
+      masteredUnits,
+      extensions
+    } = await c.req.json();
     const config = getConfig(c);
     const structuredActivityData = isActivityDataInput(activityData) ? activityData : void 0;
     if (structuredActivityData && isValidGrade2(structuredActivityData.grade) && isValidSubject2(structuredActivityData.subject)) {
@@ -612,9 +635,12 @@ async function POST(c) {
       {
         gameId: sdk.gameId,
         studentId: user.timeback_id,
+        runId,
+        resumeId,
         activityData: enrichResult.data,
         scoreData,
         timingData,
+        sessionTimingData,
         xpEarned,
         masteredUnits,
         extensions
@@ -630,6 +656,7 @@ var init_end_activity = __esm({
   "../edge-play/src/routes/integrations/timeback/end-activity.ts"() {
     "use strict";
     init_lib();
+    init_shared();
   }
 });
 
@@ -707,6 +734,86 @@ var init_get_xp = __esm({
   }
 });
 
+// ../edge-play/src/routes/integrations/timeback/heartbeat.ts
+var heartbeat_exports = {};
+__export(heartbeat_exports, {
+  POST: () => POST2
+});
+async function POST2(c) {
+  try {
+    const user = c.get("playcademyUser");
+    if (!user) {
+      return c.json(buildErrorResponse(c, "Unauthorized", "Unauthorized"), 401);
+    }
+    if (!user.timeback_id) {
+      const message = "User does not have TimeBack integration";
+      console.error("[TimeBack Heartbeat] Error:", message);
+      return c.json(buildErrorResponse(c, message, message), 400);
+    }
+    const {
+      activityData,
+      timingData,
+      windowStartedAtMs,
+      windowSequence,
+      isFinal,
+      runId,
+      resumeId
+    } = await c.req.json();
+    const hasWindowStartedAtMs = windowStartedAtMs !== void 0;
+    const hasWindowSequence = windowSequence !== void 0;
+    if (hasWindowStartedAtMs === hasWindowSequence) {
+      const message = "Provide exactly one of windowStartedAtMs or windowSequence";
+      console.error("[TimeBack Heartbeat] Error:", message);
+      return c.json(buildErrorResponse(c, message, message), 400);
+    }
+    const config = getConfig(c);
+    const structuredActivityData = isActivityDataInput(activityData) ? activityData : void 0;
+    if (structuredActivityData && isValidGrade2(structuredActivityData.grade) && isValidSubject2(structuredActivityData.subject)) {
+      const courseValidationError = validateCourseConfig({
+        grade: structuredActivityData.grade,
+        subject: structuredActivityData.subject,
+        config
+      });
+      if (courseValidationError) {
+        const message = courseValidationError.error;
+        console.error("[TimeBack Heartbeat] Error:", message);
+        return c.json(buildErrorResponse(c, message, message), 400);
+      }
+    }
+    const enrichResult = structuredActivityData ? enrichActivityData({ activityData: structuredActivityData, config, c }) : { data: activityData };
+    if ("error" in enrichResult) {
+      console.error("[TimeBack Heartbeat] Error:", enrichResult.error);
+      return c.json(buildErrorResponse(c, enrichResult.error, enrichResult.error), 500);
+    }
+    const sdk = c.get("sdk");
+    const result = await sdk.request("/api/timeback/heartbeat", "POST", {
+      gameId: sdk.gameId,
+      studentId: user.timeback_id,
+      runId,
+      resumeId,
+      activityData: enrichResult.data,
+      timingData,
+      ...hasWindowStartedAtMs ? { windowStartedAtMs } : {},
+      ...hasWindowSequence ? { windowSequence } : {},
+      isFinal
+    });
+    return c.json(result);
+  } catch (error) {
+    logError("TimeBack Heartbeat", error);
+    return c.json(
+      buildErrorResponse(c, error, "Failed to record heartbeat"),
+      getErrorStatus(error)
+    );
+  }
+}
+var init_heartbeat = __esm({
+  "../edge-play/src/routes/integrations/timeback/heartbeat.ts"() {
+    "use strict";
+    init_lib();
+    init_shared();
+  }
+});
+
 // ../../node_modules/.bun/hono@4.10.7/node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
   return (context, next) => {
@@ -3036,12 +3143,14 @@ async function registerBuiltinRoutes(app, integrations) {
   const health = await Promise.resolve().then(() => (init_health(), health_exports));
   app.get(ROUTES.HEALTH, health.GET);
   if (integrations?.timeback) {
-    const [endActivity, getXp] = await Promise.all([
+    const [endActivity, getXp, heartbeat] = await Promise.all([
       Promise.resolve().then(() => (init_end_activity(), end_activity_exports)),
-      Promise.resolve().then(() => (init_get_xp(), get_xp_exports))
+      Promise.resolve().then(() => (init_get_xp(), get_xp_exports)),
+      Promise.resolve().then(() => (init_heartbeat(), heartbeat_exports))
     ]);
     app.post(ROUTES.TIMEBACK.END_ACTIVITY, endActivity.POST);
     app.get(ROUTES.TIMEBACK.GET_XP, getXp.GET);
+    app.post(ROUTES.TIMEBACK.HEARTBEAT, heartbeat.POST);
   } else if (integrations?.timeback === null) {
     app.post(
       "/api/integrations/timeback/end-activity",
@@ -3058,6 +3167,13 @@ async function registerBuiltinRoutes(app, integrations) {
         __playcademyDevWarning: "timeback-not-configured"
       })
     );
+    app.post(
+      "/api/integrations/timeback/heartbeat",
+      async (c) => c.json({
+        status: "ok",
+        __playcademyDevWarning: "timeback-not-configured"
+      })
+    );
   }
 }
 

package/dist/runtime/backend-runtime/manifest.json

@@ -1,7 +1,7 @@
 {
-  "cliVersion": "0.19.0",
-  "sdkVersion": "0.4.0",
-  "runtimeBuildId": "4086a66aa2f8",
-  "inputFingerprint": "4086a66aa2f8f08916caeed739b88de02ca5fe45e5de235b98dd1f9e3513d196",
+  "cliVersion": "0.19.1-beta.10",
+  "sdkVersion": "0.5.0-beta.1",
+  "runtimeBuildId": "68aee00c09c6",
+  "inputFingerprint": "68aee00c09c62e7838d5d93a1b93c278d33bc528fb776834d2f27abbcd75de43",
   "entry": "index.js"
 }

package/dist/utils.js

@@ -440,7 +440,8 @@ var BADGES = {
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
   END_ACTIVITY: "/integrations/timeback/end-activity",
-  GET_XP: "/integrations/timeback/xp"
+  GET_XP: "/integrations/timeback/xp",
+  HEARTBEAT: "/integrations/timeback/heartbeat"
 };
 
 // ../constants/src/workers.ts
@@ -451,6 +452,8 @@ var WORKER_NAMING = {
   STAGING_SUFFIX: "-staging"
 };
 var SECRETS_PREFIX = "secrets_";
+var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
+var BACKEND_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 
 // src/lib/config/loader.ts
 init_file_loader();
@@ -475,7 +478,7 @@ var DEFAULT_API_ROUTES_DIRECTORY = join2(SERVER_ROOT_DIRECTORY, "api");
 // ../better-auth/package.json
 var package_default = {
   name: "@playcademy/better-auth",
-  version: "0.0.5",
+  version: "0.0.6-beta.10",
   type: "module",
   exports: {
     "./server": {
@@ -546,8 +549,6 @@ var TSCONFIG_REQUIRED_INCLUDES = [
 var BUCKET_ALWAYS_SKIP = [".git", ".DS_Store", ".gitignore", ...ENV_FILES];
 
 // src/constants/cloudflare.ts
-var CLOUDFLARE_COMPATIBILITY_DATE = "2025-10-11";
-var BACKEND_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 var CLOUDFLARE_BINDINGS = {
   /** R2 bucket binding name */
   BUCKET: "BUCKET",
@@ -1961,7 +1962,8 @@ var ROUTES = {
   /** TimeBack integration routes */
   TIMEBACK: {
     END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
-    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`
+    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
+    HEARTBEAT: `/api${TIMEBACK_ROUTES.HEARTBEAT}`
   }
 };
 
@@ -2529,7 +2531,7 @@ import { existsSync as existsSync8, mkdirSync as mkdirSync2, writeFileSync as wr
 import { dirname as dirname4, join as join13 } from "node:path";
 
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.19.0";
+var cliVersion = false ? "0.0.0-dev" : "0.19.1-beta.10";
 
 // src/lib/build/binary-resource.ts
 function writeFileTree(baseDir, files) {
@@ -5232,7 +5234,10 @@ function createEsbuildConfig(entryCode, paths, bundleConfig, customRoutesDir, op
       // └─────────────────────────────────────────────────────────────────────┘
       "@game-server": join18(workspace, "server")
     },
-    plugins: [createBackendNodeCompatPlugin(), createForbiddenRuntimeImportsPlugin(workspace)],
+    plugins: [
+      createBackendNodeCompatPlugin({ compatibilityDate: options.compatibilityDate }),
+      createForbiddenRuntimeImportsPlugin(workspace)
+    ],
     external: []
     // Native workerd builtins are externalized via the compat plugin
   };

package/dist/version.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var cliVersion = false ? "0.0.0-dev" : "0.19.0";
+var cliVersion = false ? "0.0.0-dev" : "0.19.1-beta.10";
 export {
   cliVersion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.19.0",
+    "version": "0.19.1-beta.10",
     "type": "module",
     "exports": {
         ".": {
@@ -50,7 +50,7 @@
     },
     "dependencies": {
         "@inquirer/prompts": "^7.8.6",
-        "@playcademy/sdk": "0.4.0",
+        "@playcademy/sdk": "0.5.0",
         "chokidar": "^4.0.3",
         "colorette": "^2.0.20",
         "commander": "^14.0.1",