@playcademy/sdk 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -3160,6 +3160,10 @@ interface IntegrationsConfig {
     customRoutes?: CustomRoutesIntegration | boolean;
     /** Database (optional) */
     database?: DatabaseIntegration | boolean;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3713,9 +3717,10 @@ declare class PlaycademyClient {
      * @param method - HTTP method
      * @param body - Request body (optional)
      * @param headers - Additional headers (optional)
-     * @returns Promise resolving to the response data
+     * @param raw - If true, returns raw Response instead of parsing (optional)
+     * @returns Promise resolving to the response data or raw Response
      */
-    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
      *
@@ -4163,6 +4168,7 @@ declare class PlaycademyClient {
         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>;
     };
     /** Auto-initializes a PlaycademyClient with context from the environment */
     static init: typeof init;

package/dist/index.js

@@ -935,28 +935,42 @@ function checkDevWarnings(data) {
       console.warn(`[Playcademy Dev Warning] ${warningType}`);
   }
 }
+function prepareRequestBody(body, headers) {
+  if (body instanceof FormData) {
+    return body;
+  }
+  if (body instanceof ArrayBuffer || body instanceof Blob || ArrayBuffer.isView(body)) {
+    if (!headers["Content-Type"]) {
+      headers["Content-Type"] = "application/octet-stream";
+    }
+    return body;
+  }
+  if (body !== undefined && body !== null) {
+    headers["Content-Type"] = "application/json";
+    return JSON.stringify(body);
+  }
+  return;
+}
 async function request({
   path,
   baseUrl,
   method = "GET",
   body,
-  extraHeaders = {}
+  extraHeaders = {},
+  raw = false
 }) {
   const url = baseUrl.replace(/\/$/, "") + (path.startsWith("/") ? path : `/${path}`);
   const headers = { ...extraHeaders };
-  let payload;
-  if (body instanceof FormData) {
-    payload = body;
-  } else if (body !== undefined && body !== null) {
-    payload = JSON.stringify(body);
-    headers["Content-Type"] = "application/json";
-  }
+  const payload = prepareRequestBody(body, headers);
   const res = await fetch(url, {
     method,
     headers,
     body: payload,
     credentials: "omit"
   });
+  if (raw) {
+    return res;
+  }
   if (!res.ok) {
     const clonedRes = res.clone();
     const errorBody = await clonedRes.json().catch(() => clonedRes.text().catch(() => {
@@ -978,8 +992,8 @@ async function request({
       throw err;
     }
   }
-  const raw = await res.text().catch(() => "");
-  return raw && raw.length > 0 ? raw : undefined;
+  const rawText = await res.text().catch(() => "");
+  return rawText && rawText.length > 0 ? rawText : undefined;
 }
 async function fetchManifest(assetBundleBase) {
   const manifestUrl = `${assetBundleBase.replace(/\/$/, "")}/playcademy.manifest.json`;
@@ -2276,6 +2290,9 @@ function createBackendNamespace(client) {
     },
     async request(path, method, body, headers) {
       return client["requestGameBackend"](normalizePath(path), method, body, headers);
+    },
+    async download(path, method = "GET", body, headers) {
+      return client["requestGameBackend"](normalizePath(path), method, body, headers, true);
     }
   };
 }
@@ -2542,7 +2559,7 @@ var init_client = __esm(() => {
         extraHeaders: effectiveHeaders
       });
     }
-    async requestGameBackend(path, method, body, headers) {
+    async requestGameBackend(path, method, body, headers, raw) {
       const effectiveHeaders = {
         ...headers,
         ...this.authStrategy.getHeaders()
@@ -2552,7 +2569,8 @@ var init_client = __esm(() => {
         method,
         body,
         baseUrl: this.getGameBackendUrl(),
-        extraHeaders: effectiveHeaders
+        extraHeaders: effectiveHeaders,
+        raw
       });
     }
     _ensureGameId() {

package/dist/server.d.ts

@@ -50,6 +50,10 @@ interface IntegrationsConfig {
     customRoutes?: CustomRoutesIntegration | boolean;
     /** Database (optional) */
     database?: DatabaseIntegration | boolean;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration

package/dist/types.d.ts

@@ -3929,6 +3929,10 @@ interface IntegrationsConfig {
     customRoutes?: CustomRoutesIntegration | boolean;
     /** Database (optional) */
     database?: DatabaseIntegration | boolean;
+    /** Key-Value storage (optional) */
+    kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -4401,9 +4405,10 @@ declare class PlaycademyClient {
      * @param method - HTTP method
      * @param body - Request body (optional)
      * @param headers - Additional headers (optional)
-     * @returns Promise resolving to the response data
+     * @param raw - If true, returns raw Response instead of parsing (optional)
+     * @returns Promise resolving to the response data or raw Response
      */
-    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
      *
@@ -4851,6 +4856,7 @@ declare class PlaycademyClient {
         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>;
     };
     /** Auto-initializes a PlaycademyClient with context from the environment */
     static init: typeof init;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.1.5",
+    "version": "0.1.7",
     "type": "module",
     "exports": {
         ".": {
@@ -37,12 +37,12 @@
         "@playcademy/constants": "0.0.1",
         "@playcademy/data": "0.0.1",
         "@playcademy/logger": "0.0.1",
-        "@playcademy/sandbox": "0.1.0",
+        "@playcademy/sandbox": "0.1.7",
         "@playcademy/test": "0.0.1",
         "@playcademy/timeback": "0.0.1",
         "@playcademy/utils": "0.0.1",
         "@types/bun": "latest",
-        "playcademy": "0.11.4",
+        "playcademy": "0.13.16",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2",