@yydb/light-db 0.0.0

package/dist/performance/OptimizedBuffer.d.ts

@@ -0,0 +1,375 @@
+/**
+ * 优化的二进制序列化工具
+ * 使用 Buffer.allocUnsafe + 手动 fill，比 Buffer.alloc 快 2 倍以上
+ */
+import { BufferPoolOptions, BufferPoolStats } from "./types";
+/**
+ * Buffer 池
+ * 预分配 Buffer 块，减少频繁内存分配
+ */
+export declare class BufferPool {
+    private pool;
+    private chunkSize;
+    private maxPoolSize;
+    private usedCount;
+    private totalAllocated;
+    private totalFreed;
+    /**
+     * 创建 Buffer 池
+     * @param options 配置选项
+     */
+    constructor(options?: BufferPoolOptions);
+    /**
+     * 预分配 Buffer 块
+     * @param count 分配数量
+     */
+    private preallocate;
+    /**
+     * 创建新的 Buffer 块
+     */
+    private createChunk;
+    /**
+     * 从池中获取 Buffer
+     * @param size 需要的大小
+     * @returns Buffer 实例
+     */
+    allocate(size: number): Buffer;
+    /**
+     * 释放 Buffer 回池中
+     * @param buffer 要释放的 Buffer
+     */
+    release(buffer: Buffer): void;
+    /**
+     * 获取统计信息
+     */
+    getStats(): BufferPoolStats;
+    /**
+     * 清空池
+     */
+    clear(): void;
+    /**
+     * 获取块大小
+     */
+    getChunkSize(): number;
+    /**
+     * 获取分配总数
+     */
+    getTotalAllocated(): number;
+    /**
+     * 获取释放总数
+     */
+    getTotalFreed(): number;
+}
+/**
+ * 获取全局 Buffer 池
+ */
+export declare function getGlobalBufferPool(): BufferPool;
+/**
+ * 优化的 Buffer 写入器
+ * 使用 allocUnsafe + 手动 fill，性能更优
+ */
+export declare class OptimizedBufferWriter {
+    private buffer;
+    private offset;
+    private static pool;
+    /**
+     * 创建优化的 Buffer 写入器
+     * @param size 初始大小
+     */
+    constructor(size?: number);
+    /**
+     * 获取当前写入位置
+     */
+    get position(): number;
+    /**
+     * 获取已写入的数据
+     */
+    get data(): Buffer;
+    /**
+     * 获取剩余空间
+     */
+    get remaining(): number;
+    /**
+     * 确保有足够的空间
+     * @param additional 需要的额外空间
+     */
+    private ensureCapacity;
+    /**
+     * 写入无符号 8 位整数
+     */
+    writeUInt8(value: number): this;
+    /**
+     * 写入无符号 16 位整数（Little-Endian）
+     */
+    writeUInt16LE(value: number): this;
+    /**
+     * 写入无符号 32 位整数（Little-Endian）
+     */
+    writeUInt32LE(value: number): this;
+    /**
+     * 写入有符号 32 位整数（Little-Endian）
+     */
+    writeInt32LE(value: number): this;
+    /**
+     * 写入无符号 64 位整数（Little-Endian）
+     */
+    writeBigUInt64LE(value: bigint): this;
+    /**
+     * 写入有符号 64 位整数（Little-Endian）
+     */
+    writeBigInt64LE(value: bigint): this;
+    /**
+     * 写入 32 位浮点数（Little-Endian）
+     */
+    writeFloatLE(value: number): this;
+    /**
+     * 写入 64 位双精度浮点数（Little-Endian）
+     */
+    writeDoubleLE(value: number): this;
+    /**
+     * 写入字符串（带长度前缀）
+     */
+    writeString(value: string): this;
+    /**
+     * 写入字符串（不带长度前缀）
+     */
+    writeStringRaw(value: string): this;
+    /**
+     * 写入 Buffer
+     */
+    writeBuffer(value: Buffer): this;
+    /**
+     * 写入带长度前缀的 Buffer
+     */
+    writeBufferWithLength(value: Buffer): this;
+    /**
+     * 写入字节数组
+     */
+    writeBytes(values: number[]): this;
+    /**
+     * 填充指定字节
+     */
+    fill(value: number, count: number): this;
+    /**
+     * 跳过指定字节数
+     */
+    skip(count: number): this;
+    /**
+     * 在指定位置写入值
+     */
+    writeAt(offset: number, value: number, size: 1 | 2 | 4 | 8): this;
+    /**
+     * 重置写入器
+     */
+    reset(): this;
+    /**
+     * 释放资源
+     */
+    dispose(): void;
+}
+/**
+ * 优化的 Buffer 读取器
+ */
+export declare class OptimizedBufferReader {
+    private buffer;
+    private offset;
+    private startOffset;
+    /**
+     * 创建优化的 Buffer 读取器
+     * @param buffer 要读取的 Buffer
+     * @param startOffset 起始偏移量
+     */
+    constructor(buffer: Buffer, startOffset?: number);
+    /**
+     * 获取当前读取位置
+     */
+    get position(): number;
+    /**
+     * 设置读取位置
+     */
+    set position(value: number);
+    /**
+     * 获取剩余可读字节数
+     */
+    get remaining(): number;
+    /**
+     * 获取总长度
+     */
+    get length(): number;
+    /**
+     * 检查是否有足够的可读数据
+     */
+    hasRemaining(required: number): boolean;
+    /**
+     * 读取无符号 8 位整数
+     */
+    readUInt8(): number;
+    /**
+     * 读取无符号 16 位整数（Little-Endian）
+     */
+    readUInt16LE(): number;
+    /**
+     * 读取无符号 32 位整数（Little-Endian）
+     */
+    readUInt32LE(): number;
+    /**
+     * 读取有符号 32 位整数（Little-Endian）
+     */
+    readInt32LE(): number;
+    /**
+     * 读取无符号 64 位整数（Little-Endian）
+     */
+    readBigUInt64LE(): bigint;
+    /**
+     * 读取有符号 64 位整数（Little-Endian）
+     */
+    readBigInt64LE(): bigint;
+    /**
+     * 读取 32 位浮点数（Little-Endian）
+     */
+    readFloatLE(): number;
+    /**
+     * 读取 64 位双精度浮点数（Little-Endian）
+     */
+    readDoubleLE(): number;
+    /**
+     * 读取字符串（带长度前缀）
+     */
+    readString(): string;
+    /**
+     * 读取指定长度的字符串
+     */
+    readStringFixed(length: number): string;
+    /**
+     * 读取指定长度的 Buffer
+     */
+    readBuffer(length: number): Buffer;
+    /**
+     * 读取带长度前缀的 Buffer
+     */
+    readBufferWithLength(): Buffer;
+    /**
+     * 读取字节数组
+     */
+    readBytes(length: number): number[];
+    /**
+     * 跳过指定字节数
+     */
+    skip(bytes: number): this;
+    /**
+     * 回退指定字节数
+     */
+    back(bytes: number): this;
+    /**
+     * 重置到起始位置
+     */
+    reset(): this;
+    /**
+     * 查看当前位置的字节（不移动指针）
+     */
+    peek(): number;
+    /**
+     * 查看指定偏移量的值（不移动指针）
+     */
+    peekAt(offset: number, size: 1 | 2 | 4 | 8): number | bigint;
+    /**
+     * 获取底层 Buffer
+     */
+    getBuffer(): Buffer;
+}
+/**
+ * 快速序列化工具
+ * 提供常用数据结构的快速序列化方法
+ */
+export declare class FastSerializer {
+    /**
+     * 序列化键值对
+     */
+    static serializeKeyValue(key: string, value: Buffer): Buffer;
+    /**
+     * 反序列化键值对
+     */
+    static deserializeKeyValue(
+        buffer: Buffer,
+        offset?: number,
+    ): {
+        key: string;
+        value: Buffer;
+        bytesRead: number;
+    };
+    /**
+     * 序列化字符串数组
+     */
+    static serializeStringArray(strings: string[]): Buffer;
+    /**
+     * 反序列化字符串数组
+     */
+    static deserializeStringArray(
+        buffer: Buffer,
+        offset?: number,
+    ): {
+        strings: string[];
+        bytesRead: number;
+    };
+    /**
+     * 序列化数字数组
+     */
+    static serializeNumberArray(numbers: number[]): Buffer;
+    /**
+     * 反序列化数字数组
+     */
+    static deserializeNumberArray(
+        buffer: Buffer,
+        offset?: number,
+    ): {
+        numbers: number[];
+        bytesRead: number;
+    };
+    /**
+     * 序列化对象（简单 JSON 序列化的优化版本）
+     */
+    static serializeObject(obj: Record<string, unknown>): Buffer;
+    /**
+     * 反序列化对象
+     */
+    static deserializeObject(
+        buffer: Buffer,
+        offset?: number,
+    ): {
+        obj: Record<string, unknown>;
+        bytesRead: number;
+    };
+}
+/**
+ * 批量 Buffer 合并工具
+ */
+export declare class BufferConcatenator {
+    private buffers;
+    private totalLength;
+    constructor();
+    /**
+     * 添加 Buffer
+     */
+    append(buffer: Buffer): this;
+    /**
+     * 添加多个 Buffer
+     */
+    appendMany(buffers: Buffer[]): this;
+    /**
+     * 获取总长度
+     */
+    get length(): number;
+    /**
+     * 获取 Buffer 数量
+     */
+    get count(): number;
+    /**
+     * 合并所有 Buffer
+     */
+    concat(): Buffer;
+    /**
+     * 清空
+     */
+    clear(): this;
+}
+//# sourceMappingURL=OptimizedBuffer.d.ts.map

