@playcademy/sdk 0.0.1-beta.9 → 0.0.1

package/dist/types.d.ts

@@ -1,32 +1,170 @@
-import type { User, InventoryItemWithReward, Game, DeveloperKey, DeveloperStatusResponse, MapElement, Reward, InsertReward, ManifestV1, UpdateReward } from '@playcademy/types';
+export type * from '@playcademy/data/types';
+export { CURRENCIES, BADGES } from '@playcademy/data/constants';
+export type { PlaycademyClient } from './core/client';
 export interface ClientConfig {
     baseUrl: string;
     token?: string;
     gameId?: string;
 }
+export declare const AuthProvider: {
+    readonly TIMEBACK: "TIMEBACK";
+};
+export type AuthProviderType = (typeof AuthProvider)[keyof typeof AuthProvider];
+export interface AuthOptions {
+    /** The identity provider to use for authentication */
+    provider: AuthProviderType;
+    /** The OAuth callback URL where your server handles the callback */
+    callbackUrl: string;
+    /** Authentication mode - auto detects best option based on context */
+    mode?: 'auto' | 'popup' | 'redirect';
+    /** Callback for authentication state changes */
+    onStateChange?: (state: AuthStateUpdate) => void;
+    /** Custom OAuth configuration (for users embedding the SDK outside of the Playcademy platform) */
+    oauth?: {
+        clientId: string;
+        authorizationEndpoint?: string;
+        tokenEndpoint?: string;
+        scope?: string;
+    };
+    /**
+     * Optional custom data to encode in OAuth state parameter.
+     * By default, the SDK automatically includes playcademy_user_id and game_id.
+     * Use this to add additional custom data if needed.
+     */
+    stateData?: Record<string, string>;
+}
+export interface AuthStateUpdate {
+    /** Current status of the authentication flow */
+    status: 'opening_popup' | 'exchanging_token' | 'complete' | 'error';
+    /** Human-readable message about the current state */
+    message: string;
+    /** Error details if status is 'error' */
+    error?: Error;
+}
+export interface AuthResult {
+    /** Whether authentication was successful */
+    success: boolean;
+    /** User information if authentication was successful */
+    user?: UserInfo;
+    /** Error if authentication failed */
+    error?: Error;
+}
+export interface UserInfo {
+    /** Unique user identifier (sub claim from JWT) */
+    sub: string;
+    /** User's email address */
+    email: string;
+    /** User's display name */
+    name: string;
+    /** Whether the email has been verified */
+    email_verified: boolean;
+    /** Additional user attributes from the identity provider */
+    [key: string]: unknown;
+}
+/**
+ * Authentication state change event payload.
+ * Used when authentication state changes in the application.
+ */
+export interface AuthStateChangePayload {
+    /** Whether the user is currently authenticated */
+    authenticated: boolean;
+    /** User information if authenticated, null otherwise */
+    user: UserInfo | null;
+    /** Error information if authentication failed */
+    error: Error | null;
+}
+/**
+ * OAuth callback event payload.
+ * Used when OAuth flow completes in popup/new-tab windows.
+ */
+export interface AuthCallbackPayload {
+    /** OAuth authorization code */
+    code: string;
+    /** OAuth state parameter for CSRF protection */
+    state: string;
+    /** Error message if OAuth flow failed */
+    error: string | null;
+}
+/**
+ * Message sent from server callback to opener window.
+ * This is the standardized format from our server-first architecture.
+ */
+export interface AuthServerMessage {
+    /** Type of the message */
+    type: 'PLAYCADEMY_AUTH_STATE_CHANGE';
+    /** Whether the user is currently authenticated */
+    authenticated: boolean;
+    /** Whether the authentication was successful */
+    success: boolean;
+    /** Timestamp of the message */
+    ts: number;
+    /** User information if authentication was successful */
+    user?: UserInfo;
+    /** Error message if authentication failed */
+    error?: string;
+}
+/**
+ * Token refresh event payload.
+ * Sent when authentication token is updated.
+ */
+export interface TokenRefreshPayload {
+    /** New authentication token */
+    token: string;
+    /** Token expiration timestamp */
+    exp: number;
+}
+/**
+ * Telemetry event payload.
+ * Performance metrics sent from the game.
+ */
+export interface TelemetryPayload {
+    /** Frames per second */
+    fps: number;
+    /** Memory usage in MB */
+    mem: number;
+}
+/**
+ * Keyboard event payload.
+ * Key events forwarded from the game.
+ */
+export interface KeyEventPayload {
+    /** Key value (e.g., 'Escape', 'F1') */
+    key: string;
+    /** Key code (optional) */
+    code?: string;
+    /** Event type */
+    type: 'keydown' | 'keyup';
+}
 export interface ClientEvents {
     authChange: {
         token: string | null;
     };
     inventoryChange: {
-        rewardId: string;
+        itemId: string;
         delta: number;
         newTotal: number;
     };
+    levelUp: {
+        oldLevel: number;
+        newLevel: number;
+        creditsAwarded: number;
+    };
+    xpGained: {
+        amount: number;
+        totalXP: number;
+        leveledUp: boolean;
+    };
 }
 export type GameContextPayload = {
     token: string;
     baseUrl: string;
+    realtimeUrl: string;
     gameId: string;
+    forwardKeys?: string[];
 };
 export type EventListeners = {
     [E in keyof ClientEvents]?: Array<(payload: ClientEvents[E]) => void>;
 };
-export type GameWithManifest = Game & {
-    manifest: ManifestV1;
-};
-export type DeveloperStatusValue = DeveloperStatusResponse['status'];
-export type GameState = Record<string, unknown>;
 export type LoginResponse = {
     token: string;
 };
@@ -40,4 +178,26 @@ export type StartSessionResponse = {
 export type InventoryMutationResponse = {
     newTotal: number;
 };
-export type { User, InventoryItemWithReward, Game, ManifestV1, DeveloperKey, DeveloperStatusResponse, MapElement, Reward, InsertReward, UpdateReward, };
+export type DevUploadEvent = {
+    type: 'init';
+} | {
+    type: 's3Progress';
+    loaded: number;
+    total: number;
+    percent: number;
+} | {
+    type: 'finalizeStart';
+} | {
+    type: 'finalizeProgress';
+    percent: number;
+    currentFileLabel?: string;
+} | {
+    type: 'finalizeStatus';
+    message: string;
+} | {
+    type: 'close';
+};
+export type DevUploadHooks = {
+    onEvent?: (e: DevUploadEvent) => void;
+    onClose?: () => void;
+};