@yydb/light-db 0.0.0

package/dist/utils/binary.js

@@ -0,0 +1,454 @@
+"use strict";
+/**
+ * 二进制序列化工具类
+ * 提供 Buffer 读写、校验和计算等核心功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BufferReader = exports.BufferWriter = exports.BinaryUtils = void 0;
+const errors_1 = require("../errors");
+/**
+ * CRC32 查找表
+ * 用于快速计算校验和
+ */
+const CRC32_TABLE = new Uint32Array(256);
+/** 初始化 CRC32 查找表 */
+function initCRC32Table() {
+    for (let i = 0; i < 256; i++) {
+        let crc = i;
+        for (let j = 0; j < 8; j++) {
+            crc = crc & 1 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;
+        }
+        CRC32_TABLE[i] = crc;
+    }
+}
+initCRC32Table();
+/**
+ * 二进制工具类
+ * 提供静态方法用于 Buffer 操作和校验和计算
+ */
+class BinaryUtils {
+    /**
+     * 计算 Buffer 的 CRC32 校验和
+     * @param data 要计算校验和的数据
+     * @param offset 起始偏移量，默认 0
+     * @param length 数据长度，默认到末尾
+     * @returns CRC32 校验和（无符号 32 位整数）
+     */
+    static calculateChecksum(data, offset = 0, length) {
+        const len = length ?? data.length - offset;
+        let crc = 0xffffffff;
+        for (let i = offset; i < offset + len; i++) {
+            const tableIndex = (crc ^ data[i]) & 0xff;
+            const tableValue = CRC32_TABLE[tableIndex];
+            crc = tableValue ^ (crc >>> 8);
+        }
+        return (crc ^ 0xffffffff) >>> 0;
+    }
+    /**
+     * 验证校验和
+     * @param data 数据内容
+     * @param expectedChecksum 期望的校验和
+     * @param offset 数据起始偏移量
+     * @param length 数据长度
+     * @throws ChecksumError 如果校验和不匹配
+     */
+    static verifyChecksum(data, expectedChecksum, offset = 0, length) {
+        const actual = BinaryUtils.calculateChecksum(data, offset, length);
+        if (actual !== expectedChecksum) {
+            throw new errors_1.ChecksumError(
+                `Checksum verification failed: expected ${expectedChecksum}, got ${actual}`,
+                expectedChecksum,
+                actual,
+                offset,
+            );
+        }
+    }
+    /**
+     * 读取无符号 8 位整数
+     * @param buffer 数据缓冲区
+     * @param offset 偏移量
+     */
+    static readUInt8(buffer, offset) {
+        return buffer.readUInt8(offset);
+    }
+    /**
+     * 写入无符号 8 位整数
+     * @param buffer 数据缓冲区
+     * @param value 值
+     * @param offset 偏移量
+     */
+    static writeUInt8(buffer, value, offset) {
+        buffer.writeUInt8(value, offset);
+    }
+    /**
+     * 读取无符号 16 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param offset 偏移量
+     */
+    static readUInt16LE(buffer, offset) {
+        return buffer.readUInt16LE(offset);
+    }
+    /**
+     * 写入无符号 16 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param value 值
+     * @param offset 偏移量
+     */
+    static writeUInt16LE(buffer, value, offset) {
+        buffer.writeUInt16LE(value, offset);
+    }
+    /**
+     * 读取无符号 32 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param offset 偏移量
+     */
+    static readUInt32LE(buffer, offset) {
+        return buffer.readUInt32LE(offset);
+    }
+    /**
+     * 写入无符号 32 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param value 值
+     * @param offset 偏移量
+     */
+    static writeUInt32LE(buffer, value, offset) {
+        buffer.writeUInt32LE(value, offset);
+    }
+    /**
+     * 读取有符号 32 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param offset 偏移量
+     */
+    static readInt32LE(buffer, offset) {
+        return buffer.readInt32LE(offset);
+    }
+    /**
+     * 写入有符号 32 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param value 值
+     * @param offset 偏移量
+     */
+    static writeInt32LE(buffer, value, offset) {
+        buffer.writeInt32LE(value, offset);
+    }
+    /**
+     * 读取无符号 64 位整数（Little-Endian）
+     * 返回 BigInt 类型
+     * @param buffer 数据缓冲区
+     * @param offset 偏移量
+     */
+    static readBigUInt64LE(buffer, offset) {
+        return buffer.readBigUInt64LE(offset);
+    }
+    /**
+     * 写入无符号 64 位整数（Little-Endian）
+     * @param buffer 数据缓冲区
+     * @param value 值
+     * @param offset 偏移量
+     */
+    static writeBigUInt64LE(buffer, value, offset) {
+        buffer.writeBigUInt64LE(value, offset);
+    }
+    /**
+     * 读取字符串（UTF-8 编码）
+     * @param buffer 数据缓冲区
+     * @param offset 起始偏移量
+     * @param length 字符串字节长度
+     */
+    static readString(buffer, offset, length) {
+        return buffer.toString("utf8", offset, offset + length);
+    }
+    /**
+     * 写入字符串（UTF-8 编码）
+     * @param buffer 数据缓冲区
+     * @param value 字符串值
+     * @param offset 起始偏移量
+     * @returns 实际写入的字节数
+     */
+    static writeString(buffer, value, offset) {
+        return buffer.write(value, offset, "utf8");
+    }
+    /**
+     * 计算字符串的字节长度（UTF-8 编码）
+     * @param value 字符串值
+     */
+    static stringByteLength(value) {
+        return Buffer.byteLength(value, "utf8");
+    }
+    /**
+     * 分配指定大小的 Buffer（未初始化）
+     * 比 Buffer.alloc 更快，但内容未定义
+     * @param size Buffer 大小
+     */
+    static allocUnsafe(size) {
+        return Buffer.allocUnsafe(size);
+    }
+    /**
+     * 分配指定大小的 Buffer（初始化为零）
+     * @param size Buffer 大小
+     */
+    static alloc(size) {
+        return Buffer.alloc(size);
+    }
+    /**
+     * 连接多个 Buffer
+     * @param buffers Buffer 数组
+     */
+    static concat(buffers) {
+        return Buffer.concat(buffers);
+    }
+    /**
+     * 复制 Buffer 的一部分
+     * @param source 源 Buffer
+     * @param start 起始位置
+     * @param end 结束位置
+     */
+    static slice(source, start, end) {
+        return source.subarray(start, end);
+    }
+    /**
+     * 比较两个 Buffer 是否相等
+     * @param a 第一个 Buffer
+     * @param b 第二个 Buffer
+     */
+    static equals(a, b) {
+        if (a.length !== b.length) {
+            return false;
+        }
+        return a.equals(b);
+    }
+}
+exports.BinaryUtils = BinaryUtils;
+/**
+ * Buffer 写入器
+ * 提供便捷的顺序写入功能
+ */
+class BufferWriter {
+    /**
+     * 创建 Buffer 写入器
+     * @param size 初始 Buffer 大小
+     */
+    constructor(size) {
+        this.buffer = Buffer.allocUnsafe(size);
+        this.offset = 0;
+    }
+    /**
+     * 获取当前写入位置
+     */
+    get position() {
+        return this.offset;
+    }
+    /**
+     * 获取已写入的数据
+     */
+    get data() {
+        return this.buffer.subarray(0, this.offset);
+    }
+    /**
+     * 确保有足够的空间
+     * @param additional 需要的额外空间
+     */
+    ensureCapacity(additional) {
+        const required = this.offset + additional;
+        if (required > this.buffer.length) {
+            const newBuffer = Buffer.allocUnsafe(Math.max(required, this.buffer.length * 2));
+            this.buffer.copy(newBuffer, 0, 0, this.offset);
+            this.buffer = newBuffer;
+        }
+    }
+    /**
+     * 写入无符号 8 位整数
+     */
+    writeUInt8(value) {
+        this.ensureCapacity(1);
+        this.buffer.writeUInt8(value, this.offset);
+        this.offset += 1;
+        return this;
+    }
+    /**
+     * 写入无符号 16 位整数（Little-Endian）
+     */
+    writeUInt16LE(value) {
+        this.ensureCapacity(2);
+        this.buffer.writeUInt16LE(value, this.offset);
+        this.offset += 2;
+        return this;
+    }
+    /**
+     * 写入无符号 32 位整数（Little-Endian）
+     */
+    writeUInt32LE(value) {
+        this.ensureCapacity(4);
+        this.buffer.writeUInt32LE(value, this.offset);
+        this.offset += 4;
+        return this;
+    }
+    /**
+     * 写入无符号 64 位整数（Little-Endian）
+     */
+    writeBigUInt64LE(value) {
+        this.ensureCapacity(8);
+        this.buffer.writeBigUInt64LE(value, this.offset);
+        this.offset += 8;
+        return this;
+    }
+    /**
+     * 写入字符串（带长度前缀）
+     */
+    writeString(value) {
+        const byteLength = BinaryUtils.stringByteLength(value);
+        this.writeUInt32LE(byteLength);
+        this.ensureCapacity(byteLength);
+        BinaryUtils.writeString(this.buffer, value, this.offset);
+        this.offset += byteLength;
+        return this;
+    }
+    /**
+     * 写入字符串（不带长度前缀）
+     */
+    writeStringRaw(value) {
+        const byteLength = BinaryUtils.stringByteLength(value);
+        this.ensureCapacity(byteLength);
+        BinaryUtils.writeString(this.buffer, value, this.offset);
+        this.offset += byteLength;
+        return this;
+    }
+    /**
+     * 写入 Buffer
+     */
+    writeBuffer(value) {
+        this.ensureCapacity(value.length);
+        value.copy(this.buffer, this.offset);
+        this.offset += value.length;
+        return this;
+    }
+    /**
+     * 写入带长度前缀的 Buffer
+     */
+    writeBufferWithLength(value) {
+        this.writeUInt32LE(value.length);
+        this.writeBuffer(value);
+        return this;
+    }
+    /**
+     * 写入校验和（计算从起始位置到当前位置的数据）
+     */
+    writeChecksum(startOffset = 0) {
+        const checksum = BinaryUtils.calculateChecksum(this.buffer, startOffset, this.offset - startOffset);
+        this.writeUInt32LE(checksum);
+        return this;
+    }
+}
+exports.BufferWriter = BufferWriter;
+/**
+ * Buffer 读取器
+ * 提供便捷的顺序读取功能
+ */
+class BufferReader {
+    /**
+     * 创建 Buffer 读取器
+     * @param buffer 要读取的 Buffer
+     * @param startOffset 起始偏移量，默认 0
+     */
+    constructor(buffer, startOffset = 0) {
+        this.buffer = buffer;
+        this.offset = startOffset;
+    }
+    /**
+     * 获取当前读取位置
+     */
+    get position() {
+        return this.offset;
+    }
+    /**
+     * 设置读取位置
+     */
+    set position(value) {
+        this.offset = value;
+    }
+    /**
+     * 获取剩余可读字节数
+     */
+    get remaining() {
+        return this.buffer.length - this.offset;
+    }
+    /**
+     * 检查是否有足够的可读数据
+     */
+    hasRemaining(required) {
+        return this.remaining >= required;
+    }
+    /**
+     * 读取无符号 8 位整数
+     */
+    readUInt8() {
+        const value = this.buffer.readUInt8(this.offset);
+        this.offset += 1;
+        return value;
+    }
+    /**
+     * 读取无符号 16 位整数（Little-Endian）
+     */
+    readUInt16LE() {
+        const value = this.buffer.readUInt16LE(this.offset);
+        this.offset += 2;
+        return value;
+    }
+    /**
+     * 读取无符号 32 位整数（Little-Endian）
+     */
+    readUInt32LE() {
+        const value = this.buffer.readUInt32LE(this.offset);
+        this.offset += 4;
+        return value;
+    }
+    /**
+     * 读取无符号 64 位整数（Little-Endian）
+     */
+    readBigUInt64LE() {
+        const value = this.buffer.readBigUInt64LE(this.offset);
+        this.offset += 8;
+        return value;
+    }
+    /**
+     * 读取字符串（带长度前缀）
+     */
+    readString() {
+        const length = this.readUInt32LE();
+        const value = BinaryUtils.readString(this.buffer, this.offset, length);
+        this.offset += length;
+        return value;
+    }
+    /**
+     * 读取指定长度的 Buffer
+     */
+    readBuffer(length) {
+        const value = this.buffer.subarray(this.offset, this.offset + length);
+        this.offset += length;
+        return value;
+    }
+    /**
+     * 读取带长度前缀的 Buffer
+     */
+    readBufferWithLength() {
+        const length = this.readUInt32LE();
+        return this.readBuffer(length);
+    }
+    /**
+     * 读取并验证校验和
+     */
+    readAndVerifyChecksum(startOffset) {
+        const checksum = this.readUInt32LE();
+        BinaryUtils.verifyChecksum(this.buffer, checksum, startOffset, this.offset - startOffset - 4);
+        return checksum;
+    }
+    /**
+     * 跳过指定字节数
+     */
+    skip(bytes) {
+        this.offset += bytes;
+        return this;
+    }
+}
+exports.BufferReader = BufferReader;
+//# sourceMappingURL=binary.js.map

