@playcademy/sandbox 0.3.6 → 0.3.8

package/dist/infrastructure/api/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Sandbox API Infrastructure
+ *
+ * Exports the handle and handleStream functions for use in Hono routes.
+ *
+ * @example
+ * ```ts
+ * // In route setup
+ * import { currencies } from '@playcademy/api-core/controllers'
+ * import { handle } from '../infrastructure/api'
+ *
+ * router.get('/currencies', handle(currencies.list))
+ * router.post('/currencies', handle(currencies.create, { status: 201 }))
+ * ```
+ */
+import { createHandlers } from '@playcademy/api-hono';
+/**
+ * Wrap a controller function into a Hono request handler.
+ *
+ * IMPORTANT: This returns a function that looks up handlers at REQUEST time,
+ * not at route registration time. This is critical because route modules are
+ * cached by the module system, but we need each sandbox to use its own handlers.
+ *
+ * @example
+ * ```ts
+ * import { currencies } from '@playcademy/api-core/controllers'
+ * import { handle } from '../infrastructure/api'
+ *
+ * router.get('/currencies', handle(currencies.list))
+ * router.post('/currencies', handle(currencies.create, { status: 201 }))
+ * ```
+ */
+export declare function handle(...args: Parameters<ReturnType<typeof createHandlers>[0]>): ReturnType<ReturnType<typeof createHandlers>[0]>;
+/**
+ * Wrap a streaming controller function into a Hono request handler.
+ *
+ * IMPORTANT: This returns a function that looks up handlers at REQUEST time,
+ * not at route registration time. This is critical because route modules are
+ * cached by the module system, but we need each sandbox to use its own handlers.
+ *
+ * @example
+ * ```ts
+ * import { deploy } from '@playcademy/api-core/controllers'
+ * import { handleStream } from '../infrastructure/api'
+ *
+ * router.post('/games/:slug/deploy', handleStream(deploy.deploy))
+ * ```
+ */
+export declare function handleStream(...args: Parameters<ReturnType<typeof createHandlers>[1]>): ReturnType<ReturnType<typeof createHandlers>[1]>;
+/**
+ * Reset the handlers (for testing or hot reload).
+ */
+export declare function resetHandlers(): void;
+export { createSandboxContext, getSandboxContext, resetSandboxContext } from './context';

package/dist/infrastructure/api/providers/auth.provider.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Sandbox Auth Provider
+ *
+ * Simplified auth for local development. No real JWT signing/verification -
+ * uses demo tokens and simple base64 encoding.
+ *
+ * @module infrastructure/api/providers/auth
+ */
+import type { AuthProvider } from '@playcademy/api-core/providers';
+/**
+ * Create a sandbox auth provider.
+ *
+ * Uses demo tokens and simple encoding instead of real JWT signing.
+ */
+export declare function createSandboxAuthProvider(): AuthProvider;
+/**
+ * Get a demo user for sandbox auth.
+ */
+export declare function getDemoUser(role?: 'admin' | 'developer' | 'player'): {
+    readonly id: "00000000-0000-0000-0000-000000000003";
+    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 id: "00000000-0000-0000-0000-000000000001";
+    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 id: "00000000-0000-0000-0000-000000000002";
+    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;
+};

package/dist/infrastructure/api/providers/cache.provider.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sandbox Cache Provider
+ *
+ * In-memory cache for local development. Simple TTL-based expiration.
+ *
+ * @module infrastructure/api/providers/cache
+ */
+import type { CacheProvider } from '@playcademy/api-core/providers';
+/**
+ * Create a sandbox cache provider.
+ *
+ * Uses in-memory storage with TTL support.
+ */
+export declare function createSandboxCacheProvider(): CacheProvider;
+/**
+ * Clear all sandbox cache (useful for testing).
+ */
+export declare function clearSandboxCache(): void;

