@playcademy/sdk 0.0.1-beta.11 → 0.0.1-beta.13

package/README.md

@@ -64,7 +64,7 @@ async function initializeAndUseClient() {
 
     // If the token has appropriate permissions, you can access all namespaces:
     // client.dev.games.upsert(...)
-    // client.admin.rewards.createReward(...)
+    // client.admin.items.createItem(...)
     // Calling a method without sufficient token permissions will result in a server error.
 
     // Example: Listen for auth changes (e.g., if token is refreshed or cleared by logout)
@@ -93,9 +93,9 @@ async function runGame() {
         const { sessionId } = await client.games.startSession()
         console.log('Session started:', sessionId)
 
-        // 2) Fetch player's inventory/rewards
-        const rewards = await client.users.inventory.get()
-        console.log('Player inventory:', rewards)
+        // 2) Fetch player's inventory/items
+        const items = await client.users.inventory.get()
+        console.log('Player inventory:', items)
 
         // 3) Save game state (uses client.gameId implicitly)
         await client.games.saveState({
@@ -136,8 +136,8 @@ All methods returning data are strongly typed.
     - `me()`: Fetch current user details.
     - **`inventory`**:
         - `get()`: Get player inventory.
-        - `add(rewardId, qty)`: Add item to player inventory.
-        - `spend(rewardId, qty)`: Spend item from player inventory.
+        - `add(itemId, qty)`: Add item to player inventory.
+        - `spend(itemId, qty)`: Spend item from player inventory.
     - **`progress`**: Manages persistent progress data for a game (e.g., levels completed, scores, collectibles).
         - `get(gameId?)`: Get the entire progress state for a game. `gameId` is optional and defaults to the client's current game context.
         - `update(data, gameId?)`: Update the progress state for a game. `gameId` is optional. The `data` object can be structured to hold progress for various internal nodes or aspects of the game.
@@ -157,7 +157,7 @@ All methods returning data are strongly typed.
 - **`dev.games`**: Upsert, update, delete games.
 - **`dev.keys`**: Create, list, revoke API keys for games.
 - **`admin.games`**: Pause/resume games.
-- **`admin.rewards`**: CRUD operations for rewards.
+- **`admin.items`**: CRUD operations for items.
 - **`telemetry`**: Push metrics.
 
 ## Contributing

package/dist/core/client.d.ts

@@ -1,6 +1,6 @@
 import { type Method } from './request';
-import type { Game, GameWithManifest, UpsertGameMetadataInput, InsertReward, UpdateReward } from '@playcademy/types';
-import type { GameState, InventoryItemWithReward, ClientConfig, ClientEvents, LoginResponse, GameTokenResponse, StartSessionResponse, InventoryMutationResponse, DeveloperStatusValue } from '../types';
+import type { Game, GameWithManifest, UpsertGameMetadataInput, InsertItem, UpdateItem, InsertCurrency, UpdateCurrency, InsertShopListing, UpdateShopListing } from '@playcademy/types';
+import type { GameState, InventoryItemWithItem, ClientConfig, ClientEvents, LoginResponse, GameTokenResponse, StartSessionResponse, InventoryMutationResponse, DeveloperStatusValue } from '../types';
 export declare class PlaycademyClient {
     private baseUrl;
     private token?;
@@ -47,9 +47,9 @@ export declare class PlaycademyClient {
             developerStatus: "none" | "pending" | "approved";
         }>;
         inventory: {
-            get: () => Promise<InventoryItemWithReward[]>;
-            add: (rewardId: string, qty: number) => Promise<InventoryMutationResponse>;
-            spend: (rewardId: string, qty: number) => Promise<InventoryMutationResponse>;
+            get: () => Promise<InventoryItemWithItem[]>;
+            add: (itemId: string, qty: number) => Promise<InventoryMutationResponse>;
+            spend: (itemId: string, qty: number) => Promise<InventoryMutationResponse>;
         };
     };
     dev: {
@@ -100,40 +100,146 @@ export declare class PlaycademyClient {
             pauseGame: (gameId: string) => Promise<void>;
             resumeGame: (gameId: string) => Promise<void>;
         };
-        rewards: {
-            createReward: (props: InsertReward) => Promise<{
+        items: {
+            createItem: (props: InsertItem) => Promise<{
                 id: string;
                 displayName: string;
                 metadata: unknown;
+                createdAt: Date;
                 internalName: string;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                imageUrl: string | null;
             }>;
-            getReward: (rewardId: string) => Promise<{
+            getItem: (itemId: string) => Promise<{
                 id: string;
                 displayName: string;
                 metadata: unknown;
+                createdAt: Date;
                 internalName: string;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                imageUrl: string | null;
             }>;
-            listRewards: () => Promise<{
+            listItems: () => Promise<{
                 id: string;
                 displayName: string;
                 metadata: unknown;
+                createdAt: Date;
                 internalName: string;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                imageUrl: string | null;
             }[]>;
-            updateReward: (rewardId: string, props: UpdateReward) => Promise<{
+            updateItem: (itemId: string, props: UpdateItem) => Promise<{
                 id: string;
                 displayName: string;
                 metadata: unknown;
+                createdAt: Date;
                 internalName: string;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "unlock" | "upgrade" | "other";
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                imageUrl: string | null;
+            }>;
+            deleteItem: (itemId: string) => Promise<void>;
+        };
+        currencies: {
+            createCurrency: (props: InsertCurrency) => Promise<{
+                symbol: string | null;
+                id: string;
+                displayName: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                internalName: string;
+                imageUrl: string | null;
+                isPrimary: boolean;
+            }>;
+            getCurrency: (currencyId: string) => Promise<{
+                symbol: string | null;
+                id: string;
+                displayName: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                internalName: string;
+                imageUrl: string | null;
+                isPrimary: boolean;
+            }>;
+            listCurrencies: () => Promise<{
+                symbol: string | null;
+                id: string;
+                displayName: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                internalName: string;
+                imageUrl: string | null;
+                isPrimary: boolean;
+            }[]>;
+            updateCurrency: (currencyId: string, props: UpdateCurrency) => Promise<{
+                symbol: string | null;
+                id: string;
+                displayName: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                internalName: string;
+                imageUrl: string | null;
+                isPrimary: boolean;
+            }>;
+            deleteCurrency: (currencyId: string) => Promise<void>;
+        };
+        shopListings: {
+            createListing: (props: InsertShopListing) => Promise<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                itemId: string;
+                currencyId: string;
+                priceAmount: string;
+                sellBackPercentage: number | null;
+                stock: number | null;
+                isActive: boolean;
+                availableFrom: Date | null;
+                availableUntil: Date | null;
+            }>;
+            getListing: (listingId: string) => Promise<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                itemId: string;
+                currencyId: string;
+                priceAmount: string;
+                sellBackPercentage: number | null;
+                stock: number | null;
+                isActive: boolean;
+                availableFrom: Date | null;
+                availableUntil: Date | null;
+            }>;
+            listListings: () => Promise<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                itemId: string;
+                currencyId: string;
+                priceAmount: string;
+                sellBackPercentage: number | null;
+                stock: number | null;
+                isActive: boolean;
+                availableFrom: Date | null;
+                availableUntil: Date | null;
+            }[]>;
+            updateListing: (listingId: string, props: UpdateShopListing) => Promise<{
+                id: string;
+                createdAt: Date;
+                updatedAt: Date | null;
+                itemId: string;
+                currencyId: string;
+                priceAmount: string;
+                sellBackPercentage: number | null;
+                stock: number | null;
+                isActive: boolean;
+                availableFrom: Date | null;
+                availableUntil: Date | null;
             }>;
-            deleteReward: (rewardId: string) => Promise<void>;
+            deleteListing: (listingId: string) => Promise<void>;
         };
     };
     telemetry: {

package/dist/runtime.js

@@ -256,19 +256,19 @@ class PlaycademyClient {
     },
     inventory: {
       get: async () => this.request(`/inventory`, "GET"),
-      add: async (rewardId, qty) => {
-        const res = await this.request(`/inventory/add`, "POST", { rewardId, qty });
+      add: async (itemId, qty) => {
+        const res = await this.request(`/inventory/add`, "POST", { itemId, qty });
         this.emit("inventoryChange", {
-          rewardId,
+          itemId,
           delta: qty,
           newTotal: res.newTotal
         });
         return res;
       },
-      spend: async (rewardId, qty) => {
-        const res = await this.request(`/inventory/spend`, "POST", { rewardId, qty });
+      spend: async (itemId, qty) => {
+        const res = await this.request(`/inventory/spend`, "POST", { itemId, qty });
         this.emit("inventoryChange", {
-          rewardId,
+          itemId,
           delta: -qty,
           newTotal: res.newTotal
         });
@@ -308,12 +308,26 @@ class PlaycademyClient {
       pauseGame: (gameId) => this.request(`/admin/games/${gameId}/pause`, "POST"),
       resumeGame: (gameId) => this.request(`/admin/games/${gameId}/resume`, "POST")
     },
-    rewards: {
-      createReward: (props) => this.request("/rewards", "POST", props),
-      getReward: (rewardId) => this.request(`/rewards/${rewardId}`, "GET"),
-      listRewards: () => this.request("/rewards", "GET"),
-      updateReward: (rewardId, props) => this.request(`/rewards/${rewardId}`, "PATCH", props),
-      deleteReward: (rewardId) => this.request(`/rewards/${rewardId}`, "DELETE")
+    items: {
+      createItem: (props) => this.request("/items", "POST", props),
+      getItem: (itemId) => this.request(`/items/${itemId}`, "GET"),
+      listItems: () => this.request("/items", "GET"),
+      updateItem: (itemId, props) => this.request(`/items/${itemId}`, "PATCH", props),
+      deleteItem: (itemId) => this.request(`/items/${itemId}`, "DELETE")
+    },
+    currencies: {
+      createCurrency: (props) => this.request("/currencies", "POST", props),
+      getCurrency: (currencyId) => this.request(`/currencies/${currencyId}`, "GET"),
+      listCurrencies: () => this.request("/currencies", "GET"),
+      updateCurrency: (currencyId, props) => this.request(`/currencies/${currencyId}`, "PATCH", props),
+      deleteCurrency: (currencyId) => this.request(`/currencies/${currencyId}`, "DELETE")
+    },
+    shopListings: {
+      createListing: (props) => this.request("/shop-listings", "POST", props),
+      getListing: (listingId) => this.request(`/shop-listings/${listingId}`, "GET"),
+      listListings: () => this.request("/shop-listings", "GET"),
+      updateListing: (listingId, props) => this.request(`/shop-listings/${listingId}`, "PATCH", props),
+      deleteListing: (listingId) => this.request(`/shop-listings/${listingId}`, "DELETE")
     }
   };
   telemetry = {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { User, InventoryItemWithReward, Game, DeveloperKey, DeveloperStatusResponse, MapElement, Reward, InsertReward, ManifestV1, UpdateReward } from '@playcademy/types';
+import type { User, InventoryItemWithItem, Game, DeveloperKey, DeveloperStatusResponse, MapElement, Item, InsertItem, ManifestV1, UpdateItem, Currency, InsertCurrency, UpdateCurrency, ShopListing, InsertShopListing, UpdateShopListing } from '@playcademy/types';
 export interface ClientConfig {
     baseUrl: string;
     token?: string;
@@ -9,7 +9,7 @@ export interface ClientEvents {
         token: string | null;
     };
     inventoryChange: {
-        rewardId: string;
+        itemId: string;
         delta: number;
         newTotal: number;
     };
@@ -40,4 +40,4 @@ export type StartSessionResponse = {
 export type InventoryMutationResponse = {
     newTotal: number;
 };
-export type { User, InventoryItemWithReward, Game, ManifestV1, DeveloperKey, DeveloperStatusResponse, MapElement, Reward, InsertReward, UpdateReward, };
+export type { User, InventoryItemWithItem, Game, ManifestV1, DeveloperKey, DeveloperStatusResponse, MapElement, Item, InsertItem, UpdateItem, Currency, InsertCurrency, UpdateCurrency, ShopListing, InsertShopListing, UpdateShopListing, };

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@playcademy/sdk",
     "type": "module",
-    "version": "0.0.1-beta.11",
+    "version": "0.0.1-beta.13",
     "exports": {
         ".": {
             "import": "./dist/runtime.js",