@yydb/light-db 0.0.0 → 0.0.11

package/dist/storage/Checkpoint.js

@@ -1,251 +0,0 @@
-"use strict";
-/**
- * 检查点（Checkpoint）机制实现
- * 将内存中的完整数据原子性写入新的 .light 文件
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IncrementalCheckpointManager = exports.AutoCheckpointScheduler = exports.CheckpointManager = void 0;
-const constants_1 = require("../constants");
-const errors_1 = require("../errors");
-/**
- * 检查点管理器
- * 负责管理检查点的创建和协调
- */
-class CheckpointManager {
-    /**
-     * 创建检查点管理器
-     * @param lightFileManager Light 文件管理器
-     * @param walManager WAL 管理器
-     * @param walIndexManager WAL 索引管理器
-     * @param pageManager 页面管理器
-     * @param walThreshold WAL 文件大小阈值
-     */
-    constructor(lightFileManager, walManager, walIndexManager, pageManager, walThreshold = constants_1.DEFAULT_WAL_THRESHOLD) {
-        this.lightFileManager = lightFileManager;
-        this.walManager = walManager;
-        this.walIndexManager = walIndexManager;
-        this.pageManager = pageManager;
-        this.walThreshold = walThreshold;
-        this.lastCheckpointTime = null;
-        this.checkpointInProgress = false;
-    }
-    /**
-     * 检查是否需要执行检查点
-     */
-    async shouldCheckpoint() {
-        if (this.checkpointInProgress) {
-            return false;
-        }
-        const walSize = await this.walManager.getFileSize();
-        return walSize >= this.walThreshold;
-    }
-    /**
-     * 执行检查点
-     * @param records 当前内存中的所有记录
-     */
-    async execute(records) {
-        if (this.checkpointInProgress) {
-            throw new errors_1.CheckpointError("Checkpoint already in progress");
-        }
-        this.checkpointInProgress = true;
-        try {
-            const currentLsn = this.walManager.getCurrentLsn();
-            await this.walManager.writeCheckpoint();
-            await this.walManager.sync();
-            const pages = this.buildPages(records);
-            await this.lightFileManager.writeSnapshot(pages, currentLsn);
-            await this.walManager.clear();
-            await this.walIndexManager.resetAfterCheckpoint(currentLsn);
-            this.pageManager.loadPages(pages);
-            this.pageManager.clearDirtyFlags();
-            this.lastCheckpointTime = Date.now();
-            const endTime = Date.now();
-            const bytesWritten = await this.lightFileManager.getFileSize();
-            return {
-                timestamp: endTime,
-                lsn: currentLsn,
-                pagesWritten: pages.size,
-                bytesWritten,
-            };
-        } catch (error) {
-            const err = error;
-            throw new errors_1.CheckpointError(`Checkpoint failed: ${err.message}`, this.walManager.getCurrentLsn());
-        } finally {
-            this.checkpointInProgress = false;
-        }
-    }
-    /**
-     * 将记录转换为页面
-     * @param records 记录映射
-     */
-    buildPages(records) {
-        const pages = new Map();
-        const pageSize = this.pageManager.getPageSize();
-        let currentPageId = 0;
-        let currentRecords = [];
-        let currentSize = 0;
-        const headerSize = 12;
-        const recordOverhead = 4 + 4 + 4;
-        for (const [key, value] of records) {
-            const keyLength = Buffer.byteLength(key, "utf8");
-            const recordSize = recordOverhead + keyLength + value.length;
-            if (currentSize + recordSize > pageSize - headerSize - 4 && currentRecords.length > 0) {
-                pages.set(currentPageId, {
-                    pageId: currentPageId,
-                    records: currentRecords.map((r) => ({ key: r.key, value: r.value })),
-                    checksum: 0,
-                });
-                currentPageId++;
-                currentRecords = [];
-                currentSize = 0;
-            }
-            currentRecords.push({ key, value });
-            currentSize += recordSize;
-        }
-        if (currentRecords.length > 0) {
-            pages.set(currentPageId, {
-                pageId: currentPageId,
-                records: currentRecords.map((r) => ({ key: r.key, value: r.value })),
-                checksum: 0,
-            });
-        }
-        return pages;
-    }
-    /**
-     * 获取上次检查点时间
-     */
-    getLastCheckpointTime() {
-        return this.lastCheckpointTime;
-    }
-    /**
-     * 检查是否有检查点正在进行
-     */
-    isCheckpointInProgress() {
-        return this.checkpointInProgress;
-    }
-    /**
-     * 获取 WAL 阈值
-     */
-    getWalThreshold() {
-        return this.walThreshold;
-    }
-}
-exports.CheckpointManager = CheckpointManager;
-/**
- * 自动检查点调度器
- * 根据配置自动触发检查点
- */
-class AutoCheckpointScheduler {
-    /**
-     * 创建自动检查点调度器
-     * @param checkpointManager 检查点管理器
-     * @param interval 检查间隔（毫秒）
-     * @param getRecords 获取当前记录的函数
-     */
-    constructor(checkpointManager, interval, getRecords) {
-        this.checkpointManager = checkpointManager;
-        this.interval = interval;
-        this.timer = null;
-        this.running = false;
-        this.getRecords = getRecords;
-    }
-    /**
-     * 启动调度器
-     */
-    start() {
-        if (this.running) {
-            return;
-        }
-        this.running = true;
-        this.timer = setInterval(async () => {
-            try {
-                if (await this.checkpointManager.shouldCheckpoint()) {
-                    await this.checkpointManager.execute(this.getRecords());
-                }
-            } catch {
-                // 静默处理错误，避免影响定时器
-            }
-        }, this.interval);
-    }
-    /**
-     * 停止调度器
-     */
-    stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        this.running = false;
-    }
-    /**
-     * 检查是否正在运行
-     */
-    isRunning() {
-        return this.running;
-    }
-}
-exports.AutoCheckpointScheduler = AutoCheckpointScheduler;
-/**
- * 增量检查点管理器
- * 只将脏页写入文件，减少 I/O
- */
-class IncrementalCheckpointManager {
-    /**
-     * 创建增量检查点管理器
-     * @param lightFileManager Light 文件管理器
-     * @param walManager WAL 管理器
-     * @param pageManager 页面管理器
-     * @param walThreshold WAL 阈值
-     */
-    constructor(lightFileManager, walManager, pageManager, walThreshold = constants_1.DEFAULT_WAL_THRESHOLD) {
-        this.lightFileManager = lightFileManager;
-        this.walManager = walManager;
-        this.pageManager = pageManager;
-        this.walThreshold = walThreshold;
-    }
-    /**
-     * 执行增量检查点
-     */
-    async executeIncremental() {
-        const dirtyPages = this.pageManager.getDirtyPages();
-        if (dirtyPages.length === 0) {
-            return {
-                timestamp: Date.now(),
-                lsn: this.walManager.getCurrentLsn(),
-                pagesWritten: 0,
-                bytesWritten: 0,
-            };
-        }
-        const currentLsn = this.walManager.getCurrentLsn();
-        for (const page of dirtyPages) {
-            await this.lightFileManager.writePage(page);
-        }
-        await this.lightFileManager.sync();
-        const header = await this.lightFileManager.readHeader();
-        if (header) {
-            header.lastSnapshotLsn = currentLsn;
-            await this.lightFileManager.writeHeader(header);
-        }
-        this.pageManager.clearDirtyFlags();
-        const totalBytes = dirtyPages.length * this.pageManager.getPageSize();
-        return {
-            timestamp: Date.now(),
-            lsn: currentLsn,
-            pagesWritten: dirtyPages.length,
-            bytesWritten: totalBytes,
-        };
-    }
-    /**
-     * 检查是否需要增量检查点
-     */
-    async shouldCheckpoint() {
-        const dirtyPages = this.pageManager.getDirtyPages();
-        if (dirtyPages.length > 100) {
-            return true;
-        }
-        const walSize = await this.walManager.getFileSize();
-        return walSize >= this.walThreshold;
-    }
-}
-exports.IncrementalCheckpointManager = IncrementalCheckpointManager;
-//# sourceMappingURL=Checkpoint.js.map

