@yydb/light-db 0.0.0 → 0.0.11

package/dist/codec/page.js

@@ -0,0 +1,225 @@
+/**
+ * 页与快照编解码
+ *
+ * 快照由一个固定长度头部和若干固定长度页组成，全部基于 `Uint8Array`。
+ */
+import { ByteReader, ByteWriter, BinaryUtils, ChecksumMismatchError } from './binary';
+import { crc32 } from './checksum';
+/** 快照魔数：`LIGH` */
+export const SNAPSHOT_MAGIC = 0x4c494748;
+/** 快照格式版本 */
+export const SNAPSHOT_VERSION = 1;
+/** 默认页大小：4KB */
+export const DEFAULT_PAGE_SIZE = 4096;
+/** 快照头部长度：魔数(4) + 版本(4) + 页大小(4) + 最近快照 LSN(8) + 保留(16) */
+export const SNAPSHOT_HEADER_SIZE = 36;
+/** 页头部长度：页号(4) + 记录数(2) + 空闲空间(2) */
+export const PAGE_HEADER_SIZE = 8;
+/** 页尾校验和长度 */
+export const PAGE_CHECKSUM_SIZE = 4;
+/** 记录尾校验和长度 */
+export const RECORD_CHECKSUM_SIZE = 4;
+/** 单条记录超出页容量 */
+export class RecordTooLargeError extends Error {
+    /** 记录所需字节数 */
+    size;
+    /** 页可用字节数 */
+    capacity;
+    constructor(size, capacity) {
+        super(`Record needs ${size} bytes but a page only has ${capacity}`);
+        this.name = 'RecordTooLargeError';
+        this.size = size;
+        this.capacity = capacity;
+        Object.setPrototypeOf(this, RecordTooLargeError.prototype);
+    }
+}
+/** 快照格式错误 */
+export class SnapshotFormatError extends Error {
+    /** 失败原因 */
+    reason;
+    constructor(reason) {
+        super(`Snapshot format error: ${reason}`);
+        this.name = 'SnapshotFormatError';
+        this.reason = reason;
+        Object.setPrototypeOf(this, SnapshotFormatError.prototype);
+    }
+}
+/**
+ * 计算记录编码后的字节数
+ * @param key 键
+ * @param value 值
+ */
+export function recordSize(key, value) {
+    return 4 + BinaryUtils.byteLength(key) + 4 + value.length + RECORD_CHECKSUM_SIZE;
+}
+/**
+ * 序列化快照头部
+ * @param header 头部
+ */
+export function encodeHeader(header) {
+    const writer = new ByteWriter(SNAPSHOT_HEADER_SIZE);
+    writer.writeUInt32LE(header.magic);
+    writer.writeUInt32LE(header.version);
+    writer.writeUInt32LE(header.pageSize);
+    writer.writeBigUInt64LE(header.lastSnapshotLsn);
+    writer.writeBytes(BinaryUtils.alloc(16));
+    return writer.data;
+}
+/**
+ * 反序列化快照头部
+ * @param data 数据
+ */
+export function decodeHeader(data) {
+    if (data.length < SNAPSHOT_HEADER_SIZE) {
+        throw new SnapshotFormatError(`header needs ${SNAPSHOT_HEADER_SIZE} bytes, got ${data.length}`);
+    }
+    const reader = new ByteReader(data);
+    const magic = reader.readUInt32LE();
+    const version = reader.readUInt32LE();
+    const pageSize = reader.readUInt32LE();
+    const lastSnapshotLsn = reader.readBigUInt64LE();
+    if (magic !== SNAPSHOT_MAGIC) {
+        throw new SnapshotFormatError(`unexpected magic ${magic}`);
+    }
+    if (pageSize <= 0) {
+        throw new SnapshotFormatError(`invalid page size ${pageSize}`);
+    }
+    return { magic, version, pageSize, lastSnapshotLsn };
+}
+/**
+ * 序列化单条记录
+ * @param record 记录
+ */
+export function encodeRecord(record) {
+    const writer = new ByteWriter(recordSize(record.key, record.value));
+    writer.writeString(record.key);
+    writer.writeBytesWithLength(record.value);
+    writer.writeChecksum(0);
+    return writer.data;
+}
+/**
+ * 序列化页
+ * @param page 页
+ * @param pageSize 页大小
+ */
+export function encodePage(page, pageSize = DEFAULT_PAGE_SIZE) {
+    const capacity = pageSize - PAGE_HEADER_SIZE - PAGE_CHECKSUM_SIZE;
+    const payload = [];
+    let payloadLength = 0;
+    for (const record of page.records) {
+        const encoded = encodeRecord(record);
+        payload.push(encoded);
+        payloadLength += encoded.length;
+    }
+    if (payloadLength > capacity) {
+        throw new RecordTooLargeError(payloadLength, capacity);
+    }
+    const writer = new ByteWriter(pageSize);
+    writer.writeUInt32LE(page.pageId);
+    writer.writeUInt16LE(page.records.length);
+    writer.writeUInt16LE(capacity - payloadLength);
+    for (const part of payload) {
+        writer.writeBytes(part);
+    }
+    writer.writeBytes(BinaryUtils.alloc(pageSize - PAGE_CHECKSUM_SIZE - writer.position));
+    writer.writeChecksum(0);
+    return writer.data;
+}
+/**
+ * 反序列化页
+ * @param data 页数据
+ * @param pageId 期望页号
+ */
+export function decodePage(data, pageId) {
+    if (data.length < PAGE_HEADER_SIZE + PAGE_CHECKSUM_SIZE) {
+        throw new SnapshotFormatError(`page ${pageId} is shorter than its header`);
+    }
+    const checksumView = new DataView(data.buffer, data.byteOffset + data.length - PAGE_CHECKSUM_SIZE, PAGE_CHECKSUM_SIZE);
+    const expectedChecksum = checksumView.getUint32(0, true);
+    const actualChecksum = crc32(data, 0, data.length - PAGE_CHECKSUM_SIZE);
+    if (actualChecksum !== expectedChecksum) {
+        throw new ChecksumMismatchError(expectedChecksum, actualChecksum, 0);
+    }
+    const reader = new ByteReader(data);
+    const readPageId = reader.readUInt32LE();
+    const recordCount = reader.readUInt16LE();
+    reader.readUInt16LE();
+    if (readPageId !== pageId) {
+        throw new SnapshotFormatError(`expected page ${pageId}, got ${readPageId}`);
+    }
+    const records = [];
+    for (let i = 0; i < recordCount; i++) {
+        const start = reader.position;
+        const key = reader.readString();
+        const value = BinaryUtils.copy(reader.readBytesWithLength());
+        reader.readAndVerifyChecksum(start);
+        records.push({ key, value });
+    }
+    return { pageId, records };
+}
+/**
+ * 将记录打包成页
+ * @param records 记录映射
+ * @param pageSize 页大小
+ */
+export function packRecords(records, pageSize = DEFAULT_PAGE_SIZE) {
+    const capacity = pageSize - PAGE_HEADER_SIZE - PAGE_CHECKSUM_SIZE;
+    const pages = [];
+    let current = { pageId: 0, records: [] };
+    let used = 0;
+    for (const [key, value] of records) {
+        const size = recordSize(key, value);
+        if (size > capacity) {
+            throw new RecordTooLargeError(size, capacity);
+        }
+        if (current.records.length > 0 && used + size > capacity) {
+            pages.push(current);
+            current = { pageId: pages.length, records: [] };
+            used = 0;
+        }
+        current.records.push({ key, value });
+        used += size;
+    }
+    if (current.records.length > 0) {
+        pages.push(current);
+    }
+    return pages;
+}
+/**
+ * 序列化完整快照
+ * @param records 记录映射
+ * @param lastSnapshotLsn 最近快照 LSN
+ * @param pageSize 页大小
+ */
+export function encodeSnapshot(records, lastSnapshotLsn, pageSize = DEFAULT_PAGE_SIZE) {
+    const header = encodeHeader({
+        magic: SNAPSHOT_MAGIC,
+        version: SNAPSHOT_VERSION,
+        pageSize,
+        lastSnapshotLsn,
+    });
+    const pages = packRecords(records, pageSize);
+    const parts = [header];
+    for (const page of pages) {
+        parts.push(encodePage(page, pageSize));
+    }
+    return BinaryUtils.concat(parts);
+}
+/**
+ * 反序列化完整快照
+ * @param data 数据
+ */
+export function decodeSnapshot(data) {
+    const header = decodeHeader(data);
+    const pageCount = Math.floor((data.length - SNAPSHOT_HEADER_SIZE) / header.pageSize);
+    const records = new Map();
+    for (let pageId = 0; pageId < pageCount; pageId++) {
+        const start = SNAPSHOT_HEADER_SIZE + pageId * header.pageSize;
+        const page = decodePage(data.subarray(start, start + header.pageSize), pageId);
+        for (const record of page.records) {
+            records.set(record.key, record.value);
+        }
+    }
+    return { header, records, pageCount };
+}
+//# sourceMappingURL=page.js.map

