@rtsdk/topia 0.19.2 → 0.19.4

package/dist/index.d.ts

@@ -106,7 +106,7 @@ type WorldOptions = {
     credentials?: InteractiveCredentials | undefined;
 };
 
-type ResponseType$1 = {
+type ResponseType = {
     message?: string;
     statusCode?: number;
     success?: boolean;
@@ -139,7 +139,7 @@ declare class Scene extends SDKController implements SceneInterface {
      * const { name } = scene;
      * ```
      */
-    fetchSceneById(): Promise<void | ResponseType$1>;
+    fetchSceneById(): Promise<void | ResponseType>;
 }
 
 /**
@@ -178,7 +178,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      * const { assetName } = droppedAsset;
      * ```
      */
-    fetchDroppedAssetById(): Promise<void | ResponseType$1>;
+    fetchDroppedAssetById(): Promise<void | ResponseType>;
     /**
      * Updates dropped asset details and assigns the response data to the instance. Requires Public Key to have the `canUpdateDroppedAssets` permission.
      *
@@ -211,7 +211,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      * const { assetName } = droppedAsset;
      * ```
      */
-    updateDroppedAsset({ assetScale, audioRadius, audioSliderVolume, clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, flipped, isInteractive, isTextTopLayer, isVideo, interactivePublicKey, layer0, layer1, mediaLink, mediaName, mediaType, portalName, position, specialType, syncUserMedia, text, textColor, textSize, textWeight, textWidth, uniqueName, yOrderAdjust, }: UpdateDroppedAssetInterface): Promise<void | ResponseType$1>;
+    updateDroppedAsset({ assetScale, audioRadius, audioSliderVolume, clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, flipped, isInteractive, isTextTopLayer, isVideo, interactivePublicKey, layer0, layer1, mediaLink, mediaName, mediaType, portalName, position, specialType, syncUserMedia, text, textColor, textSize, textWeight, textWidth, uniqueName, yOrderAdjust, }: UpdateDroppedAssetInterface): Promise<void | ResponseType>;
     /**
      * Deletes the dropped asset (removes it from the world).
      *
@@ -222,7 +222,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      * await droppedAsset.deleteDroppedAsset();
      * ```
      */
-    deleteDroppedAsset(): Promise<void | ResponseType$1>;
+    deleteDroppedAsset(): Promise<void | ResponseType>;
     /**
      * Retrieves the data object for a dropped asset.
      *
@@ -237,7 +237,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the data object or an error response.
      */
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
     /**
      * Sets the data object for a dropped asset and assigns the response data to the instance.
      *
@@ -271,7 +271,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates the data object for a dropped asset and assigns the response data to the instance.
      *
@@ -302,7 +302,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Increments a specific value in the data object for a dropped asset by the amount specified. Must have valid interactive credentials from a visitor in the world.
      *
@@ -328,7 +328,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates broadcast options for a dropped asset.
      *
@@ -345,7 +345,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateBroadcast({ assetBroadcast, assetBroadcastAll, broadcasterEmail, }: UpdateBroadcastInterface): Promise<void | ResponseType$1>;
+    updateBroadcast({ assetBroadcast, assetBroadcastAll, broadcasterEmail, }: UpdateBroadcastInterface): Promise<void | ResponseType>;
     /**
      * Updates click options for a dropped asset.
      *
@@ -369,7 +369,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateClickType({ clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, isForceLinkInIframe, isOpenLinkInDrawer, portalName, position, }: UpdateClickTypeInterface): Promise<void | ResponseType$1>;
+    updateClickType({ clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, isForceLinkInIframe, isOpenLinkInDrawer, portalName, position, }: UpdateClickTypeInterface): Promise<void | ResponseType>;
     /**
      * Adds an array of links to an asset. Maximum is 20 links.
      *
@@ -397,7 +397,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    setClickableLinkMulti({ clickableLinks }: SetClickableLinkMultiInterface): Promise<void | ResponseType$1>;
+    setClickableLinkMulti({ clickableLinks }: SetClickableLinkMultiInterface): Promise<void | ResponseType>;
     /**
      * Updates multiple clickable links for a dropped asset.
      *
@@ -419,7 +419,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateClickableLinkMulti({ clickableLink, clickableLinkTitle, isForceLinkInIframe, isOpenLinkInDrawer, existingLinkId, linkSamlQueryParams, }: UpdateClickableLinkMultiInterface): Promise<void | ResponseType$1>;
+    updateClickableLinkMulti({ clickableLink, clickableLinkTitle, isForceLinkInIframe, isOpenLinkInDrawer, existingLinkId, linkSamlQueryParams, }: UpdateClickableLinkMultiInterface): Promise<void | ResponseType>;
     /**
      * Removes a clickable link from a dropped asset.
      *
@@ -432,7 +432,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    removeClickableLink({ linkId }: RemoveClickableLinkInterface): Promise<void | ResponseType$1>;
+    removeClickableLink({ linkId }: RemoveClickableLinkInterface): Promise<void | ResponseType>;
     /**
      * Updates text and style of a dropped asset.
      *
@@ -452,7 +452,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateCustomTextAsset(style: object | undefined | null, text: string | null | undefined): Promise<void | ResponseType$1>;
+    updateCustomTextAsset(style: object | undefined | null, text: string | null | undefined): Promise<void | ResponseType>;
     /**
      * Updates media options for a dropped asset.
      *
@@ -474,7 +474,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateMediaType({ audioRadius, audioSliderVolume, isVideo, mediaLink, mediaName, mediaType, portalName, syncUserMedia, }: UpdateMediaTypeInterface): Promise<void | ResponseType$1>;
+    updateMediaType({ audioRadius, audioSliderVolume, isVideo, mediaLink, mediaName, mediaType, portalName, syncUserMedia, }: UpdateMediaTypeInterface): Promise<void | ResponseType>;
     /**
      * Updates mute zone options for a dropped asset.
      *
@@ -487,7 +487,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateMuteZone(isMutezone: boolean): Promise<void | ResponseType$1>;
+    updateMuteZone(isMutezone: boolean): Promise<void | ResponseType>;
     /**
      * Updates landmark zone options for a dropped asset.
      *
@@ -508,7 +508,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
         isLandmarkZoneEnabled: boolean;
         landmarkZoneName?: string;
         landmarkZoneIsVisible?: boolean;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates webhook zone options for a dropped asset.
      *
@@ -521,7 +521,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateWebhookZone(isWebhookZoneEnabled: boolean): Promise<void | ResponseType$1>;
+    updateWebhookZone(isWebhookZoneEnabled: boolean): Promise<void | ResponseType>;
     /**
      * Moves a dropped asset to specified coordinates.
      *
@@ -534,7 +534,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updatePosition(x: number, y: number, yOrderAdjust?: number): Promise<void | ResponseType$1>;
+    updatePosition(x: number, y: number, yOrderAdjust?: number): Promise<void | ResponseType>;
     /**
      * Updates private zone options for a dropped asset.
      *
@@ -551,7 +551,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updatePrivateZone({ isPrivateZone, isPrivateZoneChatDisabled, privateZoneUserCap, }: UpdatePrivateZoneInterface): Promise<void | ResponseType$1>;
+    updatePrivateZone({ isPrivateZone, isPrivateZoneChatDisabled, privateZoneUserCap, }: UpdatePrivateZoneInterface): Promise<void | ResponseType>;
     /**
      * Updates the size of a dropped asset.
      *
@@ -564,7 +564,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateScale(assetScale: number): Promise<void | ResponseType$1>;
+    updateScale(assetScale: number): Promise<void | ResponseType>;
     /**
      * Flip an dropped asset.
      *
@@ -577,7 +577,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    flip(): Promise<void | ResponseType$1>;
+    flip(): Promise<void | ResponseType>;
     /**
      * Change or remove media embedded in a dropped asset.
      *
@@ -590,7 +590,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateUploadedMediaSelected(mediaId: string): Promise<void | ResponseType$1>;
+    updateUploadedMediaSelected(mediaId: string): Promise<void | ResponseType>;
     /**
      * Change or remove top and bottom layers of a dropped asset.
      *
@@ -603,7 +603,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the updated dropped asset or an error.
      */
-    updateWebImageLayers(bottom: string, top: string): Promise<void | ResponseType$1>;
+    updateWebImageLayers(bottom: string, top: string): Promise<void | ResponseType>;
     /**
      * Add a webhook to a dropped asset
      *
@@ -650,7 +650,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
     setInteractiveSettings({ isInteractive, interactivePublicKey, }: {
         isInteractive?: boolean;
         interactivePublicKey: string;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Checks if this dropped asset exists with the current app's public key installed.
      *
@@ -686,7 +686,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
         periodType: "week" | "month" | "quarter" | "year";
         dateValue: number;
         year: number;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
 }
 
 /**
@@ -724,7 +724,7 @@ declare class World extends SDKController implements WorldInterface {
      * const { name } = world;
      * ```
      */
-    fetchDetails(): Promise<void | ResponseType$1>;
+    fetchDetails(): Promise<void | ResponseType>;
     /**
      * Update details of a world.
      *
@@ -750,7 +750,7 @@ declare class World extends SDKController implements WorldInterface {
      * const { name, description } = world;
      * ```
      */
-    updateDetails({ controls, description, forceAuthOnLogin, height, name, spawnPosition, width, }: WorldDetailsInterface): Promise<void | ResponseType$1>;
+    updateDetails({ controls, description, forceAuthOnLogin, height, name, spawnPosition, width, }: WorldDetailsInterface): Promise<void | ResponseType>;
     /**
      * Set close world settings
      *
@@ -779,7 +779,7 @@ declare class World extends SDKController implements WorldInterface {
     updateCloseWorldSettings({ closeWorldDescription, isWorldClosed, }: {
         closeWorldDescription: string;
         isWorldClosed: boolean;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Retrieve all assets dropped in a world.
      *
@@ -793,7 +793,7 @@ declare class World extends SDKController implements WorldInterface {
      * const assets = world.droppedAssets;
      * ```
      */
-    fetchDroppedAssets(): Promise<void | ResponseType$1>;
+    fetchDroppedAssets(): Promise<void | ResponseType>;
     /**
      * Retrieve all assets dropped in a world matching uniqueName.
      *
@@ -888,7 +888,7 @@ declare class World extends SDKController implements WorldInterface {
      * { sceneDropIds: [] }
      * ```
      */
-    fetchSceneDropIds(): Promise<object | ResponseType$1>;
+    fetchSceneDropIds(): Promise<object | ResponseType>;
     /**
      * Fetch a list of all scene drop ids and dropped assets in a world
      *
@@ -920,7 +920,7 @@ declare class World extends SDKController implements WorldInterface {
      * }
      * ```
      */
-    fetchScenes(): Promise<object | ResponseType$1>;
+    fetchScenes(): Promise<object | ResponseType>;
     /**
      * Drops a scene in a world and returns sceneDropId.
      *
@@ -951,7 +951,7 @@ declare class World extends SDKController implements WorldInterface {
         position: object;
         sceneDropId?: string;
         sceneId: string;
-    }): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
     /**
      * Replace the current scene of a world.
      *
@@ -974,7 +974,7 @@ declare class World extends SDKController implements WorldInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    replaceScene(sceneId: string): Promise<void | ResponseType$1>;
+    replaceScene(sceneId: string): Promise<void | ResponseType>;
     /**
      * Get all particles available
      *
@@ -989,7 +989,7 @@ declare class World extends SDKController implements WorldInterface {
      * @returns {Promise<ResponseType>} Returns an array of particles or an error response.
      * ```
      */
-    getAllParticles(): Promise<object | ResponseType$1>;
+    getAllParticles(): Promise<object | ResponseType>;
     /**
      * Trigger a particle effect at a position in the world
      *
@@ -1011,7 +1011,7 @@ declare class World extends SDKController implements WorldInterface {
         name?: string;
         duration?: number;
         position?: object;
-    }): Promise<ResponseType$1 | string>;
+    }): Promise<ResponseType | string>;
     /**
      * Add an activity to a world
      * excludeFromNotification is an array of visitorIds to exclude from the notification
@@ -1029,7 +1029,7 @@ declare class World extends SDKController implements WorldInterface {
         type: WorldActivityType;
         assetId: string;
         excludeFromNotification?: (string | number)[];
-    }): Promise<ResponseType$1 | string>;
+    }): Promise<ResponseType | string>;
     /**
      * Display a message via a toast to all visitors currently in a world.
      *
@@ -1046,7 +1046,7 @@ declare class World extends SDKController implements WorldInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType$1>;
+    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType>;
     /**
      * Retrieves the data object for a world. Must have valid interactive credentials from a visitor in the world.
      *
@@ -1060,7 +1060,7 @@ declare class World extends SDKController implements WorldInterface {
      * const { dataObject } = world;
      * ```
      */
-    fetchDataObject: (appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string) => Promise<void | ResponseType$1>;
+    fetchDataObject: (appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string) => Promise<void | ResponseType>;
     /**
      * Sets the data object for a user. Must have valid interactive credentials from a visitor in the world.
      *
@@ -1093,7 +1093,7 @@ declare class World extends SDKController implements WorldInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }) => Promise<void | ResponseType$1>;
+    }) => Promise<void | ResponseType>;
     /**
      * Updates the data object for a world. Must have valid interactive credentials from a visitor in the world.
      *
@@ -1123,7 +1123,7 @@ declare class World extends SDKController implements WorldInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }) => Promise<void | ResponseType$1>;
+    }) => Promise<void | ResponseType>;
     /**
      * Increments a specific value in the data object for a world by the amount specified. Must have valid interactive credentials from a visitor in the world.
      *
@@ -1149,7 +1149,7 @@ declare class World extends SDKController implements WorldInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Retrieve all webhooks in a world.
      *
@@ -1163,7 +1163,7 @@ declare class World extends SDKController implements WorldInterface {
      * const webhooks = world.webhooks;
      * ```
      */
-    fetchWebhooks(): Promise<void | ResponseType$1>;
+    fetchWebhooks(): Promise<void | ResponseType>;
     /**
      * Retrieve world analytics by day, week, month, quarter, or year
      *
@@ -1184,7 +1184,7 @@ declare class World extends SDKController implements WorldInterface {
         periodType: "week" | "month" | "quarter" | "year";
         dateValue: number;
         year: number;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
 }
 
 /**
@@ -1192,6 +1192,10 @@ declare class World extends SDKController implements WorldInterface {
  *
  * @remarks
  * This class should be instantiated via UserInventoryItemFactory only.
+ * UserInventoryItem represents an instance of an InventoryItem owned by a specific user or visitor.
+ * It includes ownership details like quantity, grant_source, and user-specific metadata.
+ *
+ * @keywords inventory, item, user, visitor, owned, granted
  *
  * @property inventoryItemId - The root inventory item's id
  */
@@ -1205,52 +1209,26 @@ declare class UserInventoryItem extends InventoryItem implements UserInventoryIt
     metadata?: object | null;
     grant_source: string;
     type: string;
+    image_url: string;
     profile_id?: string | null;
+    item: UserInventoryItemMetadataType;
     constructor(topia: Topia, id: string, options?: UserInventoryItemOptionalInterface);
     /**
      * Fetches the user inventory item details from the platform and assigns them to this instance.
      *
-     * @example
-     * ```ts
-     * await userInventoryItem.fetchUserInventoryItemById();
-     * ```
+     * @keywords get, fetch, retrieve, load, user, inventory, item, details, owned
      *
-     * @returns {Promise<void>} Returns when the item has been fetched and assigned.
-     */
-    fetchUserInventoryItemById(): Promise<void>;
-}
-
-/**
- * InventoryItem represents an item in a user's inventory.
- *
- * @remarks
- * This class should be instantiated via InventoryFactory only.
- *
- * @keywords inventory, item, asset, object
- */
-declare class InventoryItem extends SDKController implements InventoryItemInterface {
-    id: string;
-    name?: string;
-    description?: string;
-    type?: string;
-    created_at?: Date;
-    updated_at?: Date;
-    metadata?: object | null;
-    image_path?: string;
-    interactive_key_id?: string;
-    status?: string;
-    constructor(topia: Topia, id: string, options?: InventoryItemOptionalInterface);
-    /**
-     * Fetches the inventory item details from the platform and assigns them to this instance.
+     * @category Inventory
      *
      * @example
      * ```ts
-     * await item.fetchInventoryItemById();
+     * await userInventoryItem.fetchUserInventoryItemById();
+     * const { quantity, grant_source, item } = userInventoryItem;
      * ```
      *
-     * @returns {Promise<InventoryItem>} Returns when the item has been fetched and assigned.
+     * @returns {Promise<void>} Populates this UserInventoryItem instance with all properties from the platform.
      */
-    fetchInventoryItemById(): Promise<InventoryItem>;
+    fetchUserInventoryItemById(): Promise<void>;
 }
 
 /**
@@ -1284,7 +1262,7 @@ declare class User extends SDKController implements UserInterface {
     get worlds(): {
         [key: string]: World;
     };
-    checkInteractiveCredentials(): Promise<void | ResponseType$1>;
+    checkInteractiveCredentials(): Promise<void | ResponseType>;
     /**
      * Returns all avatars owned by User
      *
@@ -1299,7 +1277,7 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns the avatars or an error.
      */
-    fetchAvatars(): Promise<void | ResponseType$1>;
+    fetchAvatars(): Promise<void | ResponseType>;
     /**
      * Add a new avatar
      *
@@ -1373,7 +1351,7 @@ declare class User extends SDKController implements UserInterface {
      * await user.uploadAvatarFiles("exampleAvatarId", formData);
      * ```
      */
-    addAvatar(formData: FormData): Promise<void | ResponseType$1>;
+    addAvatar(formData: FormData): Promise<void | ResponseType>;
     /**
      * Update avatar and sprite sheet records and upload files to existing sprite sheet and avatar storage buckets
      *
@@ -1447,7 +1425,7 @@ declare class User extends SDKController implements UserInterface {
      * await user.uploadAvatarFiles("exampleAvatarId", formData);
      * ```
      */
-    updateAvatar(avatarId: string, formData: FormData): Promise<void | ResponseType$1>;
+    updateAvatar(avatarId: string, formData: FormData): Promise<void | ResponseType>;
     /**
      * Update avatar and sprite sheet records and upload files to existing sprite sheet and avatar storage buckets
      *
@@ -1460,7 +1438,7 @@ declare class User extends SDKController implements UserInterface {
      * await user.deleteAvatar("exampleAvatarId");
      * ```
      */
-    deleteAvatar(avatarId: string): Promise<void | ResponseType$1>;
+    deleteAvatar(avatarId: string): Promise<void | ResponseType>;
     /**
      * Returns all assets owned by User when an email address is provided.
      *
@@ -1474,7 +1452,7 @@ declare class User extends SDKController implements UserInterface {
      * const userAssets = user.assets;
      * ```
      */
-    fetchAssets(): Promise<void | ResponseType$1>;
+    fetchAssets(): Promise<void | ResponseType>;
     /**
      * Returns all platform assets.
      *
@@ -1489,7 +1467,7 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the platform assets or an error response.
      */
-    fetchPlatformAssets(): Promise<object | ResponseType$1>;
+    fetchPlatformAssets(): Promise<object | ResponseType>;
     /**
      * Returns all scenes owned by User.
      *
@@ -1503,7 +1481,7 @@ declare class User extends SDKController implements UserInterface {
      * const userScenes = user.scenes;
      * ```
      */
-    fetchScenes(): Promise<void | ResponseType$1>;
+    fetchScenes(): Promise<void | ResponseType>;
     /**
      * Retrieves all worlds owned by user with matching API Key, creates a new World object for each, and creates new map of Worlds accessible via user.worlds.
      *
@@ -1522,7 +1500,7 @@ declare class User extends SDKController implements UserInterface {
      * { urlSlug: new World({ apiKey, worldArgs, urlSlug }) }
      * ```
      */
-    fetchWorldsByKey(): Promise<void | ResponseType$1>;
+    fetchWorldsByKey(): Promise<void | ResponseType>;
     /**
      * Retrieves all worlds a user with matching API Key is an admin in, creates a new World object for each, and creates new map of Worlds accessible via user.adminWorlds.
      *
@@ -1536,7 +1514,7 @@ declare class User extends SDKController implements UserInterface {
      * const adminWorlds = user.adminWorlds;
      * ```
      */
-    fetchAdminWorldsByKey(): Promise<void | ResponseType$1>;
+    fetchAdminWorldsByKey(): Promise<void | ResponseType>;
     /**
      * Retrieves ids of all dropped assets in all worlds with a matching interactivePublicKey.
      *
@@ -1552,7 +1530,7 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the `urlSlugs` of worlds where the Public Key is found or an error response.
      */
-    fetchInteractiveWorldsByKey(interactivePublicKey: string): Promise<object | ResponseType$1>;
+    fetchInteractiveWorldsByKey(interactivePublicKey: string): Promise<object | ResponseType>;
     /**
      * Send an email
      *
@@ -1570,7 +1548,7 @@ declare class User extends SDKController implements UserInterface {
         html: string;
         subject: string;
         to: string;
-    }): Promise<object | ResponseType$1>;
+    }): Promise<object | ResponseType>;
     /**
      * Get expressions
      *
@@ -1588,7 +1566,7 @@ declare class User extends SDKController implements UserInterface {
     getExpressions({ name, getUnlockablesOnly, }: {
         name?: string;
         getUnlockablesOnly?: boolean;
-    }): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
     /**
      * Retrieves the data object for a user.
      *
@@ -1603,7 +1581,7 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the data object or an error response.
      */
-    fetchDataObject(appPublicKey?: string, appJWT?: string): Promise<void | ResponseType$1>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string): Promise<void | ResponseType>;
     /**
      * Sets the data object for a user.
      *
@@ -1637,7 +1615,7 @@ declare class User extends SDKController implements UserInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates the data object for a user.
      *
@@ -1669,7 +1647,7 @@ declare class User extends SDKController implements UserInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Increments a specific value in the data object for a user by the amount specified. Must have valid interactive credentials from a visitor in the world.
      *
@@ -1695,7 +1673,7 @@ declare class User extends SDKController implements UserInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Retrieves all inventory items owned by this user and app's key.
      *
@@ -1723,7 +1701,7 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<UserInventoryItem>} Returns the UserInventoryItem granted.
      */
-    grantInventoryItem(item: InventoryItem, quantity?: number): Promise<UserInventoryItem>;
+    grantInventoryItem(item: InventoryItemInterface, quantity?: number): Promise<UserInventoryItem>;
     /**
      * Modifies the quantity of an inventory item in this user's inventory.
      *
@@ -1737,7 +1715,45 @@ declare class User extends SDKController implements UserInterface {
      *
      * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
      */
-    modifyInventoryItemQuantity(item: UserInventoryItem, quantity: number): Promise<UserInventoryItem>;
+    modifyInventoryItemQuantity(item: UserInventoryItemInterface, quantity: number): Promise<UserInventoryItem>;
+}
+
+/**
+ * InventoryItem represents an item in a user's inventory.
+ *
+ * @remarks
+ * This class should be instantiated via InventoryFactory only.
+ *
+ * @keywords inventory, item, asset, object
+ */
+declare class InventoryItem extends SDKController implements InventoryItemInterface {
+    id: string;
+    name?: string;
+    description?: string;
+    type?: string;
+    created_at?: Date;
+    updated_at?: Date;
+    metadata?: object | null;
+    image_path?: string;
+    interactive_key_id?: string;
+    status?: string;
+    constructor(topia: Topia, id: string, options?: InventoryItemOptionalInterface);
+    /**
+     * Fetches the inventory item details from the platform and assigns them to this instance.
+     *
+     * @keywords get, fetch, retrieve, load, inventory, item, details
+     *
+     * @category Inventory
+     *
+     * @example
+     * ```ts
+     * await item.fetchInventoryItemById();
+     * const { name, description, type } = item;
+     * ```
+     *
+     * @returns {Promise<InventoryItem>} Returns this InventoryItem instance with all properties populated from the platform.
+     */
+    fetchInventoryItemById(): Promise<InventoryItem>;
 }
 
 /**
@@ -1769,7 +1785,7 @@ declare class Visitor extends User implements VisitorInterface {
      * @returns
      * Returns details for a visitor in a world by id and urlSlug
      */
