@workadventure/iframe-api-typings 1.7.1 → 1.7.2

package/Api/Events/EmbeddedWebsiteEvent.d.ts

@@ -16,6 +16,8 @@ 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;
@@ -30,6 +32,8 @@ export declare const isCreateEmbeddedWebsiteEvent: tg.TypeGuard<object & {
     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

@@ -8,6 +8,7 @@ export declare const isGameStateEvent: tg.TypeGuard<object & {
     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

@@ -22,6 +22,7 @@ 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;
 }
@@ -40,6 +41,7 @@ export declare type IframeEventMap = {
     displayBubble: null;
     removeBubble: null;
     onPlayerMove: undefined;
+    onCameraUpdate: undefined;
     showLayer: LayerEvent;
     hideLayer: LayerEvent;
     setProperty: SetPropertyEvent;
@@ -68,6 +70,7 @@ export interface IframeResponseEventMap {
     leaveZoneEvent: ChangeZoneEvent;
     buttonClickedEvent: ButtonClickedEvent;
     hasPlayerMoved: HasPlayerMovedEvent;
+    wasCameraUpdated: WasCameraUpdatedEvent;
     menuItemClicked: MenuItemClickedEvent;
     setVariable: SetVariableEvent;
     messageTriggered: MessageReferenceEvent;
@@ -95,6 +98,7 @@ export declare const iframeQueryMapTypeGuards: {
             tags: string[];
             variables: object;
             userRoomToken: string | undefined;
+            playerVariables: object;
         }>;
     };
     getMapData: {
@@ -107,6 +111,7 @@ export declare const iframeQueryMapTypeGuards: {
         query: tg.TypeGuard<object & {
             key: string;
             value: unknown;
+            target: "global" | "player";
         }>;
         answer: tg.TypeGuard<undefined>;
     };
@@ -172,6 +177,8 @@ export declare const iframeQueryMapTypeGuards: {
             visible: boolean;
             allowApi: boolean;
             allow: string;
+            origin: "player" | "map";
+            scale: number;
         }>>;
     };
     deleteEmbeddedWebsite: {
@@ -192,6 +199,8 @@ export declare const iframeQueryMapTypeGuards: {
             visible: boolean;
             allowApi: boolean;
             allow: string;
+            origin: "player" | "map";
+            scale: number;
         }>>;
         answer: tg.TypeGuard<undefined>;
     };
@@ -207,6 +216,13 @@ export declare const iframeQueryMapTypeGuards: {
         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;
@@ -225,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" | "setPlayerOutline" | "removePlayerOutline";
-export declare const isIframeQuery: (event: any) => event is IframeQuery<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline">;
-export declare const isIframeQueryWrapper: (event: any) => event is IframeQueryWrapper<"getState" | "getMapData" | "setVariable" | "loadTileset" | "openCoWebsite" | "getCoWebsites" | "closeCoWebsite" | "closeCoWebsites" | "triggerActionMessage" | "removeActionMessage" | "getEmbeddedWebsite" | "deleteEmbeddedWebsite" | "createEmbeddedWebsite" | "setPlayerOutline" | "removePlayerOutline">;
+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;
@@ -236,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" | "setPlayerOutline" | "removePlayerOutline">;
+}) => 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/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
@@ -12,5 +13,6 @@ export declare const isSetVariableIframeEvent: tg.TypeGuard<object & {
     data: object & {
         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/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.
@@ -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;
@@ -114,6 +121,7 @@ declare class IframeListener {
     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

@@ -5,14 +5,22 @@ 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.7.1",
+  "version": "v1.7.2",
   "description": "Typescript typings for WorkAdventure iFrame API",
   "main": "iframe_api.js",
   "types": "iframe_api.d.ts",