package/dist/codec/page.js.map

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

package/dist/codec/record.d.ts

@@ -0,0 +1,62 @@
+/**
+ * WAL 记录编解码
+ *
+ * 记录布局（小端）：
+ * LSN(8) + 事务号(8) + 操作(1) + 键长度(4) + 值长度(4) + 键 + 值 + CRC32(4)。
+ */
+/** WAL 记录头部长度（不含尾部校验和） */
+export declare const WAL_RECORD_HEADER_SIZE = 25;
+/** WAL 记录尾部校验和长度 */
+export declare const WAL_RECORD_CHECKSUM_SIZE = 4;
+/** WAL 操作类型 */
+export declare enum WalOperation {
+    /** 写入或覆盖键 */
+    Put = 1,
+    /** 删除键 */
+    Delete = 2,
+    /** 检查点标记 */
+    Checkpoint = 16
+}
+/** WAL 记录 */
+export interface WalRecord {
+    /** 日志序列号，单调递增 */
+    lsn: bigint;
+    /** 事务号，0 表示自动提交 */
+    transactionId: bigint;
+    /** 操作类型 */
+    operation: WalOperation;
+    /** 键 */
+    key: string;
+    /** 值，删除或检查点标记为空 */
+    value: Uint8Array | null;
+}
+/** WAL 解码结果 */
+export type WalDecodeResult = {
+    status: 'ok';
+    record: WalRecord;
+    bytesRead: number;
+} | {
+    status: 'incomplete';
+};
+/**
+ * 计算记录编码大小
+ * @param key 键
+ * @param value 值
+ */
+export declare function walRecordSize(key: string, value: Uint8Array | null): number;
+/**
+ * 序列化 WAL 记录
+ * @param record 记录
+ */
+export declare function encodeWalRecord(record: WalRecord): Uint8Array;
+/**
+ * 反序列化 WAL 记录
+ *
+ * 尾部不完整（进程在写入中途退出）返回 `incomplete`，由恢复流程丢弃该尾部。
+ * 校验和不匹配属于真实损坏，会抛出 `ChecksumMismatchError`。
+ *
+ * @param data 数据
+ * @param offset 起始偏移量
+ */
+export declare function decodeWalRecord(data: Uint8Array, offset?: number): WalDecodeResult;
+//# sourceMappingURL=record.d.ts.map

