@ff-labs/fff-bun 0.5.3-nightly.ed4c608 → 0.6.0

package/examples/grep.ts

@@ -111,7 +111,6 @@ async function main() {
   console.log(`${DIM}Initializing index for: ${directory}${RESET}`);
   const createResult = FileFinder.create({
     basePath: directory,
-    warmupMmapCache: true,
   });
 
   if (!createResult.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ff-labs/fff-bun",
-  "version": "0.5.3-nightly.ed4c608",
+  "version": "0.6.0",
   "private": false,
   "description": "High-performance fuzzy file finder for Bun - perfect for LLM agent tools",
   "type": "module",
@@ -62,14 +62,14 @@
   },
   "homepage": "https://github.com/dmtrKovalenko/fff.nvim#readme",
   "optionalDependencies": {
-    "@ff-labs/fff-bin-darwin-arm64": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-darwin-x64": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-linux-x64-gnu": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-linux-arm64-gnu": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-linux-x64-musl": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-linux-arm64-musl": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-win32-x64": "0.5.3-nightly.ed4c608",
-    "@ff-labs/fff-bin-win32-arm64": "0.5.3-nightly.ed4c608"
+    "@ff-labs/fff-bin-darwin-arm64": "0.6.0",
+    "@ff-labs/fff-bin-darwin-x64": "0.6.0",
+    "@ff-labs/fff-bin-linux-x64-gnu": "0.6.0",
+    "@ff-labs/fff-bin-linux-arm64-gnu": "0.6.0",
+    "@ff-labs/fff-bin-linux-x64-musl": "0.6.0",
+    "@ff-labs/fff-bin-linux-arm64-musl": "0.6.0",
+    "@ff-labs/fff-bin-win32-x64": "0.6.0",
+    "@ff-labs/fff-bin-win32-arm64": "0.6.0"
   },
   "devDependencies": {
     "@types/bun": "^1.3.8",

package/src/ffi.ts

@@ -50,7 +50,9 @@ const ffiDefinition = {
       FFIType.cstring, // frecency_db_path
       FFIType.cstring, // history_db_path
       FFIType.bool, // use_unsafe_no_lock
-      FFIType.bool, // warmup_mmap_cache
+      FFIType.bool, // enable_mmap_cache
+      FFIType.bool, // enable_content_indexing
+      FFIType.bool, // watch
       FFIType.bool, // ai_mode
     ],
     returns: FFIType.ptr,
@@ -419,7 +421,9 @@ export function ffiCreate(
   frecencyDbPath: string,
   historyDbPath: string,
   useUnsafeNoLock: boolean,
-  warmupMmapCache: boolean,
+  enableMmapCache: boolean,
+  enableContentIndexing: boolean,
+  watch: boolean,
   aiMode: boolean,
 ): Result<NativeHandle> {
   const library = loadLibrary();
@@ -428,7 +432,9 @@ export function ffiCreate(
     ptr(encodeString(frecencyDbPath)),
     ptr(encodeString(historyDbPath)),
     useUnsafeNoLock,
-    warmupMmapCache,
+    enableMmapCache,
+    enableContentIndexing,
+    watch,
     aiMode,
   );
 

package/src/finder.ts

@@ -38,7 +38,7 @@ import type {
   GrepOptions,
   GrepResult,
   HealthCheck,
-  InitOptions,
+  InitOptions as FFFInitOptions,
   MixedSearchResult,
   MultiGrepOptions,
   Result,
@@ -107,13 +107,15 @@ export class FileFinder {
    * });
    * ```
    */
-  static create(options: InitOptions): Result<FileFinder> {
+  static create(options: FFFInitOptions): Result<FileFinder> {
     const result = ffiCreate(
       options.basePath,
       options.frecencyDbPath ?? "",
       options.historyDbPath ?? "",
       options.useUnsafeNoLock ?? false,
-      options.warmupMmapCache ?? false,
+      !(options.disableMmapCache ?? false),
+      !(options.disableContentIndexing ?? options.disableMmapCache ?? false),
+      !(options.disableWatch ?? false),
       options.aiMode ?? false,
     );
 

package/src/types.ts

@@ -30,12 +30,24 @@ export interface InitOptions {
   /** Use unsafe no-lock mode for databases (optional, defaults to false) */
   useUnsafeNoLock?: boolean;
   /**
-   * Pre-populate mmap caches for all files after the initial scan completes.
-   * When enabled, the first grep search will be as fast as subsequent ones
-   * at the cost of a longer scan time and higher initial memory usage.
+   * Disable mmap cache warmup after the initial scan. When mmap cache is
+   * enabled (the default), the first grep search is as fast as subsequent
+   * ones at the cost of background resources spent on awarming up the cache
+   */
+  disableMmapCache?: boolean;
+  /**
+   * Disable the content index built after the initial scan.
+   * Content indexing enables faster content-aware filtering during grep.
+   * When omitted, follows `disableMmapCache` for backward compatibility.
+   * (default: follows `disableMmapCache`)
+   */
+  disableContentIndexing?: boolean;
+  /**
+   * Disable the background file-system watcher. When the watcher is
+   * disabled, files are scanned once but not monitored for changes.
    * (default: false)
    */
-  warmupMmapCache?: boolean;
+  disableWatch?: boolean;
   /** enables optimizations for AI agent assistants. Provide as true if running via mcp/agent */
   aiMode?: boolean;
 }