@dcl/ecs 7.21.0 → 7.21.1-22904194370.commit-34c867c

package/dist-cjs/components/generated/pb/decentraland/sdk/components/input_modifier.gen.js

@@ -55,8 +55,6 @@ function createBasePBInputModifier_StandardInput() {
         disableRun: undefined,
         disableJump: undefined,
         disableEmote: undefined,
-        disableDoubleJump: undefined,
-        disableGliding: undefined,
     };
 }
 /**
@@ -83,12 +81,6 @@ var PBInputModifier_StandardInput;
         if (message.disableEmote !== undefined) {
             writer.uint32(48).bool(message.disableEmote);
         }
-        if (message.disableDoubleJump !== undefined) {
-            writer.uint32(56).bool(message.disableDoubleJump);
-        }
-        if (message.disableGliding !== undefined) {
-            writer.uint32(64).bool(message.disableGliding);
-        }
         return writer;
     }
     PBInputModifier_StandardInput.encode = encode;
@@ -135,18 +127,6 @@ var PBInputModifier_StandardInput;
                     }
                     message.disableEmote = reader.bool();
                     continue;
-                case 7:
-                    if (tag !== 56) {
-                        break;
-                    }
-                    message.disableDoubleJump = reader.bool();
-                    continue;
-                case 8:
-                    if (tag !== 64) {
-                        break;
-                    }
-                    message.disableGliding = reader.bool();
-                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/dist-cjs/components/generated/pb/decentraland/sdk/components/tween.gen.d.ts

@@ -77,9 +77,6 @@ export interface PBTween {
     } | {
         $case: "textureMoveContinuous";
         textureMoveContinuous: TextureMoveContinuous;
-    } | {
-        $case: "moveRotateScale";
-        moveRotateScale: MoveRotateScale;
     } | undefined;
     /** default true (pause or running) */
     playing?: boolean | undefined;
@@ -108,17 +105,6 @@ export interface Scale {
     start: Vector3 | undefined;
     end: Vector3 | undefined;
 }
-/**
- * @public
- */
-export interface MoveRotateScale {
-    positionStart: Vector3 | undefined;
-    positionEnd: Vector3 | undefined;
-    rotationStart: Quaternion | undefined;
-    rotationEnd: Quaternion | undefined;
-    scaleStart: Vector3 | undefined;
-    scaleEnd: Vector3 | undefined;
-}
 /**
  * This tween mode allows to move the texture of a PbrMaterial or UnlitMaterial.
  * You can also specify the movement type (offset or tiling)
@@ -183,13 +169,6 @@ export declare namespace Scale {
     function encode(message: Scale, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): Scale;
 }
-/**
- * @public
- */
-export declare namespace MoveRotateScale {
-    function encode(message: MoveRotateScale, writer?: _m0.Writer): _m0.Writer;
-    function decode(input: _m0.Reader | Uint8Array, length?: number): MoveRotateScale;
-}
 /**
  * @public
  */

package/dist-cjs/components/generated/pb/decentraland/sdk/components/tween.gen.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextureMoveContinuous = exports.MoveContinuous = exports.RotateContinuous = exports.TextureMove = exports.MoveRotateScale = exports.Scale = exports.Rotate = exports.Move = exports.PBTween = exports.EasingFunction = exports.TextureMovementType = void 0;
+exports.TextureMoveContinuous = exports.MoveContinuous = exports.RotateContinuous = exports.TextureMove = exports.Scale = exports.Rotate = exports.Move = exports.PBTween = exports.EasingFunction = exports.TextureMovementType = void 0;
 /* eslint-disable */
 const minimal_1 = __importDefault(require("protobufjs/minimal"));
 const vectors_gen_1 = require("../../common/vectors.gen");
@@ -96,9 +96,6 @@ var PBTween;
             case "textureMoveContinuous":
                 TextureMoveContinuous.encode(message.mode.textureMoveContinuous, writer.uint32(90).fork()).ldelim();
                 break;
-            case "moveRotateScale":
-                MoveRotateScale.encode(message.mode.moveRotateScale, writer.uint32(98).fork()).ldelim();
-                break;
         }
         if (message.playing !== undefined) {
             writer.uint32(48).bool(message.playing);
@@ -176,12 +173,6 @@ var PBTween;
                         textureMoveContinuous: TextureMoveContinuous.decode(reader, reader.uint32()),
                     };
                     continue;