package/dist/codec/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/codec/record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,0BAA0B;AAC1B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAe;AACf,oBAAY,YAAY;IACpB,aAAa;IACb,GAAG,IAAO;IACV,UAAU;IACV,MAAM,IAAO;IACb,YAAY;IACZ,UAAU,KAAO;CACpB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACtB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW;IACX,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ;IACR,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAED,eAAe;AACf,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAEhH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAe7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,MAAU,GAAG,eAAe,CA2BrF"}

package/dist/codec/record.js

@@ -0,0 +1,82 @@
+/**
+ * WAL 记录编解码
+ *
+ * 记录布局（小端）：
+ * LSN(8) + 事务号(8) + 操作(1) + 键长度(4) + 值长度(4) + 键 + 值 + CRC32(4)。
+ */
+import { ByteReader, ByteWriter, BinaryUtils } from './binary';
+/** WAL 记录头部长度（不含尾部校验和） */
+export const WAL_RECORD_HEADER_SIZE = 25;
+/** WAL 记录尾部校验和长度 */
+export const WAL_RECORD_CHECKSUM_SIZE = 4;
+/** WAL 操作类型 */
+export var WalOperation;
+(function (WalOperation) {
+    /** 写入或覆盖键 */
+    WalOperation[WalOperation["Put"] = 1] = "Put";
+    /** 删除键 */
+    WalOperation[WalOperation["Delete"] = 2] = "Delete";
+    /** 检查点标记 */
+    WalOperation[WalOperation["Checkpoint"] = 16] = "Checkpoint";
+})(WalOperation || (WalOperation = {}));
+/**
+ * 计算记录编码大小
+ * @param key 键
+ * @param value 值
+ */
+export function walRecordSize(key, value) {
+    const keyLength = BinaryUtils.byteLength(key);
+    const valueLength = value === null ? 0 : value.length;
+    return WAL_RECORD_HEADER_SIZE + keyLength + valueLength + WAL_RECORD_CHECKSUM_SIZE;
+}
+/**
+ * 序列化 WAL 记录
+ * @param record 记录
+ */
+export function encodeWalRecord(record) {
+    const key = BinaryUtils.encode(record.key);
+    const value = record.value ?? new Uint8Array(0);
+    const writer = new ByteWriter(walRecordSize(record.key, record.value));
+    writer.writeBigUInt64LE(record.lsn);
+    writer.writeBigUInt64LE(record.transactionId);
+    writer.writeUInt8(record.operation);
+    writer.writeUInt32LE(key.length);
+    writer.writeUInt32LE(value.length);
+    writer.writeBytes(key);
+    writer.writeBytes(value);
+    writer.writeChecksum(0);
+    return writer.data;
+}
+/**
+ * 反序列化 WAL 记录
+ *
+ * 尾部不完整（进程在写入中途退出）返回 `incomplete`，由恢复流程丢弃该尾部。
+ * 校验和不匹配属于真实损坏，会抛出 `ChecksumMismatchError`。
+ *
+ * @param data 数据
+ * @param offset 起始偏移量
+ */
+export function decodeWalRecord(data, offset = 0) {
+    const reader = new ByteReader(data, offset);
+    if (!reader.hasRemaining(WAL_RECORD_HEADER_SIZE)) {
+        return { status: 'incomplete' };
+    }
+    const start = reader.position;
+    const lsn = reader.readBigUInt64LE();
+    const transactionId = reader.readBigUInt64LE();
+    const operation = reader.readUInt8();
+    const keyLength = reader.readUInt32LE();
+    const valueLength = reader.readUInt32LE();
+    if (!reader.hasRemaining(keyLength + valueLength + WAL_RECORD_CHECKSUM_SIZE)) {
+        return { status: 'incomplete' };
+    }
+    const key = BinaryUtils.decode(reader.readBytes(keyLength));
+    const value = valueLength > 0 ? BinaryUtils.copy(reader.readBytes(valueLength)) : null;
+    reader.readAndVerifyChecksum(start);
+    return {
+        status: 'ok',
+        record: { lsn, transactionId, operation, key, value },
+        bytesRead: reader.position - start,
+    };
+}
+//# sourceMappingURL=record.js.map