package/dist/storage/Checkpoint.js.map

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

package/dist/storage/LightFile.d.ts

@@ -1,227 +0,0 @@
-/**
- * .light 文件格式实现
- * 主数据文件，存储数据库的完整快照
- */
-import { LightHeader, Page, Record, PageMap, RecordMap } from "../types";
-/**
- * Light 文件序列化器
- * 负责将数据序列化为 .light 文件格式
- */
-export declare class LightFileSerializer {
-    private readonly pageSize;
-    /**
-     * 创建序列化器
-     * @param pageSize 页面大小，默认 4KB
-     */
-    constructor(pageSize?: number);
-    /**
-     * 序列化文件头部
-     * @param header 头部数据
-     */
-    serializeHeader(header: LightHeader): Buffer;
-    /**
-     * 反序列化文件头部
-     * @param buffer 包含头部数据的 Buffer
-     */
-    deserializeHeader(buffer: Buffer): LightHeader;
-    /**
-     * 序列化单条记录
-     * @param record 记录数据
-     */
-    serializeRecord(record: Record): Buffer;
-    /**
-     * 反序列化单条记录
-     * @param buffer 包含记录数据的 Buffer
-     * @param startOffset 起始偏移量
-     */
-    deserializeRecord(
-        buffer: Buffer,
-        startOffset?: number,
-    ): {
-        record: Record;
-        bytesRead: number;
-    };
-    /**
-     * 序列化页面
-     * @param page 页面数据
-     */
-    serializePage(page: Page): Buffer;
-    /**
-     * 反序列化页面
-     * @param buffer 包含页面数据的 Buffer
-     * @param pageId 页面ID
-     */
-    deserializePage(buffer: Buffer, pageId: number): Page;
-    /**
-     * 序列化整个数据库快照
-     * @param pages 页面映射
-     * @param lastSnapshotLsn 上次快照的 LSN
-     */
-    serializeSnapshot(pages: PageMap, lastSnapshotLsn: bigint): Buffer;
-    /**
-     * 获取页面大小
-     */
-    getPageSize(): number;
-}
-/**
- * Light 文件管理器
- * 负责 .light 文件的读写操作
- */
-export declare class LightFileManager {
-    private readonly basePath;
-    private readonly dbName;
-    private readonly serializer;
-    private handle;
-    /**
-     * 创建文件管理器
-     * @param basePath 数据库基础路径
-     * @param dbName 数据库名称
-     * @param pageSize 页面大小
-     */
-    constructor(basePath: string, dbName: string, pageSize?: number);
-    /**
-     * 获取 .light 文件路径
-     */
-    getFilePath(): string;
-    /**
-     * 获取临时文件路径
-     */
-    private getTempFilePath;
-    /**
-     * 打开文件
-     */
-    open(): Promise<void>;
-    /**
-     * 关闭文件
-     */
-    close(): Promise<void>;
-    /**
-     * 读取文件头部
-     */
-    readHeader(): Promise<LightHeader | null>;
-    /**
-     * 写入文件头部
-     * @param header 头部数据
-     */
-    writeHeader(header: LightHeader): Promise<void>;
-    /**
-     * 读取指定页面
-     * @param pageId 页面ID
-     */
-    readPage(pageId: number): Promise<Page | null>;
-    /**
-     * 写入指定页面
-     * @param page 页面数据
-     */
-    writePage(page: Page): Promise<void>;
-    /**
-     * 加载所有页面
-     */
-    loadAllPages(): Promise<PageMap>;
-    /**
-     * 加载所有记录到内存映射
-     */
-    loadAllRecords(): Promise<RecordMap>;
-    /**
-     * 原子性写入完整快照
-     * 先写临时文件，再 rename 确保原子性
-     * @param pages 页面映射
-     * @param lastSnapshotLsn 上次快照的 LSN
-     */
-    writeSnapshot(pages: PageMap, lastSnapshotLsn: bigint): Promise<void>;
-    /**
-     * 获取文件大小
-     */
-    getFileSize(): Promise<number>;
-    /**
-     * 同步到磁盘
-     */
-    sync(): Promise<void>;
-    /**
-     * 检查文件是否存在
-     */
-    exists(): Promise<boolean>;
-    /**
-     * 获取页面大小
-     */
-    getPageSize(): number;
-}
-/**
- * 页面管理器
- * 管理内存中的页面分配和回收
- */
-export declare class PageManager {
-    private readonly pageSize;
-    private pages;
-    private nextPageId;
-    private dirtyPages;
-    /**
-     * 创建页面管理器
-     * @param pageSize 页面大小
-     */
-    constructor(pageSize?: number);
-    /**
-     * 创建新页面
-     */
-    createPage(): Page;
-    /**
-     * 获取页面
-     * @param pageId 页面ID
-     */
-    getPage(pageId: number): Page | undefined;
-    /**
-     * 获取或创建页面
-     * @param pageId 页面ID
-     */
-    getOrCreatePage(pageId: number): Page;
-    /**
-     * 标记页面为脏页
-     * @param pageId 页面ID
-     */
-    markDirty(pageId: number): void;
-    /**
-     * 获取所有脏页
-     */
-    getDirtyPages(): Page[];
-    /**
-     * 清除脏页标记
-     */
-    clearDirtyFlags(): void;
-    /**
-     * 加载页面数据
-     * @param pages 页面映射
-     */
-    loadPages(pages: PageMap): void;
-    /**
-     * 获取所有页面
-     */
-    getAllPages(): PageMap;
-    /**
-     * 获取页面数量
-     */
-    getPageCount(): number;
-    /**
-     * 计算记录在页面中的大小
-     * @param record 记录
-     */
-    calculateRecordSize(record: Record): number;
-    /**
-     * 获取页面可用空间
-     * @param page 页面
-     */
-    getAvailableSpace(page: Page): number;
-    /**
-     * 查找可以容纳记录的页面
-     * @param record 记录
-     */
-    findPageForRecord(record: Record): Page | null;
-    /**
-     * 获取下一个页面ID
-     */
-    getNextPageId(): number;
-    /**
-     * 获取页面大小
-     */
-    getPageSize(): number;
-}
-//# sourceMappingURL=LightFile.d.ts.map

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

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