@roomkit/state 1.1.2 → 1.2.0

package/dist/compression/CompressionStrategy.js

@@ -0,0 +1,195 @@
+/**
+ * 压缩策略管理器
+ * 根据数据大小和类型智能选择压缩方案
+ */
+import { deflate, inflate } from 'pako';
+/**
+ * 压缩策略
+ */
+export class CompressionStrategy {
+    defaultOptions = {
+        threshold: 1024, // 1KB 以下不压缩
+        minCompressionRatio: 0.8, // 压缩率低于 80% 才使用
+        level: 6, // 默认压缩级别
+        force: false,
+        adaptive: true,
+    };
+    // 统计数据用于自适应
+    stats = {
+        totalAttempts: 0,
+        totalCompressed: 0,
+        totalSaved: 0,
+        averageRatio: 1.0,
+    };
+    constructor(options) {
+        if (options) {
+            this.defaultOptions = { ...this.defaultOptions, ...options };
+        }
+    }
+    /**
+     * 压缩数据
+     */
+    compress(data, options) {
+        const opts = { ...this.defaultOptions, ...options };
+        const originalSize = data.length;
+        // 太小不压缩
+        if (!opts.force && originalSize < opts.threshold) {
+            return {
+                data,
+                compressed: false,
+                originalSize,
+                compressedSize: originalSize,
+                compressionRatio: 1.0,
+            };
+        }
+        // 自适应：如果历史压缩效果不好，跳过
+        if (opts.adaptive && this.stats.totalAttempts > 10) {
+            if (this.stats.averageRatio > 0.95) {
+                return {
+                    data,
+                    compressed: false,
+                    originalSize,
+                    compressedSize: originalSize,
+                    compressionRatio: 1.0,
+                };
+            }
+        }
+        try {
+            const startTime = Date.now();
+            const compressed = deflate(data, { level: opts.level });
+            const compressionTime = Date.now() - startTime;
+            const compressedSize = compressed.length;
+            const ratio = compressedSize / originalSize;
+            // 更新统计
+            this.stats.totalAttempts++;
+            // 压缩效果不好，不使用压缩结果
+            if (!opts.force && ratio > opts.minCompressionRatio) {
+                return {
+                    data,
+                    compressed: false,
+                    originalSize,
+                    compressedSize: originalSize,
+                    compressionRatio: 1.0,
+                };
+            }
+            // 压缩成功
+            this.stats.totalCompressed++;
+            this.stats.totalSaved += (originalSize - compressedSize);
+            this.stats.averageRatio = (this.stats.averageRatio * (this.stats.totalAttempts - 1) + ratio) / this.stats.totalAttempts;
+            if (compressionTime > 100) {
+                console.warn(`[Compression] Slow compression: ${compressionTime}ms for ${originalSize} bytes`);
+            }
+            return {
+                data: compressed,
+                compressed: true,
+                originalSize,
+                compressedSize,
+                compressionRatio: ratio,
+            };
+        }
+        catch (error) {
+            console.error('[Compression] Error:', error);
+            return {
+                data,
+                compressed: false,
+                originalSize,
+                compressedSize: originalSize,
+                compressionRatio: 1.0,
+            };
+        }
+    }
+    /**
+     * 解压数据
+     */
+    decompress(data, compressed) {
+        if (!compressed)
+            return data;
+        try {
+            return inflate(data);
+        }
+        catch (error) {
+            console.error('[Compression] Decompress error:', error);
+            return data;
+        }
+    }
+    /**
+     * 批量压缩（用于多个小对象）
+     */
+    compressBatch(dataArray) {
+        // 合并所有数据
+        const totalSize = dataArray.reduce((sum, d) => sum + d.length, 0);
+        const merged = new Uint8Array(totalSize);
+        let offset = 0;
+        for (const data of dataArray) {
+            merged.set(data, offset);
+            offset += data.length;
+        }
+        // 压缩合并后的数据
+        return this.compress(merged);
+    }
+    /**
+     * 获取压缩统计
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            compressionRate: this.stats.totalAttempts > 0
+                ? this.stats.totalCompressed / this.stats.totalAttempts
+                : 0,
+            averageSaving: this.stats.totalCompressed > 0
+                ? this.stats.totalSaved / this.stats.totalCompressed
+                : 0,
+        };
+    }
+    /**
+     * 重置统计
+     */
+    resetStats() {
+        this.stats = {
+            totalAttempts: 0,
+            totalCompressed: 0,
+            totalSaved: 0,
+            averageRatio: 1.0,
+        };
+    }
+    /**
+     * 根据数据类型建议压缩级别
+     */
+    static suggestLevel(dataType) {
+        switch (dataType) {
+            case 'text':
+                return 9; // 文本压缩效果好，使用最高级别
+            case 'binary':
+                return 3; // 二进制数据可能已压缩，使用低级别
+            case 'mixed':
+            default:
+                return 6; // 混合数据使用中等级别
+        }
+    }
+    /**
+     * 估算压缩后大小（不实际压缩）
+     */
+    static estimateSize(data) {
+        // 简单启发式估算
+        const size = data.length;
+        // 检查数据熵（重复模式）
+        const sample = data.slice(0, Math.min(1024, size));
+        const unique = new Set(sample);
+        const entropy = unique.size / sample.length;
+        // 高熵（随机）数据压缩效果差
+        if (entropy > 0.9) {
+            return Math.floor(size * 0.95); // 估计只能压缩 5%
+        }
+        // 低熵数据压缩效果好
+        if (entropy < 0.3) {
+            return Math.floor(size * 0.4); // 估计能压缩 60%
+        }
+        // 中等熵
+        return Math.floor(size * 0.7); // 估计能压缩 30%
+    }
+}
+/**
+ * 全局压缩策略实例
+ */
+export const globalCompressionStrategy = new CompressionStrategy();
+//# sourceMappingURL=CompressionStrategy.js.map

