nano-git 0.2.1 → 0.2.3

package/dist/workdir/memory-backend.mjs

@@ -1,21 +1,159 @@
-import { VIRTUAL_ROOT_NODE_ID } from "./ids.mjs";
 import { createVirtualChangeLog } from "./change-log.mjs";
+import { VIRTUAL_ROOT_NODE_ID } from "./ids.mjs";
 import { createRootDirectoryNode } from "./nodes.mjs";
+import { createVirtualWorkdirSessionId } from "./session-id.mjs";
+import { openVirtualWorkdirSession } from "./session.mjs";
 //#region src/workdir/memory-backend.ts
 /**
-* Virtual Workdir 会话内存状态（与 ODB 后端无关的纯状态容器）
+* Virtual Workdir 内存状态存储
 */
 /**
-* 创建初始 session 状态（仅根目录节点，绑定 baseTree origin）
+* 创建内存版状态存储
+*
+* @example
+* ```ts
+* const store = createVirtualWorkdirMemoryStateStore(tree);
+* expect(store.readBaseTree()).toBe(tree);
+* ```
 */
-function createVirtualWorkdirMemoryState(baseTree) {
+function createVirtualWorkdirMemoryStateStore(baseTree) {
+	const state = {
+		baseTree,
+		nodes: /* @__PURE__ */ new Map(),
+		changeLog: createVirtualChangeLog()
+	};
+	resetState(state, baseTree);
+	return {
+		kind: "memory",
+		transact(fn) {
+			const snapshot = snapshotState(state);
+			try {
+				return fn();
+			} catch (error) {
+				restoreState(state, snapshot);
+				throw error;
+			}
+		},
+		readBaseTree() {
+			return state.baseTree;
+		},
+		writeBaseTree(nextBaseTree) {
+			state.baseTree = nextBaseTree;
+		},
+		getNode(id) {
+			return state.nodes.get(id) ?? null;
+		},
+		setNode(node) {
+			state.nodes.set(node.id, node);
+		},
+		deleteNode(id) {
+			state.nodes.delete(id);
+		},
+		appendChange(record) {
+			state.changeLog.append(record);
+		},
+		listChangeRecords() {
+			return state.changeLog.snapshot();
+		},
+		clearChanges() {
+			state.changeLog.clear();
+		},
+		reset(nextBaseTree) {
+			resetState(state, nextBaseTree);
+		}
+	};
+}
+/**
+* 创建内存版 Virtual Workdir backend
+*
+* @example
+* ```ts
+* const backend = createMemoryVirtualWorkdirBackend();
+* const sessionId = backend.createSession({ baseTree: tree });
+* const session = backend.openSession(repo.objects, sessionId);
+* expect(session.baseTree).toBe(tree);
+* ```
+*/
+function createMemoryVirtualWorkdirBackend() {
+	const sessions = /* @__PURE__ */ new Map();
+	return {
+		kind: "memory",
+		createSession(options) {
+			const sessionId = createVirtualWorkdirSessionId();
+			sessions.set(sessionId, createVirtualWorkdirMemoryStateStore(options.baseTree));
+			return sessionId;
+		},
+		openSession(source, sessionId) {
+			const store = sessions.get(sessionId);
+			if (store === void 0) throw new Error(`Virtual workdir session not found: ${sessionId}`);
+			return openVirtualWorkdirSession(source, store);
+		},
+		deleteSession(sessionId) {
+			if (!sessions.delete(sessionId)) throw new Error(`Virtual workdir session not found: ${sessionId}`);
+		},
+		listSessions() {
+			return Array.from(sessions.keys());
+		}
+	};
+}
+function resetState(state, baseTree) {
+	state.baseTree = baseTree;
+	state.nodes.clear();
+	state.nodes.set(VIRTUAL_ROOT_NODE_ID, createRootDirectoryNode(baseTree));
+	state.changeLog.clear();
+}
+function snapshotState(state) {
 	const nodes = /* @__PURE__ */ new Map();
-	nodes.set(VIRTUAL_ROOT_NODE_ID, createRootDirectoryNode(baseTree));
+	for (const [nodeId, node] of state.nodes) nodes.set(nodeId, cloneSessionNode(node));
 	return {
-		baseTree,
+		baseTree: state.baseTree,
 		nodes,
-		changeLog: createVirtualChangeLog()
+		changes: state.changeLog.snapshot()
+	};
+}
+function restoreState(state, snapshot) {
+	state.baseTree = snapshot.baseTree;
+	state.nodes.clear();
+	for (const [nodeId, node] of snapshot.nodes) state.nodes.set(nodeId, cloneSessionNode(node));
+	state.changeLog.clear();
+	for (const record of snapshot.changes) state.changeLog.append(record);
+}
+function cloneSessionNode(node) {
+	if (node.state.kind === "directory") return {
+		id: node.id,
+		origin: node.origin,
+		state: {
+			kind: "directory",
+			overlay: {
+				addedEntries: new Map(node.state.overlay.addedEntries),
+				deletedNames: new Set(node.state.overlay.deletedNames)
+			}
+		}
+	};
+	if (node.state.kind === "file") return {
+		id: node.id,
+		origin: node.origin,
+		state: node.state.content === void 0 ? {
+			kind: "file",
+			mode: node.state.mode
+		} : {
+			kind: "file",
+			mode: node.state.mode,
+			content: Buffer.from(node.state.content)
+		}
+	};
+	return {
+		id: node.id,
+		origin: node.origin,
+		state: node.state.target === void 0 ? {
+			kind: "symlink",
+			mode: "120000"
+		} : {
+			kind: "symlink",
+			mode: "120000",
+			target: Buffer.from(node.state.target)
+		}
 	};
 }
 //#endregion
-export { createVirtualWorkdirMemoryState };
+export { createMemoryVirtualWorkdirBackend, createVirtualWorkdirMemoryStateStore };

package/dist/workdir/memory.d.mts

@@ -1,2 +1,3 @@
-import { createVirtualWorkdirSession } from "./session.mjs";
-export { createVirtualWorkdirSession };
+import { createMemoryVirtualWorkdirBackend } from "./memory-backend.mjs";
+import { createVirtualWorkdirSession, openVirtualWorkdirSession } from "./session.mjs";
+export { createMemoryVirtualWorkdirBackend, createVirtualWorkdirSession, openVirtualWorkdirSession };

package/dist/workdir/memory.mjs

@@ -1,2 +1,3 @@
-import { createVirtualWorkdirSession } from "./session.mjs";
-export { createVirtualWorkdirSession };
+import { createVirtualWorkdirSession, openVirtualWorkdirSession } from "./session.mjs";
+import { createMemoryVirtualWorkdirBackend } from "./memory-backend.mjs";
+export { createMemoryVirtualWorkdirBackend, createVirtualWorkdirSession, openVirtualWorkdirSession };

package/dist/workdir/nodes.d.mts

@@ -0,0 +1,57 @@
+import { SHA1 } from "../core/types.mjs";
+import { NodeId } from "./ids.mjs";
+import { DirectoryOverlay } from "./overlay.mjs";
+
+//#region src/workdir/nodes.d.ts
+/** Blob / 符号链接在 origin 与 state 中使用的 mode */
+type BlobObjectMode = "100644" | "100755" | "120000";
+/**
+ * 节点来源（repo 对象或纯 session 新建）
+ */
+type NodeOrigin = {
+  readonly kind: "none";
+} | {
+  readonly kind: "repo-tree";
+  readonly hash: SHA1;
+} | {
+  readonly kind: "repo-blob";
+  readonly mode: BlobObjectMode;
+  readonly hash: SHA1;
+};
+/**
+ * 目录节点当前状态
+ *
+ * `overlay` 表达 session 层增删改；子项 nodeId 通过 overlay 合成与懒加载解析。
+ */
+interface DirectoryNodeState {
+  readonly kind: "directory";
+  readonly overlay: DirectoryOverlay;
+}
+/**
+ * 文件节点当前状态（raw content overlay）
+ */
+interface FileNodeState {
+  readonly kind: "file";
+  readonly mode: "100644" | "100755";
+  /** 未设置时表示未 materialize，可读 origin */
+  readonly content?: Buffer;
+}
+/**
+ * 符号链接节点当前状态
+ */
+interface SymlinkNodeState {
+  readonly kind: "symlink";
+  readonly mode: "120000";
+  readonly target?: Buffer;
+}
+type SessionNodeState = DirectoryNodeState | FileNodeState | SymlinkNodeState;
+/**
+ * 完整的会话节点记录
+ */
+interface SessionNode {
+  readonly id: NodeId;
+  readonly origin: NodeOrigin;
+  readonly state: SessionNodeState;
+}
+//#endregion
+export { SessionNode };

package/dist/workdir/overlay.d.mts

@@ -0,0 +1,14 @@
+import { NodeId } from "./ids.mjs";
+
+//#region src/workdir/overlay.d.ts
+/**
+ * 目录 overlay 状态（挂在目录 SessionNode 上）
+ */
+interface DirectoryOverlay {
+  /** session 新增或覆盖：条目名 -> 绑定的 nodeId */
+  readonly addedEntries: Map<string, NodeId>;
+  /** session 删除的 origin/先前条目名（tombstone） */
+  readonly deletedNames: Set<string>;
+}
+//#endregion
+export { DirectoryOverlay };

package/dist/workdir/session-id.mjs

@@ -0,0 +1,18 @@
+//#region src/workdir/session-id.ts
+let nextSessionCounter = 1;
+/**
+* 分配新的 session ID
+*
+* @example
+* ```ts
+* const sessionId = createVirtualWorkdirSessionId();
+* expect(String(sessionId).startsWith("session:")).toBe(true);
+* ```
+*/
+function createVirtualWorkdirSessionId() {
+	const id = `session:${nextSessionCounter}`;
+	nextSessionCounter += 1;
+	return id;
+}
+//#endregion
+export { createVirtualWorkdirSessionId };

package/dist/workdir/session-internal.mjs

@@ -13,8 +13,8 @@ import { assertValidVirtualPath, joinPath, splitPathSegments } from "./path.mjs"
 * - origin 节点懒注册（ensureNodeFromTreeEntry）
 */
 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;
 }
 /**
@@ -36,8 +36,8 @@ function resolvePath(source, state, path) {
 			node: null
 		};
 		currentPath = joinPath(currentPath === "" ? null : currentPath, segment);
-		const childNode = state.nodes.get(child.nodeId);
-		if (childNode === void 0) return {
+		const childNode = state.getNode(child.nodeId);
+		if (childNode === null) return {
 			found: false,
 			node: null
 		};
@@ -61,8 +61,8 @@ function resolveChild(source, state, parentNode, parentPath, name) {
 		found: false,
 		node: null
 	};
-	const childNode = state.nodes.get(child.nodeId);
-	if (childNode === void 0) return {
+	const childNode = state.getNode(child.nodeId);
+	if (childNode === null) return {
 		found: false,
 		node: null
 	};
@@ -76,7 +76,7 @@ function resolveChild(source, state, parentNode, parentPath, name) {
 */
 function ensureNodeFromTreeEntry(state, entry) {
 	const id = originBackedNodeId(entry.hash);
-	if (!state.nodes.has(id)) {
+	if (state.getNode(id) === null) {
 		const origin = treeEntryToNodeOrigin(entry);
 		let nodeState;
 		if (entry.mode === "40000") nodeState = {
@@ -94,7 +94,7 @@ function ensureNodeFromTreeEntry(state, entry) {
 			kind: "file",
 			mode: entry.mode === "100755" ? "100755" : "100644"
 		};
-		state.nodes.set(id, {
+		state.setNode({
 			id,
 			origin,
 			state: nodeState
@@ -127,8 +127,8 @@ function buildAddedModes(state, dirNode) {
 	const addedModes = /* @__PURE__ */ new Map();
 	for (const name of dirNode.state.overlay.addedEntries.keys()) {
 		const nodeId = dirNode.state.overlay.addedEntries.get(name);
-		const node = state.nodes.get(nodeId);
-		if (node !== void 0) addedModes.set(name, sessionNodeMode(node));
+		const node = state.getNode(nodeId);
+		if (node !== null) addedModes.set(name, sessionNodeMode(node));
 	}
 	return addedModes;
 }

package/dist/workdir/session.d.mts

@@ -1,5 +1,6 @@
 import { ObjectDatabase } from "../core/types/odb.mjs";
 import { CreateVirtualWorkdirSessionOptions, VirtualWorkdirSession } from "./core.mjs";
+import { VirtualWorkdirStateStore } from "./state-store.mjs";
 
 //#region src/workdir/session.d.ts
 /**
@@ -14,5 +15,16 @@ import { CreateVirtualWorkdirSessionOptions, VirtualWorkdirSession } from "./cor
  * ```
  */
 declare function createVirtualWorkdirSession(source: ObjectDatabase, options: CreateVirtualWorkdirSessionOptions): VirtualWorkdirSession;
+/**
+ * 基于已有状态存储打开 session
+ *
+ * @example
+ * ```ts
+ * const store = createVirtualWorkdirMemoryStateStore(tree);
+ * const session = openVirtualWorkdirSession(repo.objects, store);
+ * expect(session.baseTree).toBe(tree);
+ * ```
+ */
+declare function openVirtualWorkdirSession(source: ObjectDatabase, state: VirtualWorkdirStateStore): VirtualWorkdirSession;
 //#endregion
-export { createVirtualWorkdirSession };
+export { createVirtualWorkdirSession, openVirtualWorkdirSession };