@yydb/light-db 0.0.0 → 0.0.11

package/dist/storage/WALFile.d.ts

@@ -1,248 +0,0 @@
-/**
- * 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

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