@playcademy/sdk 0.0.1-beta.23 → 0.0.1-beta.25

package/dist/core/client.d.ts

@@ -106,8 +106,6 @@ export declare class PlaycademyClient {
     users: {
         me: () => Promise<{
             id: string;
-            createdAt: Date;
-            updatedAt: Date;
             name: string;
             username: string | null;
             email: string;
@@ -115,6 +113,8 @@ export declare class PlaycademyClient {
             image: string | null;
             role: "admin" | "player" | "developer";
             developerStatus: "none" | "pending" | "approved";
+            createdAt: Date;
+            updatedAt: Date;
         }>;
         inventory: {
             get: () => Promise<import("@playcademy/types").InventoryItemWithItem[]>;
@@ -136,14 +136,14 @@ export declare class PlaycademyClient {
             delete: (gameId: string) => Promise<void>;
         };
         keys: {
-            createKey: (gameId: string, label?: string) => Promise<{
+            createKey: (label?: string) => Promise<{
                 id: string;
                 createdAt: Date;
                 userId: string;
                 label: string | null;
                 keyHash: string;
             }>;
-            listKeys: (gameId: string) => Promise<{
+            listKeys: () => Promise<{
                 id: string;
                 createdAt: Date;
                 userId: string;
@@ -152,6 +152,22 @@ export declare class PlaycademyClient {
             }[]>;
             revokeKey: (keyId: string) => Promise<void>;
         };
+        items: {
+            create: (gameId: string, slug: string, itemData: Omit<import("@playcademy/types").InsertItem, "slug" | "gameId">) => Promise<import("@playcademy/types").Item>;
+            update: (gameId: string, itemId: string, updates: import("@playcademy/types").UpdateItem) => Promise<import("@playcademy/types").Item>;
+            list: (gameId: string) => Promise<Array<import("@playcademy/types").Item>>;
+            get: (gameId: string, slug: string) => Promise<import("@playcademy/types").Item>;
+            delete: (gameId: string, itemId: string) => Promise<void>;
+            shop: {
+                create: (gameId: string, itemId: string, listingData: Omit<import("@playcademy/types").InsertShopListing, "itemId">) => Promise<import("@playcademy/types").ShopListing>;
+                get: (gameId: string, itemId: string) => Promise<import("@playcademy/types").ShopListing | null>;
+                update: (gameId: string, itemId: string, updates: import("@playcademy/types").UpdateShopListing) => Promise<import("@playcademy/types").ShopListing>;
+                delete: (gameId: string, itemId: string) => Promise<void>;
+                list: (gameId: string) => Promise<Array<import("@playcademy/types").ShopListing & {
+                    item: import("@playcademy/types").Item;
+                }>>;
+            };
+        };
     };
     /** Map methods (elements) */
     maps: {
@@ -178,42 +194,46 @@ export declare class PlaycademyClient {
         items: {
             create: (props: import("@playcademy/types").InsertItem) => Promise<{
                 id: string;
+                createdAt: Date;
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 displayName: string;
                 metadata: unknown;
-                createdAt: Date;
-                internalName: string;
+                gameId: string | null;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 imageUrl: string | null;
             }>;
             get: (itemId: string) => Promise<{
                 id: string;
+                createdAt: Date;
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 displayName: string;
                 metadata: unknown;
-                createdAt: Date;
-                internalName: string;
+                gameId: string | null;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 imageUrl: string | null;
             }>;
             list: () => Promise<{
                 id: string;
+                createdAt: Date;
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 displayName: string;
                 metadata: unknown;
-                createdAt: Date;
-                internalName: string;
+                gameId: string | null;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 imageUrl: string | null;
             }[]>;
             update: (itemId: string, props: import("@playcademy/types").UpdateItem) => Promise<{
                 id: string;
+                createdAt: Date;
+                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+                slug: string;
                 displayName: string;
                 metadata: unknown;
-                createdAt: Date;
-                internalName: string;
+                gameId: string | null;
                 description: string | null;
-                type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
                 imageUrl: string | null;
             }>;
             delete: (itemId: string) => Promise<void>;

package/dist/core/namespaces/admin.d.ts

@@ -61,12 +61,13 @@ export declare function createAdminNamespace(client: PlaycademyClient): {
          */
         create: (props: InsertItem) => Promise<{
             id: string;
+            createdAt: Date;
+            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+            slug: string;
             displayName: string;
             metadata: unknown;
-            createdAt: Date;
-            internalName: string;
+            gameId: string | null;
             description: string | null;
-            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
             imageUrl: string | null;
         }>;
         /**
@@ -83,12 +84,13 @@ export declare function createAdminNamespace(client: PlaycademyClient): {
          */
         get: (itemId: string) => Promise<{
             id: string;
+            createdAt: Date;
+            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+            slug: string;
             displayName: string;
             metadata: unknown;
-            createdAt: Date;
-            internalName: string;
+            gameId: string | null;
             description: string | null;
-            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
             imageUrl: string | null;
         }>;
         /**
@@ -104,12 +106,13 @@ export declare function createAdminNamespace(client: PlaycademyClient): {
          */
         list: () => Promise<{
             id: string;
+            createdAt: Date;
+            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+            slug: string;
             displayName: string;
             metadata: unknown;
-            createdAt: Date;
-            internalName: string;
+            gameId: string | null;
             description: string | null;
-            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
             imageUrl: string | null;
         }[]>;
         /**
@@ -128,12 +131,13 @@ export declare function createAdminNamespace(client: PlaycademyClient): {
          */
         update: (itemId: string, props: UpdateItem) => Promise<{
             id: string;
+            createdAt: Date;
+            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
+            slug: string;
             displayName: string;
             metadata: unknown;
-            createdAt: Date;
-            internalName: string;
+            gameId: string | null;
             description: string | null;
-            type: "currency" | "badge" | "trophy" | "collectible" | "consumable" | "unlock" | "upgrade" | "other";
             imageUrl: string | null;
         }>;
         /**

package/dist/core/namespaces/dev.d.ts

@@ -1,12 +1,12 @@
 import type { PlaycademyClient } from '../client';
-import type { Game, UpsertGameMetadataInput } from '@playcademy/types';
+import type { Game, UpsertGameMetadataInput, Item, InsertItem, UpdateItem, ShopListing, InsertShopListing, UpdateShopListing } from '@playcademy/types';
 import type { DeveloperStatusValue } from '../../types';
 /**
  * Creates the developer namespace for the PlaycademyClient.
- * Provides methods for developer account management, game publishing, and API key management.
+ * Provides methods for developer account management, game publishing, API key management, and item management.
  *
  * @param client - The PlaycademyClient instance
- * @returns Developer namespace with auth, games, and keys methods
+ * @returns Developer namespace with auth, games, keys, and items methods
  */
 export declare function createDevNamespace(client: PlaycademyClient): {
     /**
@@ -97,19 +97,18 @@ export declare function createDevNamespace(client: PlaycademyClient): {
      */
     keys: {
         /**
-         * Creates a new API key for a game.
+         * Creates a new API key for the developer.
          *
-         * @param gameId - The game ID to create a key for
          * @param label - Optional label for the key
          * @returns Promise resolving to the created API key
          *
          * @example
          * ```typescript
-         * const key = await client.dev.keys.createKey('game-123', 'Production Key')
-         * console.log('API Key:', key.key)
+         * const key = await client.dev.keys.createKey('Production Key')
+         * console.log('API Key:', key.apiKey)
          * ```
          */
-        createKey: (gameId: string, label?: string) => Promise<{
+        createKey: (label?: string) => Promise<{
             id: string;
             createdAt: Date;
             userId: string;
@@ -117,18 +116,17 @@ export declare function createDevNamespace(client: PlaycademyClient): {
             keyHash: string;
         }>;
         /**
-         * Lists all API keys for a game.
+         * Lists all API keys for the developer.
          *
-         * @param gameId - The game ID to list keys for
          * @returns Promise resolving to array of API keys
          *
          * @example
          * ```typescript
-         * const keys = await client.dev.keys.listKeys('game-123')
-         * keys.forEach(key => console.log(`${key.label}: ${key.key}`))
+         * const keys = await client.dev.keys.listKeys()
+         * keys.forEach(key => console.log(`${key.label}: ${key.id}`))
          * ```
          */
-        listKeys: (gameId: string) => Promise<{
+        listKeys: () => Promise<{
             id: string;
             createdAt: Date;
             userId: string;
@@ -149,4 +147,177 @@ export declare function createDevNamespace(client: PlaycademyClient): {
          */
         revokeKey: (keyId: string) => Promise<void>;
     };
+    /**
+     * Item management methods for developers.
+     * Allows developers to create and manage game-specific items.
+     */
+    items: {
+        /**
+         * Creates a new game-scoped item.
+         *
+         * @param gameId - The game ID to create the item for
+         * @param slug - The item slug (unique within the game)
+         * @param itemData - Item properties (displayName, description, type, etc.)
+         * @returns Promise resolving to the created item
+         *
+         * @example
+         * ```typescript
+         * const item = await client.dev.items.create('game-123', 'MAGIC_SWORD', {
+         *   displayName: 'Magic Sword',
+         *   description: 'A powerful enchanted blade',
+         *   type: 'unlock',
+         *   metadata: { rarity: 'epic' }
+         * })
+         * ```
+         */
+        create: (gameId: string, slug: string, itemData: Omit<InsertItem, "slug" | "gameId">) => Promise<Item>;
+        /**
+         * Updates an existing game-scoped item.
+         *
+         * @param gameId - The game ID
+         * @param itemId - The item ID to update
+         * @param updates - Partial item properties to update
+         * @returns Promise resolving to the updated item
+         *
+         * @example
+         * ```typescript
+         * const updated = await client.dev.items.update('game-123', 'item-456', {
+         *   displayName: 'Super Magic Sword',
+         *   metadata: { rarity: 'legendary' }
+         * })
+         * ```
+         */
+        update: (gameId: string, itemId: string, updates: UpdateItem) => Promise<Item>;
+        /**
+         * Lists all items for a specific game.
+         *
+         * @param gameId - The game ID to list items for
+         * @returns Promise resolving to array of game-scoped items
+         *
+         * @example
+         * ```typescript
+         * const items = await client.dev.items.list('game-123')
+         * items.forEach(item => console.log(`${item.slug}: ${item.displayName}`))
+         * ```
+         */
+        list: (gameId: string) => Promise<Array<Item>>;
+        /**
+         * Gets a specific item by slug within a game context.
+         * Uses the resolution endpoint to find the item.
+         *
+         * @param gameId - The game ID context
+         * @param slug - The item slug to retrieve
+         * @returns Promise resolving to the item
+         *
+         * @example
+         * ```typescript
+         * const item = await client.dev.items.get('game-123', 'MAGIC_SWORD')
+         * console.log('Item:', item.displayName)
+         * ```
+         */
+        get: (gameId: string, slug: string) => Promise<Item>;
+        /**
+         * Deletes a game-scoped item.
+         *
+         * @param gameId - The game ID
+         * @param itemId - The item ID to delete
+         * @returns Promise that resolves when item is deleted
+         *
+         * @example
+         * ```typescript
+         * await client.dev.items.delete('game-123', 'item-456')
+         * console.log('Item deleted successfully')
+         * ```
+         */
+        delete: (gameId: string, itemId: string) => Promise<void>;
+        /**
+         * Shop listing management for game items.
+         * Allows developers to control if and how their items are sold.
+         */
+        shop: {
+            /**
+             * Creates a shop listing for a game item.
+             *
+             * @param gameId - The game ID
+             * @param itemId - The item ID to list for sale
+             * @param listingData - Shop listing properties (price, currency, etc.)
+             * @returns Promise resolving to the created shop listing
+             *
+             * @example
+             * ```typescript
+             * const listing = await client.dev.items.shop.create('game-123', 'item-456', {
+             *   currencyId: 'credits-currency-id',
+             *   price: 100,
+             *   sellBackPercentage: 50,
+             *   isActive: true
+             * })
+             * ```
+             */
+            create: (gameId: string, itemId: string, listingData: Omit<InsertShopListing, "itemId">) => Promise<ShopListing>;
+            /**
+             * Gets the shop listing for a specific game item.
+             *
+             * @param gameId - The game ID
+             * @param itemId - The item ID
+             * @returns Promise resolving to the shop listing, or null if no listing exists
+             *
+             * @example
+             * ```typescript
+             * const listing = await client.dev.items.shop.get('game-123', 'item-456')
+             * if (listing) {
+             *   console.log(`Item is listed for ${listing.price} credits`)
+             * }
+             * ```
+             */
+            get: (gameId: string, itemId: string) => Promise<ShopListing | null>;
+            /**
+             * Updates an existing shop listing for a game item.
+             *
+             * @param gameId - The game ID
+             * @param itemId - The item ID
+             * @param updates - Partial shop listing properties to update
+             * @returns Promise resolving to the updated shop listing
+             *
+             * @example
+             * ```typescript
+             * const updated = await client.dev.items.shop.update('game-123', 'item-456', {
+             *   price: 150,
+             *   isActive: false
+             * })
+             * ```
+             */
+            update: (gameId: string, itemId: string, updates: UpdateShopListing) => Promise<ShopListing>;
+            /**
+             * Removes the shop listing for a game item.
+             *
+             * @param gameId - The game ID
+             * @param itemId - The item ID
+             * @returns Promise that resolves when listing is removed
+             *
+             * @example
+             * ```typescript
+             * await client.dev.items.shop.delete('game-123', 'item-456')
+             * console.log('Item removed from shop')
+             * ```
+             */
+            delete: (gameId: string, itemId: string) => Promise<void>;
+            /**
+             * Lists all shop listings for a game.
+             *
+             * @param gameId - The game ID
+             * @returns Promise resolving to array of shop listings for the game
+             *
+             * @example
+             * ```typescript
+             * const listings = await client.dev.items.shop.list('game-123')
+             * listings.forEach(listing => {
+             *   console.log(`${listing.item.displayName}: ${listing.price}`)
+             * })
+             * ```
+             */
+            list: (gameId: string) => Promise<Array<ShopListing & {
+                item: Item;
+            }>>;
+        };
+    };
 };

package/dist/core/namespaces/users.d.ts

@@ -22,8 +22,6 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
      */
     me: () => Promise<{
         id: string;
-        createdAt: Date;
-        updatedAt: Date;
         name: string;
         username: string | null;
         email: string;
@@ -31,6 +29,8 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
         image: string | null;
         role: "admin" | "player" | "developer";
         developerStatus: "none" | "pending" | "approved";
+        createdAt: Date;
+        updatedAt: Date;
     }>;
     /**
      * Inventory management methods for the current user.
@@ -52,17 +52,17 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
         get: () => Promise<InventoryItemWithItem[]>;
         /**
          * Adds items to the user's inventory.
-         * Accepts either an item UUID or internal name.
+         * Accepts either an item UUID or slug.
          * Emits an 'inventoryChange' event when successful.
          *
-         * @param identifier - The item UUID or internal name
+         * @param identifier - The item UUID or slug
          * @param qty - The quantity to add (must be positive)
          * @returns Promise resolving to mutation response with new total
          *
          * @example
          * ```typescript
-         * // Using internal name
-         * const result = await client.users.inventory.add('GOLD_COIN', 100)
+         * // Using slug
+         * const result = await client.users.inventory.add('gold-coin', 100)
          *
          * // Using UUID
          * const result = await client.users.inventory.add('550e8400-e29b-41d4-a716-446655440000', 100)
@@ -73,16 +73,16 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
         add: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
         /**
          * Removes items from the user's inventory.
-         * Accepts either an item UUID or internal name.
+         * Accepts either an item UUID or slug.
          * Emits an 'inventoryChange' event when successful.
          *
-         * @param identifier - The item UUID or internal name
+         * @param identifier - The item UUID or slug
          * @param qty - The quantity to remove (must be positive)
          * @returns Promise resolving to mutation response with new total
          *
          * @example
          * ```typescript
-         * // Using internal name
+         * // Using slug
          * const result = await client.users.inventory.remove('HEALTH_POTION', 1)
          *
          * // Using UUID
@@ -94,14 +94,14 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
         remove: (identifier: string, qty: number) => Promise<InventoryMutationResponse>;
         /**
          * Gets the current quantity of an item.
-         * Accepts either an item UUID or internal name.
+         * Accepts either an item UUID or slug.
          *
-         * @param identifier - The item UUID or internal name
+         * @param identifier - The item UUID or slug
          * @returns Promise resolving to the current quantity (0 if not owned)
          *
          * @example
          * ```typescript
-         * const qty = await client.users.inventory.quantity('HEALTH_POTION')
+         * const qty = await client.users.inventory.quantity('health-potion')
          * const qty2 = await client.users.inventory.quantity('uuid-123-456')
          * console.log('Health potions:', qty)
          * ```
@@ -109,16 +109,16 @@ export declare function createUsersNamespace(client: PlaycademyClient): {
         quantity: (identifier: string) => Promise<number>;
         /**
          * Checks if the user has at least the specified quantity of an item.
-         * Accepts either an item UUID or internal name.
+         * Accepts either an item UUID or slug.
          *
-         * @param identifier - The item UUID or internal name
+         * @param identifier - The item UUID or slug
          * @param minQuantity - Minimum quantity required (defaults to 1)
          * @returns Promise resolving to true if user has enough of the item
          *
          * @example
          * ```typescript
-         * const hasKey = await client.users.inventory.has('DUNGEON_KEY')
-         * const hasEnoughGold = await client.users.inventory.has('GOLD_COIN', 100)
+         * const hasKey = await client.users.inventory.has('gold-coin')
+         * const hasEnoughGold = await client.users.inventory.has('gold-coin', 100)
          * const hasPotion = await client.users.inventory.has('uuid-123-456', 5)
          *
          * if (hasKey && hasEnoughGold) {