@mxpicture/build-api 0.2.13 → 0.2.14

package/dist/format/format.code.d.ts

@@ -0,0 +1,5 @@
+import { SourceFile } from "../types/types.code.js";
+export declare const formatCode: (...lines: string[]) => Promise<string>;
+export declare const formatJson: (...lines: string[]) => Promise<string>;
+export declare const formatJson2Spaces: (...lines: string[]) => Promise<string>;
+export declare const createSourceFiles: (filePaths: string[]) => SourceFile[];

package/dist/format/format.code.js

@@ -0,0 +1,21 @@
+import ts from "typescript";
+import { format } from "prettier";
+export const formatCode = async (...lines) => format(lines.join("\n"), { parser: "typescript" });
+export const formatJson = async (...lines) => format(lines.join("\n"), { parser: "json" });
+export const formatJson2Spaces = async (...lines) => format(lines.join("\n"), { parser: "json", tabWidth: 2, useTabs: false });
+export const createSourceFiles = (filePaths) => {
+    const program = ts.createProgram(filePaths, {
+        target: ts.ScriptTarget.ES2023,
+        module: ts.ModuleKind.Node20,
+        strict: true,
+    });
+    const checker = program.getTypeChecker();
+    const results = [];
+    for (const filePath of filePaths) {
+        const sourceFile = program.getSourceFile(filePath);
+        if (!sourceFile)
+            continue;
+        results.push({ sourceFile, filePath, checker });
+    }
+    return results;
+};

package/dist/format/index.d.ts

@@ -0,0 +1 @@
+export * from "./format.code.js";

package/dist/format/index.js

@@ -0,0 +1,2 @@
+// This file is auto-generated. Do not edit manually.
+export * from "./format.code.js";

package/dist/git/GitChanges.d.ts

@@ -0,0 +1,33 @@
+import { GitChangedResult, GitChangedContentsResult } from "../types/types.git.js";
+export declare class GitChanges {
+    readonly rootDir: string;
+    protected _sinceCommit: string | null;
+    constructor(rootDir: string);
+    set sinceCommit(sinceCommit: string);
+    get sinceCommit(): string;
+    /**
+     * Checks if a specific file or directory has been changed since a given git commit.
+     * Includes both committed and uncommitted changes (staged + unstaged).
+     *
+     * @param target - Relative path to the file or directory to check.
+     * @param sinceCommit - The git commit hash (or ref like a tag/branch) to compare against.
+     * @returns A result object indicating whether changes were detected.
+     */
+    hasChanged(path: string): Promise<GitChangedResult>;
+    /**
+     * Reads the current content of all files that have changed since a given git commit
+     * within a specific file or directory scope.
+     * Includes both committed and uncommitted changes (staged + unstaged).
+     *
+     * Deleted files are excluded from the result since they no longer exist on disk.
+     *
+     * @param target - Relative path to the file or directory to check.
+     * @param sinceCommit - The git commit hash (or ref like a tag/branch) to compare against.
+     * @param cwd - The working directory of the git repository (defaults to process.cwd()).
+     * @returns A result object containing the current content of each changed file.
+     */
+    readChangedFiles(readContent?: boolean): Promise<GitChangedContentsResult>;
+}
+export declare class GitChangesCommit extends GitChanges {
+    constructor(rootDir: string, sinceCommit: string);
+}

package/dist/git/GitChanges.js

