@playcademy/sandbox 0.1.0-beta.9 → 0.1.1

package/dist/config/index.d.ts

@@ -0,0 +1,10 @@
+import type { SandboxConfig } from './types';
+/**
+ * Sandbox Configuration
+ *
+ * Loads configuration from environment variables.
+ */
+export type { AuthConfig, SandboxConfig, TimebackConfig, TimebackMode } from './types';
+export { setEmbeddedMode } from './mutators';
+export { configureTimeback, hasTimebackCredentials, hasTimebackFullConfig, isTimebackEnabled, requireTimebackCredentials, } from './timeback';
+export declare const config: SandboxConfig;

package/dist/config/index.js

@@ -0,0 +1,150 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/config/timeback.ts
+function getTimebackMode() {
+  const explicit = process.env.TIMEBACK_MODE;
+  if (explicit === "local" || explicit === "remote" || explicit === "disabled")
+    return explicit;
+  if (process.env.TIMEBACK_LOCAL === "true")
+    return "local";
+  if (process.env.TIMEBACK_API_CLIENT_ID)
+    return "remote";
+  return "disabled";
+}
+function isTimebackEnabled() {
+  return config.timeback.mode !== "disabled";
+}
+function hasTimebackCredentials() {
+  const { mode, onerosterApiUrl, caliperApiUrl, clientId, clientSecret, authUrl } = config.timeback;
+  if (mode === "local") {
+    return !!(onerosterApiUrl && caliperApiUrl);
+  }
+  if (mode === "remote") {
+    return !!(onerosterApiUrl && clientId && clientSecret && authUrl);
+  }
+  return false;
+}
+function hasTimebackFullConfig() {
+  return hasTimebackCredentials() && !!(config.timeback.courseId && config.timeback.studentId);
+}
+function requireTimebackCredentials() {
+  if (hasTimebackCredentials())
+    return config.timeback;
+  const { mode, onerosterApiUrl, caliperApiUrl, clientId, clientSecret, authUrl } = config.timeback;
+  if (mode === "local") {
+    const missing2 = [];
+    if (!onerosterApiUrl)
+      missing2.push("TIMEBACK_ONEROSTER_API_URL");
+    if (!caliperApiUrl)
+      missing2.push("TIMEBACK_CALIPER_API_URL");
+    throw new Error(`TimeBack local mode missing: ${missing2.join(", ")}`);
+  }
+  const missing = [];
+  if (!onerosterApiUrl)
+    missing.push("TIMEBACK_ONEROSTER_API_URL");
+  if (!clientId)
+    missing.push("TIMEBACK_API_CLIENT_ID");
+  if (!clientSecret)
+    missing.push("TIMEBACK_API_CLIENT_SECRET");
+  if (!authUrl)
+    missing.push("TIMEBACK_API_AUTH_URL");
+  throw new Error(`TimeBack credentials missing: ${missing.join(", ")}`);
+}
+function configureTimeback(options) {
+  if (options.mode) {
+    config.timeback.mode = options.mode;
+    process.env.TIMEBACK_MODE = options.mode;
+  }
+  if (options.onerosterApiUrl) {
+    config.timeback.onerosterApiUrl = options.onerosterApiUrl;
+    process.env.TIMEBACK_ONEROSTER_API_URL = options.onerosterApiUrl;
+  }
+  if (options.caliperApiUrl) {
+    config.timeback.caliperApiUrl = options.caliperApiUrl;
+    process.env.TIMEBACK_CALIPER_API_URL = options.caliperApiUrl;
+  }
+  if (options.clientId) {
+    config.timeback.clientId = options.clientId;
+    process.env.TIMEBACK_API_CLIENT_ID = options.clientId;
+  }
+  if (options.clientSecret) {
+    config.timeback.clientSecret = options.clientSecret;
+    process.env.TIMEBACK_API_CLIENT_SECRET = options.clientSecret;
+  }
+  if (options.authUrl) {
+    config.timeback.authUrl = options.authUrl;
+    process.env.TIMEBACK_API_AUTH_URL = options.authUrl;
+  }
+  if (options.courseId) {
+    config.timeback.courseId = options.courseId;
+    process.env.SANDBOX_TIMEBACK_COURSE_ID = options.courseId;
+  }
+  if (options.studentId) {
+    config.timeback.studentId = options.studentId;
+    process.env.SANDBOX_TIMEBACK_STUDENT_ID = options.studentId;
+  }
+}
+
+// src/config/mutators.ts
+function setEmbeddedMode(embedded) {
+  config.embedded = embedded;
+  process.env.PLAYCADEMY_EMBEDDED = embedded ? "1" : undefined;
+}
+
+// src/config/index.ts
+var config = {
+  embedded: process.env.PLAYCADEMY_EMBEDDED === "1",
+  auth: {
+    betterAuthSecret: process.env.BETTER_AUTH_SECRET || "sandbox-better-auth-secret-for-testing",
+    gameJwtSecret: process.env.GAME_JWT_SECRET || "sandbox-game-jwt-secret-for-testing"
+  },
+  timeback: {
+    mode: getTimebackMode(),
+    onerosterApiUrl: process.env.TIMEBACK_ONEROSTER_API_URL,
+    caliperApiUrl: process.env.TIMEBACK_CALIPER_API_URL,
+    clientId: process.env.TIMEBACK_API_CLIENT_ID,
+    clientSecret: process.env.TIMEBACK_API_CLIENT_SECRET,
+    authUrl: process.env.TIMEBACK_API_AUTH_URL,
+    courseId: process.env.SANDBOX_TIMEBACK_COURSE_ID,
+    studentId: process.env.SANDBOX_TIMEBACK_STUDENT_ID
+  }
+};
+process.env.BETTER_AUTH_SECRET = config.auth.betterAuthSecret;
+process.env.GAME_JWT_SECRET = config.auth.gameJwtSecret;
+export {
+  setEmbeddedMode,
+  requireTimebackCredentials,
+  isTimebackEnabled,
+  hasTimebackFullConfig,
+  hasTimebackCredentials,
+  configureTimeback,
+  config
+};