package/dist/infrastructure/api/providers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sandbox Provider Implementations
+ *
+ * In-memory implementations of api-core provider interfaces for local development.
+ *
+ * @module infrastructure/api/providers
+ */
+export { createSandboxAuthProvider, getDemoUser } from './auth.provider';
+export { createSandboxCacheProvider, clearSandboxCache } from './cache.provider';
+export { createSandboxSecretsProvider, clearSandboxSecrets } from './secrets.provider';
+export { createSandboxStorageProvider, clearSandboxStorage } from './storage.provider';

package/dist/infrastructure/api/providers/secrets.provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sandbox Secrets Provider
+ *
+ * In-memory secrets storage for local development. Secrets are not persisted
+ * across restarts - this is intentional for sandbox simplicity.
+ *
+ * @module infrastructure/api/providers/secrets
+ */
+import type { SecretsProvider } from '@playcademy/api-core/providers';
+/**
+ * Create a sandbox secrets provider.
+ *
+ * Uses in-memory storage. Secrets are lost on restart.
+ */
+export declare function createSandboxSecretsProvider(): SecretsProvider;
+/**
+ * Clear all sandbox secrets (useful for testing).
+ */
+export declare function clearSandboxSecrets(): void;

package/dist/infrastructure/api/providers/storage.provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sandbox Storage Provider
+ *
+ * In-memory storage for local development. File uploads are not persisted
+ * across restarts - this is intentional for sandbox simplicity.
+ *
+ * @module infrastructure/api/providers/storage
+ */
+import type { StorageProvider } from '@playcademy/api-core/providers';
+/**
+ * Create a sandbox storage provider.
+ *
+ * Uses in-memory storage. Data is lost on restart.
+ */
+export declare function createSandboxStorageProvider(): StorageProvider;
+/**
+ * Clear all sandbox storage (useful for testing).
+ */
+export declare function clearSandboxStorage(): void;

package/dist/mocks/timeback.d.ts

@@ -4,7 +4,8 @@
  * Pure mock data generators for local development.
  * Used by route handlers when mock mode is enabled.
  */
-import type { AuthenticatedUser, GameUser, TimebackStudentProfile, User, UserEnrollment, UserTimebackData } from '@playcademy/data/types';
+import type { User } from '@playcademy/sdk/types';
+import type { AuthenticatedUser, GameUser, TimebackStudentProfile, UserEnrollment, UserTimebackData } from '@playcademy/types/user';
 import type { DatabaseInstance } from '../types';
 /**
  * Check if TimeBack should return mock data instead of calling real APIs.
@@ -24,6 +25,11 @@ export declare function getMockEnrollments(db: DatabaseInstance): Promise<UserEn
  * Generate complete mock TimeBack data for a user.
  */
 export declare function getMockTimebackData(db: DatabaseInstance, timebackId: string, gameId?: string): Promise<UserTimebackData>;
+/**
+ * Get mock timeback user data for the current sandbox user.
+ * Uses the configured timebackId from sandbox config.
+ */
+export declare function getMockTimebackUser(db: DatabaseInstance, gameId?: string): Promise<UserTimebackData>;
 /**
  * Build a complete user response with mock timeback data.
  * Used to bypass api-core when in mock mode (avoids real API calls).

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import * as _hono_node_server from '@hono/node-server';
-import { TimebackOrgType, TimebackUserRole } from '@playcademy/data/types';
+import { TimebackOrgType, TimebackUserRole } from '@playcademy/types/user';
 
 /**
  * Configuration Type Definitions
@@ -288,7 +288,7 @@ declare const version: string;
  */
 declare function startServer(port: number, project?: ProjectInfo, options?: Omit<ServerOptions, 'port' | 'project'>): Promise<{
     main: _hono_node_server.ServerType;
-    timebackMode: "local" | "remote" | "mock" | null;
+    timebackMode: "local" | "mock" | "remote" | null;
     setRole: (role: TimebackUserRole) => void;
     stop: () => Promise<void>;
 }>;