@forwardimpact/libutil 0.1.63 → 0.1.64

package/finder.js

@@ -47,6 +47,25 @@ export class Finder {
     return null;
   }
 
+  /**
+   * Resolve a data directory by upward traversal, with HOME fallback.
+   * @param {string} baseName - Directory name to find (e.g. "data")
+   * @param {string} homeDir - User home directory path
+   * @returns {string} Absolute path to found directory
+   */
+  findData(baseName, homeDir) {
+    const cwd = this.#process.cwd();
+    const found = this.findUpward(cwd, baseName);
+    if (found) return found;
+
+    const homePath = path.join(homeDir, ".fit", baseName);
+    if (fs.existsSync(homePath)) return homePath;
+
+    throw new Error(
+      `No ${baseName} directory found from ${cwd} or ${homePath}.`,
+    );
+  }
+
   /**
    * Find the project root directory
    * @param {string} startPath - Starting directory path

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libutil",
-  "version": "0.1.63",
+  "version": "0.1.64",
   "description": "Utility functions and utilities for Guide",
   "license": "Apache-2.0",
   "author": "D. Olsson <hi@senzilla.io>",

package/test/finder.test.js

@@ -257,6 +257,79 @@ describe("Finder", () => {
     });
   });
 
+  describe("findData", () => {
+    test("finds data/ in CWD via findUpward", () => {
+      const dataDir = path.join(tempDir, "data");
+      fs.mkdirSync(dataDir);
+
+      const cwdFinder = new Finder(fsPromises, mockLogger, {
+        cwd: () => tempDir,
+      });
+      const result = cwdFinder.findData("data", "/nonexistent-home");
+
+      assert.strictEqual(result, dataDir);
+    });
+
+    test("finds data/ in a parent directory via findUpward", () => {
+      const dataDir = path.join(tempDir, "data");
+      fs.mkdirSync(dataDir);
+      const subDir = path.join(tempDir, "products", "pathway");
+      fs.mkdirSync(subDir, { recursive: true });
+
+      const cwdFinder = new Finder(fsPromises, mockLogger, {
+        cwd: () => subDir,
+      });
+      const result = cwdFinder.findData("data", "/nonexistent-home");
+
+      assert.strictEqual(result, dataDir);
+    });
+
+    test("falls back to ~/.fit/data/ when CWD traversal fails", () => {
+      const fakeHome = path.join(tempDir, "fakehome");
+      const homeFitData = path.join(fakeHome, ".fit", "data");
+      fs.mkdirSync(homeFitData, { recursive: true });
+
+      const isolatedDir = path.join(tempDir, "isolated");
+      fs.mkdirSync(isolatedDir);
+
+      const cwdFinder = new Finder(fsPromises, mockLogger, {
+        cwd: () => isolatedDir,
+      });
+      const result = cwdFinder.findData("data", fakeHome);
+
+      assert.strictEqual(result, homeFitData);
+    });
+
+    test("throws when neither CWD traversal nor HOME fallback finds directory", () => {
+      const isolatedDir = path.join(tempDir, "isolated");
+      fs.mkdirSync(isolatedDir);
+
+      const cwdFinder = new Finder(fsPromises, mockLogger, {
+        cwd: () => isolatedDir,
+      });
+
+      assert.throws(() => cwdFinder.findData("data", "/nonexistent-home"), {
+        message: /No data directory found/,
+      });
+    });
+
+    test("CWD takes priority over HOME when both exist", () => {
+      const cwdData = path.join(tempDir, "data");
+      fs.mkdirSync(cwdData);
+
+      const fakeHome = path.join(tempDir, "fakehome");
+      const homeFitData = path.join(fakeHome, ".fit", "data");
+      fs.mkdirSync(homeFitData, { recursive: true });
+
+      const cwdFinder = new Finder(fsPromises, mockLogger, {
+        cwd: () => tempDir,
+      });
+      const result = cwdFinder.findData("data", fakeHome);
+
+      assert.strictEqual(result, cwdData);
+    });
+  });
+
   describe("findPackagePath", () => {
     test("finds package in local monorepo structure", () => {
       // Create mock monorepo structure