-                case 12:
-                    if (tag !== 98) {
-                        break;
-                    }
-                    message.mode = { $case: "moveRotateScale", moveRotateScale: MoveRotateScale.decode(reader, reader.uint32()) };
-                    continue;
                 case 6:
                     if (tag !== 48) {
                         break;
@@ -354,96 +345,6 @@ var Scale;
     }
     Scale.decode = decode;
 })(Scale = exports.Scale || (exports.Scale = {}));
-function createBaseMoveRotateScale() {
-    return {
-        positionStart: undefined,
-        positionEnd: undefined,
-        rotationStart: undefined,
-        rotationEnd: undefined,
-        scaleStart: undefined,
-        scaleEnd: undefined,
-    };
-}
-/**
- * @public
- */
-var MoveRotateScale;
-(function (MoveRotateScale) {
-    function encode(message, writer = minimal_1.default.Writer.create()) {
-        if (message.positionStart !== undefined) {
-            vectors_gen_1.Vector3.encode(message.positionStart, writer.uint32(10).fork()).ldelim();
-        }
-        if (message.positionEnd !== undefined) {
-            vectors_gen_1.Vector3.encode(message.positionEnd, writer.uint32(18).fork()).ldelim();
-        }
-        if (message.rotationStart !== undefined) {
-            vectors_gen_1.Quaternion.encode(message.rotationStart, writer.uint32(26).fork()).ldelim();
-        }
-        if (message.rotationEnd !== undefined) {
-            vectors_gen_1.Quaternion.encode(message.rotationEnd, writer.uint32(34).fork()).ldelim();
-        }
-        if (message.scaleStart !== undefined) {
-            vectors_gen_1.Vector3.encode(message.scaleStart, writer.uint32(42).fork()).ldelim();
-        }
-        if (message.scaleEnd !== undefined) {
-            vectors_gen_1.Vector3.encode(message.scaleEnd, writer.uint32(50).fork()).ldelim();
-        }
-        return writer;
-    }
-    MoveRotateScale.encode = encode;
-    function decode(input, length) {
-        const reader = input instanceof minimal_1.default.Reader ? input : minimal_1.default.Reader.create(input);
-        let end = length === undefined ? reader.len : reader.pos + length;
-        const message = createBaseMoveRotateScale();
-        while (reader.pos < end) {
-            const tag = reader.uint32();
-            switch (tag >>> 3) {
-                case 1:
-                    if (tag !== 10) {
-                        break;
-                    }
-                    message.positionStart = vectors_gen_1.Vector3.decode(reader, reader.uint32());
-                    continue;
-                case 2:
-                    if (tag !== 18) {
-                        break;
-                    }
-                    message.positionEnd = vectors_gen_1.Vector3.decode(reader, reader.uint32());
-                    continue;
-                case 3:
-                    if (tag !== 26) {
-                        break;
-                    }
-                    message.rotationStart = vectors_gen_1.Quaternion.decode(reader, reader.uint32());
-                    continue;
-                case 4:
-                    if (tag !== 34) {
-                        break;
-                    }
-                    message.rotationEnd = vectors_gen_1.Quaternion.decode(reader, reader.uint32());
-                    continue;
-                case 5:
-                    if (tag !== 42) {
-                        break;
-                    }
-                    message.scaleStart = vectors_gen_1.Vector3.decode(reader, reader.uint32());
-                    continue;
-                case 6:
-                    if (tag !== 50) {
-                        break;
-                    }
-                    message.scaleEnd = vectors_gen_1.Vector3.decode(reader, reader.uint32());
-                    continue;
-            }
-            if ((tag & 7) === 4 || tag === 0) {
-                break;
-            }
-            reader.skipType(tag & 7);
-        }
-        return message;
-    }
-    MoveRotateScale.decode = decode;
-})(MoveRotateScale = exports.MoveRotateScale || (exports.MoveRotateScale = {}));
 function createBaseTextureMove() {
     return { start: undefined, end: undefined, movementType: undefined };
 }

package/dist-cjs/components/index.d.ts