@@ -0,0 +1,85 @@
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { verifiedGit } from "./git.util.js";
+export class GitChanges {
+    rootDir;
+    _sinceCommit = null;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    set sinceCommit(sinceCommit) {
+        this._sinceCommit = sinceCommit;
+    }
+    get sinceCommit() {
+        if (!this._sinceCommit)
+            throw new Error("SinceCommit missing");
+        return this._sinceCommit;
+    }
+    /**
+     * Checks if a specific file or directory has been changed since a given git commit.
+     * Includes both committed and uncommitted changes (staged + unstaged).
+     *
+     * @param target - Relative path to the file or directory to check.
+     * @param sinceCommit - The git commit hash (or ref like a tag/branch) to compare against.
+     * @returns A result object indicating whether changes were detected.
+     */
+    async hasChanged(path) {
+        const sinceCommit = this.sinceCommit;
+        const resolvedTarget = resolve(this.rootDir, path);
+        if (!existsSync(resolvedTarget)) {
+            throw new Error(`Target path does not exist: ${resolvedTarget}`);
+        }
+        const git = await verifiedGit(this.rootDir, sinceCommit);
+        // Compare commit to working directory (includes uncommitted changes)
+        const diff = await git.diffSummary([sinceCommit, "--", path]);
+        const changedFiles = diff.files.map((file) => file.file);
+        return {
+            path,
+            sinceCommit,
+            hasChanged: changedFiles.length > 0,
+            changedFiles,
+        };
+    }
+    /**
+     * Reads the current content of all files that have changed since a given git commit
+     * within a specific file or directory scope.
+     * Includes both committed and uncommitted changes (staged + unstaged).
+     *
+     * Deleted files are excluded from the result since they no longer exist on disk.
+     *
+     * @param target - Relative path to the file or directory to check.
+     * @param sinceCommit - The git commit hash (or ref like a tag/branch) to compare against.
+     * @param cwd - The working directory of the git repository (defaults to process.cwd()).
+     * @returns A result object containing the current content of each changed file.
+     */
+    async readChangedFiles(readContent) {
+        const sinceCommit = this.sinceCommit;
+        const git = await verifiedGit(this.rootDir, sinceCommit);
+        // Compare commit to working directory (includes uncommitted changes)
+        const diff = await git.diffSummary([sinceCommit, "--", this.rootDir]);
+        const files = [];
+        for (const entry of diff.files) {
+            const repoFilePath = entry.file;
+            const absFilePath = resolve(this.rootDir, repoFilePath);
+            // Skip deleted files — they no longer exist on disk
+            if (!existsSync(absFilePath)) {
+                continue;
+            }
+            // Read from the file system to capture uncommitted changes
+            const content = readContent ? await readFile(absFilePath, "utf-8") : null;
+            files.push({ absFilePath, content, repoFilePath });
+        }
+        return {
+            path: this.rootDir,
+            sinceCommit,
+            files,
+        };
+    }
+}
+export class GitChangesCommit extends GitChanges {
+    constructor(rootDir, sinceCommit) {
+        super(rootDir);
+        this.sinceCommit = sinceCommit;
+    }
+}

package/dist/git/git.util.d.ts

@@ -0,0 +1,10 @@
+import { SimpleGit } from "simple-git";
+import { GitCommitHash } from "../types/types.git.js";
+/**
+ * Creates a SimpleGit instance and verifies the cwd is a repo
+ * and the commit ref is valid.
+ */
+export declare const verifiedGit: (rootDir: string, commitRef?: string) => Promise<SimpleGit>;
+export declare const lastCommitHash: (rootDir: string) => Promise<string | null>;
+export declare const commitHashs: (rootDir: string) => Promise<GitCommitHash[]>;
+export declare const ensureCommitRef: (ref: string, fallback: string, rootDir: string) => Promise<string>;

package/dist/git/git.util.js

@@ -0,0 +1,43 @@
+import { simpleGit } from "simple-git";
+const __entries = [];
+/**
+ * Creates a SimpleGit instance and verifies the cwd is a repo
+ * and the commit ref is valid.
+ */
+export const verifiedGit = async (rootDir, commitRef) => {
+    let found = __entries.find((entry) => entry.rootDir === rootDir && entry.commitRef === commitRef);
+    if (!found) {
+        found = await verifyGit(simpleGit(rootDir), rootDir, commitRef);
+        __entries.push(found);
+    }
+    return found.git;
+};
+const verifyGit = async (git, rootDir, commitRef) => {
+    if (!(await git.checkIsRepo()))
+        throw new Error(`Not a git repository: ${rootDir}`);
+    if (!commitRef)
+        return { git, rootDir, commitRef };
+    try {
+        await git.revparse(["--verify", commitRef]);
+    }
+    catch {
+        throw new Error(`Invalid git commit reference: "${commitRef}"`);
+    }
+    return { git, rootDir, commitRef };
+};
+export const lastCommitHash = async (rootDir) => (await (await verifiedGit(rootDir)).log()).latest?.hash ?? null;
+export const commitHashs = async (rootDir) => (await (await verifiedGit(rootDir)).log()).all.map((a) => ({
+    date: a.date,
+    hash: a.hash,
+    diff: a.diff,
+}));
+export const ensureCommitRef = async (ref, fallback, rootDir) => {
+    try {
+        await verifiedGit(rootDir, ref);
+        return ref;
+    }
+    catch {
+        await verifiedGit(rootDir, fallback);
+        return fallback;
+    }
+};

