@hology/core 0.0.211 → 0.0.213

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

@@ -0,0 +1,70 @@
+import { Observable } from "rxjs";
+import { NetConnection } from "./net-connection.js";
+export declare enum NetMode {
+    /**
+     * Game is played locally so it has authority but no other clients are connected.
+     * This game be supported by NetSession implmentations that support later connecting
+     * to a game hosting a server.
+     */
+    none = 1,
+    /**
+     * The server runs the game but has no po player
+     */
+    dedicatedServer = 2,
+    /**
+     * One client's game acts as a server and other clients are connected
+     * via P2P.
+     */
+    listenServer = 3,
+    /**
+     * A client is connected to a server and doesn't have authority.
+     * Should be sending inputs to the server to affect important state.
+     */
+    client = 4
+}
+export interface NetSession {
+    /**
+     * A unique ID for this sessions
+     */
+    id: string;
+    /**
+     * The network mode from this player's point of view.
+     */
+    readonly mode: NetMode;
+    /**
+     * The server holds connections to all other clients.
+     */
+    readonly clients: NetConnection[];
+    /**
+     * Clients hold a connection to the server
+     */
+    readonly server: NetConnection;
+    /**
+     * Attempt to reconnect back to a session.
+     */
+    reconnect(): void;
+    /**
+     * Leave the session and disonnect from other clients/server
+     */
+    disconnect(): void;
+    sendMessage(receiver: NetConnection, reliable: boolean, buffer: ArrayBufferLike): void;
+    /**
+     * Use this method to check if there is any messages to read.
+     * Returns the number of messages available.
+     */
+    hasMessage(): number;
+    /**
+     * Consumes a received message and removes it.
+     * Messages should be consumed at an appropriate time rather than randomly whenever received.
+     * For example, avoid using the render loop to read messages as its order is not deterministic.
+     * You may want to process all messages at a single point in time before any other processing.
+     */
+    readMessage(): NetReceivedMessage | null;
+    readonly playerLeft: Observable<NetConnection>;
+    readonly playerJoined: Observable<NetConnection>;
+}
+export type NetReceivedMessage = {
+    from: NetConnection;
+    buffer: ArrayBufferLike;
+};
+//# sourceMappingURL=net-session.d.ts.map

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

@@ -0,0 +1,4 @@
+export var NetMode;!function(e){e[e.none=1]="none",e[e.dedicatedServer=2]="dedicatedServer",e[e.listenServer=3]="listenServer",e[e.client=4]="client"}(NetMode||(NetMode={}));/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,12 @@
+/**
+ * The NetRole is sent by the server and set on actors so that
+ * they can understan what control they have on the actor without
+ * knowing the connection ownership.
+ */
+export declare enum NetRole {
+    authority = 0,// Server's authoritative instance
+    autonomousProxy = 1,// Client-owned instance (owner's client)
+    simulatedProxy = 2,// Non-owner client instance
+    none = 3
+}
+//# sourceMappingURL=net-actor-role.d.ts.map

package/dist/gameplay/net/service/net-actor-role.js

@@ -0,0 +1,4 @@
+export var NetRole;!function(o){o[o.authority=0]="authority",o[o.autonomousProxy=1]="autonomousProxy",o[o.simulatedProxy=2]="simulatedProxy",o[o.none=3]="none"}(NetRole||(NetRole={}));/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,29 @@
+import { ReplOn } from "./replication.js";
+/**
+ * Ensures that this function is only executed if on the server.
+ * This can be used to prevent executing something on the client
+ * in response to some other game play event that requires authority.
+ *
+ * Example:
+ * - An explosion does a random amount of damage to all actors nearby. A function is called
+ *   on the actor to respond to the damage. The explosion also happens
+ *   on clients but we don't know the exact amount of damage to apply because it is random.
+ *   We instead want to let the server handle this and inform clients after.
+ */
+export declare function RunIfServer(): (originalMethod: Function, context: ClassMethodDecoratorContext) => (this: any, ...args: any[]) => any;
+/**
+ * Ensures that this function is only executed if on the client.
+ * Note that this only includes those that are not also servers like standalone and listen servers.
+ */
+export declare function RunIfClient(): (originalMethod: Function, context: ClassMethodDecoratorContext) => (this: any, ...args: any[]) => any;
+/**
+ * Ensures that this function is only executed if on an instance of the game with a player
+ * Useful for logic that should only run on the client, such as UI updates, visual effects, playing sound.
+ */
+export declare function RunIfNotDedicatedServer(): (originalMethod: Function, context: ClassMethodDecoratorContext) => (this: any, ...args: any[]) => any;
+/**
+ * Marks a property to be automatically replicated to clients.
+ * This is a placeholder; actual replication logic would be handled by the networking system.
+ */
+export declare function Replicated(replicatedOn?: ReplOn, reliable?: boolean): (target: undefined, context: ClassMemberDecoratorContext) => void;
+//# sourceMappingURL=net-decorator.d.ts.map

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

