@workadventure/iframe-api-typings 1.6.4 → 1.7.3

package/Api/Events/ChangeZoneEvent.d.ts

@@ -0,0 +1,8 @@
+import * as tg from "generic-type-guard";
+export declare const isChangeZoneEvent: tg.TypeGuard<object & {
+    name: string;
+}>;
+/**
+ * A message sent from the game to the iFrame when a user enters or leaves a zone.
+ */
+export declare type ChangeZoneEvent = tg.GuardedType<typeof isChangeZoneEvent>;

package/Api/Events/ColorEvent.d.ts

@@ -0,0 +1,10 @@
+import * as tg from "generic-type-guard";
+export declare const isColorEvent: tg.TypeGuard<object & {
+    red: number;
+    green: number;
+    blue: number;
+}>;
+/**
+ * A message sent from the iFrame to the game to dynamically set the outline of the player.
+ */
+export declare type ColorEvent = tg.GuardedType<typeof isColorEvent>;

package/Api/Events/EmbeddedWebsiteEvent.d.ts

@@ -16,20 +16,24 @@ export declare const isEmbeddedWebsiteEvent: tg.TypeGuard<object & {
     y: number;
     width: number;
     height: number;
+    origin: "player" | "map";
+    scale: number;
 }>>;
 export declare const isCreateEmbeddedWebsiteEvent: tg.TypeGuard<object & {
     name: string;
     url: string;
     position: object & {
-        x: any;
-        y: any;
-        width: any;
-        height: any;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
     };
 } & Partial<{
     visible: boolean;
     allowApi: boolean;
     allow: string;
+    origin: "player" | "map";
+    scale: number;
 }>>;
 /**
  * A message sent from the iFrame to the game to modify an embedded website

package/Api/Events/GameStateEvent.d.ts

@@ -7,6 +7,8 @@ export declare const isGameStateEvent: tg.TypeGuard<object & {
     startLayerName: string | null;
     tags: string[];
     variables: object;
+    userRoomToken: string | undefined;
+    playerVariables: object;
 }>;
 /**
  * A message sent from the game to the iFrame when the gameState is received by the script

package/Api/Events/IframeEvent.d.ts

@@ -21,6 +21,8 @@ import type { LoadTilesetEvent } from "./LoadTilesetEvent";
 import type { MessageReferenceEvent } from "./ui/TriggerActionMessageEvent";
 import type { MenuRegisterEvent, UnregisterMenuEvent } from "./ui/MenuRegisterEvent";
 import type { ChangeLayerEvent } from "./ChangeLayerEvent";
+import type { ChangeZoneEvent } from "./ChangeZoneEvent";
+import type { WasCameraUpdatedEvent } from "./WasCameraUpdatedEvent";
 export interface TypedMessageEvent<T> extends MessageEvent {
     data: T;
 }
@@ -39,6 +41,7 @@ export declare type IframeEventMap = {
     displayBubble: null;
     removeBubble: null;
     onPlayerMove: undefined;
+    onCameraUpdate: undefined;
     showLayer: LayerEvent;
     hideLayer: LayerEvent;
     setProperty: SetPropertyEvent;
@@ -63,8 +66,11 @@ export interface IframeResponseEventMap {
     leaveEvent: EnterLeaveEvent;
     enterLayerEvent: ChangeLayerEvent;
     leaveLayerEvent: ChangeLayerEvent;
+    enterZoneEvent: ChangeZoneEvent;
+    leaveZoneEvent: ChangeZoneEvent;
     buttonClickedEvent: ButtonClickedEvent;
     hasPlayerMoved: HasPlayerMovedEvent;
+    wasCameraUpdated: WasCameraUpdatedEvent;
     menuItemClicked: MenuItemClickedEvent;
     setVariable: SetVariableEvent;
     messageTriggered: MessageReferenceEvent;
@@ -91,6 +97,8 @@ export declare const iframeQueryMapTypeGuards: {
             startLayerName: string | null;
             tags: string[];
             variables: object;
+            userRoomToken: string | undefined;
+            playerVariables: object;
         }>;
     };
     getMapData: {
@@ -103,6 +111,7 @@ export declare const iframeQueryMapTypeGuards: {
         query: tg.TypeGuard<object & {
             key: string;
             value: unknown;
+            target: "global" | "player";
         }>;
         answer: tg.TypeGuard<undefined>;
     };
@@ -159,15 +168,17 @@ export declare const iframeQueryMapTypeGuards: {
             name: string;
             url: string;
             position: object & {
-                x: any;
-                y: any;
-                width: any;
-                height: any;
+                x: number;
+                y: number;
+                width: number;
+                height: number;
             };
         } & Partial<{
             visible: boolean;
             allowApi: boolean;
             allow: string;
+            origin: "player" | "map";
+            scale: number;
         }>>;
     };
     deleteEmbeddedWebsite: {
@@ -179,18 +190,39 @@ export declare const iframeQueryMapTypeGuards: {
             name: string;
             url: string;
             position: object & {
-                x: any;
-                y: any;
-                width: any;
-                height: any;
+                x: number;
+                y: number;
+                width: number;
+                height: number;
             };
         } & Partial<{
             visible: boolean;
             allowApi: boolean;
             allow: string;
+            origin: "player" | "map";
+            scale: number;
         }>>;
         answer: tg.TypeGuard<undefined>;
     };
+    setPlayerOutline: {
+        query: tg.TypeGuard<object & {
+            red: number;
+            green: number;
+            blue: number;
+        }>;
+        answer: tg.TypeGuard<undefined>;
+    };
+    removePlayerOutline: {
+        query: tg.TypeGuard<undefined>;
+        answer: tg.TypeGuard<undefined>;
+    };
+    getPlayerPosition: {
+        query: tg.TypeGuard<undefined>;
+        answer: tg.TypeGuard<object & {
+            x: number;
+            y: number;
+        }>;
+    };
 };
 declare type GuardedType<T> = T extends (x: unknown) => x is infer T ? T : never;
 declare type IframeQueryMapTypeGuardsType = typeof iframeQueryMapTypeGuards;
@@ -209,9 +241,9 @@ export interface IframeQueryWrapper<T extends keyof IframeQueryMap> {
     id: number;
     query: IframeQuery<T>;
 }
-export declare const isIframeQueryKey: (type: string) => type is "getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite";
-export declare const isIframeQuery: (event: any) => event is IframeQuery<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite">;
-export declare const isIframeQueryWrapper: (event: any) => event is IframeQueryWrapper<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite">;
+export declare const isIframeQueryKey: (type: string) => type is "getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline" | "getPlayerPosition";
+export declare const isIframeQuery: (event: any) => event is IframeQuery<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline" | "getPlayerPosition">;
+export declare const isIframeQueryWrapper: (event: any) => event is IframeQueryWrapper<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline" | "getPlayerPosition">;
 export interface IframeAnswerEvent<T extends keyof IframeQueryMap> {
     id: number;
     type: T;
@@ -220,7 +252,7 @@ export interface IframeAnswerEvent<T extends keyof IframeQueryMap> {
 export declare const isIframeAnswerEvent: (event: {
     type?: string;
     id?: number;
-}) => event is IframeAnswerEvent<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite">;
+}) => event is IframeAnswerEvent<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline" | "getPlayerPosition">;
 export interface IframeErrorAnswerEvent {
     id: number;
     type: keyof IframeQueryMap;

package/Api/Events/OpenPopupEvent.d.ts

@@ -4,8 +4,8 @@ export declare const isOpenPopupEvent: tg.TypeGuard<object & {
     targetObject: string;
     message: string;
     buttons: (object & {
-        label: any;
-        className: any;
+        label: string;
+        className: string | undefined;
     })[];
 }>;
 /**

package/Api/Events/PlaySoundEvent.d.ts

@@ -2,13 +2,13 @@ import * as tg from "generic-type-guard";
 export declare const isPlaySoundEvent: tg.TypeGuard<object & {
     url: string;
     config: (object & {
-        volume: any;
-        loop: any;
-        mute: any;
-        rate: any;
-        detune: any;
-        seek: any;
-        delay: any;
+        volume: number | undefined;
+        loop: boolean | undefined;
+        mute: boolean | undefined;
+        rate: number | undefined;
+        detune: number | undefined;
+        seek: number | undefined;
+        delay: number | undefined;
     }) | undefined;
 }>;
 /**

package/Api/Events/PlayerPosition.d.ts

@@ -0,0 +1,6 @@
+import * as tg from "generic-type-guard";
+export declare const isPlayerPosition: tg.TypeGuard<object & {
+    x: number;
+    y: number;
+}>;
+export declare type PlayerPosition = tg.GuardedType<typeof isPlayerPosition>;

package/Api/Events/SetVariableEvent.d.ts

@@ -2,6 +2,7 @@ import * as tg from "generic-type-guard";
 export declare const isSetVariableEvent: tg.TypeGuard<object & {
     key: string;
     value: unknown;
+    target: "global" | "player";
 }>;
 /**
  * A message sent from the iFrame to the game to change the value of the property of the layer
@@ -10,7 +11,8 @@ export declare type SetVariableEvent = tg.GuardedType<typeof isSetVariableEvent>
 export declare const isSetVariableIframeEvent: tg.TypeGuard<object & {
     type: "setVariable";
     data: object & {
-        key: any;
-        value: any;
+        key: string;
+        value: unknown;
+        target: "global" | "player";
     };
 }>;

package/Api/Events/WasCameraUpdatedEvent.d.ts

@@ -0,0 +1,13 @@
+import * as tg from "generic-type-guard";
+export declare const isWasCameraUpdatedEvent: tg.TypeGuard<object & {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    zoom: number;
+}>;
+/**
+ * A message sent from the game to the iFrame to notify a movement from the camera.
+ */
+export declare type WasCameraUpdatedEvent = tg.GuardedType<typeof isWasCameraUpdatedEvent>;
+export declare type WasCameraUpdatedEventCallback = (event: WasCameraUpdatedEvent) => void;

