@dcl/ecs 7.22.4 → 7.22.5-24779418349.commit-111fd7e

package/dist-cjs/components/generated/pb/decentraland/common/colors.gen.d.ts

@@ -16,14 +16,6 @@ export interface Color4 {
     b: number;
     a: number;
 }
-/** A range of Color4 values. Randomized or lerped between start and end. */
-/**
- * @public
- */
-export interface ColorRange {
-    start: Color4 | undefined;
-    end: Color4 | undefined;
-}
 /**
  * @public
  */
@@ -38,10 +30,3 @@ export declare namespace Color4 {
     function encode(message: Color4, writer?: _m0.Writer): _m0.Writer;
     function decode(input: _m0.Reader | Uint8Array, length?: number): Color4;
 }
-/**
- * @public
- */
-export declare namespace ColorRange {
-    function encode(message: ColorRange, writer?: _m0.Writer): _m0.Writer;
-    function decode(input: _m0.Reader | Uint8Array, length?: number): ColorRange;
-}

package/dist-cjs/components/generated/pb/decentraland/common/colors.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.ColorRange = exports.Color4 = exports.Color3 = void 0;
+exports.Color4 = exports.Color3 = void 0;
 /* eslint-disable */
 const minimal_1 = __importDefault(require("protobufjs/minimal"));
 const protobufPackageSarasa = "decentraland.common";
@@ -128,50 +128,3 @@ var Color4;
     }
     Color4.decode = decode;
 })(Color4 = exports.Color4 || (exports.Color4 = {}));
-function createBaseColorRange() {
-    return { start: undefined, end: undefined };
-}
-/**
- * @public
- */
-var ColorRange;
-(function (ColorRange) {
-    function encode(message, writer = minimal_1.default.Writer.create()) {
-        if (message.start !== undefined) {
-            Color4.encode(message.start, writer.uint32(10).fork()).ldelim();
-        }
-        if (message.end !== undefined) {
-            Color4.encode(message.end, writer.uint32(18).fork()).ldelim();
-        }
-        return writer;
-    }
-    ColorRange.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 = createBaseColorRange();
-        while (reader.pos < end) {
-            const tag = reader.uint32();
-            switch (tag >>> 3) {
-                case 1:
-                    if (tag !== 10) {
-                        break;
-                    }
-                    message.start = Color4.decode(reader, reader.uint32());
-                    continue;
-                case 2:
-                    if (tag !== 18) {
-                        break;
-                    }
-                    message.end = Color4.decode(reader, reader.uint32());
-                    continue;
-            }
-            if ((tag & 7) === 4 || tag === 0) {
-                break;
-            }
-            reader.skipType(tag & 7);
-        }
-        return message;
-    }
-    ColorRange.decode = decode;
-})(ColorRange = exports.ColorRange || (exports.ColorRange = {}));

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

@@ -25,14 +25,5 @@ export declare const enum PointerEventType {
     PET_UP = 0,
     PET_DOWN = 1,
     PET_HOVER_ENTER = 2,
-    PET_HOVER_LEAVE = 3,
-    PET_PROXIMITY_ENTER = 4,
-    PET_PROXIMITY_LEAVE = 5
-}
-/**
- * @public
- */
-export declare const enum InteractionType {
-    CURSOR = 0,
-    PROXIMITY = 1
+    PET_HOVER_LEAVE = 3
 }

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

@@ -1,7 +1,7 @@
 "use strict";
 /* eslint-disable */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InteractionType = exports.PointerEventType = exports.InputAction = void 0;
+exports.PointerEventType = exports.InputAction = void 0;
 const protobufPackageSarasa = "decentraland.sdk.components.common";
 /**
  * @public
@@ -33,14 +33,4 @@ var PointerEventType;
     PointerEventType[PointerEventType["PET_DOWN"] = 1] = "PET_DOWN";
     PointerEventType[PointerEventType["PET_HOVER_ENTER"] = 2] = "PET_HOVER_ENTER";
     PointerEventType[PointerEventType["PET_HOVER_LEAVE"] = 3] = "PET_HOVER_LEAVE";
-    PointerEventType[PointerEventType["PET_PROXIMITY_ENTER"] = 4] = "PET_PROXIMITY_ENTER";
-    PointerEventType[PointerEventType["PET_PROXIMITY_LEAVE"] = 5] = "PET_PROXIMITY_LEAVE";
 })(PointerEventType = exports.PointerEventType || (exports.PointerEventType = {}));
-/**
- * @public
- */
-var InteractionType;
-(function (InteractionType) {
-    InteractionType[InteractionType["CURSOR"] = 0] = "CURSOR";
-    InteractionType[InteractionType["PROXIMITY"] = 1] = "PROXIMITY";
-})(InteractionType = exports.InteractionType || (exports.InteractionType = {}));

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

@@ -1,5 +1,5 @@
 import _m0 from "protobufjs/minimal";
