@rtsdk/topia 0.9.2 → 0.11.0

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.
@@ -40280,10 +40302,15 @@ class DroppedAsset extends Asset {
                 switch (periodType) {
                     case "week":
                         query = `&week=W${dateValue}`;
+                        break;
                     case "month":
                         query = `&month=${dateValue}`;
+                        break;
                     case "quarter":
                         query = `&quarter=Q${dateValue}`;
+                        break;
+                    default:
+                        "";
                 }
                 const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/dropped-asset-analytics/${this.id}?year=${year}${query}`, this.requestOptions);
                 return response.data;
@@ -40618,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, {
@@ -40637,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.
@@ -40834,6 +40900,53 @@ class World extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await world.getAllParticles();
+     * ```
+     */
+    getAllParticles() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield this.topiaPublicApi().get(`/particles`, this.requestOptions);
+                return result.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: {}, sdkMethod: "World.getAllParticles" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Trigger a particle effect at a position in the world
+     *
+     * @usage
+     * ```ts
+     * await world.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration = 10, position = { x: 1, y: 1 }, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!id && !name)
+                throw "A particle name is required.";
+            try {
+                let particleId = id;
+                if (name) {
+                    const response = yield this.topiaPublicApi().get(`/particles?name=${name}`, this.requestOptions);
+                    particleId = response.data[0].id;
+                }
+                const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/particles`, { particleId, position, duration }, this.requestOptions);
+                return result;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { id, name }, sdkMethod: "World.triggerParticle" });
+            }
+        });
+    }
     /**
      * @summary
      * 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.
@@ -40998,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('dancePreviewImage', dancePreviewImage);
+     * formData.append('emotePreviewImage', emotePreviewImage);
+     * formData.append('previewImageFile', previewImageFile);
+     * formData.append('sitPreviewImage', sitPreviewImage);
+     * formData.append('standPreviewImage', standPreviewImage);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('transportPreviewImage', transportPreviewImage);
+     * 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.
@@ -41492,6 +41727,53 @@ class Visitor extends User {
             }
         });
     }
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await visitor.getAllParticles();
+     * ```
+     */
+    getAllParticles() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield this.topiaPublicApi().get(`/particles`, this.requestOptions);
+                return result.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: {}, sdkMethod: "Visitor.getAllParticles" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Trigger a particle effect on a visitor
+     *
+     * @usage
+     * ```ts
+     * await visitor.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration = 10, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!id && !name)
+                throw "A particle name is required.";
+            try {
+                let particleId = id;
+                if (name) {
+                    const response = yield this.topiaPublicApi().get(`/particles?name=${name}`, this.requestOptions);
+                    particleId = response.data[0].id;
+                }
+                const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/particles`, { particleId, position: { x: 1, y: 1 }, duration, followPlayerId: this.id }, this.requestOptions);
+                return result;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { id, name }, sdkMethod: "Visitor.triggerParticle" });
+            }
+        });
+    }
     /**
      * @summary
      * Retrieves the data object for a visitor.
@@ -41626,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) {
@@ -41665,6 +41947,26 @@ 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 {
+                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.
@@ -649,6 +726,31 @@ declare class World extends SDKController implements WorldInterface {
      * ```
      */
     replaceScene(sceneId: string): Promise<void | ResponseType$1>;
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await world.getAllParticles();
+     * ```
+     */
+    getAllParticles(): Promise<object | ResponseType$1>;
+    /**
+     * @summary
+     * Trigger a particle effect at a position in the world
+     *
+     * @usage
+     * ```ts
+     * await world.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration, position, }: {
+        id?: string;
+        name?: string;
+        duration?: number;
+        position?: object;
+    }): Promise<object | ResponseType$1>;
     /**
      * @summary
      * Retrieves the data object for a world. Must have valid interactive credentials from a visitor in the world.
@@ -794,6 +896,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('dancePreviewImage', dancePreviewImage);
+     * formData.append('emotePreviewImage', emotePreviewImage);
+     * formData.append('previewImageFile', previewImageFile);
+     * formData.append('sitPreviewImage', sitPreviewImage);
+     * formData.append('standPreviewImage', standPreviewImage);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('transportPreviewImage', transportPreviewImage);
+     * 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.
@@ -1057,6 +1250,30 @@ declare class Visitor extends User implements VisitorInterface {
         id?: string;
         name?: string;
     }): Promise<object | ResponseType$1>;
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await visitor.getAllParticles();
+     * ```
+     */
+    getAllParticles(): Promise<object | ResponseType$1>;
+    /**
+     * @summary
+     * Trigger a particle effect on a visitor
+     *
+     * @usage
+     * ```ts
+     * await visitor.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration, }: {
+        id?: string;
+        name?: string;
+        duration?: number;
+    }): Promise<object | ResponseType$1>;
     /**
      * @summary
      * Retrieves the data object for a visitor.
@@ -1663,6 +1880,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.
@@ -40278,10 +40300,15 @@ class DroppedAsset extends Asset {
                 switch (periodType) {
                     case "week":
                         query = `&week=W${dateValue}`;
+                        break;
                     case "month":
                         query = `&month=${dateValue}`;
+                        break;
                     case "quarter":
                         query = `&quarter=Q${dateValue}`;
+                        break;
+                    default:
+                        "";
                 }
                 const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/dropped-asset-analytics/${this.id}?year=${year}${query}`, this.requestOptions);
                 return response.data;
@@ -40616,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, {
@@ -40635,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.
@@ -40832,6 +40898,53 @@ class World extends SDKController {
             }
         });
     }
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await world.getAllParticles();
+     * ```
+     */
+    getAllParticles() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield this.topiaPublicApi().get(`/particles`, this.requestOptions);
+                return result.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: {}, sdkMethod: "World.getAllParticles" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Trigger a particle effect at a position in the world
+     *
+     * @usage
+     * ```ts
+     * await world.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration = 10, position = { x: 1, y: 1 }, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!id && !name)
+                throw "A particle name is required.";
+            try {
+                let particleId = id;
+                if (name) {
+                    const response = yield this.topiaPublicApi().get(`/particles?name=${name}`, this.requestOptions);
+                    particleId = response.data[0].id;
+                }
+                const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/particles`, { particleId, position, duration }, this.requestOptions);
+                return result;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { id, name }, sdkMethod: "World.triggerParticle" });
+            }
+        });
+    }
     /**
      * @summary
      * 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.
@@ -40996,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('dancePreviewImage', dancePreviewImage);
+     * formData.append('emotePreviewImage', emotePreviewImage);
+     * formData.append('previewImageFile', previewImageFile);
+     * formData.append('sitPreviewImage', sitPreviewImage);
+     * formData.append('standPreviewImage', standPreviewImage);
+     * formData.append('spriteSheet', spriteSheet);
+     * formData.append('transportPreviewImage', transportPreviewImage);
+     * 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.
@@ -41490,6 +41725,53 @@ class Visitor extends User {
             }
         });
     }
+    /**
+     * @summary
+     * Get all particles available
+     *
+     * @usage
+     * ```ts
+     * await visitor.getAllParticles();
+     * ```
+     */
+    getAllParticles() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield this.topiaPublicApi().get(`/particles`, this.requestOptions);
+                return result.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: {}, sdkMethod: "Visitor.getAllParticles" });
+            }
+        });
+    }
+    /**
+     * @summary
+     * Trigger a particle effect on a visitor
+     *
+     * @usage
+     * ```ts
+     * await visitor.triggerParticle({ name: "Flame" });
+     * ```
+     */
+    triggerParticle({ id, name, duration = 10, }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!id && !name)
+                throw "A particle name is required.";
+            try {
+                let particleId = id;
+                if (name) {
+                    const response = yield this.topiaPublicApi().get(`/particles?name=${name}`, this.requestOptions);
+                    particleId = response.data[0].id;
+                }
+                const result = yield this.topiaPublicApi().post(`/world/${this.urlSlug}/particles`, { particleId, position: { x: 1, y: 1 }, duration, followPlayerId: this.id }, this.requestOptions);
+                return result;
+            }
+            catch (error) {
+                throw this.errorHandler({ error, params: { id, name }, sdkMethod: "Visitor.triggerParticle" });
+            }
+        });
+    }
     /**
      * @summary
      * Retrieves the data object for a visitor.
@@ -41624,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) {
@@ -41663,6 +41945,26 @@ 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 {
+                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.9.2"
+  "version": "0.11.0"
 }