package/Api/Events/ui/MenuRegisterEvent.d.ts

@@ -16,7 +16,7 @@ export declare const isMenuRegisterEvent: tg.TypeGuard<object & {
     name: string;
     iframe: string | undefined;
     options: object & {
-        allowApi: any;
+        allowApi: boolean;
     };
 }>;
 export declare type MenuRegisterEvent = tg.GuardedType<typeof isMenuRegisterEvent>;

package/Api/Events/ui/TriggerMessageEventHandler.d.ts

@@ -2,13 +2,13 @@ import * as tg from "generic-type-guard";
 export declare const isTriggerMessageHandlerEvent: tg.PartialTypeGuard<unknown, (object & {
     type: "triggerActionMessage";
     data: object & {
-        message: any;
-        uuid: any;
-        type: any;
+        message: string;
+        uuid: string;
+        type: "message" | "warning";
     };
 }) | (object & {
     type: "removeActionMessage";
     data: object & {
-        uuid: any;
+        uuid: string;
     };
 })>;

package/Api/IframeListener.d.ts

@@ -1,6 +1,7 @@
 import { IframeQueryMap, IframeResponseEvent, IframeResponseEventMap } from "./Events/IframeEvent";
 import type { HasPlayerMovedEvent } from "./Events/HasPlayerMovedEvent";
 import type { SetVariableEvent } from "./Events/SetVariableEvent";