package/dist/config/mutators.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Configuration Mutation Functions
+ */
+export declare function setEmbeddedMode(embedded: boolean): void;

package/dist/config/timeback.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TimeBack Configuration Helpers
+ */
+import type { TimebackConfig, TimebackMode } from './types';
+export declare function getTimebackMode(): TimebackMode;
+export declare function isTimebackEnabled(): boolean;
+export declare function hasTimebackCredentials(): boolean;
+export declare function hasTimebackFullConfig(): boolean;
+export declare function requireTimebackCredentials(): TimebackConfig;
+export declare function configureTimeback(options: Partial<TimebackConfig>): void;

package/dist/config/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Configuration Type Definitions
+ */
+export type TimebackMode = 'local' | 'remote' | 'disabled';
+export interface TimebackConfig {
+    mode: TimebackMode;
+    onerosterApiUrl?: string;
+    caliperApiUrl?: string;
+    clientId?: string;
+    clientSecret?: string;
+    authUrl?: string;
+    courseId?: string;
+    studentId?: string;
+}
+export interface AuthConfig {
+    betterAuthSecret: string;
+    gameJwtSecret: string;
+}
+export interface SandboxConfig {
+    embedded: boolean;
+    auth: AuthConfig;
+    timeback: TimebackConfig;
+}

package/dist/constants.d.ts