package/dist/git/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./GitChanges.js";
+export * from "./git.util.js";

package/dist/git/index.js

@@ -0,0 +1,3 @@
+// This file is auto-generated. Do not edit manually.
+export * from "./GitChanges.js";
+export * from "./git.util.js";

package/dist/types/index.d.ts

@@ -1,7 +1,11 @@
 export * from "./types.barrel.js";
+export * from "./types.changelog.js";
 export * from "./types.changeset.js";
 export * from "./types.cleanup.js";
+export * from "./types.code.js";
 export * from "./types.deps.js";
+export * from "./types.documents.js";
+export * from "./types.git.js";
 export * from "./types.npm.js";
 export * from "./types.os.js";
 export * from "./types.package.js";

package/dist/types/index.js

@@ -1,8 +1,12 @@
 // This file is auto-generated. Do not edit manually.
 export * from "./types.barrel.js";
+export * from "./types.changelog.js";
 export * from "./types.changeset.js";
 export * from "./types.cleanup.js";
+export * from "./types.code.js";
 export * from "./types.deps.js";
+export * from "./types.documents.js";
+export * from "./types.git.js";
 export * from "./types.npm.js";
 export * from "./types.os.js";
 export * from "./types.package.js";

package/dist/types/types.changelog.d.ts

@@ -0,0 +1,13 @@
+import { DocumentData } from "./types.documents.js";
+export declare enum ChangeWatchType {
+    changelog = "changelog",
+    gitHistory = "gitHistory"
+}
+export interface ChangeWatch {
+    pattern: string;
+    type: ChangeWatchType;
+}
+export type ChangeEventHandler<T extends DocumentData> = (paths: string[], watch: ChangeWatch) => Promise<T | null>;
+export interface ChangeWatchHandler<T extends DocumentData> extends ChangeWatch {
+    handler: ChangeEventHandler<T>;
+}

package/dist/types/types.changelog.js

@@ -0,0 +1,5 @@
+export var ChangeWatchType;
+(function (ChangeWatchType) {
+    ChangeWatchType["changelog"] = "changelog";
+    ChangeWatchType["gitHistory"] = "gitHistory";
+})(ChangeWatchType || (ChangeWatchType = {}));

package/dist/types/types.code.d.ts

@@ -0,0 +1,6 @@
+import ts from "typescript";
+export interface SourceFile {
+    filePath: string;
+    checker: ts.TypeChecker;
+    sourceFile: ts.SourceFile;
+}

package/dist/types/types.code.js

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

package/dist/types/types.documents.d.ts

@@ -0,0 +1,4 @@
+export type DocumentFieldValue = any;
+export type DocumentData = {
+    [field: string]: DocumentFieldValue;
+};

package/dist/types/types.documents.js

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

package/dist/types/types.git.d.ts

@@ -0,0 +1,22 @@
+import type { DiffResult } from "simple-git";
+export interface GitChangedResult {
+    path: string;
+    sinceCommit: string;
+    hasChanged: boolean;
+    changedFiles: string[];
+}
+export interface GitChangedContent {
+    absFilePath: string;
+    repoFilePath: string;
+    content: string | null;
+}
+export interface GitChangedContentsResult {
+    path: string;
+    sinceCommit: string;
+    files: GitChangedContent[];
+}
+export interface GitCommitHash {
+    hash: string;
+    date: string;
+    diff?: DiffResult;
+}

package/dist/types/types.git.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxpicture/build-api",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Build utilities API",
   "type": "module",
   "author": "MXPicture",
@@ -15,6 +15,8 @@
     "./cleanup": "./dist/cleanup/index.js",
     "./common": "./dist/common/index.js",
     "./deps": "./dist/deps/index.js",
+    "./format": "./dist/format/index.js",
+    "./git": "./dist/git/index.js",
     "./logger": "./dist/logger/index.js",
     "./npmPublish": "./dist/npmPublish/index.js",
     "./osInfo": "./dist/osInfo/index.js",
@@ -42,7 +44,11 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@types/micromatch": "^4.0.10",
     "json5": "^2.2.3",
+    "micromatch": "^4.0.8",
+    "prettier": "^3.8.1",
+    "simple-git": "^3.32.3",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   }