package/dist/compression/CompressionStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompressionStrategy.js","sourceRoot":"","sources":["../../src/compression/CompressionStrategy.ts"],"names":[],"mappings":"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"}

package/dist/compression/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compression utilities
+ */
+export * from './CompressionStrategy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/compression/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compression/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,0BAA0B,CAAC"}

package/dist/compression/index.js

@@ -0,0 +1,5 @@
+/**
+ * Compression utilities
+ */
+export * from './CompressionStrategy.js';
+//# sourceMappingURL=index.js.map

package/dist/compression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compression/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,0BAA0B,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * State Schema Decorators - TypeScript 5.0+ Standard
+ *
+ * 使用 TS 5.0+ 的标准装饰器，无需 experimentalDecorators
+ */
+import { FieldType, FieldMetadata } from '../types.js';
+/**
+ * @Field - 定义一个可序列化的字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class Player {
+ *   @Field('string') name: string = '';
+ *   @Field('number') health: number = 100;
+ *   @Field('boolean') isAlive: boolean = true;
+ * }
+ * ```
+ */
+export declare function Field(type: FieldType, optional?: boolean): (_target: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * @MapField - 定义一个 Map 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @MapField(Player) players = new Map<string, Player>();
+ * }
+ * ```
+ */
+export declare function MapField(valueType: Function): (_target: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * @ArrayField - 定义一个 Array 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @ArrayField('number') scores: number[] = [];
+ *   @ArrayField(Item) inventory: Item[] = [];
+ * }
+ * ```
+ */
+export declare function ArrayField(type: FieldType): (_target: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * @SetField - 定义一个 Set 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @SetField('string') activePlayers = new Set<string>();
+ * }
+ * ```
+ */
+export declare function SetField(type: FieldType): (_target: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * 获取类的所有字段元数据
+ */
+export declare function getFieldsMetadata(target: any): Map<string, FieldMetadata>;
+/**
+ * 检查对象是否有 State 装饰器定义
+ */
+export declare function hasStateMetadata(target: any): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAiBtE;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,GAAE,OAAe,IAE5D,SAAS,SAAS,EAClB,SAAS,0BAA0B,UAgBtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,QAAQ,IAExC,SAAS,SAAS,EAClB,SAAS,0BAA0B,UActC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,IAEtC,SAAS,SAAS,EAClB,SAAS,0BAA0B,UActC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,IAEpC,SAAS,SAAS,EAClB,SAAS,0BAA0B,UActC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAgBzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAGrD"}

package/dist/decorators/index.js

@@ -0,0 +1,144 @@
+/**
+ * State Schema Decorators - TypeScript 5.0+ Standard
+ *
+ * 使用 TS 5.0+ 的标准装饰器，无需 experimentalDecorators
+ */
+/**
+ * 获取或创建类的字段元数据（TS 5.0+ 版本）
+ */
+function getOrCreateFieldsMetadata(target) {
+    if (!target)
+        return new Map();
+    // 直接使用属性而不是 Symbol
+    const metadataKey = '__roomkit_fields__';
+    if (!target[metadataKey]) {
+        target[metadataKey] = new Map();
+    }
+    return target[metadataKey];
+}
+/**
+ * @Field - 定义一个可序列化的字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class Player {
+ *   @Field('string') name: string = '';
+ *   @Field('number') health: number = 100;
+ *   @Field('boolean') isAlive: boolean = true;
+ * }
+ * ```
+ */
+export function Field(type, optional = false) {
+    return function (_target, context) {
+        // 在类初始化时添加元数据
+        context.addInitializer(function () {
+            const fields = getOrCreateFieldsMetadata(this.constructor.prototype);
+            fields.set(context.name, {
+                key: context.name,
+                type,
+                isArray: false,
+                isMap: false,
+                isSet: false,
+                optional,
+            });
+        });
+    };
+}
+/**
+ * @MapField - 定义一个 Map 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @MapField(Player) players = new Map<string, Player>();
+ * }
+ * ```
+ */
+export function MapField(valueType) {
+    return function (_target, context) {
+        context.addInitializer(function () {
+            const fields = getOrCreateFieldsMetadata(this.constructor.prototype);
+            fields.set(context.name, {
+                key: context.name,
+                type: valueType,
+                isArray: false,
+                isMap: true,
+                isSet: false,
+            });
+        });
+    };
+}
+/**
+ * @ArrayField - 定义一个 Array 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @ArrayField('number') scores: number[] = [];
+ *   @ArrayField(Item) inventory: Item[] = [];
+ * }
+ * ```
+ */
+export function ArrayField(type) {
+    return function (_target, context) {
+        context.addInitializer(function () {
+            const fields = getOrCreateFieldsMetadata(this.constructor.prototype);
+            fields.set(context.name, {
+                key: context.name,
+                type,
+                isArray: true,
+                isMap: false,
+                isSet: false,
+            });
+        });
+    };
+}
+/**
+ * @SetField - 定义一个 Set 集合字段（TS 5.0+ 标准装饰器）
+ *
+ * @example
+ * ```typescript
+ * class GameState {
+ *   @SetField('string') activePlayers = new Set<string>();
+ * }
+ * ```
+ */
+export function SetField(type) {
+    return function (_target, context) {
+        context.addInitializer(function () {
+            const fields = getOrCreateFieldsMetadata(this.constructor.prototype);
+            fields.set(context.name, {
+                key: context.name,
+                type,
+                isArray: false,
+                isMap: false,
+                isSet: true,
+            });
+        });
+    };
+}
+/**
+ * 获取类的所有字段元数据
+ */
+export function getFieldsMetadata(target) {
+    if (!target)
+        return new Map();
+    const metadataKey = '__roomkit_fields__';
+    // 尝试从实例获取
+    if (target[metadataKey]) {
+        return target[metadataKey];
+    }
+    // 尝试从原型获取
+    if (target.constructor && target.constructor.prototype[metadataKey]) {
+        return target.constructor.prototype[metadataKey];
+    }
+    return new Map();
+}
+/**
+ * 检查对象是否有 State 装饰器定义
+ */
+export function hasStateMetadata(target) {
+    const fields = getFieldsMetadata(target);
+    return fields.size > 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"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"}

