@forwardimpact/libutil 0.1.62 → 0.1.64

package/bin/fit-tiktoken.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { countTokens } from "@forwardimpact/libutil";
+
+/**
+ * Counts tokens in the provided text
+ * Usage: fit-tiktoken <text>
+ *        echo "text" | fit-tiktoken
+ * @returns {Promise<void>}
+ */
+async function main() {
+  let text = process.argv.slice(2).join(" ");
+
+  if (!text && !process.stdin.isTTY) {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+    text = Buffer.concat(chunks).toString().trim();
+  }
+
+  if (!text) {
+    console.error("Usage: fit-tiktoken <text>");
+    console.error('       echo "text" | fit-tiktoken');
+    process.exit(1);
+  }
+
+  console.log(countTokens(text));
+}
+
+main().catch((error) => {
+  console.error(error.message);
+  process.exit(1);
+});

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,13 +1,14 @@
 {
   "name": "@forwardimpact/libutil",
-  "version": "0.1.62",
+  "version": "0.1.64",
   "description": "Utility functions and utilities for Guide",
   "license": "Apache-2.0",
   "author": "D. Olsson <hi@senzilla.io>",
   "type": "module",
   "main": "index.js",
   "bin": {
-    "fit-download-bundle": "./bin/fit-download-bundle.js"
+    "fit-download-bundle": "./bin/fit-download-bundle.js",
+    "fit-tiktoken": "./bin/fit-tiktoken.js"
   },
   "engines": {
     "node": ">=22.0.0"

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