@playcademy/sdk 0.1.6 → 0.1.8

package/dist/index.d.ts

@@ -3162,6 +3162,8 @@ interface IntegrationsConfig {
     database?: DatabaseIntegration | boolean;
     /** Key-Value storage (optional) */
     kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -3212,6 +3214,8 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
+    /** Optional game secrets */
+    secrets?: Record<string, string>;
 }
 
 type TokenType = 'session' | 'apiKey' | 'gameJwt';
@@ -3715,9 +3719,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.
      *
@@ -3851,6 +3856,12 @@ declare class PlaycademyClient {
             };
             upsert: (slug: string, metadata: UpsertGameMetadataInput) => Promise<Game>;
             delete: (gameId: string) => Promise<void>;
+            secrets: {
+                set: (slug: string, secrets: Record<string, string>) => Promise<string[]>;
+                list: (slug: string) => Promise<string[]>;
+                get: (slug: string) => Promise<Record<string, string>>;
+                delete: (slug: string, key: string) => Promise<void>;
+            };
         };
         items: {
             create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, "slug" | "gameId">) => Promise<Item>;
@@ -3887,49 +3898,49 @@ declare class PlaycademyClient {
         };
         items: {
             create: (props: InsertItemInput) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }>;
             get: (itemId: string) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }>;
             list: () => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }[]>;
             update: (itemId: string, props: UpdateItemInput) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
@@ -4165,6 +4176,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`;
@@ -1357,7 +1371,24 @@ function createDevNamespace(client) {
       upsert: async (slug, metadata) => {
         return client.dev.games.deploy.frontend(slug, metadata, null);
       },
-      delete: (gameId) => client["request"](`/games/${gameId}`, "DELETE")
+      delete: (gameId) => client["request"](`/games/${gameId}`, "DELETE"),
+      secrets: {
+        set: async (slug, secrets) => {
+          const result = await client["request"](`/games/${slug}/secrets`, "POST", secrets);
+          return result.keys;
+        },
+        list: async (slug) => {
+          const result = await client["request"](`/games/${slug}/secrets`, "GET");
+          return result.keys;
+        },
+        get: async (slug) => {
+          const result = await client["request"](`/games/${slug}/secrets/values`, "GET");
+          return result.secrets;
+        },
+        delete: async (slug, key) => {
+          await client["request"](`/games/${slug}/secrets/${key}`, "DELETE");
+        }
+      }
     },
     items: {
       create: (gameId, slug, itemData) => client["request"](`/games/${gameId}/items`, "POST", {
@@ -2276,6 +2307,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 +2576,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 +2586,8 @@ var init_client = __esm(() => {
         method,
         body,
         baseUrl: this.getGameBackendUrl(),
-        extraHeaders: effectiveHeaders
+        extraHeaders: effectiveHeaders,
+        raw
       });
     }
     _ensureGameId() {

package/dist/server.d.ts

@@ -52,6 +52,8 @@ interface IntegrationsConfig {
     database?: DatabaseIntegration | boolean;
     /** Key-Value storage (optional) */
     kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -171,6 +173,8 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
+    /** Optional game secrets */
+    secrets?: Record<string, string>;
 }
 
 /**

package/dist/server.js

@@ -122,7 +122,8 @@ async function loadFile(filename, options = {}) {
     required = false,
     searchUp = false,
     maxLevels = 3,
-    parseJson = false
+    parseJson = false,
+    stripComments = false
   } = options;
   let fileResult;
   if (searchUp) {
@@ -151,8 +152,11 @@ async function loadFile(filename, options = {}) {
     return null;
   }
   try {
-    const content = await readFile(fileResult.path, "utf-8");
+    let content = await readFile(fileResult.path, "utf-8");
     if (parseJson) {
+      if (stripComments) {
+        content = stripJsonComments(content);
+      }
       return JSON.parse(content);
     }
     return content;
@@ -178,6 +182,11 @@ async function findFile(filename, options = {}) {
   }
   return null;
 }
+function stripJsonComments(jsonc) {
+  let result = jsonc.replace(/\/\*[\s\S]*?\*\//g, "");
+  result = result.replace(/\/\/.*/g, "");
+  return result;
+}
 
 // src/server/utils/config-loader.ts
 async function findConfigPath(configPath) {

package/dist/types.d.ts

@@ -3931,6 +3931,8 @@ interface IntegrationsConfig {
     database?: DatabaseIntegration | boolean;
     /** Key-Value storage (optional) */
     kv?: boolean;
+    /** Bucket storage (optional) */
+    bucket?: boolean;
 }
 /**
  * Unified Playcademy configuration
@@ -4050,6 +4052,8 @@ interface BackendDeploymentBundle {
     bindings?: BackendResourceBindings;
     /** Optional schema information for database setup */
     schema?: SchemaInfo;
+    /** Optional game secrets */
+    secrets?: Record<string, string>;
 }
 
 interface UserScore {
@@ -4403,9 +4407,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.
      *
@@ -4539,6 +4544,12 @@ declare class PlaycademyClient {
             };
             upsert: (slug: string, metadata: UpsertGameMetadataInput) => Promise<Game>;
             delete: (gameId: string) => Promise<void>;
+            secrets: {
+                set: (slug: string, secrets: Record<string, string>) => Promise<string[]>;
+                list: (slug: string) => Promise<string[]>;
+                get: (slug: string) => Promise<Record<string, string>>;
+                delete: (slug: string, key: string) => Promise<void>;
+            };
         };
         items: {
             create: (gameId: string, slug: string, itemData: Omit<InsertItemInput, "slug" | "gameId">) => Promise<Item>;
@@ -4575,49 +4586,49 @@ declare class PlaycademyClient {
         };
         items: {
             create: (props: InsertItemInput) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }>;
             get: (itemId: string) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }>;
             list: () => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
             }[]>;
             update: (itemId: string, props: UpdateItemInput) => Promise<{
+                metadata: unknown;
                 type: "accessory" | "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 slug: string;
                 id: string;
                 createdAt: Date;
                 gameId: string | null;
                 displayName: string;
-                metadata: unknown;
                 description: string | null;
                 isPlaceable: boolean;
                 imageUrl: string | null;
@@ -4853,6 +4864,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.6",
+    "version": "0.1.8",
     "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.1",
+        "@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.12.9",
+        "playcademy": "0.13.19",
         "rollup": "^4.50.2",
         "rollup-plugin-dts": "^6.2.3",
         "typescript": "^5.7.2",