@@ -19,6 +19,7 @@ import { InputModifierComponentDefinitionExtended } from './extended/InputModifi
 import { LightSourceComponentDefinitionExtended } from './extended/LightSource';
 import { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';
 import { TagsComponentDefinitionExtended } from './manual/Tags';
+import { ICreatedByType } from './manual/CreatedBy';
 export * from './generated/index.gen';
 export type { GrowOnlyValueSetComponentDefinition, LastWriteWinElementSetComponentDefinition, LwwComponentGetter, GSetComponentGetter };
 export declare const Transform: LwwComponentGetter<TransformComponentExtended>;
@@ -50,4 +51,8 @@ export declare const NetworkEntity: (engine: Pick<IEngine, 'defineComponent'>) =
  * @alpha
  */
 export declare const NetworkParent: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<INetowrkParentType>;
+/**
+ * @public
+ */
+export declare const CreatedBy: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<ICreatedByType>;
 export { MediaState };

package/dist-cjs/components/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MediaState = exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.Tags = exports.Name = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.MeshCollider = exports.MeshRenderer = exports.AudioStream = exports.AudioSource = exports.Animator = exports.Material = exports.Transform = void 0;
+exports.MediaState = exports.CreatedBy = exports.NetworkParent = exports.NetworkEntity = exports.SyncComponents = exports.Tags = exports.Name = exports.TriggerArea = exports.LightSource = exports.InputModifier = exports.VirtualCamera = exports.Tween = exports.MeshCollider = exports.MeshRenderer = exports.AudioStream = exports.AudioSource = exports.Animator = exports.Material = exports.Transform = void 0;
 const Animator_1 = require("./extended/Animator");
 const AudioSource_1 = require("./extended/AudioSource");
 const Material_1 = require("./extended/Material");
@@ -37,6 +37,7 @@ const InputModifier_1 = require("./extended/InputModifier");
 const LightSource_1 = require("./extended/LightSource");
 const TriggerArea_1 = require("./extended/TriggerArea");
 const Tags_1 = __importDefault(require("./manual/Tags"));
+const CreatedBy_1 = __importDefault(require("./manual/CreatedBy"));
 __exportStar(require("./generated/index.gen"), exports);
 /* @__PURE__ */
 const Transform = (engine) => (0, Transform_1.defineTransformComponent)(engine);
@@ -92,12 +93,15 @@ exports.SyncComponents = SyncComponents;
 /**
  * @alpha
  */
-/* @__PURE__ */
 const NetworkEntity = (engine) => (0, NetworkEntity_1.default)(engine);
 exports.NetworkEntity = NetworkEntity;
 /**
  * @alpha
  */
-/* @__PURE__ */
 const NetworkParent = (engine) => (0, NetworkParent_1.default)(engine);
 exports.NetworkParent = NetworkParent;
+/**
+ * @public
+ */
+const CreatedBy = (engine) => (0, CreatedBy_1.default)(engine);
+exports.CreatedBy = CreatedBy;

package/dist-cjs/components/manual/CreatedBy.d.ts

@@ -0,0 +1,9 @@
+import { IEngine, LastWriteWinElementSetComponentDefinition } from '../../engine/types';
+export interface ICreatedByType {
+    address: string;
+}
+export type ICreatedBy = LastWriteWinElementSetComponentDefinition<ICreatedByType>;
+declare function defineCreatedBy(engine: Pick<IEngine, 'defineComponent'>): import("../../engine/types").MapComponentDefinition<import("../..").MapResult<{
+    address: import("../../schemas").ISchema<string>;
+}>>;
+export default defineCreatedBy;

package/dist-cjs/components/manual/CreatedBy.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const schemas_1 = require("../../schemas");
+function defineCreatedBy(engine) {
+    const CreatedBy = engine.defineComponent('core-schema::Created-By', {
+        address: schemas_1.Schemas.String
+    });
+    return CreatedBy;
+}
+exports.default = defineCreatedBy;

package/dist-cjs/components/manual/Transform.d.ts

@@ -1,5 +1,6 @@
 import { LastWriteWinElementSetComponentDefinition, IEngine } from '../../engine';
 import { Entity } from '../../engine/entity';
+import type { ISchema } from '../../schemas/ISchema';
 /**
  * @public
  */
@@ -11,6 +12,10 @@ export interface TransformComponentExtended extends TransformComponent {
     create(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
     createOrReplace(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
 }
+/**
+ * @public
+ */
+export declare const COMPONENT_ID = 1;
 /**
  * @public
  */
@@ -33,6 +38,10 @@ export type TransformType = {
     };
     parent?: Entity;
 };
+/** @public */
+export declare const TRANSFORM_LENGTH = 44;
+/** @public */
+export declare const TransformSchema: ISchema<TransformType>;
 /**
  * @public
  */

package/dist-cjs/components/manual/Transform.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineTransformComponent = exports.TransformSchema = exports.TRANSFORM_LENGTH = exports.COMPONENT_ID = void 0;
 /**
- * @internal
+ * @public
  */
 exports.COMPONENT_ID = 1;
-/** @internal */
+/** @public */
 exports.TRANSFORM_LENGTH = 44;
-/** @internal */
+/** @public */
 exports.TransformSchema = {
     serialize(value, builder) {
         const ptr = builder.incrementWriteOffset(exports.TRANSFORM_LENGTH);

package/dist-cjs/components/types.d.ts

@@ -4,7 +4,7 @@ export type { AudioStreamComponentDefinitionExtended } from './extended/AudioStr
 export type { MeshRendererComponentDefinitionExtended } from './extended/MeshRenderer';
 export type { MeshColliderComponentDefinitionExtended } from './extended/MeshCollider';
 export type { TextureHelper, MaterialComponentDefinitionExtended, FlatTexture, ReadonlyFlatMaterial, ReadonlyFlatTexture, FlatMaterial } from './extended/Material';
-export type { TweenHelper, TweenComponentDefinitionExtended, SetMoveRotateScaleParams, MoveRotateScaleModeParams } from './extended/Tween';
+export type { TweenHelper, TweenComponentDefinitionExtended } from './extended/Tween';
 export type { CameraTransitionHelper, VirtualCameraComponentDefinitionExtended } from './extended/VirtualCamera';
 export type { TransformComponentExtended, TransformTypeWithOptionals } from './manual/Transform';
 export type { NameComponent, NameType } from './manual/Name';
@@ -12,6 +12,7 @@ export type { TagsComponentDefinitionExtended, TagsType } from './manual/Tags';
 export type { ISyncComponents, ISyncComponentsType } from './manual/SyncComponents';
 export type { INetowrkEntity, INetowrkEntityType } from './manual/NetworkEntity';
 export type { INetowrkParent, INetowrkParentType } from './manual/NetworkParent';
+export type { ICreatedBy, ICreatedByType } from './manual/CreatedBy';
 export type { InputModifierHelper, InputModifierComponentDefinitionExtended } from './extended/InputModifier';
 export type { LightSourceHelper, LightSourceComponentDefinitionExtended } from './extended/LightSource';
 export type { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';

package/dist-cjs/engine/component.d.ts

@@ -1,6 +1,6 @@
 import { ISchema } from '../schemas';
 import { ByteBuffer } from '../serialization/ByteBuffer';
-import { CrdtMessageBody, DeleteComponentMessageBody, PutComponentMessageBody } from '../serialization/crdt';
+import { CrdtMessageBody, DeleteComponentMessageBody, ProcessMessageResultType, PutComponentMessageBody } from '../serialization/crdt';
 import { Entity } from './entity';
 import { DeepReadonly, DeepReadonlySet } from './readonly';
 /**
@@ -70,7 +70,58 @@ export interface BaseComponent<T> {
      * If the value is undefined, the component was deleted.
      */
     onChange(entity: Entity, cb: (value: T | undefined) => void): void;
+    /**
+     * @public
+     *
+     */
+    validateBeforeChange(entity: Entity, cb: ValidateCallback<T>): void;
+    validateBeforeChange(cb: ValidateCallback<T>): void;
+    /**
+     * Get the CRDT state for an entity (serialized data and timestamp)
+     * @param entity - Entity to get the CRDT state for
+     * @returns Object with serialized data and timestamp, or null if entity doesn't have the component
+     * @public
+     */
+    getCrdtState(entity: Entity): {
+        data: Uint8Array;
+        timestamp: number;
+    } | null;
+}
+/**
+ * Internal component interface that exposes all internal methods for SDK use
+ * This is not exposed to users, only for internal SDK operations
+ */
+export interface InternalBaseComponent<T> extends BaseComponent<T> {
+    /**
+     * @public
+     * Dry run update to check if a CRDT message would be accepted without actually applying it
+     */
+    __dry_run_updateFromCrdt(body: CrdtMessageBody): ProcessMessageResultType;
+    /**
+     * @public
+     * Get the iterator to every entity has the component
+     */
+    iterator(): Iterable<[Entity, any]>;
+    /**
+     * @public
+     */
+    dirtyIterator(): Iterable<Entity>;
+    /**
+     * @public
+     */
+    __onChangeCallbacks(entity: Entity, value: T): void;
+    /**
+     * @public
+     */
+    __run_validateBeforeChange(entity: Entity, newValue: T | undefined, senderAddress: string, createdBy: string): boolean;
 }
+export type ValidateCallback<T> = (value: {
+    entity: Entity;
+    currentValue: T | undefined;
+    newValue: T | undefined;
+    senderAddress: string;
+    createdBy: string;
+}) => boolean;
 /**
  * @public
  */

package/dist-cjs/engine/grow-only-value-set-component-definition.js

@@ -5,6 +5,7 @@ const ByteBuffer_1 = require("../serialization/ByteBuffer");
 const crdt_1 = require("../serialization/crdt");
 const invariant_1 = require("../runtime/invariant");
 const emptyReadonlySet = freezeSet(new Set());
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
 function frozenError() {
     throw new Error('The set is frozen');
 }
@@ -25,6 +26,7 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
     const dirtyIterator = new Set();
     const queuedCommands = [];
     const onChangeCallbacks = new Map();
+    const validateCallbacks = new Map();
     // only sort the array if the latest (N) element has a timestamp <= N-1
     function shouldSort(row) {
         const len = row.raw.length;
@@ -83,8 +85,11 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
         has(entity) {
             return data.has(entity);
         },
-        entityDeleted(entity) {
+        entityDeleted(entity, markAsDirty) {
             data.delete(entity);
+            if (markAsDirty) {
+                // For grow-only sets, we don't need to mark as dirty since deletion doesn't generate CRDT messages
+            }
         },
         get(entity) {
             const values = data.get(entity);
@@ -155,6 +160,44 @@ function createValueSetComponentDefinitionFromSchema(componentName, componentId,
             for (const cb of cbs) {
                 cb(value);
             }
+        },
+        __dry_run_updateFromCrdt(_body) {
+            return crdt_1.ProcessMessageResultType.StateUpdatedData;
+        },
+        validateBeforeChange(entityOrCb, cb) {
+            if (arguments.length === 1) {
+                // Second overload: just callback (global validation)
+                validateCallbacks.set(__GLOBAL_ENTITY, entityOrCb);
+            }
+            else {
+                if (cb) {
+                    validateCallbacks.set(entityOrCb, cb);
+                }
+            }
+        },
+        __run_validateBeforeChange(entity, newValue, senderAddress, createdBy) {
+            const cb = entity && validateCallbacks.get(entity);
+            const globalCb = validateCallbacks.get(__GLOBAL_ENTITY);
+            const currentValue = [...this.get(entity).values()];
+            const value = { entity, currentValue: currentValue, newValue, senderAddress, createdBy };
+            const globalResult = globalCb?.(value) ?? true;
+            const entityResult = (globalResult && cb?.(value)) ?? true;
+            return globalResult && entityResult;
+        },
+        getCrdtState(entity) {
+            const row = data.get(entity);
+            if (!row || row.raw.length === 0) {
+                return null;
+            }
+            // For GrowOnlySet, we need to return the complete CRDT messages for all values
+            // This is complex because GrowOnlySet uses APPEND messages, not a single PUT
+            // For now, return null to indicate this component type doesn't support simple corrections
+            return null;
+        },
+        __forceUpdateFromCrdt(_msg) {
+            // GrowOnlySet doesn't support authoritative corrections in the same way as LWW
+            // since it uses APPEND_VALUE messages instead of PUT_COMPONENT messages
+            return [null, undefined];
         }
     };
     return ret;

package/dist-cjs/engine/lww-element-set-component-definition.d.ts

@@ -1,8 +1,10 @@
 import { ISchema } from '../schemas';
 import { ByteBuffer } from '../serialization/ByteBuffer';
-import { PutComponentMessageBody, DeleteComponentMessageBody, CrdtMessageBody } from '../serialization/crdt';
+import { PutComponentMessageBody, DeleteComponentMessageBody, ProcessMessageResultType, CrdtMessageBody, PutNetworkComponentMessageBody, DeleteComponentNetworkMessageBody, AuthoritativePutComponentMessageBody } from '../serialization/crdt';
 import { Entity } from './entity';
 export declare function incrementTimestamp(entity: Entity, timestamps: Map<Entity, number>): number;
 export declare function createDumpLwwFunctionFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (buffer: ByteBuffer, filterEntity?: ((entity: Entity) => boolean) | undefined) => void;
+export declare function createCrdtRuleValidator(timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (message: PutComponentMessageBody | DeleteComponentMessageBody | PutNetworkComponentMessageBody | DeleteComponentNetworkMessageBody) => ProcessMessageResultType;
+export declare function createForceUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (msg: AuthoritativePutComponentMessageBody) => [null, any];
 export declare function createUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>): (msg: CrdtMessageBody) => [null | PutComponentMessageBody | DeleteComponentMessageBody, any];
 export declare function createGetCrdtMessagesForLww(componentId: number, timestamps: Map<Entity, number>, dirtyIterator: Set<Entity>, schema: Pick<ISchema<any>, 'serialize'>, data: Map<Entity, unknown>): () => Generator<PutComponentMessageBody | DeleteComponentMessageBody, void, unknown>;

package/dist-cjs/engine/lww-element-set-component-definition.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createComponentDefinitionFromSchema = exports.createGetCrdtMessagesForLww = exports.createUpdateLwwFromCrdt = exports.createDumpLwwFunctionFromCrdt = exports.incrementTimestamp = void 0;
+exports.createComponentDefinitionFromSchema = exports.createGetCrdtMessagesForLww = exports.createUpdateLwwFromCrdt = exports.createForceUpdateLwwFromCrdt = exports.createCrdtRuleValidator = exports.createDumpLwwFunctionFromCrdt = exports.incrementTimestamp = void 0;
 const ByteBuffer_1 = require("../serialization/ByteBuffer");
 const crdt_1 = require("../serialization/crdt");
 const utils_1 = require("../systems/crdt/utils");
@@ -35,16 +35,12 @@ function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data) {
     };
 }
 exports.createDumpLwwFunctionFromCrdt = createDumpLwwFunctionFromCrdt;
-function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
+function createCrdtRuleValidator(timestamps, schema, data) {
     /**
-     * Process the received message only if the lamport number recieved is higher
-     * than the stored one. If its lower, we spread it to the network to correct the peer.
-     * If they are equal, the bigger raw data wins.
-  
-      * Returns the recieved data if the lamport number was bigger than ours.
-      * If it was an outdated message, then we return void
-      * @public
-      */
+     * Shared CRDT conflict resolution logic
+     * @public
+     */
     function crdtRuleForCurrentState(message) {
         const { entityId, timestamp } = message;
         const currentTimestamp = timestamps.get(entityId);
@@ -54,7 +50,6 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
         }
         // Outdated Message. Resend our state message through the wire.
         if (currentTimestamp > timestamp) {
-            // console.log('2', currentTimestamp, timestamp)
             return crdt_1.ProcessMessageResultType.StateOutdatedTimestamp;
         }
         // Deletes are idempotent
@@ -71,7 +66,6 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
             currentDataGreater = (0, utils_1.dataCompare)(null, message.data);
         }
         // Same data, same timestamp. Weirdo echo message.
-        // console.log('3', currentDataGreater, writeBuffer.toBinary(), (message as any).data || null)
         if (currentDataGreater === 0) {
             return crdt_1.ProcessMessageResultType.NoChanges;
         }
@@ -80,10 +74,37 @@ function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
             return crdt_1.ProcessMessageResultType.StateOutdatedData;
         }
         else {
-            // Curent data is lower
+            // Current data is lower
             return crdt_1.ProcessMessageResultType.StateUpdatedData;
         }
     }
+    return crdtRuleForCurrentState;
+}
+exports.createCrdtRuleValidator = createCrdtRuleValidator;
+function createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+    /**
+     * Force update component state regardless of timestamp - used for server authoritative messages
+     */
+    return (msg) => {
+        const buffer = new ByteBuffer_1.ReadWriteByteBuffer(msg.data);
+        const deserializedValue = schema.deserialize(buffer);
+        data.set(msg.entityId, deserializedValue);
+        timestamps.set(msg.entityId, msg.timestamp);
+        return [null, deserializedValue];
+    };
+}
+exports.createForceUpdateLwwFromCrdt = createForceUpdateLwwFromCrdt;
+function createUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+    /**
+     * Process the received message only if the lamport number recieved is higher
+     * than the stored one. If its lower, we spread it to the network to correct the peer.
+     * If they are equal, the bigger raw data wins.
+  
+      * Returns the recieved data if the lamport number was bigger than ours.
+      * If it was an outdated message, then we return void
+      * @public
+      */
+    const crdtRuleForCurrentState = createCrdtRuleValidator(timestamps, schema, data);
     return (msg) => {
         /* istanbul ignore next */
         if (msg.type !== crdt_1.CrdtMessageType.PUT_COMPONENT &&
@@ -178,6 +199,7 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
     const dirtyIterator = new Set();
     const timestamps = new Map();
     const onChangeCallbacks = new Map();
+    const validateCallbacks = new Map();
     return {
         get componentId() {
             return componentId;
@@ -269,7 +291,39 @@ function createComponentDefinitionFromSchema(componentName, componentId, schema)
         },
         getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data),
         updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data),
+        __forceUpdateFromCrdt: createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data),
+        __dry_run_updateFromCrdt: createCrdtRuleValidator(timestamps, schema, data),
         dumpCrdtStateToBuffer: createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, data),