+import type { WasCameraUpdatedEvent } from "./Events/WasCameraUpdatedEvent";
 declare type AnswererCallback<T extends keyof IframeQueryMap> = (query: IframeQueryMap[T]["query"], source: MessageEventSource | null) => IframeQueryMap[T]["answer"] | PromiseLike<IframeQueryMap[T]["answer"]>;
 /**
  * Listens to messages from iframes and turn those messages into easy to use observables.
@@ -13,8 +14,8 @@ declare class IframeListener {
         targetObject: string;
         message: string;
         buttons: (object & {
-            label: any;
-            className: any;
+            label: string;
+            className: string | undefined;
         })[];
     }>;
     private readonly _openTabStream;
@@ -53,13 +54,13 @@ declare class IframeListener {
     readonly playSoundStream: import("rxjs").Observable<object & {
         url: string;
         config: (object & {
-            volume: any;
-            loop: any;
-            mute: any;
-            rate: any;
-            detune: any;
-            seek: any;
-            delay: any;
+            volume: number | undefined;
+            loop: boolean | undefined;
+            mute: boolean | undefined;
+            rate: number | undefined;
+            detune: number | undefined;
+            seek: number | undefined;
+            delay: number | undefined;
         }) | undefined;
     }>;
     private readonly _stopSoundStream;
@@ -70,6 +71,10 @@ declare class IframeListener {
     readonly loadSoundStream: import("rxjs").Observable<object & {
         url: string;
     }>;
+    private readonly _trackCameraUpdateStream;
+    readonly trackCameraUpdateStream: import("rxjs").Observable<object & {
+        url: string;
+    }>;
     private readonly _setTilesStream;
     readonly setTilesStream: import("rxjs").Observable<(object & {
         x: number;
@@ -89,6 +94,8 @@ declare class IframeListener {
         y: number;
         width: number;
         height: number;
+        origin: "player" | "map";
+        scale: number;
     }>>;
     private readonly iframes;
     private readonly iframeCloseCallbacks;
@@ -101,7 +108,7 @@ declare class IframeListener {
      */
     registerIframe(iframe: HTMLIFrameElement): void;
     unregisterIframe(iframe: HTMLIFrameElement): void;