-import { InputAction, InteractionType, PointerEventType } from "./common/input_action.gen";
+import { InputAction, PointerEventType } from "./common/input_action.gen";
 /**
  * PointerEvents adds configurable pointer-based interactions to the attached Entity.
  *
@@ -61,8 +61,6 @@ export interface PBPointerEvents_Info {
     showHighlight?: boolean | undefined;
     /** range of interaction from the avatar's position (default 0) */
     maxPlayerDistance?: number | undefined;
-    /** resolution order when multiple events overlap, higher wins (default 0) */
-    priority?: number | undefined;
 }
 /**
  * @public
@@ -72,8 +70,6 @@ export interface PBPointerEvents_Entry {
     eventType: PointerEventType;
     /** additional configuration for this detection */
     eventInfo: PBPointerEvents_Info | undefined;
-    /** the type of interaction source (default 0 == CURSOR) */
-    interactionType?: InteractionType | undefined;
 }
 /**
  * @public

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

@@ -53,7 +53,6 @@ function createBasePBPointerEvents_Info() {
         showFeedback: undefined,
         showHighlight: undefined,
         maxPlayerDistance: undefined,
-        priority: undefined,
     };
 }
 /**
@@ -80,9 +79,6 @@ var PBPointerEvents_Info;
         if (message.maxPlayerDistance !== undefined) {
             writer.uint32(53).float(message.maxPlayerDistance);
         }
-        if (message.priority !== undefined) {
-            writer.uint32(56).uint32(message.priority);
-        }
         return writer;
     }
     PBPointerEvents_Info.encode = encode;
@@ -129,12 +125,6 @@ var PBPointerEvents_Info;
                     }
                     message.maxPlayerDistance = reader.float();
                     continue;
-                case 7:
-                    if (tag !== 56) {
-                        break;
-                    }
-                    message.priority = reader.uint32();
-                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;
@@ -146,7 +136,7 @@ var PBPointerEvents_Info;
     PBPointerEvents_Info.decode = decode;
 })(PBPointerEvents_Info = exports.PBPointerEvents_Info || (exports.PBPointerEvents_Info = {}));
 function createBasePBPointerEvents_Entry() {
-    return { eventType: 0, eventInfo: undefined, interactionType: undefined };
+    return { eventType: 0, eventInfo: undefined };
 }
 /**
  * @public
@@ -160,9 +150,6 @@ var PBPointerEvents_Entry;
         if (message.eventInfo !== undefined) {
             PBPointerEvents_Info.encode(message.eventInfo, writer.uint32(18).fork()).ldelim();
         }
-        if (message.interactionType !== undefined) {
-            writer.uint32(24).int32(message.interactionType);
-        }
         return writer;
     }
     PBPointerEvents_Entry.encode = encode;
@@ -185,12 +172,6 @@ var PBPointerEvents_Entry;
                     }
                     message.eventInfo = PBPointerEvents_Info.decode(reader, reader.uint32());
                     continue;
-                case 3:
-                    if (tag !== 24) {
-                        break;
-                    }
-                    message.interactionType = reader.int32();
-                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

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

@@ -1,6 +1,5 @@
 export type { Position as PBPosition, Vector2 as PBVector2, Vector3 as PBVector3, Quaternion as PBQuaternion } from './pb/decentraland/common/vectors.gen';
 export type { Color3 as PBColor3, Color4 as PBColor4 } from './pb/decentraland/common/colors.gen';
-export { ColorRange } from './pb/decentraland/common/colors.gen';
 export * from './pb/decentraland/sdk/components/common/camera_transition.gen';
 export * from './pb/decentraland/sdk/components/common/camera_type.gen';
 export * from './pb/decentraland/sdk/components/common/input_action.gen';
@@ -9,5 +8,4 @@ export * from './pb/decentraland/sdk/components/common/media_state.gen';
 export * from './pb/decentraland/sdk/components/common/raycast_hit.gen';
 export * from './pb/decentraland/sdk/components/common/texts.gen';
 export * from './pb/decentraland/common/border_rect.gen';
-export * from './pb/decentraland/common/floats.gen';
 export * from './pb/decentraland/common/texture.gen';

package/dist-cjs/components/generated/types.gen.js

@@ -14,9 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ColorRange = void 0;
-var colors_gen_1 = require("./pb/decentraland/common/colors.gen");
-Object.defineProperty(exports, "ColorRange", { enumerable: true, get: function () { return colors_gen_1.ColorRange; } });
 __exportStar(require("./pb/decentraland/sdk/components/common/camera_transition.gen"), exports);
 // export { PbCameraTransition }
 __exportStar(require("./pb/decentraland/sdk/components/common/camera_type.gen"), exports);
@@ -33,7 +30,5 @@ __exportStar(require("./pb/decentraland/sdk/components/common/texts.gen"), expor
 // export { PbTexts }
 __exportStar(require("./pb/decentraland/common/border_rect.gen"), exports);
 // export { PbBorderRect }
-__exportStar(require("./pb/decentraland/common/floats.gen"), exports);
-// export { PbFloats }
 __exportStar(require("./pb/decentraland/common/texture.gen"), exports);
 // export { PbTexture }

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

@@ -18,8 +18,8 @@ import { VirtualCameraComponentDefinitionExtended } from './extended/VirtualCame
 import { InputModifierComponentDefinitionExtended } from './extended/InputModifier';
 import { LightSourceComponentDefinitionExtended } from './extended/LightSource';
 import { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';
-import { ParticleSystemComponentDefinitionExtended } from './extended/ParticleSystem';
 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>;
@@ -34,7 +34,6 @@ export declare const VirtualCamera: LwwComponentGetter<VirtualCameraComponentDef
 export declare const InputModifier: LwwComponentGetter<InputModifierComponentDefinitionExtended>;
 export declare const LightSource: LwwComponentGetter<LightSourceComponentDefinitionExtended>;
 export declare const TriggerArea: LwwComponentGetter<TriggerAreaComponentDefinitionExtended>;
-export declare const ParticleSystem: LwwComponentGetter<ParticleSystemComponentDefinitionExtended>;
 /**
  * @alpha
  */