@@ -1,11 +1,171 @@
-import type { Item, User } from '@playcademy/data/types';
-export declare const DEMO_USER: User;
-export declare const DEMO_TOKEN = "demo-token";
+import type { Item } from '@playcademy/data/types';
+export declare const DEMO_USERS: {
+    readonly admin: {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Admin User";
+        readonly username: "admin_user";
+        readonly email: "admin@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "admin";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly player: {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Player User";
+        readonly username: "player_user";
+        readonly email: "player@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "player";
+        readonly developerStatus: "none";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly developer: {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Developer User";
+        readonly username: "developer_user";
+        readonly email: "developer@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "developer";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly pendingDeveloper: {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Pending Developer";
+        readonly username: "pending_dev";
+        readonly email: "pending@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "developer";
+        readonly developerStatus: "pending";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly unverifiedPlayer: {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Unverified Player";
+        readonly username: "unverified_player";
+        readonly email: "unverified@playcademy.com";
+        readonly emailVerified: false;
+        readonly image: null;
+        readonly role: "player";
+        readonly developerStatus: "none";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+};
+export declare const DEMO_TOKENS: {
+    readonly 'sandbox-demo-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Admin User";
+        readonly username: "admin_user";
+        readonly email: "admin@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "admin";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'sandbox-admin-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Admin User";
+        readonly username: "admin_user";
+        readonly email: "admin@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "admin";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'sandbox-player-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Player User";
+        readonly username: "player_user";
+        readonly email: "player@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "player";
+        readonly developerStatus: "none";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'sandbox-developer-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Developer User";
+        readonly username: "developer_user";
+        readonly email: "developer@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "developer";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'sandbox-pending-dev-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Pending Developer";
+        readonly username: "pending_dev";
+        readonly email: "pending@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "developer";
+        readonly developerStatus: "pending";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'sandbox-unverified-token': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Unverified Player";
+        readonly username: "unverified_player";
+        readonly email: "unverified@playcademy.com";
+        readonly emailVerified: false;
+        readonly image: null;
+        readonly role: "player";
+        readonly developerStatus: "none";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+    readonly 'mock-game-token-for-local-dev': {
+        readonly id: `${string}-${string}-${string}-${string}-${string}`;
+        readonly name: "Admin User";
+        readonly username: "admin_user";
+        readonly email: "admin@playcademy.com";
+        readonly emailVerified: true;
+        readonly image: null;
+        readonly role: "admin";
+        readonly developerStatus: "approved";
+        readonly createdAt: Date;
+        readonly updatedAt: Date;
+    };
+};
+export declare const DEMO_USER: {
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly name: "Admin User";
+    readonly username: "admin_user";
+    readonly email: "admin@playcademy.com";
+    readonly emailVerified: true;
+    readonly image: null;
+    readonly role: "admin";
+    readonly developerStatus: "approved";
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+};
+export declare const DEMO_TOKEN = "sandbox-demo-token";
+export declare const MOCK_GAME_ID = "mock-game-id-from-template";
 export declare const PLAYCADEMY_CREDITS_ID: `${string}-${string}-${string}-${string}-${string}`;
 export declare const SAMPLE_ITEMS: Omit<Item, 'createdAt'>[];
 export declare const SAMPLE_INVENTORY: {
     id: `${string}-${string}-${string}-${string}-${string}`;
-    userId: string;
+    userId: `${string}-${string}-${string}-${string}-${string}`;
     itemId: `${string}-${string}-${string}-${string}-${string}`;
     quantity: number;
 }[];

package/dist/database/seed.d.ts

@@ -1,16 +1,16 @@
 import { setupDatabase } from '.';
 import type { ProjectInfo } from '../types';
 export declare function seedDemoData(db: Awaited<ReturnType<typeof setupDatabase>>): Promise<{
-    id: string;
-    name: string;
-    username: string | null;
-    email: string;
-    emailVerified: boolean;
-    image: string | null;
-    role: "admin" | "player" | "developer";
-    developerStatus: "none" | "pending" | "approved";
-    createdAt: Date;
-    updatedAt: Date;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly name: "Admin User";
+    readonly username: "admin_user";
+    readonly email: "admin@playcademy.com";
+    readonly emailVerified: true;
+    readonly image: null;
+    readonly role: "admin";
+    readonly developerStatus: "approved";
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
 }>;
 export declare function generateLevelConfigs(): {
     level: number;
@@ -21,12 +21,14 @@ export declare function seedCurrentProjectGame(db: Awaited<ReturnType<typeof set
     id: string;
     createdAt: Date | null;
     updatedAt: Date | null;
-    displayName: string;
     developerId: string | null;
     slug: string;
+    displayName: string;
     version: string;
-    assetBundleBase: string;
+    gameType: "hosted" | "external";
+    assetBundleBase: string | null;
+    externalUrl: string | null;
     platform: "web" | "godot" | "unity";
     mapElementId: string | null;
-    metadata: unknown;
+    metadata: import("@playcademy/data/tables").GameMetadata;
 } | undefined>;

package/dist/lib/auth.d.ts

@@ -1,2 +1,10 @@
-import type { Context, Next } from 'hono';
-export declare function setupAuth(): (c: Context, next: Next) => Promise<void>;
+import type { MiddlewareHandler } from 'hono';
+export interface SetupAuthOptions {
+    /** Paths that don't require authentication */
+    exceptions?: string[];
+}
+/**
+ * Setup authentication middleware for sandbox
+ * Accepts both Bearer tokens (for user auth) and x-api-key (for server-to-server)
+ */
+export declare function setupAuth(options?: SetupAuthOptions): MiddlewareHandler;

package/dist/lib/error-handler.d.ts

@@ -1,2 +1,22 @@
+import { ApiError } from '@playcademy/api-core/errors';
 import type { Context } from 'hono';
+/**
+ * Create a standardized error response that matches the API contract
+ */
+export declare function createErrorResponse(error: ApiError): {
+    error: {
+        code: string;
+        message: string;
+        details: unknown;
+    };
+};
+/**
+ * Create a standardized error response for unknown errors
+ */
+export declare function createUnknownErrorResponse(error: unknown): {
+    error: {
+        code: string;
+        message: string;
+    };
+};
 export declare function handleApiError(c: Context, error: unknown): Response;

package/dist/lib/realtime.d.ts

@@ -0,0 +1,17 @@
+import { createRealtimeServer } from '@playcademy/realtime/server';
+import type { SandboxRealtimeServer } from '@playcademy/realtime/server/sandbox';
+import type { ServerOptions } from '../types';
+/**
+ * Starts the realtime server with sandbox-specific configuration.
+ *
+ * This function handles:
+ * - Conditional startup based on options
+ * - Sandbox-specific authentication secrets
+ * - Quiet mode for clean embedded logging
+ * - Error handling with graceful degradation
+ *
+ * @param realtimeOptions - Realtime configuration from ServerOptions
+ * @param betterAuthSecret - Authentication secret for realtime server
+ * @returns Promise resolving to realtime server instance or null
+ */
+export declare function startRealtimeServer(realtimeOptions: NonNullable<ServerOptions['realtime']>, betterAuthSecret: string): Promise<SandboxRealtimeServer | Awaited<ReturnType<typeof createRealtimeServer>> | null>;

package/dist/routes/achievements.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const achievementsRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/character.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const characterRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/index.d.ts

@@ -10,3 +10,11 @@ export { mapRouter, mapsRouter } from './maps';
 export { shopListingsRouter } from './shop-listings';
 export { devRouter } from './dev';
 export { levelsRouter } from './levels';
+export { leaderboardRouter } from './leaderboard';
+export { realtimeRouter } from './realtime';
+export { characterRouter } from './character';
+export { spriteRouter } from './sprite';
+export { timebackRouter } from './timeback';
+export { achievementsRouter } from './achievements';
+export { ltiRouter } from './lti';
+export { notificationsRouter } from './notifications';

package/dist/routes/leaderboard.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const leaderboardRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/lti.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const ltiRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/notifications.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const notificationsRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/realtime.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const realtimeRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/sprite.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const spriteRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/timeback.d.ts

@@ -0,0 +1,3 @@
+import { Hono } from 'hono';
+import type { HonoEnv } from '../types';
+export declare const timebackRouter: Hono<HonoEnv, import("hono/types").BlankSchema, "/">;

package/dist/server.d.ts

@@ -1,3 +1,7 @@
-import type { ServerOptions } from './types';
-export declare function startServer(options: ServerOptions): Promise<import("@hono/node-server").ServerType>;
+import type { ProjectInfo, ServerOptions } from './types';
+export declare function startServer(port: number, project?: ProjectInfo, options?: Omit<ServerOptions, 'port' | 'project'>): Promise<{
+    main: import("@hono/node-server").ServerType;
+    realtime: Bun.Server<import("@playcademy/realtime/server").WebSocketData> | import("@playcademy/realtime/server/sandbox").SandboxRealtimeServer | null;
+    stop: () => void;
+}>;
 export declare const version: string;