@playcademy/sandbox 0.1.9 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {
@@ -12,13 +12,9 @@
             "import": "./dist/cli.js",
             "types": "./dist/cli.d.ts"
         },
-        "./ports": {
-            "import": "./dist/utils/port.js",
-            "types": "./dist/utils/port.d.ts"
-        },
         "./config": {
-            "import": "./dist/config/index.js",
-            "types": "./dist/config/index.d.ts"
+            "import": "./dist/config.js",
+            "types": "./dist/config.d.ts"
         }
     },
     "bin": {
@@ -29,10 +25,10 @@
     ],
     "scripts": {
         "build": "bun run build.ts",
-        "dev": "bun --watch src/cli.ts",
+        "dev": "bun --watch src/cli",
+        "docs": "typedoc",
         "pub": "bun publish.ts",
-        "start": "bun src/cli.ts",
-        "docs": "typedoc"
+        "start": "bun src/cli.ts"
     },
     "dependencies": {
         "@electric-sql/pglite": "^0.3.2",
@@ -42,6 +38,7 @@
         "drizzle-orm": "^0.42.0",
         "hono": "^4.6.3",
         "jose": "^5.2.3",
+        "json-colorizer": "^3.0.1",
         "picocolors": "^1.1.1"
     },
     "devDependencies": {
@@ -53,7 +50,8 @@
         "@playcademy/timeback": "0.0.1",
         "@types/bun": "latest",
         "aws-jwt-verify": "^5.1.0",
-        "yocto-spinner": "^0.2.2"
+        "rollup": "^4.50.2",
+        "rollup-plugin-dts": "^6.2.3"
     },
     "peerDependencies": {
         "typescript": "^5"

package/dist/config/index.d.ts

@@ -1,10 +0,0 @@
-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/mutators.d.ts

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

package/dist/config/timeback.d.ts

@@ -1,10 +0,0 @@
-/**
- * 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

@@ -1,23 +0,0 @@
-/**
- * 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,171 +0,0 @@
-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}-${string}-${string}-${string}-${string}`;
-    itemId: `${string}-${string}-${string}-${string}-${string}`;
-    quantity: number;
-}[];

package/dist/database/index.d.ts

@@ -1,6 +0,0 @@
-import { PGlite } from '@electric-sql/pglite';
-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/path-manager.d.ts

@@ -1,26 +0,0 @@
-/**
- * Database path configuration and management
- */
-export declare class DatabasePathManager {
-    private static readonly DEFAULT_DB_SUBPATH;
-    /**
-     * Find the nearest node_modules directory by walking up the directory tree
-     */
-    private static findNodeModulesPath;
-    /**
-     * Resolve the database path, using provided path or auto-discovering location
-     */
-    static resolveDatabasePath(customPath?: string): string;
-    /**
-     * Ensure database directory exists, removing any existing data for fresh start
-     */
-    static ensureDatabaseDirectory(dbPath: string): void;
-    /**
-     * Get debug information about the database path resolution
-     */
-    static getDebugInfo(customPath?: string): {
-        resolvedPath: string;
-        nodeModulesPath: string;
-        isCustomPath: boolean;
-    };
-}

package/dist/database/seed.d.ts

@@ -1,34 +0,0 @@
-import { setupDatabase } from '.';
-import type { ProjectInfo } from '../types';
-export declare function seedDemoData(db: Awaited<ReturnType<typeof setupDatabase>>): Promise<{
-    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;
-    xpRequired: number;
-    creditsReward: number;
-}[];
-export declare function seedCurrentProjectGame(db: Awaited<ReturnType<typeof setupDatabase>>, project: ProjectInfo): Promise<{
-    id: string;
-    createdAt: Date | null;
-    updatedAt: Date | null;
-    developerId: string | null;
-    slug: string;
-    displayName: string;
-    version: string;
-    gameType: "hosted" | "external";
-    assetBundleBase: string | null;
-    externalUrl: string | null;
-    platform: "web" | "godot" | "unity";
-    mapElementId: string | null;
-    metadata: import("@playcademy/data/tables").GameMetadata;
-} | undefined>;

package/dist/lib/auth.d.ts

@@ -1,10 +0,0 @@
-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,22 +0,0 @@
-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

@@ -1,17 +0,0 @@
-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

@@ -1,3 +0,0 @@
-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

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

package/dist/routes/currencies.d.ts

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

package/dist/routes/dev.d.ts

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

package/dist/routes/games.d.ts

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

package/dist/routes/health.d.ts

@@ -1,2 +0,0 @@
-import { Hono } from 'hono';
-export declare const healthRouter: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/routes/index.d.ts

@@ -1,20 +0,0 @@
-export { usersRouter } from './users';
-export { healthRouter } from './health';
-export { inventoryRouter } from './inventory';
-export { gamesRouter } from './games';
-export { manifestRouter } from './manifest';
-export { shopRouter } from './shop';
-export { itemsRouter } from './items';
-export { currenciesRouter } from './currencies';
-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/inventory.d.ts

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

package/dist/routes/items.d.ts

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

package/dist/routes/leaderboard.d.ts

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

package/dist/routes/levels.d.ts

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

package/dist/routes/lti.d.ts

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

package/dist/routes/manifest.d.ts

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

package/dist/routes/maps.d.ts

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

package/dist/routes/notifications.d.ts

@@ -1,3 +0,0 @@
-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

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

package/dist/routes/shop-listings.d.ts

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

package/dist/routes/shop.d.ts

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

package/dist/routes/sprite.d.ts

@@ -1,3 +0,0 @@
-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

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

package/dist/routes/users.d.ts

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

package/dist/types.d.ts

@@ -1,29 +0,0 @@
-import type { User } from '@playcademy/data/types';
-import type { TimebackConfig } from './config';
-import type { setupDatabase } from './database';
-export type HonoEnv = {
-    Variables: {
-        user: User | null;
-        db: Awaited<ReturnType<typeof setupDatabase>>;
-    };
-};
-export interface ProjectInfo {
-    slug: string;
-    displayName: string;
-    version: string;
-    description?: string;
-}
-export interface ServerOptions {
-    port: number;
-    project?: ProjectInfo;
-    verbose?: boolean;
-    quiet?: boolean;
-    seed?: boolean;
-    memoryOnly?: boolean;
-    logLevel?: 'debug' | 'info' | 'warn' | 'error';
-    realtime?: {
-        enabled?: boolean;
-        port?: number;
-    };
-    timeback?: Partial<TimebackConfig>;
-}