@playcademy/sdk 0.5.0 → 0.5.1-beta.1

package/dist/internal.js

@@ -25,6 +25,7 @@ var MessageEvents;
   MessageEvents2["TELEMETRY"] = "PLAYCADEMY_TELEMETRY";
   MessageEvents2["KEY_EVENT"] = "PLAYCADEMY_KEY_EVENT";
   MessageEvents2["DISPLAY_ALERT"] = "PLAYCADEMY_DISPLAY_ALERT";
+  MessageEvents2["DEMO_END"] = "PLAYCADEMY_DEMO_END";
   MessageEvents2["AUTH_STATE_CHANGE"] = "PLAYCADEMY_AUTH_STATE_CHANGE";
   MessageEvents2["AUTH_CALLBACK"] = "PLAYCADEMY_AUTH_CALLBACK";
 })(MessageEvents ||= {});
@@ -84,7 +85,8 @@ class PlaycademyMessaging {
       "PLAYCADEMY_EXIT" /* EXIT */,
       "PLAYCADEMY_TELEMETRY" /* TELEMETRY */,
       "PLAYCADEMY_KEY_EVENT" /* KEY_EVENT */,
-      "PLAYCADEMY_DISPLAY_ALERT" /* DISPLAY_ALERT */
+      "PLAYCADEMY_DISPLAY_ALERT" /* DISPLAY_ALERT */,
+      "PLAYCADEMY_DEMO_END" /* DEMO_END */
     ];
     const shouldUsePostMessage = isIframe && iframeToParentEvents.includes(eventType);
     return {
@@ -185,7 +187,8 @@ function createStandaloneConfig() {
     gameUrl: globalThis.location.origin,
     token: "mock-game-token-for-local-dev",
     gameId: "mock-game-id-from-template",
-    realtimeUrl: undefined
+    realtimeUrl: undefined,
+    mode: "standalone"
   };
   globalThis.PLAYCADEMY = mockConfig;
   return mockConfig;
@@ -203,6 +206,7 @@ async function init(options) {
     gameUrl: config.gameUrl,
     token: config.token,
     gameId: config.gameId,
+    mode: config.mode,
     autoStartSession: globalThis.self !== window.top,
     onDisconnect: options?.onDisconnect,
     enableConnectionMonitoring: options?.enableConnectionMonitoring
@@ -850,7 +854,12 @@ async function login2(client, options) {
 // src/namespaces/game/identity.ts
 function createIdentityNamespace(client) {
   return {
-    connect: (options) => login2(client, options),
+    connect: (options) => {
+      if (client.mode === "demo") {
+        throw new PlaycademyError("identity.connect() is not available in demo mode. Use platform or standalone mode for OAuth flows.");
+      }
+      return login2(client, options);
+    },
     _getContext: () => ({
       isInIframe: client["authContext"]?.isInIframe ?? false
     })
@@ -1050,6 +1059,42 @@ function createBackendNamespace(client) {
     }
   };
 }
+// src/namespaces/game/guard.ts
+function assertPlatformMode(client, operation) {
+  if (client.mode !== "platform") {
+    throw new PlaycademyError(`${operation} requires platform mode (current: ${client.mode}). Check client.mode before calling.`);
+  }
+}
+function assertDemoMode(client, operation) {
+  if (client.mode !== "demo") {
+    throw new PlaycademyError(`${operation} requires demo mode (current: ${client.mode}). Check client.mode before calling.`);
+  }
+}
+
+// src/namespaces/game/demo.ts
+function createDemoNamespace(client) {
+  return {
+    profile: {
+      get: async () => {
+        assertDemoMode(client, "demo.profile.get()");
+        return client["request"]("/users/demo-profile", "GET");
+      },
+      update: async (updates) => {
+        assertDemoMode(client, "demo.profile.update()");
+        return client["request"]("/users/demo-profile", "PATCH", {
+          body: updates
+        });
+      }
+    },
+    end: (score, options) => {
+      assertDemoMode(client, "demo.end()");
+      messaging.send("PLAYCADEMY_DEMO_END" /* DEMO_END */, {
+        score,
+        ...options
+      });
+    }
+  };
+}
 // src/core/cache/permanent-cache.ts
 function createPermanentCache(keyPrefix) {
   const cache = new Map;
@@ -1112,10 +1157,17 @@ function createUsersNamespace(client) {
     });
   }
   return {
-    me: async () => client["request"]("/users/me", "GET"),
+    me: async () => {
+      assertPlatformMode(client, "users.me()");
+      return client["request"]("/users/me", "GET");
+    },
     inventory: {
-      get: async () => client["request"](`/inventory`, "GET"),
+      get: async () => {
+        assertPlatformMode(client, "users.inventory.get()");
+        return client["request"](`/inventory`, "GET");
+      },
       add: async (identifier, qty) => {
+        assertPlatformMode(client, "users.inventory.add()");
         const itemId = await resolveItemId(identifier);
         const res = await client["request"](`/inventory/add`, "POST", { body: { itemId, qty } });
         client["emit"]("inventoryChange", {
@@ -1126,6 +1178,7 @@ function createUsersNamespace(client) {
         return res;
       },
       remove: async (identifier, qty) => {
+        assertPlatformMode(client, "users.inventory.remove()");
         const itemId = await resolveItemId(identifier);
         const res = await client["request"](`/inventory/remove`, "POST", { body: { itemId, qty } });
         client["emit"]("inventoryChange", {
@@ -1136,12 +1189,14 @@ function createUsersNamespace(client) {
         return res;
       },
       quantity: async (identifier) => {
+        assertPlatformMode(client, "users.inventory.quantity()");
         const itemId = await resolveItemId(identifier);
         const inventory = await client["request"](`/inventory`, "GET");
         const item = inventory.find((inv) => inv.item?.id === itemId);
         return item?.quantity ?? 0;
       },
       has: async (identifier, minQuantity = 1) => {
+        assertPlatformMode(client, "users.inventory.has()");
         const itemId = await resolveItemId(identifier);
         const inventory = await client["request"](`/inventory`, "GET");
         const item = inventory.find((inv) => inv.item?.id === itemId);
@@ -1315,11 +1370,13 @@ function createCreditsNamespace(client) {
   }
   return {
     balance: async () => {
+      assertPlatformMode(client, "credits.balance()");
       const inventory = await client["request"]("/inventory", "GET");
       const primaryCurrencyInventoryItem = inventory.find((item) => item.item?.slug === CURRENCIES.PRIMARY);
       return primaryCurrencyInventoryItem?.quantity ?? 0;
     },
     add: async (amount) => {
+      assertPlatformMode(client, "credits.add()");
       if (amount <= 0) {
         throw new Error("Amount must be positive");
       }
@@ -1338,6 +1395,7 @@ function createCreditsNamespace(client) {
       return result.newTotal;
     },
     spend: async (amount) => {
+      assertPlatformMode(client, "credits.spend()");
       if (amount <= 0) {
         throw new Error("Amount must be positive");
       }
@@ -1360,12 +1418,15 @@ function createCreditsNamespace(client) {
 // src/namespaces/game/scores.ts
 function createScoresNamespace(client) {
   return {
-    submit: async (gameId, score, metadata) => client["request"](`/games/${gameId}/scores`, "POST", {
-      body: {
-        score,
-        metadata
-      }
-    })
+    submit: async (score, metadata) => {
+      const gameId = client["_ensureGameId"]();
+      return client["request"](`/games/${gameId}/scores`, "POST", {
+        body: {
+          score,
+          metadata
+        }
+      });
+    }
   };
 }
 // src/namespaces/game/realtime.ts
@@ -1373,6 +1434,7 @@ function createRealtimeNamespace(client) {
   return {
     token: {
       get: async () => {
+        assertPlatformMode(client, "realtime.token.get()");
         const endpoint = client["gameId"] ? `/games/${client["gameId"]}/realtime/token` : "/realtime/token";
         return client["request"](endpoint, "POST");
       }
@@ -1826,6 +1888,7 @@ function createTimebackNamespace(client) {
   }
   return {
     get user() {
+      assertPlatformMode(client, "timeback.user");
       return {
         get id() {
           return getTimeback()?.id;
@@ -1898,15 +1961,21 @@ function createTimebackNamespace(client) {
       };
     },
     startActivity: (metadata, options) => {
+      assertPlatformMode(client, "timeback.startActivity()");
       activityTracker.startActivity(metadata, options);
     },
     pauseActivity: () => {
+      assertPlatformMode(client, "timeback.pauseActivity()");
       activityTracker.pauseActivity();
     },
     resumeActivity: () => {
+      assertPlatformMode(client, "timeback.resumeActivity()");
       activityTracker.resumeActivity();
     },
-    endActivity: async (data) => activityTracker.endActivity(data)
+    endActivity: async (data) => {
+      assertPlatformMode(client, "timeback.endActivity()");
+      return activityTracker.endActivity(data);
+    }
   };
 }
 // src/namespaces/platform/auth.ts
@@ -2464,22 +2533,37 @@ function createAchievementsNamespace(client) {
   };
 }
 // src/namespaces/platform/leaderboard.ts
+async function fetchInternalLeaderboardEntries(client, options) {
+  const params = new URLSearchParams({
+    timeframe: options?.timeframe || "all_time",
+    limit: String(options?.limit || 10),
+    offset: String(options?.offset || 0)
+  });
+  if (options?.gameId) {
+    params.append("gameId", options.gameId);
+  }
+  return client["request"](`/leaderboard?${params}`, "GET");
+}
+async function fetchPublicLeaderboardEntries(client, options) {
+  const params = new URLSearchParams({
+    timeframe: options?.timeframe || "all_time",
+    limit: String(options?.limit || 10),
+    offset: String(options?.offset || 0)
+  });
+  params.append("gameId", options?.gameId || client["_ensureGameId"]());
+  return client["request"](`/leaderboard?${params}`, "GET");
+}
 function createLeaderboardNamespace(client) {
   return {
-    fetch: async (options) => {
-      const params = new URLSearchParams({
-        timeframe: options?.timeframe || "all_time",
-        limit: String(options?.limit || 10),
-        offset: String(options?.offset || 0)
-      });
-      if (options?.gameId) {
-        params.append("gameId", options.gameId);
-      }
-      return client["request"](`/leaderboard?${params}`, "GET");
-    },
+    fetch: async (options) => fetchInternalLeaderboardEntries(client, options),
     getUserRank: async (gameId, userId) => client["request"](`/games/${gameId}/users/${userId}/rank`, "GET")
   };
 }
+function createLeaderboardFetchNamespace(client) {
+  return {
+    fetch: async (options) => fetchPublicLeaderboardEntries(client, options)
+  };
+}
 // src/core/cache/cooldown-cache.ts
 function createCooldownCache(defaultCooldownMs) {
   const lastFetchTime = new Map;
@@ -2691,9 +2775,13 @@ function createTelemetryNamespace(client) {
 }
 // src/namespaces/platform/scores.ts
 function createScoresNamespace2(client) {
-  const publicScores = createScoresNamespace(client);
   return {
-    ...publicScores,
+    submit: async (gameId, score, metadata) => client["request"](`/games/${gameId}/scores`, "POST", {
+      body: {
+        score,
+        metadata
+      }
+    }),
     getByUser: async (gameId, userId, options) => {
       const params = new URLSearchParams;
       if (options?.limit) {
@@ -3317,6 +3405,7 @@ async function request({
 class PlaycademyBaseClient {
   baseUrl;
   gameUrl;
+  mode;
   authStrategy;
   gameId;
   config;
@@ -3333,6 +3422,7 @@ class PlaycademyBaseClient {
   constructor(config) {
     this.baseUrl = config?.baseUrl?.endsWith("/api") ? config.baseUrl : `${config?.baseUrl}/api`;
     this.gameUrl = config?.gameUrl;
+    this.mode = config?.mode ?? "platform";
     this.gameId = config?.gameId;
     this.launchId = config?.launchId ?? undefined;
     this.config = config || {};