@rtsdk/topia 0.19.0 → 0.19.1

package/dist/index.cjs

@@ -40683,6 +40683,32 @@ class DroppedAsset extends Asset {
             }
         });
     }
+    /**
+     * Checks if this dropped asset exists with the current app's public key installed.
+     *
+     * @keywords check, exists, verify, validate, lookup
+     *
+     * @example
+     * ```ts
+     * const { exists } = await droppedAsset.checkExists();
+     * ```
+     *
+     * @returns {Promise<{ exists: boolean }>} Returns whether the asset exists with the app's public key.
+     */
+    checkExists() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/dropped-asset/${this.id}/exists`, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({
+                    error,
+                    sdkMethod: "DroppedAsset.checkExists",
+                });
+            }
+        });
+    }
     /**
      * Retrieve analytics for a dropped asset by day, week, month, quarter, or year
      *
@@ -41013,7 +41039,7 @@ class UserInventoryItem extends InventoryItem {
         super(topia, item_id, { attributes: options.attributes, credentials: options.credentials });
         Object.assign(this, options.attributes);
         this.userItemId = id;
-        const { user_id = "", quantity = 0, grant_source = "unknown", type = "unknown", metadata = {}, created_at = new Date(), updated_at = new Date(), } = options.attributes;
+        const { user_id = "", quantity = 0, grant_source = "unknown", type = "unknown", metadata = {}, created_at = new Date(), updated_at = new Date(), profile_id = null, } = options.attributes;
         this.item_id = item_id;
         this.quantity = quantity;
         this.grant_source = grant_source;
@@ -41022,6 +41048,7 @@ class UserInventoryItem extends InventoryItem {
         this.metadata = metadata;
         this.created_at = created_at;
         this.updated_at = updated_at;
+        this.profile_id = profile_id;
     }
     /**
      * Fetches the user inventory item details from the platform and assigns them to this instance.
@@ -43456,27 +43483,31 @@ class Visitor extends User {
     }
     /**
      * Modifies the quantity of an inventory item in this visitor's inventory.
+     * Supports upsert behavior - if the visitor doesn't own the item yet, it will be granted first.
      *
-     * @param item The UserInventoryItem to modify.
-     * @param quantity The new quantity to set.
+     * @param item Either a UserInventoryItem (for owned items) or an InventoryItem (for upsert).
+     * @param quantity The quantity delta to apply (positive to add, negative to subtract).
      *
      * @example
      * ```ts
-     * await visitor.modifyInventoryItemQuantity("item-id-123", 5);
+     * // Modify an existing user inventory item
+     * await visitor.modifyInventoryItemQuantity(userItem, 5);
+     *
+     * // Upsert: grant if not owned, or modify if already owned
+     * await visitor.modifyInventoryItemQuantity(inventoryItem, 1);
      * ```
      *
      * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
      */
     modifyInventoryItemQuantity(item, quantity) {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            // Check for existence in #visitorInventoryItems
-            const found = (_a = __classPrivateFieldGet(this, _Visitor_visitorInventoryItems, "f")) === null || _a === void 0 ? void 0 : _a.some((visitorItem) => visitorItem.id === item.userItemId);
-            if (!found) {
-                throw new Error(`Inventory item with id '${item.userItemId}' does not exist in visitorInventoryItems.`);
-            }
             try {
-                const response = yield this.topiaPublicApi().put(`/world/${this.urlSlug}/visitors/${this.id}/update-visitor-inventory-item-quantity`, { userItemId: item.id, itemId: item.item_id, quantity }, this.requestOptions);
+                // Determine if item is a UserInventoryItem (has userItemId) or InventoryItem (only has id)
+                const isUserItem = "userItemId" in item && item.userItemId;
+                const body = isUserItem
+                    ? { userItemId: item.userItemId, itemId: item.item_id, quantity }
+                    : { itemId: item.id, quantity };
+                const response = yield this.topiaPublicApi().put(`/world/${this.urlSlug}/visitors/${this.id}/update-visitor-inventory-item-quantity`, body, this.requestOptions);
                 const userInventoryItemFactory = new UserInventoryItemFactory(this.topia);
                 const { inventoryItem, user_id, quantity: newQuantity } = response.data;
                 return userInventoryItemFactory.create(inventoryItem, user_id, newQuantity, {

package/dist/index.d.ts

@@ -651,6 +651,21 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
         isInteractive?: boolean;
         interactivePublicKey: string;
     }): Promise<void | ResponseType$1>;
+    /**
+     * Checks if this dropped asset exists with the current app's public key installed.
+     *
+     * @keywords check, exists, verify, validate, lookup
+     *
+     * @example
+     * ```ts
+     * const { exists } = await droppedAsset.checkExists();
+     * ```
+     *
+     * @returns {Promise<{ exists: boolean }>} Returns whether the asset exists with the app's public key.
+     */
+    checkExists(): Promise<{
+        exists: boolean;
+    }>;
     /**
      * Retrieve analytics for a dropped asset by day, week, month, quarter, or year
      *
@@ -1190,6 +1205,7 @@ declare class UserInventoryItem extends InventoryItem implements UserInventoryIt
     metadata?: object | null;
     grant_source: string;
     type: string;
+    profile_id?: string | null;
     constructor(topia: Topia, id: string, options?: UserInventoryItemOptionalInterface);
     /**
      * Fetches the user inventory item details from the platform and assigns them to this instance.
@@ -2143,18 +2159,23 @@ declare class Visitor extends User implements VisitorInterface {
     grantInventoryItem(item: InventoryItem, quantity?: number): Promise<UserInventoryItem>;
     /**
      * Modifies the quantity of an inventory item in this visitor's inventory.
+     * Supports upsert behavior - if the visitor doesn't own the item yet, it will be granted first.
      *
-     * @param item The UserInventoryItem to modify.
-     * @param quantity The new quantity to set.
+     * @param item Either a UserInventoryItem (for owned items) or an InventoryItem (for upsert).
+     * @param quantity The quantity delta to apply (positive to add, negative to subtract).
      *
      * @example
      * ```ts