-    fetchVisitor(): Promise<void | ResponseType$1>;
+    fetchVisitor(): Promise<void | ResponseType>;
     /**
      * Teleport or walk a visitor currently in a world to a single set of coordinates.
      *
@@ -1787,7 +1803,7 @@ declare class Visitor extends User implements VisitorInterface {
      * @returns
      * Returns `{ success: true }` if the visitor was moved successfully.
      */
-    moveVisitor({ shouldTeleportVisitor, x, y }: MoveVisitorInterface): Promise<void | ResponseType$1>;
+    moveVisitor({ shouldTeleportVisitor, x, y }: MoveVisitorInterface): Promise<void | ResponseType>;
     /**
      * Display a message via a toast to a visitor currently in a world.
      *
@@ -1804,7 +1820,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType$1>;
+    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType>;
     /**
      * Open an iframe in a drawer or modal for a visitor currently in a world.
      *
@@ -1824,7 +1840,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    openIframe({ droppedAssetId, link, shouldOpenInDrawer, title, }: OpenIframeInterface): Promise<void | ResponseType$1>;
+    openIframe({ droppedAssetId, link, shouldOpenInDrawer, title, }: OpenIframeInterface): Promise<void | ResponseType>;
     /**
      * Reload an iframe for a visitor currently in a world.
      *
@@ -1839,7 +1855,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    reloadIframe(droppedAssetId: string): Promise<void | ResponseType$1>;
+    reloadIframe(droppedAssetId: string): Promise<void | ResponseType>;
     /**
      * Close an iframe for a visitor currently in a world.
      *
@@ -1854,7 +1870,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    closeIframe(droppedAssetId: string): Promise<void | ResponseType$1>;
+    closeIframe(droppedAssetId: string): Promise<void | ResponseType>;
     /**
      * Mute and turn video off for a visitor currently in a world.
      *
@@ -1867,7 +1883,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<void | ResponseType>} Returns `{ success: true }` or an error.
      */