@@ -52,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.ParticleSystem = 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");
@@ -36,8 +36,8 @@ const VirtualCamera_1 = require("./extended/VirtualCamera");
 const InputModifier_1 = require("./extended/InputModifier");
 const LightSource_1 = require("./extended/LightSource");
 const TriggerArea_1 = require("./extended/TriggerArea");
-const ParticleSystem_1 = require("./extended/ParticleSystem");
 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);
@@ -75,9 +75,6 @@ exports.LightSource = LightSource;
 /* @__PURE__ */
 const TriggerArea = (engine) => (0, TriggerArea_1.defineTriggerAreaComponent)(engine);
 exports.TriggerArea = TriggerArea;
-/* @__PURE__ */
-const ParticleSystem = (engine) => (0, ParticleSystem_1.defineParticleSystemComponent)(engine);
-exports.ParticleSystem = ParticleSystem;
 /**
  * @alpha
  */
@@ -96,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,6 +1,6 @@
 import { LastWriteWinElementSetComponentDefinition, IEngine } from '../../engine';
 import { Entity } from '../../engine/entity';
-import type { Vector3Type } from '../../schemas/custom/Vector3';
+import type { ISchema } from '../../schemas/ISchema';
 /**
  * @public
  */
@@ -11,19 +11,11 @@ export type TransformComponent = LastWriteWinElementSetComponentDefinition<Trans
 export interface TransformComponentExtended extends TransformComponent {
     create(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
     createOrReplace(entity: Entity, val?: TransformTypeWithOptionals): TransformType;
-    /**
-     * Transforms a direction vector from an entity's local coordinate space
-     * to world space, accounting for the full parent hierarchy.
-     *
-     * This applies only rotation (not translation or scale) — suitable for
-     * direction vectors like force/impulse directions.
-     *
-     * @param entity - The source entity whose local space defines the direction
-     * @param localDirection - Direction vector in the entity's local coordinates
-     * @returns The direction vector in world coordinates
-     */
-    localToWorldDirection(entity: Entity, localDirection: Vector3Type): Vector3Type;
 }
+/**
+ * @public
+ */
+export declare const COMPONENT_ID = 1;
 /**
  * @public
  */
@@ -46,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

@@ -1,40 +1,13 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineTransformComponent = exports.TransformSchema = exports.TRANSFORM_LENGTH = exports.COMPONENT_ID = void 0;
-// Use import * to safely handle circular dependency (tree.ts → components → Transform.ts → tree.ts).
-// With import *, the namespace object's properties are resolved at access time (live bindings in ESM,
-// getters via __importStar in CJS), so by the time methods are called all exports are available.
-const treeHelpers = __importStar(require("../../runtime/helpers/tree"));
 /**
- * @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);
@@ -131,10 +104,6 @@ function defineTransformComponent(engine) {
         },
         createOrReplace(entity, val) {
             return transformDef.createOrReplace(entity, exports.TransformSchema.extend(val));
-        },
-        localToWorldDirection(entity, localDirection) {
-            const worldRotation = treeHelpers.getWorldRotation(engine, entity);
-            return treeHelpers.rotateVectorByQuaternion(localDirection, worldRotation);
         }
     };
 }

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

@@ -12,7 +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';
-export type { ParticleSystemHelper, ParticleSystemComponentDefinitionExtended, ParticleSystemBlendMode, ParticleSystemPlaybackState } from './extended/ParticleSystem';

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 createUpdateLwwFromCrdt(componentId: number, timestamps: Map<Entity, number>, schema: Pick<ISchema<any>, 'serialize' | 'deserialize'>, data: Map<Entity, unknown>, lastSentData: Map<Entity, Uint8Array>): (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>, lastSentData: Map<Entity, Uint8Array>): () => Generator<PutComponentMessageBody | DeleteComponentMessageBody, void, unknown>;
+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>;