playcademy 0.16.4 → 0.16.6

package/dist/cli.js

@@ -1299,7 +1299,7 @@ var ACHIEVEMENT_DEFINITIONS = [
 ];
 
 // ../constants/src/typescript.ts
-var TSC_PACKAGE = "@typescript/native-preview";
+var TSC_PACKAGE = "typescript";
 var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
 
 // ../constants/src/overworld.ts
@@ -1818,7 +1818,7 @@ var init_achievements = __esm2(() => {
 });
 var init_auth = () => {
 };
-var TSC_PACKAGE2 = "@typescript/native-preview";
+var TSC_PACKAGE2 = "typescript";
 var USE_NATIVE_TSC2;
 var init_typescript = __esm2(() => {
   USE_NATIVE_TSC2 = TSC_PACKAGE2.includes("native-preview");
@@ -2965,7 +2965,7 @@ import { join as join13 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.16.3",
+  version: "0.16.5",
   type: "module",
   exports: {
     ".": {

package/dist/constants/src/timeback.ts

@@ -32,6 +32,7 @@ export const TIMEBACK_CALIPER_SENSORS = [
  */
 export const TIMEBACK_ROUTES = {
     END_ACTIVITY: '/integrations/timeback/end-activity',
+    GET_XP: '/integrations/timeback/xp',
 } as const
 
 /**

package/dist/constants/src/typescript.ts

@@ -11,7 +11,10 @@
  * - '@typescript/native-preview' - Native TypeScript compiler (faster)
  * - 'typescript' - Standard TypeScript compiler
  */
-export const TSC_PACKAGE = '@typescript/native-preview'
+// Temporarily using regular TypeScript because @typescript/native-preview daily
+// dev builds can break unexpectedly (e.g., 7.0.0-e3a5e657689e43fb from Dec 18 hung).
+// TODO: Switch back to native-preview once stable releases are available.
+export const TSC_PACKAGE = 'typescript'
 
 /**
  * Whether using the native TypeScript compiler.

package/dist/constants.js

@@ -387,7 +387,7 @@ var ACHIEVEMENT_DEFINITIONS = [
 ];
 
 // ../constants/src/typescript.ts
-var TSC_PACKAGE = "@typescript/native-preview";
+var TSC_PACKAGE = "typescript";
 var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
 
 // ../constants/src/domains.ts

package/dist/db.js

@@ -311,7 +311,7 @@ var ACHIEVEMENT_DEFINITIONS = [
 ];
 
 // ../constants/src/typescript.ts
-var TSC_PACKAGE = "@typescript/native-preview";
+var TSC_PACKAGE = "typescript";
 var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
 
 // ../constants/src/overworld.ts

package/dist/edge-play/src/constants.ts

@@ -22,5 +22,6 @@ export const ROUTES = {
     /** TimeBack integration routes */
     TIMEBACK: {
         END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
+        GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`,
     },
 } as const

package/dist/edge-play/src/lib/errors.ts

@@ -0,0 +1,45 @@
+/* eslint-disable no-console */
+/**
+ * Shared error handling utilities for edge-play routes.
+ */
+
+import type { Context } from 'hono'
+import type { HonoEnv } from '../types'
+
+/**
+ * Check if running in development mode.
+ * Dev mode is detected by localhost or .dev. in the base URL.
+ */
+export function isDev(c: Context<HonoEnv>): boolean {
+    const baseUrl = c.env.PLAYCADEMY_BASE_URL || ''
+    return baseUrl.includes('localhost') || baseUrl.includes('.dev.')
+}
+
+/**
+ * Build an error response object with optional stack trace (dev only).
+ */
+export function buildErrorResponse(
+    c: Context<HonoEnv>,
+    error: unknown,
+    fallbackMessage: string,
+): { error: string; message: string; stack?: string } {
+    const message = error instanceof Error ? error.message : String(error)
+    const stack = error instanceof Error ? error.stack : undefined
+
+    return {
+        error: fallbackMessage,
+        message,
+        ...(isDev(c) && stack && { stack }),
+    }
+}
+
+/**
+ * Log an error with a prefix tag for consistent logging.
+ */
+export function logError(tag: string, error: unknown): void {
+    const message = error instanceof Error ? error.message : String(error)
+    const stack = error instanceof Error ? error.stack : undefined
+
+    if (message) console.error(`[${tag}] Error:`, message)
+    if (stack) console.error(`[${tag}] Stack:`, stack)
+}

package/dist/edge-play/src/lib/index.ts

@@ -0,0 +1,2 @@
+export * from './errors'
+export * from './validation'

package/dist/edge-play/src/lib/validation.test.ts

@@ -0,0 +1,189 @@
+import { describe, expect, it } from 'bun:test'
+
+import {
+    isValidGrade,
+    isValidSubject,
+    validateCourseConfig,
+    VALID_GRADES,
+    VALID_SUBJECTS,
+} from './validation'
+
+import type { PlaycademyConfig } from '@playcademy/sdk/server'
+
+describe('isValidGrade', () => {
+    it('accepts valid grade levels', () => {
+        for (const grade of VALID_GRADES) {
+            expect(isValidGrade(grade)).toBe(true)
+        }
+    })
+
+    it('accepts Pre-K (-1), Kindergarten (0), and AP (13)', () => {
+        expect(isValidGrade(-1)).toBe(true) // Pre-K
+        expect(isValidGrade(0)).toBe(true) // Kindergarten
+        expect(isValidGrade(13)).toBe(true) // AP
+    })
+
+    it('rejects invalid grade levels', () => {
+        expect(isValidGrade(-2)).toBe(false)
+        expect(isValidGrade(14)).toBe(false)
+        expect(isValidGrade(100)).toBe(false)
+    })
+
+    it('rejects non-integer values', () => {
+        expect(isValidGrade(3.5)).toBe(false)
+        expect(isValidGrade(NaN)).toBe(false)
+        expect(isValidGrade(Infinity)).toBe(false)
+    })
+
+    it('rejects non-number values', () => {
+        expect(isValidGrade('3')).toBe(false)
+        expect(isValidGrade(null)).toBe(false)
+        expect(isValidGrade(undefined)).toBe(false)
+        expect(isValidGrade({})).toBe(false)
+    })
+})
+
+describe('isValidSubject', () => {
+    it('accepts valid subjects', () => {
+        for (const subject of VALID_SUBJECTS) {
+            expect(isValidSubject(subject)).toBe(true)
+        }
+    })
+
+    it('accepts common subjects', () => {
+        expect(isValidSubject('Math')).toBe(true)
+        expect(isValidSubject('FastMath')).toBe(true)
+        expect(isValidSubject('Reading')).toBe(true)
+        expect(isValidSubject('Science')).toBe(true)
+    })
+
+    it('rejects invalid subjects', () => {
+        expect(isValidSubject('History')).toBe(false)
+        expect(isValidSubject('Art')).toBe(false)
+        expect(isValidSubject('math')).toBe(false) // case-sensitive
+        expect(isValidSubject('MATH')).toBe(false)
+    })
+
+    it('rejects non-string values', () => {
+        expect(isValidSubject(123)).toBe(false)
+        expect(isValidSubject(null)).toBe(false)
+        expect(isValidSubject(undefined)).toBe(false)
+        expect(isValidSubject({})).toBe(false)
+    })
+})
+
+describe('validateCourseConfig', () => {
+    /**
+     * Simulates a typical playcademy.config.js for a math game
+     * covering grades 3-5.
+     */
+    const mathGameConfig: PlaycademyConfig = {
+        name: 'Math Adventure',
+        integrations: {
+            timeback: {
+                courses: [
+                    { subject: 'Math', grade: 3, totalXp: 1000, masterableUnits: 10 },
+                    { subject: 'Math', grade: 4, totalXp: 1200, masterableUnits: 12 },
+                    { subject: 'Math', grade: 5, totalXp: 1500, masterableUnits: 15 },
+                ],
+            },
+        },
+    }
+
+    /**
+     * Simulates a multi-subject game config.
+     */
+    const multiSubjectConfig: PlaycademyConfig = {
+        name: 'Learning Hub',
+        integrations: {
+            timeback: {
+                courses: [
+                    { subject: 'Math', grade: 3, totalXp: 500, masterableUnits: 5 },
+                    { subject: 'Reading', grade: 3, totalXp: 500, masterableUnits: 5 },
+                    { subject: 'Science', grade: 4, totalXp: 600, masterableUnits: 6 },
+                ],
+            },
+        },
+    }
+
+    it('returns null for configured grade/subject combinations', () => {
+        expect(validateCourseConfig({ grade: 3, subject: 'Math', config: mathGameConfig })).toBeNull()
+        expect(validateCourseConfig({ grade: 4, subject: 'Math', config: mathGameConfig })).toBeNull()
+        expect(validateCourseConfig({ grade: 5, subject: 'Math', config: mathGameConfig })).toBeNull()
+    })
+
+    it('returns error for unconfigured grade', () => {
+        const result = validateCourseConfig({ grade: 6, subject: 'Math', config: mathGameConfig })
+
+        expect(result).not.toBeNull()
+        expect(result?.error).toContain('Invalid grade/subject combination')
+        expect(result?.error).toContain('Math (Grade 6)')
+        expect(result?.error).toContain('Configured courses:')
+    })
+
+    it('returns error for unconfigured subject', () => {
+        const result = validateCourseConfig({ grade: 3, subject: 'Reading', config: mathGameConfig })
+
+        expect(result).not.toBeNull()
+        expect(result?.error).toContain('Invalid grade/subject combination')
+        expect(result?.error).toContain('Reading (Grade 3)')
+    })
+
+    it('lists all configured courses in error message', () => {
+        const result = validateCourseConfig({ grade: 1, subject: 'Math', config: mathGameConfig })
+
+        expect(result?.error).toContain('Math (Grade 3)')
+        expect(result?.error).toContain('Math (Grade 4)')
+        expect(result?.error).toContain('Math (Grade 5)')
+    })
+
+    it('validates multi-subject configs correctly', () => {
+        // Configured combinations
+        expect(
+            validateCourseConfig({ grade: 3, subject: 'Math', config: multiSubjectConfig }),
+        ).toBeNull()
+        expect(
+            validateCourseConfig({ grade: 3, subject: 'Reading', config: multiSubjectConfig }),
+        ).toBeNull()
+        expect(
+            validateCourseConfig({ grade: 4, subject: 'Science', config: multiSubjectConfig }),
+        ).toBeNull()
+
+        // Not configured: Math grade 4 (only Science is grade 4)
+        const result = validateCourseConfig({
+            grade: 4,
+            subject: 'Math',
+            config: multiSubjectConfig,
+        })
+        expect(result).not.toBeNull()
+        expect(result?.error).toContain('Math (Grade 4)')
+    })
+
+    it('handles config with no courses', () => {
+        const emptyConfig: PlaycademyConfig = {
+            name: 'Empty Game',
+            integrations: {
+                timeback: {
+                    courses: [],
+                },
+            },
+        }
+
+        const result = validateCourseConfig({ grade: 3, subject: 'Math', config: emptyConfig })
+
+        expect(result).not.toBeNull()
+        expect(result?.error).toContain('Configured courses: none')
+    })
+
+    it('handles config with no timeback integration', () => {
+        const noTimebackConfig: PlaycademyConfig = {
+            name: 'No Timeback',
+            integrations: {},
+        }
+
+        const result = validateCourseConfig({ grade: 3, subject: 'Math', config: noTimebackConfig })
+
+        expect(result).not.toBeNull()
+        expect(result?.error).toContain('Configured courses: none')
+    })
+})

package/dist/edge-play/src/lib/validation.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared validation utilities for edge-play routes.
+ */
+
+import type { PlaycademyConfig } from '@playcademy/sdk/server'
+
+/** Valid grade levels: -1 (Pre-K), 0 (Kindergarten), 1-12 (Grades), 13 (AP) */
+export const VALID_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13] as const
+
+/** Valid TimeBack subject values */
+export const VALID_SUBJECTS = [
+    'Reading',
+    'Language',
+    'Vocabulary',
+    'Social Studies',
+    'Writing',
+    'Science',
+    'FastMath',
+    'Math',
+    'None',
+] as const
+
+export type ValidGrade = (typeof VALID_GRADES)[number]
+export type ValidSubject = (typeof VALID_SUBJECTS)[number]
+
+export function isValidGrade(value: unknown): value is ValidGrade {
+    return (
+        typeof value === 'number' &&
+        Number.isInteger(value) &&
+        VALID_GRADES.includes(value as ValidGrade)
+    )
+}
+
+export function isValidSubject(value: unknown): value is ValidSubject {
+    return typeof value === 'string' && VALID_SUBJECTS.includes(value as ValidSubject)
+}
+
+/**
+ * Validate that a grade/subject combination is configured for this game.
+ * Returns an error object if invalid, null if valid.
+ */
+export function validateCourseConfig(params: {
+    grade: number
+    subject: string
+    config: PlaycademyConfig
+}): { error: string } | null {
+    const { grade, subject, config } = params
+    const timebackConfig = config.integrations?.timeback
+    const configuredCourse = timebackConfig?.courses?.find(
+        course => course.grade === grade && course.subject === subject,
+    )
+    if (!configuredCourse) {
+        const configured = timebackConfig?.courses
+            ?.map(c => `${c.subject} (Grade ${c.grade})`)
+            .join(', ')
+        return {
+            error: `Invalid grade/subject combination: ${subject} (Grade ${grade}). Configured courses: ${configured || 'none'}`,
+        }
+    }
+    return null
+}

package/dist/edge-play/src/register-routes.ts

@@ -27,12 +27,12 @@ export async function registerBuiltinRoutes(app: Hono<HonoEnv>, integrations?: I
 
     // TimeBack integration
     if (integrations?.timeback) {
-        const [endActivity] = await Promise.all([
+        const [endActivity, getXp] = await Promise.all([
             import('./routes/integrations/timeback/end-activity'),
-            // ... other routes
+            import('./routes/integrations/timeback/get-xp'),
         ])
         app.post(ROUTES.TIMEBACK.END_ACTIVITY, endActivity.POST)
-        // ... other routes
+        app.get(ROUTES.TIMEBACK.GET_XP, getXp.GET)
     } else if (integrations?.timeback === null) {
         app.post('/api/integrations/timeback/end-activity', async c => {
             return c.json({
@@ -40,6 +40,13 @@ export async function registerBuiltinRoutes(app: Hono<HonoEnv>, integrations?: I
                 __playcademyDevWarning: 'timeback-not-configured',
             })
         })
+        app.get('/api/integrations/timeback/xp', async c => {
+            return c.json({
+                timebackId: '',
+                totalXp: 0,
+                __playcademyDevWarning: 'timeback-not-configured',
+            })
+        })
     }
 
     // TODO: Auth integration

package/dist/edge-play/src/routes/integrations/timeback/end-activity.ts

@@ -1,3 +1,13 @@
+import {
+    buildErrorResponse,
+    isValidGrade,
+    isValidSubject,
+    logError,
+    VALID_GRADES,
+    VALID_SUBJECTS,
+    validateCourseConfig,
+} from '../../../lib'
+
 import type { Context } from 'hono'
 import type { PlaycademyConfig } from '@playcademy/sdk/server'
 import type { ActivityData } from '@playcademy/types/timeback'
@@ -17,37 +27,6 @@ import type { HonoEnv } from '../../../types'
  * their own backend infrastructure. The SDK handles config enrichment and metadata.
  */
 
-/** Valid grade levels: -1 (Pre-K), 0 (Kindergarten), 1-12 (Grades), 13 (AP) */
-const VALID_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13] as const
-
-/** Valid TimeBack subject values */
-const VALID_SUBJECTS = [
-    'Reading',
-    'Language',
-    'Vocabulary',
-    'Social Studies',
-    'Writing',
-    'Science',
-    'FastMath',
-    'Math',
-    'None',
-] as const
-
-function isValidGrade(value: unknown): value is (typeof VALID_GRADES)[number] {
-    return (
-        typeof value === 'number' &&
-        Number.isInteger(value) &&
-        VALID_GRADES.includes(value as (typeof VALID_GRADES)[number])
-    )
-}
-
-function isValidSubject(value: unknown): value is (typeof VALID_SUBJECTS)[number] {
-    return (
-        typeof value === 'string' &&
-        VALID_SUBJECTS.includes(value as (typeof VALID_SUBJECTS)[number])
-    )
-}
-
 function getConfig(c: Context<HonoEnv>): PlaycademyConfig {
     const config = c.get('config')
     const timebackConfig = config?.integrations?.timeback
@@ -88,27 +67,6 @@ function validateRequestBody(body: {
     return null
 }
 
-function validateCourse(params: {
-    grade: number
-    subject: string
-    config: PlaycademyConfig
-}): { error: string } | null {
-    const { grade, subject, config } = params
-    const timebackConfig = config.integrations?.timeback
-    const configuredCourse = timebackConfig?.courses?.find(
-        course => course.grade === grade && course.subject === subject,
-    )
-    if (!configuredCourse) {
-        const configured = timebackConfig?.courses
-            ?.map(c => `${c.subject} (Grade ${c.grade})`)
-            .join(', ')
-        return {
-            error: `Invalid grade/subject combination: ${subject} (Grade ${grade}). Configured courses: ${configured || 'none'}`,
-        }
-    }
-    return null
-}
-
 function enrichActivityData(params: {
     activityData: ActivityData
     config: PlaycademyConfig
@@ -163,7 +121,7 @@ export async function POST(c: Context<HonoEnv>): Promise<Response> {
 
         // 6. Validate grade/subject against configured courses
         const { grade, subject } = activityData
-        const courseValidationError = validateCourse({ grade, subject, config })
+        const courseValidationError = validateCourseConfig({ grade, subject, config })
 
         if (courseValidationError) {
             const message = courseValidationError.error
@@ -193,10 +151,7 @@ export async function POST(c: Context<HonoEnv>): Promise<Response> {
 
         return c.json(result)
     } catch (error) {
-        const message = error instanceof Error ? error.message : String(error)
-        const stack = error instanceof Error ? error.stack : undefined
-        if (message) console.error('[TimeBack End Activity] Error:', message)
-        if (stack) console.error('[TimeBack End Activity] Stack:', stack)
-        return c.json({ error: 'Failed to end activity', message, stack }, 500)
+        logError('TimeBack End Activity', error)
+        return c.json(buildErrorResponse(c, error, 'Failed to end activity'), 500)
     }
 }

package/dist/edge-play/src/routes/integrations/timeback/get-xp.ts

@@ -0,0 +1,147 @@
+import {
+    buildErrorResponse,
+    isValidGrade,
+    isValidSubject,
+    logError,
+    VALID_GRADES,
+    VALID_SUBJECTS,
+    validateCourseConfig,
+} from '../../../lib'
+
+import type { Context } from 'hono'
+import type { PlaycademyConfig } from '@playcademy/sdk/server'
+import type { HonoEnv } from '../../../types'
+
+/**
+ * TimeBack integration - Get student XP
+ * Route: GET /api/integrations/timeback/xp
+ * Auto-generated when integrations.timeback is configured
+ *
+ * Flow:
+ * 1. Game frontend calls this route on deployed backend ({slug}.playcademy.gg/api/integrations/timeback/xp)
+ * 2. This route calls Playcademy platform API via SDK (hub.playcademy.net/api/timeback/student-xp/:timebackId)
+ * 3. Platform API fetches XP data from TimeBack EduBridge analytics API
+ *
+ * By default, returns XP for all courses configured for this game/app.
+ * Use `grade` and `subject` to query a specific course instead.
+ *
+ * Query Parameters:
+ *
+ * @param {number} [grade] - Grade level to filter (-1 to 13).
+ *   Must be used together with `subject`.
+ *   Example: `?grade=3&subject=Math`
+ *
+ * @param {string} [subject] - Subject to filter.
+ *   Must be used together with `grade`.
+ *   Valid values: Reading, Language, Vocabulary, Social Studies, Writing, Science, FastMath, Math, None
+ *   Example: `?grade=3&subject=Math`
+ *
+ * @param {string} [include] - Comma-separated list of additional data to include.
+ *   Available options:
+ *   - `perCourse` - Include per-course XP breakdown with grade, subject, and xp
+ *   - `today` - Include today's XP (both total and per-course if perCourse is set)
+ *   Example: `?include=perCourse,today`
+ *
+ * Response:
+ * ```json
+ * {
+ *   "totalXp": 1500,
+ *   "todayXp": 50,           // Only if include contains 'today'
+ *   "courses": [              // Only if include contains 'perCourse'
+ *     {
+ *       "grade": 3,
+ *       "subject": "Math",
+ *       "title": "Math Grade 3",
+ *       "totalXp": 1000,
+ *       "todayXp": 30        // Only if include contains 'today'
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+
+/**
+ * Get config and validate that the game has TimeBack configured.
+ */
+function getConfig(c: Context<HonoEnv>): PlaycademyConfig {
+    const config = c.get('config')
+    const timebackConfig = config?.integrations?.timeback
+    if (!timebackConfig) throw new Error('TimeBack integration not found')
+    return config
+}
+
+export async function GET(c: Context<HonoEnv>): Promise<Response> {
+    try {
+        // 1. Get authenticated user from middleware
+        const user = c.get('playcademyUser')
+        if (!user) return c.json({ error: 'Unauthorized' }, 401)
+
+        // 2. Ensure user has TimeBack integration
+        if (!user.timeback_id) {
+            const message = 'User does not have TimeBack integration'
+            console.error('[TimeBack Get XP] Error:', message)
+            return c.json({ error: message }, 400)
+        }
+
+        // 3. Validate TimeBack is configured for this game
+        const config = getConfig(c)
+
+        // 4. Parse query parameters
+        const url = new URL(c.req.url)
+        const gradeParam = url.searchParams.get('grade')
+        const subjectParam = url.searchParams.get('subject')
+        const includeParam = url.searchParams.get('include')
+        const include = includeParam
+            ? (includeParam.split(',').map(s => s.trim()) as ('perCourse' | 'today')[])
+            : undefined
+
+        let grade: number | undefined
+        let subject: string | undefined
+
+        if (gradeParam !== null || subjectParam !== null) {
+            if (gradeParam === null || subjectParam === null) {
+                return c.json({ error: 'Both grade and subject must be provided together' }, 400)
+            }
+
+            grade = parseInt(gradeParam, 10)
+            subject = subjectParam
+
+            if (!isValidGrade(grade)) {
+                return c.json(
+                    { error: `grade must be a valid grade level (${VALID_GRADES.join(', ')})` },
+                    400,
+                )
+            }
+
+            if (!isValidSubject(subject)) {
+                return c.json(
+                    { error: `subject must be a valid subject (${VALID_SUBJECTS.join(', ')})` },
+                    400,
+                )
+            }
+
+            // 5. Validate grade/subject against configured courses
+            const courseValidationError = validateCourseConfig({ grade, subject, config })
+
+            if (courseValidationError) {
+                return c.json({ error: courseValidationError.error }, 400)
+            }
+        }
+
+        // 6. Get SDK client from context
+        const sdk = c.get('sdk')
+
+        // 7. Fetch student XP from platform API
+        // The SDK automatically passes gameId, so XP is filtered to this game's courses
+        const result = await sdk.timeback.getStudentXp(user.timeback_id, {
+            grade,
+            subject,
+            include,
+        })
+
+        return c.json(result)
+    } catch (error) {
+        logError('TimeBack Get XP', error)
+        return c.json(buildErrorResponse(c, error, 'Failed to get XP'), 500)
+    }
+}

package/dist/index.d.ts

@@ -731,7 +731,7 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "games";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "external" | "hosted";
+            data: "hosted" | "external";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -782,7 +782,7 @@ declare const games: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "games";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "godot" | "unity" | "web";
+            data: "web" | "godot" | "unity";
             driverParam: string;
             notNull: true;
             hasDefault: true;

package/dist/index.js

@@ -700,7 +700,7 @@ var ACHIEVEMENT_DEFINITIONS = [
 ];
 
 // ../constants/src/typescript.ts
-var TSC_PACKAGE = "@typescript/native-preview";
+var TSC_PACKAGE = "typescript";
 var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
 
 // ../constants/src/domains.ts
@@ -747,7 +747,8 @@ var BADGES = {
 
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
-  END_ACTIVITY: "/integrations/timeback/end-activity"
+  END_ACTIVITY: "/integrations/timeback/end-activity",
+  GET_XP: "/integrations/timeback/xp"
 };
 
 // ../constants/src/workers.ts
@@ -2397,7 +2398,7 @@ var init_achievements = __esm2(() => {
 });
 var init_auth = () => {
 };
-var TSC_PACKAGE2 = "@typescript/native-preview";
+var TSC_PACKAGE2 = "typescript";
 var USE_NATIVE_TSC2;
 var init_typescript = __esm2(() => {
   USE_NATIVE_TSC2 = TSC_PACKAGE2.includes("native-preview");
@@ -2801,7 +2802,7 @@ var init_achievements2 = __esm3(() => {
 });
 var init_auth2 = () => {
 };
-var TSC_PACKAGE3 = "@typescript/native-preview";
+var TSC_PACKAGE3 = "typescript";
 var USE_NATIVE_TSC3;
 var init_typescript2 = __esm3(() => {
   USE_NATIVE_TSC3 = TSC_PACKAGE3.includes("native-preview");
@@ -3995,7 +3996,7 @@ import { join as join12 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.16.3",
+  version: "0.16.5",
   type: "module",
   exports: {
     ".": {
@@ -6332,7 +6333,8 @@ var ROUTES = {
   HEALTH: "/api/health",
   /** TimeBack integration routes */
   TIMEBACK: {
-    END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`
+    END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
+    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`
   }
 };
 
@@ -8421,9 +8423,11 @@ async function analyzeChanges(context2) {
     deployedGameInfo
   } = context2;
   let secretsDiff = void 0;
-  if (localSecrets && Object.keys(localSecrets).length > 0) {
+  const hasLocalSecrets = Object.keys(localSecrets ?? {}).length > 0;
+  const hasRemoteSecrets = remoteSecretKeys && remoteSecretKeys.length > 0;
+  if (hasLocalSecrets || hasRemoteSecrets) {
     secretsDiff = computeSecretsDiff({
-      localSecrets,
+      localSecrets: localSecrets ?? {},
       remoteKeys: remoteSecretKeys ?? [],
       cachedHashes: deployedGameInfo?.secretsHashes
     });
@@ -8514,8 +8518,8 @@ async function analyzeChanges(context2) {
 async function calculateDeploymentPlan(context2, changes) {
   const { config, isGameDeployed: isGameDeployed2, projectPath, deployBackend, forceBackend } = context2;
   if (!isGameDeployed2) {
-    const needsBackend2 = hasLocalCustomRoutes(projectPath, context2.fullConfig) || !!context2.fullConfig?.integrations;
-    const shouldDeployBackend2 = deployBackend && needsBackend2;
+    const needsBackend3 = hasLocalCustomRoutes(projectPath, context2.fullConfig) || !!context2.fullConfig?.integrations;
+    const shouldDeployBackend2 = deployBackend && needsBackend3;
     return {
       action: "deploy-new",
       gameType: config.gameType ?? "hosted",
@@ -8541,7 +8545,8 @@ async function calculateDeploymentPlan(context2, changes) {
   }
   const shouldUpdateGame = buildHasChanges || configHasChanges;
   const shouldUploadBuild = buildHasChanges;
-  const shouldDeployBackend = deployBackend && (backendHasChanges || forceBackend);
+  const needsBackend2 = hasLocalCustomRoutes(projectPath, context2.fullConfig) || !!context2.fullConfig?.integrations;
+  const shouldDeployBackend = deployBackend && (backendHasChanges || forceBackend || shouldUploadBuild && needsBackend2);
   return {
     action: "update-existing",
     gameType: config.gameType ?? "hosted",
@@ -10675,8 +10680,11 @@ async function executeDeployment(plan, changes, context2, environment) {
   return { game, backendMetadata };
 }
 async function runDeployment(options) {
-  const environment = ensureEnvironment(options.env);
-  await selectEnvironment({ env: environment, dryRun: options.dryRun });
+  if (options.env) {
+    ensureEnvironment(options.env);
+  }
+  await selectEnvironment({ env: options.env, dryRun: options.dryRun });
+  const environment = ensureEnvironment(void 0);
   const context2 = await prepareDeploymentContext(options);
   displayCurrentConfiguration(context2);
   const didPrompt = await promptForMissingConfig(context2);
@@ -10991,7 +10999,7 @@ var getStatusCommand = new Command13("status").description("Check your developer
 });
 
 // package.json
-var version2 = "0.16.3";
+var version2 = "0.16.5";
 
 // src/commands/dev/server.ts
 function setupCleanupHandlers(workspace, getServer) {
@@ -14503,18 +14511,18 @@ async function runSecretsPush(options = {}) {
   }
   const localSecrets = await readEnvFile(workspace);
   const localKeys = Object.keys(localSecrets);
-  if (localKeys.length === 0) {
-    logger.admonition("info", "No Secrets", [
-      `Your <.env> file is empty or contains no valid secrets`
-    ]);
-    logger.newLine();
-    return false;
-  }
   const remoteKeys = await runStep(
     `Fetching secrets from ${environment}`,
     () => client.dev.games.secrets.list(game.slug),
     (keys) => `Found ${keys.length} existing ${pluralize(keys.length, "secret")} on ${environment}`
   );
+  const noSyncNecessary = localKeys.length === 0 && remoteKeys.length === 0;
+  if (noSyncNecessary) {
+    logger.newLine();
+    logger.success("No secrets to sync");
+    logger.newLine();
+    return true;
+  }
   const cachedHashes = deployedGame.secretsHashes;
   const diff = computeSecretsDiff({
     localSecrets,

package/dist/utils.js

@@ -616,7 +616,7 @@ var ACHIEVEMENT_DEFINITIONS = [
 ];
 
 // ../constants/src/typescript.ts
-var TSC_PACKAGE = "@typescript/native-preview";
+var TSC_PACKAGE = "typescript";
 var USE_NATIVE_TSC = TSC_PACKAGE.includes("native-preview");
 
 // ../constants/src/overworld.ts
@@ -652,7 +652,8 @@ var BADGES = {
 
 // ../constants/src/timeback.ts
 var TIMEBACK_ROUTES = {
-  END_ACTIVITY: "/integrations/timeback/end-activity"
+  END_ACTIVITY: "/integrations/timeback/end-activity",
+  GET_XP: "/integrations/timeback/xp"
 };
 
 // ../constants/src/workers.ts
@@ -1327,7 +1328,8 @@ var ROUTES = {
   HEALTH: "/api/health",
   /** TimeBack integration routes */
   TIMEBACK: {
-    END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`
+    END_ACTIVITY: `/api${TIMEBACK_ROUTES.END_ACTIVITY}`,
+    GET_XP: `/api${TIMEBACK_ROUTES.GET_XP}`
   }
 };
 
@@ -2356,7 +2358,7 @@ import { join as join12 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.16.3",
+  version: "0.16.5",
   type: "module",
   exports: {
     ".": {

package/dist/version.js

@@ -1,7 +1,7 @@
 // package.json with { type: 'json' }
 var package_default = {
   name: "playcademy",
-  version: "0.16.3",
+  version: "0.16.5",
   type: "module",
   exports: {
     ".": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.16.4",
+    "version": "0.16.6",
     "type": "module",
     "exports": {
         ".": {
@@ -50,7 +50,7 @@
     },
     "dependencies": {
         "@inquirer/prompts": "^7.8.6",
-        "@playcademy/sdk": "0.2.11",
+        "@playcademy/sdk": "0.2.12",
         "chokidar": "^4.0.3",
         "colorette": "^2.0.20",
         "commander": "^14.0.1",