-     * await visitor.modifyInventoryItemQuantity("item-id-123", 5);
+     * // Modify an existing user inventory item
+     * await visitor.modifyInventoryItemQuantity(userItem, 5);
+     *
+     * // Upsert: grant if not owned, or modify if already owned
+     * await visitor.modifyInventoryItemQuantity(inventoryItem, 1);
      * ```
      *
      * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
      */
-    modifyInventoryItemQuantity(item: UserInventoryItem, quantity: number): Promise<UserInventoryItem>;
+    modifyInventoryItemQuantity(item: UserInventoryItem | InventoryItem, quantity: number): Promise<UserInventoryItem>;
 }
 
 type VisitorType = {
@@ -2778,6 +2799,7 @@ interface UserInventoryItemInterface extends InventoryItemInterface {
     updated_at?: Date;
     metadata?: object | null;
     grant_source: string;
+    profile_id?: string | null;
 }
 type UserInventoryItemOptionalInterface = {
     attributes?: UserInventoryItemInterface | object;

package/dist/index.js

@@ -40681,6 +40681,32 @@ class DroppedAsset extends Asset {
             }
         });
     }
+    /**
+     * Checks if this dropped asset exists with the current app's public key installed.
+     *
+     * @keywords check, exists, verify, validate, lookup
+     *
+     * @example
+     * ```ts
+     * const { exists } = await droppedAsset.checkExists();
+     * ```
+     *
+     * @returns {Promise<{ exists: boolean }>} Returns whether the asset exists with the app's public key.
+     */
+    checkExists() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/dropped-asset/${this.id}/exists`, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({
+                    error,
+                    sdkMethod: "DroppedAsset.checkExists",
+                });
+            }
+        });
+    }
     /**
      * Retrieve analytics for a dropped asset by day, week, month, quarter, or year
      *
@@ -41011,7 +41037,7 @@ class UserInventoryItem extends InventoryItem {
         super(topia, item_id, { attributes: options.attributes, credentials: options.credentials });
         Object.assign(this, options.attributes);
         this.userItemId = id;
-        const { user_id = "", quantity = 0, grant_source = "unknown", type = "unknown", metadata = {}, created_at = new Date(), updated_at = new Date(), } = options.attributes;
+        const { user_id = "", quantity = 0, grant_source = "unknown", type = "unknown", metadata = {}, created_at = new Date(), updated_at = new Date(), profile_id = null, } = options.attributes;
         this.item_id = item_id;
         this.quantity = quantity;
         this.grant_source = grant_source;
@@ -41020,6 +41046,7 @@ class UserInventoryItem extends InventoryItem {
         this.metadata = metadata;
         this.created_at = created_at;
         this.updated_at = updated_at;
+        this.profile_id = profile_id;
     }
     /**
      * Fetches the user inventory item details from the platform and assigns them to this instance.
@@ -43454,27 +43481,31 @@ class Visitor extends User {
     }
     /**
      * Modifies the quantity of an inventory item in this visitor's inventory.
+     * Supports upsert behavior - if the visitor doesn't own the item yet, it will be granted first.
      *
-     * @param item The UserInventoryItem to modify.
-     * @param quantity The new quantity to set.
+     * @param item Either a UserInventoryItem (for owned items) or an InventoryItem (for upsert).
+     * @param quantity The quantity delta to apply (positive to add, negative to subtract).
      *
      * @example
      * ```ts
-     * await visitor.modifyInventoryItemQuantity("item-id-123", 5);
+     * // Modify an existing user inventory item
+     * await visitor.modifyInventoryItemQuantity(userItem, 5);
+     *
+     * // Upsert: grant if not owned, or modify if already owned
+     * await visitor.modifyInventoryItemQuantity(inventoryItem, 1);
      * ```
      *
      * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
      */
     modifyInventoryItemQuantity(item, quantity) {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            // Check for existence in #visitorInventoryItems
-            const found = (_a = __classPrivateFieldGet(this, _Visitor_visitorInventoryItems, "f")) === null || _a === void 0 ? void 0 : _a.some((visitorItem) => visitorItem.id === item.userItemId);
-            if (!found) {
-                throw new Error(`Inventory item with id '${item.userItemId}' does not exist in visitorInventoryItems.`);
-            }
             try {
-                const response = yield this.topiaPublicApi().put(`/world/${this.urlSlug}/visitors/${this.id}/update-visitor-inventory-item-quantity`, { userItemId: item.id, itemId: item.item_id, quantity }, this.requestOptions);
+                // Determine if item is a UserInventoryItem (has userItemId) or InventoryItem (only has id)
+                const isUserItem = "userItemId" in item && item.userItemId;
+                const body = isUserItem
+                    ? { userItemId: item.userItemId, itemId: item.item_id, quantity }
+                    : { itemId: item.id, quantity };
+                const response = yield this.topiaPublicApi().put(`/world/${this.urlSlug}/visitors/${this.id}/update-visitor-inventory-item-quantity`, body, this.requestOptions);
                 const userInventoryItemFactory = new UserInventoryItemFactory(this.topia);
                 const { inventoryItem, user_id, quantity: newQuantity } = response.data;
                 return userInventoryItemFactory.create(inventoryItem, user_id, newQuantity, {

package/package.json

@@ -61,5 +61,5 @@
     "yalc-push": "yarn build && yalc publish --push --dev --no-scripts"
   },
   "type": "module",
-  "version": "0.19.00"
+  "version": "0.19.01"
 }