-    registerScript(scriptUrl: string): Promise<void>;
+    registerScript(scriptUrl: string, enableModuleMode?: boolean): Promise<void>;
     private getBaseUrl;
     getBaseUrlFromSource(source: MessageEventSource): string;
     private static getIFrameId;
@@ -111,7 +118,10 @@ declare class IframeListener {
     sendLeaveEvent(name: string): void;
     sendEnterLayerEvent(layerName: string): void;
     sendLeaveLayerEvent(layerName: string): void;
+    sendEnterZoneEvent(zoneName: string): void;
+    sendLeaveZoneEvent(zoneName: string): void;
     hasPlayerMoved(event: HasPlayerMovedEvent): void;
+    sendCameraUpdated(event: WasCameraUpdatedEvent): void;
     sendButtonClickedEvent(popupId: number, buttonId: number): void;
     setVariable(setVariableEvent: SetVariableEvent): void;
     sendActionMessageTriggered(uuid: string): void;

package/Api/iframe/Room/EmbeddedWebsite.d.ts

@@ -7,11 +7,21 @@ export declare class EmbeddedWebsite {
     private _allow;
     private _allowApi;
     private _position;
+    private readonly origin;
+    private _scale;
     constructor(config: CreateEmbeddedWebsiteEvent);
+    get url(): string;
     set url(url: string);
+    get visible(): boolean;
     set visible(visible: boolean);
+    get x(): number;
     set x(x: number);
+    get y(): number;
     set y(y: number);
+    get width(): number;
     set width(width: number);
+    get height(): number;
     set height(height: number);
+    get scale(): number;
+    set scale(scale: number);
 }

package/Api/iframe/camera.d.ts

@@ -0,0 +1,9 @@
+import { IframeApiContribution } from "./IframeApiContribution";
+import { Subject } from "rxjs";
+import type { WasCameraUpdatedEvent } from "../Events/WasCameraUpdatedEvent";
+export declare class WorkAdventureCameraCommands extends IframeApiContribution<WorkAdventureCameraCommands> {
+    callbacks: import("./IframeApiContribution").IframeCallbackContribution<keyof import("../Events/IframeEvent").IframeResponseEventMap>[];
+    onCameraUpdate(): Subject<WasCameraUpdatedEvent>;
+}
+declare const _default: WorkAdventureCameraCommands;
+export default _default;

package/Api/iframe/player.d.ts

@@ -2,13 +2,25 @@ import { IframeApiContribution } from "./IframeApiContribution";
 import type { HasPlayerMovedEventCallback } from "../Events/HasPlayerMovedEvent";
 export declare const setPlayerName: (name: string) => void;
 export declare const setTags: (_tags: string[]) => void;
+export declare const setUserRoomToken: (token: string | undefined) => void;
 export declare const setUuid: (_uuid: string | undefined) => void;
 export declare class WorkadventurePlayerCommands extends IframeApiContribution<WorkadventurePlayerCommands> {
+    readonly state: import("./state").WorkadventureStateCommands & {
+        [key: string]: unknown;
+    };
     callbacks: import("./IframeApiContribution").IframeCallbackContribution<keyof import("../Events/IframeEvent").IframeResponseEventMap>[];
     onPlayerMove(callback: HasPlayerMovedEventCallback): void;
     get name(): string;
     get tags(): string[];
     get id(): string | undefined;
+    getPosition(): Promise<Position>;
+    get userRoomToken(): string | undefined;
+    setOutlineColor(red: number, green: number, blue: number): Promise<void>;
+    removeOutlineColor(): Promise<void>;
 }
+export declare type Position = {
+    x: number;
+    y: number;
+};
 declare const _default: WorkadventurePlayerCommands;
 export default _default;

package/Api/iframe/state.d.ts

@@ -1,14 +1,18 @@
 import { Observable } from "rxjs";
 import { IframeApiContribution } from "./IframeApiContribution";
-export declare const initVariables: (_variables: Map<string, unknown>) => void;
 export declare class WorkadventureStateCommands extends IframeApiContribution<WorkadventureStateCommands> {
+    private target;
+    private setVariableResolvers;
+    private variables;
+    private variableSubscribers;
+    constructor(target: "global" | "player");
     callbacks: import("./IframeApiContribution").IframeCallbackContribution<keyof import("../Events/IframeEvent").IframeResponseEventMap>[];
+    initVariables(_variables: Map<string, unknown>): void;
     saveVariable(key: string, value: unknown): Promise<void>;
     loadVariable(key: string): unknown;
     hasVariable(key: string): boolean;
     onVariableChange(key: string): Observable<unknown>;
 }
-declare const proxyCommand: WorkadventureStateCommands & {
+export declare function createState(target: "global" | "player"): WorkadventureStateCommands & {
     [key: string]: unknown;
 };
-export default proxyCommand;

package/iframe_api.d.ts

@@ -1,3 +1,4 @@
+import { CoWebsite } from "./Api/iframe/nav";
 import type { ButtonDescriptor } from "./Api/iframe/Ui/ButtonDescriptor";
 import type { Popup } from "./Api/iframe/Ui/Popup";
 import type { Sound } from "./Api/iframe/Sound/Sound";
@@ -9,6 +10,7 @@ declare const wa: {
     sound: import("./Api/iframe/sound").WorkadventureSoundCommands;
     room: import("./Api/iframe/room").WorkadventureRoomCommands;
     player: import("./Api/iframe/player").WorkadventurePlayerCommands;
+    camera: import("./Api/iframe/camera").WorkAdventureCameraCommands;
     state: import("./Api/iframe/state").WorkadventureStateCommands & {
         [key: string]: unknown;
     };
@@ -52,11 +54,11 @@ declare const wa: {
     /**
      * @deprecated Use WA.nav.openCoWebSite instead
      */
-    openCoWebSite(url: string, allowApi?: boolean, allowPolicy?: string): void;
+    openCoWebSite(url: string, allowApi?: boolean, allowPolicy?: string): Promise<CoWebsite>;
     /**
      * @deprecated Use WA.nav.closeCoWebSite instead
      */
-    closeCoWebSite(): void;
+    closeCoWebSite(): Promise<void>;
     /**
      * @deprecated Use WA.ui.openPopup instead
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workadventure/iframe-api-typings",
-  "version": "v1.6.4",
+  "version": "v1.7.3",
   "description": "Typescript typings for WorkAdventure iFrame API",
   "main": "iframe_api.js",
   "types": "iframe_api.d.ts",