@playcademy/sandbox 0.1.0-beta.8 → 0.1.0

package/dist/constants.d.ts

@@ -1,11 +1,158 @@
-import type { Item, User } from '@playcademy/data/schemas';
-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;
+    };
+};
+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 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/index.d.ts

@@ -1,5 +1,5 @@
 import { PGlite } from '@electric-sql/pglite';
-import * as schema from '@playcademy/data/schemas';
+import * as schema from '@playcademy/data/tables';
 import type { PgliteDatabase } from 'drizzle-orm/pglite';
 export declare function setupDatabase(customPath?: string): Promise<PgliteDatabase<typeof schema> & {
     $client: PGlite;

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,5 @@
 import type { Context, Next } from 'hono';
+/**
+ * Setup authentication middleware for sandbox
+ */
 export declare function setupAuth(): (c: Context, next: Next) => Promise<void>;

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/sandbox").SandboxRealtimeServer | null;
+    stop: () => void;
+}>;
 export declare const version: string;