@playcademy/sdk 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -3412,6 +3412,15 @@ interface BetterAuthApiKey {
     lastRequest: string | null;
     requestCount: number;
 }
+/**
+ * Bucket file metadata
+ */
+interface BucketFile {
+    key: string;
+    size: number;
+    uploaded: string;
+    contentType?: string;
+}
 
 /**
  * OAuth 2.0 implementation for the Playcademy SDK
@@ -3706,11 +3715,17 @@ declare class PlaycademyClient {
      *
      * @param path - API endpoint path
      * @param method - HTTP method
-     * @param body - Request body (optional)
-     * @param headers - Additional headers (optional)
-     * @returns Promise resolving to the response data
+     * @param options - Optional request configuration
+     * @param options.body - Request body
+     * @param options.headers - Additional headers
+     * @param options.raw - If true, returns raw Response instead of parsing
+     * @returns Promise resolving to the response data or raw Response
      */
-    protected request<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    protected request<T>(path: string, method: Method, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        raw?: boolean;
+    }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      * Uses gameUrl if set, otherwise falls back to platform API.
@@ -3862,6 +3877,12 @@ declare class PlaycademyClient {
                 get: (slug: string) => Promise<Record<string, string>>;
                 delete: (slug: string, key: string) => Promise<void>;
             };
+            bucket: {
+                list: (slug: string, prefix?: string) => Promise<BucketFile[]>;
+                get: (slug: string, key: string) => Promise<ArrayBuffer>;
+                put: (slug: string, key: string, content: Blob | ArrayBuffer | Uint8Array, contentType?: string) => Promise<void>;
+                delete: (slug: string, key: string) => Promise<void>;
+            };
         };
         items: {
             create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, "slug" | "gameId">) => Promise<Item>;