package/dist/codec/record.js.map

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

package/dist/core/broadcast.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 跨标签页通知
+ *
+ * 多标签页各自持有内存视图，提交、schema 变更和关闭需要广播，
+ * 其他标签页据此丢弃陈旧视图。
+ */
+/** 数据库事件类型 */
+export type DatabaseEventType = 'commit' | 'schema' | 'close';
+/** 数据库事件 */
+export interface DatabaseEvent {
+    /** 事件类型 */
+    type: DatabaseEventType;
+    /** 数据库名 */
+    name: string;
+    /** 提交后的 LSN，仅 `commit` 事件携带 */
+    lsn?: string;
+}
+/**
+ * 数据库事件广播器
+ */
+export declare class DatabaseBroadcaster {
+    private readonly channel;
+    constructor(name: string);
+    /**
+     * 发送事件
+     * @param event 事件
+     */
+    notify(event: DatabaseEvent): void;
+    /** 关闭广播 */
+    close(): void;
+}
+/**
+ * 监听数据库事件
+ * @param name 数据库名
+ * @param handler 处理函数
+ * @returns 取消监听
+ */
+export declare function listenDatabaseEvents(name: string, handler: (event: DatabaseEvent) => void): () => void;
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/core/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/core/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9D,YAAY;AACZ,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;GAEG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAE1C,IAAI,EAAE,MAAM;IAIxB;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIzC,WAAW;IACJ,KAAK,IAAI,IAAI;CAGvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CActG"}

package/dist/core/broadcast.js

