@hology/core 0.0.252 → 0.0.253

package/dist/gameplay/initiate.d.ts

@@ -1,112 +1,202 @@
-import type { Constructable, ContainerInstance } from "typedi";
-import type { ShaderType, ActorType, ActorComponentType } from '../shader/shader.js';
+import type { Constructable, ContainerInstance, ServiceIdentifier } from 'typedi';
+import { Observable } from 'rxjs';
+import type { ActorComponentType, ActorType, ShaderType } from '../shader/shader.js';
+import type { ParameterType } from '../shader/parameter.js';
+import type { DetailTier } from '../scene/model.js';
 import { World } from './services/world.js';
-import { type DirectionalShadowOptions, type DynamicResolutionOptions, type ExperimentalWebGpuPostProcessingOptions, type RenderingBackend, type UpscalingOptions } from '../rendering.js';
-import type { Observable } from 'rxjs';
-import type { DetailTier } from "../scene/model.js";
-import type { NetSession } from "./net/net-session.js";
-import type { ParameterType } from "../shader/parameter.js";
-import type { VfxBackendPreference } from "../effects/vfx/gpu-sprite-compiler.js";
+import { RenderingView, type DirectionalShadowOptions, type DynamicResolutionOptions, type ExperimentalWebGpuPostProcessingOptions, type RenderingBackend, type UpscalingOptions } from '../rendering.js';
+import type { VfxBackendPreference } from '../effects/vfx/gpu-sprite-compiler.js';
+import type { NetSession } from './net/net-session.js';
+import { RenderingHost, type RenderingHostStageContext } from './rendering-host.js';
+import { type SceneTransitionRequest } from './services/scene-transition.js';
+import { SceneRef } from '../scene/scene-ref.js';
 type GameClass<T> = Constructable<T>;