@@ -0,0 +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})}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,15 @@
+export declare class NetSerializer {
+    private world;
+    private assetLoader;
+    encode(data: unknown): string;
+    decode(data: string, result: DecodeResult): unknown;
+    private wrapObject;
+    private unwrapObject;
+    /**
+     * Mutates the result from decode to resolve all assets
+     * but leaving already decoded values as they are.
+     * @returns
+     */
+    decodeAssets(obj: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=net-serializer.d.ts.map

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

@@ -0,0 +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;/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,171 @@
+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 { ReplOn } from "./replication.js";
+import { RunsOn } from './rpc.js';
+export declare class NetService {
+    session?: NetSession;
+    /**
+     * For connection ownership to be determined, actors have
+     * to be registerd with their owning connection.
+     * You might just have a single actor per player with a connection.
+     * For many games, most actors are owned by the server. The player might
+     * just have a single playable character as its owned actor.
+     * For example, if the character enters a car, the player should start controlling
+     * that car and the car's ownership should be to the player.
+     * A player controller migth be a good solution for this because
+     * we need to somehow inform the client that it entered the car?
+     * This could be done on the player character as well though and the client
+     * will need to check if the player character is in a car and adjust the input controls
+     * and camera accordingly.
+     *
+     * Spawning controllers from the server might also be a solution.
+     * You can then define inputs on the client when the game starts using the input service.
+     * This might be a nice abstraction but it is not required.
+     *
+     * When the server spawns a player character or controller, it will set the
+     * connection on the NetService.
+     */
+    private readonly actorConnection;
+    private destroyed;
+    get mode(): NetMode;
+    private world;
+    private serializer;
+    private serverTimeOffset;
+    /**
+     * Convenience function to check if mode === NetworkRole.client
+     */
+    get isClient(): boolean;
+    /**
+     * Convenience function to check if you are authoritative
+     */
+    get isServer(): boolean;
+    /**
+     * Convenience function to check if mode === NetworkRole.dedicatedServer
+     */
+    get isDedicatedServer(): boolean;
+    /**
+     * A queue of messages is kept for recently spawned actors so
+     * any RPC or property replication on this actor is not sent
+     * until we got a confirmation on the client that the actor is spawned.
+     *
+     * This is not perfect though.
+     * If a message contains a reference to an actor
+     */
+    private actorPreSpawnMessageBuffer;
+    /**
+     * If we receive a message with a reference to an actor
+     * that currently does not exist, we should queue it.
+     * This can happen if the server sends an RPC or property replication
+     * for an actor that we have not yet finished spawning.
+     * This is only relevant for reliable messages.
+     */
+    private actorRefMissingMessageQueue;
+    private netStartupActorSpawnQueue;
+    private spawningActorNetIds;
+    start(): void;
+    stop(): void;
+    private configureMaterializedActorRole;
+    shouldReplicate(actor: BaseActor): boolean;
+    setReplicate(actor: BaseActor, replicate: any): void;
+    /**
+     * Ensure that we only replicate an actor for spawn, properties and RPC
+     * to connections for which it is relevant. This includes checking
+     * if it is only relevant to owner and possibly other relevancy
+     * logic.
+     * @param actor
+     * @param connection
+     * @returns
+     */
+    isRelevant(actor: BaseActor, connection: NetConnection): boolean;
+    getRelevancyOptions(actor: BaseActor): Partial<ActorOptions['relevancy']> | undefined;
+    /**
+     * Actors are normally sent to clients as soon as they
+     * are spawned on the server. If a client joins after this
+     * has happened, then they have to know which ones to spawn.
+     */
+    private spawnOnLateClient;
+    private processMessages;
+    private processMessage;
+    private processServerTime;
+    private getActorRefMissingMessageQueue;
+    private processRpc;
+    private processProp;
+    private processPropSnapshot;
+    private applyReplicatedProperties;
+    private processSpawn;
+    private readOptionalSceneId;
+    private findMaterializedNetStartupActor;
+    private applySpawnNetInfo;
+    private getNetStartupActorSpawnQueue;
+    private processQueuedNetStartupActorSpawns;
+    private processQueuedActorMessages;
+    sendActorReady(actor: BaseActor): void;
+    /**
+     * Processes an actor ready message from a client.
+     * @param from The connection the message is from.
+     * @param buffer The message buffer.
+     */
+    private processActorReady;
+    sendRpc(runsOn: RunsOn, reliable: boolean, actor: BaseActor, fname: string, args: any[], component?: ActorComponent): void;
+    private sendWithQueue;
+    private findQueuedActorsInData;
+    handlePropertySet(replOn: ReplOn, reliable: boolean, actor: BaseActor, property: string, value: unknown, component?: ActorComponent): void;
+    sendProperty(replOn: ReplOn, reliable: boolean, actor: BaseActor, property: string, propertyBuffer: ArrayBufferLike, component?: ActorComponent): void;
+    private nextNetId;
+    /**
+     * Generate a uniqe id for the network to be used for replication and
+     * to not collide with the existing actor id
+     */
+    private defineNetId;
+    private shouldReplicateMap;
+    private replicatedActors;
+    private replicatedProperties;
+    private replicatedPropertyRegistry;
+    sendActorSpawn(actor: BaseActor, connections?: NetConnection[]): void;
+    /**
+     * Sends a message to remove an actor with the given id to all relevant connections.
+     * @param actor The actor to remove.
+     */
+    sendActorRemove(actor: BaseActor): void;
+    /**
+     * Processes a remove actor message.
+     * @param from The connection the message is from.
+     * @param buffer The message buffer.
+     */
+    private processRemoveActor;
+    setOwningConnection(actor: BaseActor, connection: NetConnection): void;
+    getOwningConnection(actor: BaseActor): NetConnection;
+    getActorsByOwningConnection(connection: NetConnection): BaseActor[];
+    private isLocallyControlled;
+    /**
+     * See if an actor is locally owned.
+     * This relies on role and player controller
+     */
+    isLocalOwner(actor: BaseActor): boolean;
+    /**
+     * Sends the current server time (Date.now()) to the specified NetConnection.
+     * The time is sent as an 8-byte (BigInt) value.
+     */
+    sendServerTime(connection: NetConnection): void;
+    /**
+     * Parses a server time message buffer and returns the timestamp (number).
+     * Expects the buffer to be at least 9 bytes: 1 byte type, 8 bytes timestamp.
+     */
+    parseServerTime(buffer: ArrayBufferLike): number;
+    private getConnectionKey;
+    private getPreSpawnMessageQueue;
+    private shouldQueueMessageUntilActorReady;
+    private isPropertyMessage;
+    private getReplicatedPropertyKey;
+    private sendPropertySnapshot;
+    private buildPropertySnapshotEntries;
+    private shouldReplicatePropertyToConnection;
+    private readReplicatedPropertyValue;
+    private createPropertySnapshotBuffer;
+    private decodeReplicatedValue;
+    private applyReplicatedProperty;
+    private callRepNotify;
+}
+//# sourceMappingURL=net-service.d.ts.map

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

@@ -0,0 +1,4 @@
+import{__decorate as e}from"tslib";import{delay as t,interval as n,Subject as r,takeUntil as s,tap as o}from"rxjs";import{Euler as i,Vector3 as c}from"three";import{Service as a}from"typedi";import{$actorOptions as l,BaseActor as d,getActorClassById as p}from"../../actors/actor.js";import{ActorComponent as u}from"../../actors/component.js";import{$actorComponents as f}from"../../actors/internal/component-init.js";import{inject as h}from"../../inject.js";import{World as g}from"../../services/world.js";import{NetMode as y}from"../net-session.js";import{NetRole as w}from"./net-actor-role.js";import{DecodeResult as m,NetSerializer as v}from"./net-serializer.js";import{isSignalLike as A}from"./net-utils.js";import{ReplOn as b}from"./replication.js";import{getRpcMethodId as R,getRpcMethodName as _,RunsOn as S}from"./rpc.js";import{ActorController as U,BasePlayerController as M}from"../../actors/controller/actor-controller.js";import{makePropertyReplicated as C}from"./net-decorator.js";var P;!function(e){e[e.rpc=1]="rpc",e[e.prop=2]="prop",e[e.spawn=3]="spawn",e[e.removeActor=4]="removeActor",e[e.rpcComponent=5]="rpcComponent",e[e.propComponent=6]="propComponent",e[e.rpcBinary=21]="rpcBinary",e[e.rpcComponentBinary=25]="rpcComponentBinary",e[e.actorReady=7]="actorReady",e[e.propSnapshot=8]="propSnapshot",e[e.serverTime=100]="serverTime"}(P||(P={}));var $;!function(e){e[e.actor=0]="actor",e[e.component=1]="component"}($||($={}));let L=class{constructor(){this.actorConnection=new Map,this.destroyed=new r,this.world=h(g),this.serializer=h(v),this.serverTimeOffset=0,this.actorPreSpawnMessageBuffer=new Map,this.actorRefMissingMessageQueue=new Map,this.netStartupActorSpawnQueue=new Map,this.spawningActorNetIds=new Set,this.nextNetId=1,this.shouldReplicateMap=new Map,this.replicatedActors=new Map,this.replicatedProperties=new Map,this.replicatedPropertyRegistry=new Map}get mode(){return this.session?.mode??y.none}get isClient(){return this.mode===y.client}get isServer(){return this.mode<y.client}get isDedicatedServer(){return this.mode===y.dedicatedServer}start(){if(this.stop(),this.destroyed=new r,this.isServer)for(const e of this.session.clients)this.sendServerTime(e);n(15).pipe(s(this.destroyed)).subscribe(()=>{this.processMessages()}),this.world.actorAdded.pipe(s(this.destroyed),o(e=>{this.configureMaterializedActorRole(e),this.isServer?this.defineNetId(e):this.processQueuedNetStartupActorSpawns(e)}),t(8)).subscribe(e=>{this.shouldReplicate(e)&&(C(e,"owner",this,!0,b.all),this.sendActorSpawn(e))}),this.world.actorRemoved.pipe(s(this.destroyed),t(10)).subscribe(e=>{this.sendActorRemove(e),this.replicatedActors.delete(e),this.replicatedProperties.delete(e),this.replicatedPropertyRegistry.delete(e),this.actorPreSpawnMessageBuffer.delete(e)}),this.session.playerJoined.pipe(s(this.destroyed)).subscribe(e=>{this.sendServerTime(e),this.isServer&&this.replicatedActors.size>0&&this.spawnOnLateClient(e)})}stop(){this.destroyed.next(null),this.destroyed.complete()}configureMaterializedActorRole(e){null!=e.__netSceneId&&this.mode!==y.none&&(this.shouldReplicate(e)?e.netRole=this.isServer?w.authority:w.simulatedProxy:this.isServer||(e.netRole=w.none))}shouldReplicate(e){const t=this.shouldReplicateMap.get(e);if(null==t){const t=e.constructor[l],n=!0===t?.replicate;return this.shouldReplicateMap.set(e,n),n}return!0===t}setReplicate(e,t){this.shouldReplicateMap.set(e,t)}isRelevant(e,t){const n=this.getRelevancyOptions(e);return!(!0===n?.ownerOnly)||this.resolveActorConnection(e)?.id===t.id}getRelevancyOptions(e){return e.constructor[l].relevancy}spawnOnLateClient(e){const t=[e];for(const e of this.replicatedActors.keys())this.sendActorSpawn(e,t)}async processMessages(){const e=this.session.hasMessage();for(let t=0;t<e;t++){const e=this.session.readMessage();null!=e&&await this.processMessage(e)}}async processMessage(e){try{switch(new DataView(e.buffer).getUint8(0)){case P.rpc:case P.rpcComponent:case P.rpcBinary:case P.rpcComponentBinary:this.processRpc(e.from,e.buffer);break;case P.prop:case P.propComponent:this.processProp(e.from,e.buffer);break;case P.propSnapshot:this.processPropSnapshot(e.from,e.buffer);break;case P.spawn:await this.processSpawn(e.from,e.buffer);break;case P.removeActor:this.processRemoveActor(e.from,e.buffer);break;case P.serverTime:this.processServerTime(e.from,e.buffer);break;case P.actorReady:this.processActorReady(e.from,e.buffer)}}catch(e){console.error("Failed to process message",e)}}processServerTime(e,t){if(this.isServer||this.session.server?.id!==e.id)return;const n=this.parseServerTime(t);this.serverTimeOffset=Date.now()-n}getActorRefMissingMessageQueue(e){let t=this.actorRefMissingMessageQueue.get(e);return null==t&&(t=[],this.actorRefMissingMessageQueue.set(e,t)),t}processRpc(e,t){let n=0;const r=new DataView(t),s=r.getUint8(n);n+=1;const o=r.getUint32(n,!0);n+=4;const i=r.getUint8(n);n+=1;const c=s===P.rpcBinary||s===P.rpcComponentBinary;let a,l,d="";if(c){const e=r.getUint32(n,!0);n+=4,l=new Uint8Array(t,n,e),n+=e}else{const e=r.getUint16(n,!0);n+=2,d=O(t,n,e),n+=e;try{a=this.serializer.decode(d,F)}catch(e){return void console.warn("Failed to parse RPC args JSON",d,e)}}if(!c&&F.error){if(null!=F.missingActorId){const n=this.getActorRefMissingMessageQueue(F.missingActorId);console.debug(`Missing referenced actor ${F.missingActorId}. Queueing message for later`),n.push({from:e,buffer:t})}else console.log("Unknown decode error",d);return}const p=this.world.actors.find(e=>e.__netid===o);if(null==p){return this.getActorRefMissingMessageQueue(o).push({from:e,buffer:t}),void console.debug(`Missing actor ${o}. Queueing message for later`)}let u;if(s===P.rpcComponent||s===P.rpcComponentBinary){const e=r.getUint8(n),t=p[f];if(null!=t&&(u=t.find(t=>t.__netid===e)),null==u)return void console.error(`RPC failed: Failed to find component with netid ${e} on actor with netid ${o}`)}if(this.isServer){if(!this.session.clients.some(t=>t.id==e.id))return void console.warn("Received RCP from non client");const t=this.resolveActorConnection(p);if(null==t)return void console.error("Received server RPC for actor without owner which can't be processed");if(t.id!==e.id)return void console.warn(`Received RPC for actor net id ${p.__netid} from connection ${e.id}, but this connection is not the owner. Can't process.`)}else{if(!(this.session.server?.id===e.id))return void console.warn("Received RCP from non server which is not allowed")}const h=u??p,g=_(h,i);if(null!=g)if("function"==typeof h[g])if(c)h[g](l);else{if(F.requiresAssetLookups)return this.serializer.decodeAssets(a).then(e=>{h[g](...e)}).catch(e=>{console.warn(`Failed to decode asset references for RPC '${g}' on actor net id ${p.__netid}`,e)});h[g](...a)}else console.error(`RPC function '${g}' not found on actor net id ${p.__netid}`+(null!=u?` and component net id ${u.__netid}`:""));else console.error(`RPC method id ${i} not found on actor net id ${p.__netid}`+(null!=u?` and component net id ${u.__netid}`:""))}processProp(e,t){if(this.session.server?.id!==e.id)return void console.warn(`Received property replication from non-server connection (id: ${e.id}), ignoring.`);let n=0;const r=new DataView(t),s=r.getUint8(n);n+=1;const o=r.getUint32(n,!0);n+=4;const i=r.getUint8(n);n+=1;let c="";for(let e=0;e<i;e++)c+=String.fromCharCode(r.getUint8(n+e));n+=i;const a=r.getUint16(n,!0);n+=2;const l=t.slice(n,n+a);n+=a;const d=this.world.actors.find(e=>e.__netid===o);if(!d){return this.getActorRefMissingMessageQueue(o).push({from:e,buffer:t}),void console.error("Failed to process property replication. No actor found with id",o,c)}let p;if(s===P.propComponent){const e=r.getUint8(n),t=d[f];if(null!=t&&(p=t.find(t=>t.__netid===e)),null==p)return void console.error(`Failed to find component with netid ${e} on actor with netid ${o}`)}const u=p??d;try{const n=this.decodeReplicatedValue(l);if(F.error){if(null!=F.missingActorId){let n=this.getActorRefMissingMessageQueue(F.missingActorId);console.debug(`Missing referenced actor ${F.missingActorId}. Queueing message for later`),n.push({from:e,buffer:t})}return}if(F.requiresAssetLookups)return this.serializer.decodeAssets(n).then(e=>{this.applyReplicatedProperty(u,c,e),this.callRepNotify(u,c)}).catch(e=>{console.warn(`Failed to decode asset references for replicated property '${c}' on actor id ${o}`,e)});this.applyReplicatedProperty(u,c,n),this.callRepNotify(u,c)}catch(e){console.warn(`Failed to decode replicated property '${c}' on actor id ${o}`,e)}}processPropSnapshot(e,t){if(this.session.server?.id!==e.id)return void console.warn(`Received property snapshot from non-server connection (id: ${e.id}), ignoring.`);let n=0;const r=new DataView(t);n+=1;const s=r.getUint32(n,!0);n+=4;const o=this.world.actors.find(e=>e.__netid===s);if(null==o){return this.getActorRefMissingMessageQueue(s).push({from:e,buffer:t}),void console.debug(`Missing actor ${s}. Queueing property snapshot for later`)}const i=r.getUint16(n,!0);n+=2;const c=[];for(let a=0;a<i;a++){const i=r.getUint8(n);n+=1;let a=o;if(i===$.component){const e=r.getUint8(n);n+=1;const t=o[f];if(a=t?.find(t=>t.__netid===e),null==a)return void console.error(`Failed to process property snapshot. No component found with netid ${e} on actor with netid ${s}`)}else if(i!==$.actor)return void console.error(`Failed to process property snapshot. Unknown target kind ${i}`);const l=r.getUint8(n);n+=1;let d="";for(let e=0;e<l;e++)d+=String.fromCharCode(r.getUint8(n+e));n+=l;const p=r.getUint32(n,!0);n+=4;const u=t.slice(n,n+p);n+=p;try{const n=this.decodeReplicatedValue(u);if(F.error){if(null!=F.missingActorId){this.getActorRefMissingMessageQueue(F.missingActorId).push({from:e,buffer:t}),console.debug(`Missing referenced actor ${F.missingActorId}. Queueing property snapshot for later`)}else console.warn(`Unknown decode error in property snapshot for actor ${s}`);return}c.push({target:a,property:d,value:n,requiresAssetLookups:F.requiresAssetLookups})}catch(e){return void console.warn(`Failed to decode replicated property snapshot entry '${d}' on actor id ${s}`,e)}}if(c.some(e=>e.requiresAssetLookups))return Promise.all(c.map(async e=>{e.requiresAssetLookups&&(e.value=await this.serializer.decodeAssets(e.value))})).then(()=>{this.applyReplicatedProperties(c)}).catch(e=>{console.warn(`Failed to decode asset references for property snapshot on actor id ${s}`,e)});this.applyReplicatedProperties(c)}applyReplicatedProperties(e){for(const t of e)this.applyReplicatedProperty(t.target,t.property,t.value);for(const t of e)this.callRepNotify(t.target,t.property)}async processSpawn(e,t){if(this.isServer)return;const n=new DataView(t);let r=0;r+=1;const s=n.getUint32(r,!0);r+=4;const o=n.getUint8(r);r+=1;let i="";for(let e=0;e<o;e++)i+=String.fromCharCode(n.getUint8(r+e));r+=o,Q.set(n.getFloat32(r,!0),n.getFloat32(r+4,!0),n.getFloat32(r+8,!0)),r+=12,B.set(n.getFloat32(r,!0),n.getFloat32(r+4,!0),n.getFloat32(r+8,!0)),r+=12;const c=n.getUint8(r);r+=1;const a=n.getUint32(r);r+=4;const l=this.readOptionalSceneId(t,r);console.log("Spawning "+i);const d=p(i);if(!d)return void console.error(`Failed to spawn actor: unknown actor type '${i}'`);const u=this.world.actors.find(e=>e.__netid===s);if(null!=u)return void this.applySpawnNetInfo(u,s,c,a);if(this.spawningActorNetIds.has(s))return void console.log("Actor was already spawned",null!=u);const f=this.findMaterializedNetStartupActor(l,i,s);if(null!=f)return this.applySpawnNetInfo(f,s,c,a),this.processQueuedActorMessages(s),void this.sendActorReady(f);if(null==l){this.spawningActorNetIds.add(s);try{const e=await this.world.spawnActorWithNetInfo(d,s,c,a,Q,B);this.processQueuedActorMessages(s),this.sendActorReady(e)}catch(e){return void console.error("Spawning replicated actor on client failed",e)}finally{this.spawningActorNetIds.delete(s)}}else this.getNetStartupActorSpawnQueue(l).push({from:e,buffer:t})}readOptionalSceneId(e,t){if(t+2>e.byteLength)return;const n=new DataView(e).getUint16(t,!0);return t+=2,0===n||t+n>e.byteLength?void 0:O(e,t,n)}findMaterializedNetStartupActor(e,t,n){if(null!=e)return this.world.actors.find(r=>{if(r.__netSceneId!==e)return!1;if(null!=r.__netid&&r.__netid!==n)return!1;return(r.constructor.__actorId??r.constructor.name)===t})}applySpawnNetInfo(e,t,n,r){if(e.__netid=t,e.netRole=n,0===r)e.owner=void 0;else{const t=this.world.actors.find(e=>e.__netid===r);null!=t&&(e.owner=t)}e instanceof M&&(e.isLocallyControlled=n===w.autonomousProxy)}getNetStartupActorSpawnQueue(e){let t=this.netStartupActorSpawnQueue.get(e);return null==t&&(t=[],this.netStartupActorSpawnQueue.set(e,t)),t}processQueuedNetStartupActorSpawns(e){if(null==e.__netSceneId)return;const t=this.netStartupActorSpawnQueue.get(e.__netSceneId);if(null!=t){this.netStartupActorSpawnQueue.delete(e.__netSceneId);for(const e of t)this.processMessage(e)}}processQueuedActorMessages(e){const t=this.actorRefMissingMessageQueue.get(e);if(null!=t){console.log(`Processing queued messages for actor ${e}`),this.actorRefMissingMessageQueue.delete(e);for(const e of t)this.processMessage(e)}}sendActorReady(e){if(this.mode===y.none)return;if(!e||null==e.__netid)return void console.warn("sendActorReady: actor or actor.__netid is undefined");if(this.isServer)return;const t=new ArrayBuffer(5),n=new DataView(t);let r=0;n.setUint8(r,P.actorReady),r+=1,n.setUint32(r,e.__netid,!0),this.session.server&&this.session.sendMessage(this.session.server,!0,t)}processActorReady(e,t){if(!this.isServer)return;const n=new DataView(t).getUint32(1,!0),r=this.world.actors.find(e=>e.__netid===n);if(!r)return void console.warn(`processActorReady: No actor found with net id ${n}`);const s=this.actorPreSpawnMessageBuffer.get(r),o=this.getConnectionKey(e),i=s?.get(o);if(null!=i){this.sendPropertySnapshot(r,e);const t=i.filter(e=>!this.isPropertyMessage(e.buffer));if(t.length>0){console.log(`Sending ${t.length} queued messages for actor ${r.__netid}`);for(const e of t)this.session.sendMessage(e.connection,e.reliable,e.buffer)}s.delete(o),0===s.size&&this.actorPreSpawnMessageBuffer.delete(r)}}sendRpc(e,t,n,r,s,o){if(this.mode==y.none)return;if(!this.shouldReplicate(n))return;const i=n.__netid;if(null==i)return void console.warn("No __netid defined on actor. Actor must be repliated for RPC");const c=this.resolveActorConnection(n),a=[];if(this.isServer)switch(e){case S.all:a.push(...this.session.clients.filter(e=>this.isRelevant(n,e)));break;case S.client:null!=c&&a.push(c);break;case S.notOwner:a.push(...this.session.clients.filter(e=>e.id!==c?.id&&this.isRelevant(n,e)));case S.server:}else switch(e){case S.all:case S.client:case S.notOwner:break;case S.server:a.push(this.session.server)}if(0==a.length)return;if(null!=o&&null==o.__netid)return void console.warn("No __netid defined on component. Component must be initialized for RPC",o);const l=null!=o,d=o??n,p=R(d,r);if(null==p)return void console.warn(`RPC function '${r}' is not registered on ${d.constructor?.name??"target"}`);const u=1===s.length?function(e){if(e instanceof Uint8Array)return e;if(e instanceof ArrayBuffer)return new Uint8Array(e);if("undefined"!=typeof SharedArrayBuffer&&e instanceof SharedArrayBuffer)return new Uint8Array(e);if(ArrayBuffer.isView(e))return new Uint8Array(e.buffer,e.byteOffset,e.byteLength);return null}(s[0]):null;if(null!=u){let e=10+u.byteLength;l&&(e+=1);const r=new ArrayBuffer(e),s=new DataView(r);let c=0;s.setUint8(c,l?P.rpcComponentBinary:P.rpcBinary),c+=1,s.setUint32(c,i,!0),c+=4,s.setUint8(c,p),c+=1,s.setUint32(c,u.byteLength,!0),c+=4,D(r,c,u),c+=u.byteLength,l&&(s.setUint8(c,o.__netid),c+=1);for(const e of a)null!=e&&this.sendWithQueue(n,{connection:e,reliable:t,buffer:r});return}const f=this.serializer.encode(s),h=I.encode(f);if(h.byteLength>65535)return void console.warn("RPC arguments are too large to send with the JSON RPC format",r);let g=8+h.byteLength;l&&(g+=1);const w=new ArrayBuffer(g),m=new DataView(w);let v=0;m.setUint8(v,l?P.rpcComponent:P.rpc),v+=1,m.setUint32(v,i,!0),v+=4,m.setUint8(v,p),v+=1,m.setUint16(v,h.byteLength,!0),v+=2,D(w,v,h),v+=h.byteLength,l&&(m.setUint8(v,o.__netid),v+=1);for(const e of a)null!=e&&this.sendWithQueue(n,{connection:e,reliable:t,buffer:w})}sendWithQueue(e,t){if(this.shouldQueueMessageUntilActorReady(e,t.connection)){return void this.getPreSpawnMessageQueue(e,t.connection).push(t)}this.session.sendMessage(t.connection,t.reliable,t.buffer)}findQueuedActorsInData(e,t=[]){if("object"==typeof e){if(Array.isArray(e))for(const t of e)this.findQueuedActorsInData(t);if(e instanceof d){this.actorPreSpawnMessageBuffer.get(e)}}}handlePropertySet(e,t,n,r,s,o){if(this.mode==y.none)return;if(!this.isServer)return;if(!this.shouldReplicate(n))return;let i=this.replicatedProperties.get(n);null==i&&(i={},this.replicatedProperties.set(n,i));const c=this.serializer.encode(s),a=I.encode(c),l=a.buffer.slice(a.byteOffset,a.byteOffset+a.byteLength);i[this.getReplicatedPropertyKey(r,o)]={property:r,replOn:e,reliable:t,buffer:l,component:o},this.sendProperty(e,t,n,r,l,o)}sendProperty(e,t,n,r,s,o){if(!this.isServer)return;const i=[],c=this.resolveActorConnection(n);switch(e){case b.all:i.push(...this.session.clients);break;case b.owner:null!=c&&i.push(c);break;case b.notOwner:null==c?i.push(...this.session.clients):i.push(...this.session.clients.filter(e=>e.id!==c.id))}const a=null!=o&&null!=o.__netid;let l=6+r.length+2+s.byteLength;a&&(l+=1);const d=new ArrayBuffer(l),p=new DataView(d);let u=0;p.setUint8(u,a?P.propComponent:P.prop),u+=1,p.setUint32(u,n.__netid,!0),u+=4,p.setUint8(u,r.length),u+=1;for(let e=0;e<r.length;e++)p.setUint8(u++,r.charCodeAt(e));p.setUint16(u,s.byteLength,!0),u+=2,new Uint8Array(d,u,s.byteLength).set(new Uint8Array(s)),u+=s.byteLength,a&&(p.setUint8(u,o.__netid),u+=1);for(const e of i)null!=e&&this.isRelevant(n,e)&&this.sendWithQueue(n,{connection:e,reliable:t,buffer:d})}defineNetId(e){null==e.__netid&&(e.__netid=this.nextNetId++)}registerReplicatedProperty(e,t,n,r,s,o){if(null==n||null==r||null==s)return;let i=this.replicatedPropertyRegistry.get(n);null==i&&(i=[],this.replicatedPropertyRegistry.set(n,i));const c=o??(s instanceof u?s:void 0),a=i.find(e=>e.target===s&&e.property===r);if(null!=a)return a.replOn=e,a.reliable=t,void(a.component=c);i.push({property:r,replOn:e,reliable:t,target:s,component:c})}sendActorSpawn(e,t=this.session.clients){if(!this.isServer)return;const n=t.filter(t=>this.isRelevant(e,t));this.defineNetId(e);const r=e.__netid;let s=e.constructor.__actorId??e.constructor.name;const o=I.encode(s);let i;null!=e.__netSceneId&&(i=I.encode(e.__netSceneId),i.byteLength>65535&&(console.warn(`Scene actor id is too long to replicate as a startup actor: ${e.__netSceneId}`),i=void 0));const c=i?.byteLength??0,a=6+o.length+12+12+1+4+2+c,l=new ArrayBuffer(a),d=new DataView(l);let p=0;d.setUint8(p,P.spawn),p+=1,d.setUint32(p,r,!0),p+=4,d.setUint8(p,o.length),p+=1,new Uint8Array(l).set(o,p),p+=o.length,d.setFloat32(p,e.position.x,!0),p+=4,d.setFloat32(p,e.position.y,!0),p+=4,d.setFloat32(p,e.position.z,!0),p+=4,d.setFloat32(p,e.rotation.x,!0),p+=4,d.setFloat32(p,e.rotation.y,!0),p+=4,d.setFloat32(p,e.rotation.z,!0),p+=4;let u=p;p+=1,d.setUint32(p,e.owner?.__netid??0),p+=4,d.setUint16(p,c,!0),p+=2,null!=i&&(D(l,p,i),p+=i.byteLength);let f=this.replicatedActors.get(e);null==f&&(f={spawnedAt:Date.now(),connections:[]},this.replicatedActors.set(e,f));for(const t of n){const n=l.slice(0),r=new DataView(n),s=this.resolveActorConnection(e)?.id===t.id?w.autonomousProxy:w.simulatedProxy;r.setUint8(u,s),this.getPreSpawnMessageQueue(e,t),this.session.sendMessage(t,!0,n),f.connections.some(e=>e.id===t.id)||f.connections.push(t)}}sendActorRemove(e){if(!this.isServer)return;const t=new ArrayBuffer(5),n=new DataView(t);let r=0;n.setUint8(r,P.removeActor),r+=1,n.setUint32(r,e.__netid,!0);for(const e of this.session.clients)this.session.sendMessage(e,!0,t)}processRemoveActor(e,t){if(this.isServer||this.session.server?.id!==e.id)return;const n=new DataView(t).getUint32(1,!0),r=this.world.actors.find(e=>e.__netid===n);r&&(this.world.removeActor(r),this.replicatedActors?.delete?.(r),this.replicatedProperties?.delete?.(r))}setOwningConnection(e,t){this.actorConnection.set(e.id,t)}getOwningConnection(e){return this.actorConnection.get(e.id)}getActorsByOwningConnection(e){const t=[];return this.actorConnection.forEach((n,r)=>{if(n.id===e.id){const e=this.world.actors.find(e=>e.id===r);null!=e&&t.push(e)}}),t}resolveActorConnection(e){let t;for(;null==t&&null!=e;)t=this.actorConnection.get(e.id),null==t&&(e=e.owner);return t}isLocallyControlled(e){let t=e;for(;null!=t;){if(t.netRole===w.autonomousProxy)return!0;if(t instanceof U)return t.isLocallyControlled;t=e.owner}return!1}isLocalOwner(e){return this.isLocallyControlled(e)}sendServerTime(e){const t=new ArrayBuffer(9),n=new DataView(t);n.setUint8(0,P.serverTime),n.setBigUint64(1,BigInt(Date.now()),!0),this.session.sendMessage(e,!0,t)}parseServerTime(e){const t=new DataView(e).getBigUint64(1,!0);return Number(t)}getConnectionKey(e){return e.id.toString()}getPreSpawnMessageQueue(e,t){let n=this.actorPreSpawnMessageBuffer.get(e);null==n&&(n=new Map,this.actorPreSpawnMessageBuffer.set(e,n));const r=this.getConnectionKey(t);let s=n.get(r);return null==s&&(s=[],n.set(r,s)),s}shouldQueueMessageUntilActorReady(e,t){const n=this.actorPreSpawnMessageBuffer.get(e);return!!n?.has(this.getConnectionKey(t))||this.isServer&&!this.replicatedActors.has(e)&&this.shouldReplicate(e)}isPropertyMessage(e){const t=new DataView(e).getUint8(0);return t===P.prop||t===P.propComponent}getReplicatedPropertyKey(e,t){return null!=t?.__netid?`component:${t.__netid}:${e}`:`actor:${e}`}sendPropertySnapshot(e,t){const n=this.buildPropertySnapshotEntries(e,t);if(0===n.length)return;const r=this.createPropertySnapshotBuffer(e,n);this.session.sendMessage(t,!0,r)}buildPropertySnapshotEntries(e,t){if(!this.isRelevant(e,t))return[];const n=this.replicatedPropertyRegistry.get(e);if(null==n)return[];const r=[];for(const s of n){if(!this.shouldReplicatePropertyToConnection(e,s.replOn,t))continue;if(null!=s.component&&null==s.component.__netid)continue;const n=this.readReplicatedPropertyValue(s),o=this.serializer.encode(n),i=I.encode(o),c=i.buffer.slice(i.byteOffset,i.byteOffset+i.byteLength);r.push({property:s.property,component:s.component,buffer:c})}return r}shouldReplicatePropertyToConnection(e,t,n){const r=this.resolveActorConnection(e);switch(t){case b.all:return!0;case b.owner:return r?.id===n.id;case b.notOwner:return null==r||r.id!==n.id}}readReplicatedPropertyValue(e){const t=e.target[e.property];return A(t)?t.value:t}createPropertySnapshotBuffer(e,t){let n=7;const r=t.map(e=>I.encode(e.property));for(let e=0;e<t.length;e++){const s=t[e];n+=1,null!=s.component&&(n+=1),n+=1+r[e].byteLength+4+s.buffer.byteLength}const s=new ArrayBuffer(n),o=new DataView(s);let i=0;o.setUint8(i,P.propSnapshot),i+=1,o.setUint32(i,e.__netid,!0),i+=4,o.setUint16(i,t.length,!0),i+=2;for(let e=0;e<t.length;e++){const n=t[e],c=r[e],a=null!=n.component;o.setUint8(i,a?$.component:$.actor),i+=1,a&&(o.setUint8(i,n.component.__netid),i+=1),o.setUint8(i,c.byteLength),i+=1,new Uint8Array(s,i,c.byteLength).set(c),i+=c.byteLength,o.setUint32(i,n.buffer.byteLength,!0),i+=4,new Uint8Array(s,i,n.buffer.byteLength).set(new Uint8Array(n.buffer)),i+=n.buffer.byteLength}return s}decodeReplicatedValue(e){let t;if(null!=N)t=N.decode(e);else{t="";const n=new Uint8Array(e);for(let e=0;e<n.length;e++)t+=String.fromCharCode(n[e])}return this.serializer.decode(t,F)}applyReplicatedProperty(e,t,n){A(e[t])?e[t].value=n:e[t]=n}callRepNotify(e,t){const n=e[`onRep_${t}`];"function"==typeof n&&n.call(e)}};L=e([a()],L);export{L as NetService};const Q=new c,B=new i,I=new TextEncoder,N="undefined"!=typeof TextDecoder?new TextDecoder:void 0;function O(e,t,n){const r=new Uint8Array(e,t,n);if(null!=N)return N.decode(r);let s="";for(let e=0;e<r.length;e++)s+=String.fromCharCode(r[e]);return s}function D(e,t,n){new Uint8Array(e,t,n.byteLength).set(n)}const F=new m;/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,8 @@
+type SignalDispose = () => void;
+type SignalLike<T = unknown> = {
+    subscribe: (fn: (value: T) => void) => SignalDispose;
+    value: T;
+};
+export declare function isSignalLike<T = unknown>(value: unknown): value is SignalLike<T>;
+export {};
+//# sourceMappingURL=net-utils.d.ts.map

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

@@ -0,0 +1,4 @@
+export function isSignalLike(e){return"object"==typeof e&&null!==e&&"function"==typeof e.subscribe&&"value"in e}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,31 @@
+export declare enum ReplOn {
+    /**
+     * The property will be replicated on all connected clients.
+     * This is usually the default behavior.
+     */
+    all = 0,
+    /**
+     * The property will be replicated on the owning client and server
+     *
+     * Example use case:
+     * - Information that should be hidden from other players such as
+     *   remaining ammunition or active spell cooldown but needs to be
+     *   known by the player and server.
+     */
+    owner = 1,
+    /**
+     * The property will be replicated on all clients and server but
+     * not the owner.
+     *
+     * Example use case:
+     * - Certain state is already set on the owning client
+     *   that could for example drive visual effects or sound.
+     *   We exclude the owner to avoid unnecesary networking and
+     *   triggering effective twice.
+     * - Movement state like isJumping used to control animation state
+     *   machines, which is likely already set
+     *   on the owning client for immediate feedback.
+     */
+    notOwner = 2
+}
+//# sourceMappingURL=replication.d.ts.map

package/dist/gameplay/net/service/replication.js

@@ -0,0 +1,4 @@
+export var ReplOn;!function(n){n[n.all=0]="all",n[n.owner=1]="owner",n[n.notOwner=2]="notOwner"}(ReplOn||(ReplOn={}));/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,21 @@
+/**
+ * Decorator for marking a method as an RPC.
+ * @param reliable - If the call on remotes has to happen. Set to false for better performance is ok to lose some calls
+ */
+export declare function RunOnServer(reliable?: boolean): any;
+/**
+ * Decorator for marking a method as an RPC.
+ * @param reliable - If the call on remotes has to happen. Set to false for better performance is ok to lose some calls
+ */
+export declare function RunOnClient(reliable?: boolean): any;
+/**
+ * Decorator for marking a method as an RPC.
+ * @param reliable - If the call on remotes has to happen. Set to false for better performance is ok to lose some calls
+ */
+export declare function RunOnNotOwner(reliable?: boolean): any;
+/**
+ * Decorator for marking a method as an RPC.
+ * @param reliable - If the call on remotes has to happen. Set to false for better performance is ok to lose some calls
+ */
+export declare function RunOnAll(reliable?: boolean): any;
+//# sourceMappingURL=rpc-decorator.d.ts.map

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

@@ -0,0 +1,4 @@
+import{inject as n}from"../../inject.js";import{NetService as t}from"./net-service.js";import{registerRpcMethod as e,RunsOn as r}from"./rpc.js";import{BaseActor as o}from"../../actors/actor.js";import{NetMode as i}from"../net-session.js";import{ActorComponent as s}from"../../actors/component.js";export function RunOnServer(n=!0){return c(r.server,n)}export function RunOnClient(n=!0){return c(r.client,n)}export function RunOnNotOwner(n=!0){return c(r.notOwner,n)}export function RunOnAll(n=!0){return c(r.all,n)}function c(r,o=!0){return function(...i){if(i.length>=3){const[s,c,u]=i,a=u.value,f=c.toString();let p;return e(s,f),u.value=l(a,f,r,o,()=>(p??(p=n(t)),p)),u}const[s,c]=i,u=c.name.toString();let a;return c.addInitializer(function(){e(Object.getPrototypeOf(this),u),a=n(t)}),l(s,u,r,o,()=>(a??(a=n(t)),a))}}function l(n,t,e,c,l){return function(...u){const a=l();if(!(this instanceof o||this instanceof s))return void console.warn("RPC is defined on a non actor");let f,p;if(this instanceof o)f=this;else if(f=this.actor,p=this,null==f)return void console.warn("Can't call RPC on component before actor is set");let m,v=!1;return a.isServer&&(e===r.all||e===r.server||e===r.notOwner&&!a.isLocalOwner(f)&&a.mode===i.listenServer||e===r.client&&!a.isDedicatedServer&&a.isLocalOwner(f))?v=!0:a.isServer||e!==r.all&&e!==r.client&&e!==r.notOwner||(v=!0),v&&(m=n.apply(this,u)),a&&"function"==typeof a.sendRpc?a.sendRpc(e,c,f,t,u,p):console.warn("Net service is not set up",{netService:a}),m}}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

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

@@ -0,0 +1,35 @@
+export declare enum RunsOn {
+    /**
+     * Runs on the owning client if sent from the server.
+     * Can be called on client as well and executes locally only.
+     *
+     * Example use case: correct player position
+     */
+    client = 0,
+    /**
+     * Runs on clients (or listen server) if it is not the owner.
+     * Can only be called from the server.
+     * Does not run on dedicated server.
+     *
+     * Example use case: playing effects that already were played on the owning client
+     */
+    notOwner = 1,
+    /**
+     * Runs on the server when sent from the client.
+     * Can be called on the server as well and executes locally only.
+     *
+     * Example use cases: process user input
+     */
+    server = 2,
+    /**
+     * Runs on the server and all clients.
+     * If called on a client, it is only executed locally.
+     *
+     * May be used in combination with checking if not dedicated server
+     * to not perform unnecessary work that is purely visual.
+     *
+     * Example use cases: visual effects, playing sound, synchronize state
+     */
+    all = 3
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/gameplay/net/service/rpc.js

@@ -0,0 +1,4 @@
+export var RunsOn;!function(e){e[e.client=0]="client",e[e.notOwner=1]="notOwner",e[e.server=2]="server",e[e.all=3]="all"}(RunsOn||(RunsOn={}));const e=Symbol("rpc-method-registry");export function registerRpcMethod(n,o){const r=function(n){const o=Object.prototype.hasOwnProperty.call(n,e)?n[e]:void 0;if(null!=o)return o;const r=t(Object.getPrototypeOf(n)),s={methodNames:null!=r?[...r.methodNames]:[],methodIdsByName:null!=r?new Map(r.methodIdsByName):new Map};return Object.defineProperty(n,e,{value:s}),s}(n),s=r.methodIdsByName.get(o);if(null!=s)return s;if(r.methodNames.length>=256)return void console.warn(`Too many RPC methods registered on ${function(e){return e.constructor?.name??"target"}(n)}. A maximum of 256 methods can be encoded.`);const m=r.methodNames.length;return r.methodNames.push(o),r.methodIdsByName.set(o,m),m}export function getRpcMethodId(e,n){return t(e)?.methodIdsByName.get(n)}export function getRpcMethodName(e,n){return t(e)?.methodNames[n]}function t(t){let n=t;for(;null!=n;){const t=Object.prototype.hasOwnProperty.call(n,e)?n[e]:void 0;if(null!=t)return t;n=Object.getPrototypeOf(n)}}/*
+ * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
+ * See the LICENSE.md file for details.
+ */

package/dist/gameplay/services/asset-loader.d.ts

@@ -9,6 +9,7 @@ import { ShaderImpl } from '../../shader/shader.js';
 import type { ShaderGraphDocument } from '../../shader/graph/model.js';
 import { Sequence } from '../../effects/sequence/sequence-data.js';
 import { DataAssetRef } from '../../scene/objects/data-asset.js';
+import { Type } from '../../utils/type.js';
 export declare class AssetLoader {
     protected assetResourceLoader: AssetResourceLoader;
     protected assetService: AssetsProvider;
@@ -24,6 +25,7 @@ export declare class AssetLoader {
     private ktx2Loader;
     private textureLoader;
     private audioLoader;
+    private animationVariantIds;
     constructor(assetResourceLoader: AssetResourceLoader, assetService: AssetsProvider, shaders: ShaderImpl[]);
     /**
      * @param filePath
@@ -44,13 +46,19 @@ export declare class AssetLoader {
     getModelByAssetName(name: string): Promise<LoadedMesh>;
     getModelByAssetId(id: AssetId): Promise<LoadedMesh>;
     getAnimationClipByAssetId(id: AssetId): Promise<THREE.AnimationClip | null>;
+    /**
+     * Resolve an animation reference for a concrete target rig without running a
+     * retarget solver. A mismatched source clip must already have a generated
+     * output recorded by an Animation Retargeter asset.
+     */
+    getAnimationClipForTargetByAssetId(id: AssetId, targetRigId?: AssetId): Promise<THREE.AnimationClip | null>;
     getAnimationClipByAssetName(name: string): Promise<THREE.AnimationClip | null>;
     getTextureByAssetName(name: string): Promise<THREE.Texture>;
     getTextureByAssetId(id: AssetId): Promise<THREE.Texture>;
     getSequenceById(id: AssetId): Promise<Sequence>;
     getSequenceByName(name: string): Promise<Sequence>;
-    getDataAssetById<T = unknown>(id: AssetId): Promise<DataAssetRef<T> | null>;
-    getDataAssetByName<T = unknown>(name: string): Promise<DataAssetRef<T> | null>;
+    getDataAssetById<T = unknown>(id: AssetId, type?: Type<T>): Promise<DataAssetRef<T> | null>;
+    getDataAssetByName<T = unknown>(name: string, type?: Type<T>): Promise<DataAssetRef<T> | null>;
     getShaderGraphByAssetId(id: AssetId): Promise<ShaderGraphDocument>;
     prepareShaderGraphParameters(graph: ShaderGraphDocument, params?: Record<string, any>): Promise<Record<string, unknown>>;
     getMaterialByAssetId(id: AssetId): Promise<Material>;

package/dist/gameplay/services/asset-loader.js

@@ -1,4 +1,4 @@
-import{__decorate as e,__metadata as s}from"tslib";import{AudioLoader as t,LoadingManager as a,TextureLoader as r}from"three";import{FBXLoader as i,GLTFLoader as o,MTLLoader as n,OBJLoader as h,TGALoader as d}from"three-stdlib";import{KTX2Loader as c}from"three/examples/jsm/Addons.js";import{Service as l}from"typedi";import{AssetResourceLoader as u}from"../../scene/asset-resource-loader.js";import{applyMaterial as w}from"../../scene/materializer";import{materialFromAsset as g,materializeDataAssetRef as f,prepareShaderGraphParameters as m}from"../../scene/materializer.js";import{Prefab as y}from"../../scene/objects/prefab.js";import{pathJoin as A}from"../../utils/files.js";import{Sequence as p}from"../../effects/sequence/sequence-data.js";let b=class{constructor(e,s,l){this.assetResourceLoader=e,this.assetService=s,this.shaders=l,this.baseUrl="",this.urlSuffix="",this.loadingManager=new a,this.glbLoader=new o(this.loadingManager),this.fbxLoader=new i(this.loadingManager),this.objLoader=new h(this.loadingManager),this.mtlLoader=new n(this.loadingManager),this.tgaLoader=new d(this.loadingManager),this.ktx2Loader=new c(this.loadingManager),this.textureLoader=new r(this.loadingManager),this.audioLoader=new t(this.loadingManager),this.assetResourceLoader.materialProvider=e=>this.getMaterialByAssetId(e)}resolvePath(e){return A(this.baseUrl,e)+this.urlSuffix}getAudioAtPath(e){const s=this.resolvePath(e);return this.audioLoader.loadAsync(s)}async getAudioByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No audio could be found with asset id ${e}`);return this.assetResourceLoader.getAudio(s)}async getAudioByAssetName(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No audio could be found with asset name ${e}`);return this.assetResourceLoader.getAudio(s)}async getModelAtPath(e){const s=this.resolvePath(e);switch(e.split(".").pop().toLowerCase()){case"glb":case"gltf":return(await this.glbLoader.loadAsync(s)).scene;case"fbx":return this.fbxLoader.loadAsync(s);case"obj":return this.objLoader.loadAsync(s);default:throw new Error(`File suffix is not supperted in file ${e}`)}}async getGltfAtPath(e){const s=this.resolvePath(e);return this.glbLoader.loadAsync(s)}async getModelByAssetName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if(null==s)throw new Error(`No model could be found with asset name ${e}`);return this.assetResourceLoader.getMesh(s,{applyMaterials:!0,materialResolver:e=>this.getMaterialByAssetId(e)})}async getModelByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No model could be found with asset id ${e}`);return this.assetResourceLoader.getMesh(s,{applyMaterials:!0,materialResolver:e=>this.getMaterialByAssetId(e)})}async getAnimationClipByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No animation clip could be found with asset id ${e}`);return this.assetResourceLoader.getAnimationClip(s)}async getAnimationClipByAssetName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if(null==s)throw new Error(`No animation clip could be found with asset name ${e}`);return this.assetResourceLoader.getAnimationClip(s)}async applyMaterials(e,s){for(const t of e.materialAssignments??[])await w(s,t,async e=>this.getMaterialByAssetId(e))}async getTextureByAssetName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if(null==s)throw new Error(`No texture could be found with asset name ${e}`);return this.assetResourceLoader.getTexture(s)}async getTextureByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No texture could be found with asset id ${e}`);return this.assetResourceLoader.getTexture(s)}async getSequenceById(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No sequence could be found with asset id ${e}`);if(null==s.sequence)throw new Error(`Missing sequence data in asset ${e}`);return new p(s.sequence)}async getSequenceByName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if(null==s)throw new Error(`No sequence could be found with asset name ${e}`);if(null==s.sequence)throw new Error(`Missing sequence data in asset ${e}`);return new p(s.sequence)}async getDataAssetById(e){return f(e,this.assetService,this.assetResourceLoader,void 0,void 0,this.shaders)}async getDataAssetByName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if(null==s)throw new Error(`No data asset could be found with name ${e}`);return this.getDataAssetById(s.id)}async getShaderGraphByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No shader graph could be found with asset id ${e}`);if("shaderGraph"!==s.type||null==s.shaderGraph)throw new Error(`Missing shader graph data in asset ${e}`);return s.shaderGraph}async prepareShaderGraphParameters(e,s={}){return m(s,e,this.assetService,this.assetResourceLoader,void 0,this.shaders)}async getMaterialByAssetId(e){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No material could be found with asset id ${e}`);return g(s,null,this.assetService,this.assetResourceLoader,this.shaders,!1)}async getAsset(e){return this.assetService.getAsset(e)}async getPrefabByName(e){const s=(await this.assetService.getAssets()).find(s=>s.name===e);if("prefab"!==s.type)throw`Asset with name ${e} is not a prefab`;return new y(s)}async getPrefabById(e){const s=await this.getAsset(e);if("prefab"!==s.type)throw`Asset with name ${name} is not a prefab`;return new y(s)}clearCache(e){this.assetResourceLoader.clearCache(e)}clearCacheById(e){this.assetResourceLoader.clearCacheById(e)}};b=e([l(),s("design:paramtypes",[u,Function,Array])],b);export{b as AssetLoader};/*
+import{__decorate as e,__metadata as t}from"tslib";import{AudioLoader as s,LoadingManager as a,TextureLoader as r}from"three";import{FBXLoader as i,GLTFLoader as n,MTLLoader as o,OBJLoader as h,TGALoader as d}from"three-stdlib";import{KTX2Loader as c}from"three/examples/jsm/Addons.js";import{Service as l}from"typedi";import{AssetResourceLoader as u}from"../../scene/asset-resource-loader.js";import{applyMaterial as w}from"../../scene/materializer";import{materialFromAsset as g,materializeDataAssetRef as f,prepareShaderGraphParameters as m}from"../../scene/materializer.js";import{Prefab as y}from"../../scene/objects/prefab.js";import{pathJoin as A}from"../../utils/files.js";import{Sequence as p}from"../../effects/sequence/sequence-data.js";import{resolveAnimationClipAssetForTarget as b}from"../animation/retarget.js";let v=class{constructor(e,t,l){this.assetResourceLoader=e,this.assetService=t,this.shaders=l,this.baseUrl="",this.urlSuffix="",this.loadingManager=new a,this.glbLoader=new n(this.loadingManager),this.fbxLoader=new i(this.loadingManager),this.objLoader=new h(this.loadingManager),this.mtlLoader=new o(this.loadingManager),this.tgaLoader=new d(this.loadingManager),this.ktx2Loader=new c(this.loadingManager),this.textureLoader=new r(this.loadingManager),this.audioLoader=new s(this.loadingManager),this.animationVariantIds=new Map,this.assetResourceLoader.materialProvider=e=>this.getMaterialByAssetId(e),this.assetResourceLoader.animationRigProvider=async e=>(await this.assetService.getAsset(e))?.animationRig}resolvePath(e){return A(this.baseUrl,e)+this.urlSuffix}getAudioAtPath(e){const t=this.resolvePath(e);return this.audioLoader.loadAsync(t)}async getAudioByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No audio could be found with asset id ${e}`);return this.assetResourceLoader.getAudio(t)}async getAudioByAssetName(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No audio could be found with asset name ${e}`);return this.assetResourceLoader.getAudio(t)}async getModelAtPath(e){const t=this.resolvePath(e);switch(e.split(".").pop().toLowerCase()){case"glb":case"gltf":return(await this.glbLoader.loadAsync(t)).scene;case"fbx":return this.fbxLoader.loadAsync(t);case"obj":return this.objLoader.loadAsync(t);default:throw new Error(`File suffix is not supperted in file ${e}`)}}async getGltfAtPath(e){const t=this.resolvePath(e);return this.glbLoader.loadAsync(t)}async getModelByAssetName(e){const t=(await this.assetService.getAssets()).find(t=>t.name===e);if(null==t)throw new Error(`No model could be found with asset name ${e}`);return this.assetResourceLoader.getMesh(t,{applyMaterials:!0,materialResolver:e=>this.getMaterialByAssetId(e)})}async getModelByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No model could be found with asset id ${e}`);return this.assetResourceLoader.getMesh(t,{applyMaterials:!0,materialResolver:e=>this.getMaterialByAssetId(e)})}async getAnimationClipByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No animation clip could be found with asset id ${e}`);return this.assetResourceLoader.getAnimationClip(t)}async getAnimationClipForTargetByAssetId(e,t){const s=await this.assetService.getAsset(e);if(null==s)throw new Error(`No animation clip could be found with asset id ${e}`);let a=s;if(null!=t&&s.anim?.rigId!==t){const r=`${e}|${t}`,i=this.animationVariantIds.get(r);null!=i?a=await this.assetService.getAsset(i):(a=b(s,await this.assetService.getAssets(),t),this.animationVariantIds.set(r,a.id))}return this.assetResourceLoader.getAnimationClip(a)}async getAnimationClipByAssetName(e){const t=(await this.assetService.getAssets()).find(t=>t.name===e);if(null==t)throw new Error(`No animation clip could be found with asset name ${e}`);return this.assetResourceLoader.getAnimationClip(t)}async applyMaterials(e,t){for(const s of e.materialAssignments??[])await w(t,s,async e=>this.getMaterialByAssetId(e))}async getTextureByAssetName(e){const t=(await this.assetService.getAssets()).find(t=>t.name===e);if(null==t)throw new Error(`No texture could be found with asset name ${e}`);return this.assetResourceLoader.getTexture(t)}async getTextureByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No texture could be found with asset id ${e}`);return this.assetResourceLoader.getTexture(t)}async getSequenceById(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No sequence could be found with asset id ${e}`);if(null==t.sequence)throw new Error(`Missing sequence data in asset ${e}`);return new p(t.sequence)}async getSequenceByName(e){const t=(await this.assetService.getAssets()).find(t=>t.name===e);if(null==t)throw new Error(`No sequence could be found with asset name ${e}`);if(null==t.sequence)throw new Error(`Missing sequence data in asset ${e}`);return new p(t.sequence)}async getDataAssetById(e,t){const s=await f(e,this.assetService,this.assetResourceLoader,void 0,void 0,this.shaders);if(null!=t&&null!=s&&!(s.value instanceof t))throw new Error(`Invalid type. Expecting asset with id ${e} to be of type ${t.name} but got:`+s.value);return s}async getDataAssetByName(e,t){const s=(await this.assetService.getAssets()).find(t=>t.name===e);if(null==s)throw new Error(`No data asset could be found with name ${e}`);return this.getDataAssetById(s.id,t)}async getShaderGraphByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No shader graph could be found with asset id ${e}`);if("shaderGraph"!==t.type||null==t.shaderGraph)throw new Error(`Missing shader graph data in asset ${e}`);return t.shaderGraph}async prepareShaderGraphParameters(e,t={}){return m(t,e,this.assetService,this.assetResourceLoader,void 0,this.shaders)}async getMaterialByAssetId(e){const t=await this.assetService.getAsset(e);if(null==t)throw new Error(`No material could be found with asset id ${e}`);return g(t,null,this.assetService,this.assetResourceLoader,this.shaders,!1)}async getAsset(e){return this.assetService.getAsset(e)}async getPrefabByName(e){const t=(await this.assetService.getAssets()).find(t=>t.name===e);if("prefab"!==t.type)throw`Asset with name ${e} is not a prefab`;return new y(t)}async getPrefabById(e){const t=await this.getAsset(e);if("prefab"!==t.type)throw`Asset with name ${name} is not a prefab`;return new y(t)}clearCache(e){this.animationVariantIds.clear(),this.assetResourceLoader.clearCache(e)}clearCacheById(e){this.animationVariantIds.clear(),this.assetResourceLoader.clearCacheById(e)}};v=e([l(),t("design:paramtypes",[u,Function,Array])],v);export{v as AssetLoader};/*
  * Copyright (©) 2026 Hology Interactive AB. All rights reserved.
  * See the LICENSE.md file for details.
  */