-    turnAVOff(): Promise<void | ResponseType$1>;
+    turnAVOff(): Promise<void | ResponseType>;
     /**
      * Get expressions
      *
@@ -1884,7 +1900,7 @@ declare class Visitor extends User implements VisitorInterface {
     getExpressions({ name, getUnlockablesOnly, }: {
         name?: string;
         getUnlockablesOnly?: boolean;
-    }): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
     /**
      * Grant expression to a visitor by id or name.
      *
@@ -1903,7 +1919,7 @@ declare class Visitor extends User implements VisitorInterface {
     grantExpression({ id, name }: {
         id?: string;
         name?: string;
-    }): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
     /**
      * Get all particles available
      *
@@ -1918,7 +1934,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<ResponseType>} Returns an array of particles or an error response.
      */
-    getAllParticles(): Promise<ResponseType$1>;
+    getAllParticles(): Promise<ResponseType>;
     /**
      * Trigger a particle effect on a visitor
      *
@@ -1937,7 +1953,7 @@ declare class Visitor extends User implements VisitorInterface {
         id?: string;
         name?: string;
         duration?: number;
-    }): Promise<ResponseType$1 | string>;
+    }): Promise<ResponseType | string>;
     /**
      * Retrieves the data object for a visitor.
      *
@@ -1952,7 +1968,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the data object or an error response.
      */
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
     /**
      * Sets the data object for a visitor.
      *
@@ -1986,7 +2002,7 @@ declare class Visitor extends User implements VisitorInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates the data object for a visitor.
      *
@@ -2018,7 +2034,7 @@ declare class Visitor extends User implements VisitorInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Increments a specific value in the data object for a visitor by the amount specified. Must have valid interactive credentials from a visitor in the world.
      *
@@ -2044,7 +2060,7 @@ declare class Visitor extends User implements VisitorInterface {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Update analytics for a given public key. Must have valid interactive credentials from a visitor in the world.
      *
@@ -2055,7 +2071,7 @@ declare class Visitor extends User implements VisitorInterface {
      * await visitor.updatePublicKeyAnalytics([{ analyticName: "joins", profileId, uniqueKey: profileId, urlSlug }]);
      * ```
      */
