@rtsdk/topia 0.10.0 → 0.11.1

package/README.md

@@ -1,10 +1,59 @@
+<hr />
+
 # Javascript RTSDK - Topia Client Library
 
-The Topia Client Library leverages the Topia Public API and allows users to interact with the topia systems and modify their world programmatically. With the SDK you can now build new features to be used in Topia! Questions, comments, or have something exciting to share with the Topia team? Reach out to [developers@topia.io](mailto:developers@topia.io)!
+<hr/>
+
+<br>
+
+### Create integrated, interactive experiences with Topia’s SDK and API
+
+Topia offers a robust SDK and API that allows anyone to build custom apps or integrate any 3rd-party content, application, game or learning experience. Dedicated deployments launch with dozens of SDK Applications, including mini-games and social apps made by the Topia team and our developer community
+
+### Topia’s SDK/API can be used to:
+
+- Turn existing applications and systems into multiplayer, cooperative experiences
+- Integrate existing content into multiplayer learning journeys
+- Create your own custom, dynamic social experiences and games
+- Store and persist JSON data objects across sessions
+- Add Social Connectivity Networking capabilities to your existing platforms
+
+### Key Features:
+
+- Built-in safety and security via an interactive credentialing system
+- Control over the code and IP of your creations
+- Integrated via i-frame, in-world assets, and server-based bi-directional data flow
+- Every object, world, and visitor has a JSON database you use to build interactivity and data persistence
+- Powerful SDK classes and methods enable control of every aspect of Topia
+
+### Resources:
+
+- [NPM Package](https://www.npmjs.com/package/@rtsdk/topia)
+- [Demo World](https://topia.io/sdk-demos)
+- [Typescript Boilerplate](https://github.com/metaversecloud-com/sdk-ts-boilerplate)
+- [Javascript Boilerplate](https://github.com/metaversecloud-com/sdk-ts-boilerplate)
+
+#### Need inspiration?! Check out the following applications which utilizes the SDK to create new and enhanced features inside [topia.io](https://topia.io/):
+
+- **Bulletin Board:** A message board style application where users can submit messages and/or images for approval and an admin can approve the message so that it can be added to the world.
+  - [Github](https://github.com/metaversecloud-com/sdk-bulletin-board-app)
+  - [Demo](https://topia.io/bulletin-board-prod)
+- **Jukebox:** A real-time interactive music player.
+  - [Github](https://github.com/metaversecloud-com/jukebox)
+  - [Demo](https://topia.io/jukebox-prod)
+- **TicTacToe:** A turn based multiplayer game built completely on the canvas.
+  - [Github](https://github.com/metaversecloud-com/sdk-tictactoe)
+  - [Demo](https://topia.io/tictactoe-prod)
+- **Quest:** A dynamic hide and seek game where an admin can drop multiple quest items within a world for users to find.
+  - [Github](https://github.com/metaversecloud-com/sdk-quest)
+  - [Demo](https://topia.io/quest-prod)
+
+Questions, comments, or have something exciting to share with the Topia team? Reach out to [developers@topia.io](mailto:developers@topia.io)!
+<br/>
 
 ## Authorization
 
-A Topia provided API Key can be included with every object initialization as a parameter named `apiKey`. This API Key is used to in authorization headers in all calls to the Public API. Use it wisely and sparingly! The API Key should only be used to authorize your app (and therefore all of it's users) to perform specific actions. In most case the ability to interact with an SDK application should be controlled per user using Interactive Credentials (see below).
+Visitors of a [topia.io](https://topia.io/) world interact with each other and the interactively configured assets in your world without the need for an API Key. This is all made possible through Interactive Session credentials passed to the SDK with every request, when applicable. What does this mean for you? Not much, actually! All of the magic happens behind the scenes and all you have to do is make sure that new class constructors include an options object like this: `options: WorldOptionalInterface = { attributes: {}, credentials: {} }` and all calls to `this.topia.axios` include the inherited `this.requestOptions` parameter.
 
 ### Want to build interactive assets? This is how you can get started:
 
@@ -42,37 +91,24 @@ await DroppedAsset.get(assetId, urlSlug, {
 });
 ```
 
-<br />
+![Interactive Application Development Diagram](https://raw.githubusercontent.com/metaversecloud-com/mc-sdk-js/main/clients/client-topia/InteractiveApplicationDevelopment.png)
 
-### Need an API Key to test locally? This is how you can create one:
+### Want to enable want world owners / admins to use the app outside of Topia, but still have ability to modify things in worlds where they have the permission to do so? This is how you can create an API Key:
+
+A Topia provided API Key can be included with every object initialization as a parameter named `apiKey`. This API Key is used to in authorization headers in all calls to the Public API. **Use it wisely and sparingly!** The API Key should only be used to authorize your app (and therefore all of it's users) to perform specific actions **when not currently in a Topia world**. In most case the ability to interact with an SDK application should be controlled per user using Interactive Credentials (see above).
 
 - Navigate directly to your [integrations page](https://topia.io/t/dashboard/integrations) or follow the steps below from within a world.
   - Click on your image (or circle) at the top left of the left hand navbar.
   - Click Edit Profile. This will bring you to a separate dashboard.
-  - Click Integrations on the left nav
-- Click Generate New API Key and copy the API Key to be used in your .env and while using https://sdk-examples.metaversecloud.com
-
-Alternatively, visitors of a [topia.io](https://topia.io/) world interact with each other and the interactively configured assets in your world without the need for an API Key. This is all made possible through Interactive Session credentials passed to the SDK with every request, when applicable. What does this mean for you? Not much, actually! All of the magic happens behind the scenes and all you have to do is make sure that new class constructors include an options object like this: `options: WorldOptionalInterface = { attributes: {}, credentials: {} }` and all calls to `this.topia.axios` include the inherited `this.requestOptions` parameter.
-
-![Interactive Application Development Diagram](https://raw.githubusercontent.com/metaversecloud-com/mc-sdk-js/main/clients/client-topia/InteractiveApplicationDevelopment.png)
+  - Click Integrations on the left nav.
+- Click Generate New API Key and copy the API Key to be used in your .env file.
 
 <br>
 
-<hr/>
-
 # Developers
 
 <hr/>
 
-Need inspiration?! Check out the following applications which utilizes the SDK to create new and enhanced features inside [topia.io](https://topia.io/):
-
-- **TicTacToe:** A turn based multiplayer game built completely on the canvas.
-  - [Github](https://github.com/metaversecloud-com/sdk-tictactoe)
-  - [Demo](https://topia.io/tictactoe-prod)
-- **Quest:** A dynamic hide and seek game where an admin can drop multiple quest items within a world for users to find.
-  - [Github](https://github.com/metaversecloud-com/sdk-quest)
-  - [Demo](https://topia.io/quest-prod)
-
 <br>
 
 ## Get Started
@@ -133,6 +169,8 @@ export const getAssetAndDataObject = async (req) => {
 };
 ```
 
+<br/><br/>
+
 ## Data Objects
 
 Data Objects can be used to store information such as game state, configurations, themes, and analytics.
@@ -167,9 +205,8 @@ There are three types of Data Objects:
     ```
 - **User:** The User data object should be used to store information unique to a user that is NOT unique to a world or instance (dropped asset) of an app.
   - **Example - Update totalMessagesSentCount by a user across all worlds:**
-    ```js
-    await world.incrementDataObjectValue([`totalMessagesSentCount`], 1);
-    ```
+    `` js await world.incrementDataObjectValue([`totalMessagesSentCount`], 1);  ``
+    <br/>
 
 ### Data Object Locking
 
@@ -216,10 +253,6 @@ Note: This does NOT impact the data objects themselves but rather allows you to
 
 <br>
 
-<hr/>
-
-<br>
-
 # Contributors
 
 <hr/>

package/dist/index.cjs

@@ -40067,6 +40067,28 @@ class DroppedAsset extends Asset {
             throw this.errorHandler({ error, params: { isMutezone }, sdkMethod: "DroppedAsset.updateMuteZone" });
         }
     }
+    /**
+     * @summary
+     * Updates landmark zone options for a dropped asset.
+     *
+     * @usage
+     * ```ts
+     * await droppedAsset.updateLandmarkZone({
+     *  isLandmarkZoneEnabled: true,
+     *  landmarkZoneName: "Example",
+     *  landmarkZoneIsVisible: true,
+     *});
+     * ```
+     */
+    updateLandmarkZone({ isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible, }) {
+        const params = { isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible };
+        try {
+            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, params, "set-landmark-zone");
+        }
+        catch (error) {
+            throw this.errorHandler({ error, params, sdkMethod: "DroppedAsset.updateLandmarkZone" });
+        }
+    }
     /**
      * @summary
      * Updates webhook zone options for a dropped asset.
@@ -40623,7 +40645,6 @@ class World extends SDKController {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/assets-with-unique-name/${uniqueName}?${isPartial ? `partial=${isPartial}&` : ""}${isReversed ? `reversed=${isReversed}` : ""}`, this.requestOptions);
-                // create temp map and then update private property only once
                 const droppedAssets = [];
                 for (const asset of response.data.assets) {
                     droppedAssets.push(new DroppedAsset(this.topia, asset.id, this.urlSlug, {
@@ -40642,6 +40663,46 @@ class World extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Retrieve all landmark zone assets dropped in a world.
+     *
+     * @usage
+     * ```ts
+     * const zones = await world.fetchLandmarkZones("optionalLandmarkZoneName", "optionalSceneDropIdExample");
+     * ```
+     */
+    fetchLandmarkZones(landmarkZoneName, sceneDropId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let queryParams = "";
+                if (landmarkZoneName) {
+                    queryParams = `?landmarkZoneName=${landmarkZoneName}`;
+                    if (sceneDropId)
+                        queryParams += `&sceneDropId=${sceneDropId}`;
+                }
+                else if (sceneDropId) {
+                    queryParams = `?sceneDropId=${sceneDropId}`;
+                }
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/landmark-zones${queryParams}`, this.requestOptions);
+                const droppedAssets = [];
+                for (const asset of response.data.assets) {
+                    droppedAssets.push(new DroppedAsset(this.topia, asset.id, this.urlSlug, {
+                        attributes: asset,
+                        credentials: this.credentials,
+                    }));
+                }
+                return droppedAssets;
+            }
+            catch (error) {
+                throw this.errorHandler({
+                    error,
+                    params: { landmarkZoneName, sceneDropId },
+                    sdkMethod: "World.fetchLandmarkZones",
+                });
+            }
+        });
+    }
     /**
      * @summary
      * Retrieve all assets dropped in a world matching sceneDropId.
@@ -40800,9 +40861,9 @@ class World extends SDKController {
      * { sceneDropId: sceneId-timestamp, success: true }
      * ```
      */
-    dropScene({ assetSuffix, position, sceneId, }) {
+    dropScene({ assetSuffix, position, sceneDropId, sceneId, }) {
         return __awaiter(this, void 0, void 0, function* () {
-            const params = { assetSuffix, position, sceneId };
+            const params = { assetSuffix, position, sceneDropId, sceneId };
             try {
                 const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/drop-scene`, params, this.requestOptions);
                 return result;
@@ -40871,7 +40932,7 @@ class World extends SDKController {
     triggerParticle({ id, name, duration = 10, position = { x: 1, y: 1 }, }) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!id && !name)
-                throw "An particle name is required.";
+                throw "A particle name is required.";
             try {
                 let particleId = id;
                 if (name) {
@@ -41050,6 +41111,128 @@ class User extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Returns all avatars owned by User
+     *
+     * @usage
+     * ```ts
+     * const avatars = await user.fetchAvatars();
+     * ```
+     */
+    fetchAvatars() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/avatars`, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, sdkMethod: "User.fetchAvatars" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Add a new avatar
+     *
+     * @usage
+     * ```ts
+     * const { avatarId, spriteSheetId } = await user.addAvatar({
+     *   name: "ExampleAvatar",
+     *   animationMeta: {
+     *     dance: {
+     *       loop: true,
+     *       x: 0,
+     *       y: -20,
+     *       hideLoop: true,
+     *     },
+     *   },
+     *   animations: {
+     *     "dance": [
+     *       "dance/1.png",
+     *       "dance/2.png",
+     *       "dance/3.png",
+     *       "dance/4.png",
+     *       "dance/5.png",
+     *     ],
+     *   },
+     *   frames: {
+     *     "dance/1.png": {
+     *       "frame": {
+     *         "x": 1,
+     *         "y": 1040,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "rotated": true,
+     *       "trimmed": true,
+     *       "spriteSourceSize": {
+     *         "x": 50,
+     *         "y": 58,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "sourceSize": {
+     *         "w": 159,
+     *         "h": 200
+     *       }
+     *     },
+     *   },
+     *   "spriteSheetType": "PLAYER_AVATAR",
+     *   "spriteSheetTypeMeta": {
+     *   "meta": {
+     *     "image": "spriteSheets%2FTvHNjgoMkiErDNSrVqHU%2FspriteSheet.png?alt=media",
+     *     "format": "RGBA8888",
+     *     "size": {
+     *       "w": 2006,
+     *       "h": 1099,
+     *     },
+     *     "scale": "1",
+     *   },
+     * });
+     * ```
+     */
+    addAvatar({ animationMeta, animations, name, frames, meta, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = { animationMeta, animations, name, frames, meta };
+            try {
+                const response = yield this.topiaPublicApi().post(`/avatars`, params, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params, sdkMethod: "User.addAvatar" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Upload sprite sheet and avatar preview .png files to existing sprite sheet and avatar storage buckets
+     *
+     * @usage
+     * ```ts
+     * const formData = new FormData();
+     * formData.append('expression_dance', expression_dance);
+     * formData.append('expression_emote', expression_emote);
+     * formData.append('expression_sit', expression_sit);
+     * formData.append('expression_stand', expression_stand);
+     * formData.append('expression_transport', expression_transport);
+     * formData.append('preview', preview);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('unityPackage', unityPackage);
+     * await user.uploadAvatarFiles("exampleAvatarId", formData);
+     * ```
+     */
+    uploadAvatarFiles(avatarId, formData) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().post(`/avatars/${avatarId}/upload-files`, formData, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, sdkMethod: "User.uploadAvatarFiles" });
+            }
+        });
+    }
     /**
      * @summary
      * Returns all assets owned by User when an email address is provided.
@@ -41576,7 +41759,7 @@ class Visitor extends User {
     triggerParticle({ id, name, duration = 10, }) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!id && !name)
-                throw "An particle name is required.";
+                throw "A particle name is required.";
             try {
                 let particleId = id;
                 if (name) {
@@ -41725,10 +41908,10 @@ class WorldActivity extends SDKController {
         return __classPrivateFieldGet(this, _WorldActivity_visitorsMap, "f");
     }
     //////// visitors
-    fetchVisitors() {
+    fetchVisitors(droppedAssetId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/visitors`, this.requestOptions);
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/visitors${droppedAssetId ? `?droppedAssetId=${droppedAssetId}` : ""}`, this.requestOptions);
                 // create temp map and then update private property only once
                 const tempVisitorsMap = {};
                 for (const id in response.data) {
@@ -41764,6 +41947,28 @@ class WorldActivity extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Retrieve all visitors currently in a Landmark Zone.
+     *
+     * @usage
+     * ```ts
+     * const visitors = await worldActivity.fetchVisitorsInZone("exampleDroppedAssetId");
+     * ```
+     */
+    fetchVisitorsInZone(droppedAssetId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!droppedAssetId)
+                    throw "A landmark zone id (droppedAssetId) is required.";
+                yield this.fetchVisitors(droppedAssetId);
+                return this.visitors;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { droppedAssetId }, sdkMethod: "WorldActivity.fetchVisitorsInZone" });
+            }
+        });
+    }
     /**
      * @summary
      * Move all visitors currently in a world to a single set of coordinates.

package/dist/index.d.ts

@@ -2,6 +2,55 @@ import * as axios from 'axios';
 import { AxiosResponse, AxiosInstance, AxiosError } from 'axios';
 import jwt from 'jsonwebtoken';
 
+type AnimationMetaType = {
+    loop: boolean;
+    x: number;
+    y: number;
+    hideLoop: boolean;
+};
+type FrameType = {
+    frame: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    rotated: boolean;
+    trimmed: boolean;
+    spriteSourceSize: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    sourceSize: {
+        w: number;
+        h: number;
+    };
+};
+type SpriteSheetJSONType = {
+    name: string;
+    animations: {
+        [key: string]: string[];
+    };
+    animationMeta: {
+        [key: string]: AnimationMetaType;
+    };
+    frames: {
+        [key: string]: FrameType;
+    };
+    meta: {
+        image: string;
+        format: string;
+        size: {
+            w: number;
+            h: number;
+        };
+        scale: string;
+    };
+    spriteSheetType: string;
+};
+
 declare enum DroppedAssetClickType {
     NONE = "none",
     LINK = "link",
@@ -275,6 +324,24 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      * ```
      */
     updateMuteZone(isMutezone: boolean): Promise<void | ResponseType$1>;
+    /**
+     * @summary
+     * Updates landmark zone options for a dropped asset.
+     *
+     * @usage
+     * ```ts
+     * await droppedAsset.updateLandmarkZone({
+     *  isLandmarkZoneEnabled: true,
+     *  landmarkZoneName: "Example",
+     *  landmarkZoneIsVisible: true,
+     *});
+     * ```
+     */
+    updateLandmarkZone({ isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible, }: {
+        isLandmarkZoneEnabled: boolean;
+        landmarkZoneName?: string;
+        landmarkZoneIsVisible?: boolean;
+    }): Promise<void | ResponseType$1>;
     /**
      * @summary
      * Updates webhook zone options for a dropped asset.
@@ -521,6 +588,16 @@ declare class World extends SDKController implements WorldInterface {
         isPartial?: boolean;
         isReversed?: boolean;
     }): Promise<DroppedAsset[]>;
+    /**
+     * @summary
+     * Retrieve all landmark zone assets dropped in a world.
+     *
+     * @usage
+     * ```ts
+     * const zones = await world.fetchLandmarkZones("optionalLandmarkZoneName", "optionalSceneDropIdExample");
+     * ```
+     */
+    fetchLandmarkZones(landmarkZoneName?: string, sceneDropId?: string): Promise<DroppedAsset[]>;
     /**
      * @summary
      * Retrieve all assets dropped in a world matching sceneDropId.
@@ -626,9 +703,10 @@ declare class World extends SDKController implements WorldInterface {
      * { sceneDropId: sceneId-timestamp, success: true }
      * ```
      */
-    dropScene({ assetSuffix, position, sceneId, }: {
-        assetSuffix: string;
+    dropScene({ assetSuffix, position, sceneDropId, sceneId, }: {
+        assetSuffix?: string;
         position: object;
+        sceneDropId?: string;
         sceneId: string;
     }): Promise<object | ResponseType$1>;
     /**
@@ -819,6 +897,97 @@ declare class User extends SDKController implements UserInterface {
      * ```
      */
     checkInteractiveCredentials(): Promise<void | ResponseType$1>;
+    /**
+     * @summary
+     * Returns all avatars owned by User
+     *
+     * @usage
+     * ```ts
+     * const avatars = await user.fetchAvatars();
+     * ```
+     */
+    fetchAvatars(): Promise<void | ResponseType$1>;
+    /**
+     * @summary
+     * Add a new avatar
+     *
+     * @usage
+     * ```ts
+     * const { avatarId, spriteSheetId } = await user.addAvatar({
+     *   name: "ExampleAvatar",
+     *   animationMeta: {
+     *     dance: {
+     *       loop: true,
+     *       x: 0,
+     *       y: -20,
+     *       hideLoop: true,
+     *     },
+     *   },
+     *   animations: {
+     *     "dance": [
+     *       "dance/1.png",
+     *       "dance/2.png",
+     *       "dance/3.png",
+     *       "dance/4.png",
+     *       "dance/5.png",
+     *     ],
+     *   },
+     *   frames: {
+     *     "dance/1.png": {
+     *       "frame": {
+     *         "x": 1,
+     *         "y": 1040,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "rotated": true,
+     *       "trimmed": true,
+     *       "spriteSourceSize": {
+     *         "x": 50,
+     *         "y": 58,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "sourceSize": {
+     *         "w": 159,
+     *         "h": 200
+     *       }
+     *     },
+     *   },
+     *   "spriteSheetType": "PLAYER_AVATAR",
+     *   "spriteSheetTypeMeta": {
+     *   "meta": {
+     *     "image": "spriteSheets%2FTvHNjgoMkiErDNSrVqHU%2FspriteSheet.png?alt=media",
+     *     "format": "RGBA8888",
+     *     "size": {
+     *       "w": 2006,
+     *       "h": 1099,
+     *     },
+     *     "scale": "1",
+     *   },
+     * });
+     * ```
+     */
+    addAvatar({ animationMeta, animations, name, frames, meta, }: SpriteSheetJSONType): Promise<void | ResponseType$1>;
+    /**
+     * @summary
+     * Upload sprite sheet and avatar preview .png files to existing sprite sheet and avatar storage buckets
+     *
+     * @usage
+     * ```ts
+     * const formData = new FormData();
+     * formData.append('expression_dance', expression_dance);
+     * formData.append('expression_emote', expression_emote);
+     * formData.append('expression_sit', expression_sit);
+     * formData.append('expression_stand', expression_stand);
+     * formData.append('expression_transport', expression_transport);
+     * formData.append('preview', preview);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('unityPackage', unityPackage);
+     * await user.uploadAvatarFiles("exampleAvatarId", formData);
+     * ```
+     */
+    uploadAvatarFiles(avatarId: string, formData: FormData): Promise<void | ResponseType$1>;
     /**
      * @summary
      * Returns all assets owned by User when an email address is provided.
@@ -1712,6 +1881,18 @@ declare class WorldActivity extends SDKController {
     currentVisitors(): Promise<{
         [key: string]: Visitor;
     }>;
+    /**
+     * @summary
+     * Retrieve all visitors currently in a Landmark Zone.
+     *
+     * @usage
+     * ```ts
+     * const visitors = await worldActivity.fetchVisitorsInZone("exampleDroppedAssetId");
+     * ```
+     */
+    fetchVisitorsInZone(droppedAssetId: string): Promise<{
+        [key: string]: Visitor;
+    }>;
     /**
      * @summary
      * Move all visitors currently in a world to a single set of coordinates.

package/dist/index.js

@@ -40065,6 +40065,28 @@ class DroppedAsset extends Asset {
             throw this.errorHandler({ error, params: { isMutezone }, sdkMethod: "DroppedAsset.updateMuteZone" });
         }
     }
+    /**
+     * @summary
+     * Updates landmark zone options for a dropped asset.
+     *
+     * @usage
+     * ```ts
+     * await droppedAsset.updateLandmarkZone({
+     *  isLandmarkZoneEnabled: true,
+     *  landmarkZoneName: "Example",
+     *  landmarkZoneIsVisible: true,
+     *});
+     * ```
+     */
+    updateLandmarkZone({ isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible, }) {
+        const params = { isLandmarkZoneEnabled, landmarkZoneName, landmarkZoneIsVisible };
+        try {
+            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, params, "set-landmark-zone");
+        }
+        catch (error) {
+            throw this.errorHandler({ error, params, sdkMethod: "DroppedAsset.updateLandmarkZone" });
+        }
+    }
     /**
      * @summary
      * Updates webhook zone options for a dropped asset.
@@ -40621,7 +40643,6 @@ class World extends SDKController {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/assets-with-unique-name/${uniqueName}?${isPartial ? `partial=${isPartial}&` : ""}${isReversed ? `reversed=${isReversed}` : ""}`, this.requestOptions);
-                // create temp map and then update private property only once
                 const droppedAssets = [];
                 for (const asset of response.data.assets) {
                     droppedAssets.push(new DroppedAsset(this.topia, asset.id, this.urlSlug, {
@@ -40640,6 +40661,46 @@ class World extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Retrieve all landmark zone assets dropped in a world.
+     *
+     * @usage
+     * ```ts
+     * const zones = await world.fetchLandmarkZones("optionalLandmarkZoneName", "optionalSceneDropIdExample");
+     * ```
+     */
+    fetchLandmarkZones(landmarkZoneName, sceneDropId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let queryParams = "";
+                if (landmarkZoneName) {
+                    queryParams = `?landmarkZoneName=${landmarkZoneName}`;
+                    if (sceneDropId)
+                        queryParams += `&sceneDropId=${sceneDropId}`;
+                }
+                else if (sceneDropId) {
+                    queryParams = `?sceneDropId=${sceneDropId}`;
+                }
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/landmark-zones${queryParams}`, this.requestOptions);
+                const droppedAssets = [];
+                for (const asset of response.data.assets) {
+                    droppedAssets.push(new DroppedAsset(this.topia, asset.id, this.urlSlug, {
+                        attributes: asset,
+                        credentials: this.credentials,
+                    }));
+                }
+                return droppedAssets;
+            }
+            catch (error) {
+                throw this.errorHandler({
+                    error,
+                    params: { landmarkZoneName, sceneDropId },
+                    sdkMethod: "World.fetchLandmarkZones",
+                });
+            }
+        });
+    }
     /**
      * @summary
      * Retrieve all assets dropped in a world matching sceneDropId.
@@ -40798,9 +40859,9 @@ class World extends SDKController {
      * { sceneDropId: sceneId-timestamp, success: true }
      * ```
      */
-    dropScene({ assetSuffix, position, sceneId, }) {
+    dropScene({ assetSuffix, position, sceneDropId, sceneId, }) {
         return __awaiter(this, void 0, void 0, function* () {
-            const params = { assetSuffix, position, sceneId };
+            const params = { assetSuffix, position, sceneDropId, sceneId };
             try {
                 const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/drop-scene`, params, this.requestOptions);
                 return result;
@@ -40869,7 +40930,7 @@ class World extends SDKController {
     triggerParticle({ id, name, duration = 10, position = { x: 1, y: 1 }, }) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!id && !name)
-                throw "An particle name is required.";
+                throw "A particle name is required.";
             try {
                 let particleId = id;
                 if (name) {
@@ -41048,6 +41109,128 @@ class User extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Returns all avatars owned by User
+     *
+     * @usage
+     * ```ts
+     * const avatars = await user.fetchAvatars();
+     * ```
+     */
+    fetchAvatars() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/avatars`, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, sdkMethod: "User.fetchAvatars" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Add a new avatar
+     *
+     * @usage
+     * ```ts
+     * const { avatarId, spriteSheetId } = await user.addAvatar({
+     *   name: "ExampleAvatar",
+     *   animationMeta: {
+     *     dance: {
+     *       loop: true,
+     *       x: 0,
+     *       y: -20,
+     *       hideLoop: true,
+     *     },
+     *   },
+     *   animations: {
+     *     "dance": [
+     *       "dance/1.png",
+     *       "dance/2.png",
+     *       "dance/3.png",
+     *       "dance/4.png",
+     *       "dance/5.png",
+     *     ],
+     *   },
+     *   frames: {
+     *     "dance/1.png": {
+     *       "frame": {
+     *         "x": 1,
+     *         "y": 1040,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "rotated": true,
+     *       "trimmed": true,
+     *       "spriteSourceSize": {
+     *         "x": 50,
+     *         "y": 58,
+     *         "w": 58,
+     *         "h": 107
+     *       },
+     *       "sourceSize": {
+     *         "w": 159,
+     *         "h": 200
+     *       }
+     *     },
+     *   },
+     *   "spriteSheetType": "PLAYER_AVATAR",
+     *   "spriteSheetTypeMeta": {
+     *   "meta": {
+     *     "image": "spriteSheets%2FTvHNjgoMkiErDNSrVqHU%2FspriteSheet.png?alt=media",
+     *     "format": "RGBA8888",
+     *     "size": {
+     *       "w": 2006,
+     *       "h": 1099,
+     *     },
+     *     "scale": "1",
+     *   },
+     * });
+     * ```
+     */
+    addAvatar({ animationMeta, animations, name, frames, meta, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const params = { animationMeta, animations, name, frames, meta };
+            try {
+                const response = yield this.topiaPublicApi().post(`/avatars`, params, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params, sdkMethod: "User.addAvatar" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Upload sprite sheet and avatar preview .png files to existing sprite sheet and avatar storage buckets
+     *
+     * @usage
+     * ```ts
+     * const formData = new FormData();
+     * formData.append('expression_dance', expression_dance);
+     * formData.append('expression_emote', expression_emote);
+     * formData.append('expression_sit', expression_sit);
+     * formData.append('expression_stand', expression_stand);
+     * formData.append('expression_transport', expression_transport);
+     * formData.append('preview', preview);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('unityPackage', unityPackage);
+     * await user.uploadAvatarFiles("exampleAvatarId", formData);
+     * ```
+     */
+    uploadAvatarFiles(avatarId, formData) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().post(`/avatars/${avatarId}/upload-files`, formData, this.requestOptions);
+                return response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, sdkMethod: "User.uploadAvatarFiles" });
+            }
+        });
+    }
     /**
      * @summary
      * Returns all assets owned by User when an email address is provided.
@@ -41574,7 +41757,7 @@ class Visitor extends User {
     triggerParticle({ id, name, duration = 10, }) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!id && !name)
-                throw "An particle name is required.";
+                throw "A particle name is required.";
             try {
                 let particleId = id;
                 if (name) {
@@ -41723,10 +41906,10 @@ class WorldActivity extends SDKController {
         return __classPrivateFieldGet(this, _WorldActivity_visitorsMap, "f");
     }
     //////// visitors
-    fetchVisitors() {
+    fetchVisitors(droppedAssetId) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/visitors`, this.requestOptions);
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/visitors${droppedAssetId ? `?droppedAssetId=${droppedAssetId}` : ""}`, this.requestOptions);
                 // create temp map and then update private property only once
                 const tempVisitorsMap = {};
                 for (const id in response.data) {
@@ -41762,6 +41945,28 @@ class WorldActivity extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Retrieve all visitors currently in a Landmark Zone.
+     *
+     * @usage
+     * ```ts
+     * const visitors = await worldActivity.fetchVisitorsInZone("exampleDroppedAssetId");
+     * ```
+     */
+    fetchVisitorsInZone(droppedAssetId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!droppedAssetId)
+                    throw "A landmark zone id (droppedAssetId) is required.";
+                yield this.fetchVisitors(droppedAssetId);
+                return this.visitors;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { droppedAssetId }, sdkMethod: "WorldActivity.fetchVisitorsInZone" });
+            }
+        });
+    }
     /**
      * @summary
      * Move all visitors currently in a world to a single set of coordinates.

package/package.json

@@ -59,5 +59,5 @@
     "local-publish": "yarn build && yalc publish --push --no-scripts"
   },
   "type": "module",
-  "version": "0.10.0"
+  "version": "0.11.1"
 }