-export type InitiateGameConfig = {
-    element: HTMLElement;
-    sceneName: string;
+export type RenderingConfig = Partial<{
+    backend: RenderingBackend;
+    resolutionScale: number;
+    maxPixelRatio: number;
+    dynamicResolution: DynamicResolutionOptions;
+    upscaling: UpscalingOptions;
+    webgpuPostProcessing: ExperimentalWebGpuPostProcessingOptions;
+    webgpuDirectionalShadows: DirectionalShadowOptions;
+    webgpuVfx: VfxBackendPreference;
+    msaa: number;
+    fpsCap: number | null;
+    depthPrepass: {
+        enabled?: boolean;
+    };
+    shadows: {
+        enabled?: boolean;
+        autoUpdate?: boolean;
+    };
+    bloom: {
+        enabled?: boolean;
+    };
+    reflection: {
+        enabled?: boolean;
+    };
+    occlusionCulling: {
+        enabled?: boolean;
+    };
+}>;
+type ApplicationConfigBase = {
+    /** Optional convenience used when loadGame() is called without an explicit mode class. */
+    defaultGameClass?: GameClass<unknown>;
     dataDir: string;
-    /** Bypasses callback-based Three file loaders for runtimes with a partial DOM implementation. */
     directAssetFileLoading?: boolean;
-    /** Target-specific location of the generated hology_data.json bundle. */
     runtimeDataUrl?: string | URL;
-    shaders: {
-        [name: string]: ShaderType;
-    };
-    actors: {
-        [name: string]: ActorType;
-    };
-    components?: {
-        [name: string]: ActorComponentType;
+    shaders: Record<string, ShaderType>;
+    actors: Record<string, ActorType>;
+    components?: Record<string, ActorComponentType>;
+    dataDefinitions?: Record<string, ParameterType>;
+};
+export type InitiateApplicationConfig = ApplicationConfigBase & ({
+    element: HTMLElement;
+    renderingView?: never;
+    renderingHost?: never;
+    rendering?: RenderingConfig;
+    xr?: {
+        enabled: boolean;
     };
-    dataDefinitions?: {
-        [name: string]: ParameterType;
+} | {
+    renderingView: RenderingView;
+    renderingViewFactory?: () => RenderingView;
+    element?: never;
+    renderingHost?: never;
+    rendering?: never;
+    xr?: never;
+} | {
+    renderingHost: RenderingHost;
+    element?: never;
+    renderingView?: never;
+    rendering?: never;
+    xr?: never;
+});
+export type LoadGameConfig = {
+    sceneName: string;
+    detailTier?: DetailTier;
+    multi?: {
+        session: NetSession;
     };
+};
+export type InitiateGameConfig = ApplicationConfigBase & {
+    element: HTMLElement;
+    sceneName: string;
+    rendering?: RenderingConfig;
     xr?: {
         enabled: boolean;
     };
-    /**
-     * What tier of detail to include. If Medium, then any mesh in tier High will not be loaded or rendered but it will also load
-     * with tier low or undefined.
-    */
     detailTier?: DetailTier;
-    rendering?: Partial<{
-        backend: RenderingBackend;
-        resolutionScale: number;
-        maxPixelRatio: number;
-        dynamicResolution: DynamicResolutionOptions;
-        upscaling: UpscalingOptions;
-        webgpuPostProcessing: ExperimentalWebGpuPostProcessingOptions;
-        webgpuDirectionalShadows: DirectionalShadowOptions;
-        /** Preferred VFX simulation backend. `auto` uses GPU when supported and otherwise falls back to CPU. */
-        webgpuVfx: VfxBackendPreference;
-        msaa: number;
-        fpsCap: number | null;
-        depthPrepass: {
-            enabled?: boolean;
-        };
-        shadows: {
-            enabled?: boolean;
-            autoUpdate?: boolean;
-        };
-        bloom: {
-            enabled?: boolean;
-        };
-        reflection: {
-            enabled?: boolean;
-        };
-        occlusionCulling: {
-            enabled?: boolean;
-        };
-    }>;
     multi?: {
         session: NetSession;
     };
 };
-export declare function initiateGame<T_Game>(gameClass: GameClass<T_Game>, config: InitiateGameConfig): HologyRuntime<T_Game>;
+export type RuntimeLoadingStage = 'physics' | 'runtime-data' | 'scene' | 'game-preload' | 'shaders' | 'textures' | 'vfx-warmup';
+export type HologyApplicationState = {
+    readonly type: 'initializing';
+} | {
+    readonly type: 'menu';
+} | {
+    readonly type: 'loading';
+    readonly sceneName: string;
+    readonly progress: number;
+    readonly stage: RuntimeLoadingStage;
+} | {
+    readonly type: 'playing';
+    readonly sceneName: string;
+} | {
+    readonly type: 'unloading';
+    readonly sceneName?: string;
+} | {
+    readonly type: 'error';
+    readonly operation: 'initialize' | 'load' | 'unload';
+    readonly error: unknown;
+} | {
+    readonly type: 'stopped';
+};
+export interface GameSession<TGame = unknown> {
+    readonly sceneName: string;
+    readonly world: World;
+    readonly gameInstance: TGame;
+}
+export type ApplicationRenderStageContext = RenderingHostStageContext;
+export declare function initiateApplication(config: InitiateApplicationConfig): HologyApplicationRuntime;
+/** @deprecated Pass the game class to loadGame(); this overload supplies a default for compatibility. */
+export declare function initiateApplication<TGame>(gameClass: GameClass<TGame>, config: InitiateApplicationConfig): HologyApplicationRuntime<TGame>;
+/** @deprecated Use initiateApplication() followed by runtime.loadGame(). */
+export declare function initiateGame<TGame>(gameClass: GameClass<TGame>, config: InitiateGameConfig): HologyRuntime<TGame>;
 export declare abstract class GameInstance {
-    /** Add gameplay objects and preload render resources before the final scene compile. */
     onPreload(): void | Promise<void>;
     onStart(): void | Promise<void>;
+    onUnload(): void | Promise<void>;
+    /** @deprecated Use onUnload(). */
     onShutdown(): void | Promise<void>;
 }
-export declare function createHologyScene(): void;
-/**
- * It ideally shouldn't be async.
- *
- * It should return a runtime and it could have a status to tell you when it is ready.
- * There will be stages of loading, etc. Ideally information about loading should be exposed.
- *
- */
+export declare class HologyApplicationRuntime<TGame = unknown> {
+    private readonly config;
+    private readonly applicationContainer;
+    readonly renderingHost: RenderingHost;
+    private readonly defaultGameClass?;
+    private readonly stateSubject;
+    readonly state: Observable<HologyApplicationState>;
+    private readonly shutdownSubject;
+    readonly shutdownStarted: Observable<void>;
+    readonly ready: Promise<void>;
+    private resolveReady;
+    private rejectReady;
+    private transitionTail;
+    private initializationPromise;
+    private transitionIntent;
+    private session?;
+    private shutdownFlag;
+    constructor(config: InitiateApplicationConfig, applicationContainer: ContainerInstance, renderingHost: RenderingHost, defaultGameClass?: GameClass<TGame>);
+    /** The current compatibility presentation view owned by the rendering host. */
+    get renderingView(): RenderingView;
+    get currentState(): HologyApplicationState;
+    private initialize;
+    loadGame(config: LoadGameConfig): Promise<GameSession<TGame>>;
+    loadGame<TLoadedGame>(gameClass: GameClass<TLoadedGame>, config: LoadGameConfig): Promise<GameSession<TLoadedGame>>;
+    unloadGame(): Promise<void>;
+    /** Replace the scene while retaining the current World, game instance, view, and runtime actors. */
+    transitionScene(request: SceneTransitionRequest | SceneRef | string): Promise<GameSession<TGame>>;
+    shutdown(): Promise<void>;
+    getWorld(): World | undefined;
+    getGameInstance(): TGame | undefined;
+    getApplicationService<T>(service: ServiceIdentifier<T>): T;
+    getSessionService<T>(service: ServiceIdentifier<T>): T | undefined;
+    getService<T>(service: ServiceIdentifier<T>): T;
+    /** Registers an application-lifetime WebGPU pass on the native-resolution presentation target after upscaling. */
+    registerRenderStage(callback: (context: ApplicationRenderStageContext) => void): () => void;
+    private registerApplicationServices;
+    private performLoad;
+    private createSession;
+    private performSceneTransition;
+    private copyApplicationServices;
+    private disposeSession;
+    private enqueue;
+    private checkIntent;
+    private assertRunning;
+    private loading;
+    private setState;
+    private getOptionalApplicationService;
+}
+/** Deprecated compatibility façade returned by initiateGame(). */
+export declare class HologyRuntime<TGame = unknown> {
+    readonly application: HologyApplicationRuntime<TGame>;
+    readonly ready: Promise<boolean>;
+    readonly shutdownStarted: Observable<void>;
+    constructor(application: HologyApplicationRuntime<TGame>, initialLoad: Promise<GameSession<TGame>>);
+    get status(): HologyRuntimeStatus;
+    get gameInstance(): TGame;
+    get isShutdown(): boolean;
+    getWorld(): World;
+    getService<T>(service: ServiceIdentifier<T>): T;
+    shutdown(): Promise<void>;
+}
 export declare const enum HologyRuntimeStatus {
     INITIATING = 0,
     RUNNING = 5,
     STOPPED = 10
 }
-export declare class HologyRuntime<T_Game = unknown> {
-    private containerInstance;
-    status: HologyRuntimeStatus;
-    gameInstance?: T_Game;
-    isShutdown: boolean;
-    shutdownStarted: Observable<void>;
-    private _resolver;
-    /**
-     * A promise that you can await on to delay some logic until the runtime has finished loading
-     */
-    readonly ready: Promise<boolean>;
-    constructor(containerInstance: ContainerInstance);
-    getWorld(): World;
-    getService<T>(serviceType: Constructable<T>): T;
-    /**
-     * Stops rendering and all game activity on this client.
-     */
-    shutdown(): void;
-}
 export {};
 //# sourceMappingURL=initiate.d.ts.map

package/dist/gameplay/initiate.js

@@ -1,4 +1,4 @@
-import e from"typedi";import{loadScene as t}from"../scene/bootstrap.js";import{ActorFactory as n}from"./actors/factory.js";import{World as s}from"./services/world.js";import{SceneMaterializer as o}from"../scene/materializer.js";import{ViewController as i}from"./services/render.js";import{RenderingView as r}from"../rendering.js";import{PhysicsSystem as a}from"./services/physics/physics-system.js";import{MeshComponent as c}from"./actors/builtin/components/mesh-component.js";import{builtInComponents as d}from"./actors/builtin/components/index.js";import{activeContainerInstance as l}from"./actors/internal/container-map.js";import{InputService as m}from"./input/index.js";import{RuntimeAssetsService as p}from"../scene/runtime-asset-service.js";import{AssetResourceLoader as u}from"../scene/asset-resource-loader.js";import{AssetLoader as g}from"./services/asset-loader.js";import{polyfillClient as h}from"./polyfill.js";import{Subject as f}from"rxjs";import{PointerEvents as w}from"./services/pointer-events.js";import{RuntimeBundledBackendService as b}from"../scene/runtime-bundled-backend-service.js";import{Scene as v}from"three";import{ShaderProvider as y}from"./services/shader-provider.js";import{SceneDataService as S}from"../scene/scene-data-service.js";import{NetMode as j}from"./net/net-session.js";import{AssetsProvider as x}from"../scene/assets-provider.js";import{GpuVfxWorldService as I}from"../effects/vfx/gpu-vfx-world-service.js";export function initiateGame(f,w){if(h(),0!=w.element.childNodes.length)return console.error("Can not initialize the game with a non-empty html element"),null;e.has(i);const P=e.of("default"),D=new HologyRuntime(P),G=new n(P,{inEditor:!1});var k;G.classes=w.actors,e.set(n,G),k=w.element,Object.assign(k.style,{position:"absolute",top:"0",left:"0",width:"100%",height:"100%",overflow:"hidden"});const W=new r(w.element,{backend:w.rendering?.backend??"webgpu",enableXR:!0===w.xr?.enabled,maxPixelRatio:w.rendering?.maxPixelRatio,resolutionScale:w.rendering?.resolutionScale,dynamicResolution:w.rendering?.dynamicResolution,upscaling:w.rendering?.upscaling,webgpuPostProcessing:w.rendering?.webgpuPostProcessing,webgpuDirectionalShadows:w.rendering?.webgpuDirectionalShadows,webgpuVfx:w.rendering?.webgpuVfx??"auto",msaa:w.rendering?.msaa,fpsCap:w.rendering?.fpsCap,depthPrepass:{enabled:!0===w.rendering?.depthPrepass?.enabled},bloom:{enabled:!1!==w?.rendering?.bloom?.enabled},reflection:{enabled:!1!==w?.rendering?.reflection?.enabled},occlusionCulling:{enabled:!1!==w?.rendering?.occlusionCulling?.enabled},shadows:{enabled:w.rendering?.shadows?.enabled??!0,autoUpdate:w.rendering?.shadows?.autoUpdate??!0,cascadeUpdateIntervals:[22,40,60,120]}});e.set(r,W);const F=new i(W);e.set(i,F);const H=new b(w.runtimeDataUrl),R=new p(H),z=new u;z.setDataDir(w.dataDir),z.setDirectFileLoading(!0===w.directAssetFileLoading),"webgpu"===W.requestedBackend?z.initKtx2ForWebGpu():z.initKtx2(W.renderer);const A=Object.entries(w.shaders).map(([e,t])=>({name:e,type:t})),E=Object.entries(w.actors).map(([e,t])=>({name:e,type:t})),C={...d,...w.components??{}},U=Object.entries(C).map(([e,t])=>({name:e,type:t})),q=new y(A);e.set(y,q);const O=new g(z,R,A);e.set(x,R),e.set(u,z),e.set(g,O);const B=new v,L=new o(B,new S,R,z,W,A,E,G,U);L.inEditor=!1,L.netMode=w.multi?.session?.mode??j.none,e.set(o,L);const M=e.get(s);return e.set(s,M),M.materializer=L,(async()=>{const n=e.get(a);if(console.info("[Hology] Initializing physics."),await n.start(),console.info("[Hology] Physics initialized."),D.isShutdown)return;if(console.info("[Hology] Loading runtime data."),await H.preloadData(),console.info("[Hology] Runtime data loaded."),D.isShutdown)return;if(M.scene=B,null!=w.multi?.session){const{NetService:e}=await import("./net/service/net-service.js"),t=P.get(e);t.session=w.multi.session,t.start(),D.shutdownStarted.subscribe(()=>t.stop())}const{scene:s,actors:o,materializer:i}=await t(W,w.sceneName,w.dataDir,w.shaders,w.actors,C,G,H,R,z,{detailTier:w.detailTier,nodeMode:w.multi?.session?.mode??j.none});M.scene=s,n.scene=M.scene;for(const e of B.children)M.scene.add(e);if(D.isShutdown)return void W.stop();e.import([c]);for(const e of o)M.addActor(e);n.addFromScene(s),await M.startSceneEventGraphs(i),l.value=P,P.remove(f),P.set({id:f,type:f});const r=P.get(f);if(l.value=null,D.gameInstance=r,r instanceof GameInstance&&await r.onPreload(),D.isShutdown)return void W.stop();if(console.log("Start compile shaders"),console.time("compile shaders"),await W.compileAsync(),console.timeEnd("compile shaders"),"webgpu"===W.activeBackend?console.log("Finished compiling the experimental WebGPU scene."):console.log("Finished compile shaders. Programs: ",W.renderer.info.programs?.length??0),console.log("Start init scene textures"),console.time("init scene textures"),await W.initTexturesAsync(),console.timeEnd("init scene textures"),"webgpu"===W.activeBackend){const e=P.get(I).beginPipelineWarmup();try{W.render(0),await(W.experimentalWebGpuDevice?.queue.onSubmittedWorkDone())}finally{e()}W.render(0),await(W.experimentalWebGpuDevice?.queue.onSubmittedWorkDone()),await new Promise(e=>requestAnimationFrame(()=>e()))}const d=P.get(m);W.loop(e=>{d.update(e)}),D.status=5,D.shutdownStarted.subscribe(()=>{z.disposeAll()}),r instanceof GameInstance&&await r.onStart(),D._resolver(!0)})().catch(e=>{D.status=10,console.error("Failed to initialize Hology runtime.",e),e instanceof Error&&console.error(e.stack)}),D}export class GameInstance{onPreload(){}onStart(){}onShutdown(){}}export function createHologyScene(){}export class HologyRuntime{constructor(e){this.containerInstance=e,this.status=0,this.isShutdown=!1,this.shutdownStarted=new f,this.ready=new Promise(e=>{this._resolver=e})}getWorld(){return this.containerInstance.get(s)}getService(e){return this.containerInstance.get(e)}shutdown(){this.isShutdown=!0;const e=this.shutdownStarted;e.next(),e.complete(),this.gameInstance instanceof GameInstance&&this.gameInstance.onShutdown(),this.containerInstance.get(m).stop();const t=this.containerInstance.get(r);t?.stop();const n=this.getWorld();n.stopSceneEventGraphs();const s=this.containerInstance.get(i);s.setMuted(!0),s.dispose();for(const e of[...n.actors])n.removeActor(e);this.containerInstance.get(a).stop(),this.containerInstance.get(o).dispose();const c=this.containerInstance.get(x);c instanceof p&&c.dispose(),this.containerInstance.get(w).stop(),this.containerInstance.reset(),this.shutdownStarted.complete()}}/*
+import e from"typedi";import{BehaviorSubject as t,Subject as i}from"rxjs";import{loadScene as n}from"../scene/bootstrap.js";import{ActorFactory as s}from"./actors/factory.js";import{SceneMaterializer as o}from"../scene/materializer.js";import{SceneDataService as r}from"../scene/scene-data-service.js";import{World as a}from"./services/world.js";import{ViewController as c}from"./services/render.js";import{RenderingView as p,GraphicsRuntime as h}from"../rendering.js";import{PhysicsSystem as l}from"./services/physics/physics-system.js";import{MeshComponent as d}from"./actors/builtin/components/mesh-component.js";import{builtInComponents as m}from"./actors/builtin/components/index.js";import{InputService as u}from"./input/index.js";import{RuntimeAssetsService as g}from"../scene/runtime-asset-service.js";import{AssetResourceLoader as w}from"../scene/asset-resource-loader.js";import{AssetLoader as f}from"./services/asset-loader.js";import{RuntimeBundledBackendService as y}from"../scene/runtime-bundled-backend-service.js";import{AssetsProvider as S}from"../scene/assets-provider.js";import{ShaderProvider as v}from"./services/shader-provider.js";import{PointerEvents as b}from"./services/pointer-events.js";import{GpuVfxWorldService as I}from"../effects/vfx/gpu-vfx-world-service.js";import{NetMode as j}from"./net/net-session.js";import{polyfillClient as A}from"./polyfill.js";import{withInjectionContext as V}from"./inject.js";import{RenderingHost as N}from"./rendering-host.js";import{SceneTransitionService as R}from"./services/scene-transition.js";import{SceneRef as k}from"../scene/scene-ref.js";let x=0;export function initiateApplication(t,i){const n="function"==typeof t?t:void 0,s=i??t;var o;A(),"element"in s&&null!=s.element&&(o=s.element,Object.assign(o.style,{position:"absolute",top:"0",left:"0",width:"100%",height:"100%",overflow:"hidden"}));const r=s.renderingHost??(null!=s.renderingView?new N(s.renderingView,!1,("renderingViewFactory"in s?s.renderingViewFactory:void 0)??(()=>new p(s.renderingView.container,s.renderingView.options))):function(e,t,i){const n=new h,s=()=>function(e,t,i,n){return new p(e,{graphicsRuntime:n,backend:t?.backend??"webgpu",enableXR:!0===i?.enabled,maxPixelRatio:t?.maxPixelRatio,resolutionScale:t?.resolutionScale,dynamicResolution:t?.dynamicResolution,upscaling:t?.upscaling,webgpuPostProcessing:t?.webgpuPostProcessing,webgpuDirectionalShadows:t?.webgpuDirectionalShadows,webgpuVfx:t?.webgpuVfx??"auto",msaa:t?.msaa,fpsCap:t?.fpsCap,depthPrepass:{enabled:!0===t?.depthPrepass?.enabled},bloom:{enabled:!1!==t?.bloom?.enabled},reflection:{enabled:!1!==t?.reflection?.enabled},occlusionCulling:{enabled:!1!==t?.occlusionCulling?.enabled},shadows:{enabled:t?.shadows?.enabled??!0,autoUpdate:t?.shadows?.autoUpdate??!0,cascadeUpdateIntervals:[22,40,60,120]}})}(e,t,i,n);return new N(s(),!0,s)}(s.element,s.rendering,s.xr)),a=e.of("hology-application-"+ ++x),c=new HologyApplicationRuntime(s,a,r,n??s.defaultGameClass);return c.startInitialization(),c}export function initiateGame(e,t){const{sceneName:i,detailTier:n,multi:s,...o}=t,r=initiateApplication(e,o),a=r.ready.then(()=>r.loadGame({sceneName:i,detailTier:n,multi:s}));return new HologyRuntime(r,a)}export class GameInstance{onPreload(){}onStart(){}onUnload(){return this.onShutdown()}onShutdown(){}}export class HologyApplicationRuntime{constructor(e,n,s,o){this.config=e,this.applicationContainer=n,this.renderingHost=s,this.defaultGameClass=o,this.stateSubject=new t({type:"initializing"}),this.state=this.stateSubject.asObservable(),this.shutdownSubject=new i,this.shutdownStarted=this.shutdownSubject.asObservable(),this.transitionTail=Promise.resolve(),this.initializationPromise=Promise.resolve(),this.transitionIntent=0,this.shutdownFlag=!1,this.ready=new Promise((e,t)=>{this.resolveReady=e,this.rejectReady=t})}get renderingView(){return this.renderingHost.activeView}get currentState(){return this.stateSubject.value}startInitialization(){this.initializationPromise=this.initialize()}async initialize(){try{if(this.registerApplicationServices(),await this.renderingHost.applicationView.compileAsync(),this.shutdownFlag)return void this.rejectReady(z());const e=this.getApplicationService(u);this.renderingHost.start(t=>e.update(t)),this.setState({type:"menu"}),this.resolveReady()}catch(e){this.setState({type:"error",operation:"initialize",error:e}),this.rejectReady(e)}}loadGame(e,t){const i="function"==typeof e?e:this.defaultGameClass,n=t??e;if(null==i)return Promise.reject(new Error("loadGame() requires a game class because no default was configured"));const s=++this.transitionIntent;return this.enqueue(async()=>(await this.ready,this.assertRunning(),this.checkIntent(s),null!=this.session&&await this.disposeSession(this.session,!0),this.checkIntent(s),this.performLoad(i,n,s)))}unloadGame(){const e=++this.transitionIntent;return this.enqueue(async()=>{if(await this.ready,!this.shutdownFlag&&e===this.transitionIntent){try{null!=this.session&&await this.disposeSession(this.session,!0)}catch(t){throw this.shutdownFlag||e!==this.transitionIntent||this.setState({type:"error",operation:"unload",error:t}),t}this.shutdownFlag||e!==this.transitionIntent||this.setState({type:"menu"})}})}transitionScene(e){const t="string"==typeof e?{scene:new k(e,e)}:e instanceof k?{scene:e}:e,i=this.transitionIntent;return this.enqueue(async()=>{await this.ready,this.assertRunning(),this.checkIntent(i);const e=this.session;if(null==e)throw new Error("transitionScene() requires an active game session");try{return await this.performSceneTransition(e,t,i),e}catch(e){throw C(e)||this.shutdownFlag||i!==this.transitionIntent||this.setState({type:"error",operation:"load",error:e}),e}})}async shutdown(){this.shutdownFlag||(this.shutdownFlag=!0,++this.transitionIntent,this.shutdownSubject.next(),this.shutdownSubject.complete(),await this.initializationPromise.catch(()=>{}),await this.transitionTail.catch(()=>{}),null!=this.session&&await this.disposeSession(this.session,!1),this.getApplicationService(u).stop(),this.getOptionalApplicationService(b)?.stop(),this.getApplicationService(w).disposeAll(),this.getApplicationService(g).dispose(),this.getApplicationService(c).dispose(!1),this.renderingHost.shutdown(),e.reset(this.applicationContainer.id),this.setState({type:"stopped"}),this.stateSubject.complete())}getWorld(){return this.session?.world}getGameInstance(){return this.session?.gameInstance}getApplicationService(e){return this.applicationContainer.get(e)}getSessionService(e){return this.session?.container.get(e)}getService(e){return null!=this.session?this.session.container.get(e):this.applicationContainer.get(e)}registerRenderStage(e){return this.renderingHost.registerStage(e)}registerApplicationServices(){const e=new c(this.renderingView);this.applicationContainer.set(p,this.renderingHost.applicationView),this.applicationContainer.set(c,e);const t=new y(this.config.runtimeDataUrl),i=new g(t),n=new w;n.setDataDir(this.config.dataDir),n.setDirectFileLoading(!0===this.config.directAssetFileLoading),"webgpu"===this.renderingHost.applicationView.requestedBackend?n.initKtx2ForWebGpu():n.initKtx2(this.renderingHost.applicationView.renderer);const s=Object.entries(this.config.shaders).map(([e,t])=>({name:e,type:t}));this.applicationContainer.set(y,t),this.applicationContainer.set(S,i),this.applicationContainer.set(g,i),this.applicationContainer.set(w,n),this.applicationContainer.set(f,new f(n,i,s)),this.applicationContainer.set(v,new v(s));const o=V(this.applicationContainer,e=>e.get(u));this.applicationContainer.set(u,o)}async performLoad(t,i,s){const r=this.createSession(i);this.session=r;try{this.loading(i.sceneName,"physics",.08),await r.physics.start(),this.checkIntent(s),this.loading(i.sceneName,"runtime-data",.2),await this.getApplicationService(y).preloadData(),this.checkIntent(s),this.loading(i.sceneName,"scene",.42);const a=await n(r.renderingView,i.sceneName,this.config.dataDir,this.config.shaders,this.config.actors,r.components,r.actorFactory,this.getApplicationService(y),this.getApplicationService(g),this.getApplicationService(w),{detailTier:i.detailTier,nodeMode:i.multi?.session.mode??j.none});if(r.materializer.dispose(),r.materializer=a.materializer,r.sceneRoots=a.sceneRoots,r.container.set(o,a.materializer),r.world.materializer=a.materializer,r.world.scene=a.scene,r.physics.scene=a.scene,this.checkIntent(s),null!=i.multi?.session){const{NetService:e}=await import("./net/service/net-service.js"),t=V(r.container,t=>t.get(e));t.session=i.multi.session,t.start(),r.stopNetwork=()=>t.stop()}e.import([d]);for(const e of a.actors)r.world.addActor(e);if(r.physics.addFromScene(a.scene),await r.world.startSceneEventGraphs(a.materializer),this.checkIntent(s),r.gameInstance=V(r.container,e=>(e.set({id:t,type:t}),e.get(t))),this.loading(i.sceneName,"game-preload",.58),r.gameInstance instanceof GameInstance&&await r.gameInstance.onPreload(),this.checkIntent(s),this.loading(i.sceneName,"shaders",.7),await r.renderingView.compileAsync(),this.checkIntent(s),this.loading(i.sceneName,"textures",.82),await r.renderingView.initTexturesAsync(),this.checkIntent(s),"webgpu"===r.renderingView.activeBackend){this.loading(i.sceneName,"vfx-warmup",.94);const e=r.container.get(I).beginPipelineWarmup();try{const e=performance.now();console.info("[Hology GPU VFX warmup] Rendering loading frame",i.sceneName),r.renderingView.render(0),console.info("[Hology GPU VFX warmup] Render returned; waiting for GPU queue",{sceneName:i.sceneName,renderMs:performance.now()-e}),await(r.renderingView.webGpuDevice?.queue.onSubmittedWorkDone()),console.info("[Hology GPU VFX warmup] GPU queue completed",{sceneName:i.sceneName,totalMs:performance.now()-e})}finally{e()}}return this.checkIntent(s),this.renderingHost.activate(r.renderingView),r.gameInstance instanceof GameInstance&&await r.gameInstance.onStart(),this.checkIntent(s),this.setState({type:"playing",sceneName:i.sceneName}),r}catch(e){throw await this.disposeSession(r,!1),C(e)||this.shutdownFlag||s!==this.transitionIntent||this.setState({type:"error",operation:"load",error:e}),e}}createSession(t){const i=e.of("hology-session-"+ ++x);this.copyApplicationServices(i);const n=this.renderingHost.createView(),h=new c(n);i.set(p,n),i.set(c,h);const d={...m,...this.config.components??{}},u=new s(i,{inEditor:!1});u.classes=this.config.actors,i.set(s,u);const f=new o(n.scene,new r,this.getApplicationService(g),this.getApplicationService(w),n,Object.entries(this.config.shaders).map(([e,t])=>({name:e,type:t})),Object.entries(this.config.actors).map(([e,t])=>({name:e,type:t})),u,Object.entries(d).map(([e,t])=>({name:e,type:t})));f.inEditor=!1,f.netMode=t.multi?.session.mode??j.none,i.set(o,f);const y=V(i,e=>e.get(a));y.scene=n.scene,i.set(a,y);const S=V(i,e=>e.get(l));i.set(l,S);const v=new R;return v.bind(async e=>{await this.transitionScene(e)}),i.set(R,v),{sceneName:t.sceneName,detailTier:t.detailTier,container:i,renderingView:n,viewController:h,actorFactory:u,materializer:f,world:y,physics:S,components:d,sceneTransition:v,sceneRoots:[],netMode:t.multi?.session.mode??j.none}}async performSceneTransition(e,t,i){if(null!=e.stopNetwork)throw new Error("In-session scene transitions are not yet supported for network sessions");const s=t.scene.id.trim();if(0===s.length)throw new Error("A destination scene id is required");const r=e.sceneName;this.setState({type:"unloading",sceneName:r}),e.world.stopSceneEventGraphs();const a=e.world.removeSceneLifetimeActors(e.sceneRoots);for(const t of e.sceneRoots)e.physics.removeRemoved(t),t.removeFromParent();e.sceneRoots=[],e.materializer.dispose(a),this.checkIntent(i),this.loading(s,"scene",.42);const c=await n(e.renderingView,s,this.config.dataDir,this.config.shaders,this.config.actors,e.components,e.actorFactory,this.getApplicationService(y),this.getApplicationService(g),this.getApplicationService(w),{detailTier:e.detailTier,nodeMode:e.netMode});this.checkIntent(i),e.materializer=c.materializer,e.sceneRoots=c.sceneRoots,e.sceneName=s,e.container.set(o,c.materializer),e.world.materializer=c.materializer;for(const t of c.actors)e.world.addActor(t);e.physics.addFromScene(c.scene),await e.world.startSceneEventGraphs(c.materializer),await(t.afterLoad?.(e.world)),this.checkIntent(i),this.loading(s,"shaders",.7),await e.renderingView.compileAsync(),this.checkIntent(i),this.loading(s,"textures",.82),await e.renderingView.initTexturesAsync(),this.checkIntent(i),e.sceneTransition.publish({previousSceneName:r,sceneName:s}),this.setState({type:"playing",sceneName:s})}copyApplicationServices(e){const t=[u,S,g,y,w,f,v];for(const i of t)e.set(i,this.applicationContainer.get(i))}async disposeSession(t,i){if(t.disposed)return;let n;t.disposed=!0,i&&this.setState({type:"unloading",sceneName:t.sceneName});try{t.stopNetwork?.(),t.sceneTransition.dispose(),t.world.stopSceneEventGraphs(),t.gameInstance instanceof GameInstance&&await t.gameInstance.onUnload()}catch(e){n=e}finally{for(const e of[...t.world.actors])t.world.removeActor(e);t.physics.stop(),t.materializer.dispose(),this.renderingHost.activeView===t.renderingView&&this.renderingHost.activate(this.renderingHost.applicationView),t.viewController.dispose(!1),this.renderingHost.releaseView(t.renderingView),e.reset(t.container.id),this.session===t&&(this.session=void 0)}if(null!=n)throw n}enqueue(e){const t=this.transitionTail.then(e,e);return this.transitionTail=t.catch(()=>{}),t}checkIntent(e){if(this.assertRunning(),e!==this.transitionIntent)throw z()}assertRunning(){if(this.shutdownFlag)throw new Error("Hology application has been shut down")}loading(e,t,i){this.setState({type:"loading",sceneName:e,stage:t,progress:i})}setState(e){this.stateSubject.next(e)}getOptionalApplicationService(e){return this.applicationContainer.has(e)?this.applicationContainer.get(e):void 0}}export class HologyRuntime{constructor(e,t){this.application=e,this.ready=t.then(()=>!0),this.shutdownStarted=e.shutdownStarted}get status(){return"playing"===this.application.currentState.type?5:"stopped"===this.application.currentState.type||"error"===this.application.currentState.type?10:0}get gameInstance(){return this.application.getGameInstance()}get isShutdown(){return"stopped"===this.application.currentState.type}getWorld(){return this.application.getWorld()}getService(e){return this.application.getService(e)}shutdown(){return this.application.shutdown()}}function z(){return new DOMException("Superseded by a newer game transition","AbortError")}function C(e){return e instanceof DOMException&&"AbortError"===e.name}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/gameplay/net/browser/index.d.ts

@@ -1,7 +1,7 @@
 import { BehaviorSubject, Subject } from 'rxjs';
 import type { NetReceivedMessage, NetSession } from '../net-session.js';
 import { NetMode } from '../net-session.js';
-import type { NetConnection } from '../net-connection.js';
+import type { NetConnection, NetPlayerInfo } from '../net-connection.js';
 export type BrowserNetSimulationOptions = {
     /**
      * Fixed one-way latency applied to outgoing messages from this session.
@@ -22,6 +22,8 @@ export type BrowserNetSimulationOptions = {
     reliablePacketLoss?: number;
 };
 export type BrowserNetSessionOptions = BrowserNetSimulationOptions & {
+    /** Authenticated identity to expose for this simulated participant. */
+    player?: NetPlayerInfo;
     /**
      * How often this tab refreshes its membership entry. Set to 0 to disable.
      */
@@ -48,6 +50,7 @@ export declare class BrowserNetSession implements NetSession {
      * The network mode from this player's point of view.
      */
     readonly mode: NetMode;
+    readonly localPlayer?: NetPlayerInfo;
     /**
      * Convenience function to check if mode === NetworkRole.client
      */

package/dist/gameplay/net/browser/index.js

@@ -1,4 +1,4 @@
-import{BehaviorSubject as e,Subject as s}from"rxjs";import{NetMode as t}from"../net-session.js";const n=0,i=0,r=0,o=0;export class BrowserNetSession{get isClient(){return this.mode===t.client}get isServer(){return this.mode<t.client}get isDedicatedServer(){return this.mode===t.dedicatedServer}get clients(){return this.isServer?this.currentMembers().filter(e=>e.mode===t.client).map(e=>a(e)):[]}get server(){if(!this.isServer){const e=this.currentMembers().find(e=>e.mode<t.client);if(null!=e)return a(e)}return null}constructor(t,n,i,r={}){this.sessionId=n,this.localId=i,this.playerLeft=new s,this.playerJoined=new s,this.receivedMessageCount=new e(0),this.storageKey=`net_session_${this.sessionId}`,this.channelName=`net_session_${this.sessionId}`,this.connected=!1,this.storage=null,this.channel=null,this.heartbeatTimer=null,this.receivedMessages=[],this.knownMemberIds=new Set,this.pendingDeliveryTimers=new Set,this.reliableQueues=new Map,this.messageSequence=0,this.onStorage=e=>{if(e.key!==this.storageKey)return;const s=this.getLocalStorage();this.setMembers(s?.members??[],!0)},this.onChannelMessage=e=>{const s=e.data;if(function(e){if(null==e||"object"!=typeof e)return!1;const s=e.kind;return"join"===s||"leave"===s||"heartbeat"===s||"members-request"===s||"members"===s||"message"===s}(s)&&s.sessionId===this.sessionId&&s.sourceConnectionId!==this.localId)switch(s.kind){case"join":case"heartbeat":this.mergeMember(s.member,!0);break;case"leave":this.removeMember(s.member.connectionId,!0);break;case"members-request":this.broadcast({kind:"members",sessionId:this.sessionId,sourceConnectionId:this.localId,members:this.currentMembers()});break;case"members":this.setMembers([...this.currentMembers(),...s.members],!0);break;case"message":this.mergeMember(s.fromMember,!0),s.message.toConnectionId===this.localId&&this.enqueueReceivedMessage(s.message)}},this.onBeforeUnload=()=>{this.disconnect()},this.onUnload=()=>{this.disconnect()},this.mode=t,this.id=n,this.simulation=l(r),this.heartbeatIntervalMs=Math.max(0,r.heartbeatIntervalMs??2e3),this.memberTimeoutMs=Math.max(1,r.memberTimeoutMs??1e4),this.maxQueuedMessages=Math.max(1,r.maxQueuedMessages??1e4)}configureNetworkSimulation(e){this.simulation=l({...this.simulation,...e})}reconnect(){this.disconnect(),this.connect()}disconnect(){this.connected&&this.broadcast({kind:"leave",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()}),this.stopHeartbeat(),this.cancelPendingDeliveries(),this.connected&&(window.removeEventListener("storage",this.onStorage),window.removeEventListener("beforeunload",this.onBeforeUnload),window.removeEventListener("unload",this.onUnload),this.channel?.removeEventListener("message",this.onChannelMessage),this.channel?.close(),this.channel=null,this.connected=!1);const e=this.getLocalStorage(),s=(e?.members??this.storage?.members??[]).filter(e=>e.connectionId!==this.localId);this.writeLocalStorage({members:this.activeMembers(s)}),this.storage=null,this.knownMemberIds.clear(),this.receivedMessages=[],this.receivedMessageCount.next(0)}sendMessage(e,s,t){const n=function(e){const s=(e.id,Number(e.id));return Number.isFinite(s)?s:null}(e);if(null==n)return void console.error(`BrowserNetSession can only send to numeric connection ids. Received ${e.id}`);const i={id:this.createMessageId(),fromConnectionId:this.localId,toConnectionId:n,reliable:s,sentAt:Date.now(),buffer:c(t)};this.sendOrSimulateMessage(i,s)}hasMessage(){return this.receivedMessages.length}readMessage(){const e=this.consumeMessage();if(null!=e){const s=this.connectionForMessage(e);return null==s?(console.error(`No connection found with id ${e.fromConnectionId}`),null):{from:s,buffer:e.buffer}}return null}connect(){if(this.connected)return;if("undefined"==typeof BroadcastChannel)throw new Error("BrowserNetSession requires BroadcastChannel support");this.channel=new BroadcastChannel(this.channelName),this.channel.addEventListener("message",this.onChannelMessage),window.addEventListener("storage",this.onStorage),window.addEventListener("beforeunload",this.onBeforeUnload),window.addEventListener("unload",this.onUnload),this.connected=!0;const e=this.getLocalStorage()??{members:[]},s=this.activeMembers([...e.members,this.createLocalMember()]);this.setMembers(s,!1),this.writeLocalStorage({members:s}),this.broadcast({kind:"join",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()}),this.broadcast({kind:"members-request",sessionId:this.sessionId,sourceConnectionId:this.localId}),this.startHeartbeat()}sendOrSimulateMessage(e,s){if(this.shouldDropMessage(s))return;if(s)return void this.enqueueReliableDelivery(e);const t=this.simulatedDelayMs();if(t<=0)return void this.deliverMessage(e);const n=window.setTimeout(()=>{this.pendingDeliveryTimers.delete(n),this.deliverMessage(e)},t);this.pendingDeliveryTimers.add(n)}deliverMessage(e){e.toConnectionId!==this.localId?this.broadcast({kind:"message",sessionId:this.sessionId,sourceConnectionId:this.localId,fromMember:this.createLocalMember(),message:e}):this.enqueueReceivedMessage(e)}enqueueReceivedMessage(e){this.receivedMessages.length>=this.maxQueuedMessages&&this.receivedMessages.shift(),this.receivedMessages.push(e),this.receivedMessageCount.next(this.receivedMessages.length)}consumeMessage(){const e=this.receivedMessages.shift()??null;return this.receivedMessageCount.next(this.receivedMessages.length),e}connectionForMessage(e){const s=this.server;if(s?.id===e.fromConnectionId)return s;const t=this.clients.find(s=>s.id===e.fromConnectionId);if(null!=t)return t;const n=this.currentMembers().find(s=>s.connectionId===e.fromConnectionId);return null!=n?a(n):null}enqueueReliableDelivery(e){const s=this.simulatedDelayMs(),t=this.reliableQueues.get(e.toConnectionId);if((null==t||0===t.messages.length)&&s<=0)return void this.deliverMessage(e);const n=Date.now(),i=t??{messages:[],timer:null},r=i.messages[i.messages.length-1]?.deliveryAt??n,o=Math.max(n+s,r);i.messages.push({message:e,deliveryAt:o}),this.reliableQueues.set(e.toConnectionId,i),this.scheduleReliableDelivery(e.toConnectionId,i)}scheduleReliableDelivery(e,s){if(null!=s.timer||0===s.messages.length)return;const t=Math.max(0,s.messages[0].deliveryAt-Date.now()),n=window.setTimeout(()=>{this.pendingDeliveryTimers.delete(n),s.timer=null,this.flushReliableDelivery(e)},t);s.timer=n,this.pendingDeliveryTimers.add(n)}flushReliableDelivery(e){const s=this.reliableQueues.get(e);if(null==s)return;const t=Date.now();for(;s.messages.length>0&&s.messages[0].deliveryAt<=t+1;)this.deliverMessage(s.messages.shift().message);s.messages.length>0?this.scheduleReliableDelivery(e,s):this.reliableQueues.delete(e)}shouldDropMessage(e){const s=e?this.simulation.reliablePacketLoss:this.simulation.packetLoss;return s>0&&Math.random()<s}simulatedDelayMs(){const e=this.simulation.jitterMs>0?(2*Math.random()-1)*this.simulation.jitterMs:0;return Math.max(0,this.simulation.latencyMs+e)}startHeartbeat(){this.heartbeatIntervalMs<=0||null!=this.heartbeatTimer||(this.heartbeatTimer=window.setInterval(()=>{const e=this.activeMembers([...this.currentMembers(),this.createLocalMember()]);this.setMembers(e,!0),this.writeLocalStorage({members:e}),this.broadcast({kind:"heartbeat",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()})},this.heartbeatIntervalMs))}stopHeartbeat(){null!=this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null)}cancelPendingDeliveries(){this.pendingDeliveryTimers.forEach(e=>clearTimeout(e)),this.pendingDeliveryTimers.clear(),this.reliableQueues.clear()}mergeMember(e,s){this.setMembers([...this.currentMembers(),e],s)}removeMember(e,s){this.setMembers(this.currentMembers().filter(s=>s.connectionId!==e),s)}setMembers(e,s){const t=this.storage?.members??[],n=this.activeMembers(this.connected?[...e,this.createLocalMember()]:e);if(s){const e=new Set(n.map(e=>e.connectionId));n.filter(e=>e.connectionId!==this.localId&&!this.knownMemberIds.has(e.connectionId)).forEach(e=>this.playerJoined.next(a(e))),this.knownMemberIds.forEach(s=>{if(s===this.localId||e.has(s))return;const n=t.find(e=>e.connectionId===s);null!=n&&this.playerLeft.next(a(n))})}this.storage={members:n},this.knownMemberIds.clear(),n.forEach(e=>this.knownMemberIds.add(e.connectionId))}currentMembers(){return this.activeMembers(this.storage?.members??this.getLocalStorage()?.members??[])}activeMembers(e){const s=Date.now();return function(e){const s=new Map;for(const t of e){if(!Number.isFinite(t.connectionId))continue;const e=s.get(t.connectionId);(null==e||(t.lastSeenAt??0)>=(e.lastSeenAt??0))&&s.set(t.connectionId,t)}return[...s.values()].sort((e,s)=>e.connectionId-s.connectionId)}(e).filter(e=>e.connectionId===this.localId||null!=e.lastSeenAt&&s-e.lastSeenAt<=this.memberTimeoutMs)}createLocalMember(){return{connectionId:this.localId,mode:this.mode,player:{id:this.localId.toString()},lastSeenAt:Date.now()}}createMessageId(){const e=window.crypto?.randomUUID;return"function"==typeof e?e.call(window.crypto):`${this.localId}-${Date.now()}-${this.messageSequence++}`}broadcast(e){this.channel?.postMessage(e)}getLocalStorage(){const e=localStorage.getItem(this.storageKey);if(null!=e)try{const s=JSON.parse(e);if(Array.isArray(s?.members))return{members:s.members}}catch(e){console.warn(`Failed to parse browser net session ${this.sessionId}`,e)}return null}writeLocalStorage(e){const s=this.activeMembers(e.members);0!==s.length?localStorage.setItem(this.storageKey,JSON.stringify({members:s})):localStorage.removeItem(this.storageKey)}}function a(e){return{id:e.connectionId,player:e.player}}function c(e){const s=new Uint8Array(e),t=new Uint8Array(s.byteLength);return t.set(s),t.buffer}function l(e){return{latencyMs:Math.max(0,e.latencyMs??n),jitterMs:Math.max(0,e.jitterMs??i),packetLoss:h(e.packetLoss??r),reliablePacketLoss:h(e.reliablePacketLoss??o)}}function h(e){return Math.min(1,Math.max(0,e))}/*
+import{BehaviorSubject as e,Subject as s}from"rxjs";import{NetMode as t}from"../net-session.js";const n=0,i=0,r=0,o=0;export class BrowserNetSession{get isClient(){return this.mode===t.client}get isServer(){return this.mode<t.client}get isDedicatedServer(){return this.mode===t.dedicatedServer}get clients(){return this.isServer?this.currentMembers().filter(e=>e.mode===t.client).map(e=>a(e)):[]}get server(){if(!this.isServer){const e=this.currentMembers().find(e=>e.mode<t.client);if(null!=e)return a(e)}return null}constructor(n,i,r,o={}){this.sessionId=i,this.localId=r,this.playerLeft=new s,this.playerJoined=new s,this.receivedMessageCount=new e(0),this.storageKey=`net_session_${this.sessionId}`,this.channelName=`net_session_${this.sessionId}`,this.connected=!1,this.storage=null,this.channel=null,this.heartbeatTimer=null,this.receivedMessages=[],this.knownMemberIds=new Set,this.pendingDeliveryTimers=new Set,this.reliableQueues=new Map,this.messageSequence=0,this.onStorage=e=>{if(e.key!==this.storageKey)return;const s=this.getLocalStorage();this.setMembers(s?.members??[],!0)},this.onChannelMessage=e=>{const s=e.data;if(function(e){if(null==e||"object"!=typeof e)return!1;const s=e.kind;return"join"===s||"leave"===s||"heartbeat"===s||"members-request"===s||"members"===s||"message"===s}(s)&&s.sessionId===this.sessionId&&s.sourceConnectionId!==this.localId)switch(s.kind){case"join":case"heartbeat":this.mergeMember(s.member,!0);break;case"leave":this.removeMember(s.member.connectionId,!0);break;case"members-request":this.broadcast({kind:"members",sessionId:this.sessionId,sourceConnectionId:this.localId,members:this.currentMembers()});break;case"members":this.setMembers([...this.currentMembers(),...s.members],!0);break;case"message":this.mergeMember(s.fromMember,!0),s.message.toConnectionId===this.localId&&this.enqueueReceivedMessage(s.message)}},this.onBeforeUnload=()=>{this.disconnect()},this.onUnload=()=>{this.disconnect()},this.mode=n,this.localPlayer=n===t.dedicatedServer?void 0:o.player??{id:r.toString()},this.id=i,this.simulation=l(o),this.heartbeatIntervalMs=Math.max(0,o.heartbeatIntervalMs??2e3),this.memberTimeoutMs=Math.max(1,o.memberTimeoutMs??1e4),this.maxQueuedMessages=Math.max(1,o.maxQueuedMessages??1e4)}configureNetworkSimulation(e){this.simulation=l({...this.simulation,...e})}reconnect(){this.disconnect(),this.connect()}disconnect(){this.connected&&this.broadcast({kind:"leave",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()}),this.stopHeartbeat(),this.cancelPendingDeliveries(),this.connected&&(window.removeEventListener("storage",this.onStorage),window.removeEventListener("beforeunload",this.onBeforeUnload),window.removeEventListener("unload",this.onUnload),this.channel?.removeEventListener("message",this.onChannelMessage),this.channel?.close(),this.channel=null,this.connected=!1);const e=this.getLocalStorage(),s=(e?.members??this.storage?.members??[]).filter(e=>e.connectionId!==this.localId);this.writeLocalStorage({members:this.activeMembers(s)}),this.storage=null,this.knownMemberIds.clear(),this.receivedMessages=[],this.receivedMessageCount.next(0)}sendMessage(e,s,t){const n=function(e){const s=(e.id,Number(e.id));return Number.isFinite(s)?s:null}(e);if(null==n)return void console.error(`BrowserNetSession can only send to numeric connection ids. Received ${e.id}`);const i={id:this.createMessageId(),fromConnectionId:this.localId,toConnectionId:n,reliable:s,sentAt:Date.now(),buffer:c(t)};this.sendOrSimulateMessage(i,s)}hasMessage(){return this.receivedMessages.length}readMessage(){const e=this.consumeMessage();if(null!=e){const s=this.connectionForMessage(e);return null==s?(console.error(`No connection found with id ${e.fromConnectionId}`),null):{from:s,buffer:e.buffer}}return null}connect(){if(this.connected)return;if("undefined"==typeof BroadcastChannel)throw new Error("BrowserNetSession requires BroadcastChannel support");this.channel=new BroadcastChannel(this.channelName),this.channel.addEventListener("message",this.onChannelMessage),window.addEventListener("storage",this.onStorage),window.addEventListener("beforeunload",this.onBeforeUnload),window.addEventListener("unload",this.onUnload),this.connected=!0;const e=this.getLocalStorage()??{members:[]},s=this.activeMembers([...e.members,this.createLocalMember()]);this.setMembers(s,!1),this.writeLocalStorage({members:s}),this.broadcast({kind:"join",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()}),this.broadcast({kind:"members-request",sessionId:this.sessionId,sourceConnectionId:this.localId}),this.startHeartbeat()}sendOrSimulateMessage(e,s){if(this.shouldDropMessage(s))return;if(s)return void this.enqueueReliableDelivery(e);const t=this.simulatedDelayMs();if(t<=0)return void this.deliverMessage(e);const n=window.setTimeout(()=>{this.pendingDeliveryTimers.delete(n),this.deliverMessage(e)},t);this.pendingDeliveryTimers.add(n)}deliverMessage(e){e.toConnectionId!==this.localId?this.broadcast({kind:"message",sessionId:this.sessionId,sourceConnectionId:this.localId,fromMember:this.createLocalMember(),message:e}):this.enqueueReceivedMessage(e)}enqueueReceivedMessage(e){this.receivedMessages.length>=this.maxQueuedMessages&&this.receivedMessages.shift(),this.receivedMessages.push(e),this.receivedMessageCount.next(this.receivedMessages.length)}consumeMessage(){const e=this.receivedMessages.shift()??null;return this.receivedMessageCount.next(this.receivedMessages.length),e}connectionForMessage(e){const s=this.server;if(s?.id===e.fromConnectionId)return s;const t=this.clients.find(s=>s.id===e.fromConnectionId);if(null!=t)return t;const n=this.currentMembers().find(s=>s.connectionId===e.fromConnectionId);return null!=n?a(n):null}enqueueReliableDelivery(e){const s=this.simulatedDelayMs(),t=this.reliableQueues.get(e.toConnectionId);if((null==t||0===t.messages.length)&&s<=0)return void this.deliverMessage(e);const n=Date.now(),i=t??{messages:[],timer:null},r=i.messages[i.messages.length-1]?.deliveryAt??n,o=Math.max(n+s,r);i.messages.push({message:e,deliveryAt:o}),this.reliableQueues.set(e.toConnectionId,i),this.scheduleReliableDelivery(e.toConnectionId,i)}scheduleReliableDelivery(e,s){if(null!=s.timer||0===s.messages.length)return;const t=Math.max(0,s.messages[0].deliveryAt-Date.now()),n=window.setTimeout(()=>{this.pendingDeliveryTimers.delete(n),s.timer=null,this.flushReliableDelivery(e)},t);s.timer=n,this.pendingDeliveryTimers.add(n)}flushReliableDelivery(e){const s=this.reliableQueues.get(e);if(null==s)return;const t=Date.now();for(;s.messages.length>0&&s.messages[0].deliveryAt<=t+1;)this.deliverMessage(s.messages.shift().message);s.messages.length>0?this.scheduleReliableDelivery(e,s):this.reliableQueues.delete(e)}shouldDropMessage(e){const s=e?this.simulation.reliablePacketLoss:this.simulation.packetLoss;return s>0&&Math.random()<s}simulatedDelayMs(){const e=this.simulation.jitterMs>0?(2*Math.random()-1)*this.simulation.jitterMs:0;return Math.max(0,this.simulation.latencyMs+e)}startHeartbeat(){this.heartbeatIntervalMs<=0||null!=this.heartbeatTimer||(this.heartbeatTimer=window.setInterval(()=>{const e=this.activeMembers([...this.currentMembers(),this.createLocalMember()]);this.setMembers(e,!0),this.writeLocalStorage({members:e}),this.broadcast({kind:"heartbeat",sessionId:this.sessionId,sourceConnectionId:this.localId,member:this.createLocalMember()})},this.heartbeatIntervalMs))}stopHeartbeat(){null!=this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null)}cancelPendingDeliveries(){this.pendingDeliveryTimers.forEach(e=>clearTimeout(e)),this.pendingDeliveryTimers.clear(),this.reliableQueues.clear()}mergeMember(e,s){this.setMembers([...this.currentMembers(),e],s)}removeMember(e,s){this.setMembers(this.currentMembers().filter(s=>s.connectionId!==e),s)}setMembers(e,s){const t=this.storage?.members??[],n=this.activeMembers(this.connected?[...e,this.createLocalMember()]:e);if(s){const e=new Set(n.map(e=>e.connectionId));n.filter(e=>e.connectionId!==this.localId&&!this.knownMemberIds.has(e.connectionId)).forEach(e=>this.playerJoined.next(a(e))),this.knownMemberIds.forEach(s=>{if(s===this.localId||e.has(s))return;const n=t.find(e=>e.connectionId===s);null!=n&&this.playerLeft.next(a(n))})}this.storage={members:n},this.knownMemberIds.clear(),n.forEach(e=>this.knownMemberIds.add(e.connectionId))}currentMembers(){return this.activeMembers(this.storage?.members??this.getLocalStorage()?.members??[])}activeMembers(e){const s=Date.now();return function(e){const s=new Map;for(const t of e){if(!Number.isFinite(t.connectionId))continue;const e=s.get(t.connectionId);(null==e||(t.lastSeenAt??0)>=(e.lastSeenAt??0))&&s.set(t.connectionId,t)}return[...s.values()].sort((e,s)=>e.connectionId-s.connectionId)}(e).filter(e=>e.connectionId===this.localId||null!=e.lastSeenAt&&s-e.lastSeenAt<=this.memberTimeoutMs)}createLocalMember(){return{connectionId:this.localId,mode:this.mode,player:this.localPlayer,lastSeenAt:Date.now()}}createMessageId(){const e=window.crypto?.randomUUID;return"function"==typeof e?e.call(window.crypto):`${this.localId}-${Date.now()}-${this.messageSequence++}`}broadcast(e){this.channel?.postMessage(e)}getLocalStorage(){const e=localStorage.getItem(this.storageKey);if(null!=e)try{const s=JSON.parse(e);if(Array.isArray(s?.members))return{members:s.members}}catch(e){console.warn(`Failed to parse browser net session ${this.sessionId}`,e)}return null}writeLocalStorage(e){const s=this.activeMembers(e.members);0!==s.length?localStorage.setItem(this.storageKey,JSON.stringify({members:s})):localStorage.removeItem(this.storageKey)}}function a(e){return{id:e.connectionId,player:e.player}}function c(e){const s=new Uint8Array(e),t=new Uint8Array(s.byteLength);return t.set(s),t.buffer}function l(e){return{latencyMs:Math.max(0,e.latencyMs??n),jitterMs:Math.max(0,e.jitterMs??i),packetLoss:h(e.packetLoss??r),reliablePacketLoss:h(e.reliablePacketLoss??o)}}function h(e){return Math.min(1,Math.max(0,e))}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/gameplay/net/index.d.ts

@@ -4,4 +4,7 @@ export * from './service/net-service.js';
 export * from './service/replication.js';
 export * from './service/net-decorator.js';
 export * from './service/net-actor-role.js';
+export * from './player-session.js';
+export * from './net-connection.js';
+export * from './net-session.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/gameplay/net/index.js

@@ -1,4 +1,4 @@
-export*from"./service/rpc-decorator.js";export*from"./service/rpc.js";export*from"./service/net-service.js";export*from"./service/replication.js";export*from"./service/net-decorator.js";export*from"./service/net-actor-role.js";/*
+export*from"./service/rpc-decorator.js";export*from"./service/rpc.js";export*from"./service/net-service.js";export*from"./service/replication.js";export*from"./service/net-decorator.js";export*from"./service/net-actor-role.js";export*from"./player-session.js";export*from"./net-connection.js";export*from"./net-session.js";/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/gameplay/net/net-connection.d.ts

@@ -21,5 +21,9 @@ export interface NetPlayerInfo {
      * the player ID.
      */
     readonly id: string;
+    /** Optional authenticated display name. Gameplay may mirror this into PlayerState. */
+    readonly displayName?: string;
 }
+/** Canonical player identity used by ownership, travel, and reconnection. */
+export type NetPlayerId = NetPlayerInfo['id'];
 //# sourceMappingURL=net-connection.d.ts.map

package/dist/gameplay/net/net-session.d.ts

@@ -1,5 +1,6 @@
 import type { Observable } from "rxjs";
 import type { NetConnection } from "./net-connection.js";
+import type { NetPlayerInfo } from './net-connection.js';
 export declare enum NetMode {
     /**
      * Game is played locally so it has authority but no other clients are connected.
@@ -31,6 +32,8 @@ export interface NetSession {
      * The network mode from this player's point of view.
      */
     readonly mode: NetMode;
+    /** Authenticated local player. Undefined for a dedicated server. */
+    readonly localPlayer?: NetPlayerInfo;
     /**
      * The server holds connections to all other clients.
      */

package/dist/gameplay/net/player-session.d.ts

@@ -0,0 +1,39 @@
+import { type Observable } from 'rxjs';
+import type { BasePlayerController, BasePlayerState } from '../actors/controller/actor-controller.js';
+import type { NetConnection, NetPlayerId, NetPlayerInfo } from './net-connection.js';
+import { type NetSession } from './net-session.js';
+export type PlayerSessionStatus = 'joining' | 'active' | 'travelling' | 'disconnected';
+/** Mutable engine record associated with one stable authenticated player. */
+export interface PlayerSession {
+    readonly info: NetPlayerInfo;
+    connection?: NetConnection;
+    controller?: BasePlayerController;
+    playerState?: BasePlayerState;
+    /**
+     * Zero-based slot for a player controlled on this machine, such as a
+     * split-screen player. Undefined for remote players and dedicated servers.
+     */
+    localPlayerIndex?: number;
+    status: PlayerSessionStatus;
+}
+/** Tracks stable players separately from replaceable transport connections. */
+export declare class NetPlayerRegistry {
+    private readonly sessions;
+    private readonly joinedSubject;
+    private readonly leftSubject;
+    private subscriptions;
+    readonly playerJoined$: Observable<PlayerSession>;
+    readonly playerLeft$: Observable<PlayerSession>;
+    get values(): readonly PlayerSession[];
+    get(playerId: NetPlayerId): PlayerSession | undefined;
+    start(session: NetSession): void;
+    attachController(playerId: NetPlayerId, controller: BasePlayerController): void;
+    attachPlayerState(playerId: NetPlayerId, playerState: BasePlayerState): void;
+    setStatus(playerId: NetPlayerId, status: PlayerSessionStatus): void;
+    stop(clear?: boolean): void;
+    private addConnection;
+    private upsert;
+    private removeConnection;
+    private require;
+}
+//# sourceMappingURL=player-session.d.ts.map

package/dist/gameplay/net/player-session.js

@@ -0,0 +1,4 @@
+import{Subject as t}from"rxjs";import{NetMode as e}from"./net-session.js";export class NetPlayerRegistry{constructor(){this.sessions=new Map,this.joinedSubject=new t,this.leftSubject=new t,this.subscriptions=[],this.playerJoined$=this.joinedSubject.asObservable(),this.playerLeft$=this.leftSubject.asObservable()}get values(){return[...this.sessions.values()]}get(t){return this.sessions.get(t)}start(t){if(this.stop(!1),null!=t.localPlayer&&this.upsert(t.localPlayer,void 0,0),t.mode<e.client){for(const e of t.clients)this.addConnection(e);this.subscriptions.push(t.playerJoined.subscribe(t=>this.addConnection(t)),t.playerLeft.subscribe(t=>this.removeConnection(t)))}}attachController(t,e){const s=this.require(t);s.controller=e,e.playerId=t,null!=s.playerState?e.playerState=s.playerState:null!=e.playerState&&(s.playerState=e.playerState),s.status="active"}attachPlayerState(t,e){const s=this.require(t);s.playerState=e,e.playerId=t,null!=s.info.displayName&&(e.displayName=s.info.displayName),null!=s.controller&&(s.controller.playerState=e)}setStatus(t,e){this.require(t).status=e}stop(t=!0){for(const t of this.subscriptions)t.unsubscribe();this.subscriptions=[],t&&this.sessions.clear()}addConnection(t){null!=t.player&&this.upsert(t.player,t)}upsert(t,e,s){const n=this.sessions.get(t.id);if(null!=n){const t="disconnected"===n.status;return n.connection=e,n.status="active",null!=s&&(n.localPlayerIndex=s),t&&this.joinedSubject.next(n),n}const i={info:t,connection:e,localPlayerIndex:s,status:"joining"};return this.sessions.set(t.id,i),this.joinedSubject.next(i),i}removeConnection(t){const e=t.player?.id;if(null==e)return;const s=this.sessions.get(e);null!=s&&s.connection?.id===t.id&&(s.connection=void 0,s.status="disconnected",this.leftSubject.next(s))}require(t){const e=this.sessions.get(t);if(null==e)throw new Error(`Unknown network player ${JSON.stringify(t)}`);return e}}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/gameplay/net/service/net-decorator.js

@@ -1,4 +1,4 @@
-import{BaseActor as t}from"../../actors/actor.js";import{NetService as e}from"./net-service.js";import{inject as n}from"../../inject.js";import{ReplOn as r}from"./replication.js";import{isSignalLike as i}from"./net-utils.js";import{ActorComponent as o}from"../../actors/component.js";export function RunIfServer(){return function(r,i){let o;return i.addInitializer(function(){this instanceof t?o=n(e):console.warn("RunIfServer should not be defined on a non actor")}),function(...t){if(o.isServer)return r.apply(this,t)}}}export function RunIfClient(){return function(r,i){let o;return i.addInitializer(function(){this instanceof t?o=n(e):console.warn("RunIfClient should not be defined on a non actor")}),function(...t){if(!o.isServer)return r.apply(this,t)}}}export function RunIfNotDedicatedServer(){return function(r,i){let o;return i.addInitializer(function(){this instanceof t?o=n(e):console.warn("RunIfClient should not be defined on a non actor")}),function(...t){if(!o.isDedicatedServer)return r.apply(this,t)}}}export function Replicated(s=r.all,c=!0){return function(r,a){let f;a.addInitializer(function(){if(!(this instanceof t||this instanceof o))return void console.warn("RunIfClient should not only be used on actors and actor components");let r,u;if(this instanceof t)r=this;else if(this instanceof o&&(r=this.actor,u=this,null==r))return;f=n(e),f.registerReplicatedProperty(s,c,r,a.name.toString(),this,u);const l=this[a.name];if(i(l)){const t=l.subscribe(t=>{if(f.isServer){if(null==r.__netid)return;f.handlePropertySet(s,c,r,a.name.toString(),t,u)}});return void r.disposed.subscribe(()=>{t()})}let d=l;Object.defineProperty(this,a.name,{set:t=>{f.isServer&&f.handlePropertySet(s,c,r,a.name.toString(),t,u),d=t},get:()=>d})})}}export function makePropertyReplicated(t,e,n,r,i){n.registerReplicatedProperty(i,r,t,e,this,null);let o=t[e];Object.defineProperty(t,e,{set:s=>{n.isServer&&n.handlePropertySet(i,r,t,e,s,null),o=s},get:()=>o})}/*
+import{BaseActor as e}from"../../actors/actor.js";import{NetService as t}from"./net-service.js";import{inject as n}from"../../inject.js";import{ReplOn as r}from"./replication.js";import{isSignalLike as i}from"./net-utils.js";import{ActorComponent as o}from"../../actors/component.js";export function RunIfServer(){return function(r,i){let o;return i.addInitializer(function(){this instanceof e?o=n(t):console.warn("RunIfServer should not be defined on a non actor")}),function(...e){if(o.isServer)return r.apply(this,e)}}}export function RunIfClient(){return function(r,i){let o;return i.addInitializer(function(){this instanceof e?o=n(t):console.warn("RunIfClient should not be defined on a non actor")}),function(...e){if(!o.isServer)return r.apply(this,e)}}}export function RunIfNotDedicatedServer(){return function(r,i){let o;return i.addInitializer(function(){this instanceof e?o=n(t):console.warn("RunIfClient should not be defined on a non actor")}),function(...e){if(!o.isDedicatedServer)return r.apply(this,e)}}}export function Replicated(s=r.all,c=!0){return function(r,a){let f;a.addInitializer(function(){if(!(this instanceof e||this instanceof o))return void console.warn("RunIfClient should not only be used on actors and actor components");let r,u;if(this instanceof e)r=this;else if(this instanceof o&&(r=this.actor,u=this,null==r))return;f=n(t),f.registerReplicatedProperty(s,c,r,a.name.toString(),this,u);const l=this[a.name];if(i(l)){const e=l.subscribe(e=>{if(f.isServer){if(null==r.__netid)return;f.handlePropertySet(s,c,r,a.name.toString(),e,u)}});return void r.disposed.subscribe(()=>{e()})}let d=l;Object.defineProperty(this,a.name,{set:e=>{f.isServer&&f.handlePropertySet(s,c,r,a.name.toString(),e,u),d=e},get:()=>d})})}}export function makePropertyReplicated(e,t,n,r,i){n.registerReplicatedProperty(i,r,e,t,e);let o=e[t];Object.defineProperty(e,t,{set:s=>{n.isServer&&n.handlePropertySet(i,r,e,t,s,null),o=s},get:()=>o})}/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/gameplay/net/service/net-serializer.js

@@ -1,4 +1,4 @@
-import{__decorate as r}from"tslib";import{World as t}from"../../services/world.js";import{inject as e}from"../../inject.js";import{Service as s}from"typedi";import{BaseActor as n}from"../../actors/actor.js";import{Euler as o,Quaternion as i,Vector2 as a,Vector3 as c,Vector4 as f}from"three";import{DataAssetRef as u}from"../../../scene/objects/data-asset.js";import{AssetLoader as l}from"../../services/asset-loader.js";const p="-a",m="-v2",d="-v3",w="-v4",y="-e",A="-q",h="-s",j="-m",b="-dar";export class DecodeResult{constructor(){this.error=!1,this.requiresAssetLookups=!1}reset(){this.error=!1,this.missingActorId=void 0,this.requiresAssetLookups=!1}}let O=class{constructor(){this.world=e(t),this.assetLoader=e(l)}encode(r){return JSON.stringify(this.wrapObject(r))}decode(r,t){t.reset();const e=JSON.parse(r);return this.unwrapObject(e,t)}wrapObject(r){if(null!=r&&"object"==typeof r){if(Array.isArray(r))return r.map(r=>this.wrapObject(r));if(r instanceof n){if(null!=r.__netid)return{[p]:r.__netid};console.warn("Missing netid on actor",r)}else{if(r instanceof a)return{[m]:r.toArray([])};if(r instanceof c)return{[d]:r.toArray([])};if(r instanceof f)return{[w]:r.toArray([])};if(r instanceof o)return{[y]:r.toArray([])};if(r instanceof i)return{[A]:r.toArray([])};if(r instanceof Map)return{[j]:Array.from(r.entries()).map(([r,t])=>[r,this.wrapObject(t)])};if(r instanceof Set)return{[h]:Array.from(r.values()).map(r=>this.wrapObject(r))};if(r instanceof u)return{[b]:r.id}}const t={};for(const e of Object.keys(r))t[e]=this.wrapObject(r[e]);return t}return r}unwrapObject(r,t){if(null!=r&&"object"==typeof r){if(Array.isArray(r))return r.map(r=>this.unwrapObject(r,t));{if(null!=r[p]){const e=r[p],s=this.world.actors.find(r=>r.__netid===e);return null==s&&(t.error=!0,t.missingActorId=e,console.warn(`Failed to find replicated actor with netid "${e}"`)),s}if(null!=r[m]){const t=r[m];return(new a).fromArray(t)}if(null!=r[d]){const t=r[d];return(new c).fromArray(t)}if(null!=r[w]){const t=r[w];return(new f).fromArray(t)}if(null!=r[y]){const t=r[y];return(new o).fromArray(t)}if(null!=r[A]){const t=r[A];return(new i).fromArray(t)}if(null!=r[j]){const e=r[j];return new Map(e.map(([r,e])=>[r,this.unwrapObject(e,t)]))}if(null!=r[h]){const e=r[h];return new Set(e.map(r=>this.unwrapObject(r,t)))}if(null!=r[b])return t.requiresAssetLookups=!0,r;const e={};for(const s of Object.keys(r))e[s]=this.unwrapObject(r[s],t);return e}}return r}async decodeAssets(r){if(null!=r&&"object"==typeof r){if(Array.isArray(r))return await Promise.all(r.map(r=>this.decodeAssets(r)));if(r instanceof Map){const t=await Promise.all(Array.from(r.entries()).map(async([r,t])=>[r,await this.decodeAssets(t)]));r.clear();for(const[e,s]of t)r.set(e,s);return r}if(r instanceof Set){const t=await Promise.all(Array.from(r.values()).map(r=>this.decodeAssets(r)));r.clear();for(const e of t)r.add(e);return r}{const t=r;if(null!=t[b])return await this.assetLoader.getDataAssetById(t[b]);for(const r of Object.keys(t))t[r]=await this.decodeAssets(t[r]);return t}}return r}};O=r([s()],O);export{O as NetSerializer};new a,new c,new f,new o,new i;/*
+import{__decorate as r}from"tslib";import{World as t}from"../../services/world.js";import{inject as e}from"../../inject.js";import{Service as s}from"typedi";import{BaseActor as n}from"../../actors/actor.js";import{Euler as o,Quaternion as i,Vector2 as a,Vector3 as c,Vector4 as f}from"three";import{DataAssetRef as u}from"../../../scene/objects/data-asset.js";import{AssetLoader as l}from"../../services/asset-loader.js";const p="-a",d="-v2",m="-v3",w="-v4",y="-e",A="-q",h="-s",j="-m",b="-dar",O="-u";export class DecodeResult{constructor(){this.error=!1,this.requiresAssetLookups=!1}reset(){this.error=!1,this.missingActorId=void 0,this.requiresAssetLookups=!1}}let v=class{constructor(){this.world=e(t),this.assetLoader=e(l)}encode(r){return JSON.stringify(this.wrapObject(r))}decode(r,t){t.reset();const e=JSON.parse(r);return this.unwrapObject(e,t)}wrapObject(r){if(void 0===r)return{[O]:!0};if(null!=r&&"object"==typeof r){if(Array.isArray(r))return r.map(r=>this.wrapObject(r));if(r instanceof n){if(null!=r.__netid)return{[p]:r.__netid};console.warn("Missing netid on actor",r)}else{if(r instanceof a)return{[d]:r.toArray([])};if(r instanceof c)return{[m]:r.toArray([])};if(r instanceof f)return{[w]:r.toArray([])};if(r instanceof o)return{[y]:r.toArray([])};if(r instanceof i)return{[A]:r.toArray([])};if(r instanceof Map)return{[j]:Array.from(r.entries()).map(([r,t])=>[r,this.wrapObject(t)])};if(r instanceof Set)return{[h]:Array.from(r.values()).map(r=>this.wrapObject(r))};if(r instanceof u)return{[b]:r.id}}const t={};for(const e of Object.keys(r))t[e]=this.wrapObject(r[e]);return t}return r}unwrapObject(r,t){if(null!=r&&"object"==typeof r){if(Array.isArray(r))return r.map(r=>this.unwrapObject(r,t));{if(!0===r["-u"])return;if(null!=r[p]){const e=r[p],s=this.world.actors.find(r=>r.__netid===e);return null==s&&(t.error=!0,t.missingActorId=e,console.warn(`Failed to find replicated actor with netid "${e}"`)),s}if(null!=r[d]){const t=r[d];return(new a).fromArray(t)}if(null!=r[m]){const t=r[m];return(new c).fromArray(t)}if(null!=r[w]){const t=r[w];return(new f).fromArray(t)}if(null!=r[y]){const t=r[y];return(new o).fromArray(t)}if(null!=r[A]){const t=r[A];return(new i).fromArray(t)}if(null!=r[j]){const e=r[j];return new Map(e.map(([r,e])=>[r,this.unwrapObject(e,t)]))}if(null!=r[h]){const e=r[h];return new Set(e.map(r=>this.unwrapObject(r,t)))}if(null!=r[b])return t.requiresAssetLookups=!0,r;const e={};for(const s of Object.keys(r))e[s]=this.unwrapObject(r[s],t);return e}}return r}async decodeAssets(r){if(null!=r&&"object"==typeof r){if(Array.isArray(r))return await Promise.all(r.map(r=>this.decodeAssets(r)));if(r instanceof Map){const t=await Promise.all(Array.from(r.entries()).map(async([r,t])=>[r,await this.decodeAssets(t)]));r.clear();for(const[e,s]of t)r.set(e,s);return r}if(r instanceof Set){const t=await Promise.all(Array.from(r.values()).map(r=>this.decodeAssets(r)));r.clear();for(const e of t)r.add(e);return r}{const t=r;if(null!=t[b])return await this.assetLoader.getDataAssetById(t[b]);for(const r of Object.keys(t))t[r]=await this.decodeAssets(t[r]);return t}}return r}};v=r([s()],v);export{v as NetSerializer};new a,new c,new f,new o,new i;/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */

package/dist/gameplay/net/service/net-service.d.ts

@@ -2,10 +2,34 @@ import { ActorOptions, BaseActor } from '../../actors/actor.js';
 import { ActorComponent } from '../../actors/component.js';
 import { NetConnection } from '../net-connection.js';
 import { NetMode, NetSession } from '../net-session.js';
+import { NetPlayerRegistry } from '../player-session.js';
 import { ReplOn } from "./replication.js";
 import { RunsOn } from './rpc.js';
+import { BaseGameState } from "../../actors/controller/game-state.js";
+export type SceneTravelMessage = {
+    travelId: string;
+    sceneName: string;
+};
+export type SceneTravelReadyMessage = {
+    travelId: string;
+    connection: NetConnection;
+};
 export declare class NetService {
     session?: NetSession;
+    readonly players: NetPlayerRegistry;
+    private registeredGameState?;
+    private readonly suspendedReplicationConnections;
+    private readonly sceneTravelBeginSubject;
+    private readonly sceneTravelReadySubject;
+    private readonly sceneTravelCompleteSubject;
+    private activeSceneTravel?;
+    readonly sceneTravelBegin$: import("rxjs").Observable<SceneTravelMessage>;
+    readonly sceneTravelReady$: import("rxjs").Observable<SceneTravelReadyMessage>;
+    readonly sceneTravelComplete$: import("rxjs").Observable<SceneTravelMessage>;
+    /** Travel command retained until a late-starting client coordinator handles it. */
+    get pendingSceneTravel(): SceneTravelMessage | undefined;
+    /** The single game state after authority creation or replicated client spawn. */
+    get gameState(): BaseGameState | undefined;
     /**
      * For connection ownership to be determined, actors have
      * to be registerd with their owning connection.
@@ -136,6 +160,7 @@ export declare class NetService {
      */
     private processRemoveActor;
     setOwningConnection(actor: BaseActor, connection: NetConnection): void;
+    clearOwningConnection(actor: BaseActor): void;
     getOwningConnection(actor: BaseActor): NetConnection;
     getActorsByOwningConnection(connection: NetConnection): BaseActor[];
     private isLocallyControlled;
@@ -144,6 +169,19 @@ export declare class NetService {
      * This relies on role and player controller
      */
     isLocalOwner(actor: BaseActor): boolean;
+    /** Suspends gameplay replication and asks every remote client to load a scene. */
+    beginSceneTravel(travelId: string, sceneName: string): void;
+    /** Notifies authority that this client has finished loading the destination. */
+    sendSceneTravelReady(travelId: string, sceneName: string): void;
+    /** Resynchronizes replicated actors, then tells clients that travel is complete. */
+    completeSceneTravel(travelId: string, sceneName: string): void;
+    private suspendAndSendSceneTravel;
+    private processSceneTravelBegin;
+    private processSceneTravelReady;
+    private processSceneTravelComplete;
+    private createSceneTravelMessage;
+    private parseSceneTravelMessage;
+    private sendMessage;
     /**
      * Sends the current server time (Date.now()) to the specified NetConnection.
      * The time is sent as an 8-byte (BigInt) value.
@@ -155,6 +193,8 @@ export declare class NetService {
      */
     parseServerTime(buffer: ArrayBufferLike): number;
     private getConnectionKey;
+    /** Forgets server-side delivery state after a client has discarded its world. */
+    private resetReplicationState;
     private getPreSpawnMessageQueue;
     private shouldQueueMessageUntilActorReady;
     private isPropertyMessage;
@@ -166,6 +206,8 @@ export declare class NetService {
     private createPropertySnapshotBuffer;
     private decodeReplicatedValue;
     private applyReplicatedProperty;
+    /** Associates replicated player actors with the stable local player record. */
+    private synchronizeReplicatedPlayerActor;
     private callRepNotify;
 }
 //# sourceMappingURL=net-service.d.ts.map