release: v0.2.5 — 质量加固 + Bug修复 + 性能优化 + SQL扩展

src/engine/aria/wal/checkpoint.ts

@@ -24,26 +24,36 @@ export class CheckpointManager {
   private flushable: Flushable | null;
   private interval: number;
   private opCount = 0;
+  private walSizeThreshold: number;
 
   constructor(
     lsm: LSM,
     wal: WAL,
     flushable: Flushable | null = null,
     interval: number = 1000,
+    walSizeThreshold: number = 16 * 1024 * 1024,
   ) {
     this.lsm = lsm;
     this.wal = wal;
     this.flushable = flushable;
     this.interval = interval;
+    this.walSizeThreshold = walSizeThreshold;
   }
 
   async tick(): Promise<void> {
     this.opCount++;
-    if (this.opCount >= this.interval) {
+    // 检查操作计数或 WAL 大小是否超阈值
+    if (this.opCount >= this.interval || this.getWALEstimatedSize() >= this.walSizeThreshold) {
       await this.checkpoint();
     }
   }
 
+  /** 估算 WAL 大小 */
+  private getWALEstimatedSize(): number {
+    const count = typeof this.wal.getBufferedCount === 'function' ? this.wal.getBufferedCount() : 0;
+    return count * 200;
+  }
+
   async checkpoint(): Promise<void> {
     await this.lsm.flush();
     if (this.flushable) {

src/engine/aria/wal/log.ts

@@ -59,8 +59,8 @@ export class WAL {
   //  写入
   // =======================================================================
 
-  /** 追加一条 WAL 记录 */
-  append(record: Omit<WALRecord, 'lsn' | 'checksum'>): void {
+  /** 追加一条 WAL 记录（full 模式同步等待写入完成） */
+  async append(record: Omit<WALRecord, 'lsn' | 'checksum'>): Promise<void> {
     if (!this.enabled) return;
 
     this.lsn++;
@@ -73,10 +73,12 @@ export class WAL {
     const bytes = this.encodeRecord(fullRecord);
 
     if (this.syncMode === 'full') {
-      this.store.append(bytes).catch(() => {
+      try {
+        await this.store.append(bytes);
+      } catch {
         // eslint-disable-next-line no-console
         console.warn('[AriaEngine WAL] Failed to append record');
-      });
+      }
     } else if (this.syncMode === 'batch') {
       this.buffer.push(bytes);
     }