@@ -4076,7 +4097,9 @@ declare class PlaycademyClient {
             }) => Promise<TodayXpResponse>;
             total: () => Promise<TotalXpResponse>;
             history: (options?: {
-                startDate?: string;
+                startDate
+                /** Auto-initializes a PlaycademyClient with context from the environment */
+                ?: string;
                 endDate?: string;
             }) => Promise<XpHistoryResponse>;
             summary: (options?: {

package/dist/index.js

@@ -20,6 +20,8 @@ var isBrowser = () => {
   return typeof process !== "undefined" && true;
 }, isInteractiveTTY = () => {
   return typeof process !== "undefined" && Boolean(process.stdout && process.stdout.isTTY);
+}, isSilent = () => {
+  return typeof process !== "undefined" && process.env.LOG_SILENT === "true";
 }, detectOutputFormat = () => {
   if (isBrowser()) {
     return "browser";
@@ -117,6 +119,8 @@ var isBrowser = () => {
   }
   return isProduction() ? "info" : "debug";
 }, shouldLog = (level) => {
+  if (isSilent())
+    return false;
   const minLevel = getMinimumLogLevel();
   return levelPriority[level] >= levelPriority[minLevel];
 }, performLog = (level, message, context) => {
@@ -299,7 +303,7 @@ function createAuthNamespace(client) {
   return {
     login: async (credentials) => {
       try {
-        const response = await client["request"]("/auth/sign-in/email", "POST", credentials);
+        const response = await client["request"]("/auth/sign-in/email", "POST", { body: credentials });
         client.setToken(response.token, "session");
         return {
           success: true,
@@ -323,12 +327,14 @@ function createAuthNamespace(client) {
     apiKeys: {
       create: async (options) => {
         return client["request"]("/dev/api-keys", "POST", {
-          name: options?.name || `SDK Key - ${new Date().toISOString()}`,
-          expiresIn: options?.expiresIn !== undefined ? options.expiresIn : null,
-          permissions: options?.permissions || {
-            games: ["read", "write", "delete"],
-            users: ["read:self", "write:self"],
-            dev: ["read", "write"]
+          body: {
+            name: options?.name || `SDK Key - ${new Date().toISOString()}`,
+            expiresIn: options?.expiresIn !== undefined ? options.expiresIn : null,
+            permissions: options?.permissions || {
+              games: ["read", "write", "delete"],
+              users: ["read:self", "write:self"],
+              dev: ["read", "write"]
+            }
           }
         });
       },
@@ -336,7 +342,9 @@ function createAuthNamespace(client) {
         return client["request"]("/auth/api-key/list", "GET");
       },
       revoke: async (keyId) => {
-        await client["request"]("/auth/api-key/revoke", "POST", { id: keyId });
+        await client["request"]("/auth/api-key/revoke", "POST", {
+          body: { id: keyId }
+        });
       }
     }
   };
@@ -1046,7 +1054,7 @@ function createGamesNamespace(client) {
     },
     saveState: async (state) => {
       const gameId = client["_ensureGameId"]();
-      await client["request"](`/games/${gameId}/state`, "POST", state);
+      await client["request"](`/games/${gameId}/state`, "POST", { body: state });
     },
     loadState: async () => {
       const gameId = client["_ensureGameId"]();
@@ -1156,7 +1164,7 @@ function createUsersNamespace(client) {
       get: async () => client["request"](`/inventory`, "GET"),
       add: async (identifier, qty) => {
         const itemId = await resolveItemId(identifier);
-        const res = await client["request"](`/inventory/add`, "POST", { itemId, qty });
+        const res = await client["request"](`/inventory/add`, "POST", { body: { itemId, qty } });
         client["emit"]("inventoryChange", {
           itemId,
           delta: qty,
@@ -1166,7 +1174,7 @@ function createUsersNamespace(client) {
       },
       remove: async (identifier, qty) => {
         const itemId = await resolveItemId(identifier);
-        const res = await client["request"](`/inventory/remove`, "POST", { itemId, qty });
+        const res = await client["request"](`/inventory/remove`, "POST", { body: { itemId, qty } });
         client["emit"]("inventoryChange", {
           itemId,
           delta: -qty,
@@ -1227,14 +1235,18 @@ function createDevNamespace(client) {
       deploy: {
         frontend: async (slug, metadata, file, hooks) => {
           hooks?.onEvent?.({ type: "init" });
-          const game = await client["request"](`/games/${slug}`, "PUT", metadata);
+          const game = await client["request"](`/games/${slug}`, "PUT", {
+            body: metadata
+          });
           if (metadata.gameType === "external" || file === null) {
             return game;
           }
           const fileName = file instanceof File ? file.name : "game.zip";
           const initiateResponse = await client["request"]("/games/uploads/initiate/", "POST", {
-            fileName,
-            gameId: game.id
+            body: {
+              fileName,
+              gameId: game.id
+            }
           });
           if (hooks?.onEvent && typeof XMLHttpRequest !== "undefined") {
             await new Promise((resolve, reject) => {
@@ -1365,7 +1377,7 @@ function createDevNamespace(client) {
           throw new Error("Upload completed but no final game data received");
         },
         backend: async (slug, bundle) => {
-          return client["request"](`/games/${slug}/backend/deploy`, "POST", bundle);
+          return client["request"](`/games/${slug}/backend/deploy`, "POST", { body: bundle });
         }
       },
       upsert: async (slug, metadata) => {
@@ -1374,7 +1386,7 @@ function createDevNamespace(client) {
       delete: (gameId) => client["request"](`/games/${gameId}`, "DELETE"),
       secrets: {
         set: async (slug, secrets) => {
-          const result = await client["request"](`/games/${slug}/secrets`, "POST", secrets);
+          const result = await client["request"](`/games/${slug}/secrets`, "POST", { body: secrets });
           return result.keys;
         },
         list: async (slug) => {
@@ -1388,14 +1400,50 @@ function createDevNamespace(client) {
         delete: async (slug, key) => {
           await client["request"](`/games/${slug}/secrets/${key}`, "DELETE");
         }
+      },
+      bucket: {
+        list: async (slug, prefix) => {
+          const params = prefix ? `?prefix=${encodeURIComponent(prefix)}` : "";
+          const result = await client["request"](`/games/${slug}/bucket${params}`, "GET");
+          return result.files;
+        },
+        get: async (slug, key) => {
+          const res = await client["request"](`/games/${slug}/bucket/${encodeURIComponent(key)}`, "GET", { raw: true });
+          if (!res.ok) {
+            let errorMessage = res.statusText;
+            try {
+              const errorData = await res.json();
+              if (errorData.error) {
+                errorMessage = errorData.error;
+              } else if (errorData.message) {
+                errorMessage = errorData.message;
+              }
+            } catch {}
+            throw new Error(errorMessage);
+          }
+          return res.arrayBuffer();
+        },
+        put: async (slug, key, content, contentType) => {
+          await client["request"](`/games/${slug}/bucket/${encodeURIComponent(key)}`, "PUT", {
+            body: content,
+            headers: contentType ? { "Content-Type": contentType } : undefined
+          });
+        },
+        delete: async (slug, key) => {
+          await client["request"](`/games/${slug}/bucket/${encodeURIComponent(key)}`, "DELETE");
+        }
       }
     },
     items: {
       create: (gameId, slug, itemData) => client["request"](`/games/${gameId}/items`, "POST", {
-        slug,
-        ...itemData
+        body: {
+          slug,
+          ...itemData
+        }
+      }),
+      update: (gameId, itemId, updates) => client["request"](`/games/${gameId}/items/${itemId}`, "PATCH", {
+        body: updates
       }),
-      update: (gameId, itemId, updates) => client["request"](`/games/${gameId}/items/${itemId}`, "PATCH", updates),
       list: (gameId) => client["request"](`/games/${gameId}/items`, "GET"),
       get: (gameId, slug) => {
         const queryParams = new URLSearchParams({ slug, gameId });
@@ -1404,13 +1452,13 @@ function createDevNamespace(client) {
       delete: (gameId, itemId) => client["request"](`/games/${gameId}/items/${itemId}`, "DELETE"),
       shop: {
         create: (gameId, itemId, listingData) => {
-          return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "POST", listingData);
+          return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "POST", { body: listingData });
         },
         get: (gameId, itemId) => {
           return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "GET");
         },
         update: (gameId, itemId, updates) => {
-          return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "PATCH", updates);
+          return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "PATCH", { body: updates });
         },
         delete: (gameId, itemId) => {
           return client["request"](`/games/${gameId}/items/${itemId}/shop-listing`, "DELETE");
@@ -1438,7 +1486,9 @@ function createMapsNamespace(client) {
     elements: (mapId, options) => mapElementsCache.get(mapId, () => client["request"](`/map/elements?mapId=${mapId}`, "GET"), options),
     objects: {
       list: (mapId) => client["request"](`/maps/${mapId}/objects`, "GET"),
-      create: (mapId, objectData) => client["request"](`/maps/${mapId}/objects`, "POST", objectData),
+      create: (mapId, objectData) => client["request"](`/maps/${mapId}/objects`, "POST", {
+        body: objectData
+      }),
       delete: (mapId, objectId) => client["request"](`/maps/${mapId}/objects/${objectId}`, "DELETE")
     }
   };
@@ -1453,24 +1503,26 @@ function createAdminNamespace(client) {
       resumeGame: (gameId) => client["request"](`/admin/games/${gameId}/resume`, "POST")
     },
     items: {
-      create: (props) => client["request"]("/items", "POST", props),
+      create: (props) => client["request"]("/items", "POST", { body: props }),
       get: (itemId) => client["request"](`/items/${itemId}`, "GET"),
       list: () => client["request"]("/items", "GET"),
-      update: (itemId, props) => client["request"](`/items/${itemId}`, "PATCH", props),
+      update: (itemId, props) => client["request"](`/items/${itemId}`, "PATCH", { body: props }),
       delete: (itemId) => client["request"](`/items/${itemId}`, "DELETE")
     },
     currencies: {
-      create: (props) => client["request"]("/currencies", "POST", props),
+      create: (props) => client["request"]("/currencies", "POST", { body: props }),
       get: (currencyId) => client["request"](`/currencies/${currencyId}`, "GET"),
       list: () => client["request"]("/currencies", "GET"),
-      update: (currencyId, props) => client["request"](`/currencies/${currencyId}`, "PATCH", props),
+      update: (currencyId, props) => client["request"](`/currencies/${currencyId}`, "PATCH", { body: props }),
       delete: (currencyId) => client["request"](`/currencies/${currencyId}`, "DELETE")
     },
     shopListings: {
-      create: (props) => client["request"]("/shop-listings", "POST", props),
+      create: (props) => client["request"]("/shop-listings", "POST", { body: props }),
       get: (listingId) => client["request"](`/shop-listings/${listingId}`, "GET"),
       list: () => client["request"]("/shop-listings", "GET"),
-      update: (listingId, props) => client["request"](`/shop-listings/${listingId}`, "PATCH", props),
+      update: (listingId, props) => client["request"](`/shop-listings/${listingId}`, "PATCH", {
+        body: props
+      }),
       delete: (listingId) => client["request"](`/shop-listings/${listingId}`, "DELETE")
     }
   };
@@ -1488,7 +1540,7 @@ function createShopNamespace(client) {
 // src/core/namespaces/telemetry.ts
 function createTelemetryNamespace(client) {
   return {
-    pushMetrics: (metrics) => client["request"](`/telemetry/metrics`, "POST", metrics)
+    pushMetrics: (metrics) => client["request"](`/telemetry/metrics`, "POST", { body: metrics })
   };
 }
 
@@ -1665,8 +1717,10 @@ function createCreditsNamespace(client) {
       }
       const creditsItemId = await getCreditsItemId();
       const result = await client["request"]("/inventory/add", "POST", {
-        itemId: creditsItemId,
-        qty: amount
+        body: {
+          itemId: creditsItemId,
+          qty: amount
+        }
       });
       client["emit"]("inventoryChange", {
         itemId: creditsItemId,
@@ -1681,8 +1735,10 @@ function createCreditsNamespace(client) {
       }
       const creditsItemId = await getCreditsItemId();
       const result = await client["request"]("/inventory/remove", "POST", {
-        itemId: creditsItemId,
-        qty: amount
+        body: {
+          itemId: creditsItemId,
+          qty: amount
+        }
       });
       client["emit"]("inventoryChange", {
         itemId: creditsItemId,
@@ -1722,8 +1778,10 @@ function createScoresNamespace(client) {
   return {
     submit: async (gameId, score, metadata) => {
       return client["request"](`/games/${gameId}/scores`, "POST", {
-        score,
-        metadata
+        body: {
+          score,
+          metadata
+        }
       });
     },
     getByUser: async (gameId, userId, options) => {
@@ -1759,10 +1817,10 @@ function createCharacterNamespace(client) {
       }
     },
     create: async (characterData) => {
-      return client["request"]("/character", "POST", characterData);
+      return client["request"]("/character", "POST", { body: characterData });
     },
     update: async (updates) => {
-      return client["request"]("/character", "PATCH", updates);
+      return client["request"]("/character", "PATCH", { body: updates });
     },
     components: {
       list: async (options) => {
@@ -1778,7 +1836,7 @@ function createCharacterNamespace(client) {
     },
     accessories: {
       equip: async (slot, componentId) => {
-        return client["request"]("/character/accessories/equip", "POST", { slot, accessoryComponentId: componentId });
+        return client["request"]("/character/accessories/equip", "POST", { body: { slot, accessoryComponentId: componentId } });
       },
       remove: async (slot) => {
         return client["request"](`/character/accessories/${slot}`, "DELETE");
@@ -2080,7 +2138,7 @@ function createAchievementsNamespace(client) {
     },
     progress: {
       submit: async (achievementId) => client["request"]("/achievements/progress", "POST", {
-        achievementId
+        body: { achievementId }
       })
     }
   };
@@ -2155,7 +2213,9 @@ function createTimebackNamespace(client) {
     },
     management: {
       setup: (request2) => {
-        return client["request"]("/timeback/setup", "POST", request2);
+        return client["request"]("/timeback/setup", "POST", {
+          body: request2
+        });
       },
       verify: (gameId) => {
         return client["request"](`/timeback/verify/${gameId}`, "GET");
@@ -2244,24 +2304,30 @@ function createNotificationsNamespace(client) {
     },
     markAsSeen: async (notificationId) => {
       const result = await client["request"](`/notifications/${notificationId}/status`, "PATCH", {
-        id: notificationId,
-        status: "seen"
+        body: {
+          id: notificationId,
+          status: "seen"
+        }
       });
       notificationsListCache.clear();
       return result;
     },
     markAsClicked: async (notificationId) => {
       const result = await client["request"](`/notifications/${notificationId}/status`, "PATCH", {
-        id: notificationId,
-        status: "clicked"
+        body: {
+          id: notificationId,
+          status: "clicked"
+        }
       });
       notificationsListCache.clear();
       return result;
     },
     dismiss: async (notificationId) => {
       const result = await client["request"](`/notifications/${notificationId}/status`, "PATCH", {
-        id: notificationId,
-        status: "dismissed"
+        body: {
+          id: notificationId,
+          status: "dismissed"
+        }
       });
       notificationsListCache.clear();
       return result;
@@ -2574,17 +2640,18 @@ var init_client = __esm(() => {
         listener(payload);
       });
     }
-    async request(path, method, body, headers) {
+    async request(path, method, options) {
       const effectiveHeaders = {
-        ...headers,
+        ...options?.headers,
         ...this.authStrategy.getHeaders()
       };
       return request({
         path,
         method,
-        body,
+        body: options?.body,
         baseUrl: this.baseUrl,
-        extraHeaders: effectiveHeaders
+        extraHeaders: effectiveHeaders,
+        raw: options?.raw
       });
     }
     async requestGameBackend(path, method, body, headers, raw) {

package/dist/types.d.ts

@@ -4394,11 +4394,17 @@ declare class PlaycademyClient {
      *
      * @param path - API endpoint path
      * @param method - HTTP method
-     * @param body - Request body (optional)
-     * @param headers - Additional headers (optional)
-     * @returns Promise resolving to the response data
+     * @param options - Optional request configuration
+     * @param options.body - Request body
+     * @param options.headers - Additional headers
+     * @param options.raw - If true, returns raw Response instead of parsing
+     * @returns Promise resolving to the response data or raw Response
      */
-    protected request<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    protected request<T>(path: string, method: Method, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        raw?: boolean;
+    }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      * Uses gameUrl if set, otherwise falls back to platform API.
@@ -4550,6 +4556,12 @@ declare class PlaycademyClient {
                 get: (slug: string) => Promise<Record<string, string>>;
                 delete: (slug: string, key: string) => Promise<void>;
             };
+            bucket: {
+                list: (slug: string, prefix?: string) => Promise<BucketFile[]>;
+                get: (slug: string, key: string) => Promise<ArrayBuffer>;
+                put: (slug: string, key: string, content: Blob | ArrayBuffer | Uint8Array, contentType?: string) => Promise<void>;
+                delete: (slug: string, key: string) => Promise<void>;
+            };
         };
         items: {
             create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, "slug" | "gameId">) => Promise<Item>;
@@ -4764,7 +4776,9 @@ declare class PlaycademyClient {
             }) => Promise<TodayXpResponse>;
             total: () => Promise<TotalXpResponse>;
             history: (options?: {
-                startDate?: string;
+                startDate
+                /** Auto-initializes a PlaycademyClient with context from the environment */
+                ?: string;
                 endDate?: string;
             }) => Promise<XpHistoryResponse>;
             summary: (options?: {
@@ -5128,6 +5142,15 @@ interface BetterAuthApiKey {
     lastRequest: string | null;
     requestCount: number;
 }
+/**
+ * Bucket file metadata
+ */
+interface BucketFile {
+    key: string;
+    size: number;
+    uploaded: string;
+    contentType?: string;
+}
 
 export { PlaycademyClient };
-export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, CharacterComponent, CharacterComponentWithSpriteUrl, ClientConfig, ClientEvents, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, EventListeners, ExternalGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, HostedGameWithManifest, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore$1 as UserScore, XpHistoryResponse };
+export type { Achievement, AchievementCurrent, AchievementProgressResponse, AuthCallbackPayload, AuthOptions, AuthProviderType, AuthResult, AuthServerMessage, AuthStateChangePayload, AuthStateUpdate, AuthenticatedUser, BetterAuthApiKey, BetterAuthApiKeyResponse, BetterAuthSignInResponse, BucketFile, CharacterComponent, CharacterComponentWithSpriteUrl, ClientConfig, ClientEvents, Currency, DevUploadEvent, DevUploadHooks, DeveloperStatusResponse, EventListeners, ExternalGame, Game, GameContextPayload, GameLeaderboardEntry, GameSession, GameStateData, GameTokenResponse, GameUser, HostedGame, HostedGameWithManifest, InitPayload, InventoryItem, InventoryItemWithItem, InventoryMutationResponse, Item, KeyEventPayload, LeaderboardEntry, LevelConfig, LoginResponse, ManifestV1, Map, MapElement, MapElementWithGame, MapObject, MapObjectWithItem, PlaycademyServerClientConfig, PlaycademyServerClientState, PlayerCharacter, ShopCurrency, ShopDisplayItem, ShopViewResponse, SpriteTemplate, SpriteTemplateData, StartSessionResponse, TelemetryPayload, TodayXpResponse, TokenRefreshPayload, TokenType, TotalXpResponse, User, UserInfo, UserLevel, UserLevelWithConfig, UserRank, UserRankResponse, UserRoleEnumType, UserScore$1 as UserScore, XpHistoryResponse };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.1.9",
+    "version": "0.1.11",
     "type": "module",
     "exports": {
         ".": {
@@ -42,7 +42,7 @@
         "@playcademy/timeback": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/bun": "latest",
-        "playcademy": "0.13.20",
+        "playcademy": "0.13.22",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2",