@ff-labs/fff-bun 0.1.0-nightly.fcdf4a9 → 0.2.4-dev.233679d

package/README.md

@@ -16,20 +16,20 @@ High-performance fuzzy file finder for Bun, powered by Rust. Perfect for LLM age
 bun add @ff-labs/bun
 ```
 
-The correct native binary for your platform is installed automatically via platform-specific packages (e.g. `@ff-labs/fff-bun-darwin-arm64`, `@ff-labs/fff-bun-linux-x64-gnu`). No GitHub downloads are needed.
+The correct native binary for your platform is installed automatically via platform-specific packages (e.g. `@ff-labs/fff-bin-darwin-arm64`, `@ff-labs/fff-bin-linux-x64-gnu`). No GitHub downloads are needed.
 
 ### Supported Platforms
 
 | Platform | Architecture | Package |
 |----------|-------------|---------|
-| macOS | ARM64 (Apple Silicon) | `@ff-labs/fff-bun-darwin-arm64` |
-| macOS | x64 (Intel) | `@ff-labs/fff-bun-darwin-x64` |
-| Linux | x64 (glibc) | `@ff-labs/fff-bun-linux-x64-gnu` |
-| Linux | ARM64 (glibc) | `@ff-labs/fff-bun-linux-arm64-gnu` |
-| Linux | x64 (musl) | `@ff-labs/fff-bun-linux-x64-musl` |
-| Linux | ARM64 (musl) | `@ff-labs/fff-bun-linux-arm64-musl` |
-| Windows | x64 | `@ff-labs/fff-bun-win32-x64` |
-| Windows | ARM64 | `@ff-labs/fff-bun-win32-arm64` |
+| macOS | ARM64 (Apple Silicon) | `@ff-labs/fff-bin-darwin-arm64` |
+| macOS | x64 (Intel) | `@ff-labs/fff-bin-darwin-x64` |
+| Linux | x64 (glibc) | `@ff-labs/fff-bin-linux-x64-gnu` |
+| Linux | ARM64 (glibc) | `@ff-labs/fff-bin-linux-arm64-gnu` |
+| Linux | x64 (musl) | `@ff-labs/fff-bin-linux-x64-musl` |
+| Linux | ARM64 (musl) | `@ff-labs/fff-bin-linux-arm64-musl` |
+| Windows | x64 | `@ff-labs/fff-bin-win32-x64` |
+| Windows | ARM64 | `@ff-labs/fff-bin-win32-arm64` |
 
 If the platform package isn't available, the postinstall script will attempt to download from GitHub releases as a fallback.
 
@@ -113,7 +113,7 @@ Track file access for frecency scoring.
 FileFinder.trackAccess("/path/to/file.ts");
 ```
 
-### `FileFinder.liveGrep(query, options?)`
+### `FileFinder.grep(query, options?)`
 
 Search file contents with SIMD-accelerated matching.
 
@@ -129,7 +129,7 @@ interface GrepOptions {
 }
 
 // Plain text search
