synapse-db 0.3.0 → 0.3.1

package/dist/connectome.d.ts

@@ -11,6 +11,7 @@ export declare class SynapseConnectome {
     private readonly edgeMeta;
     private readonly tokenInvertedIndex;
     private readonly documentTokens;
+    private readonly dirtySearchNodes;
     constructor();
     /**
      * 고유 노드 ID 복합키 생성
@@ -29,9 +30,17 @@ export declare class SynapseConnectome {
      */
     removeDocument(collection: string, id: string): boolean;
     /**
-     * 해당 문서가 소유한 나가는 간선(Outgoing Edges)과 검색 역색인 토큰만 정리
+     * 해당 문서에서 출발하는 나가는 간선(Outgoing Edges)만 정리
      */
-    private removeDocumentOwnedIndices;
+    private removeDocumentOutgoingEdges;
+    /**
+     * 해당 문서의 기존 전문 검색 토큰 역색인 정리 (유령 토큰 원천 차단)
+     */
+    private removeDocumentSearchTokens;
+    /**
+     * 대기 중인 변경 문서들의 검색 역색인을 일괄 동기화 (검색 또는 무결성 검증 시 자동 호출)
+     */
+    private flushDirtySearchIndex;
     /**
      * O(1) 단일 문서 조회
      */

package/dist/engine.d.ts

@@ -1,19 +1,24 @@
 import { SynapseConnectome } from "./connectome";
+import { CausalWalEngine } from "./wal";
 import type { SynapseDBConfig, SynapseDocument, SynapseDocumentInput, SynapseDBStats } from "./types";
 export declare class SynapseEngine {
     readonly vaultDir: string;
     readonly connectome: SynapseConnectome;
+    readonly wal: CausalWalEngine;
     readonly config: SynapseDBConfig;
     private isInitialized;
     private pendingWriteQueue;
     private writeTimer;
+    private nextTimerFlushAtMs;
+    private cachedIsoMs;
+    private cachedIsoStr;
     private watcherDebounceTimer;
     private internalWriteResetTimer;
     private fileWatcher;
     private isWritingInternally;
     constructor(config: SynapseDBConfig);
     /**
-     * 볼트 디렉터리 초기화 및 기존 마크다운 파일 전체 로드
+     * 볼트 디렉터리 초기화 및 기존 마크다운 파일 전체 로드 + SQLite WAL 크래시 복구
      */
     init(): Promise<void>;
     /**
@@ -25,7 +30,16 @@ export declare class SynapseEngine {
      */
     private loadCollectionDir;
     /**
-     * 문서 저장 (인메모리 즉시 반영 + 디바운스 원자적 디스크 쓰기)
+     * 트랜잭션 아레나 스코프 내부일 경우 스테이징된 최신 문서를 우선 조회
+     */
+    private getEffectiveDocument;
+    private isValidSafeIdentifier;
+    /**
+     * 동일 밀리초 내 Date.toISOString() 반복 문자열 할당을 제거하는 O(1) 시계열 타임스탬프 생성기
+     */
+    private getNowIso;
+    /**
+     * 문서 저장 (Causal-WAL 링 버퍼 기록 + 인메모리 즉시 반영 + 지연(Lazy) 직렬화 원자적 디스크 쓰기)
      */
     saveDocument<TData = Record<string, any>>(collection: string, input: SynapseDocumentInput<TData>): Promise<SynapseDocument<TData>>;
     /**
@@ -37,9 +51,14 @@ export declare class SynapseEngine {
      */
     deleteDocument(collection: string, id: string): Promise<boolean>;
     /**
-     * 비동기 디바운스 디스크 쓰기 예약
+     * 아레나 할당기 기반 원자적 트랜잭션 실행 (예외 발생 시 0ns 롤백, 성공 시 일괄 반영)
+     */
+    executeTransaction<TResult>(fn: () => Promise<TResult> | TResult): Promise<TResult>;
+    /**
+     * 비동기 디바운스 디스크 쓰기 예약 (커널 타이머 재등록 오버헤드 제거 Coalesced Timer)
      */
     private scheduleWrite;
+    private armWriteTimer;
     /**
      * 대기 중인 모든 디스크 쓰기 일괄 실행
      */

package/dist/index.d.ts

@@ -5,8 +5,10 @@
 import { SynapseEngine } from "./engine";
 import { SynapseCollection } from "./collection";
 import { SynapseMigrator } from "./migrator";
+import { SynapseConnectome } from "./connectome";
 import { exportToObsidianCanvas, type CanvasData } from "./canvasExporter";
 import type { SynapseDBConfig, SynapseDBStats } from "./types";
+import type { CausalTimelineDiff, CausalWalEntry, CausalWalUnifiedStats, CompilerTemporalMetric } from "./wal";
 export declare class SynapseDB {
     readonly engine: SynapseEngine;
     private readonly collections;
@@ -35,6 +37,30 @@ export declare class SynapseDB {
      * 대기 중인 모든 디스크 I/O 플러시
      */
     flush(): void;
+    /**
+     * 아레나 할당기 기반 원자적 트랜잭션 실행 (예외 발생 시 0ns 롤백)
+     */
+    transaction<TResult>(fn: () => Promise<TResult> | TResult): Promise<TResult>;
+    /**
+     * 특정 LSN 시점의 시냅스 커넥톰을 즉시 복원 (Time-Travel)
+     */
+    asOfLsn(targetLsn: number): SynapseConnectome;
+    /**
+     * 특정 타임스탬프(밀리초 또는 ISO 문자열) 시점의 시냅스 커넥톰 즉시 복원 (Time-Travel)
+     */
+    asOf(timestampMsOrIso: number | string): SynapseConnectome;
+    /**
+     * 두 LSN 시점 사이의 문서 생성·수정·삭제 및 위키링크 변화 차분(Diff) 조회
+     */
+    diffBetweenLsn(fromLsn: number, toLsn: number): CausalTimelineDiff;
+    /**
+     * 컴파일러 빌드 지연시간 및 바이너리 크기 시계열 메트릭 기록
+     */
+    recordCompilerMetric(metric: CompilerTemporalMetric): CausalWalEntry;
+    /**
+     * Causal-WAL (링 버퍼, 아레나, SQLite WAL) 통합 상태 통계
+     */
+    walStats(): CausalWalUnifiedStats;
     /**
      * 데이터베이스 종료 및 워처 해제
      */
@@ -47,3 +73,4 @@ export * from "./serializer";
 export * from "./engine";
 export * from "./migrator";
 export * from "./canvasExporter";
+export * from "./wal";