playcademy 0.18.0 → 0.18.2

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "playcademy",
-    "version": "0.18.0",
+    "version": "0.18.2",
     "type": "module",
     "exports": {
         ".": {

package/dist/constants/src/achievements.ts

@@ -1,107 +0,0 @@
-/**
- * Achievement definitions - single source of truth for all achievements
- *
- * Used by:
- * - apps/cademy seed scripts
- * - packages/sandbox seeding
- * - packages/fns achievement awarding
- *
- * NOTE: Uses string literals instead of AchievementCompletionType enum
- * to avoid circular dependency with @playcademy/data
- */
-
-/**
- * Achievement IDs as constants to avoid magic strings
- */
-export const ACHIEVEMENT_IDS = {
-    PLAY_ANY_GAME_DAILY: 'play_any_game_daily',
-    DAILY_CHEST_OPEN: 'daily_chest_open',
-    LEADERBOARD_TOP3_DAILY: 'leaderboard_top3_daily',
-    LEADERBOARD_TOP3_WEEKLY: 'leaderboard_top3_weekly',
-    FIRST_SCORE_ANY_GAME: 'first_score_any_game',
-    PERSONAL_BEST_ANY_GAME: 'personal_best_any_game',
-} as const
-
-export type AchievementId = (typeof ACHIEVEMENT_IDS)[keyof typeof ACHIEVEMENT_IDS]
-
-/**
- * Achievement definitions for platform seeding
- */
-export const ACHIEVEMENT_DEFINITIONS = [
-    {
-        id: ACHIEVEMENT_IDS.PLAY_ANY_GAME_DAILY,
-        title: 'Play any game',
-        description: 'Play any arcade game for at least 60 seconds in a single session.',
-        scope: 'daily' as const,
-        rewardCredits: 10,
-        limit: 1,
-        completionType: 'time_played_session' as const,
-        completionConfig: { minSeconds: 60 },
-        target: { anyArcadeGame: true },
-        active: true,
-    },
-    {
-        id: ACHIEVEMENT_IDS.DAILY_CHEST_OPEN,
-        title: 'Opened the daily chest',
-        description: 'Find the chest on the map and open it to claim your reward.',
-        scope: 'daily' as const,
-        rewardCredits: 10,
-        limit: 1,
-        completionType: 'interaction' as const,
-        completionConfig: { triggerId: 'bunny_chest' },
-        target: { map: 'arcade' },
-        active: true,
-    },
-    {
-        id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_DAILY,
-        title: 'Daily Champion',
-        description: 'Finish in the top 3 of any game leaderboard for the day.',
-        scope: 'daily' as const,
-        rewardCredits: 25, // Base reward, overridden by rankRewards
-        limit: 1,
-        completionType: 'leaderboard_rank' as const,
-        completionConfig: {
-            rankRewards: [50, 30, 15], // [1st place, 2nd place, 3rd place]
-        },
-        target: { anyArcadeGame: true },
-        active: true,
-    },
-    {
-        id: ACHIEVEMENT_IDS.LEADERBOARD_TOP3_WEEKLY,
-        title: 'Weekly Legend',
-        description: 'Finish in the top 3 of any game leaderboard for the week.',
-        scope: 'weekly' as const,
-        rewardCredits: 50, // Base reward, overridden by rankRewards
-        limit: 1,
-        completionType: 'leaderboard_rank' as const,
-        completionConfig: {
-            rankRewards: [100, 60, 30], // [1st place, 2nd place, 3rd place]
-        },
-        target: { anyArcadeGame: true },
-        active: true,
-    },
-    {
-        id: ACHIEVEMENT_IDS.FIRST_SCORE_ANY_GAME,
-        title: 'First Score',
-        description: 'Submit your first score in any arcade game.',
-        scope: 'game' as const, // Scoped per game, no time limit
-        rewardCredits: 5,
-        limit: 1,
-        completionType: 'first_score' as const,
-        completionConfig: {},
-        target: { anyArcadeGame: true },
-        active: true,
-    },
-    {
-        id: ACHIEVEMENT_IDS.PERSONAL_BEST_ANY_GAME,
-        title: 'Personal Best',
-        description: 'Beat your personal best score in any arcade game.',
-        scope: 'daily' as const,
-        rewardCredits: 5,
-        limit: 3, // Can earn 3 times per day
-        completionType: 'personal_best' as const,
-        completionConfig: {},
-        target: { anyArcadeGame: true },
-        active: true,
-    },
-]

package/dist/constants/src/auth.ts

@@ -1,13 +0,0 @@
-/**
- * Authentication Constants
- *
- * Constants related to authentication providers.
- */
-
-/**
- * Auth Provider Constants
- */
-export const AUTH_PROVIDER_IDS = {
-    TIMEBACK: 'timeback',
-    TIMEBACK_LTI: 'timeback-lti',
-} as const

package/dist/constants/src/character.ts

@@ -1,16 +0,0 @@
-/**
- * Character Constants
- *
- * Configuration for player character customization.
- */
-
-/** Accessory slot configuration with unlock levels */
-export const ACCESSORY_SLOTS = [
-    { type: 'head', unlockLevel: 1, displayName: 'Head', maxItems: 1 },
-    { type: 'face', unlockLevel: 2, displayName: 'Face', maxItems: 1 },
-    { type: 'hands', unlockLevel: 10, displayName: 'Hands', maxItems: 1 },
-    { type: 'back', unlockLevel: 15, displayName: 'Back', maxItems: 1 },
-] as const
-
-/** Valid accessory slot types */
-export const VALID_SLOT_TYPES = ['head', 'face', 'hands', 'back'] as const

package/dist/constants/src/domains.ts

@@ -1,50 +0,0 @@
-/**
- * Domain and URL Constants
- *
- * Centralized domain names and base URLs for the Playcademy platform.
- * These constants are shared across multiple packages to ensure consistency.
- */
-
-/**
- * Playcademy domain names
- */
-export const PLAYCADEMY_DOMAINS = {
-    /** Primary domain (hub, landing pages) */
-    apex: 'playcademy.net',
-    /** Marketing/alternative domain */
-    apexAlt: 'playcademy.com',
-    /** Game backend worker domain */
-    games: 'playcademy.gg',
-} as const
-
-/**
- * Platform hub base URLs by environment
- * Used by CLI, SDK, and other packages to make API requests
- */
-export const PLAYCADEMY_BASE_URLS = {
-    production: 'https://hub.playcademy.net',
-    staging: 'https://hub.dev.playcademy.net',
-} as const
-
-/**
- * Game backend worker domains by environment
- * Workers are deployed to Cloudflare and accessible at:
- * - Production: {slug}.playcademy.gg
- * - Staging: {slug}-staging.playcademy.gg
- */
-export const GAME_WORKER_DOMAINS = {
-    production: 'playcademy.gg',
-    staging: 'staging.playcademy.gg',
-} as const
-
-/**
- * Log collector worker URL
- * Used by CLI to stream real-time logs from deployed games
- * Works for both production and staging (game slugs include environment suffix)
- */
-export const LOG_COLLECTOR_URL = 'https://logs.playcademy.gg'
-
-/**
- * Type exports
- */
-export type PlatformEnvironment = 'production' | 'staging'

package/dist/constants/src/env-vars.ts

@@ -1,20 +0,0 @@
-/**
- * Environment Variable Names
- *
- * Centralized environment variable names used across the platform.
- * These ensure consistency between deployers and runtime environments.
- */
-
-/**
- * Environment variables for game backend workers
- * Used by both the deployment system (@playcademy/api-core)
- * and the worker runtime (@playcademy/edge-play)
- */
-export const WORKER_ENV_VARS = {
-    /** Game-specific API key for calling platform API */
-    PLAYCADEMY_API_KEY: 'PLAYCADEMY_API_KEY',
-    /** Game ID (UUID) */
-    GAME_ID: 'GAME_ID',
-    /** Platform API base URL */
-    PLAYCADEMY_BASE_URL: 'PLAYCADEMY_BASE_URL',
-} as const

package/dist/constants/src/index.ts

@@ -1,18 +0,0 @@
-/**
- * @playcademy/constants
- *
- * Centralized constants shared across the Playcademy platform.
- * This package contains domain names, URLs, environment variable names,
- * and other constants that need to be consistent across multiple packages.
- */
-
-export * from './achievements'
-export * from './auth'
-export * from './typescript'
-export * from './character'
-export * from './domains'
-export * from './env-vars'
-export * from './overworld'
-export * from './system'
-export * from './timeback'
-export * from './workers'

package/dist/constants/src/overworld.ts

@@ -1,330 +0,0 @@
-/**
- * Overworld & Game Constants
- *
- * All constants related to the game world, including items, rendering,
- * maps, physics, UI, and core platform games.
- */
-
-// ═══════════════════════════════════════════════════════════════════════
-// VIEWPORT & LEVEL SYSTEM
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Minimum viewport dimensions for the game.
- *
- * Height reduced from 640px to 600px to accommodate devices with taskbars
- * (e.g., Chromebooks in school deployments that showed 632px viewport).
- */
-export const MIN_VIEWPORT_WIDTH = 960
-export const MIN_VIEWPORT_HEIGHT = 560
-
-/**
- * Maximum player level
- */
-export const MAX_LEVEL = 100
-
-// ═══════════════════════════════════════════════════════════════════════
-// ITEMS & ECONOMY
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Item Slugs - Canonical slugs for core platform items
- */
-export const ITEM_SLUGS = {
-    /** Primary platform currency */
-    PLAYCADEMY_CREDITS: 'PLAYCADEMY_CREDITS',
-
-    /** Experience points currency */
-    PLAYCADEMY_XP: 'PLAYCADEMY_XP',
-
-    /** Core platform badges */
-    FOUNDING_MEMBER_BADGE: 'FOUNDING_MEMBER_BADGE',
-    EARLY_ADOPTER_BADGE: 'EARLY_ADOPTER_BADGE',
-    FIRST_GAME_BADGE: 'FIRST_GAME_BADGE',
-
-    /** Example items */
-    COMMON_SWORD: 'COMMON_SWORD',
-    SMALL_HEALTH_POTION: 'SMALL_HEALTH_POTION',
-    SMALL_BACKPACK: 'SMALL_BACKPACK',
-
-    /** Placeable items */
-    LAVA_LAMP: 'LAVA_LAMP',
-    BOOMBOX: 'BOOMBOX',
-    CABIN_BED: 'CABIN_BED',
-} as const
-
-/**
- * Currency-specific constants for easier access
- */
-export const CURRENCIES = {
-    /** Primary platform currency slug */
-    PRIMARY: ITEM_SLUGS.PLAYCADEMY_CREDITS,
-
-    /** Experience points slug */
-    XP: ITEM_SLUGS.PLAYCADEMY_XP,
-} as const
-
-/**
- * Currency symbol constants
- */
-export const CURRENCY_SYMBOLS = {
-    /** Primary platform currency symbol */
-    PLAYCADEMY_CREDITS: 'PC',
-
-    /** Experience points symbol */
-    PLAYCADEMY_XP: 'XP',
-
-    /** Default currency symbol */
-    DEFAULT: '¤',
-} as const
-
-/**
- * Badge constants for easier access
- */
-export const BADGES = {
-    FOUNDING_MEMBER: ITEM_SLUGS.FOUNDING_MEMBER_BADGE,
-    EARLY_ADOPTER: ITEM_SLUGS.EARLY_ADOPTER_BADGE,
-    FIRST_GAME: ITEM_SLUGS.FIRST_GAME_BADGE,
-} as const
-
-// ═══════════════════════════════════════════════════════════════════════
-// RENDERING & VISUALS
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Sprite System Constants
- */
-export const SPRITE_COMPONENTS = ['body', 'outfit', 'hairstyle', 'eyes', 'accessory'] as const
-export const SPRITE_LAYER_ORDER = ['body', 'outfit', 'hairstyle', 'eyes', 'accessory'] as const
-
-/**
- * Renderer Z-layer constants – centralised depth values used by the Three.js
- * front-end so magic numbers aren't scattered around the codebase.
- */
-export const Z_LAYERS = {
-    /** Depth step between successive Tiled tile-layers (background → foreground). */
-    TILE_LAYER_STEP: 0.01,
-
-    /** Depth step between stacked sprite components inside a single character. */
-    SPRITE_COMPONENT_STEP: 0.002,
-
-    /** Minimum Z for Y-sorted entities (top of screen). */
-    ENTITY_MIN: 0.011,
-
-    /** Maximum Z for Y-sorted entities (bottom of screen). */
-    ENTITY_MAX: 0.0115,
-
-    /** Fallback Z when map bounds are unavailable. */
-    ENTITY_FALLBACK: 0.011_25,
-
-    /** Offset applied to placeable item sprites so they sit above characters. */
-    PLACEABLE_OFFSET: 0.012,
-
-    /** Shadow offset below entity base Z (shadows appear below characters). */
-    SHADOW_OFFSET: -0.001,
-} as const
-
-/**
- * Shadow constants
- */
-export const SHADOW_CONSTANTS = {
-    /** Shadow radius as a fraction of tileWidth */
-    RADIUS_MULTIPLIER: 0.4,
-
-    /** Y offset in world units as a fraction of one tile width. */
-    Y_OFFSET_TILES: -0.9,
-
-    /** Shadow opacity (semi-transparent) */
-    OPACITY: 0.4,
-
-    /** Y-axis scale for elliptical perspective */
-    Y_SCALE: 0.6,
-
-    /** Minimum shadow size during jumps (30% of original) */
-    SCALE_MIN: 0.1,
-
-    /** Maximum jump height for scaling calculations */
-    MAX_JUMP_HEIGHT: 100,
-} as const
-
-/**
- * Nameplate constants
- */
-export const NAMEPLATE_CONSTANTS = {
-    /** Adjust nameplate position from base height */
-    BASE_Y_ADJUST: -1,
-    /** Extra pixels to raise when a head accessory is equipped */
-    HEAD_ACCESSORY_EXTRA_PX: 5,
-    /** Available background colors for nameplates */
-    BACKGROUND_COLORS: [
-        '#2d3748', // Default gray
-        '#dc2626', // Red
-        '#ea580c', // Orange
-        '#ca8a04', // Amber
-        '#16a34a', // Green
-        '#0891b2', // Cyan
-        '#2563eb', // Blue
-        '#7c3aed', // Purple
-        '#c026d3', // Pink
-        '#e11d48', // Rose
-        '#134e4a', // Dark teal
-        '#831843', // Dark pink
-    ],
-    /** Default background color */
-    DEFAULT_BACKGROUND_COLOR: '#2d3748',
-} as const
-
-/**
- * Particle system constants
- */
-export const LANDING_PARTICLES = {
-    /** Number of particles per landing */
-    COUNT: 6,
-
-    /** Base duration in ms */
-    DURATION: 500,
-
-    /** Spread radius as fraction of tileWidth */
-    SPREAD: 0.4,
-
-    /** Dust particle color */
-    COLOR: '#777',
-
-    /** Particle size in pixels in the game world */
-    SIZE: 3,
-
-    /** Vertical offset as a fraction of tile width (world units). */
-    Y_OFFSET_TILES: -0.9,
-} as const
-
-// ═══════════════════════════════════════════════════════════════════════
-// MAPS
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Map System Constants
- */
-export const MAP_CONSTANTS = {
-    /** Name of the Tiled layer containing map entry points */
-    ENTRY_POINT_LAYER_NAME: 'EntryPoints',
-
-    /** Name of the Tiled layer containing collision objects */
-    COLLISION_LAYER_NAME: 'Object Layer 1',
-
-    /** Name of the Tiled layer containing placeable objects */
-    PLACEABLE_AREA_LAYER_NAME: 'PlaceableArea',
-
-    /** Base path for tilesets */
-    TILESET_BASE_PATH: '/public/tilesets',
-} as const
-
-// ═══════════════════════════════════════════════════════════════════════
-// PHYSICS & MOVEMENT
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Player movement and physics constants
- */
-export const PLAYER_PHYSICS = {
-    /** Initial upward velocity when jumping (pixels per second) */
-    JUMP_FORCE: 150,
-
-    /** Downward acceleration due to gravity (pixels per second^2) */
-    GRAVITY: -450,
-} as const
-
-/**
- * Bunny hop (jump queuing) constants – Counter-Strike style mechanics.
- */
-export const BUNNY_HOP = {
-    /** Base time window (ms) within which a queued jump is valid. */
-    QUEUE_WINDOW_MS: 100,
-
-    /** Downward velocity threshold (px/s) to allow jump queuing. */
-    FALL_SPEED_THRESHOLD: -50,
-
-    /** Vertical offset threshold (px) to allow queuing close to ground. */
-    CLOSE_TO_GROUND_THRESHOLD: 30,
-
-    /** Speed increase per successful hop. */
-    SPEED_INCREMENT: 0.15,
-
-    /** Maximum total speed multiplier. */
-    MAX_SPEED_MULTIPLIER: 5,
-
-    /** Multiplier applied to jump force on chained hops (slightly lower). */
-    HOP_JUMP_FORCE_MULTIPLIER: 0.95,
-} as const
-
-// ═══════════════════════════════════════════════════════════════════════
-// UI & UX
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Audio defaults
- */
-export const AUDIO_DEFAULTS = {
-    /** Master output volume */
-    MASTER_VOLUME: 0.5,
-
-    /** Background music enabled by default */
-    MUSIC_ENABLED: true,
-    /** Background music volume */
-    MUSIC_VOLUME: 0.5,
-
-    /** Sound effects enabled by default */
-    SFX_ENABLED: true,
-    /** Sound effects volume */
-    SFX_VOLUME: 0.5,
-} as const
-
-/**
- * Toast Duration Constants
- * Centralized toast notification display durations in milliseconds.
- */
-export const TOAST_DURATION = {
-    /** Short duration for simple confirmations */
-    SHORT: 3000,
-
-    /** Standard duration for most notifications */
-    STANDARD: 5000,
-
-    /** Long duration for important notifications */
-    LONG: 8000,
-
-    /** Error message duration */
-    ERROR: 4000,
-} as const
-
-/**
- * Cache Control Headers
- * Centralized cache control strategies for different asset types and API responses.
- */
-export const CACHE_CONTROL = {
-    /** Immutable assets with content-based versioning (sprites, audio, etc.) */
-    IMMUTABLE: 'public, max-age=31536000, immutable',
-
-    /** JSON data - cached for 1 day in browser, 1 year in CDN */
-    JSON_DATA: 'public, max-age=86400, s-maxage=31536000, must-revalidate',
-
-    /** Character components API - cached for 1 hour in browser, 3 hours in CDN */
-    API_CHARACTER_COMPONENTS: 'public, max-age=21600, s-maxage=21600, stale-while-revalidate=3600',
-
-    /** Level configs API - cached for 1 hour in browser, 12 hours in CDN */
-    API_LEVEL_CONFIGS: 'public, max-age=3600, s-maxage=86400, stale-while-revalidate=120',
-
-    /** Sprite templates API - cached for 1 day in browser, 1 week in CDN */
-    API_SPRITE_TEMPLATES: 'public, max-age=86400, s-maxage=86400, stale-while-revalidate=3600',
-} as const
-
-// ═══════════════════════════════════════════════════════════════════════
-// CORE PLATFORM GAMES
-// ═══════════════════════════════════════════════════════════════════════
-
-/**
- * Core Game UUIDs - Canonical UUIDs for core platform games
- */
-export const CORE_GAME_UUIDS = {
-    /** Internal playground game for development and testing */
-    PLAYGROUND: '00000000-0000-0000-0000-000000000001',
-} as const

package/dist/constants/src/system.ts

@@ -1,10 +0,0 @@
-/**
- * System-Level Platform Constants
- *
- * Core platform settings that affect the entire system.
- */
-
-/**
- * Timezone for platform-wide operations
- */
-export const PLATFORM_TIMEZONE = 'America/New_York' as const