package/dist/encoding/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * State Encoding and Decoding
+ * 使用 MessagePack 进行高性能二进制编码
+ */
+import { CompressionStrategy } from '../compression/CompressionStrategy.js';
+import type { Patch, EncodedState, EncodeOptions, DecodeOptions } from '../types.js';
+/**
+ * StateEncoder - 状态编码器
+ */
+export declare class StateEncoder {
+    private compressionStrategy;
+    constructor(compressionStrategy?: CompressionStrategy);
+    /**
+     * 编码完整状态
+     */
+    encodeFull(state: any, options?: EncodeOptions): EncodedState;
+    /**
+     * 编码增量变化
+     */
+    encodeDelta(patches: Patch[], options?: EncodeOptions): EncodedState;
+    /**
+     * 获取压缩统计
+     */
+    getCompressionStats(): {
+        compressionRate: number;
+        averageSaving: number;
+        totalAttempts: number;
+        totalCompressed: number;
+        totalSaved: number;
+        averageRatio: number;
+    };
+    /**
+     * 重置压缩统计
+     */
+    resetCompressionStats(): void;
+    /**
+     * 序列化对象
+     */
+    private serializeObject;
+    /**
+     * 序列化值
+     */
+    private serializeValue;
+}
+/**
+ * StateDecoder - 状态解码器
+ */
+export declare class StateDecoder {
+    private compressionStrategy;
+    constructor(compressionStrategy?: CompressionStrategy);
+    /**
+     * 解码二进制数据
+     */
+    decode<T = any>(data: Uint8Array, options?: DecodeOptions): T;
+    /**
+     * 应用 Patches 到对象
+     */
+    applyPatches(target: any, patches: Patch[]): void;
+    /**
+     * 应用单个 Patch
+     */
+    private applyPatch;
+    /**
+     * 反序列化对象
+     */
+    private deserializeObject;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/encoding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encoding/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAE5E,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EAEd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,mBAAmB,CAAsB;gBAErC,mBAAmB,CAAC,EAAE,mBAAmB;IAIrD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAuBjE;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAoBxE;;OAEG;IACH,mBAAmB;;;;;;;;IAInB;;OAEG;IACH,qBAAqB;IAIrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAevB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,mBAAmB,CAAsB;gBAErC,mBAAmB,CAAC,EAAE,mBAAmB;IAIrD;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,CAAC;IAWjE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI;IAMjD;;OAEG;IACH,OAAO,CAAC,UAAU;IAoDlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA+B1B"}