+        validateBeforeChange(entityOrCb, cb) {
+            if (arguments.length === 1) {
+                // Second overload: just callback (global validation)
+                validateCallbacks.set(__GLOBAL_ENTITY, entityOrCb);
+            }
+            else {
+                if (cb) {
+                    validateCallbacks.set(entityOrCb, cb);
+                }
+            }
+        },
+        __run_validateBeforeChange(entity, newValue, senderAddress, createdBy) {
+            const cb = entity && validateCallbacks.get(entity);
+            const globalCb = validateCallbacks.get(__GLOBAL_ENTITY);
+            const currentValue = data.get(entity);
+            const value = { entity, currentValue, newValue, senderAddress, createdBy };
+            const globalResult = globalCb?.(value) ?? true;
+            const entityResult = (globalResult && cb?.(value)) ?? true;
+            return globalResult && entityResult;
+        },
+        getCrdtState(entity) {
+            const componentData = data.get(entity);
+            const timestamp = timestamps.get(entity);
+            if (componentData && timestamp !== undefined) {
+                const buffer = new ByteBuffer_1.ReadWriteByteBuffer();
+                schema.serialize((0, readonly_1.deepReadonly)(componentData), buffer);
+                return { data: buffer.toBinary(), timestamp };
+            }
+            return null;
+        },
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];
             cbs.push(cb);

package/dist-cjs/index.d.ts

@@ -1,6 +1,5 @@
 export * from './engine';
 export * from './schemas';
-export * from './runtime/globals';
 export * from './runtime/initialization';
 export * from './runtime/types';
 export * from './runtime/helpers';
@@ -14,7 +13,7 @@ export * from './systems/tween';
 export * from './systems/triggerArea';
 export * from './engine/entity';
 export * from './components/types';
-import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended } from './components/types';
+import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ICreatedBy } from './components/types';
 import { NameComponent } from './components/manual/Name';
 import { TagsComponentDefinitionExtended } from './components/manual/Tags';
 export declare const Transform: TransformComponentExtended;
@@ -47,6 +46,7 @@ export declare const NetworkEntity: INetowrkEntity;
  * Tag a entity to be syncronized through comms
  */
 export declare const NetworkParent: INetowrkParent;
+export declare const CreatedBy: ICreatedBy;
 export * from './components/generated/global.gen';
 export * from './components/generated/types.gen';
 export * from './serialization/crdt';