@roomkit/state 1.1.2 → 1.1.3

package/dist/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * State Synchronization Types
+ */
+import 'reflect-metadata';
+/**
+ * 支持的原始类型
+ */
+export type PrimitiveType = 'string' | 'number' | 'boolean' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32';
+/**
+ * 字段类型（原始类型或构造函数）
+ */
+export type FieldType = PrimitiveType | Function;
+/**
+ * 字段元数据
+ */
+export interface FieldMetadata {
+    key: string;
+    type: FieldType;
+    isArray: boolean;
+    isMap: boolean;
+    isSet: boolean;
+    optional?: boolean;
+}
+/**
+ * 类元数据
+ */
+export interface ClassMetadata {
+    fields: Map<string, FieldMetadata>;
+    className: string;
+}
+/**
+ * 变化操作类型
+ */
+export declare enum ChangeOp {
+    ADD = "add",
+    REPLACE = "replace",
+    REMOVE = "remove"
+}
+/**
+ * JSON Patch 格式的变化记录
+ */
+export interface Patch {
+    op: ChangeOp;
+    path: string;
+    value?: any;
+    oldValue?: any;
+}
+/**
+ * 编码选项
+ */
+export interface EncodeOptions {
+    /**
+     * 压缩选项
+     */
+    compressionOptions?: {
+        /**
+         * 压缩阈值（字节），小于此值不压缩
+         */
+        threshold?: number;
+        /**
+         * 最小压缩率，低于此值不使用压缩结果
+         */
+        minCompressionRatio?: number;
+        /**
+         * 压缩级别 (1-9)
+         */
+        level?: number;
+        /**
+         * 是否强制压缩
+         */
+        force?: boolean;
+        /**
+         * 是否启用自适应压缩
+         */
+        adaptive?: boolean;
+    };
+    /**
+     * 是否包含类型信息
+     */
+    includeTypes?: boolean;
+}
+/**
+ * 解码选项
+ */
+export interface DecodeOptions {
+    /**
+     * 是否自动解压
+     */
+    decompress?: boolean;
+}
+/**
+ * 序列化后的状态数据
+ */
+export interface EncodedState {
+    /**
+     * 二进制数据
+     */
+    data: Uint8Array;
+    /**
+     * 是否压缩
+     */
+    compressed: boolean;
+    /**
+     * 原始大小（压缩前）
+     */
+    originalSize?: number;
+    /**
+     * 压缩后大小
+     */
+    compressedSize?: number;
+    /**
+     * 压缩率
+     */
+    compressionRatio?: number;
+}
+/**
+ * Metadata keys
+ */
+export declare const METADATA_KEYS: {
+    readonly FIELDS: symbol;
+    readonly CLASS_NAME: symbol;
+};
+/**
+ * 变化追踪配置
+ */
+export interface TrackingOptions {
+    /**
+     * 批量刷新间隔（毫秒）
+     */
+    patchRate?: number;
+    /**
+     * 是否深度追踪嵌套对象
+     */
+    deep?: boolean;
+    /**
+     * 最大变化队列大小
+     */
+    maxQueueSize?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,kBAAkB,CAAC,EAAE;QACnB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;WAEG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAE7B;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,KAAK,CAAC,EAAE,OAAO,CAAC;QAEhB;;WAEG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * State Synchronization Types
+ */
+import 'reflect-metadata';
+/**
+ * 变化操作类型
+ */
+export var ChangeOp;
+(function (ChangeOp) {
+    ChangeOp["ADD"] = "add";
+    ChangeOp["REPLACE"] = "replace";
+    ChangeOp["REMOVE"] = "remove";
+})(ChangeOp || (ChangeOp = {}));
+/**
+ * Metadata keys
+ */
+export const METADATA_KEYS = {
+    FIELDS: Symbol('state:fields'),
+    CLASS_NAME: Symbol('state:className'),
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAyC1B;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,uBAAW,CAAA;IACX,+BAAmB,CAAA;IACnB,6BAAiB,CAAA;AACnB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AA4FD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,iBAAiB,CAAC;CAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomkit/state",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "High-performance state synchronization library inspired by Colyseus Schema",
   "type": "module",
   "main": "./dist/index.js",