@cyberalien/git-utils 0.0.1

package/lib/git/branch.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get current branch at target directory
+ */
+declare function getCurrentGitBranch(target: string): Promise<string | null>;
+export { getCurrentGitBranch };

package/lib/git/branch.js

@@ -0,0 +1,13 @@
+import { execAsync } from "../misc/exec.js";
+/**
+* Get current branch at target directory
+*/
+async function getCurrentGitBranch(target) {
+	try {
+		const { stdout } = await execAsync(`git rev-parse --abbrev-ref HEAD`, { cwd: target });
+		return stdout.trim();
+	} catch {
+		return null;
+	}
+}
+export { getCurrentGitBranch };

package/lib/git/clone.d.ts

@@ -0,0 +1,6 @@
+import { GitRepoConfig } from "./types.js";
+/**
+ * Clone Git repository to target directory
+ */
+declare function cloneGitRepo(repo: GitRepoConfig, target: string): Promise<boolean>;
+export { cloneGitRepo };

package/lib/git/clone.js

@@ -0,0 +1,21 @@
+import { execAsync } from "../misc/exec.js";
+import { doesGitRepoExist } from "./exists.js";
+import { rm } from "node:fs/promises";
+/**
+* Clone Git repository to target directory
+*/
+async function cloneGitRepo(repo, target) {
+	try {
+		await rm(target, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+	try {
+		await execAsync(`git clone ${repo.shallow ? "--depth 1" : ""} --branch ${repo.branch} ${repo.repo} ${target}`);
+	} catch {
+		return false;
+	}
+	return doesGitRepoExist(target);
+}
+export { cloneGitRepo };

package/lib/git/commit.d.ts

@@ -0,0 +1,2 @@
+declare function commitGitRepoChanges(target: string, message: string, push?: boolean): Promise<boolean>;
+export { commitGitRepoChanges };

package/lib/git/commit.js

@@ -0,0 +1,17 @@
+import { execAsync } from "../misc/exec.js";
+import { getCurrentGitBranch } from "./branch.js";
+async function commitGitRepoChanges(target, message, push = true) {
+	try {
+		await execAsync(`git add -A`, { cwd: target });
+		await execAsync(`git commit -m "${message}"`, { cwd: target });
+		if (!(await execAsync(`git status`, { cwd: target })).stdout.includes("Your branch is ahead of")) {
+			console.error("Failed to commit changes");
+			return false;
+		}
+		if (push) await execAsync(`git push origin "${await getCurrentGitBranch(target)}"`, { cwd: target });
+	} catch {
+		return false;
+	}
+	return true;
+}
+export { commitGitRepoChanges };

package/lib/git/exists.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Check if Git repository exists in target directory
+ */
+declare function doesGitRepoExist(target: string): Promise<boolean>;
+export { doesGitRepoExist };

package/lib/git/exists.js

@@ -0,0 +1,12 @@
+import { lstat } from "node:fs/promises";
+/**
+* Check if Git repository exists in target directory
+*/
+async function doesGitRepoExist(target) {
+	try {
+		return (await lstat(`${target}/.git`)).isDirectory();
+	} catch {
+		return false;
+	}
+}
+export { doesGitRepoExist };

package/lib/git/types.d.ts

@@ -0,0 +1,6 @@
+interface GitRepoConfig {
+  repo: string;
+  branch: string;
+  shallow?: boolean;
+}
+export { GitRepoConfig };

package/lib/git/types.js

@@ -0,0 +1 @@
+export {};

package/lib/git/updated.d.ts

@@ -0,0 +1,2 @@
+declare function isGitRepoUpdated(target: string): Promise<boolean | null>;
+export { isGitRepoUpdated };

package/lib/git/updated.js

@@ -0,0 +1,10 @@
+import { execAsync } from "../misc/exec.js";
+async function isGitRepoUpdated(target) {
+	try {
+		return !(await execAsync(`git status`, { cwd: target })).stdout.includes("nothing to commit, working tree clean");
+	} catch {
+		return null;
+	}
+	return false;
+}
+export { isGitRepoUpdated };

package/lib/misc/exec.d.ts

@@ -0,0 +1,10 @@
+import { ExecOptions } from "node:child_process";
+interface ExecResult {
+  stdout: string;
+  stderr: string;
+}
+/**
+ * Exec as Promise
+ */
+declare function execAsync(cmd: string, options?: ExecOptions): Promise<ExecResult>;
+export { ExecResult, execAsync };

package/lib/misc/exec.js

@@ -0,0 +1,21 @@
+import { resolve } from "node:path";
+import { exec } from "node:child_process";
+/**
+* Exec as Promise
+*/
+function execAsync(cmd, options) {
+	return new Promise((fulfill, reject) => {
+		if (typeof options?.cwd === "string") options = {
+			...options,
+			cwd: resolve(options.cwd)
+		};
+		exec(cmd, options, (error, stdout, stderr) => {
+			if (error) reject(error);
+			else fulfill({
+				stdout,
+				stderr
+			});
+		});
+	});
+}
+export { execAsync };

package/lib/misc/json.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Read and parse JSON file
+ */
+declare function readJsonFile<T>(target: string, filename: string): Promise<any>;
+/**
+ * Write JSON file
+ */
+declare function writeJsonFile<T>(target: string, filename: string, data: T): Promise<void>;
+export { readJsonFile, writeJsonFile };

package/lib/misc/json.js

@@ -0,0 +1,16 @@
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
+/**
+* Read and parse JSON file
+*/
+async function readJsonFile(target, filename) {
+	const data = await readFile(join(target, filename), "utf-8");
+	return JSON.parse(data);
+}
+/**
+* Write JSON file
+*/
+async function writeJsonFile(target, filename, data) {
+	await writeFile(join(target, filename), JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+export { readJsonFile, writeJsonFile };

package/lib/misc/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Bump version in package.json file, return new version
+ */
+declare function bumpPackageVersion(target: string, newVersion?: string | ((currentVersion: string) => string)): Promise<string>;
+export { bumpPackageVersion };

package/lib/misc/version.js

@@ -0,0 +1,24 @@
+import { readJsonFile, writeJsonFile } from "./json.js";
+function update(oldVersion, newVersion) {
+	if (typeof newVersion === "string") return newVersion;
+	if (newVersion) return newVersion(oldVersion);
+	const parts = oldVersion.split(".");
+	const lastPart = parseInt(parts.pop() || "");
+	if (isNaN(lastPart)) throw new Error(`Invalid version: ${oldVersion}`);
+	parts.push((lastPart + 1).toString());
+	return parts.join(".");
+}
+/**
+* Bump version in package.json file, return new version
+*/
+async function bumpPackageVersion(target, newVersion) {
+	const content = await readJsonFile(target, "package.json");
+	const oldVersion = content.version;
+	const version = update(oldVersion, newVersion);
+	if (version !== oldVersion) {
+		content.version = version;
+		writeJsonFile(target, "package.json", content);
+	}
+	return version;
+}
+export { bumpPackageVersion };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@cyberalien/git-utils",
+  "type": "module",
+  "description": "Functions for working with git repos.",
+  "author": "Vjacheslav Trushkin",
+  "version": "0.0.1",
+  "license": "UNLICENSED",
+  "bugs": "https://github.com/cyberalien/svg-utils/issues",
+  "homepage": "https://cyberalien.dev/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyberalien/svg-utils.git"
+  },
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "module": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "*.d.ts"
+  ],
+  "dependencies": {
+    "@iconify/types": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "oxlint": "^1.60.0",
+    "tsdown": "^0.21.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "scripts": {
+    "lint": "oxlint --fix src/**/*.ts && tsc --noemit",
+    "prebuild": "pnpm run lint",
+    "build": "tsdown",
+    "test": "vitest"
+  }
+}