playcademy 0.14.33 → 0.15.0

package/dist/cli.js

@@ -2958,7 +2958,7 @@ import { join as join13 } from "path";
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "playcademy",
-  version: "0.14.32",
+  version: "0.14.34",
   type: "module",
   exports: {
     ".": {
@@ -3021,7 +3021,8 @@ var package_default2 = {
     "json-colorizer": "^3.0.1",
     jszip: "^3.10.1",
     miniflare: "^4.20251008.0",
-    open: "^10.2.0"
+    open: "^10.2.0",
+    ws: "^8.18.3"
   },
   devDependencies: {
     "@cloudflare/workers-types": "^4.20251011.0",
@@ -3031,6 +3032,7 @@ var package_default2 = {
     "@playcademy/timeback": "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"

package/dist/constants/src/domains.ts

@@ -37,6 +37,13 @@ export const GAME_WORKER_DOMAINS = {
     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
  */

package/dist/constants/src/timeback.ts

@@ -105,3 +105,13 @@ export const TIMEBACK_COMPONENT_RESOURCE_DEFAULTS = {
     sortOrder: 1,
     lessonType: 'quiz',
 } as const
+
+// ============================================================================
+// 2HL (Two-Hour Learning) Model
+// ============================================================================
+
+/**
+ * Daily XP threshold for the 2HL model.
+ * Students must earn this much XP daily to unlock non-enrolled games.
+ */
+export const DAILY_XP_THRESHOLD = 120

package/dist/index.d.ts

@@ -964,7 +964,6 @@ interface DeployedGameInfo {
     schemaSnapshot?: unknown;
     integrationKeys?: string[];
     integrationsHash?: string;
-    deployedSecrets?: string[];
 }
 interface GameStore {
     /** Staging environment game deployments, keyed by absolute project path */
@@ -1004,7 +1003,6 @@ interface DeploymentContext {
     previousResources?: string[];
     previousIntegrationKeys?: string[];
     previousIntegrationsHash?: string;
-    currentSecretKeys?: string[];
     isDryRun: boolean;
     deployBackend: boolean;
     forceBackend: boolean;
@@ -1024,7 +1022,6 @@ interface DeploymentChanges {
         changes: IntegrationConfigChange[];
     }>;
     schema?: boolean;
-    secrets?: boolean;
 }
 /**
  * Plan for what needs to be deployed
@@ -1063,8 +1060,6 @@ interface BackendDeploymentMetadata {
     integrationKeys: string[];
     /** Hash of integrations config (for detecting metadata changes) */
     integrationsHash: string | null;
-    /** Secret keys that have been deployed */
-    deployedSecrets?: string[];
     /** When this backend was deployed */
     deployedAt: string;
 }
@@ -1186,6 +1181,84 @@ interface DevServerOptions {
     customLogger?: PluginLogger;
 }
 
+/**
+ * Configuration differences between existing and new game state
+ */
+interface ConfigDiff {
+    displayName?: {
+        old: string;
+        new: string;
+    };
+    emoji?: {
+        old: string | undefined;
+        new: string | undefined;
+    };
+    description?: {
+        old: string | undefined;
+        new: string | undefined;
+    };
+    gameType?: {
+        old: string;
+        new: string;
+    };
+}
+/**
+ * Build deployment changes
+ */
+interface BuildDiff {
+    changed?: boolean;
+    previousSize?: number;
+    currentSize?: number;
+}
+/**
+ * Backend deployment changes
+ */
+interface BackendDiff {
+    changed?: boolean;
+    /** Routes that were added (e.g., ['/api/bucket']) */
+    addedRoutes?: string[];
+    /** Routes that were removed (e.g., ['/api/kv']) */
+    removedRoutes?: string[];
+    /** Resources that were added (e.g., ['database']) */
+    addedResources?: string[];
+    /** Resources that were removed (e.g., ['keyValue']) */
+    removedResources?: string[];
+    previousServerSize?: number;
+    currentServerSize?: number;
+    previousDbSize?: number;
+    currentDbSize?: number;
+    previousBundleSize?: number;
+    currentBundleSize?: number;
+    forced?: boolean;
+    schemaStatementCount?: number;
+}
+/**
+ * Integration changes
+ */
+interface IntegrationsDiff {
+    previousKeys?: string[];
+    currentKeys?: string[];
+    metadata?: Array<{
+        name: string;
+        changes: Array<{
+            label: string;
+            current: string;
+            next: string;
+            field: string;
+        }>;
+    }>;
+}
+/**
+ * Options for displaying deployment diff
+ */
+interface DeploymentDiffOptions {
+    diff: ConfigDiff;
+    noChanges?: boolean;
+    build?: BuildDiff;
+    backend?: BackendDiff;
+    integrations?: IntegrationsDiff;
+}
+
 /**
  * Engine Template System Types
  */
@@ -1278,6 +1351,41 @@ interface CallbackServerResult {
     error?: string;
 }
 
+/**
+ * KV command types
+ */
+/**
+ * Statistics about KV storage
+ */
+interface KeyStats {
+    /** Total number of keys */
+    totalKeys: number;
+    /** Total size in bytes */
+    totalSize: number;
+    /** Information about the largest key */
+    largestKey?: {
+        name: string;
+        size: number;
+    };
+    /** Keys grouped by prefix pattern */
+    prefixes: Record<string, number>;
+}
+/**
+ * Metadata about a specific key
+ */
+interface KeyMetadata {
+    /** The key name */
+    key: string;
+    /** Whether the key exists */
+    exists: boolean;
+    /** Size in bytes (if key exists) */
+    size?: number;
+    /** Parsed value */
+    value?: unknown;
+    /** Type of value stored */
+    valueType?: 'json' | 'string';
+}
+
 /**
  * @fileoverview Config Loader Types
  *
@@ -1293,6 +1401,46 @@ interface LoadConfigResult {
     configDir: string;
 }
 
+/**
+ * Log Streaming Types
+ */
+interface LogEntry {
+    timestamp: number;
+    scriptName: string;
+    outcome: string;
+    logs: Array<{
+        level: string;
+        message: unknown[];
+    }>;
+    exceptions: Array<{
+        name: string;
+        message: string;
+    }>;
+    request?: {
+        url: string;
+        method: string;
+    };
+    response?: {
+        status: number;
+    };
+}
+interface LogStreamUrlOptions {
+    /** Worker ID to stream logs from */
+    workerId: string;
+    /** Authentication token */
+    token: string;
+    /** Include recent log history */
+    history?: boolean;
+}
+interface LogStreamConfig {
+    /** WebSocket URL to connect to */
+    url: string;
+    /** Game slug (for display purposes) */
+    slug: string;
+    /** Environment (for display purposes) */
+    environment: 'staging' | 'production';
+}
+
 /**
  * Preview options
  */
@@ -1321,137 +1469,44 @@ interface PreviewResponse {
 }
 
 /**
- * Configuration differences between existing and new game state
- */
-interface ConfigDiff {
-    displayName?: {
-        old: string;
-        new: string;
-    };
-    emoji?: {
-        old: string | undefined;
-        new: string | undefined;
-    };
-    description?: {
-        old: string | undefined;
-        new: string | undefined;
-    };
-    gameType?: {
-        old: string;
-        new: string;
-    };
-}
-/**
- * Build deployment changes
- */
-interface BuildDiff {
-    changed?: boolean;
-    previousSize?: number;
-    currentSize?: number;
-}
-/**
- * Backend deployment changes
- */
-interface BackendDiff {
-    changed?: boolean;
-    /** Routes that were added (e.g., ['/api/bucket']) */
-    addedRoutes?: string[];
-    /** Routes that were removed (e.g., ['/api/kv']) */
-    removedRoutes?: string[];
-    /** Resources that were added (e.g., ['database']) */
-    addedResources?: string[];
-    /** Resources that were removed (e.g., ['keyValue']) */
-    removedResources?: string[];
-    previousServerSize?: number;
-    currentServerSize?: number;
-    previousDbSize?: number;
-    currentDbSize?: number;
-    previousBundleSize?: number;
-    currentBundleSize?: number;
-    forced?: boolean;
-    schemaStatementCount?: number;
-}
-/**
- * Integration changes
+ * Project directory info collected during init prompts.
+ * Directory is NOT created until scaffolding step.
  */
-interface IntegrationsDiff {
-    previousKeys?: string[];
-    currentKeys?: string[];
-    metadata?: Array<{
-        name: string;
-        changes: Array<{
-            label: string;
-            current: string;
-            next: string;
-            field: string;
-        }>;
-    }>;
+interface ProjectDirectoryInfo {
+    /** The resolved absolute path to the project directory */
+    targetDir: string;
+    /** Whether this directory needs to be created (doesn't exist yet) */
+    needsCreation: boolean;
+    /** Whether setup was cancelled by user */
+    cancelled: boolean;
 }
+
 /**
- * Secret changes
+ * Secret Command Types
+ *
+ * Options for secret management CLI commands.
  */
-interface SecretsDiff {
-    previousKeys?: string[];
-    currentKeys?: string[];
-}
 /**
- * Options for displaying deployment diff
+ * Base options shared by all secret commands.
  */
-interface DeploymentDiffOptions {
-    diff: ConfigDiff;
-    noChanges?: boolean;
-    build?: BuildDiff;
-    backend?: BackendDiff;
-    integrations?: IntegrationsDiff;
-    secrets?: SecretsDiff;
+interface SecretCommandOptions {
+    /** Environment (staging or production) */
+    env?: string;
 }
-
 /**
- * KV command types
+ * Options for the `secret set` command.
  */
+type SecretSetOptions = SecretCommandOptions;
 /**
- * Statistics about KV storage
+ * Options for the `secret list` command.
  */
-interface KeyStats {
-    /** Total number of keys */
-    totalKeys: number;
-    /** Total size in bytes */
-    totalSize: number;
-    /** Information about the largest key */
-    largestKey?: {
-        name: string;
-        size: number;
-    };
-    /** Keys grouped by prefix pattern */
-    prefixes: Record<string, number>;
-}
+type SecretListOptions = SecretCommandOptions;
 /**
- * Metadata about a specific key
+ * Options for the `secret delete` command.
  */
-interface KeyMetadata {
-    /** The key name */
-    key: string;
-    /** Whether the key exists */
-    exists: boolean;
-    /** Size in bytes (if key exists) */
-    size?: number;
-    /** Parsed value */
-    value?: unknown;
-    /** Type of value stored */
-    valueType?: 'json' | 'string';
-}
-
-/**
- * Project directory info collected during init prompts.
- * Directory is NOT created until scaffolding step.
- */
-interface ProjectDirectoryInfo {
-    /** The resolved absolute path to the project directory */
-    targetDir: string;
-    /** Whether this directory needs to be created (doesn't exist yet) */
-    needsCreation: boolean;
-    /** Whether setup was cancelled by user */
-    cancelled: boolean;
+interface SecretDeleteOptions extends SecretCommandOptions {
+    /** Skip confirmation prompt */
+    force?: boolean;
 }
 
-export type { ApiConfig, ApiErrorResponse, ApiKeyListItem, ApiKeyWithSecret, ApiRequestOptions, AuthProfile, AuthStore, AuthStrategy, BackendBundle, BackendDeploymentMetadata, BackendDiff, BackendFeatures, BucketBulkOptions, BucketDeleteOptions, BucketGetOptions, BucketListOptions, BucketPutOptions, BuildDiff, BulkCollectionResult, BundleOptions, CallbackServerResult, CollectedFile, ComponentConfig, ComponentResourceConfig, ConfigDiff, CreateApiKeyResponse, CustomRoutesIntegrationOptions, DatabaseIntegrationOptions, DeployConfig, DeployNewGameOptions, DeployedGameInfo, DeploymentChanges, DeploymentContext, DeploymentDiffOptions, DeploymentPlan, DeploymentResult, DevServerOptions, EmbeddedSourcePaths, EngineConfig, EngineType, EnvironmentAuthProfiles, GameStore, IntegrationChangeDetector, IntegrationChangeDetectors, IntegrationConfigChange, IntegrationsConfig, IntegrationsDiff, KeyMetadata, KeyStats, LoadConfigResult, LoginCredentials, LoginResponse, OrganizationConfig, PlaycademyConfig, PluginLogger, PreviewOptions, PreviewResponse, ProjectDirectoryInfo, ResourceConfig, ScaffoldResult, SecretsDiff, SignInResponse, SsoCallbackData, Template, TemplateFramework, TemplateHook, TemplateHookOptions, TemplateSource, TimebackBaseConfig, TimebackCourseConfig, TimebackCourseConfigWithOverrides, TimebackGrade, TimebackIntegrationConfig, TimebackSourcedIds, TimebackSubject, TokenType, UpdateExistingGameOptions };
+export type { ApiConfig, ApiErrorResponse, ApiKeyListItem, ApiKeyWithSecret, ApiRequestOptions, AuthProfile, AuthStore, AuthStrategy, BackendBundle, BackendDeploymentMetadata, BackendDiff, BackendFeatures, BucketBulkOptions, BucketDeleteOptions, BucketGetOptions, BucketListOptions, BucketPutOptions, BuildDiff, BulkCollectionResult, BundleOptions, CallbackServerResult, CollectedFile, ComponentConfig, ComponentResourceConfig, ConfigDiff, CreateApiKeyResponse, CustomRoutesIntegrationOptions, DatabaseIntegrationOptions, DeployConfig, DeployNewGameOptions, DeployedGameInfo, DeploymentChanges, DeploymentContext, DeploymentDiffOptions, DeploymentPlan, DeploymentResult, DevServerOptions, EmbeddedSourcePaths, EngineConfig, EngineType, EnvironmentAuthProfiles, GameStore, IntegrationChangeDetector, IntegrationChangeDetectors, IntegrationConfigChange, IntegrationsConfig, IntegrationsDiff, KeyMetadata, KeyStats, LoadConfigResult, LogEntry, LogStreamConfig, LogStreamUrlOptions, LoginCredentials, LoginResponse, OrganizationConfig, PlaycademyConfig, PluginLogger, PreviewOptions, PreviewResponse, ProjectDirectoryInfo, ResourceConfig, ScaffoldResult, SecretCommandOptions, SecretDeleteOptions, SecretListOptions, SecretSetOptions, SignInResponse, SsoCallbackData, Template, TemplateFramework, TemplateHook, TemplateHookOptions, TemplateSource, TimebackBaseConfig, TimebackCourseConfig, TimebackCourseConfigWithOverrides, TimebackGrade, TimebackIntegrationConfig, TimebackSourcedIds, TimebackSubject, TokenType, UpdateExistingGameOptions };