@rtsdk/topia 0.3.7 → 0.3.9

package/README.md

@@ -10,8 +10,22 @@ A Topia provided API Key can be included with every object initialization as a p
 
 ### Want to build interactive assets? This is how you can get started:
 
-- Email developers@metaversecloud.com and Topia wil send you a Public/Private key pair.
-- When you want to make an asset “interactive” add your PUBLIC key to the integrations page of the asset editor. Now webhooks that fire from this asset and iframes that open from this asset include the following values:
+Getting a Key Pair:
+
+- 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 the “Add Key Pair” button. This is going to be your public / private key pair for your app.
+
+Adding a Key Pair to an asset:
+
+Make an asset “interactive” by adding your PUBLIC key to the integrations page of the asset editor.
+
+- Go back to your world. Make sure you are in “Edit Mode” by toggling on Edit on the left nav bar
+- Hover over any asset. Click the pencil icon that should show up on hover and select “Edit”
+- Go to the Integrations tab
+- At the bottom, you'll see a section that says “Add player session credentials to asset interactions”. Toggle that on. Now webhooks that fire from this asset and iframes that open from this asset will include the following values:
   - assetId
   - interactivePublicKey
   - interactiveNonce

package/dist/index.cjs

@@ -40049,9 +40049,9 @@ class DroppedAsset extends Asset {
      * await droppedAsset.updatePosition(100,200);
      * ```
      */
-    updatePosition(x, y) {
+    updatePosition(x, y, yOrderAdjust) {
         try {
-            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, { x, y }, "set-position");
+            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, { x, y, yOrderAdjust }, "set-position");
         }
         catch (error) {
             throw this.errorHandler({ error });
@@ -40269,6 +40269,7 @@ class World extends SDKController {
     constructor(topia, urlSlug, options = { attributes: {}, credentials: {} }) {
         super(topia, options.credentials);
         _World_droppedAssetsMap.set(this, void 0);
+        ////////// data objects
         /**
          * @summary
          * Retrieves the data object for a world. Must have valid interactive credentials from a visitor in the world.
@@ -40642,6 +40643,28 @@ class World extends SDKController {
             }
         });
     }
+    ////////// webhooks
+    /**
+     * @summary
+     * Retrieve all webhooks in a world.
+     *
+     * @usage
+     * ```ts
+     * await world.fetchWebhooks();
+     * const webhooks = world.webhooks;
+     * ```
+     */
+    fetchWebhooks() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/webhooks`, this.requestOptions);
+                this.webhooks = response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error });
+            }
+        });
+    }
 }
 _World_droppedAssetsMap = new WeakMap();
 
@@ -41370,14 +41393,16 @@ class DroppedAssetFactory extends SDKController {
             return droppedAsset;
         });
     }
