nano-git 0.2.1 → 0.2.2

package/dist/workdir/session.mjs

@@ -1,12 +1,13 @@
 import { VirtualNotDirectoryError, VirtualNotFileError, VirtualNotSymlinkError, VirtualPathAlreadyExistsError, VirtualPathNotFoundError, VirtualRevertNotSupportedError } from "../core/errors.mjs";
+import { mapInternalChangesToVirtualChanges } from "./change-log.mjs";
 import { VIRTUAL_ROOT_NODE_ID, createNodeId } from "./ids.mjs";
 import { overlayBindEntry, overlayRenameEntry, overlayTombstoneEntry } from "./overlay.mjs";
-import { cloneSessionNodeForCopy, createRootDirectoryNode, revertNodeState } from "./nodes.mjs";
-import { createVirtualWorkdirMemoryState } from "./memory-backend.mjs";
+import { cloneSessionNodeForCopy, revertNodeState } from "./nodes.mjs";
 import { modeToVirtualEntryKind, readRepoBlobContent } from "./origin.mjs";
 import { assertValidVirtualPath, baseName, normalizeDirectoryPath, parentPath } from "./path.mjs";
 import { listDirectoryChildren, resolveChild, resolvePath } from "./session-internal.mjs";
 import { writeTreeFromSession } from "./write-tree.mjs";
+import { createVirtualWorkdirMemoryStateStore } from "./memory-backend.mjs";
 //#region src/workdir/session.ts
 /**
 * VirtualWorkdirSession 行为编排
@@ -25,12 +26,22 @@ import { writeTreeFromSession } from "./write-tree.mjs";
 * ```
 */
 function createVirtualWorkdirSession(source, options) {
-	return buildSessionApi(source, createVirtualWorkdirMemoryState(options.baseTree));
+	return openVirtualWorkdirSession(source, createVirtualWorkdirMemoryStateStore(options.baseTree));
 }