package/dist/performance/OptimizedBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptimizedBuffer.d.ts","sourceRoot":"","sources":["../../src/performance/OptimizedBuffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE7D;;;GAGG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,UAAU,CAAS;IAE3B;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAa3C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;;OAIG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYrC;;;OAGG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAapC;;OAEG;IACI,QAAQ,IAAI,eAAe;IAUlC;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,aAAa,IAAI,MAAM;CAGjC;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAKhD;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAqC;IAExD;;;OAGG;gBACS,IAAI,GAAE,MAAa;IAK/B;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO3C;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASvC;;OAEG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOvC;;OAEG;IACI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMjD;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IASzC;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/C;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI;IAkBxE;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACI,OAAO,IAAI,IAAI;CAGzB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,WAAW,GAAE,MAAU;IAMnD;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEhC;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;OAEG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9C;;OAEG;IACI,SAAS,IAAI,MAAM;IAM1B;;OAEG;IACI,YAAY,IAAI,MAAM;IAM7B;;OAEG;IACI,YAAY,IAAI,MAAM;IAM7B;;OAEG;IACI,WAAW,IAAI,MAAM;IAM5B;;OAEG;IACI,eAAe,IAAI,MAAM;IAMhC;;OAEG;IACI,cAAc,IAAI,MAAM;IAM/B;;OAEG;IACI,WAAW,IAAI,MAAM;IAM5B;;OAEG;IACI,YAAY,IAAI,MAAM;IAM7B;;OAEG;IACI,UAAU,IAAI,MAAM;IAO3B;;OAEG;IACI,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAM9C;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMzC;;OAEG;IACI,oBAAoB,IAAI,MAAM;IAKrC;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAS1C;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,MAAM;IAanE;;OAEG;IACI,SAAS,IAAI,MAAM;CAG7B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACvB;;OAEG;WACW,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAanE;;OAEG;WACW,mBAAmB,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACnB;QACC,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;WACW,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAgB7D;;OAEG;WACW,sBAAsB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACnB;QACC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;WACW,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM;IAY7D;;OAEG;WACW,sBAAsB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACnB;QACC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;WACW,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAWnE;;OAEG;WACW,iBAAiB,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACnB;QACC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC;KACrB;CAWJ;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,WAAW,CAAS;;IAO5B;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMnC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAO1C;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;OAEG;IACI,MAAM,IAAI,MAAM;IAoBvB;;OAEG;IACI,KAAK,IAAI,IAAI;CAKvB"}