@netless/window-manager 1.0.0-canary.0 → 1.0.0-canary.11

package/src/App/AppContext.ts

@@ -1,5 +1,4 @@
 import { BoxNotCreatedError } from "../Utils/error";
-import { putScenes } from "../Utils/Common";
 import { Storage } from "./Storage";
 import {
     autorun,
@@ -19,7 +18,7 @@ import type {
 import type { ReadonlyTeleBox } from "@netless/telebox-insider";
 import type Emittery from "emittery";
 import type { BoxManager } from "../BoxManager";
-import type { AppEmitterEvent } from "../index";
+import type { AppEmitterEvent, Member } from "../index";
 import type { AppManager } from "../AppManager";
 import type { AppProxy } from "./AppProxy";
 import type {
@@ -27,11 +26,12 @@ import type {
     MagixEventDispatcher,
     MagixEventRemoveListener,
 } from "./MagixEvent";
-import type { AddPageParams, PageController, PageState } from "../Page";
+import { WhiteBoardView } from "./WhiteboardView";
+import { findMemberByUid } from "../Helper";
+import { MAX_PAGE_SIZE } from "../constants";
+import { isNumber } from "lodash";
 
-export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOptions = any>
-    implements PageController
-{
+export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOptions = any> {
     public readonly emitter: Emittery<AppEmitterEvent<TAttributes>>;
     public readonly mobxUtils = {
         autorun,
@@ -48,6 +48,8 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
     private store = this.manager.store;
     public readonly isAddApp: boolean;
     public readonly isReplay = this.manager.isReplay;
+    private whiteBoardView?: WhiteBoardView;
+    public _viewWrapper?: HTMLElement;
 
     constructor(
         private manager: AppManager,
@@ -60,9 +62,13 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
         this.isAddApp = appProxy.isAddApp;
     }
 
-    public getDisplayer = () => {
+    public get displayer() {
         return this.manager.displayer;
-    };
+    }
+
+    public get destroyed() {
+        return this.appProxy.status === "destroyed";
+    }
 
     /** @deprecated Use context.storage.state instead. */
     public getAttributes = (): TAttributes | undefined => {
@@ -78,32 +84,58 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
         }
     };
 
-    public getView = (): View | undefined => {
+    public get view(): View | undefined {
         return this.appProxy.view;
     };
 
-    public mountView = (dom: HTMLElement): void => {
-        const view = this.getView();
-        if (view) {
-            view.divElement = dom as HTMLDivElement;
-            setTimeout(() => {
-                // 渲染需要时间，延迟 refresh
-                this.getRoom()?.refreshViewSize();
-            }, 1000);
+    public createWhiteBoardView = (size?: number): WhiteBoardView => {
+        if (this.whiteBoardView) {
+            return this.whiteBoardView;
         }
-    };
+        let view = this.view;
+        if (!view) {
+            view = this.appProxy.createAppDir();
+        }
+        const viewWrapper = document.createElement("div");
+        this._viewWrapper = viewWrapper;
+        viewWrapper.className = "window-manager-view-wrapper";
+        this.box.$content.parentElement?.appendChild(viewWrapper);
+        const removeViewWrapper = () => {
+            this.box.$content.parentElement?.removeChild(viewWrapper);
+            this._viewWrapper = undefined;
+        }
+        view.divElement = viewWrapper;
+        this.appProxy.fireMemberStateChange();
+        if (this.isAddApp) {
+            this.ensurePageSize(size);
+        }
+        this.whiteBoardView = new WhiteBoardView(view, this, this.appProxy, removeViewWrapper, this.ensurePageSize);
+        return this.whiteBoardView;
+    }
+
+    private ensurePageSize = (size?: number) => {
+        if (!isNumber(size)) return;
+        if (!this.appProxy.scenePath) return;
+        if (this.appProxy.pageState.length >= size) return;
+        if (size <= 0 || size >= MAX_PAGE_SIZE) {
+            throw Error(`[WindowManager]: size ${size} muse be in range [1, ${MAX_PAGE_SIZE}]`);
+        }
+        const needInsert = size - this.appProxy.pageState.length;
+        const scenes = new Array(needInsert).fill({});
+        this.room?.putScenes(this.appProxy.scenePath, scenes);
+    }
 
     public getInitScenePath = () => {
         return this.manager.getAppInitPath(this.appId);
     };
 
     /** Get App writable status. */
-    public getIsWritable = (): boolean => {
-        return this.manager.canOperate;
+    public get isWritable(): boolean {
+        return this.manager.canOperate && !this.destroyed;
     };
 
     /** Get the App Window UI box. */
-    public getBox = (): ReadonlyTeleBox => {
+    public get box(): ReadonlyTeleBox {
         const box = this.boxManager.getBox(this.appId);
         if (box) {
             return box;
@@ -112,10 +144,25 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
         }
     };
 
-    public getRoom = (): Room | undefined => {
+    public get room(): Room | undefined {
         return this.manager.room;
     };
 
+    public get members() {
+        return this.manager.members;
+    }
+
+    public get memberState(): Member {
+        const self = findMemberByUid(this.room, this.manager.uid);
+        if (!self) {
+            throw new Error(`Member ${this.manager.uid} not found.`);
+        }
+        return {
+            uid: this.manager.uid,
+            ...self,
+        }
+    }
+
     /** @deprecated Use context.storage.setState instead. */
     public setAttributes = (attributes: TAttributes) => {
         this.manager.safeSetAttributes({ [this.appId]: attributes });
@@ -128,11 +175,12 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
         }
     };
 
+    /** @deprecated Use Pages api instead. */
     public setScenePath = async (scenePath: string): Promise<void> => {
         if (!this.appProxy.box) return;
         this.appProxy.setFullPath(scenePath);
         // 兼容 15 版本 SDK 的切页
-        this.getRoom()?.setScenePath(scenePath);
+        this.room?.setScenePath(scenePath);
     };
 
     /** Get the local App options. */
@@ -196,55 +244,4 @@ export class AppContext<TAttributes = any, TMagixEventPayloads = any, TAppOption
     public removeMagixEventListener = this.manager.displayer.removeMagixEventListener.bind(
         this.manager.displayer
     ) as MagixEventRemoveListener<TMagixEventPayloads>;
-
-    /** PageController  */
-    public nextPage = async (): Promise<boolean> => {
-        const nextIndex = this.pageState.index + 1;
-        if (nextIndex > this.pageState.length - 1) {
-            console.warn("[WindowManager] nextPage: index out of range");
-            return false;
-        }
-        this.appProxy.setSceneIndex(nextIndex);
-        return true;
-    };
-
-    public prevPage = async (): Promise<boolean> => {
-        const nextIndex = this.pageState.index - 1;
-        if (nextIndex < 0) {
-            console.warn("[WindowManager] prevPage: index out of range");
-            return false;
-        }
-        this.appProxy.setSceneIndex(nextIndex);
-        return true;
-    };
-
-    public addPage = async (params?: AddPageParams) => {
-        const after = params?.after;
-        const scene = params?.scene;
-        const scenePath = this.appProxy.scenePath;
-        if (!scenePath) return;
-        if (after) {
-            const nextIndex = this.pageState.index + 1;
-            putScenes(this.manager.room, scenePath, [scene || {}], nextIndex);
-        } else {
-            putScenes(this.manager.room, scenePath, [scene || {}]);
-        }
-    };
-
-    public removePage = async (index?: number): Promise<boolean> => {
-        const needRemoveIndex = index === undefined ? this.pageState.index : index;
-        if (this.pageState.length === 1) {
-            console.warn(`[WindowManager]: can not remove the last page`);
-            return false;
-        }
-        if (needRemoveIndex < 0 || needRemoveIndex >= this.pageState.length) {
-            console.warn(`[WindowManager]: page index ${index} out of range`);
-            return false;
-        }
-        return this.appProxy.removeSceneByIndex(needRemoveIndex);;
-    }
-
-    public get pageState(): PageState {
-        return this.appProxy.pageState;
-    }
 }

package/src/App/AppPageStateImpl.ts

@@ -9,11 +9,15 @@ export type AppPageStateParams = {
 };
 
 export class AppPageStateImpl {
-    private sceneNode: ScenesCallbacksNode | null = null;
+    public sceneNode: ScenesCallbacksNode | null = null;
+    private scenePath?: string;
+    private view?: View;
 
     constructor(private params: AppPageStateParams) {
         const { displayer, scenePath } = this.params;
+        this.view = this.params.view;
         if (scenePath) {
+            this.scenePath = scenePath;
             this.sceneNode = displayer.createScenesCallback(scenePath, {
                 onAddScene: this.onSceneChange,
                 onRemoveScene: this.onSceneChange,
@@ -21,24 +25,39 @@ export class AppPageStateImpl {
         }
     }
 
-    private onSceneChange = (node: ScenesCallbacksNode) => {
-        this.sceneNode = node;
+    public createSceneNode = (scenePath: string) => {
+        this.scenePath = scenePath;
+        if (this.sceneNode) {
+            this.sceneNode.dispose();
+        }
+        this.sceneNode = this.params.displayer.createScenesCallback(scenePath, {
+            onAddScene: this.onSceneChange,
+            onRemoveScene: this.onSceneChange,
+        });
+        return this.sceneNode;
+    }
+
+    public setView(view: View) {
+        this.view = view;
+    }
+
+    private onSceneChange = () => {
         this.params.notifyPageStateChange();
     };
 
     public getFullPath(index: number) {
         const scenes = this.sceneNode?.scenes;
-        if (this.params.scenePath && scenes) {
+        if (this.scenePath && scenes) {
             const name = scenes[index];
             if (name) {
-                return `${this.params.scenePath}/${name}`;
+                return `${this.scenePath}/${name}`;
             }
         }
     }
 
     public toObject(): PageState {
         return {
-            index: this.params.view?.focusSceneIndex || 0,
+            index: this.view?.focusSceneIndex || 0,
             length: this.sceneNode?.scenes.length || 0,
         };
     }

package/src/App/AppProxy.ts

@@ -3,15 +3,22 @@ import { AppAttributes, AppEvents, Events, SETUP_APP_DELAY } from "../constants"
 import { AppContext } from "./AppContext";
 import { AppPageStateImpl } from "./AppPageStateImpl";
 import { appRegister } from "../Register";
-import { autorun } from "white-web-sdk";
+import { AppViewSync } from "./AppViewSync";
+import { autorun, reaction, toJS } from "white-web-sdk";
+import { boxEmitter } from "../BoxEmitter";
 import { BoxManagerNotFoundError } from "../Utils/error";
+import { calculateNextIndex } from "../Page";
+import { combine, Val, ValManager } from "value-enhancer";
 import { debounce, get } from "lodash";
 import { emitter } from "../InternalEmitter";
 import { Fields } from "../AttributesDelegate";
 import { log } from "../Utils/log";
+import { SideEffectManager } from "side-effect-manager";
+import type { ICamera, ISize } from "../AttributesDelegate";
 import {
     entireScenes,
     getScenePath,
+    putScenes,
     removeScenes,
     setScenePath,
     setViewFocusScenePath,
@@ -23,13 +30,11 @@ import type {
     setAppOptions,
     AppListenerKeys,
 } from "../index";
-import type { SceneState, View, SceneDefinition } from "white-web-sdk";
+import type { SceneState, View, SceneDefinition, Camera , MemberState} from "white-web-sdk";
 import type { AppManager } from "../AppManager";
 import type { NetlessApp } from "../typings";
-import type { ReadonlyTeleBox } from "@netless/telebox-insider";
+import type { ReadonlyTeleBox, TeleBoxRect } from "@netless/telebox-insider";
 import type { PageRemoveService, PageState } from "../Page";
-import { calculateNextIndex } from "../Page";
-import { boxEmitter } from "../BoxEmitter";
 
 export type AppEmitter = Emittery<AppEmitterEvent>;
 
@@ -37,6 +42,7 @@ export class AppProxy implements PageRemoveService {
     public kind: string;
     public id: string;
     public scenePath?: string;
+    private appScenePath: string;
     public appEmitter: AppEmitter;
     public scenes?: SceneDefinition[];
 
@@ -45,16 +51,27 @@ export class AppProxy implements PageRemoveService {
     private appProxies = this.manager.appProxies;
     private viewManager = this.manager.viewManager;
     private store = this.manager.store;
+    public uid = this.manager.uid;
 
     public isAddApp: boolean;
-    private status: "normal" | "destroyed" = "normal";
+    public status: "normal" | "destroyed" = "normal";
     private stateKey: string;
-    private _pageState: AppPageStateImpl;
-    private _prevFullPath: string | undefined;
+    public _pageState: AppPageStateImpl;
 
     public appResult?: NetlessApp<any>;
     public appContext?: AppContext<any, any>;
 
+    private sideEffectManager = new SideEffectManager();
+    private valManager = new ValManager();
+
+    private fullPath$ = this.valManager.attach(new Val<string | undefined>(undefined));
+    private appViewSync?: AppViewSync;
+
+    public camera$ = this.valManager.attach(new Val<ICamera | undefined>(undefined));
+    public size$ = this.valManager.attach(new Val<ISize | undefined>(undefined));
+    public box$ = this.valManager.attach(new Val<ReadonlyTeleBox | undefined>(undefined));
+    public view$ = this.valManager.attach(new Val<View | undefined>(undefined));
+
     constructor(
         private params: BaseInsertParams,
         private manager: AppManager,
@@ -63,6 +80,7 @@ export class AppProxy implements PageRemoveService {
     ) {
         this.kind = params.kind;
         this.id = appId;
+        this.appScenePath = `/${this.id}-app-dir`;
         this.stateKey = `${this.id}_state`;
         this.appProxies.set(this.id, this);
         this.appEmitter = new Emittery();
@@ -75,12 +93,109 @@ export class AppProxy implements PageRemoveService {
             // 只有传入了 scenePath 的 App 才会创建 View
             this.createView();
         }
+        if (!this.scenePath) {
+            this.scenePath = this.appScenePath;
+        }
         this._pageState = new AppPageStateImpl({
             displayer: this.manager.displayer,
             scenePath: this.scenePath,
             view: this.view,
             notifyPageStateChange: this.notifyPageStateChange,
         });
+        this.sideEffectManager.add(() => () => this._pageState.destroy());
+        this.sideEffectManager.add(() =>
+            emitter.on("roomMembersChange", members => {
+                this.appEmitter.emit("roomMembersChange", members);
+            })
+        );
+        this.camera$.setValue(toJS(this.appAttributes.camera));
+        this.size$.setValue(toJS(this.appAttributes.size));
+        this.addCameraReaction();
+        this.addSizeReaction();
+        this.sideEffectManager.add(() =>
+            combine([this.box$, this.view$]).subscribe(([box, view]) => {
+                if (box && view) {
+                    if (!this.camera$.value) {
+                        this.storeCamera({
+                            centerX: 0,
+                            centerY: 0,
+                            scale: 1,
+                            id: this.uid,
+                        });
+                        this.camera$.setValue(toJS(this.appAttributes.camera));
+                    }
+                    if (!this.size$.value && box.contentStageRect) {
+                        const initialRect = this.computedInitialRect(box.contentStageRect);
+                        const width = initialRect?.width || box.contentStageRect.width;
+                        const height = initialRect?.height || box.contentStageRect.height;
+                        this.storeSize({
+                            id: this.uid,
+                            width,
+                            height,
+                        });
+                        this.size$.setValue(toJS(this.appAttributes.size));
+                    }
+                    this.appViewSync = new AppViewSync(this);
+                    this.sideEffectManager.add(() => () => this.appViewSync?.destroy());
+                }
+            })
+        );
+        this.sideEffectManager.add(() =>
+            emitter.on("memberStateChange", this.onMemberStateChange)
+        );
+    }
+
+    public fireMemberStateChange = () => {
+        if (this.manager.room) {
+            this.onMemberStateChange(this.manager.room.state.memberState);
+        }
+    }
+
+    private onMemberStateChange = (memberState: MemberState) => {
+        // clicker 教具把事件穿透给下层
+        const needPointerEventsNone = memberState.currentApplianceName === "clicker";
+        if (needPointerEventsNone) {
+            if (this.appContext?._viewWrapper) {
+                this.appContext._viewWrapper.style.pointerEvents = "none";
+            }
+        } else {
+            if (this.appContext?._viewWrapper) {
+                this.appContext._viewWrapper.style.pointerEvents = "auto";
+            }
+        }
+    }
+
+    private computedInitialRect = (boxRect: TeleBoxRect) => {
+        const managerRect = this.manager.boxManager?.stageRect;
+        if (managerRect) {
+            const { width, height } = managerRect;
+            const boxRatio = boxRect.height / boxRect.width;
+            if (height < 480) {
+                return {
+                    width: 480 / boxRatio,
+                    height: 480,
+                };
+            } else {
+                return {
+                    width: width * 0.65,
+                    height: height * 0.65,
+                };
+            }
+        }
+    }
+
+    public createAppDir() {
+        const scenePath = this.scenePath || this.appScenePath;
+        const sceneNode = this._pageState.createSceneNode(scenePath);
+        if (!sceneNode) {
+            putScenes(this.manager.room, scenePath, [{ name: "1" }]);
+            this._pageState.createSceneNode(scenePath);
+            this.setSceneIndex(0);
+        }
+        this.scenes = entireScenes(this.manager.displayer)[scenePath];
+        const view = this.createView();
+        this._pageState.setView(view);
+        return view;
     }
 
     private initScenes() {
@@ -96,7 +211,7 @@ export class AppProxy implements PageRemoveService {
     }
 
     public get view(): View | undefined {
-        return this.manager.viewManager.getView(this.id);
+        return this.view$.value;
     }
 
     public get viewIndex(): number | undefined {
@@ -131,7 +246,7 @@ export class AppProxy implements PageRemoveService {
     }
 
     public setFullPath(path: string) {
-        this.manager.safeUpdateAttributes(["apps", this.id, Fields.FullPath], path);
+        this.store.updateAppAttributes(this.id, Fields.FullPath, path);
     }
 
     public async baseInsertApp(skipUpdate = false): Promise<{ appId: string; app: NetlessApp }> {
@@ -160,7 +275,7 @@ export class AppProxy implements PageRemoveService {
     }
 
     public get box(): ReadonlyTeleBox | undefined {
-        return this.boxManager?.getBox(this.id);
+        return this.box$.value;
     }
 
     private async setupApp(
@@ -194,13 +309,14 @@ export class AppProxy implements PageRemoveService {
                     this.fixMobileSize();
                 }, SETUP_APP_DELAY);
             });
-            this.boxManager?.createBox({
+            const box = this.boxManager?.createBox({
                 appId: appId,
                 app,
                 options,
                 canOperate: this.manager.canOperate,
                 smartPosition: this.isAddApp,
             });
+            this.box$.setValue(box);
             if (this.isAddApp && this.box) {
                 this.store.updateAppState(appId, AppAttributes.ZIndex, this.box.zIndex);
                 this.boxManager.focusBox({ appId }, false);
@@ -345,7 +461,7 @@ export class AppProxy implements PageRemoveService {
     }
 
     private appAttributesUpdateListener = (appId: string) => {
-        this.manager.refresher?.add(appId, () => {
+        this.manager.refresher.add(appId, () => {
             return autorun(() => {
                 const attrs = this.manager.attributes[appId];
                 if (attrs) {
@@ -353,7 +469,7 @@ export class AppProxy implements PageRemoveService {
                 }
             });
         });
-        this.manager.refresher?.add(this.stateKey, () => {
+        this.manager.refresher.add(this.stateKey, () => {
             return autorun(() => {
                 const appState = this.appAttributes?.state;
                 if (appState?.zIndex > 0 && appState.zIndex !== this.box?.zIndex) {
@@ -361,13 +477,13 @@ export class AppProxy implements PageRemoveService {
                 }
             });
         });
-        this.manager.refresher?.add(`${appId}-fullPath`, () => {
+        this.manager.refresher.add(`${appId}-fullPath`, () => {
             return autorun(() => {
                 const fullPath = this.appAttributes?.fullPath;
                 this.setFocusScenePathHandler(fullPath);
-                if (this._prevFullPath !== fullPath) {
+                if (this.fullPath$.value !== fullPath) {
                     this.notifyPageStateChange();
-                    this._prevFullPath = fullPath;
+                    this.fullPath$.setValue(fullPath);
                 }
             });
         });
@@ -395,14 +511,17 @@ export class AppProxy implements PageRemoveService {
         return fullPath;
     }
 
-    private async createView(): Promise<View> {
-        const view = await this.viewManager.createView(this.id);
+    private createView(): View {
+        const view = this.viewManager.createView(this.id);
+        this.view$.setValue(view);
         this.setViewFocusScenePath();
         return view;
     }
 
     public notifyPageStateChange = debounce(() => {
-        this.appEmitter.emit("pageStateChange", this.pageState);
+        if (this.pageState) {
+            this.appEmitter.emit("pageStateChange", this.pageState);
+        }
     }, 50);
 
     public get pageState(): PageState {
@@ -412,7 +531,7 @@ export class AppProxy implements PageRemoveService {
     // PageRemoveService
     public async removeSceneByIndex(index: number) {
         const scenePath = this._pageState.getFullPath(index);
-        if (scenePath) {
+        if (scenePath && this.pageState) {
             const nextIndex = calculateNextIndex(index, this.pageState);
             // 只修改 focus path 不修改 FullPath
             this.setSceneIndexWithoutSync(nextIndex);
@@ -448,6 +567,31 @@ export class AppProxy implements PageRemoveService {
         }
     }
 
+    public storeCamera = (camera: ICamera) => {
+        this.store.updateAppAttributes(this.id, Fields.Camera, camera);
+    };
+
+    public storeSize = (size: ISize) => {
+        this.store.updateAppAttributes(this.id, Fields.Size, size);
+    };
+
+    public updateSize = (width: number, height: number) => {
+        const iSize = {
+            id: this.manager.uid,
+            width, height
+        }
+        this.store.updateAppAttributes(this.id, Fields.Size, iSize);
+        this.size$.setValue(iSize);
+    }
+
+    public moveCamera = (camera: Camera) => {
+        if (!this.camera$.value) {
+            return;
+        }
+        const nextCamera = { ...this.camera$.value, ...camera };
+        this.storeCamera(nextCamera);
+    };
+
     public async destroy(
         needCloseBox: boolean,
         cleanAttrs: boolean,
@@ -463,6 +607,7 @@ export class AppProxy implements PageRemoveService {
             console.error("[WindowManager]: notifyApp error", error.message, error.stack);
         }
         this.appEmitter.clearListeners();
+        this.sideEffectManager.flushAll();
         emitter.emit(`destroy-${this.id}` as any, { error });
         if (needCloseBox) {
             this.boxManager?.closeBox(this.id, skipUpdate);
@@ -474,14 +619,49 @@ export class AppProxy implements PageRemoveService {
             }
         }
         this.appProxies.delete(this.id);
-        this._pageState.destroy();
 
         this.viewManager.destroyView(this.id);
         this.manager.appStatus.delete(this.id);
-        this.manager.refresher?.remove(this.id);
-        this.manager.refresher?.remove(this.stateKey);
-        this.manager.refresher?.remove(`${this.id}-fullPath`);
-        this._prevFullPath = undefined;
+        this.manager.refresher.remove(this.id);
+        this.manager.refresher.remove(this.stateKey);
+        this.manager.refresher.remove(`${this.id}-fullPath`);
+        this.valManager.destroy();
+    }
+
+    private addCameraReaction = () => {
+        this.sideEffectManager.add(() =>
+            this.manager.refresher.add(`${this.id}-camera`, () =>
+                reaction(
+                    () => this.appAttributes?.camera,
+                    camera => {
+                        if (camera && camera.id !== this.uid) {
+                            const rawCamera = toJS(camera);
+                            if (rawCamera !== this.camera$.value) {
+                                this.camera$.setValue(rawCamera);
+                            }
+                        }
+                    }
+                )
+            )
+        , "camera");
+    }
+
+    private addSizeReaction = () => {
+        this.sideEffectManager.add(() =>
+            this.manager.refresher.add(`${this.id}-size`, () =>
+                reaction(
+                    () => this.appAttributes?.size,
+                    size => {
+                        if (size && size.id !== this.uid) {
+                            const rawSize = toJS(size);
+                            if (this.size$.value !== rawSize) {
+                                this.size$.setValue(rawSize);
+                            }
+                        }
+                    }
+                )
+            )
+        , "size");
     }
 
     public close(): Promise<void> {