@hardlydifficult/repo-processor 1.0.140 → 1.0.142

package/dist/RepoWatcher.js

@@ -2,146 +2,117 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RepoWatcher = void 0;
 const state_tracker_1 = require("@hardlydifficult/state-tracker");
-/**
- * Watches for SHA changes on GitHub repos and triggers processing.
- *
- * Handles state persistence (last-processed SHA per repo), concurrent run
- * prevention, pending SHA re-triggers, and manual triggers. Consumers
- * provide the `run` callback containing domain-specific logic.
- */
+function getDefaultStateKey(repo) {
+    return `repo-processor-${repo.replace(/[^A-Za-z0-9_-]/gu, "-")}`;
+}
+/** Watches for repository updates and schedules processor runs with retries. */
 class RepoWatcher {
-    stateTracker;
-    running = new Set();
-    pendingSha = new Map();
-    config;
-    maxAttempts;
-    constructor(config) {
-        this.config = config;
-        this.maxAttempts = config.maxAttempts ?? 1;
-        this.stateTracker = new state_tracker_1.StateTracker({
-            key: config.stateKey,
-            default: { lastProcessedSha: {} },
-            stateDirectory: config.stateDirectory,
-            storageAdapter: config.storageAdapter,
-            autoSaveMs: config.autoSaveMs ?? 5000,
-            onEvent: config.onEvent,
+    static async open(processor, options = {}) {
+        const stateTracker = await state_tracker_1.StateTracker.open({
+            key: options.stateKey ?? getDefaultStateKey(processor.repo),
+            default: {},
+            stateDirectory: options.stateDirectory,
+            autoSaveMs: options.autoSaveMs ?? 5000,
+            onEvent: options.onEvent,
         });
+        return new RepoWatcher(processor, stateTracker, options);
     }
-    /** Load persisted state from disk. */
-    async init() {
-        await this.stateTracker.loadAsync();
+    processor;
+    stateTracker;
+    onComplete;
+    onError;
+    onEvent;
+    maxAttempts;
+    running = false;
+    pendingSha;
+    constructor(processor, stateTracker, options) {
+        this.processor = processor;
+        this.stateTracker = stateTracker;
+        this.onComplete = options.onComplete;
+        this.onError = options.onError;
+        this.onEvent = options.onEvent;
+        this.maxAttempts = options.maxAttempts ?? 1;
     }
-    /**
-     * Handle a push event. Compares the SHA against tracked state,
-     * queues processing if changed, stores as pending if already running.
-     */
-    handlePush(owner, name, sha) {
-        const key = `${owner}/${name}`;
-        const lastSha = this.stateTracker.state.lastProcessedSha[key];
-        if (lastSha === sha) {
+    handlePush(sha) {
+        if (this.getLastSha() === sha) {
             return;
         }
-        if (this.running.has(key)) {
-            this.pendingSha.set(key, sha);
+        if (this.running) {
+            this.pendingSha = sha;
             return;
         }
-        this.queueRun(owner, name, sha);
-    }
-    /**
-     * Queue a run unconditionally (no SHA comparison).
-     * Skips if already running. Returns false if skipped.
-     */
-    trigger(owner, name) {
-        const key = `${owner}/${name}`;
-        if (this.running.has(key)) {
-            return false;
-        }
-        this.queueRun(owner, name, "");
-        return true;
+        this.queueRun();
     }
-    /**
-     * Run processing synchronously (blocks until complete).
-     * Returns an error if already running.
-     */
-    async triggerManual(owner, name) {
-        const key = `${owner}/${name}`;
-        if (this.running.has(key)) {
-            return {
-                success: false,
-                reason: `Already running for ${key}`,
-            };
+    async runNow() {
+        if (this.running) {
+            throw new Error(`Already running for ${this.processor.repo}`);
         }
-        this.running.add(key);
+        this.running = true;
         try {
-            const result = await this.executeWithRetry(owner, name);
-            return { success: true, result };
+            const result = await this.executeWithRetry();
+            this.completeRun(result);
+            return result;
         }
         catch (error) {
-            this.config.onError?.(owner, name, error);
-            const message = error instanceof Error ? error.message : String(error);
-            return { success: false, reason: message };
+            this.onError?.(error);
+            throw error;
         }
         finally {
-            this.running.delete(key);
+            this.running = false;
+            this.flushPendingRun();
         }
     }
-    /** Check if a repo is currently being processed. */
-    isRunning(owner, name) {
-        return this.running.has(`${owner}/${name}`);
+    isRunning() {
+        return this.running;
     }
-    /** Get the last processed SHA for a repo key. */
-    getLastSha(key) {
-        return this.stateTracker.state.lastProcessedSha[key];
+    getLastSha() {
+        return this.stateTracker.state.lastProcessedSha;
     }
-    /** Persist a processed SHA for a repo key. */
-    setLastSha(key, sha) {
-        this.stateTracker.set({
-            ...this.stateTracker.state,
-            lastProcessedSha: {
-                ...this.stateTracker.state.lastProcessedSha,
-                [key]: sha,
-            },
-        });
+    setLastSha(sha) {
+        this.stateTracker.set({ lastProcessedSha: sha });
     }
-    // ---------------------------------------------------------------------------
-    // Private
-    // ---------------------------------------------------------------------------
-    queueRun(owner, name, sha) {
-        const key = `${owner}/${name}`;
-        this.running.add(key);
-        this.executeWithRetry(owner, name)
+    queueRun() {
+        this.running = true;
+        this.executeWithRetry()
             .then((result) => {
-            if (sha) {
-                this.setLastSha(key, sha);
-            }
-            this.config.onComplete?.(owner, name, result, sha);
+            this.completeRun(result);
         })
             .catch((error) => {
-            this.config.onError?.(owner, name, error);
+            this.onError?.(error);
         })
             .finally(() => {
-            this.running.delete(key);
-            const pending = this.pendingSha.get(key);
-            if (pending !== undefined) {
-                this.pendingSha.delete(key);
-                this.handlePush(owner, name, pending);
-            }
+            this.running = false;
+            this.flushPendingRun();
         });
     }
-    async executeWithRetry(owner, name) {
+    completeRun(result) {
+        this.setLastSha(result.sourceSha);
+        this.onComplete?.(result, result.sourceSha);
+    }
+    flushPendingRun() {
+        const { pendingSha } = this;
+        this.pendingSha = undefined;
+        if (pendingSha === undefined ||
+            pendingSha === this.getLastSha() ||
+            this.running) {
+            return;
+        }
+        this.queueRun();
+    }
+    async executeWithRetry() {
         let lastError;
         for (let attempt = 1; attempt <= this.maxAttempts; attempt++) {
             try {
-                return await this.config.run(owner, name);
+                return await this.processor.run();
             }
             catch (error) {
                 lastError = error;
                 if (attempt < this.maxAttempts) {
-                    this.config.onEvent?.({
+                    this.onEvent?.({
                         level: "warn",
                         message: `Run failed (attempt ${String(attempt)}/${String(this.maxAttempts)}), retrying`,
                         context: {
-                            repo: `${owner}/${name}`,
+                            repo: this.processor.repo,
                             error: error instanceof Error ? error.message : String(error),
                         },
                     });

package/dist/RepoWatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"RepoWatcher.js","sourceRoot":"","sources":["../src/RepoWatcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RepoWatcher.js","sourceRoot":"","sources":["../src/RepoWatcher.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,4 @@
 export { RepoProcessor } from "./RepoProcessor.js";
-export type { RepoProcessorConfig } from "./RepoProcessor.js";
 export { RepoWatcher } from "./RepoWatcher.js";
-export type { RepoWatcherConfig } from "./RepoWatcher.js";
-export { resolveStaleDirectories } from "./resolveDirectories.js";
-export { GitYamlStore } from "./GitYamlStore.js";
-export type { GitYamlStoreConfig } from "./GitYamlStore.js";
-export type { ProcessorStore, ProcessorCallbacks, FileContext, DirectoryContext, DirectoryChild, ProcessingProgress, ProgressCallback, ProcessingResult, } from "./types.js";
+export type { GitIdentity, RepoFileFilterInput, RepoFileInput, RepoDirectoryChild, RepoDirectoryInput, RepoProcessorResultsConfig, RepoProcessorOptions, RepoProcessorProgressCounts, RepoProcessorProgress, RepoProcessorProgressCallback, RepoProcessorRunOptions, RepoProcessorRunResult, RepoWatcherOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,12 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GitYamlStore = exports.resolveStaleDirectories = exports.RepoWatcher = exports.RepoProcessor = void 0;
+exports.RepoWatcher = exports.RepoProcessor = void 0;
 var RepoProcessor_js_1 = require("./RepoProcessor.js");
 Object.defineProperty(exports, "RepoProcessor", { enumerable: true, get: function () { return RepoProcessor_js_1.RepoProcessor; } });
 var RepoWatcher_js_1 = require("./RepoWatcher.js");
 Object.defineProperty(exports, "RepoWatcher", { enumerable: true, get: function () { return RepoWatcher_js_1.RepoWatcher; } });
-var resolveDirectories_js_1 = require("./resolveDirectories.js");
-Object.defineProperty(exports, "resolveStaleDirectories", { enumerable: true, get: function () { return resolveDirectories_js_1.resolveStaleDirectories; } });
-var GitYamlStore_js_1 = require("./GitYamlStore.js");
-Object.defineProperty(exports, "GitYamlStore", { enumerable: true, get: function () { return GitYamlStore_js_1.GitYamlStore; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AAEtB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA;AAEpB,iEAAkE;AAAzD,gIAAA,uBAAuB,OAAA;AAChC,qDAAiD;AAAxC,+GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAA1C,iHAAA,aAAa,OAAA;AACtB,mDAA+C;AAAtC,6GAAA,WAAW,OAAA"}

package/dist/internalTypes.d.ts

@@ -0,0 +1,42 @@
+import type { FileTreeResult, TreeEntry } from "@hardlydifficult/github";
+import type { z } from "zod";
+import type { RepoDirectoryInput, RepoFileFilterInput, RepoFileInput } from "./types.js";
+export interface BoundRepoRef {
+    owner: string;
+    name: string;
+    fullName: string;
+}
+export type FileManifest = Record<string, string>;
+export interface ResultsStore {
+    ensureReady(): Promise<void>;
+    getFileManifest(): Promise<FileManifest>;
+    getDirSha(dirPath: string): Promise<string | null>;
+    writeFileResult(filePath: string, sha: string, result: unknown): Promise<void>;
+    writeDirResult(dirPath: string, sha: string, result: unknown): Promise<void>;
+    deleteFileResult(filePath: string): Promise<void>;
+    commitBatch(sourceRepo: string, count: number): Promise<void>;
+    readFileResult<T>(filePath: string, schema: z.ZodType<T>): Promise<T | null>;
+    readDirectoryResult<T>(dirPath: string, schema: z.ZodType<T>): Promise<T | null>;
+}
+export interface RepoClientLike {
+    getFileTree(ref?: string): Promise<FileTreeResult>;
+    getFileContent(filePath: string, ref?: string): Promise<string>;
+}
+export interface RepoProcessorInternals<TFileResult, TDirResult = never> {
+    repo: BoundRepoRef;
+    repoClient: RepoClientLike;
+    store: ResultsStore;
+    ref?: string;
+    concurrency: number;
+    include: (file: RepoFileFilterInput) => boolean;
+    processFile(file: RepoFileInput): Promise<TFileResult>;
+    processDirectory?: (directory: RepoDirectoryInput) => Promise<TDirResult>;
+}
+export interface ProcessingFailure {
+    path: string;
+    reason: unknown;
+}
+export type DirectoryTreeEntry = TreeEntry & {
+    type: "tree";
+};
+//# sourceMappingURL=internalTypes.d.ts.map

package/dist/internalTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalTypes.d.ts","sourceRoot":"","sources":["../src/internalTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACzC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,mBAAmB,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,sBAAsB,CAAC,WAAW,EAAE,UAAU,GAAG,KAAK;IACrE,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAChD,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/internalTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internalTypes.js.map

package/dist/internalTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalTypes.js","sourceRoot":"","sources":["../src/internalTypes.ts"],"names":[],"mappings":""}

package/dist/resolveDirectories.d.ts

@@ -1,14 +1,5 @@
 import type { TreeEntry } from "@hardlydifficult/github";
-import type { ProcessorStore } from "./types.js";
-/**
- * Find all directories that need (re-)processing.
- *
- * Combines two sources:
- * 1. Stale dirs from diffTree (directories with changed/removed children)
- * 2. Any directory whose stored SHA is missing or differs from the current tree SHA
- *
- * The second source handles recovery after partial failures and catches
- * directories whose tree SHA changed without any processable file changes.
- */
-export declare function resolveStaleDirectories(owner: string, repo: string, staleDirsFromDiff: readonly string[], allFilePaths: readonly string[], tree: readonly TreeEntry[], store: ProcessorStore): Promise<string[]>;
+import type { ResultsStore } from "./internalTypes.js";
+/** Returns directories that are missing results or whose stored SHA is stale. */
+export declare function resolveStaleDirectories(staleDirsFromDiff: readonly string[], allFilePaths: readonly string[], tree: readonly TreeEntry[], store: ResultsStore): Promise<string[]>;
 //# sourceMappingURL=resolveDirectories.d.ts.map

package/dist/resolveDirectories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveDirectories.d.ts","sourceRoot":"","sources":["../src/resolveDirectories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,IAAI,EAAE,SAAS,SAAS,EAAE,EAC1B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAyCnB"}
+{"version":3,"file":"resolveDirectories.d.ts","sourceRoot":"","sources":["../src/resolveDirectories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,iFAAiF;AACjF,wBAAsB,uBAAuB,CAC3C,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,IAAI,EAAE,SAAS,SAAS,EAAE,EAC1B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB"}

package/dist/resolveDirectories.js

@@ -1,50 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveStaleDirectories = resolveStaleDirectories;
-/**
- * Find all directories that need (re-)processing.
- *
- * Combines two sources:
- * 1. Stale dirs from diffTree (directories with changed/removed children)
- * 2. Any directory whose stored SHA is missing or differs from the current tree SHA
- *
- * The second source handles recovery after partial failures and catches
- * directories whose tree SHA changed without any processable file changes.
- */
-async function resolveStaleDirectories(owner, repo, staleDirsFromDiff, allFilePaths, tree, store) {
-    // Build map of directory path → current tree SHA
+/** Returns directories that are missing results or whose stored SHA is stale. */
+async function resolveStaleDirectories(staleDirsFromDiff, allFilePaths, tree, store) {
     const treeShaByDir = new Map();
     for (const entry of tree) {
         if (entry.type === "tree") {
             treeShaByDir.set(entry.path, entry.sha);
         }
     }
-    // Collect all directories that should be processed (derived from file paths + root)
     const allExpectedDirs = new Set();
     for (const filePath of allFilePaths) {
         const parts = filePath.split("/");
-        for (let i = 1; i < parts.length; i++) {
-            allExpectedDirs.add(parts.slice(0, i).join("/"));
+        for (let index = 1; index < parts.length; index++) {
+            allExpectedDirs.add(parts.slice(0, index).join("/"));
         }
     }
-    // Always include root
     allExpectedDirs.add("");
-    // Start with stale dirs from diff
     const needed = new Set(staleDirsFromDiff);
-    // Check every expected directory for a missing or stale stored SHA
     for (const dirPath of allExpectedDirs) {
         if (needed.has(dirPath)) {
             continue;
         }
-        const storedSha = await store.getDirSha(owner, repo, dirPath);
+        const storedSha = await store.getDirSha(dirPath);
         if (storedSha === null) {
             needed.add(dirPath);
+            continue;
         }
-        else {
-            const currentSha = treeShaByDir.get(dirPath) ?? "";
-            if (storedSha !== currentSha) {
-                needed.add(dirPath);
-            }
+        const currentSha = treeShaByDir.get(dirPath) ?? "";
+        if (storedSha !== currentSha) {
+            needed.add(dirPath);
         }
     }
     return [...needed];

package/dist/resolveDirectories.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveDirectories.js","sourceRoot":"","sources":["../src/resolveDirectories.ts"],"names":[],"mappings":";;AAcA,0DAgDC;AA1DD;;;;;;;;;GASG;AACI,KAAK,UAAU,uBAAuB,CAC3C,KAAa,EACb,IAAY,EACZ,iBAAoC,EACpC,YAA+B,EAC/B,IAA0B,EAC1B,KAAqB;IAErB,iDAAiD;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,sBAAsB;IACtB,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAExB,kCAAkC;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE1C,mEAAmE;IACnE,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC"}
+{"version":3,"file":"resolveDirectories.js","sourceRoot":"","sources":["../src/resolveDirectories.ts"],"names":[],"mappings":";;AAKA,0DAyCC;AA1CD,iFAAiF;AAC1E,KAAK,UAAU,uBAAuB,CAC3C,iBAAoC,EACpC,YAA+B,EAC/B,IAA0B,EAC1B,KAAmB;IAEnB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC"}

package/dist/types.d.ts

@@ -1,66 +1,76 @@
-import type { FileManifest, TreeEntry } from "@hardlydifficult/github";
-export type { TreeEntry, FileManifest };
-/** Manifest of previously processed file SHAs (path → blob SHA). */
-export type { FileManifest as ProcessorFileManifest };
-/** Consumer-implemented persistence layer. */
-export interface ProcessorStore {
-    /** One-time init (e.g. ensure local clone). Optional. */
-    ensureReady?(owner: string, repo: string): Promise<void>;
-    /** Return manifest of previously processed file SHAs (path → blob SHA). */
-    getFileManifest(owner: string, repo: string): Promise<FileManifest>;
-    /** Return stored SHA for a directory. Null if not stored. */
-    getDirSha(owner: string, repo: string, dirPath: string): Promise<string | null>;
-    /** Persist result for a processed file. */
-    writeFileResult(owner: string, repo: string, path: string, sha: string, result: unknown): Promise<void>;
-    /** Persist result for a processed directory. */
-    writeDirResult(owner: string, repo: string, path: string, sha: string, result: unknown): Promise<void>;
-    /** Delete stored result for a removed file. */
-    deleteFileResult(owner: string, repo: string, path: string): Promise<void>;
-    /** Commit current batch of changes. */
-    commitBatch(owner: string, repo: string, count: number): Promise<void>;
+import type { StateTrackerEvent } from "@hardlydifficult/state-tracker";
+export interface GitIdentity {
+    name: string;
+    email: string;
 }
-/** Context passed to processFile callback. */
-export interface FileContext {
-    readonly entry: TreeEntry;
-    readonly content: string;
+export interface RepoFileFilterInput {
+    path: string;
+    sha: string;
+    size?: number;
 }
-/** An immediate child of a directory being processed. */
-export interface DirectoryChild {
-    readonly name: string;
-    readonly isDir: boolean;
-    readonly fullPath: string;
+export interface RepoFileInput {
+    repo: string;
+    path: string;
+    sha: string;
+    content: string;
 }
-/** Context passed to processDirectory callback. */
-export interface DirectoryContext {
-    readonly path: string;
-    readonly sha: string;
-    readonly subtreeFilePaths: readonly string[];
-    readonly children: readonly DirectoryChild[];
-    readonly tree: readonly TreeEntry[];
+export interface RepoDirectoryChild {
+    name: string;
+    path: string;
+    type: "file" | "directory";
 }
-/** Consumer-provided domain logic. */
-export interface ProcessorCallbacks {
-    /** Filter: which tree entries should be processed? */
-    shouldProcess(entry: TreeEntry): boolean;
-    /** Process a single changed file. Return value passed to store.writeFileResult. */
-    processFile(ctx: FileContext): Promise<unknown>;
-    /** Process a directory after all children. Return value passed to store.writeDirResult. */
-    processDirectory(ctx: DirectoryContext): Promise<unknown>;
+export interface RepoDirectoryInput {
+    repo: string;
+    path: string;
+    sha: string;
+    files: readonly string[];
+    children: readonly RepoDirectoryChild[];
 }
-/** Progress reported during a run. */
-export interface ProcessingProgress {
+export interface RepoProcessorResultsConfig {
+    repo: string;
+    directory: string;
+    root?: string;
+    branch?: string;
+    gitUser?: GitIdentity;
+}
+export interface RepoProcessorOptions<TFileResult, TDirResult = never> {
+    repo: string;
+    githubToken?: string;
+    ref?: string;
+    concurrency?: number;
+    results: RepoProcessorResultsConfig;
+    include?: (file: RepoFileFilterInput) => boolean;
+    processFile(file: RepoFileInput): Promise<TFileResult>;
+    processDirectory?: (directory: RepoDirectoryInput) => Promise<TDirResult>;
+}
+export interface RepoProcessorProgressCounts {
+    total: number;
+    completed: number;
+}
+export interface RepoProcessorProgress {
     phase: "loading" | "files" | "directories" | "committing";
     message: string;
-    filesTotal: number;
-    filesCompleted: number;
-    dirsTotal: number;
-    dirsCompleted: number;
+    files: RepoProcessorProgressCounts;
+    directories: RepoProcessorProgressCounts;
+}
+export type RepoProcessorProgressCallback = (progress: RepoProcessorProgress) => void;
+export interface RepoProcessorRunOptions {
+    onProgress?: RepoProcessorProgressCallback;
+}
+export interface RepoProcessorRunResult {
+    repo: string;
+    sourceSha: string;
+    processedFiles: number;
+    removedFiles: number;
+    processedDirectories: number;
 }
-export type ProgressCallback = (progress: ProcessingProgress) => void;
-/** Result returned by RepoProcessor.run(). */
-export interface ProcessingResult {
-    filesProcessed: number;
-    filesRemoved: number;
-    dirsProcessed: number;
+export interface RepoWatcherOptions {
+    stateDirectory?: string;
+    stateKey?: string;
+    autoSaveMs?: number;
+    maxAttempts?: number;
+    onComplete?: (result: RepoProcessorRunResult, sha: string) => void;
+    onError?: (error: unknown) => void;
+    onEvent?: (event: StateTrackerEvent) => void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}