package/dist/utils/binary.js.map

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

package/dist/utils/file.d.ts

@@ -0,0 +1,166 @@
+/**
+ * 文件操作工具类
+ * 提供文件系统操作的封装
+ */
+import { promises as fs } from "fs";
+/**
+ * 文件操作工具类
+ * 提供静态方法用于文件系统操作
+ */
+export declare class FileUtils {
+    /**
+     * 检查文件是否存在
+     * @param filePath 文件路径
+     */
+    static exists(filePath: string): Promise<boolean>;
+    /**
+     * 确保目录存在，不存在则创建
+     * @param dirPath 目录路径
+     */
+    static ensureDir(dirPath: string): Promise<void>;
+    /**
+     * 读取文件内容
+     * @param filePath 文件路径
+     */
+    static readFile(filePath: string): Promise<Buffer>;
+    /**
+     * 写入文件内容
+     * @param filePath 文件路径
+     * @param data 文件内容
+     */
+    static writeFile(filePath: string, data: Buffer): Promise<void>;
+    /**
+     * 追加写入文件
+     * @param filePath 文件路径
+     * @param data 要追加的数据
+     */
+    static appendFile(filePath: string, data: Buffer): Promise<void>;
+    /**
+     * 删除文件
+     * @param filePath 文件路径
+     */
+    static deleteFile(filePath: string): Promise<void>;
+    /**
+     * 原子性重命名文件
+     * @param oldPath 原文件路径
+     * @param newPath 新文件路径
+     */
+    static rename(oldPath: string, newPath: string): Promise<void>;
+    /**
+     * 获取文件大小
+     * @param filePath 文件路径
+     */
+    static getFileSize(filePath: string): Promise<number>;
+    /**
+     * 同步文件到磁盘
+     * @param filePath 文件路径
+     */
+    static syncFile(filePath: string): Promise<void>;
+    /**
+     * 打开文件句柄
+     * @param filePath 文件路径
+     * @param flags 打开标志
+     */
+    static openFile(filePath: string, flags: string): Promise<fs.FileHandle>;
+    /**
+     * 从指定位置读取文件
+     * @param handle 文件句柄
+     * @param buffer 目标缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 读取长度
+     * @param position 文件位置
+     */
+    static readFromPosition(handle: fs.FileHandle, buffer: Buffer, offset: number, length: number, position: number): Promise<number>;
+    /**
+     * 在指定位置写入文件
+     * @param handle 文件句柄
+     * @param buffer 源缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 写入长度
+     * @param position 文件位置
+     */
+    static writeToPosition(handle: fs.FileHandle, buffer: Buffer, offset: number, length: number, position: number): Promise<number>;
+    /**
+     * 截断文件到指定大小
+     * @param filePath 文件路径
+     * @param size 目标大小
+     */
+    static truncateFile(filePath: string, size: number): Promise<void>;
+    /**
+     * 构建完整文件路径
+     * @param basePath 基础路径
+     * @param name 文件名（不含扩展名）
+     * @param extension 文件扩展名
+     */
+    static buildFilePath(basePath: string, name: string, extension: string): string;
+    /**
+     * 解析文件名（不含扩展名）
+     * @param filePath 文件路径
+     */
+    static getFileName(filePath: string): string;
+    /**
+     * 获取目录路径
+     * @param filePath 文件路径
+     */
+    static getDirPath(filePath: string): string;
+}
+/**
+ * 文件句柄包装类
+ * 提供更高级的文件操作接口
+ */
+export declare class FileHandleWrapper {
+    private handle;
+    private readonly filePath;
+    private readonly flags;
+    /**
+     * 创建文件句柄包装
+     * @param filePath 文件路径
+     * @param flags 打开标志
+     */
+    constructor(filePath: string, flags: string);
+    /**
+     * 打开文件
+     */
+    open(): Promise<void>;
+    /**
+     * 关闭文件
+     */
+    close(): Promise<void>;
+    /**
+     * 确保文件已打开
+     */
+    private ensureOpen;
+    /**
+     * 读取数据
+     * @param buffer 目标缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 读取长度
+     * @param position 文件位置
+     */
+    read(buffer: Buffer, offset: number, length: number, position: number): Promise<number>;
+    /**
+     * 写入数据
+     * @param buffer 源缓冲区
+     * @param offset 缓冲区偏移
+     * @param length 写入长度
+     * @param position 文件位置
+     */
+    write(buffer: Buffer, offset: number, length: number, position: number): Promise<number>;
+    /**
+     * 同步到磁盘
+     */
+    sync(): Promise<void>;
+    /**
+     * 获取文件大小
+     */
+    size(): Promise<number>;
+    /**
+     * 获取文件路径
+     */
+    get path(): string;
+    /**
+     * 检查是否已打开
+     */
+    get isOpen(): boolean;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

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