nano-git 0.1.0

package/dist/refs/shallow/memory.mjs

@@ -0,0 +1,33 @@
+//#region src/refs/shallow/memory.ts
+/**
+* 创建基于内存的 Shallow 存储
+*
+* @param initial - 初始 shallow 边界集合（可选）
+*
+* @example
+* ```ts
+* const store = createMemoryShallowStore([hashA]);
+* console.log(store.isShallow(hashA)); // true
+* ```
+*/
+function createMemoryShallowStore(initial) {
+	const shallowSet = new Set(initial ?? []);
+	return {
+		read() {
+			return Array.from(shallowSet).sort();
+		},
+		write(boundaries) {
+			shallowSet.clear();
+			for (const hash of boundaries) shallowSet.add(hash);
+		},
+		applyUpdate(update) {
+			for (const hash of update.unshallow) shallowSet.delete(hash);
+			for (const hash of update.shallow) shallowSet.add(hash);
+		},
+		isShallow(hash) {
+			return shallowSet.has(hash);
+		}
+	};
+}
+//#endregion
+export { createMemoryShallowStore };

package/dist/repository/core.d.mts

@@ -0,0 +1,3 @@
+import { FileRepository, Repository } from "./types.mjs";
+import { createRepository } from "./create.mjs";
+export { type FileRepository, type Repository, createRepository };

package/dist/repository/core.mjs

@@ -0,0 +1,2 @@
+import { createRepository } from "./create.mjs";
+export { createRepository };

package/dist/repository/create.d.mts

@@ -0,0 +1,22 @@
+import { RepositoryBackend } from "../backend/types.mjs";
+import { Repository } from "./types.mjs";
+
+//#region src/repository/create.d.ts
+/**
+ * 基于显式后端创建仓库实例
+ *
+ * Repository 不负责拼装 ObjectStore / RefStore，
+ * 调用方需要显式提供统一的 RepositoryBackend。
+ *
+ * @param backend - 仓库后端
+ * @returns 仓库实例
+ *
+ * @example
+ * ```ts
+ * const backend = createMemoryRepositoryBackend();
+ * const repo = createRepository(backend);
+ * ```
+ */
+declare function createRepository(backend: RepositoryBackend): Repository;
+//#endregion
+export { createRepository };

package/dist/repository/create.mjs

@@ -0,0 +1,43 @@
+import { createRepoImportOperations } from "./import/import-session.mjs";
+import { createFetchRepositoryOperations } from "./ops/fetch-operations.mjs";
+import { createMaintenanceRepositoryOperations } from "./ops/maintenance-operations.mjs";
+import { createObjectRepositoryOperations } from "./ops/object-operations.mjs";
+import { createPushRepositoryOperations } from "./ops/push-operations.mjs";
+import { createRefRepositoryOperations } from "./ops/ref-operations.mjs";
+//#region src/repository/create.ts
+/**
+* 仓库实例创建逻辑
+*/
+/**
+* 基于显式后端创建仓库实例
+*
+* Repository 不负责拼装 ObjectStore / RefStore，
+* 调用方需要显式提供统一的 RepositoryBackend。
+*
+* @param backend - 仓库后端
+* @returns 仓库实例
+*
+* @example
+* ```ts
+* const backend = createMemoryRepositoryBackend();
+* const repo = createRepository(backend);
+* ```
+*/
+function createRepository(backend) {
+	const { objects, refs, packs, shallow, gitDir } = backend;
+	return {
+		objects,
+		refs,
+		packs,
+		shallow,
+		gitDir,
+		...createObjectRepositoryOperations(objects),
+		...createRefRepositoryOperations(backend),
+		...createMaintenanceRepositoryOperations(objects, refs, packs),
+		...createPushRepositoryOperations(backend),
+		...createFetchRepositoryOperations(backend),
+		...createRepoImportOperations(backend)
+	};
+}
+//#endregion
+export { createRepository };

package/dist/repository/file.d.mts

@@ -0,0 +1,43 @@
+import { FileRepository } from "./types.mjs";
+
+//#region src/repository/file.d.ts
+/**
+ * 初始化一个新的 bare Git 仓库
+ *
+ * 等价于 `git init --bare`，所有 Git 数据直接存放在传入路径下。
+ * 如需创建非 bare 仓库，请自行拼接 `.git` 子路径。
+ *
+ * @param path - bare 仓库根目录路径（Git 数据直接存放于此）
+ * @returns 仓库实例
+ *
+ * @example
+ * ```ts
+ * const repo = initRepository("/tmp/demo");
+ * console.log(repo.getCurrentBranch()); // => "main"
+ * ```
+ */
+declare function initRepository(path: string): FileRepository;
+/**
+ * 打开一个已有的 Git 仓库
+ *
+ * 传入的路径直接作为 `gitDir` 使用：
+ * - bare 仓库：传入仓库根路径
+ * - 非 bare 仓库：传入 `.git` 目录的完整路径
+ *
+ * 通过检测 `HEAD` 文件是否存在来判断是否为有效的 git 目录。
+ *
+ * @param path - git 目录路径（bare 仓库根路径，或非 bare 仓库的 `.git` 目录）
+ * @returns 仓库实例
+ *
+ * @example
+ * ```ts
+ * // bare 仓库
+ * const bareRepo = openRepository("/path/to/bare-repo");
+ *
+ * // 非 bare 仓库（需显式传入 .git 路径）
+ * const nonBareRepo = openRepository("/path/to/repo/.git");
+ * ```
+ */
+declare function openRepository(path: string): FileRepository;
+//#endregion
+export { initRepository, openRepository };