-function buildSessionApi(source, state) {
+/**
+* 基于已有状态存储打开 session
+*
+* @example
+* ```ts
+* const store = createVirtualWorkdirMemoryStateStore(tree);
+* const session = openVirtualWorkdirSession(repo.objects, store);
+* expect(session.baseTree).toBe(tree);
+* ```
+*/
+function openVirtualWorkdirSession(source, state) {
 	return {
 		get baseTree() {
-			return state.baseTree;
+			return state.readBaseTree();
 		},
 		exists(path) {
 			if (path === "") return true;
@@ -80,240 +91,256 @@ function buildSessionApi(source, state) {
 			throw new VirtualPathNotFoundError(path);
 		},
 		mkdir(path) {
-			assertValidVirtualPath(path);
-			const parent = parentPath(path);
-			const name = baseName(path);
-			const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
-			const parentNode = parentResolved.node;
-			if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
-			const existing = resolveChild(source, state, parentNode, parent ?? "", name);
-			if (existing.found && existing.node !== null) throw new VirtualPathAlreadyExistsError(path);
-			const nodeId = createNodeId();
-			const newNode = {
-				id: nodeId,
-				origin: { kind: "none" },
-				state: {
-					kind: "directory",
-					overlay: {
-						addedEntries: /* @__PURE__ */ new Map(),
-						deletedNames: /* @__PURE__ */ new Set()
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(path);
+				const parent = parentPath(path);
+				const name = baseName(path);
+				const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
+				const parentNode = parentResolved.node;
+				if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
+				const existing = resolveChild(source, state, parentNode, parent ?? "", name);
+				if (existing.found && existing.node !== null) throw new VirtualPathAlreadyExistsError(path);
+				const nodeId = createNodeId();
+				const newNode = {
+					id: nodeId,
+					origin: { kind: "none" },
+					state: {
+						kind: "directory",
+						overlay: {
+							addedEntries: /* @__PURE__ */ new Map(),
+							deletedNames: /* @__PURE__ */ new Set()
+						}
 					}
-				}
-			};
-			state.nodes.set(nodeId, newNode);
-			updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
-			state.changeLog.append({
-				op: "add",
-				path
+				};
+				state.setNode(newNode);
+				updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
+				state.appendChange({
+					op: "add",
+					path
+				});
 			});
 		},
 		writeFile(path, content, options) {
-			assertValidVirtualPath(path);
-			const mode = options?.mode ?? "100644";
-			const parent = parentPath(path);
-			const name = baseName(path);
-			const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
-			const parentNode = parentResolved.node;
-			if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
-			const existing = resolveChild(source, state, parentNode, parent ?? "", name);
-			if (existing.found && existing.node !== null) {
-				if (existing.node.state.kind === "directory") throw new VirtualNotFileError(path);
-			}
-			const isNew = !existing.found || existing.node === null;
-			const nodeId = existing.found ? existing.node.id : createNodeId();
-			const fileNode = {
-				id: nodeId,
-				origin: existing.found ? existing.node.origin : { kind: "none" },
-				state: {
-					kind: "file",
-					mode,
-					content
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(path);
+				const mode = options?.mode ?? "100644";
+				const parent = parentPath(path);
+				const name = baseName(path);
+				const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
+				const parentNode = parentResolved.node;
+				if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
+				const existing = resolveChild(source, state, parentNode, parent ?? "", name);
+				if (existing.found && existing.node !== null) {
+					if (existing.node.state.kind === "directory") throw new VirtualNotFileError(path);
 				}
-			};
-			state.nodes.set(nodeId, fileNode);
-			updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
-			state.changeLog.append({
-				op: isNew ? "add" : "modify",
-				path
+				const isNew = !existing.found || existing.node === null;
+				const nodeId = existing.found ? existing.node.id : createNodeId();
+				const fileNode = {
+					id: nodeId,
+					origin: existing.found ? existing.node.origin : { kind: "none" },
+					state: {
+						kind: "file",
+						mode,
+						content
+					}
+				};
+				state.setNode(fileNode);
+				updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
+				state.appendChange({
+					op: isNew ? "add" : "modify",
+					path
+				});
 			});
 		},
 		writeLink(path, target) {
-			assertValidVirtualPath(path);
-			const parent = parentPath(path);
-			const name = baseName(path);
-			const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
-			const parentNode = parentResolved.node;
-			if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
-			const existing = resolveChild(source, state, parentNode, parent ?? "", name);
-			if (existing.found && existing.node !== null) {
-				if (existing.node.state.kind === "directory") throw new VirtualNotFileError(path);
-			}
-			const isNew = !existing.found || existing.node === null;
-			const nodeId = existing.found ? existing.node.id : createNodeId();
-			const linkNode = {
-				id: nodeId,
-				origin: existing.found ? existing.node.origin : { kind: "none" },
-				state: {
-					kind: "symlink",
-					mode: "120000",
-					target: Buffer.from(target)
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(path);
+				const parent = parentPath(path);
+				const name = baseName(path);
+				const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
+				const parentNode = parentResolved.node;
+				if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
+				const existing = resolveChild(source, state, parentNode, parent ?? "", name);
+				if (existing.found && existing.node !== null) {
+					if (existing.node.state.kind === "directory") throw new VirtualNotFileError(path);
 				}
-			};
-			state.nodes.set(nodeId, linkNode);
-			updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
-			state.changeLog.append({
-				op: isNew ? "add" : "modify",
-				path
+				const isNew = !existing.found || existing.node === null;
+				const nodeId = existing.found ? existing.node.id : createNodeId();
+				const linkNode = {
+					id: nodeId,
+					origin: existing.found ? existing.node.origin : { kind: "none" },
+					state: {
+						kind: "symlink",
+						mode: "120000",
+						target: Buffer.from(target)
+					}
+				};
+				state.setNode(linkNode);
+				updateParentOverlay(state, parentNode.id, overlayBindEntry(parentNode.state.overlay, name, nodeId));
+				state.appendChange({
+					op: isNew ? "add" : "modify",
+					path
+				});
 			});
 		},
 		delete(path) {
-			assertValidVirtualPath(path);
-			const parent = parentPath(path);
-			const name = baseName(path);
-			const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
-			const parentNode = parentResolved.node;
-			if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
-			const existing = resolveChild(source, state, parentNode, parent ?? "", name);
-			if (!existing.found || existing.node === null) throw new VirtualPathNotFoundError(path);
-			updateParentOverlay(state, parentNode.id, overlayTombstoneEntry(parentNode.state.overlay, name));
-			state.changeLog.append({
-				op: "delete",
-				path
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(path);
+				const parent = parentPath(path);
+				const name = baseName(path);
+				const parentResolved = parent !== null ? resolvePath(source, state, parent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!parentResolved.found || parentResolved.node === null) throw new VirtualPathNotFoundError(parent ?? path);
+				const parentNode = parentResolved.node;
+				if (parentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(parent ?? path);
+				const existing = resolveChild(source, state, parentNode, parent ?? "", name);
+				if (!existing.found || existing.node === null) throw new VirtualPathNotFoundError(path);
+				updateParentOverlay(state, parentNode.id, overlayTombstoneEntry(parentNode.state.overlay, name));
+				state.appendChange({
+					op: "delete",
+					path
+				});
 			});
 		},
 		rename(from, to) {
-			assertValidVirtualPath(from);
-			assertValidVirtualPath(to);
-			if (from === to) return;
-			const fromParent = parentPath(from);
-			const fromName = baseName(from);
-			const fromParentResolved = fromParent !== null ? resolvePath(source, state, fromParent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!fromParentResolved.found || fromParentResolved.node === null) throw new VirtualPathNotFoundError(from);
-			const fromParentNode = fromParentResolved.node;
-			if (fromParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(from);
-			const fromChild = resolveChild(source, state, fromParentNode, fromParent ?? "", fromName);
-			if (!fromChild.found || fromChild.node === null) throw new VirtualPathNotFoundError(from);
-			const sourceNode = fromChild.node;
-			const toParent = parentPath(to);
-			const toName = baseName(to);
-			const toParentResolved = toParent !== null ? resolvePath(source, state, toParent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!toParentResolved.found || toParentResolved.node === null) throw new VirtualPathNotFoundError(to);
-			const toParentNode = toParentResolved.node;
-			if (toParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(to);
-			const toExisting = resolveChild(source, state, toParentNode, toParent ?? "", toName);
-			if (toExisting.found && toExisting.node !== null) throw new VirtualPathAlreadyExistsError(to);
-			if (sourceNode.state.kind === "directory") {
-				const toPath = to;
-				const fromPath = from;
-				if (toPath.startsWith(fromPath + "/") || toPath === fromPath) throw new Error(`Cannot rename '${from}' to '${to}': destination is a subdirectory of source`);
-			}
-			if (fromParentNode.id === toParentNode.id) updateParentOverlay(state, fromParentNode.id, overlayRenameEntry(fromParentNode.state.overlay, fromName, toName, sourceNode.id));
-			else {
-				updateParentOverlay(state, fromParentNode.id, overlayTombstoneEntry(fromParentNode.state.overlay, fromName));
-				updateParentOverlay(state, toParentNode.id, overlayBindEntry(toParentNode.state.overlay, toName, sourceNode.id));
-			}
-			state.changeLog.append({
-				op: "rename",
-				from,
-				to
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(from);
+				assertValidVirtualPath(to);
+				if (from === to) return;
+				const fromParent = parentPath(from);
+				const fromName = baseName(from);
+				const fromParentResolved = fromParent !== null ? resolvePath(source, state, fromParent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!fromParentResolved.found || fromParentResolved.node === null) throw new VirtualPathNotFoundError(from);
+				const fromParentNode = fromParentResolved.node;
+				if (fromParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(from);
+				const fromChild = resolveChild(source, state, fromParentNode, fromParent ?? "", fromName);
+				if (!fromChild.found || fromChild.node === null) throw new VirtualPathNotFoundError(from);
+				const sourceNode = fromChild.node;
+				const toParent = parentPath(to);
+				const toName = baseName(to);
+				const toParentResolved = toParent !== null ? resolvePath(source, state, toParent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!toParentResolved.found || toParentResolved.node === null) throw new VirtualPathNotFoundError(to);
+				const toParentNode = toParentResolved.node;
+				if (toParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(to);
+				const toExisting = resolveChild(source, state, toParentNode, toParent ?? "", toName);
+				if (toExisting.found && toExisting.node !== null) throw new VirtualPathAlreadyExistsError(to);
+				if (sourceNode.state.kind === "directory") {
+					const toPath = to;
+					const fromPath = from;
+					if (toPath.startsWith(fromPath + "/") || toPath === fromPath) throw new Error(`Cannot rename '${from}' to '${to}': destination is a subdirectory of source`);
+				}
+				if (fromParentNode.id === toParentNode.id) updateParentOverlay(state, fromParentNode.id, overlayRenameEntry(fromParentNode.state.overlay, fromName, toName, sourceNode.id));
+				else {
+					updateParentOverlay(state, fromParentNode.id, overlayTombstoneEntry(fromParentNode.state.overlay, fromName));
+					updateParentOverlay(state, toParentNode.id, overlayBindEntry(toParentNode.state.overlay, toName, sourceNode.id));
+				}
+				state.appendChange({
+					op: "rename",
+					from,
+					to
+				});
 			});
 		},
 		copy(from, to) {
-			assertValidVirtualPath(from);
-			assertValidVirtualPath(to);
-			if (from === to) throw new VirtualPathAlreadyExistsError(to);
-			const fromParent = parentPath(from);
-			const fromName = baseName(from);
-			const fromParentResolved = fromParent !== null ? resolvePath(source, state, fromParent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!fromParentResolved.found || fromParentResolved.node === null) throw new VirtualPathNotFoundError(from);
-			const fromParentNode = fromParentResolved.node;
-			if (fromParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(from);
-			const fromChild = resolveChild(source, state, fromParentNode, fromParent ?? "", fromName);
-			if (!fromChild.found || fromChild.node === null) throw new VirtualPathNotFoundError(from);
-			const sourceNode = fromChild.node;
-			const toParent = parentPath(to);
-			const toName = baseName(to);
-			const toParentResolved = toParent !== null ? resolvePath(source, state, toParent) : {
-				found: true,
-				node: getRootNode(state)
-			};
-			if (!toParentResolved.found || toParentResolved.node === null) throw new VirtualPathNotFoundError(to);
-			const toParentNode = toParentResolved.node;
-			if (toParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(to);
-			const toExisting = resolveChild(source, state, toParentNode, toParent ?? "", toName);
-			if (toExisting.found && toExisting.node !== null) throw new VirtualPathAlreadyExistsError(to);
-			const newNodeId = cloneNodeGraphForCopy(source, state, sourceNode, from);
-			updateParentOverlay(state, toParentNode.id, overlayBindEntry(toParentNode.state.overlay, toName, newNodeId));
-			state.changeLog.append({
-				op: "copy",
-				from,
-				to
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(from);
+				assertValidVirtualPath(to);
+				if (from === to) throw new VirtualPathAlreadyExistsError(to);
+				const fromParent = parentPath(from);
+				const fromName = baseName(from);
+				const fromParentResolved = fromParent !== null ? resolvePath(source, state, fromParent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!fromParentResolved.found || fromParentResolved.node === null) throw new VirtualPathNotFoundError(from);
+				const fromParentNode = fromParentResolved.node;
+				if (fromParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(from);
+				const fromChild = resolveChild(source, state, fromParentNode, fromParent ?? "", fromName);
+				if (!fromChild.found || fromChild.node === null) throw new VirtualPathNotFoundError(from);
+				const sourceNode = fromChild.node;
+				const toParent = parentPath(to);
+				const toName = baseName(to);
+				const toParentResolved = toParent !== null ? resolvePath(source, state, toParent) : {
+					found: true,
+					node: getRootNode(state)
+				};
+				if (!toParentResolved.found || toParentResolved.node === null) throw new VirtualPathNotFoundError(to);
+				const toParentNode = toParentResolved.node;
+				if (toParentNode.state.kind !== "directory") throw new VirtualNotDirectoryError(to);
+				const toExisting = resolveChild(source, state, toParentNode, toParent ?? "", toName);
+				if (toExisting.found && toExisting.node !== null) throw new VirtualPathAlreadyExistsError(to);
+				const newNodeId = cloneNodeGraphForCopy(source, state, sourceNode, from);
+				updateParentOverlay(state, toParentNode.id, overlayBindEntry(toParentNode.state.overlay, toName, newNodeId));
+				state.appendChange({
+					op: "copy",
+					from,
+					to
+				});
 			});
 		},
 		revert(path) {
-			assertValidVirtualPath(path);
-			const resolved = resolvePath(source, state, path);
-			if (!resolved.found || resolved.node === null) throw new VirtualPathNotFoundError(path);
-			const node = resolved.node;
-			const reverted = revertNodeState(node);
-			if (reverted === node) throw new VirtualRevertNotSupportedError(path);
-			state.nodes.set(node.id, reverted);
-			state.changeLog.append({
-				op: "revert",
-				path
+			runInWriteTransaction(state, () => {
+				assertValidVirtualPath(path);
+				const resolved = resolvePath(source, state, path);
+				if (!resolved.found || resolved.node === null) throw new VirtualPathNotFoundError(path);
+				const node = resolved.node;
+				const reverted = revertNodeState(node);
+				if (reverted === node) throw new VirtualRevertNotSupportedError(path);
+				state.setNode(reverted);
+				state.appendChange({
+					op: "revert",
+					path
+				});
 			});
 		},
 		writeTree() {
 			return writeTreeFromSession(source, state);
 		},
 		reset(baseTree) {
-			state.baseTree = baseTree;
-			state.nodes.clear();
-			state.nodes.set(VIRTUAL_ROOT_NODE_ID, createRootDirectoryNode(baseTree));
-			state.changeLog.clear();
+			runInWriteTransaction(state, () => {
+				state.reset(baseTree);
+			});
 		},
 		listChanges() {
-			return state.changeLog.toVirtualChanges();
+			return mapInternalChangesToVirtualChanges(state.listChangeRecords());
 		}
 	};
 }
 function getRootNode(state) {
-	const root = state.nodes.get(VIRTUAL_ROOT_NODE_ID);
-	if (root === void 0) throw new Error("Virtual workdir session is missing root node");
+	const root = state.getNode(VIRTUAL_ROOT_NODE_ID);
+	if (root === null) throw new Error("Virtual workdir session is missing root node");
 	return root;
 }
+function runInWriteTransaction(state, fn) {
+	return state.transact(fn);
+}
 /**
 * 更新父节点的 overlay（创建新节点对象替代 Map 中的旧引用）
 */
 function updateParentOverlay(state, parentId, newOverlay) {
-	const parentNode = state.nodes.get(parentId);
-	if (!parentNode || parentNode.state.kind !== "directory") throw new Error("updateParentOverlay: parent is not a directory");
-	state.nodes.set(parentId, {
+	const parentNode = state.getNode(parentId);
+	if (parentNode === null || parentNode.state.kind !== "directory") throw new Error("updateParentOverlay: parent is not a directory");
+	state.setNode({
 		...parentNode,
 		state: {
 			...parentNode.state,
@@ -357,17 +384,17 @@ function statDirectoryNode(node) {
 function cloneNodeGraphForCopy(source, state, node, path) {
 	const newNodeId = createNodeId();
 	const cloned = cloneSessionNodeForCopy(node, newNodeId);
-	state.nodes.set(newNodeId, cloned);
+	state.setNode(cloned);
 	if (node.state.kind !== "directory" || cloned.state.kind !== "directory") return newNodeId;
 	let overlay = cloned.state.overlay;
 	const children = listDirectoryChildren(source, state, node, path);
 	for (const child of children) {
-		const childNode = state.nodes.get(child.nodeId);
-		if (childNode === void 0) continue;
+		const childNode = state.getNode(child.nodeId);
+		if (childNode === null) continue;
 		const clonedChildId = cloneNodeGraphForCopy(source, state, childNode, path === "" ? child.name : `${path}/${child.name}`);
 		overlay = overlayBindEntry(overlay, child.name, clonedChildId);
 	}
-	state.nodes.set(newNodeId, {
+	state.setNode({
 		...cloned,
 		state: {
 			kind: "directory",
@@ -377,4 +404,4 @@ function cloneNodeGraphForCopy(source, state, node, path) {
 	return newNodeId;
 }
 //#endregion
-export { createVirtualWorkdirSession };
+export { createVirtualWorkdirSession, openVirtualWorkdirSession };

package/dist/workdir/sqlite-backend.d.mts

@@ -0,0 +1,30 @@
+import { VirtualWorkdirBackend } from "./core.mjs";
+import { Database } from "bun:sqlite";
+
+//#region src/workdir/sqlite-backend.d.ts
+/** 创建 SQLite Virtual Workdir backend 的可选参数 */
+interface CreateSqliteVirtualWorkdirBackendOptions {
+  /** 开启 WAL 模式，默认 true */
+  readonly walMode?: boolean;
+}
+/**
+ * SQLite Virtual Workdir backend（含资源释放能力）
+ */
+interface SqliteVirtualWorkdirBackend extends VirtualWorkdirBackend {
+  /** 释放 SQLite 数据库连接 */
+  [Symbol.dispose](): void;
+}
+/**
+ * 创建基于 SQLite 的 Virtual Workdir backend
+ *
+ * @example
+ * ```ts
+ * using backend = createSqliteVirtualWorkdirBackend(":memory:");
+ * const sessionId = backend.createSession({ baseTree: tree });
+ * const session = backend.openSession(repo.objects, sessionId);
+ * expect(session.baseTree).toBe(tree);
+ * ```
+ */
+declare function createSqliteVirtualWorkdirBackend(dbPath: string, options?: CreateSqliteVirtualWorkdirBackendOptions): SqliteVirtualWorkdirBackend;
+//#endregion
+export { CreateSqliteVirtualWorkdirBackendOptions, SqliteVirtualWorkdirBackend, createSqliteVirtualWorkdirBackend };