-    updatePublicKeyAnalytics(analytics?: AnalyticType[]): Promise<void | ResponseType$1>;
+    updatePublicKeyAnalytics(analytics?: AnalyticType[]): Promise<void | ResponseType>;
     /**
      * Setup signal to visitor
      *
@@ -2066,7 +2082,7 @@ declare class Visitor extends User implements VisitorInterface {
      * await visitor.sendSignalToVisitor(iceServers);
      * ```
      */
-    sendSignalToVisitor(signal: any): Promise<void | (ResponseType$1 & {
+    sendSignalToVisitor(signal: any): Promise<void | (ResponseType & {
         answerSignal: any;
     })>;
     /**
@@ -2083,23 +2099,52 @@ declare class Visitor extends User implements VisitorInterface {
      */
     fetchInventoryItem(item: InventoryItem): Promise<UserInventoryItem>;
     /**
-     * Gets an NPC for this visitor, if one exists.
+     * Retrieves the NPC (Non-Player Character) associated with this visitor, if one exists.
+     *
+     * @remarks
+     * Each visitor can have one NPC per application public key. NPCs are AI-controlled
+     * characters that follow the visitor around the world. They are created using inventory
+     * items of type "npc" and appear as additional avatars that track the visitor's position.
+     * If no NPC exists for this visitor and app, returns null.
+     *
+     * @keywords get, fetch, retrieve, npc, bot, follower, character, assistant, companion
+     *
+     * @category NPCs
      *
      * @example
      * ```ts
-     * await visitor.getNpc();
+     * const npc = await visitor.getNpc();
+     * if (npc) {
+     *   console.log(`NPC position: ${npc.position}`);
+     *   console.log(`NPC ID: ${npc.id}`);
+     * } else {
+     *   console.log('No NPC found for this visitor');
+     * }
      * ```
      *
-     * @returns {Promise<Visitor | null>} Returns a Visitor object representing the NPC.
+     * @returns {Promise<Visitor | null>} Returns a Visitor object representing the NPC, or null if none exists.
      */
     getNpc(): Promise<Visitor | null>;
     /**
-     * Creates an NPC that follows this visitor using an inventory item the visitor owns.
-     * One NPC is allowed per visitor, per application public key.
+     * Creates an NPC (Non-Player Character) that follows this visitor using an inventory item the visitor owns.
+     *
+     * @remarks
+     * One NPC is allowed per visitor, per application public key. NPCs are AI-controlled
+     * characters that automatically follow the visitor around the world. They appear as
+     * additional avatars and can be useful for companions, guides, or assistant characters.
+     *
+     * Requirements:
+     * - The visitor must own a user inventory item of type "npc"
+     * - The item must have been granted to the visitor before calling this method
+     * - Only one NPC can exist per visitor per app at a time
+     *
+     * @keywords create, spawn, add, npc, bot, follower, character, assistant, companion
      *
-     * @param userInventoryItemId The ID of the user's inventory item (must be an NPC type item owned by this visitor).
-     * @param options Optional configuration for the NPC.
-     * @param options.showNameplate Whether to display a nameplate above the NPC (default: true).
+     * @category NPCs
+     *
+     * @param userInventoryItemId - The ID of the user's inventory item (must be an NPC type item owned by this visitor)
+     * @param options - Optional configuration for the NPC
+     * @param options.showNameplate - Whether to display a nameplate above the NPC (default: true)
      *
      * @example
      * ```ts
@@ -2113,17 +2158,31 @@ declare class Visitor extends User implements VisitorInterface {
      * const npc = await visitor.createNpc(userItem.id, { showNameplate: false });
      * ```
      *
-     * @returns {Promise<Visitor>} Returns a Visitor object representing the created NPC.
+     * @returns {Promise<Visitor>} Returns a Visitor object representing the created NPC. The NPC will automatically follow the visitor.
      */
     createNpc(userInventoryItemId: string, options?: {
         showNameplate?: boolean;
     }): Promise<Visitor>;
     /**
-     * Deletes the NPC this app has assigned to this visitor.
+     * Deletes the NPC (Non-Player Character) this app has assigned to this visitor.
+     *
+     * @remarks
+     * This method removes the NPC associated with this visitor for the current application.
+     * The NPC will immediately disappear from the world. The underlying inventory item
+     * is not consumed and can be used to create a new NPC later.
+     *
+     * @keywords delete, remove, destroy, dismiss, despawn, npc, bot, follower, character
+     *
+     * @category NPCs
      *
      * @example
      * ```ts
-     * await visitor.deleteNpc();
+     * // Check if NPC exists before deleting
+     * const npc = await visitor.getNpc();
+     * if (npc) {
+     *   await visitor.deleteNpc();
+     *   console.log('NPC removed successfully');
+     * }
      * ```
      *
      * @returns {Promise<void>} Returns nothing if successful.
@@ -2146,17 +2205,34 @@ declare class Visitor extends User implements VisitorInterface {
     /**
      * Grants an inventory item to this visitor.
      *
-     * @param item The InventoryItem to modify.
-     * @param quantity The new quantity to set.
+     * @remarks
+     * This method requires that the inventory item is already defined in your application's inventory system.
+     * Each visitor can only be granted an item once. Use modifyInventoryItemQuantity() to adjust quantities
+     * for items the visitor already owns. The grant_source will be set to track where the item came from.
+     *
+     * Important: This method will throw an error if the visitor already owns this inventory item.
+     * Check visitorInventoryItems first or use modifyInventoryItemQuantity() to update existing items.
+     *
+     * @keywords grant, give, add, inventory, item, visitor, award, reward
+     *
+     * @category Inventory
+     *
+     * @param item - The InventoryItem to grant to the visitor
+     * @param quantity - The quantity to grant (default: 1)
      *
      * @example
      * ```ts
-     * await visitor.grantInventoryItem("item-id-123", 2);
+     * // First create or fetch the inventory item
+     * const item = await InventoryItem.get("item-id-123");
+     *
+     * // Grant it to the visitor
+     * const userItem = await visitor.grantInventoryItem(item, 2);
+     * console.log(`Granted ${userItem.quantity} items to visitor`);
      * ```
      *
-     * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
+     * @returns {Promise<UserInventoryItem>} Returns the granted UserInventoryItem with quantity and metadata.
      */
-    grantInventoryItem(item: InventoryItem, quantity?: number): Promise<UserInventoryItem>;
+    grantInventoryItem(item: InventoryItemInterface, 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.
@@ -2175,7 +2251,7 @@ declare class Visitor extends User implements VisitorInterface {
      *
      * @returns {Promise<UserInventoryItem>} Returns the updated inventory item or a response object.
      */
-    modifyInventoryItemQuantity(item: UserInventoryItem | InventoryItem, quantity: number): Promise<UserInventoryItem>;
+    modifyInventoryItemQuantity(item: UserInventoryItemInterface | InventoryItemInterface, quantity: number): Promise<UserInventoryItem>;
 }
 
 type VisitorType = {
@@ -2259,29 +2335,29 @@ type AssetOptionalInterface = {
 };
 
 interface DroppedAssetInterface extends AssetInterface {
-    fetchDroppedAssetById(): Promise<void | ResponseType$1>;
-    deleteDroppedAsset(): Promise<void | ResponseType$1>;
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
-    setDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType$1>;
-    updateBroadcast({ assetBroadcast, assetBroadcastAll, broadcasterEmail, }: UpdateBroadcastInterface): Promise<void | ResponseType$1>;
-    updateClickType({ clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, isForceLinkInIframe, isOpenLinkInDrawer, portalName, position, }: UpdateClickTypeInterface): Promise<void | ResponseType$1>;
-    updateCustomTextAsset(style: object | undefined | null, text: string | null | undefined): Promise<void | ResponseType$1>;
-    updateMediaType({ audioRadius, audioSliderVolume, isVideo, mediaLink, mediaName, mediaType, portalName, syncUserMedia, }: UpdateMediaTypeInterface): Promise<void | ResponseType$1>;
-    updateMuteZone(isMutezone: boolean): Promise<void | ResponseType$1>;
+    fetchDroppedAssetById(): Promise<void | ResponseType>;
+    deleteDroppedAsset(): Promise<void | ResponseType>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
+    setDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
+    updateBroadcast({ assetBroadcast, assetBroadcastAll, broadcasterEmail, }: UpdateBroadcastInterface): Promise<void | ResponseType>;
+    updateClickType({ clickType, clickableLink, clickableLinkTitle, clickableDisplayTextDescription, clickableDisplayTextHeadline, isForceLinkInIframe, isOpenLinkInDrawer, portalName, position, }: UpdateClickTypeInterface): Promise<void | ResponseType>;
+    updateCustomTextAsset(style: object | undefined | null, text: string | null | undefined): Promise<void | ResponseType>;
+    updateMediaType({ audioRadius, audioSliderVolume, isVideo, mediaLink, mediaName, mediaType, portalName, syncUserMedia, }: UpdateMediaTypeInterface): Promise<void | ResponseType>;
+    updateMuteZone(isMutezone: boolean): Promise<void | ResponseType>;
     updateLandmarkZone({ isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible, }: {
         isLandmarkZoneEnabled: boolean;
         landmarkZoneName?: string;
         landmarkZoneIsVisible?: boolean;
-    }): Promise<void | ResponseType$1>;
-    updateWebhookZone(isWebhookZoneEnabled: boolean): Promise<void | ResponseType$1>;
-    updatePosition(x: number, y: number, yOrderAdjust?: number): Promise<void | ResponseType$1>;
-    updatePrivateZone({ isPrivateZone, isPrivateZoneChatDisabled, privateZoneUserCap, }: UpdatePrivateZoneInterface): Promise<void | ResponseType$1>;
-    updateScale(assetScale: number): Promise<void | ResponseType$1>;
-    flip(): Promise<void | ResponseType$1>;
-    updateUploadedMediaSelected(mediaId: string): Promise<void | ResponseType$1>;
-    updateWebImageLayers(bottom: string, top: string): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
+    updateWebhookZone(isWebhookZoneEnabled: boolean): Promise<void | ResponseType>;
+    updatePosition(x: number, y: number, yOrderAdjust?: number): Promise<void | ResponseType>;
+    updatePrivateZone({ isPrivateZone, isPrivateZoneChatDisabled, privateZoneUserCap, }: UpdatePrivateZoneInterface): Promise<void | ResponseType>;
+    updateScale(assetScale: number): Promise<void | ResponseType>;
+    flip(): Promise<void | ResponseType>;
+    updateUploadedMediaSelected(mediaId: string): Promise<void | ResponseType>;
+    updateWebImageLayers(bottom: string, top: string): Promise<void | ResponseType>;
     addWebhook({ dataObject, description, isUniqueOnly, title, type, url, }: {
         dataObject: object;
         description: string;
@@ -2293,15 +2369,15 @@ interface DroppedAssetInterface extends AssetInterface {
     setInteractiveSettings({ isInteractive, interactivePublicKey, }: {
         isInteractive?: boolean;
         interactivePublicKey: string;
-    }): Promise<void | ResponseType$1>;
-    setClickableLinkMulti({ clickableLinks }: SetClickableLinkMultiInterface): Promise<void | ResponseType$1>;
-    updateClickableLinkMulti({ clickableLink, clickableLinkTitle, isForceLinkInIframe, isOpenLinkInDrawer, existingLinkId, linkSamlQueryParams, }: UpdateClickableLinkMultiInterface): Promise<void | ResponseType$1>;
-    removeClickableLink({ linkId }: RemoveClickableLinkInterface): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
+    setClickableLinkMulti({ clickableLinks }: SetClickableLinkMultiInterface): Promise<void | ResponseType>;
+    updateClickableLinkMulti({ clickableLink, clickableLinkTitle, isForceLinkInIframe, isOpenLinkInDrawer, existingLinkId, linkSamlQueryParams, }: UpdateClickableLinkMultiInterface): Promise<void | ResponseType>;
+    removeClickableLink({ linkId }: RemoveClickableLinkInterface): Promise<void | ResponseType>;
     fetchDroppedAssetAnalytics({ periodType, dateValue, year, }: {
         periodType: "week" | "month" | "quarter" | "year";
         dateValue: number;
         year: number;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     id?: string;
     assetId?: string;
     assetScale?: number | null;
@@ -2462,18 +2538,18 @@ interface UpdatePrivateZoneInterface {
     privateZoneUserCap: number;
 }
 
-interface EcosystemInterface {
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
-    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType$1>;
-    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType$1>;
+interface EcosystemInterface extends SDKInterface {
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
+    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType>;
+    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
 }
 interface EcosystemOptionalInterface {
     credentials?: InteractiveCredentials;
 }
 
 interface SceneInterface {
-    fetchSceneById(): Promise<void | ResponseType$1>;
+    fetchSceneById(): Promise<void | ResponseType>;
     id: string;
     background?: null;
     description?: string;
@@ -2516,28 +2592,28 @@ interface TopiaInterface {
 }
 
 interface UserInterface {
-    checkInteractiveCredentials(): Promise<void | ResponseType$1>;
-    fetchAvatars(): Promise<void | ResponseType$1>;
-    addAvatar(formData: FormData): Promise<void | ResponseType$1>;
-    updateAvatar(avatarId: string, formData: FormData): Promise<void | ResponseType$1>;
-    deleteAvatar(avatarId: string): Promise<void | ResponseType$1>;
-    fetchAssets(): Promise<void | ResponseType$1>;
-    fetchPlatformAssets(): Promise<object | ResponseType$1>;
-    fetchScenes(): Promise<void | ResponseType$1>;
-    fetchWorldsByKey(): Promise<void | ResponseType$1>;
+    checkInteractiveCredentials(): Promise<void | ResponseType>;
+    fetchAvatars(): Promise<void | ResponseType>;
+    addAvatar(formData: FormData): Promise<void | ResponseType>;
+    updateAvatar(avatarId: string, formData: FormData): Promise<void | ResponseType>;
+    deleteAvatar(avatarId: string): Promise<void | ResponseType>;
+    fetchAssets(): Promise<void | ResponseType>;
+    fetchPlatformAssets(): Promise<object | ResponseType>;
+    fetchScenes(): Promise<void | ResponseType>;
+    fetchWorldsByKey(): Promise<void | ResponseType>;
     sendEmail({ html, subject, to }: {
         html: string;
         subject: string;
         to: string;
-    }): Promise<object | ResponseType$1>;
+    }): Promise<object | ResponseType>;
     getExpressions({ name, getUnlockablesOnly }: {
         name?: string;
         getUnlockablesOnly?: boolean;
-    }): Promise<ResponseType$1>;
-    fetchDataObject(appPublicKey?: string, appJWT?: string): Promise<void | ResponseType$1>;
-    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType$1>;
-    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType$1>;
+    }): Promise<ResponseType>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string): Promise<void | ResponseType>;
+    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType>;
+    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
     fetchInventoryItems(): Promise<void>;
     inventoryItems: UserInventoryItem[];
     grantInventoryItem(item: InventoryItem, quantity: number): Promise<UserInventoryItem>;
@@ -2552,27 +2628,27 @@ interface UserOptionalInterface {
 }
 
 interface VisitorInterface extends SDKInterface {
-    fetchVisitor(): Promise<void | ResponseType$1>;
-    moveVisitor({ shouldTeleportVisitor, x, y }: MoveVisitorInterface): Promise<void | ResponseType$1>;
-    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType$1>;
-    openIframe({ link, shouldOpenInDrawer, title }: OpenIframeInterface): Promise<void | ResponseType$1>;
-    reloadIframe(droppedAssetId: string): Promise<void | ResponseType$1>;
-    closeIframe(droppedAssetId: string): Promise<void | ResponseType$1>;
-    turnAVOff(): Promise<void | ResponseType$1>;
+    fetchVisitor(): Promise<void | ResponseType>;
+    moveVisitor({ shouldTeleportVisitor, x, y }: MoveVisitorInterface): Promise<void | ResponseType>;
+    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType>;
+    openIframe({ link, shouldOpenInDrawer, title }: OpenIframeInterface): Promise<void | ResponseType>;
+    reloadIframe(droppedAssetId: string): Promise<void | ResponseType>;
+    closeIframe(droppedAssetId: string): Promise<void | ResponseType>;
+    turnAVOff(): Promise<void | ResponseType>;
     getExpressions({ name, getUnlockablesOnly }: {
         name?: string;
         getUnlockablesOnly?: boolean;
-    }): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
     grantExpression({ id, name }: {
         id?: string;
         name?: string;
-    }): Promise<ResponseType$1>;
-    getAllParticles(): Promise<ResponseType$1>;
+    }): Promise<ResponseType>;
+    getAllParticles(): Promise<ResponseType>;
     fetchInventoryItems(): Promise<void>;
     inventoryItems: UserInventoryItem[];
-    grantInventoryItem(item: InventoryItem, quantity: number): Promise<UserInventoryItem>;
-    modifyInventoryItemQuantity(item: UserInventoryItem, quantity: number): Promise<UserInventoryItem>;
-    fetchInventoryItem(item: InventoryItem): Promise<UserInventoryItem>;
+    grantInventoryItem(item: InventoryItemInterface, quantity: number): Promise<UserInventoryItem>;
+    modifyInventoryItemQuantity(item: UserInventoryItemInterface | InventoryItemInterface, quantity: number): Promise<UserInventoryItem>;
+    fetchInventoryItem(item: InventoryItemInterface): Promise<UserInventoryItem>;
     createNpc(userInventoryItemId: string, options?: {
         showNameplate?: boolean;
     }): Promise<Visitor>;
@@ -2582,13 +2658,13 @@ interface VisitorInterface extends SDKInterface {
         id?: string;
         name?: string;
         duration?: number;
-    }): Promise<ResponseType$1 | string>;
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
-    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType$1>;
-    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType$1>;
-    updatePublicKeyAnalytics(analytics?: AnalyticType[]): Promise<void | ResponseType$1>;
-    sendSignalToVisitor(signal: any): Promise<void | (ResponseType$1 & {
+    }): Promise<ResponseType | string>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
+    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType>;
+    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
+    updatePublicKeyAnalytics(analytics?: AnalyticType[]): Promise<void | ResponseType>;
+    sendSignalToVisitor(signal: any): Promise<void | (ResponseType & {
         answerSignal: any;
     })>;
     color?: string;
@@ -2651,7 +2727,7 @@ interface WebhookInterface {
 }
 
 interface WebRTCConnectorInterface {
-    getTwilioConfig(): Promise<void | ResponseType$1>;
+    getTwilioConfig(): Promise<void | ResponseType>;
 }
 interface WebRTCConnectorOptionalInterface {
     credentials?: InteractiveCredentials;
@@ -2696,13 +2772,13 @@ interface WorldDetailsInterface {
     width?: number;
 }
 interface WorldInterface extends SDKInterface, WorldDetailsInterface {
-    fetchDetails(): Promise<void | ResponseType$1>;
-    updateDetails({ controls, description, forceAuthOnLogin, height, name, spawnPosition, width, }: WorldDetailsInterface): Promise<void | ResponseType$1>;
+    fetchDetails(): Promise<void | ResponseType>;
+    updateDetails({ controls, description, forceAuthOnLogin, height, name, spawnPosition, width, }: WorldDetailsInterface): Promise<void | ResponseType>;
     updateCloseWorldSettings({ closeWorldDescription, isWorldClosed, }: {
         closeWorldDescription: string;
         isWorldClosed: boolean;
-    }): Promise<void | ResponseType$1>;
-    fetchDroppedAssets(): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
+    fetchDroppedAssets(): Promise<void | ResponseType>;
     fetchDroppedAssetsWithUniqueName({ uniqueName, isPartial, isReversed, }: {
         uniqueName: string;
         isPartial?: boolean;
@@ -2714,37 +2790,37 @@ interface WorldInterface extends SDKInterface, WorldDetailsInterface {
     }): Promise<DroppedAsset[]>;
     updateCustomTextDroppedAssets(droppedAssetsToUpdate: Array<DroppedAsset>, style: object): Promise<object>;
     fetchLandmarkZones(landmarkZoneName?: string, sceneDropId?: string): Promise<DroppedAsset[]>;
-    fetchSceneDropIds(): Promise<object | ResponseType$1>;
-    fetchScenes(): Promise<object | ResponseType$1>;
+    fetchSceneDropIds(): Promise<object | ResponseType>;
+    fetchScenes(): Promise<object | ResponseType>;
     dropScene({ assetSuffix, position, sceneId, }: {
         assetSuffix: string;
         position: object;
         sceneId: string;
-    }): Promise<object | ResponseType$1>;
-    replaceScene(sceneId: string): Promise<void | ResponseType$1>;
-    getAllParticles(): Promise<ResponseType$1>;
+    }): Promise<object | ResponseType>;
+    replaceScene(sceneId: string): Promise<void | ResponseType>;
+    getAllParticles(): Promise<ResponseType>;
     triggerParticle({ id, name, duration, position, }: {
         id?: string;
         name?: string;
         duration?: number;
         position?: object;
-    }): Promise<ResponseType$1 | string>;
+    }): Promise<ResponseType | string>;
     triggerActivity({ type, assetId, excludeFromNotification, }: {
         type: WorldActivityType;
         assetId: string;
         excludeFromNotification?: (string | number)[];
-    }): Promise<ResponseType$1 | string>;
-    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType$1>;
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
-    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType$1>;
-    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType$1>;
-    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType$1>;
-    fetchWebhooks(): Promise<void | ResponseType$1>;
+    }): Promise<ResponseType | string>;
+    fireToast({ groupId, title, text }: FireToastInterface): Promise<void | ResponseType>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
+    setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType>;
+    updateDataObject(dataObject: object, options: object): Promise<void | ResponseType>;
+    incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
+    fetchWebhooks(): Promise<void | ResponseType>;
     fetchWorldAnalytics({ periodType, dateValue, year, }: {
         periodType: "week" | "month" | "quarter" | "year";
         dateValue: number;
         year: number;
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     dataObject?: object | null;
 }
 interface WorldOptionalInterface {
@@ -2771,6 +2847,7 @@ type InteractiveCredentials$1 = {
  * Interface for an inventory item.
  */
 interface InventoryItemInterface extends SDKInterface {
+    fetchInventoryItemById(): Promise<InventoryItem>;
     id: string;
     name?: string;
     description?: string;
@@ -2779,6 +2856,7 @@ interface InventoryItemInterface extends SDKInterface {
     updated_at?: Date;
     metadata?: object | null;
     image_path?: string;
+    image_url?: string;
     interactive_key_id?: string;
     status?: string;
 }
@@ -2791,31 +2869,53 @@ type InventoryItemOptionalInterface = {
  * Interface for a user-owned inventory item.
  */
 interface UserInventoryItemInterface extends InventoryItemInterface {
-    userItemId: string;
     user_id: string;
     item_id: string;
     quantity: number;
     created_at?: Date;
     updated_at?: Date;
-    metadata?: object | null;
     grant_source: string;
     profile_id?: string | null;
+    item: UserInventoryItemMetadataType;
 }
 type UserInventoryItemOptionalInterface = {
     attributes?: UserInventoryItemInterface | object;
     credentials?: InteractiveCredentials$1;
 };
+type UserInventoryItemMetadataType = {
+    id: string;
+    name: string;
+    description: string;
+    type: string;
+    metadata: object | null;
+    image_url: string;
+};
 
 /**
- * Create a single instance of Topia axios used for all calls to the public API in all classes
+ * Main Topia SDK client for configuring API access and authentication.
+ *
+ * @remarks
+ * This class should be instantiated ONCE per application at initialization time.
+ * The instance configures the Axios HTTP client with proper authentication headers
+ * and base URL, and is passed to all factory classes to create controllers.
+ *
+ * Configuration options:
+ * - apiKey: Your Topia API key for server-side authentication
+ * - interactiveKey/interactiveSecret: For interactive iframe applications
+ * - apiDomain: API endpoint domain (defaults to "api.topia.io")
+ * - apiProtocol: HTTP protocol (defaults to "https")
+ *
+ * @keywords topia, client, sdk, initialization, config, setup, api
  *
  * @example
  * ```ts
- * const topia = await new Topia({
+ * import { Topia } from "@rtsdk/topia";
+ *
+ * const topia = new Topia({
+ *   apiKey: "your-api-key",
  *   apiDomain: "api.topia.io",
- *   apiKey: "exampleKey",
- *   interactiveKey: "key",
- *   interactiveSecret: "secret",
+ *   interactiveKey: "your-public-key",
+ *   interactiveSecret: "your-secret-key",
  * });
  * ```
  */
@@ -2838,24 +2938,24 @@ declare class Topia implements TopiaInterface {
 }
 
 /**
- * Create an instance of SDKController class with credentials.
+ * Abstract base controller that provides common functionality for all SDK controllers.
+ *
+ * @remarks
+ * This class should NOT be instantiated directly. It serves as the base class for all
+ * SDK controllers (World, Visitor, User, etc.) and provides:
+ * - Authentication and credential management
+ * - Axios instance configuration for API calls
+ * - Standardized error handling
+ * - JWT token generation for interactive credentials
+ *
+ * @keywords base, controller, sdk, authentication, api, abstract
  *
  * @example
  * ```ts
- * const credentials = {
- *   assetId: "exampleAsset",
- *   interactiveNonce: "exampleNonce"
- *   interactivePublicKey: "examplePublicKey",
- *   visitorId: 1,
- *   url: "https://topia.io",
+ * // This class is extended by all controllers
+ * export class World extends SDKController implements WorldInterface {
+ *   // World-specific implementation
  * }
- * const topia = await new Topia({
- *   apiDomain: "api.topia.io",
- *   apiKey: "exampleKey",
- *   interactiveKey: "key",
- *   interactiveSecret: "secret",
- * }
- * await new SDKController({ credentials, topia });
  * ```
  */
 declare abstract class SDKController implements SDKInterface {
@@ -2864,7 +2964,40 @@ declare abstract class SDKController implements SDKInterface {
     requestOptions: object;
     topia: Topia;
     constructor(topia: Topia, credentials?: InteractiveCredentials);
+    /**
+     * Returns the configured Axios instance for making API calls to Topia's Public API.
+     *
+     * @remarks
+     * All HTTP requests to the Topia API should use this method to ensure proper
+     * authentication headers and base URL configuration are applied.
+     *
+     * @keywords api, axios, http, request, client, public api
+     *
+     * @returns {AxiosInstance} The configured Axios client instance with authentication headers.
+     */
     topiaPublicApi(): axios.AxiosInstance;
+    /**
+     * Standardized error handler for all SDK operations.
+     *
+     * @remarks
+     * This method processes errors from API calls and formats them consistently across the SDK.
+     * It extracts relevant error information including:
+     * - HTTP status codes and response data
+     * - Error messages from API responses
+     * - Stack traces for debugging
+     * - Request details (URL, method, parameters)
+     *
+     * All errors thrown by SDK methods flow through this handler to ensure consistent error format.
+     *
+     * @keywords error, exception, handler, debugging, api error, http error
+     *
+     * @param error - The error object from the failed operation (AxiosError, Error, or unknown)
+     * @param message - Optional custom error message (defaults to generic message)
+     * @param params - Optional parameters that were passed to the failed method
+     * @param sdkMethod - Optional name of the SDK method that failed (e.g., "World.fetchDetails")
+     *
+     * @returns {object} Standardized error object with properties: data, message, method, params, sdkMethod, stack, status, success, url
+     */
     errorHandler({ error, message, params, sdkMethod, }: {
         error?: Error | AxiosError | unknown;
         message?: string;
@@ -2913,7 +3046,7 @@ declare class Asset extends SDKController implements AssetInterface {
      *
      * @returns {Promise<object | ResponseType>} Returns the asset details or an error response.
      */
-    fetchAssetById(): Promise<object | ResponseType$1>;
+    fetchAssetById(): Promise<object | ResponseType>;
     /**
      * Updates platform asset details.
      *
@@ -2941,7 +3074,7 @@ declare class Asset extends SDKController implements AssetInterface {
         shouldUploadImages?: boolean;
         tagJson: string;
         topLayerURL?: string;
-    }): Promise<object | ResponseType$1>;
+    }): Promise<object | ResponseType>;
 }
 
 /**
@@ -2963,7 +3096,7 @@ declare class Ecosystem extends SDKController {
     /**
      * Retrieves the data object for a Topia ecosystem. Requires canUpdateEcosystemDataObjects permission to be set to true for the public key.
      *
-     * @keywords get, fetch, retrieve, load, data, object, state
+     * @keywords get, fetch, retrieve, load, ecosystem, data, object, state, global, platform
      *
      * @category Data Objects
      *
@@ -2972,9 +3105,9 @@ declare class Ecosystem extends SDKController {
      * const dataObject = await ecosystem.fetchDataObject("exampleAppPublicKey", "exampleAppPublicKeyJWT");
      * ```
      *
-     * @returns {Promise<object | ResponseType>} Returns the data object or an error response.
+     * @returns {Promise<void | ResponseType>} Populates the dataObject property with ecosystem-wide data, or returns an error response.
      */
-    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType$1>;
+    fetchDataObject(appPublicKey?: string, appJWT?: string, sharedAppPublicKey?: string, sharedAppJWT?: string): Promise<void | ResponseType>;
     /**
      * Sets the data object for a Topia ecosystem.
      *
@@ -2983,7 +3116,7 @@ declare class Ecosystem extends SDKController {
      *
      * Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id
      *
-     * @keywords set, assign, store, save, data, object, state
+     * @keywords set, assign, store, save, ecosystem, data, object, state, global, platform
      *
      * @category Data Objects
      *
@@ -2995,6 +3128,8 @@ declare class Ecosystem extends SDKController {
      * });
      * const { exampleKey } = ecosystem.dataObject;
      * ```
+     *
+     * @returns {Promise<void | ResponseType>} Returns success or an error response.
      */
     setDataObject(dataObject: object | null | undefined, options?: {
         appPublicKey?: string;
@@ -3006,7 +3141,7 @@ declare class Ecosystem extends SDKController {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Updates the data object for a Topia ecosystem.
      *
@@ -3015,7 +3150,7 @@ declare class Ecosystem extends SDKController {
      *
      * Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id
      *
-     * @keywords update, modify, change, edit, alter, data, object, state
+     * @keywords update, modify, change, edit, alter, ecosystem, data, object, state, global, platform
      *
      * @category Data Objects
      *
@@ -3033,6 +3168,8 @@ declare class Ecosystem extends SDKController {
      * });
      * const { exampleKey } = ecosystem.dataObject;
      * ```
+     *
+     * @returns {Promise<void | ResponseType>} Returns success or an error response.
      */
     updateDataObject(dataObject: object, options?: {
         appPublicKey?: string;
@@ -3044,7 +3181,7 @@ declare class Ecosystem extends SDKController {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Increments a specific value in the data object for a Topia ecosystem by the amount specified. Must have valid interactive credentials from a visitor in the world.
      *
@@ -3053,7 +3190,7 @@ declare class Ecosystem extends SDKController {
      *
      * Optionally, a lock can be provided with this request to ensure only one update happens at a time between all updates that share the same lock id
      *
-     * @keywords increment, increase, add, count, data, object, state
+     * @keywords increment, increase, add, count, ecosystem, data, object, state, global, platform
      *
      * @category Data Objects
      *
@@ -3064,6 +3201,8 @@ declare class Ecosystem extends SDKController {
      *   sharedAppJWT: "exampleAppPublicKeyJWT",}
      * });
      * ```
+     *
+     * @returns {Promise<void | ResponseType>} Returns success or an error response.
      */
     incrementDataObjectValue(path: string, amount: number, options?: {
         appPublicKey?: string;
@@ -3075,31 +3214,44 @@ declare class Ecosystem extends SDKController {
             lockId: string;
             releaseLock?: boolean;
         };
-    }): Promise<void | ResponseType$1>;
+    }): Promise<void | ResponseType>;
     /**
      * Retrieves all inventory items for a given keyholder (app public key).
      *
-     * @keywords get, fetch, retrieve, list, inventory, items, keyholder
+     * @keywords get, fetch, retrieve, list, inventory, items, keyholder, ecosystem, catalog
+     *
+     * @category Inventory
      *
      * @example
      * ```ts
-     * const items = await ecosystem.fetchInventoryItems("appPublicKey", "appJWT");
+     * await ecosystem.fetchInventoryItems();
+     * const items = ecosystem.inventoryItems;
      * ```
      *
-     * @returns {Promise<object[]>} Returns an array of InventoryItem objects.
+     * @returns {Promise<void>} Populates the inventoryItems property with an array of InventoryItem objects.
      */
     fetchInventoryItems(): Promise<void>;
     get inventoryItems(): InventoryItem[];
 }
 
 /**
- * Create an instance of WebRTCConnector class with optional session credentials.
+ * WebRTC connector for managing real-time video and audio connections in Topia worlds.
+ *
+ * @remarks
+ * This class should NOT be instantiated directly. Use WebRTCConnectorFactory to create instances.
+ * The WebRTCConnector provides access to Twilio configuration needed for establishing
+ * peer-to-peer video and audio connections between visitors in a world.
+ *
+ * @see WebRTCConnectorFactory for proper instantiation
+ *
+ * @keywords webrtc, video, audio, twilio, real-time, communication, voice, peer
  *
  * @example
  * ```ts
- * const webRTC = await new WebRTCConnector(topia, {
- *   credentials: { interactivePublicKey: "examplePublicKey", interactiveNonce: "exampleNonce", assetId: "exampleDroppedAssetId", profileId: "exampleProfileId", visitorId: 1, urlSlug: "exampleUrlSlug" }
- * });
+ * import { WebRTC } from "utils/topiaInit.ts";
+ *
+ * const webrtc = await WebRTC.create(urlSlug, { credentials });
+ * const config = await webrtc.getTwilioConfig();
  * ```
  */
 declare class WebRTCConnector extends SDKController implements WebRTCConnectorInterface {
@@ -3107,14 +3259,27 @@ declare class WebRTCConnector extends SDKController implements WebRTCConnectorIn
     urlSlug: string;
     constructor(topia: Topia, urlSlug: string, options?: WebRTCConnectorOptionalInterface);
     /**
-     * Get twilio
+     * Retrieves the Twilio configuration for WebRTC connections in a world.
+     *
+     * @remarks
+     * This method fetches the Twilio room configuration needed to establish peer-to-peer
+     * video and audio connections between visitors. The configuration includes authentication
+     * tokens and room settings. Call this before initializing WebRTC connections.
+     *
+     * @keywords get, fetch, retrieve, webrtc, twilio, configuration, video, audio, connection
+     *
+     * @category WebRTC
      *
      * @example
      * ```ts
      * await webRTCConnector.getTwilioConfig();
+     * const { twilioConfig } = webRTCConnector;
+     * console.log(twilioConfig); // Use for WebRTC setup
      * ```
+     *
+     * @returns {Promise<void | ResponseType>} Populates twilioConfig property with Twilio room configuration, or returns an error response.
      */
-    getTwilioConfig(): Promise<void | ResponseType$1>;
+    getTwilioConfig(): Promise<void | ResponseType>;
 }
 
 /**
@@ -3203,7 +3368,7 @@ declare class WorldActivity extends SDKController {
      * @returns
      * Updates each Visitor instance and worldActivity.visitors map.
      */
-    moveAllVisitors({ shouldFetchVisitors, shouldTeleportVisitors, scatterVisitorsBy, x, y, }: MoveAllVisitorsInterface): Promise<(void | ResponseType$1)[] | undefined>;
+    moveAllVisitors({ shouldFetchVisitors, shouldTeleportVisitors, scatterVisitorsBy, x, y, }: MoveAllVisitorsInterface): Promise<(void | ResponseType)[] | undefined>;
     /**
      * Teleport or walk a list of visitors currently in a world to various coordinates.
      *
@@ -3232,7 +3397,7 @@ declare class WorldActivity extends SDKController {
      * @returns
      * Updates each Visitor instance and worldActivity.visitors map.
      */
-    moveVisitors(visitorsToMove: VisitorsToMoveArrayType): Promise<(void | ResponseType$1)[]>;
+    moveVisitors(visitorsToMove: VisitorsToMoveArrayType): Promise<(void | ResponseType)[]>;
 }
 
 /**
@@ -4025,4 +4190,4 @@ declare class WorldFactory extends SDKController {
     }>;
 }
 
-export { AnalyticType, AnimationMetaType, Asset, AssetFactory, AssetInterface, AssetOptionalInterface, AssetOptions, AssetType, DroppedAsset, DroppedAssetClickType, DroppedAssetFactory, DroppedAssetInterface, DroppedAssetLinkType, DroppedAssetMediaType, DroppedAssetMediaVolumeRadius, DroppedAssetOptionalInterface, DroppedAssetOptions, Ecosystem, EcosystemFactory, EcosystemInterface, EcosystemOptionalInterface, FireToastInterface, FrameType, InteractiveCredentials, InventoryItemInterface, InventoryItemOptionalInterface, MoveAllVisitorsInterface, MoveVisitorInterface, OpenIframeInterface, RemoveClickableLinkInterface, ResponseType$1 as ResponseType, SDKController, SDKInterface, Scene, SceneFactory, SceneInterface, SceneOptionalInterface, SetClickableLinkMultiInterface, Topia, TopiaInterface, UpdateBroadcastInterface, UpdateClickTypeInterface, UpdateClickableLinkMultiInterface, UpdateDroppedAssetInterface, UpdateMediaTypeInterface, UpdatePrivateZoneInterface, User, UserFactory, UserInterface, UserInventoryItemInterface, UserInventoryItemOptionalInterface, UserOptionalInterface, UserOptions, Visitor, VisitorFactory, VisitorInterface, VisitorOptionalInterface, VisitorOptions, VisitorType, VisitorsToMoveArrayType, VisitorsToMoveType, WebRTCConnector, WebRTCConnectorFactory, WebRTCConnectorInterface, WebRTCConnectorOptionalInterface, WebhookInterface, World, WorldActivity, WorldActivityFactory, WorldActivityOptionalInterface, WorldActivityType, WorldDetailsInterface, WorldFactory, WorldInterface, WorldOptionalInterface, WorldOptions, WorldWebhooksInterface };
+export { AnalyticType, AnimationMetaType, Asset, AssetFactory, AssetInterface, AssetOptionalInterface, AssetOptions, AssetType, DroppedAsset, DroppedAssetClickType, DroppedAssetFactory, DroppedAssetInterface, DroppedAssetLinkType, DroppedAssetMediaType, DroppedAssetMediaVolumeRadius, DroppedAssetOptionalInterface, DroppedAssetOptions, Ecosystem, EcosystemFactory, EcosystemInterface, EcosystemOptionalInterface, FireToastInterface, FrameType, InteractiveCredentials, InventoryItemInterface, InventoryItemOptionalInterface, MoveAllVisitorsInterface, MoveVisitorInterface, OpenIframeInterface, RemoveClickableLinkInterface, ResponseType, SDKController, SDKInterface, Scene, SceneFactory, SceneInterface, SceneOptionalInterface, SetClickableLinkMultiInterface, Topia, TopiaInterface, UpdateBroadcastInterface, UpdateClickTypeInterface, UpdateClickableLinkMultiInterface, UpdateDroppedAssetInterface, UpdateMediaTypeInterface, UpdatePrivateZoneInterface, User, UserFactory, UserInterface, UserInventoryItemInterface, UserInventoryItemMetadataType, UserInventoryItemOptionalInterface, UserOptionalInterface, UserOptions, Visitor, VisitorFactory, VisitorInterface, VisitorOptionalInterface, VisitorOptions, VisitorType, VisitorsToMoveArrayType, VisitorsToMoveType, WebRTCConnector, WebRTCConnectorFactory, WebRTCConnectorInterface, WebRTCConnectorOptionalInterface, WebhookInterface, World, WorldActivity, WorldActivityFactory, WorldActivityOptionalInterface, WorldActivityType, WorldDetailsInterface, WorldFactory, WorldInterface, WorldOptionalInterface, WorldOptions, WorldWebhooksInterface };