@edxeth/fff-node 0.7.2-edxeth.0

package/dist/src/platform.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,462 @@
+/**
+ * Result type for all operations - follows the Result pattern
+ */
+export type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Helper to create a successful result
+ */
+export declare function ok<T>(value: T): Result<T>;
+/**
+ * Helper to create an error result
+ */
+export declare function err<T>(error: string): Result<T>;
+/**
+ * Initialization options for the file finder
+ */
+export interface InitOptions {
+    /** Base directory to index (required) */
+    basePath: string;
+    /** Path to frecency database (optional, omit to skip frecency initialization) */
+    frecencyDbPath?: string;
+    /** Path to query history database (optional, omit to skip query tracker initialization) */
+    historyDbPath?: string;
+    /** Use unsafe no-lock mode for databases (optional, defaults to false) */
+    useUnsafeNoLock?: boolean;
+    /**
+     * 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 a longer scan time and higher initial memory usage.
+     * (default: false)
+     */
+    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)
+     */
+    disableWatch?: boolean;
+    /** enables optimizations for AI agent assistants. Provide as true if running via mcp/agent */
+    aiMode?: boolean;
+    /**
+     * Path to the tracing log file. When set, the shared FFF tracing subscriber
+     * is installed on first init and file output is written here. Omit to leave
+     * logging uninitialized.
+     */
+    logFilePath?: string;
+    /**
+     * Log level for the tracing subscriber: "trace", "debug", "info", "warn",
+     * or "error". Defaults to "info". Ignored when `logFilePath` is not set.
+     */
+    logLevel?: "trace" | "debug" | "info" | "warn" | "error";
+    /**
+     * Override for the content cache file-count cap. When omitted, the picker
+     * auto-sizes the budget from the final scanned file count.
+     */
+    cacheBudgetMaxFiles?: number;
+    /** Override for the content cache byte cap. See `cacheBudgetMaxFiles`. */
+    cacheBudgetMaxBytes?: number;
+    /** Override for the per-file byte cap in the content cache. */
+    cacheBudgetMaxFileSize?: number;
+}
+/**
+ * Search options for fuzzy file search
+ */
+export interface SearchOptions {
+    /** Maximum threads for parallel search (0 = auto) */
+    maxThreads?: number;
+    /** Current file path (for deprioritization in results) */
+    currentFile?: string;
+    /** Combo boost score multiplier (default: 100) */
+    comboBoostMultiplier?: number;
+    /** Minimum combo count for boost (default: 3) */
+    minComboCount?: number;
+    /** Page index for pagination (default: 0) */
+    pageIndex?: number;
+    /** Page size for pagination (default: 100) */
+    pageSize?: number;
+}
+/**
+ * A file item in search results
+ */
+export interface FileItem {
+    /** Path relative to the indexed directory */
+    relativePath: string;
+    /** File name only */
+    fileName: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified timestamp (Unix seconds) */
+    modified: number;
+    /** Frecency score based on access patterns */
+    accessFrecencyScore: number;
+    /** Frecency score based on modification time */
+    modificationFrecencyScore: number;
+    /** Combined frecency score */
+    totalFrecencyScore: number;
+    /** Git status: 'clean', 'modified', 'untracked', 'staged_new', etc. */
+    gitStatus: string;
+}
+/**
+ * Score breakdown for a search result
+ */
+export interface Score {
+    /** Total combined score */
+    total: number;
+    /** Base fuzzy match score */
+    baseScore: number;
+    /** Bonus for filename match */
+    filenameBonus: number;
+    /** Bonus for special filenames (index.ts, main.rs, etc.) */
+    specialFilenameBonus: number;
+    /** Boost from frecency */
+    frecencyBoost: number;
+    /** Penalty for distance in path */
+    distancePenalty: number;
+    /** Penalty if this is the current file */
+    currentFilePenalty: number;
+    /** Boost from query history combo matching */
+    comboMatchBoost: number;
+    /** Whether this was an exact match */
+    exactMatch: boolean;
+    /** Type of match: 'fuzzy', 'exact', 'prefix', etc. */
+    matchType: string;
+}
+/**
+ * Location in file (from query like "file.ts:42")
+ */
+export type Location = {
+    type: "line";
+    line: number;
+} | {
+    type: "position";
+    line: number;
+    col: number;
+} | {
+    type: "range";
+    start: {
+        line: number;
+        col: number;
+    };
+    end: {
+        line: number;
+        col: number;
+    };
+};
+/**
+ * Search result from fuzzy file search
+ */
+export interface SearchResult {
+    /** Matched file items */
+    items: FileItem[];
+    /** Corresponding scores for each item */
+    scores: Score[];
+    /** Total number of files that matched */
+    totalMatched: number;
+    /** Total number of indexed files */
+    totalFiles: number;
+    /** Location parsed from query (e.g., "file.ts:42:10") */
+    location?: Location;
+}
+/**
+ * A directory item in search results
+ */
+export interface DirItem {
+    /** Path relative to the indexed directory (e.g., "src/components/") */
+    relativePath: string;
+    /** Last path segment (e.g., "components/" for "src/components/") */
+    dirName: string;
+    /** Maximum access frecency score among direct child files */
+    maxAccessFrecency: number;
+}
+/**
+ * Search options for directory search (subset of SearchOptions)
+ */
+export interface DirSearchOptions {
+    /** Maximum threads for parallel search (0 = auto) */
+    maxThreads?: number;
+    /** Current file path (for distance scoring) */
+    currentFile?: string;
+    /** Page index for pagination (default: 0) */
+    pageIndex?: number;
+    /** Page size for pagination (default: 100) */
+    pageSize?: number;
+}
+/**
+ * Search result from fuzzy directory search
+ */
+export interface DirSearchResult {
+    /** Matched directory items */
+    items: DirItem[];
+    /** Corresponding scores for each item */
+    scores: Score[];
+    /** Total number of directories that matched */
+    totalMatched: number;
+    /** Total number of indexed directories */
+    totalDirs: number;
+}
+/**
+ * A single item in a mixed (files + directories) search result
+ */
+export type MixedItem = {
+    type: "file";
+    item: FileItem;
+} | {
+    type: "directory";
+    item: DirItem;
+};
+/**
+ * Search result from mixed (files + directories) fuzzy search.
+ * Items are interleaved by total score in descending order.
+ */
+export interface MixedSearchResult {
+    /** Matched items (files and directories interleaved by score) */
+    items: MixedItem[];
+    /** Corresponding scores for each item */
+    scores: Score[];
+    /** Total number of items (files + dirs) that matched */
+    totalMatched: number;
+    /** Total number of indexed files */
+    totalFiles: number;
+    /** Total number of indexed directories */
+    totalDirs: number;
+    /** Location parsed from query */
+    location?: Location;
+}
+/**
+ * Scan progress information
+ */
+export interface ScanProgress {
+    /** Number of files scanned so far */
+    scannedFilesCount: number;
+    /** Whether a scan is currently in progress */
+    isScanning: boolean;
+}
+/**
+ * Database health information
+ */
+export interface DbHealth {
+    /** Path to the database */
+    path: string;
+    /** Size of the database on disk in bytes */
+    diskSize: number;
+}
+/**
+ * Health check result
+ */
+export interface HealthCheck {
+    /** Library version */
+    version: string;
+    /** Git integration status */
+    git: {
+        /** Whether git2 library is available */
+        available: boolean;
+        /** Whether a git repository was found */
+        repositoryFound: boolean;
+        /** Git working directory path */
+        workdir?: string;
+        /** libgit2 version string */
+        libgit2Version: string;
+        /** Error message if git detection failed */
+        error?: string;
+    };
+    /** File picker status */
+    filePicker: {
+        /** Whether the file picker is initialized */
+        initialized: boolean;
+        /** Base path being indexed */
+        basePath?: string;
+        /** Whether a scan is in progress */
+        isScanning?: boolean;
+        /** Number of indexed files */
+        indexedFiles?: number;
+        /** Error message if there's an issue */
+        error?: string;
+    };
+    /** Frecency database status */
+    frecency: {
+        /** Whether frecency tracking is initialized */
+        initialized: boolean;
+        /** Database health information */
+        dbHealthcheck?: DbHealth;
+        /** Error message if there's an issue */
+        error?: string;
+    };
+    /** Query tracker status */
+    queryTracker: {
+        /** Whether query tracking is initialized */
+        initialized: boolean;
+        /** Database health information */
+        dbHealthcheck?: DbHealth;
+        /** Error message if there's an issue */
+        error?: string;
+    };
+}
+/**
+ * Grep search mode
+ */
+export type GrepMode = "plain" | "regex" | "fuzzy";
+/**
+ * Opaque pagination cursor for grep results.
+ * Pass this to `GrepOptions.cursor` to fetch the next page.
+ * Do not construct or modify this — use the `nextCursor` from a previous `GrepResult`.
+ */
+export interface GrepCursor {
+    /** @internal */
+    readonly __brand: "GrepCursor";
+    /** @internal */
+    readonly _offset: number;
+}
+/**
+ * @internal Create a GrepCursor from a raw file offset.
+ */
+export declare function createGrepCursor(offset: number): GrepCursor;
+/**
+ * Options for live grep (content search)
+ *
+ * Files are searched sequentially in frecency order (most recently/frequently
+ * accessed first). The engine returns a `nextCursor` for fetching the next page.
+ */
+export interface GrepOptions {
+    /** Maximum file size to search in bytes. Files larger than this are skipped. (default: 10MB) */
+    maxFileSize?: number;
+    /** Maximum matching lines to collect from a single file (default: 200) */
+    maxMatchesPerFile?: number;
+    /** Smart case: case-insensitive when the query is all lowercase, case-sensitive otherwise (default: true) */
+    smartCase?: boolean;
+    /**
+     * Pagination cursor from a previous `GrepResult.nextCursor`.
+     * Omit (or pass `null`) for the first page.
+     */
+    cursor?: GrepCursor | null;
+    /** Search mode (default: "plain") */
+    mode?: GrepMode;
+    /**
+     * Maximum wall-clock time in milliseconds to spend searching before returning
+     * partial results. 0 = unlimited. (default: 0)
+     */
+    timeBudgetMs?: number;
+    /** Number of context lines to include before each match (default: 0) */
+    beforeContext?: number;
+    /** Number of context lines to include after each match (default: 0) */
+    afterContext?: number;
+    /**
+     * When true, classify each match line as a code definition (struct/fn/class/...)
+     * and expose it via `GrepMatch.isDefinition`. Let callers re-rank defs first
+     * without a TS-side regex port. (default: false)
+     */
+    classifyDefinitions?: boolean;
+}
+/**
+ * A single grep match with file and line information
+ */
+export interface GrepMatch {
+    /** Path relative to the indexed directory */
+    relativePath: string;
+    /** File name only */
+    fileName: string;
+    /** Git status */
+    gitStatus: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modified timestamp (Unix seconds) */
+    modified: number;
+    /** Whether the file is binary */
+    isBinary: boolean;
+    /** Combined frecency score */
+    totalFrecencyScore: number;
+    /** Access-based frecency score */
+    accessFrecencyScore: number;
+    /** Modification-based frecency score */
+    modificationFrecencyScore: number;
+    /** 1-based line number of the match */
+    lineNumber: number;
+    /** 0-based byte column of first match start */
+    col: number;
+    /** Absolute byte offset of the matched line from file start */
+    byteOffset: number;
+    /** The matched line text (may be truncated) */
+    lineContent: string;
+    /** Byte offset pairs [start, end] within lineContent for highlighting */
+    matchRanges: [number, number][];
+    /** Fuzzy match score (only in fuzzy mode) */
+    fuzzyScore?: number;
+    /** Lines before the match (context). Empty array when context is 0. */
+    contextBefore?: string[];
+    /** Lines after the match (context). Empty array when context is 0. */
+    contextAfter?: string[];
+    /** Whether this line is a code definition (only populated when `classifyDefinitions: true`). */
+    isDefinition?: boolean;
+}
+/**
+ * Result from a grep search
+ */
+export interface GrepResult {
+    /** Matched items with file and line information. At most `max_matches_per_file`. */
+    items: GrepMatch[];
+    /** Total number of matches collected (always equal to items.length). */
+    totalMatched: number;
+    /** Number of files actually opened and searched in this call */
+    totalFilesSearched: number;
+    /** Total number of indexed files (before any filtering) */
+    totalFiles: number;
+    /** Number of files eligible for search after filtering out binary files, oversized files, and constraint mismatches */
+    filteredFileCount: number;
+    /**
+     * Cursor for the next page, or `null` if all eligible files have been searched.
+     * Pass this as `GrepOptions.cursor` to continue from where this call left off.
+     */
+    nextCursor: GrepCursor | null;
+    /** When regex mode fails to compile the pattern, the engine falls back to literal matching and this field contains the compilation error */
+    regexFallbackError?: string;
+}
+/**
+ * Options for multi-pattern grep (Aho-Corasick multi-needle search)
+ *
+ * Searches for lines matching ANY of the provided patterns using
+ * SIMD-accelerated Aho-Corasick multi-pattern matching.
+ */
+export interface MultiGrepOptions {
+    /** Patterns to search for (OR logic — matches lines containing any pattern) */
+    patterns: string[];
+    /** File constraints like "*.rs" or "/src/" */
+    constraints?: string;
+    /** Maximum file size to search in bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Maximum matching lines to collect from a single file (default: 0 = unlimited) */
+    maxMatchesPerFile?: number;
+    /** Smart case: case-insensitive when all patterns are lowercase (default: true) */
+    smartCase?: boolean;
+    /**
+     * Pagination cursor from a previous `GrepResult.nextCursor`.
+     * Omit (or pass `null`) for the first page.
+     */
+    cursor?: GrepCursor | null;
+    /**
+     * Maximum wall-clock time in milliseconds to spend searching before returning
+     * partial results. 0 = unlimited. (default: 0)
+     */
+    timeBudgetMs?: number;
+    /** Number of context lines to include before each match (default: 0) */
+    beforeContext?: number;
+    /** Number of context lines to include after each match (default: 0) */
+    afterContext?: number;
+    /**
+     * When true, classify each match line as a code definition (struct/fn/class/...)
+     * and expose it via `GrepMatch.isDefinition`. (default: false)
+     */
+    classifyDefinitions?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,19 @@
+/**
+ * Helper to create a successful result
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Helper to create an error result
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+/**
+ * @internal Create a GrepCursor from a raw file offset.
+ */
+export function createGrepCursor(offset) {
+    return { __brand: "GrepCursor", _offset: offset };
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAa;IAClC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAmTD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,EAAE,OAAO,EAAE,YAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@edxeth/fff-node",
+  "version": "0.7.2-edxeth.0",
+  "private": false,
+  "description": "High-performance fuzzy file finder for Node.js - perfect for LLM agent tools",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node test/e2e.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edxeth/fff.git",
+    "directory": "packages/fff-node"
+  },
+  "keywords": [
+    "file-finder",
+    "fuzzy-search",
+    "node",
+    "ffi",
+    "llm-tools",
+    "agent-tools",
+    "fast",
+    "rust"
+  ],
+  "author": "edxeth",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/edxeth/fff/issues"
+  },
+  "homepage": "https://github.com/edxeth/fff#readme",
+  "dependencies": {
+    "ffi-rs": "^1.0.0"
+  },
+  "optionalDependencies": {
+    "@edxeth/fff-bin-darwin-arm64": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-darwin-x64": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-linux-x64-gnu": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-linux-arm64-gnu": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-linux-x64-musl": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-linux-arm64-musl": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-win32-x64": "0.7.2-edxeth.0",
+    "@edxeth/fff-bin-win32-arm64": "0.7.2-edxeth.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^22.0.0"
+  }
+}