package/dist/repository/file.mjs

@@ -0,0 +1,82 @@
+import { RepositoryError } from "../core/errors.mjs";
+import { createFileRepositoryBackend } from "../backend/file-backend.mjs";
+import { createRepository } from "./create.mjs";
+import { createRepositoryFsObjectOperations } from "./ops/fs-object-operations.mjs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+//#region src/repository/file.ts
+/**
+* 文件仓库便捷创建函数
+*
+* 初始化或打开基于文件系统的 Git 仓库。
+* 拉入 `node:fs` 和完整文件后端。
+*
+* 函数直接接受仓库根路径作为 `gitDir` 参数：
+* - bare 仓库：传入仓库根路径即可
+* - 非 bare 仓库：显式传入 `.git` 子路径
+*
+* @example
+* ```ts
+* import { initRepository, openRepository } from "nano-git/repository/file";
+*
+* const repo = initRepository("/tmp/my-repo");
+* ```
+*/
+/**
+* 初始化一个新的 bare Git 仓库
+*
+* 等价于 `git init --bare`，所有 Git 数据直接存放在传入路径下。
+* 如需创建非 bare 仓库，请自行拼接 `.git` 子路径。
+*
+* @param path - bare 仓库根目录路径（Git 数据直接存放于此）
+* @returns 仓库实例
+*
+* @example
+* ```ts
+* const repo = initRepository("/tmp/demo");
+* console.log(repo.getCurrentBranch()); // => "main"
+* ```
+*/
+function initRepository(path) {
+	mkdirSync(join(path, "objects"), { recursive: true });
+	mkdirSync(join(path, "refs", "heads"), { recursive: true });
+	mkdirSync(join(path, "refs", "tags"), { recursive: true });
+	writeFileSync(join(path, "HEAD"), "ref: refs/heads/main\n");
+	return createFileRepository(path);
+}
+/**
+* 打开一个已有的 Git 仓库
+*
+* 传入的路径直接作为 `gitDir` 使用：
+* - bare 仓库：传入仓库根路径
+* - 非 bare 仓库：传入 `.git` 目录的完整路径
+*
+* 通过检测 `HEAD` 文件是否存在来判断是否为有效的 git 目录。
+*
+* @param path - git 目录路径（bare 仓库根路径，或非 bare 仓库的 `.git` 目录）
+* @returns 仓库实例
+*
+* @example
+* ```ts
+* // bare 仓库
+* const bareRepo = openRepository("/path/to/bare-repo");
+*
+* // 非 bare 仓库（需显式传入 .git 路径）
+* const nonBareRepo = openRepository("/path/to/repo/.git");
+* ```
+*/
+function openRepository(path) {
+	if (!existsSync(join(path, "HEAD"))) throw new RepositoryError(`Not a git repository: ${path}`);
+	return createFileRepository(path);
+}
+function createFileRepository(path) {
+	const backend = createFileRepositoryBackend(path);
+	const repo = createRepository(backend);
+	return {
+		...repo,
+		...createRepositoryFsObjectOperations(backend.objects, (data) => repo.writeBlob(data)),
+		gitDir: path
+	};
+}
+//#endregion
+export { initRepository, openRepository };

package/dist/repository/import/import-glob.mjs

@@ -0,0 +1,44 @@
+//#region src/repository/import/import-glob.ts
+/**
+* Glob 模式匹配工具
+*
+* 提供将 glob 模式转换为正则表达式以及判断 ref 名称是否匹配 glob 模式的功能。
+*/
+/**
+* 将 glob 模式转换为正则表达式
+*
+* 只支持 `*` 通配符（匹配任意字符，包括 /）。
+* 其他字符按字面量匹配。
+*
+* @param pattern - glob 模式，如 "refs/heads/*"
+* @returns RegExp
+*
+* @example
+* ```ts
+* const re = globToRegex("refs/heads/*");
+* re.test("refs/heads/main"); // true
+* re.test("refs/tags/v1");    // false
+* ```
+*/
+function globToRegex(pattern) {
+	const regexStr = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+	return new RegExp(`^${regexStr}$`);
+}
+/**
+* 判断 ref 名称是否匹配 glob 模式
+*
+* @param pattern - glob 模式
+* @param refName - ref 名称
+* @returns 是否匹配
+*
+* @example
+* ```ts
+* matchRefGlob("refs/heads/*", "refs/heads/main"); // true
+* matchRefGlob("refs/tags/v*", "refs/tags/v1.0");  // true
+* ```
+*/
+function matchRefGlob(pattern, refName) {
+	return globToRegex(pattern).test(refName);
+}
+//#endregion
+export { globToRegex, matchRefGlob };