@@ -0,0 +1,54 @@
+/**
+ * 跨标签页通知
+ *
+ * 多标签页各自持有内存视图，提交、schema 变更和关闭需要广播，
+ * 其他标签页据此丢弃陈旧视图。
+ */
+/**
+ * 数据库事件广播器
+ */
+export class DatabaseBroadcaster {
+    channel;
+    constructor(name) {
+        this.channel = createChannel(`yydb:${name}`);
+    }
+    /**
+     * 发送事件
+     * @param event 事件
+     */
+    notify(event) {
+        this.channel?.postMessage(event);
+    }
+    /** 关闭广播 */
+    close() {
+        this.channel?.close();
+    }
+}
+/**
+ * 监听数据库事件
+ * @param name 数据库名
+ * @param handler 处理函数
+ * @returns 取消监听
+ */
+export function listenDatabaseEvents(name, handler) {
+    const channel = createChannel(`yydb:${name}`);
+    if (!channel) {
+        return () => undefined;
+    }
+    channel.onmessage = (event) => {
+        const data = event.data;
+        if (data && data.name === name) {
+            handler(data);
+        }
+    };
+    return () => channel.close();
+}
+/**
+ * 创建广播通道
+ * @param channelName 通道名
+ */
+function createChannel(channelName) {
+    const constructor = globalThis.BroadcastChannel;
+    return constructor ? new constructor(channelName) : null;
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/core/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../src/core/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACX,OAAO,CAA8B;IAEtD,YAAY,IAAY;QACpB,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAoB;QAC9B,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,WAAW;IACJ,KAAK;QACR,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAuC;IACtF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAA4B,CAAC;QAChD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACL,CAAC,CAAC;IAEF,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,WAAmB;IACtC,MAAM,WAAW,GAAI,UAA2F,CAAC,gBAAgB,CAAC;IAClI,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC"}

package/dist/core/checkpoint.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 检查点
+ *
+ * 把内存记录写成一份新快照，再用适配器的 `rename` 原子发布。
+ * 崩溃发生在发布前时旧快照仍然完整，WAL 会在下次打开时重放。
+ */
+import type { StorageAdapter } from '../storage/StorageAdapter';
+/**
+ * 检查点写入器
+ */
+export declare class CheckpointWriter {
+    private readonly adapter;
+    private readonly pageSize;
+    constructor(adapter: StorageAdapter, pageSize: number);
+    /**
+     * 写入快照
+     * @param records 记录视图
+     * @param lsn 快照覆盖到的 LSN
+     * @returns 写入字节数
+     */
+    write(records: ReadonlyMap<string, Uint8Array>, lsn: bigint): Promise<number>;
+}
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/core/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/core/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM;IAKrD;;;;;OAKG;IACU,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuB7F"}

package/dist/core/checkpoint.js

@@ -0,0 +1,49 @@
+/**
+ * 检查点
+ *
+ * 把内存记录写成一份新快照，再用适配器的 `rename` 原子发布。
+ * 崩溃发生在发布前时旧快照仍然完整，WAL 会在下次打开时重放。
+ */
+import { encodeSnapshot } from '../codec';
+import { LightDbError, LightDbErrorCodes } from '../errors';
+/**
+ * 检查点写入器
+ */
+export class CheckpointWriter {
+    adapter;
+    pageSize;
+    constructor(adapter, pageSize) {
+        this.adapter = adapter;
+        this.pageSize = pageSize;
+    }
+    /**
+     * 写入快照
+     * @param records 记录视图
+     * @param lsn 快照覆盖到的 LSN
+     * @returns 写入字节数
+     */
+    async write(records, lsn) {
+        let data;
+        try {
+            data = encodeSnapshot(records, lsn, this.pageSize);
+        }
+        catch (error) {
+            throw new LightDbError(LightDbErrorCodes.unsupported, 'cannot encode database snapshot', {
+                operation: 'checkpoint',
+                cause: error,
+            });
+        }
+        const temp = await this.adapter.open('main.tmp', 'readwrite');
+        try {
+            await temp.truncate(0);
+            await temp.write(0, data);
+            await temp.sync();
+        }
+        finally {
+            await temp.close();
+        }
+        await this.adapter.rename('main.tmp', 'main');
+        return data.length;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/core/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/core/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG5D;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACR,OAAO,CAAiB;IACxB,QAAQ,CAAS;IAElC,YAAY,OAAuB,EAAE,QAAgB;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,KAAK,CAAC,OAAwC,EAAE,GAAW;QACpE,IAAI,IAAgB,CAAC;QACrB,IAAI,CAAC;YACD,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,YAAY,CAAC,iBAAiB,CAAC,WAAW,EAAE,iCAAiC,EAAE;gBACrF,SAAS,EAAE,YAAY;gBACvB,KAAK,EAAE,KAAK;aACf,CAAC,CAAC;QACP,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ"}