-const result = FileFinder.liveGrep("TODO", { pageLimit: 20 });
+const result = FileFinder.grep("TODO", { pageLimit: 20 });
 if (result.ok) {
   for (const match of result.value.items) {
     console.log(`${match.relativePath}:${match.lineNumber}: ${match.lineContent}`);
@@ -137,22 +137,22 @@ if (result.ok) {
 }
 
 // Regex search
-const regexResult = FileFinder.liveGrep("fn\\s+\\w+", { mode: "regex" });
+const regexResult = FileFinder.grep("fn\\s+\\w+", { mode: "regex" });
 
 // Fuzzy search
-const fuzzyResult = FileFinder.liveGrep("imprt recat", { mode: "fuzzy" });
+const fuzzyResult = FileFinder.grep("imprt recat", { mode: "fuzzy" });
 
 // Pagination
-const page1 = FileFinder.liveGrep("error");
+const page1 = FileFinder.grep("error");
 if (page1.ok && page1.value.nextCursor) {
-  const page2 = FileFinder.liveGrep("error", {
+  const page2 = FileFinder.grep("error", {
     cursor: page1.value.nextCursor,
   });
 }
 
 // With file constraints
-const tsOnly = FileFinder.liveGrep("*.ts useState");
-const srcOnly = FileFinder.liveGrep("src/ handleClick");
+const tsOnly = FileFinder.grep("*.ts useState");
+const srcOnly = FileFinder.grep("src/ handleClick");
 ```
 
 ### `FileFinder.trackQuery(query, selectedFile)`
@@ -178,7 +178,7 @@ if (health.ok) {
 
 ### Other Methods
 
-- `FileFinder.liveGrep(query, options?)` - Search file contents
+- `FileFinder.grep(query, options?)` - Search file contents
 - `FileFinder.scanFiles()` - Trigger rescan
 - `FileFinder.isScanning()` - Check scan status
 - `FileFinder.getScanProgress()` - Get scan progress

package/examples/grep.ts

@@ -190,7 +190,7 @@ async function main() {
       }
 
       const searchStart = Date.now();
-      const result = finder.liveGrep(query, {
+      const result = finder.grep(query, {
         mode: currentMode,
         pageLimit: 30,
         timeBudgetMs: 5000,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ff-labs/fff-bun",
-  "version": "0.1.0-nightly.fcdf4a9",
+  "version": "0.2.4-dev.233679d",
   "private": false,
   "description": "High-performance fuzzy file finder for Bun - perfect for LLM agent tools",
   "type": "module",
@@ -13,19 +13,14 @@
     }
   },
   "bin": {
-    "fff": "./scripts/cli.ts",
     "fff-demo": "./examples/search.ts",
     "fff-grep": "./examples/grep.ts"
   },
   "files": [
     "src",
-    "bin",
-    "scripts",
     "examples"
   ],
   "scripts": {
-    "postinstall": "bun ./scripts/postinstall.ts",
-    "download": "bun ./scripts/cli.ts download",
     "test": "bun test src/",
     "typecheck": "tsc --noEmit",
     "demo": "bun ./examples/search.ts"
@@ -67,14 +62,14 @@
   },
   "homepage": "https://github.com/dmtrKovalenko/fff.nvim#readme",
   "optionalDependencies": {
-    "@ff-labs/fff-bun-darwin-arm64": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-darwin-x64": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-linux-x64-gnu": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-linux-arm64-gnu": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-linux-x64-musl": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-linux-arm64-musl": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-win32-x64": "0.1.0-nightly.fcdf4a9",
-    "@ff-labs/fff-bun-win32-arm64": "0.1.0-nightly.fcdf4a9"
+    "@ff-labs/fff-bin-darwin-arm64": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-darwin-x64": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-linux-x64-gnu": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-linux-arm64-gnu": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-linux-x64-musl": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-linux-arm64-musl": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-win32-x64": "0.2.4-dev.233679d",
+    "@ff-labs/fff-bin-win32-arm64": "0.2.4-dev.233679d"
   },
   "devDependencies": {
     "@types/bun": "^1.3.8",

package/src/download.ts

@@ -1,25 +1,16 @@
 /**
  * Binary resolution utilities for fff
  *
- * Resolves the native binary from:
- * 1. Platform-specific npm package (e.g. @ff-labs/fff-bun-darwin-arm64) - primary
- * 2. Local bin/ directory (legacy or manual download)
- * 3. Local dev build (target/release or target/debug)
- * 4. GitHub releases (fallback, requires network)
+ * Resolves the native library from:
+ * 1. Platform-specific npm package (e.g. @ff-labs/fff-bin-darwin-arm64)
+ * 2. Local dev build (target/release or target/debug)
  */
 
-import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import {
-  getLibExtension,
-  getLibFilename,
-  getNpmPackageName,
-  getTriple,
-} from "./platform";
-
-const GITHUB_REPO = "dmtrKovalenko/fff.nvim";
+import { getLibFilename, getNpmPackageName } from "./platform";
 
 /**
  * Get the current file's directory
@@ -47,21 +38,6 @@ function getPackageDir(): string {
   return dirname(currentDir);
 }
 
-/**
- * Get the directory where binaries are stored (legacy/fallback)
- */
-export function getBinDir(): string {
-  return join(getPackageDir(), "bin");
-}
-
-/**
- * Get the full path to the native library in bin/ (legacy/fallback)
- */
-export function getBinaryPath(): string {
-  const binDir = getBinDir();
-  return join(binDir, getLibFilename());
-}
-
 /**
  * Check if the binary exists in any known location
  */
@@ -72,8 +48,8 @@ export function binaryExists(): boolean {
 /**
  * Try to resolve the binary from the platform-specific npm package.
  *
- * When users install @ff-labs/bun, npm/bun automatically installs the matching
- * optionalDependency (e.g. @ff-labs/fff-bun-darwin-arm64). We resolve the binary
+ * When users install @ff-labs/fff-bun, npm/bun automatically installs the matching
+ * optionalDependency (e.g. @ff-labs/fff-bin-darwin-arm64). We resolve the binary
  * path by requiring that package's package.json and looking for the binary
  * in the same directory.
  */
@@ -101,7 +77,7 @@ function resolveFromNpmPackage(): string | null {
 /**
  * Get the development binary path (for local development)
  */
-export function getDevBinaryPath(): string | null {
+function getDevBinaryPath(): string | null {
   const packageDir = getPackageDir();
   const workspaceRoot = join(packageDir, "..", "..");
 
@@ -125,11 +101,20 @@ function isDevWorkspace(): boolean {
   return existsSync(join(workspaceRoot, "Cargo.toml"));
 }
 
+/**
+ * Find the native library binary.
+ *
+ * Resolution order:
+ * - Dev workspace: local dev build first, then npm package
+ * - Production: npm package first, then dev build
+ *
+ * @returns Absolute path to the library, or null if not found
+ */
 export function findBinary(): string | null {
   if (isDevWorkspace()) {
     // 1. Local bin/ directory (populated by `make prepare-bun`)
-    const installedPath = getBinaryPath();
-    if (existsSync(installedPath)) return installedPath;
+    const binPath = join(getPackageDir(), "bin", getLibFilename());
+    if (existsSync(binPath)) return binPath;
 
     // 2. Local dev build (target/release or target/debug)
     const devPath = getDevBinaryPath();
@@ -143,117 +128,9 @@ export function findBinary(): string | null {
   }
 
   // Production: npm package first
-  // 1. Try platform-specific npm package first
   const npmPath = resolveFromNpmPackage();
   if (npmPath) return npmPath;
 
-  // 2. Try local bin/ directory (legacy or manual download)
-  const installedPath = getBinaryPath();
-  if (existsSync(installedPath)) return installedPath;
-
-  // 3. Try local dev build
+  // Fallback: local dev build (e.g. user built from source)
   return getDevBinaryPath();
 }
-
-/**
- * Download the binary from GitHub releases as a fallback.
- * This is only used when the platform npm package is not available.
- *
- * @param tag - The release tag to download (e.g. commit hash), or "latest"
- */
-export async function downloadBinary(tag?: string): Promise<string> {
-  const resolvedTag = tag || "latest";
-  const triple = getTriple();
-  const ext = getLibExtension();
-
-  // Resolve "latest" tag via GitHub API
-  let releaseTag = resolvedTag;
-  if (releaseTag === "latest") {
-    console.log("fff: Fetching latest release tag from GitHub...");
-    releaseTag = await fetchLatestReleaseTag();
-  }
-
-  const binaryName = `c-lib-${triple}.${ext}`;
-  const baseUrl = `https://github.com/${GITHUB_REPO}/releases/download/${releaseTag}`;
-  const binaryUrl = `${baseUrl}/${binaryName}`;
-
-  console.log(`fff: Downloading native library for ${triple}...`);
-  console.log(`fff: Release: ${releaseTag}`);
-
-  const binaryResponse = await fetch(binaryUrl);
-  if (!binaryResponse.ok) {
-    throw new Error(
-      `Failed to download binary: ${binaryResponse.status} ${binaryResponse.statusText}\nURL: ${binaryUrl}`,
-    );
-  }
-
-  const binaryBuffer = Buffer.from(await binaryResponse.arrayBuffer());
-
-  const binDir = getBinDir();
-  if (!existsSync(binDir)) {
-    mkdirSync(binDir, { recursive: true });
-  }
-
-  const binaryPath = getBinaryPath();
-  writeFileSync(binaryPath, binaryBuffer);
-
-  // Make executable on Unix
-  if (process.platform !== "win32") {
-    chmodSync(binaryPath, 0o755);
-  }
-
-  console.log(`fff: Binary downloaded to ${binaryPath}`);
-  return releaseTag;
-}
-
-/**
- * Fetch the latest release tag from GitHub
- */
-async function fetchLatestReleaseTag(): Promise<string> {
-  const url = `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`;
-
-  const response = await fetch(url, {
-    headers: {
-      Accept: "application/vnd.github.v3+json",
-      "User-Agent": "fff-bun-client",
-    },
-  });
-
-  if (!response.ok) {
-    const allReleasesUrl = `https://api.github.com/repos/${GITHUB_REPO}/releases`;
-    const allResponse = await fetch(allReleasesUrl, {
-      headers: {
-        Accept: "application/vnd.github.v3+json",
-        "User-Agent": "fff-bun-client",
-      },
-    });
-
-    if (!allResponse.ok) {
-      throw new Error(`Failed to fetch releases: ${allResponse.status}`);
-    }
-
-    const releases = (await allResponse.json()) as Array<{ tag_name: string }>;
-    if (releases.length === 0) {
-      throw new Error("No releases found");
-    }
-
-    return releases[0].tag_name;
-  }
-
-  const release = (await response.json()) as { tag_name: string };
-  return release.tag_name;
-}
-
-/**
- * Ensure the binary exists, downloading from GitHub if necessary.
- */
-export async function ensureBinary(): Promise<string> {
-  const existingPath = findBinary();
-  if (existingPath) {
-    return existingPath;
-  }
-
-  // Fallback: download from GitHub
-  await downloadBinary();
-  return getBinaryPath();
-}