@yydb/light-db 0.0.0

package/dist/storage/WALFile.d.ts

@@ -0,0 +1,248 @@
+/**
+ * WAL（预写日志）文件实现
+ * 记录每一次写操作的增量日志，用于崩溃恢复与异步持久化
+ */
+import { WalRecord, WriteResult, BatchWriteResult, WalRecordIterator } from "../types";
+/**
+ * WAL 记录序列化器
+ * 负责将 WAL 记录序列化为二进制格式
+ */
+export declare class WalRecordSerializer {
+    /**
+     * 序列化 WAL 记录
+     * @param record WAL 记录
+     */
+    serialize(record: WalRecord): Buffer;
+    /**
+     * 反序列化 WAL 记录
+     * @param buffer 包含记录数据的 Buffer
+     * @param startOffset 起始偏移量
+     */
+    deserialize(
+        buffer: Buffer,
+        startOffset?: number,
+    ): {
+        record: WalRecord;
+        bytesRead: number;
+    } | null;
+    /**
+     * 计算记录大小
+     * @param key 键
+     * @param value 值（可选）
+     */
+    calculateRecordSize(key: string, value: Buffer | null): number;
+}
+/**
+ * WAL 文件写入器
+ * 负责将 WAL 记录追加写入文件
+ */
+export declare class WalWriter {
+    private readonly filePath;
+    private handle;
+    private readonly serializer;
+    private currentOffset;
+    private pendingSync;
+    private readonly syncStrategy;
+    private readonly batchSize;
+    private writeCount;
+    /**
+     * 创建 WAL 写入器
+     * @param basePath 数据库基础路径
+     * @param dbName 数据库名称
+     * @param syncStrategy 同步策略
+     * @param batchSize 批量写入大小
+     */
+    constructor(basePath: string, dbName: string, syncStrategy?: "always" | "batch" | "interval", batchSize?: number);
+    /**
+     * 打开 WAL 文件
+     */
+    open(): Promise<void>;
+    /**
+     * 关闭 WAL 文件
+     */
+    close(): Promise<void>;
+    /**
+     * 写入单条 WAL 记录
+     * @param record WAL 记录
+     */
+    write(record: WalRecord): Promise<WriteResult>;
+    /**
+     * 批量写入 WAL 记录
+     * @param records WAL 记录数组
+     */
+    writeBatch(records: WalRecord[]): Promise<BatchWriteResult>;
+    /**
+     * 同步到磁盘
+     */
+    sync(): Promise<void>;
+    /**
+     * 获取当前文件大小
+     */
+    getFileSize(): Promise<number>;
+    /**
+     * 获取当前偏移量
+     */
+    getCurrentOffset(): number;
+    /**
+     * 清空 WAL 文件
+     */
+    clear(): Promise<void>;
+    /**
+     * 获取文件路径
+     */
+    getFilePath(): string;
+}
+/**
+ * WAL 文件读取器
+ * 负责顺序读取 WAL 记录
+ */
+export declare class WalReader {
+    private readonly filePath;
+    private handle;
+    private readonly serializer;
+    private fileSize;
+    private currentOffset;
+    private readBufferSize;
+    private readBuffer;
+    private bufferValidBytes;
+    /**
+     * 创建 WAL 读取器
+     * @param basePath 数据库基础路径
+     * @param dbName 数据库名称
+     * @param readBufferSize 读取缓冲区大小，默认 64KB
+     */
+    constructor(basePath: string, dbName: string, readBufferSize?: number);
+    /**
+     * 打开 WAL 文件
+     */
+    open(): Promise<void>;
+    /**
+     * 关闭 WAL 文件
+     */
+    close(): Promise<void>;
+    /**
+     * 填充读取缓冲区
+     */
+    private fillBuffer;
+    /**
+     * 读取下一条 WAL 记录
+     */
+    readNext(): Promise<WalRecord | null>;
+    /**
+     * 创建 WAL 记录迭代器
+     */
+    iterate(): WalRecordIterator;
+    /**
+     * 从指定偏移量开始读取
+     * @param offset 起始偏移量
+     */
+    seek(offset: number): Promise<void>;
+    /**
+     * 获取当前偏移量
+     */
+    getCurrentOffset(): number;
+    /**
+     * 获取文件大小
+     */
+    getFileSize(): number;
+    /**
+     * 读取所有 WAL 记录
+     */
+    readAll(): Promise<WalRecord[]>;
+    /**
+     * 获取文件路径
+     */
+    getFilePath(): string;
+}
+/**
+ * WAL 管理器
+ * 提供统一的 WAL 读写接口
+ */
+export declare class WalManager {
+    private readonly basePath;
+    private readonly dbName;
+    private writer;
+    private reader;
+    private currentLsn;
+    private currentTransactionId;
+    /**
+     * 创建 WAL 管理器
+     * @param basePath 数据库基础路径
+     * @param dbName 数据库名称
+     */
+    constructor(basePath: string, dbName: string);
+    /**
+     * 初始化 WAL 管理器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 获取最后一条记录的 LSN
+     */
+    getLastLsn(): Promise<bigint>;
+    /**
+     * 分配新的 LSN
+     */
+    allocateLsn(): bigint;
+    /**
+     * 分配新的事务 ID
+     */
+    allocateTransactionId(): bigint;
+    /**
+     * 写入插入记录
+     * @param key 键
+     * @param value 值
+     */
+    writeInsert(key: string, value: Buffer): Promise<WriteResult>;
+    /**
+     * 写入更新记录
+     * @param key 键
+     * @param value 新值
+     */
+    writeUpdate(key: string, value: Buffer): Promise<WriteResult>;
+    /**
+     * 写入删除记录
+     * @param key 键
+     */
+    writeDelete(key: string): Promise<WriteResult>;
+    /**
+     * 写入检查点标记
+     */
+    writeCheckpoint(): Promise<WriteResult>;
+    /**
+     * 同步 WAL 到磁盘
+     */
+    sync(): Promise<void>;
+    /**
+     * 清空 WAL 文件
+     */
+    clear(): Promise<void>;
+    /**
+     * 获取 WAL 文件大小
+     */
+    getFileSize(): Promise<number>;
+    /**
+     * 创建记录迭代器
+     */
+    iterateRecords(): WalRecordIterator;
+    /**
+     * 读取所有记录
+     */
+    readAllRecords(): Promise<WalRecord[]>;
+    /**
+     * 关闭 WAL 管理器
+     */
+    close(): Promise<void>;
+    /**
+     * 获取当前 LSN
+     */
+    getCurrentLsn(): bigint;
+    /**
+     * 获取当前事务 ID
+     */
+    getCurrentTransactionId(): bigint;
+    /**
+     * 设置当前 LSN（用于恢复）
+     */
+    setCurrentLsn(lsn: bigint): void;
+}
+//# sourceMappingURL=WALFile.d.ts.map

package/dist/storage/WALFile.d.ts.map

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