@playcademy/sdk 0.0.1-beta.12 → 0.0.1-beta.14

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, InsertItem, UpdateItem } from '@playcademy/types';
-import type { GameState, InventoryItemWithItem, 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, ShopViewResponse } from '../types';
 export declare class PlaycademyClient {
     private baseUrl;
     private token?;
@@ -105,40 +105,145 @@ export declare class PlaycademyClient {
                 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;
             }>;
             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;
             }>;
             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;
             }[]>;
             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;
+            }>;
+            deleteListing: (listingId: string) => Promise<void>;
+        };
+    };
+    shop: {
+        view: () => Promise<ShopViewResponse>;
     };
     telemetry: {
         pushMetrics: (metrics: Record<string, number>) => Promise<void>;

package/dist/runtime.js

@@ -314,6 +314,25 @@ class PlaycademyClient {
       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")
+    }
+  };
+  shop = {
+    view: async () => {
+      return this.request("/shop/view", "GET");
     }
   };
   telemetry = {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { User, InventoryItemWithItem, Game, DeveloperKey, DeveloperStatusResponse, MapElement, Item, InsertItem, ManifestV1, UpdateItem } 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;
@@ -40,4 +40,24 @@ export type StartSessionResponse = {
 export type InventoryMutationResponse = {
     newTotal: number;
 };
-export type { User, InventoryItemWithItem, Game, ManifestV1, DeveloperKey, DeveloperStatusResponse, MapElement, Item, InsertItem, UpdateItem, };
+export interface ShopDisplayItem extends Item {
+    listingId: string;
+    shopPrice: string;
+    currencyId: string;
+    currencySymbol?: string | null;
+    currencyImageUrl?: string | null;
+    stock?: number | null;
+    sellBackPercentage?: number | null;
+}
+export interface UserCurrencyInfo {
+    id: string;
+    balance: number;
+    symbol?: string | null;
+    imageUrl?: string | null;
+    isPrimary: boolean;
+}
+export interface ShopViewResponse {
+    shopItems: ShopDisplayItem[];
+    userCurrencies: UserCurrencyInfo[];
+}
+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.12",
+    "version": "0.0.1-beta.14",
     "exports": {
         ".": {
             "import": "./dist/runtime.js",