-    drop(asset, { interactivePublicKey, position: { x, y }, uniqueName, urlSlug, }) {
+    drop(asset, { interactivePublicKey, position: { x, y }, sceneDropId, uniqueName, urlSlug, yOrderAdjust, }) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const response = yield this.topiaPublicApi().post(`/world/${urlSlug}/assets`, {
                     assetId: asset.id,
                     interactivePublicKey,
                     position: { x, y },
+                    sceneDropId,
                     uniqueName,
+                    yOrderAdjust,
                 }, asset.requestOptions);
                 const { id } = response.data;
                 return new DroppedAsset(this.topia, id, urlSlug, { credentials: asset.credentials });

package/dist/index.d.ts

@@ -270,7 +270,7 @@ declare class DroppedAsset extends Asset implements DroppedAssetInterface {
      * await droppedAsset.updatePosition(100,200);
      * ```
      */
-    updatePosition(x: number, y: number): Promise<void | ResponseType>;
+    updatePosition(x: number, y: number, yOrderAdjust: number): Promise<void | ResponseType>;
     /**
      * @summary
      * Updates private zone options for a dropped asset.
@@ -374,6 +374,7 @@ declare class World extends SDKController implements WorldInterface {
     urlSlug: string;
     dataObject?: object | null | undefined;
     sceneDropIds?: [string] | null | undefined;
+    webhooks?: WorldWebhooksInterface | null | undefined;
     constructor(topia: Topia, urlSlug: string, options?: WorldOptionalInterface);
     get droppedAssets(): {
         [key: string]: DroppedAsset;
@@ -606,6 +607,17 @@ declare class World extends SDKController implements WorldInterface {
             releaseLock?: boolean;
         };
     }): Promise<void | ResponseType>;
+    /**
+     * @summary
+     * Retrieve all webhooks in a world.
+     *
+     * @usage
+     * ```ts
+     * await world.fetchWebhooks();
+     * const webhooks = world.webhooks;
+     * ```
+     */
+    fetchWebhooks(): Promise<void | ResponseType>;
 }
 
 /**
@@ -987,7 +999,7 @@ interface DroppedAssetInterface extends AssetInterface {
     updateMediaType({ audioRadius, audioSliderVolume, isVideo, mediaLink, mediaName, mediaType, portalName, syncUserMedia, }: UpdateMediaTypeInterface): Promise<void | ResponseType>;
     updateMuteZone(isMutezone: boolean): Promise<void | ResponseType>;
     updateWebhookZone(isWebhookZoneEnabled: boolean): Promise<void | ResponseType>;
-    updatePosition(x: number, y: number): 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>;
     updateUploadedMediaSelected(mediaId: string): Promise<void | ResponseType>;
@@ -1047,6 +1059,7 @@ interface DroppedAssetInterface extends AssetInterface {
     portalCoordsY?: number | null;
     showMediaAsIfPeer?: boolean | null;
     syncUserMedia?: boolean | null;
+    uniqueName?: string | null;
     urlSlug: string;
     tagJson?: string | null;
     text?: string | null;
@@ -1150,6 +1163,7 @@ interface UserInterface {
     fetchDataObject(): Promise<void | ResponseType>;
     setDataObject(dataObject: object | null | undefined, options: object): Promise<void | ResponseType>;
     incrementDataObjectValue(path: string, amount: number, options: object): Promise<void | ResponseType>;
+    dataObject?: object | null;
 }
 interface UserOptionalInterface {
     credentials?: InteractiveCredentials | object;
@@ -1213,6 +1227,21 @@ interface OpenIframeInterface {
     title?: string;
 }
 
+interface WebhookInterface {
+    webhookId?: string;
+    assetId?: string;
+    active: boolean;
+    dataObject?: object;
+    dateAdded: Date;
+    description: string;
+    isUniqueOnly: boolean;
+    lastUpdated?: Date;
+    title: string;
+    type: string;
+    url: string;
+    urlSlug: string;
+}
+
 interface WorldActivityOptionalInterface {
     credentials?: InteractiveCredentials | object;
 }
@@ -1275,6 +1304,9 @@ interface WorldOptionalInterface {
     attributes?: WorldDetailsInterface | object;
     credentials?: InteractiveCredentials | object;
 }
+interface WorldWebhooksInterface {
+    webhooks: Array<WebhookInterface>;
+}
 
 /**
  * @summary
@@ -1453,14 +1485,16 @@ declare class DroppedAssetFactory extends SDKController {
     constructor(topia: Topia);
     create(id: string, urlSlug: string, options?: DroppedAssetOptionalInterface): DroppedAsset;
     get(id: string, urlSlug: string, options?: DroppedAssetOptionalInterface): Promise<DroppedAsset>;
-    drop(asset: Asset, { interactivePublicKey, position: { x, y }, uniqueName, urlSlug, }: {
+    drop(asset: Asset, { interactivePublicKey, position: { x, y }, sceneDropId, uniqueName, urlSlug, yOrderAdjust, }: {
         interactivePublicKey?: string;
         position: {
             x: number;
             y: number;
         };
+        sceneDropId?: string;
         uniqueName?: string;
         urlSlug: string;
+        yOrderAdjust?: number;
     }): Promise<DroppedAsset>;
 }
 
@@ -1496,4 +1530,4 @@ declare class WorldFactory {
     create(urlSlug: string, options?: WorldOptionalInterface): World;
 }
 
-export { Asset, AssetFactory, AssetInterface, AssetOptionalInterface, AssetOptions, DroppedAsset, DroppedAssetClickType, DroppedAssetFactory, DroppedAssetInterface, DroppedAssetMediaType, DroppedAssetOptionalInterface, DroppedAssetOptions, FireToastInterface, InteractiveCredentials, MoveAllVisitorsInterface, MoveVisitorInterface, OpenIframeInterface, ResponseType, SDKController, SDKInterface, Scene, SceneFactory, SceneInterface, SceneOptionalInterface, Topia, TopiaInterface, UpdateBroadcastInterface, UpdateClickTypeInterface, UpdateMediaTypeInterface, UpdatePrivateZoneInterface, User, UserFactory, UserInterface, UserOptionalInterface, UserOptions, Visitor, VisitorFactory, VisitorInterface, VisitorOptionalInterface, VisitorOptions, VisitorType, VisitorsToMoveArrayType, VisitorsToMoveType, World, WorldActivity, WorldActivityFactory, WorldActivityOptionalInterface, WorldDetailsInterface, WorldFactory, WorldInterface, WorldOptionalInterface, WorldOptions };
+export { Asset, AssetFactory, AssetInterface, AssetOptionalInterface, AssetOptions, DroppedAsset, DroppedAssetClickType, DroppedAssetFactory, DroppedAssetInterface, DroppedAssetMediaType, DroppedAssetOptionalInterface, DroppedAssetOptions, FireToastInterface, InteractiveCredentials, MoveAllVisitorsInterface, MoveVisitorInterface, OpenIframeInterface, ResponseType, SDKController, SDKInterface, Scene, SceneFactory, SceneInterface, SceneOptionalInterface, Topia, TopiaInterface, UpdateBroadcastInterface, UpdateClickTypeInterface, UpdateMediaTypeInterface, UpdatePrivateZoneInterface, User, UserFactory, UserInterface, UserOptionalInterface, UserOptions, Visitor, VisitorFactory, VisitorInterface, VisitorOptionalInterface, VisitorOptions, VisitorType, VisitorsToMoveArrayType, VisitorsToMoveType, WebhookInterface, World, WorldActivity, WorldActivityFactory, WorldActivityOptionalInterface, WorldDetailsInterface, WorldFactory, WorldInterface, WorldOptionalInterface, WorldOptions, WorldWebhooksInterface };

package/dist/index.js

@@ -40047,9 +40047,9 @@ class DroppedAsset extends Asset {
      * await droppedAsset.updatePosition(100,200);
      * ```
      */
-    updatePosition(x, y) {
+    updatePosition(x, y, yOrderAdjust) {
         try {
-            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, { x, y }, "set-position");
+            return __classPrivateFieldGet(this, _DroppedAsset_updateDroppedAsset, "f").call(this, { x, y, yOrderAdjust }, "set-position");
         }
         catch (error) {
             throw this.errorHandler({ error });
@@ -40267,6 +40267,7 @@ class World extends SDKController {
     constructor(topia, urlSlug, options = { attributes: {}, credentials: {} }) {
         super(topia, options.credentials);
         _World_droppedAssetsMap.set(this, void 0);
+        ////////// data objects
         /**
          * @summary
          * Retrieves the data object for a world. Must have valid interactive credentials from a visitor in the world.
@@ -40640,6 +40641,28 @@ class World extends SDKController {
             }
         });
     }
+    ////////// webhooks
+    /**
+     * @summary
+     * Retrieve all webhooks in a world.
+     *
+     * @usage
+     * ```ts
+     * await world.fetchWebhooks();
+     * const webhooks = world.webhooks;
+     * ```
+     */
+    fetchWebhooks() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield this.topiaPublicApi().get(`/world/${this.urlSlug}/webhooks`, this.requestOptions);
+                this.webhooks = response.data;
+            }
+            catch (error) {
+                throw this.errorHandler({ error });
+            }
+        });
+    }
 }
 _World_droppedAssetsMap = new WeakMap();
 
@@ -41368,14 +41391,16 @@ class DroppedAssetFactory extends SDKController {
             return droppedAsset;
         });
     }
-    drop(asset, { interactivePublicKey, position: { x, y }, uniqueName, urlSlug, }) {
+    drop(asset, { interactivePublicKey, position: { x, y }, sceneDropId, uniqueName, urlSlug, yOrderAdjust, }) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const response = yield this.topiaPublicApi().post(`/world/${urlSlug}/assets`, {
                     assetId: asset.id,
                     interactivePublicKey,
                     position: { x, y },
+                    sceneDropId,
                     uniqueName,
+                    yOrderAdjust,
                 }, asset.requestOptions);
                 const { id } = response.data;
                 return new DroppedAsset(this.topia, id, urlSlug, { credentials: asset.credentials });

package/package.json

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