@dcl/ecs 7.29.1-35978346337.commit-823107b → 7.29.1-36041177279.commit-502e633

package/dist/components/generated/component-names.gen.js

@@ -22,7 +22,6 @@ export const coreComponentMappings = {
     "core::CameraMode": 1072,
     "core::CameraModeArea": 1071,
     "core::EngineInfo": 1048,
-    "core::ExplorerItemPurchaseResult": 1222,
     "core::ExplorerUiEventsResult": 1220,
     "core::GltfContainer": 1041,
     "core::GltfContainerLoadingState": 1049,

package/dist/components/generated/global.gen.d.ts

@@ -18,7 +18,6 @@ import { PBBillboard } from './pb/decentraland/sdk/components/billboard.gen';
 import { PBCameraMode } from './pb/decentraland/sdk/components/camera_mode.gen';
 import { PBCameraModeArea } from './pb/decentraland/sdk/components/camera_mode_area.gen';
 import { PBEngineInfo } from './pb/decentraland/sdk/components/engine_info.gen';
-import { PBExplorerItemPurchaseResult } from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 import { PBExplorerUiEventsResult } from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 import { PBGltfContainer } from './pb/decentraland/sdk/components/gltf_container.gen';
 import { PBGltfContainerLoadingState } from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -76,7 +75,6 @@ import { PBVisibilityComponent } from './pb/decentraland/sdk/components/visibili
 /** @public */ export declare const CameraMode: LastWriteWinElementSetComponentDefinition<PBCameraMode>;
 /** @public */ export declare const CameraModeArea: LastWriteWinElementSetComponentDefinition<PBCameraModeArea>;
 /** @public */ export declare const EngineInfo: LastWriteWinElementSetComponentDefinition<PBEngineInfo>;
-/** @public */ export declare const ExplorerItemPurchaseResult: GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>;
 /** @public */ export declare const ExplorerUiEventsResult: GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>;
 /** @public */ export declare const GltfContainer: LastWriteWinElementSetComponentDefinition<PBGltfContainer>;
 /** @public */ export declare const GltfContainerLoadingState: LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>;

package/dist/components/generated/global.gen.js

@@ -19,7 +19,6 @@ export * from './index.gen';
 /** @public */ export const CameraMode = /* @__PURE__ */ components.CameraMode(engine);
 /** @public */ export const CameraModeArea = /* @__PURE__ */ components.CameraModeArea(engine);
 /** @public */ export const EngineInfo = /* @__PURE__ */ components.EngineInfo(engine);
-/** @public */ export const ExplorerItemPurchaseResult = /* @__PURE__ */ components.ExplorerItemPurchaseResult(engine);
 /** @public */ export const ExplorerUiEventsResult = /* @__PURE__ */ components.ExplorerUiEventsResult(engine);
 /** @public */ export const GltfContainer = /* @__PURE__ */ components.GltfContainer(engine);
 /** @public */ export const GltfContainerLoadingState = /* @__PURE__ */ components.GltfContainerLoadingState(engine);

package/dist/components/generated/index.gen.d.ts

@@ -19,7 +19,6 @@ import { PBBillboard } from './pb/decentraland/sdk/components/billboard.gen';
 import { PBCameraMode } from './pb/decentraland/sdk/components/camera_mode.gen';
 import { PBCameraModeArea } from './pb/decentraland/sdk/components/camera_mode_area.gen';
 import { PBEngineInfo } from './pb/decentraland/sdk/components/engine_info.gen';
-import { PBExplorerItemPurchaseResult } from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 import { PBExplorerUiEventsResult } from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 import { PBGltfContainer } from './pb/decentraland/sdk/components/gltf_container.gen';
 import { PBGltfContainerLoadingState } from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -82,7 +81,6 @@ export * from './pb/decentraland/sdk/components/billboard.gen';
 export * from './pb/decentraland/sdk/components/camera_mode.gen';
 export * from './pb/decentraland/sdk/components/camera_mode_area.gen';
 export * from './pb/decentraland/sdk/components/engine_info.gen';
-export * from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 export * from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 export * from './pb/decentraland/sdk/components/gltf_container.gen';
 export * from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -147,7 +145,6 @@ export type GSetComponentGetter<T extends GrowOnlyValueSetComponentDefinition<an
 /** @public */ export declare const CameraMode: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
 /** @public */ export declare const CameraModeArea: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
 /** @public */ export declare const EngineInfo: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
-/** @public */ export declare const ExplorerItemPurchaseResult: GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>>;
 /** @public */ export declare const ExplorerUiEventsResult: GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>>;
 /** @public */ export declare const GltfContainer: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
 /** @public */ export declare const GltfContainerLoadingState: LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;
@@ -212,7 +209,6 @@ export declare const componentDefinitionByName: {
     "core::CameraMode": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraMode>>;
     "core::CameraModeArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBCameraModeArea>>;
     "core::EngineInfo": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBEngineInfo>>;
-    "core::ExplorerItemPurchaseResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerItemPurchaseResult>>;
     "core::ExplorerUiEventsResult": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBExplorerUiEventsResult>>;
     "core::GltfContainer": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainer>>;
     "core::GltfContainerLoadingState": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBGltfContainerLoadingState>>;

package/dist/components/generated/index.gen.js

@@ -17,7 +17,6 @@ import { BillboardSchema } from './Billboard.gen';
 import { CameraModeSchema } from './CameraMode.gen';
 import { CameraModeAreaSchema } from './CameraModeArea.gen';
 import { EngineInfoSchema } from './EngineInfo.gen';
-import { ExplorerItemPurchaseResultSchema } from './ExplorerItemPurchaseResult.gen';
 import { ExplorerUiEventsResultSchema } from './ExplorerUiEventsResult.gen';
 import { GltfContainerSchema } from './GltfContainer.gen';
 import { GltfContainerLoadingStateSchema } from './GltfContainerLoadingState.gen';
@@ -80,7 +79,6 @@ export * from './pb/decentraland/sdk/components/billboard.gen';
 export * from './pb/decentraland/sdk/components/camera_mode.gen';
 export * from './pb/decentraland/sdk/components/camera_mode_area.gen';
 export * from './pb/decentraland/sdk/components/engine_info.gen';
-export * from './pb/decentraland/sdk/components/explorer_item_purchase_result.gen';
 export * from './pb/decentraland/sdk/components/explorer_ui_events_result.gen';
 export * from './pb/decentraland/sdk/components/gltf_container.gen';
 export * from './pb/decentraland/sdk/components/gltf_container_loading_state.gen';
@@ -168,10 +166,6 @@ export * from './pb/decentraland/sdk/components/visibility_component.gen';
 /* @__PURE__ */ engine.defineComponentFromSchema("core::CameraModeArea", CameraModeAreaSchema);
 /** @public */ export const EngineInfo = engine => 
 /* @__PURE__ */ engine.defineComponentFromSchema("core::EngineInfo", EngineInfoSchema);
-/** @public */ export const ExplorerItemPurchaseResult = (engine) => /* @__PURE__ */ engine.defineValueSetComponentFromSchema("core::ExplorerItemPurchaseResult", ExplorerItemPurchaseResultSchema, {
-    timestampFunction: (t) => t.timestamp,
-    maxElements: 100
-});
 /** @public */ export const ExplorerUiEventsResult = (engine) => /* @__PURE__ */ engine.defineValueSetComponentFromSchema("core::ExplorerUiEventsResult", ExplorerUiEventsResultSchema, {
     timestampFunction: (t) => t.timestamp,
     maxElements: 100
@@ -287,7 +281,6 @@ export const componentDefinitionByName = /* @__PURE__ */ {
     "core::CameraMode": CameraMode,
     "core::CameraModeArea": CameraModeArea,
     "core::EngineInfo": EngineInfo,
-    "core::ExplorerItemPurchaseResult": ExplorerItemPurchaseResult,
     "core::ExplorerUiEventsResult": ExplorerUiEventsResult,
     "core::GltfContainer": GltfContainer,
     "core::GltfContainerLoadingState": GltfContainerLoadingState,

package/dist/components/generated/pb/decentraland/sdk/components/common/explorer_ui.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * Identifies which explorer panel OpenExplorerUi targets. Panels are not all fullscreen.
+ * Identifies which fullscreen explorer panel OpenExplorerUi targets.
  * EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
  */
 /**
@@ -12,7 +12,5 @@ export declare const enum ExplorerUi {
     EU_CAMERA_REEL = 3,
     EU_COMMUNITIES = 4,
     EU_PLACES = 5,
-    EU_EVENTS = 6,
-    /** EU_ITEM_PURCHASE - the item-purchase confirmation modal; see OpenExplorerUi for its parameters and result component */
-    EU_ITEM_PURCHASE = 7
+    EU_EVENTS = 6
 }

package/dist/components/generated/pb/decentraland/sdk/components/common/explorer_ui.gen.js

@@ -1,7 +1,7 @@
 /* eslint-disable */
 const protobufPackageSarasa = "decentraland.sdk.components.common";
 /**
- * Identifies which explorer panel OpenExplorerUi targets. Panels are not all fullscreen.
+ * Identifies which fullscreen explorer panel OpenExplorerUi targets.
  * EU_SETTINGS holds 0 so an unset `ui` field defaults to the least-intrusive panel.
  */
 /**
@@ -16,6 +16,4 @@ export var ExplorerUi;
     ExplorerUi[ExplorerUi["EU_COMMUNITIES"] = 4] = "EU_COMMUNITIES";
     ExplorerUi[ExplorerUi["EU_PLACES"] = 5] = "EU_PLACES";
     ExplorerUi[ExplorerUi["EU_EVENTS"] = 6] = "EU_EVENTS";
-    /** EU_ITEM_PURCHASE - the item-purchase confirmation modal; see OpenExplorerUi for its parameters and result component */
-    ExplorerUi[ExplorerUi["EU_ITEM_PURCHASE"] = 7] = "EU_ITEM_PURCHASE";
 })(ExplorerUi || (ExplorerUi = {}));

package/dist/components/generated/pb/decentraland/sdk/components/explorer_ui_events_result.gen.d.ts

@@ -1,7 +1,7 @@
 import _m0 from "protobufjs/minimal";
 import { ExplorerUi } from "./common/explorer_ui.gen";
 /**
- * PBExplorerUiEventsResult transports the lifecycle events of explorer UI panels — a panel was
+ * PBExplorerUiEventsResult transports the lifecycle events of fullscreen explorer panels — a panel was
  * opened, a panel was closed. It is a grow only value set appended to the scene root entity, so every
  * event of a tick is delivered and none overwrites another.
  */
@@ -13,8 +13,6 @@ export interface PBExplorerUiEventsResult {
     ui: ExplorerUi;
     /** The scene tick when the event occurred */
     timestamp: number;
-    /** The OpenExplorerUiRequest.request_id that caused this event; 0 when the request carried none */
-    requestId: number;
     event?: {
         $case: "opened";
         opened: PBExplorerUiEventsResult_UiOpened;
@@ -23,16 +21,13 @@ export interface PBExplorerUiEventsResult {
         closed: PBExplorerUiEventsResult_UiClosed;
     } | undefined;
 }
-/**
- * Emitted when an explorer panel is opened. The OpenExplorerUi response carries the same fact,
- * but it reaches only the caller; this channel is scene wide.
- */
+/** Emitted when a fullscreen explorer panel is opened. */
 /**
  * @public
  */
 export interface PBExplorerUiEventsResult_UiOpened {
 }
-/** Emitted when an explorer panel is closed. */
+/** Emitted when a fullscreen explorer panel is closed. */
 /**
  * @public
  */

package/dist/components/generated/pb/decentraland/sdk/components/explorer_ui_events_result.gen.js

@@ -2,7 +2,7 @@
 import _m0 from "protobufjs/minimal";
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBExplorerUiEventsResult() {
-    return { ui: 0, timestamp: 0, requestId: 0, event: undefined };
+    return { ui: 0, timestamp: 0, event: undefined };
 }
 /**
  * @public
@@ -16,9 +16,6 @@ export var PBExplorerUiEventsResult;
         if (message.timestamp !== 0) {
             writer.uint32(16).uint32(message.timestamp);
         }
-        if (message.requestId !== 0) {
-            writer.uint32(24).uint32(message.requestId);
-        }
         switch (message.event?.$case) {
             case "opened":
                 PBExplorerUiEventsResult_UiOpened.encode(message.event.opened, writer.uint32(82).fork()).ldelim();
@@ -49,12 +46,6 @@ export var PBExplorerUiEventsResult;
                     }
                     message.timestamp = reader.uint32();
                     continue;
-                case 3:
-                    if (tag !== 24) {
-                        break;
-                    }
-                    message.requestId = reader.uint32();
-                    continue;
                 case 10:
                     if (tag !== 82) {
                         break;

package/dist/components/index.d.ts

@@ -23,6 +23,7 @@ import { TriggerAreaComponentDefinitionExtended } from './extended/TriggerArea';
 import { ParticleSystemComponentDefinitionExtended } from './extended/ParticleSystem';
 import { TouchScreenControlsComponentDefinitionExtended } from './extended/TouchScreenControls';
 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>;
@@ -57,5 +58,9 @@ 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 };
 export type { AudioAnalysisView };

package/dist/components/index.js

@@ -19,6 +19,7 @@ import { defineTriggerAreaComponent } from './extended/TriggerArea';
 import { defineParticleSystemComponent } from './extended/ParticleSystem';
 import { defineTouchScreenControlsComponent } from './extended/TouchScreenControls';
 import defineTagsComponent from './manual/Tags';
+import defineCreatedBy from './manual/CreatedBy';
 export * from './generated/index.gen';
 /* @__PURE__ */
 export const Transform = (engine) => defineTransformComponent(engine);
@@ -65,11 +66,13 @@ export const SyncComponents = (engine) => defineSyncComponent(engine);
 /**
  * @alpha
  */
-/* @__PURE__ */
 export const NetworkEntity = (engine) => defineNetworkEntity(engine);
 /**
  * @alpha
  */
-/* @__PURE__ */
 export const NetworkParent = (engine) => defineNetworkParent(engine);
+/**
+ * @public
+ */
+export const CreatedBy = (engine) => defineCreatedBy(engine);
 export { MediaState };

package/dist/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/components/manual/CreatedBy.js

@@ -0,0 +1,8 @@
+import { Schemas } from '../../schemas';
+function defineCreatedBy(engine) {
+    const CreatedBy = engine.defineComponent('core-schema::Created-By', {
+        address: Schemas.String
+    });
+    return CreatedBy;
+}
+export default defineCreatedBy;

package/dist/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';
 import type { Vector3Type } from '../../schemas/custom/Vector3';
 /**
  * @public
@@ -24,6 +25,10 @@ export interface TransformComponentExtended extends TransformComponent {
      */
     localToWorldDirection(entity: Entity, localDirection: Vector3Type): Vector3Type;
 }
+/**
+ * @public
+ */
+export declare const COMPONENT_ID = 1;
 /**
  * @public
  */
@@ -46,6 +51,10 @@ export type TransformType = {
     };
     parent?: Entity;
 };
+/** @public */
+export declare const TRANSFORM_LENGTH = 44;
+/** @public */
+export declare const TransformSchema: ISchema<TransformType>;
 /**
  * @public
  */

package/dist/components/manual/Transform.js

@@ -3,12 +3,12 @@
 // getters via __importStar in CJS), so by the time methods are called all exports are available.
 import * as treeHelpers from '../../runtime/helpers/tree';
 /**
- * @internal
+ * @public
  */
 export const COMPONENT_ID = 1;
-/** @internal */
+/** @public */
 export const TRANSFORM_LENGTH = 44;
-/** @internal */
+/** @public */
 export const TransformSchema = {
     serialize(value, builder) {
         const ptr = builder.incrementWriteOffset(TRANSFORM_LENGTH);

package/dist/components/types.d.ts

@@ -13,6 +13,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/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/engine/grow-only-value-set-component-definition.js

@@ -1,7 +1,8 @@
 import { ReadWriteByteBuffer } from '../serialization/ByteBuffer';
-import { AppendValueOperation, CrdtMessageType } from '../serialization/crdt';
+import { AppendValueOperation, CrdtMessageType, ProcessMessageResultType } from '../serialization/crdt';
 import { __DEV__ } from '../runtime/invariant';
 const emptyReadonlySet = freezeSet(new Set());
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
 function frozenError() {
     throw new Error('The set is frozen');
 }
@@ -22,6 +23,7 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
     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;
@@ -80,8 +82,11 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
         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);
@@ -152,6 +157,44 @@ export function createValueSetComponentDefinitionFromSchema(componentName, compo
             for (const cb of cbs) {
                 cb(value);
             }
+        },
+        __dry_run_updateFromCrdt(_body) {
+            return 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/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>, lastSentData: Map<Entity, Uint8Array>): (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>, 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>;

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

@@ -30,16 +30,12 @@ export function createDumpLwwFunctionFromCrdt(componentId, timestamps, schema, d
         }
     };
 }
-export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData) {
+const __GLOBAL_ENTITY = '__GLOBAL_ENTITY';
+export function createCrdtRuleValidator(timestamps, schema, data, lastSentData) {
     /**
-     * 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);
@@ -49,7 +45,6 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
         }
         // Outdated Message. Resend our state message through the wire.
         if (currentTimestamp > timestamp) {
-            // console.log('2', currentTimestamp, timestamp)
             return ProcessMessageResultType.StateOutdatedTimestamp;
         }
         // Deletes are idempotent
@@ -66,7 +61,6 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
             currentDataGreater = 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 ProcessMessageResultType.NoChanges;
         }
@@ -75,10 +69,35 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
             return ProcessMessageResultType.StateOutdatedData;
         }
         else {
-            // Curent data is lower
+            // Current data is lower
             return ProcessMessageResultType.StateUpdatedData;
         }
     }
+    return crdtRuleForCurrentState;
+}
+export function createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data) {
+    /**
+     * Force update component state regardless of timestamp - used for server authoritative messages
+     */
+    return (msg) => {
+        const buffer = new ReadWriteByteBuffer(msg.data);
+        const deserializedValue = schema.deserialize(buffer);
+        data.set(msg.entityId, deserializedValue);
+        timestamps.set(msg.entityId, msg.timestamp);
+        return [null, deserializedValue];
+    };
+}
+export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData) {
+    /**
+     * 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, lastSentData);
     return (msg) => {
         /* istanbul ignore next */
         if (msg.type !== CrdtMessageType.PUT_COMPONENT &&
@@ -96,7 +115,10 @@ export function createUpdateLwwFromCrdt(componentId, timestamps, schema, data, l
                 if (msg.type === CrdtMessageType.PUT_COMPONENT || msg.type === CrdtMessageType.PUT_COMPONENT_NETWORK) {
                     const buf = new ReadWriteByteBuffer(msg.data);
                     data.set(entity, schema.deserialize(buf));
-                    lastSentData.set(entity, new Uint8Array(msg.data));
+                    // do NOT seed lastSentData from an INCOMING message!!!!
+                    // seeding it from received bytes makes the engine
+                    // believe it already sent this state, which kills valid re-broadcasting 🧨
+                    lastSentData.delete(entity);
                 }
                 else {
                     data.delete(entity);
@@ -185,6 +207,7 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
     const timestamps = new Map();
     const lastSentData = new Map();
     const onChangeCallbacks = new Map();
+    const validateCallbacks = new Map();
     return {
         get componentId() {
             return componentId;
@@ -285,7 +308,39 @@ export function createComponentDefinitionFromSchema(componentName, componentId,
         },
         getCrdtUpdates: createGetCrdtMessagesForLww(componentId, timestamps, dirtyIterator, schema, data, lastSentData),
         updateFromCrdt: createUpdateLwwFromCrdt(componentId, timestamps, schema, data, lastSentData),
+        __forceUpdateFromCrdt: createForceUpdateLwwFromCrdt(componentId, timestamps, schema, data),
+        __dry_run_updateFromCrdt: createCrdtRuleValidator(timestamps, schema, data, lastSentData),
         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 ReadWriteByteBuffer();
+                schema.serialize(deepReadonly(componentData), buffer);
+                return { data: buffer.toBinary(), timestamp };
+            }
+            return null;
+        },
         onChange(entity, cb) {
             const cbs = onChangeCallbacks.get(entity) ?? [];
             cbs.push(cb);

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export * from './systems/triggerArea';
 export * from './systems/physics';
 export * from './engine/entity';
 export * from './components/types';
-import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioAnalysisComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ParticleSystemComponentDefinitionExtended, TouchScreenControlsComponentDefinitionExtended } from './components/types';
+import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioAnalysisComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended, ParticleSystemComponentDefinitionExtended, ICreatedBy, TouchScreenControlsComponentDefinitionExtended } from './components/types';
 import { NameComponent } from './components/manual/Name';
 import { TagsComponentDefinitionExtended } from './components/manual/Tags';
 export declare const Transform: TransformComponentExtended;
@@ -52,6 +52,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';

package/dist/index.js

@@ -58,6 +58,7 @@ export const NetworkEntity = /* @__PURE__*/ components.NetworkEntity(engine);
  * Tag a entity to be syncronized through comms
  */
 export const NetworkParent = /* @__PURE__*/ components.NetworkParent(engine);
+export const CreatedBy = /* @__PURE__*/ components.CreatedBy(engine);
 // export components for global engine
 export * from './components/generated/global.gen';
 export * from './components/generated/types.gen';