@playcademy/sdk 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -57,8 +57,6 @@ interface ErrorResponseBody {
  * ```
  */
 declare class ApiError extends Error {
-    /** HTTP status code */
-    readonly status: number;
     /**
      * API error code (e.g., "NOT_FOUND", "VALIDATION_FAILED").
      * Use this for programmatic error handling.
@@ -74,6 +72,7 @@ declare class ApiError extends Error {
      * @internal
      */
     readonly rawBody: unknown;
+    readonly status: number;
     constructor(
     /** HTTP status code */
     status: number, 
@@ -635,7 +634,7 @@ declare const items: drizzle_orm_pg_core.PgTableWithColumns<{
             tableName: "items";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "accessory" | "other";
+            data: "accessory" | "badge" | "collectible" | "consumable" | "currency" | "other" | "trophy" | "unlock" | "upgrade";
             driverParam: string;
             notNull: true;
             hasDefault: true;
@@ -856,6 +855,7 @@ declare abstract class PlaycademyBaseClient {
     };
     protected initPayload?: InitPayload;
     protected connectionManager?: ConnectionManager;
+    protected launchId?: string;
     /**
      * Internal session manager for automatic session lifecycle.
      * @private
@@ -884,6 +884,7 @@ declare abstract class PlaycademyBaseClient {
      * Sets the authentication token for API requests.
      */
     setToken(token: string | null, tokenType?: TokenType): void;
+    setLaunchId(launchId: string | null | undefined): void;
     /**
      * Gets the current token type.
      */
@@ -951,9 +952,6 @@ declare abstract class PlaycademyBaseClient {
      * Initializes connection monitoring if enabled.
      */
     private _initializeConnectionMonitor;
-    /**
-     * Initializes an internal game session for automatic session management.
-     */
     private _initializeInternalSession;
     /**
      * Current user data and inventory management.
@@ -1062,8 +1060,8 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      */
     runtime: {
         getGameToken: (gameId: string, options?: {
-            apply?: boolean;
-        }) => Promise<GameTokenResponse>;
+            apply?: boolean | undefined;
+        } | undefined) => Promise<GameTokenResponse>;
         exit: () => Promise<void>;
         onInit: (handler: (context: GameContextPayload) => void) => void;
         onTokenRefresh: (handler: (data: {
@@ -1087,7 +1085,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
         getListenerCounts: () => Record<string, number>;
         assets: {
             url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
-            fetch: (path: string, options?: RequestInit) => Promise<Response>;
+            fetch: (path: string, options?: RequestInit | undefined) => Promise<Response>;
             json: <T = unknown>(path: string) => Promise<T>;
             blob: (path: string) => Promise<Blob>;
             text: (path: string) => Promise<string>;
@@ -1130,7 +1128,7 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      * - `submit(gameId, score, metadata?)` - Record a game score
      */
     scores: {
-        submit: (gameId: string, score: number, metadata?: Record<string, unknown>) => Promise<ScoreSubmission>;
+        submit: (gameId: string, score: number, metadata?: Record<string, unknown> | undefined) => Promise<ScoreSubmission>;
     };
     /**
      * Realtime multiplayer authentication.
@@ -1147,13 +1145,13 @@ declare class PlaycademyClient extends PlaycademyBaseClient {
      * - Routes are relative to your game's deployment (e.g., '/hello' → your-game.playcademy.gg/api/hello)
      */
     backend: {
-        get<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
-        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        delete<T = unknown>(path: string, headers?: Record<string, string>): Promise<T>;
-        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
-        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string>): Promise<Response>;
+        get<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
+        post<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        put<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        patch<T = unknown>(path: string, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        delete<T = unknown>(path: string, headers?: Record<string, string> | undefined): Promise<T>;
+        request<T = unknown>(path: string, method: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<T>;
+        download(path: string, method?: Method, body?: unknown, headers?: Record<string, string> | undefined): Promise<Response>;
         url(pathOrStrings: string | TemplateStringsArray, ...values: unknown[]): string;
     };
     /** Auto-initializes a PlaycademyClient with context from the environment */
@@ -1312,6 +1310,7 @@ interface ClientConfig {
     token?: string;
     tokenType?: TokenType;
     gameId?: string;
+    launchId?: string;
     autoStartSession?: boolean;
     onDisconnect?: DisconnectHandler;
     enableConnectionMonitoring?: boolean;
@@ -1351,15 +1350,15 @@ interface InitPayload {
     /** Timeback context (if user has a Timeback account) */
     timeback?: TimebackInitContext;
 }
-type GameContextPayload = {
+interface GameContextPayload {
     token: string;
     baseUrl: string;
     realtimeUrl: string;
     gameId: string;
     forwardKeys?: string[];
-};
+}
 type EventListeners = {
-    [E in keyof ClientEvents]?: Array<(payload: ClientEvents[E]) => void>;
+    [E in keyof ClientEvents]?: ((payload: ClientEvents[E]) => void)[];
 };
 interface ClientEvents {
     authChange: {
@@ -1465,16 +1464,16 @@ interface ConnectionStatePayload {
 /**
  * SDK-specific API response types
  */
-type LoginResponse = {
+interface LoginResponse {
     token: string;
-};
-type GameTokenResponse = {
+}
+interface GameTokenResponse {
     token: string;
     exp: number;
-};
-type InventoryMutationResponse = {
+}
+interface InventoryMutationResponse {
     newTotal: number;
-};
+}
 
 /**
  * Realtime namespace types
@@ -1561,10 +1560,10 @@ type DevUploadEvent = {
 } | {
     type: 'close';
 };
-type DevUploadHooks = {
+interface DevUploadHooks {
     onEvent?: (e: DevUploadEvent) => void;
     onClose?: () => void;
-};
+}
 
 /**
  * Connection Manager
@@ -1908,7 +1907,7 @@ type MessageHandler<T = unknown> = (payload: T) => void;
  * })
  * ```
  */
-type MessageEventMap = {
+interface MessageEventMap {
     /** Game initialization context with API endpoint, auth token, and game ID */
     [MessageEvents.INIT]: GameContextPayload;
     /** Token refresh data with new token and expiration timestamp */
@@ -1937,7 +1936,7 @@ type MessageEventMap = {
     [MessageEvents.AUTH_STATE_CHANGE]: AuthStateChangePayload;
     /** OAuth callback data from popup/new-tab windows */
     [MessageEvents.AUTH_CALLBACK]: AuthCallbackPayload;
-};
+}
 /**
  * **PlaycademyMessaging Class**
  *