@neuralsea/workspace-indexer 0.3.6 → 0.4.1

package/dist/index.d.cts

@@ -61,6 +61,28 @@ interface SymbolGraphProvider {
     }): Promise<GraphEdge[]>;
 }
 
+type WorkspaceDbCapabilities = {
+    /** Whether this SQLite build supports `CREATE VIRTUAL TABLE ... USING fts5(...)`. */
+    supportsFts5: boolean;
+};
+interface WorkspaceDbStatement {
+    run(...args: any[]): any;
+    get(...args: any[]): any;
+    all(...args: any[]): any;
+}
+interface WorkspaceDbAdapter {
+    readonly capabilities: WorkspaceDbCapabilities;
+    pragma(sql: string): void;
+    exec(sql: string): void;
+    prepare(sql: string): WorkspaceDbStatement;
+    transaction<T>(fn: () => T): () => T;
+    close(): void;
+}
+type WorkspaceDbFactory = {
+    open(dbPath: string): WorkspaceDbAdapter;
+};
+declare const betterSqlite3Adapter: WorkspaceDbFactory;
+
 type AnnMetric = "cosine" | "ip" | "l2";
 type AnnPoint = {
     id: string;
@@ -406,6 +428,11 @@ interface IndexerConfig extends ProfilesConfig {
     ann?: AnnConfig;
     /** Workspace-only settings (used by WorkspaceIndexer). */
     workspace?: {
+        /**
+         * Optional DB adapter factory used for the workspace store.
+         * Default: `sqlJsAdapter()` (falls back to `betterSqlite3Adapter` if sql.js isn't available).
+         */
+        db?: WorkspaceDbFactory | Promise<WorkspaceDbFactory>;
         /**
          * Repo discovery knobs.
          * - include/exclude are workspace-root-relative globs (POSIX-style)
@@ -752,7 +779,16 @@ type WorkspaceStoreOptions = {
     /** "auto" (default) tries FTS5; "off" disables it. */
     fts?: "auto" | "off";
 };
+type WorkspaceStoreDbOptions = {
+    db?: WorkspaceDbFactory;
+};
 
+type CreateWorkspaceStoreOptions = WorkspaceStoreOptions & WorkspaceStoreDbOptions;
+declare function createWorkspaceStore(dbPath: string, opts?: CreateWorkspaceStoreOptions): WorkspaceStore;
+type CreateWorkspaceStoreAsyncOptions = WorkspaceStoreOptions & {
+    db?: WorkspaceDbFactory | Promise<WorkspaceDbFactory>;
+};
+declare function createWorkspaceStoreAsync(dbPath: string, opts?: CreateWorkspaceStoreAsyncOptions): Promise<WorkspaceStore>;
 /**
  * Workspace-level unified store (SQLite) for multi-repo indexing.
  *
@@ -767,6 +803,7 @@ declare class WorkspaceStore {
     private readonly dbPath;
     private readonly db;
     private readonly uow;
+    private readonly ftsEnabledInternal;
     private readonly meta;
     private readonly repoHeads;
     private readonly files;
@@ -775,7 +812,8 @@ declare class WorkspaceStore {
     private readonly symbols;
     private readonly chunks;
     private readonly opts;
-    constructor(dbPath: string, opts?: WorkspaceStoreOptions);
+    constructor(dbPath: string, opts?: CreateWorkspaceStoreOptions);
+    get ftsEnabled(): boolean;
     setMeta(k: string, v: string): void;
     getMeta(k: string): string | null;
     /**
@@ -852,6 +890,21 @@ declare class WorkspaceStore {
     close(): void;
 }
 
+type SqlJsAdapterOptions = {
+    /**
+     * sql.js locateFile hook used to find `sql-wasm.wasm`.
+     * If omitted, a Node-only default is used to resolve the wasm from the installed `sql.js` package.
+     */
+    locateFile?: (file: string) => string;
+    /** Provide a preloaded wasm binary (avoids filesystem/network lookups). */
+    wasmBinary?: Uint8Array;
+};
+/**
+ * Creates a WorkspaceDbFactory backed by sql.js (WASM).
+ * Requires the optional dependency `sql.js` to be installed.
+ */
+declare function sqlJsAdapter(opts?: SqlJsAdapterOptions): Promise<WorkspaceDbFactory>;
+
 declare function stableSymbolId(input: {
     repoRoot: string;
     path: string;
@@ -1314,13 +1367,14 @@ declare class WorkspaceIndexer {
     private progress;
     private workspaceStore;
     private graphStore;
+    private readonly workspaceDbPath;
     constructor(workspaceRoot: string, embedder: EmbeddingsProvider, config?: IndexerConfig);
     private emitProgress;
+    private ensureWorkspaceStore;
     open(): Promise<void>;
     indexAll(): Promise<void>;
     watch(): Promise<void>;
     getRepoIndexers(): RepoIndexer[];
-    private resolveProfile;
     retrieve(query: string, opts?: RetrieveOptions): Promise<ContextBundle>;
     search(query: string, k?: number): Promise<SearchHit[]>;
     closeAsync(): Promise<void>;
@@ -1394,4 +1448,4 @@ declare function linkWorkspaceRepos(args: {
 
 declare function loadConfigFile(filePath: string): IndexerConfig;
 
-export { type AnnConfig, type AnnIndex, type AnnIndexInit, type AnnMetric, type AnnPoint, type AnnSearchHit, type Cancellation, type Chunk, type ChunkRecord, type ChunkingConfig, type ContextBundle, type CustomVectorConfig, DEFAULT_PROFILES, type EmbeddingsProvider, type FaissVectorConfig, GoModuleLinkStrategy, type GraphEdge, type GraphFileUpdate, type GraphStore, type GraphSymbol, HashEmbeddingsProvider, type HnswlibVectorConfig, type IndexerConfig, type IndexerProgress, type IndexerProgressEvent, type IndexerProgressHandler, IndexerProgressObservable, type IndexerProgressSink, type LspDocument, type LspDocumentSymbol, type LspFacade, type LspPosition, type LspRange, type LspTargetLocation, Neo4jGraphStore, NestedRepoLinkStrategy, NoopAnnIndex, NpmDependencyLinkStrategy, OllamaEmbeddingsProvider, OpenAIEmbeddingsProvider, type ProfilesConfig, type QdrantVectorConfig, type RelatedContextOptions, type RepoDiscoveryOptions, type RepoId, RepoIndexer, type RepoInfo, type RepoLink, type RetrievalProfile, type RetrievalProfileName, type RetrievalScope, type RetrievalWeights, type RetrieveOptions, type SearchHit, type SearchOptions, type SymbolEdgeKind, type SymbolGraphIndexInput, type SymbolGraphIndexOutput, SymbolGraphIndexer, type SymbolGraphIndexingMode, type SymbolGraphProvider, type SymbolGraphStrategyOptions, type SymbolKind, type SymbolRange, type VectorConfig, type VectorIndex, type VectorIndexInit, type VectorMetric, type VectorPoint, type VectorProviderKind, type VectorSearchHit, VsCodeContributesLanguageLinkStrategy, type WorkspaceChunkRow, WorkspaceIndexer, type WorkspaceLinkContext, type WorkspaceLinkStrategy, WorkspaceLinker, WorkspaceStore, asProgressSink, chunkSource, createAnnIndex, createNeo4jGraphStore, createVSCodeSymbolGraphProvider, createVectorIndex, deepMergeProfile, discoverGitRepos, languageFromPath, linkWorkspaceRepos, loadConfigFile, mergeIndexerConfig, pickRepoOverride, stableSymbolId };
+export { type AnnConfig, type AnnIndex, type AnnIndexInit, type AnnMetric, type AnnPoint, type AnnSearchHit, type Cancellation, type Chunk, type ChunkRecord, type ChunkingConfig, type ContextBundle, type CreateWorkspaceStoreAsyncOptions, type CreateWorkspaceStoreOptions, type CustomVectorConfig, DEFAULT_PROFILES, type EmbeddingsProvider, type FaissVectorConfig, GoModuleLinkStrategy, type GraphEdge, type GraphFileUpdate, type GraphStore, type GraphSymbol, HashEmbeddingsProvider, type HnswlibVectorConfig, type IndexerConfig, type IndexerProgress, type IndexerProgressEvent, type IndexerProgressHandler, IndexerProgressObservable, type IndexerProgressSink, type LspDocument, type LspDocumentSymbol, type LspFacade, type LspPosition, type LspRange, type LspTargetLocation, Neo4jGraphStore, NestedRepoLinkStrategy, NoopAnnIndex, NpmDependencyLinkStrategy, OllamaEmbeddingsProvider, OpenAIEmbeddingsProvider, type ProfilesConfig, type QdrantVectorConfig, type RelatedContextOptions, type RepoDiscoveryOptions, type RepoId, RepoIndexer, type RepoInfo, type RepoLink, type RetrievalProfile, type RetrievalProfileName, type RetrievalScope, type RetrievalWeights, type RetrieveOptions, type SearchHit, type SearchOptions, type SymbolEdgeKind, type SymbolGraphIndexInput, type SymbolGraphIndexOutput, SymbolGraphIndexer, type SymbolGraphIndexingMode, type SymbolGraphProvider, type SymbolGraphStrategyOptions, type SymbolKind, type SymbolRange, type VectorConfig, type VectorIndex, type VectorIndexInit, type VectorMetric, type VectorPoint, type VectorProviderKind, type VectorSearchHit, VsCodeContributesLanguageLinkStrategy, type WorkspaceChunkRow, type WorkspaceDbAdapter, type WorkspaceDbCapabilities, type WorkspaceDbFactory, type WorkspaceDbStatement, WorkspaceIndexer, type WorkspaceLinkContext, type WorkspaceLinkStrategy, WorkspaceLinker, WorkspaceStore, asProgressSink, betterSqlite3Adapter, chunkSource, createAnnIndex, createNeo4jGraphStore, createVSCodeSymbolGraphProvider, createVectorIndex, createWorkspaceStore, createWorkspaceStoreAsync, deepMergeProfile, discoverGitRepos, languageFromPath, linkWorkspaceRepos, loadConfigFile, mergeIndexerConfig, pickRepoOverride, sqlJsAdapter, stableSymbolId };

package/dist/index.d.ts

@@ -61,6 +61,28 @@ interface SymbolGraphProvider {
     }): Promise<GraphEdge[]>;
 }
 
+type WorkspaceDbCapabilities = {
+    /** Whether this SQLite build supports `CREATE VIRTUAL TABLE ... USING fts5(...)`. */
+    supportsFts5: boolean;
+};
+interface WorkspaceDbStatement {
+    run(...args: any[]): any;
+    get(...args: any[]): any;
+    all(...args: any[]): any;
+}
+interface WorkspaceDbAdapter {
+    readonly capabilities: WorkspaceDbCapabilities;
+    pragma(sql: string): void;
+    exec(sql: string): void;
+    prepare(sql: string): WorkspaceDbStatement;
+    transaction<T>(fn: () => T): () => T;
+    close(): void;
+}
+type WorkspaceDbFactory = {
+    open(dbPath: string): WorkspaceDbAdapter;
+};
+declare const betterSqlite3Adapter: WorkspaceDbFactory;
+
 type AnnMetric = "cosine" | "ip" | "l2";
 type AnnPoint = {
     id: string;
@@ -406,6 +428,11 @@ interface IndexerConfig extends ProfilesConfig {
     ann?: AnnConfig;
     /** Workspace-only settings (used by WorkspaceIndexer). */
     workspace?: {
+        /**
+         * Optional DB adapter factory used for the workspace store.
+         * Default: `sqlJsAdapter()` (falls back to `betterSqlite3Adapter` if sql.js isn't available).
+         */
+        db?: WorkspaceDbFactory | Promise<WorkspaceDbFactory>;
         /**
          * Repo discovery knobs.
          * - include/exclude are workspace-root-relative globs (POSIX-style)
@@ -752,7 +779,16 @@ type WorkspaceStoreOptions = {
     /** "auto" (default) tries FTS5; "off" disables it. */
     fts?: "auto" | "off";
 };
+type WorkspaceStoreDbOptions = {
+    db?: WorkspaceDbFactory;
+};
 
+type CreateWorkspaceStoreOptions = WorkspaceStoreOptions & WorkspaceStoreDbOptions;
+declare function createWorkspaceStore(dbPath: string, opts?: CreateWorkspaceStoreOptions): WorkspaceStore;
+type CreateWorkspaceStoreAsyncOptions = WorkspaceStoreOptions & {
+    db?: WorkspaceDbFactory | Promise<WorkspaceDbFactory>;
+};
+declare function createWorkspaceStoreAsync(dbPath: string, opts?: CreateWorkspaceStoreAsyncOptions): Promise<WorkspaceStore>;
 /**
  * Workspace-level unified store (SQLite) for multi-repo indexing.
  *
@@ -767,6 +803,7 @@ declare class WorkspaceStore {
     private readonly dbPath;
     private readonly db;
     private readonly uow;
+    private readonly ftsEnabledInternal;
     private readonly meta;
     private readonly repoHeads;
     private readonly files;
@@ -775,7 +812,8 @@ declare class WorkspaceStore {
     private readonly symbols;
     private readonly chunks;
     private readonly opts;
-    constructor(dbPath: string, opts?: WorkspaceStoreOptions);
+    constructor(dbPath: string, opts?: CreateWorkspaceStoreOptions);
+    get ftsEnabled(): boolean;
     setMeta(k: string, v: string): void;
     getMeta(k: string): string | null;
     /**
@@ -852,6 +890,21 @@ declare class WorkspaceStore {
     close(): void;
 }
 
+type SqlJsAdapterOptions = {
+    /**
+     * sql.js locateFile hook used to find `sql-wasm.wasm`.
+     * If omitted, a Node-only default is used to resolve the wasm from the installed `sql.js` package.
+     */
+    locateFile?: (file: string) => string;
+    /** Provide a preloaded wasm binary (avoids filesystem/network lookups). */
+    wasmBinary?: Uint8Array;
+};
+/**
+ * Creates a WorkspaceDbFactory backed by sql.js (WASM).
+ * Requires the optional dependency `sql.js` to be installed.
+ */
+declare function sqlJsAdapter(opts?: SqlJsAdapterOptions): Promise<WorkspaceDbFactory>;
+
 declare function stableSymbolId(input: {
     repoRoot: string;
     path: string;
@@ -1314,13 +1367,14 @@ declare class WorkspaceIndexer {
     private progress;
     private workspaceStore;
     private graphStore;
+    private readonly workspaceDbPath;
     constructor(workspaceRoot: string, embedder: EmbeddingsProvider, config?: IndexerConfig);
     private emitProgress;
+    private ensureWorkspaceStore;
     open(): Promise<void>;
     indexAll(): Promise<void>;
     watch(): Promise<void>;
     getRepoIndexers(): RepoIndexer[];
-    private resolveProfile;
     retrieve(query: string, opts?: RetrieveOptions): Promise<ContextBundle>;
     search(query: string, k?: number): Promise<SearchHit[]>;
     closeAsync(): Promise<void>;
@@ -1394,4 +1448,4 @@ declare function linkWorkspaceRepos(args: {
 
 declare function loadConfigFile(filePath: string): IndexerConfig;
 
-export { type AnnConfig, type AnnIndex, type AnnIndexInit, type AnnMetric, type AnnPoint, type AnnSearchHit, type Cancellation, type Chunk, type ChunkRecord, type ChunkingConfig, type ContextBundle, type CustomVectorConfig, DEFAULT_PROFILES, type EmbeddingsProvider, type FaissVectorConfig, GoModuleLinkStrategy, type GraphEdge, type GraphFileUpdate, type GraphStore, type GraphSymbol, HashEmbeddingsProvider, type HnswlibVectorConfig, type IndexerConfig, type IndexerProgress, type IndexerProgressEvent, type IndexerProgressHandler, IndexerProgressObservable, type IndexerProgressSink, type LspDocument, type LspDocumentSymbol, type LspFacade, type LspPosition, type LspRange, type LspTargetLocation, Neo4jGraphStore, NestedRepoLinkStrategy, NoopAnnIndex, NpmDependencyLinkStrategy, OllamaEmbeddingsProvider, OpenAIEmbeddingsProvider, type ProfilesConfig, type QdrantVectorConfig, type RelatedContextOptions, type RepoDiscoveryOptions, type RepoId, RepoIndexer, type RepoInfo, type RepoLink, type RetrievalProfile, type RetrievalProfileName, type RetrievalScope, type RetrievalWeights, type RetrieveOptions, type SearchHit, type SearchOptions, type SymbolEdgeKind, type SymbolGraphIndexInput, type SymbolGraphIndexOutput, SymbolGraphIndexer, type SymbolGraphIndexingMode, type SymbolGraphProvider, type SymbolGraphStrategyOptions, type SymbolKind, type SymbolRange, type VectorConfig, type VectorIndex, type VectorIndexInit, type VectorMetric, type VectorPoint, type VectorProviderKind, type VectorSearchHit, VsCodeContributesLanguageLinkStrategy, type WorkspaceChunkRow, WorkspaceIndexer, type WorkspaceLinkContext, type WorkspaceLinkStrategy, WorkspaceLinker, WorkspaceStore, asProgressSink, chunkSource, createAnnIndex, createNeo4jGraphStore, createVSCodeSymbolGraphProvider, createVectorIndex, deepMergeProfile, discoverGitRepos, languageFromPath, linkWorkspaceRepos, loadConfigFile, mergeIndexerConfig, pickRepoOverride, stableSymbolId };
+export { type AnnConfig, type AnnIndex, type AnnIndexInit, type AnnMetric, type AnnPoint, type AnnSearchHit, type Cancellation, type Chunk, type ChunkRecord, type ChunkingConfig, type ContextBundle, type CreateWorkspaceStoreAsyncOptions, type CreateWorkspaceStoreOptions, type CustomVectorConfig, DEFAULT_PROFILES, type EmbeddingsProvider, type FaissVectorConfig, GoModuleLinkStrategy, type GraphEdge, type GraphFileUpdate, type GraphStore, type GraphSymbol, HashEmbeddingsProvider, type HnswlibVectorConfig, type IndexerConfig, type IndexerProgress, type IndexerProgressEvent, type IndexerProgressHandler, IndexerProgressObservable, type IndexerProgressSink, type LspDocument, type LspDocumentSymbol, type LspFacade, type LspPosition, type LspRange, type LspTargetLocation, Neo4jGraphStore, NestedRepoLinkStrategy, NoopAnnIndex, NpmDependencyLinkStrategy, OllamaEmbeddingsProvider, OpenAIEmbeddingsProvider, type ProfilesConfig, type QdrantVectorConfig, type RelatedContextOptions, type RepoDiscoveryOptions, type RepoId, RepoIndexer, type RepoInfo, type RepoLink, type RetrievalProfile, type RetrievalProfileName, type RetrievalScope, type RetrievalWeights, type RetrieveOptions, type SearchHit, type SearchOptions, type SymbolEdgeKind, type SymbolGraphIndexInput, type SymbolGraphIndexOutput, SymbolGraphIndexer, type SymbolGraphIndexingMode, type SymbolGraphProvider, type SymbolGraphStrategyOptions, type SymbolKind, type SymbolRange, type VectorConfig, type VectorIndex, type VectorIndexInit, type VectorMetric, type VectorPoint, type VectorProviderKind, type VectorSearchHit, VsCodeContributesLanguageLinkStrategy, type WorkspaceChunkRow, type WorkspaceDbAdapter, type WorkspaceDbCapabilities, type WorkspaceDbFactory, type WorkspaceDbStatement, WorkspaceIndexer, type WorkspaceLinkContext, type WorkspaceLinkStrategy, WorkspaceLinker, WorkspaceStore, asProgressSink, betterSqlite3Adapter, chunkSource, createAnnIndex, createNeo4jGraphStore, createVSCodeSymbolGraphProvider, createVectorIndex, createWorkspaceStore, createWorkspaceStoreAsync, deepMergeProfile, discoverGitRepos, languageFromPath, linkWorkspaceRepos, loadConfigFile, mergeIndexerConfig, pickRepoOverride, sqlJsAdapter, stableSymbolId };

package/dist/index.js

@@ -15,10 +15,13 @@ import {
   WorkspaceLinker,
   WorkspaceStore,
   asProgressSink,
+  betterSqlite3Adapter,
   chunkSource,
   createAnnIndex,
   createNeo4jGraphStore,
   createVectorIndex,
+  createWorkspaceStore,
+  createWorkspaceStoreAsync,
   deepMergeProfile,
   discoverGitRepos,
   languageFromPath,
@@ -26,8 +29,9 @@ import {
   loadConfigFile,
   mergeIndexerConfig,
   pickRepoOverride,
+  sqlJsAdapter,
   stableSymbolId
-} from "./chunk-FUUQXFJQ.js";
+} from "./chunk-TQTWTPPG.js";
 
 // src/symbolGraph/vscodeProvider.ts
 import path2 from "path";
@@ -411,11 +415,14 @@ export {
   WorkspaceLinker,
   WorkspaceStore,
   asProgressSink,
+  betterSqlite3Adapter,
   chunkSource,
   createAnnIndex,
   createNeo4jGraphStore,
   createVSCodeSymbolGraphProvider,
   createVectorIndex,
+  createWorkspaceStore,
+  createWorkspaceStoreAsync,
   deepMergeProfile,
   discoverGitRepos,
   languageFromPath,
@@ -423,5 +430,6 @@ export {
   loadConfigFile,
   mergeIndexerConfig,
   pickRepoOverride,
+  sqlJsAdapter,
   stableSymbolId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neuralsea/workspace-indexer",
-  "version": "0.3.6",
+  "version": "0.4.1",
   "description": "Local-first multi-repo workspace indexer (semantic embeddings + git-aware incremental updates + hybrid retrieval profiles) for AI agents.",
   "repository": {
     "type": "git",
@@ -26,8 +26,8 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts --clean",
-    "dev": "tsup src/index.ts src/cli.ts --format esm,cjs --dts --watch",
+    "build": "tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
     "lint": "node -e \"console.log('Add eslint if desired')\"",
     "test": "node scripts/run-tests.mjs test",
     "test:unit": "node scripts/run-tests.mjs test/unit",
@@ -41,6 +41,9 @@
     "p-limit": "^7.2.0",
     "yargs": "^18.0.0"
   },
+  "optionalDependencies": {
+    "sql.js": "^1.13.0"
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.0.3",