taladb 0.11.7 → 0.12.0

package/README.md

@@ -137,13 +137,13 @@ await runMigrations(db, [
 
 ## Full Documentation
 
-**[https://taladb.github.io/taladb](https://taladb.github.io/taladb)**
+**[https://taladb.dev](https://taladb.dev)**
 
-- [Introduction](https://taladb.github.io/taladb/introduction)
-- [Web (Browser / WASM) Guide](https://taladb.github.io/taladb/guide/web)
-- [Node.js Guide](https://taladb.github.io/taladb/guide/node)
-- [React Native Guide](https://taladb.github.io/taladb/guide/react-native)
-- [API Reference](https://taladb.github.io/taladb/api/collection)
+- [Introduction](https://taladb.dev/introduction)
+- [Web (Browser / WASM) Guide](https://taladb.dev/guide/web)
+- [Node.js Guide](https://taladb.dev/guide/node)
+- [React Native Guide](https://taladb.dev/guide/react-native)
+- [API Reference](https://taladb.dev/api/collection)
 
 ## License
 

package/dist/index.browser.mjs

@@ -22,6 +22,19 @@ function abortError() {
 }
 function createVectorClient(send) {
   const client = {
+    vectorCacheStats: () => send({ op: "cacheStats" }),
+    setVectorCacheBudget: async (bytes) => {
+      integer(bytes, "bytes");
+      return send({ op: "cacheBudget", bytes });
+    },
+    setVectorCacheAdaptive: async (memoryBytes) => {
+      if (memoryBytes !== void 0) integer(memoryBytes, "memoryBytes", 1, Number.MAX_SAFE_INTEGER);
+      return send({ op: "cacheAdaptive", memoryBytes });
+    },
+    notifyMemoryPressure: async (level) => {
+      if (!["normal", "moderate", "critical"].includes(level)) throw new Error("invalid memory pressure level");
+      return send({ op: "memoryPressure", level });
+    },
     searchVectors: async (field, vector, topK, filter, options = {}) => {
       integer(topK, "topK");
       return send({ op: "search", field, query: vectorValues(vector), topK, filter, options: queryOptions(options) });
@@ -92,6 +105,12 @@ var ENDPOINT_FIELDS = [
   "delete_endpoint"
 ];
 function validateConfig(config) {
+  if (config.vector_cache_memory_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_memory_bytes) || config.vector_cache_memory_bytes <= 0)) {
+    throw new Error("TalaDB config: vector_cache_memory_bytes must be a positive safe integer");
+  }
+  if (config.vector_cache_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_bytes) || config.vector_cache_bytes < 0)) {
+    throw new Error("TalaDB config: vector_cache_bytes must be a nonnegative safe integer");
+  }
   const sync = config.sync;
   if (!sync) return;
   for (const key of ENDPOINT_FIELDS) {

package/dist/index.d.mts

@@ -62,7 +62,28 @@ interface VectorRecall {
     exactMs: number;
     annMs: number;
 }
+type MemoryPressure = 'normal' | 'moderate' | 'critical';
+interface VectorCacheStats {
+    budgetBytes: number;
+    baselineBudgetBytes: number;
+    policy: 'adaptive' | 'fixed';
+    memoryHintBytes: number | null;
+    pressure: MemoryPressure;
+    retainedBytes: number;
+    memoryBudgetBytes: number;
+    activeBytes: number;
+    peakBytes: number;
+    vectorIndexes: number;
+    graphIndexes: number;
+}
 interface VectorClient<T> {
+    /** Cache controls apply to all collections in this database. */
+    vectorCacheStats(): Promise<VectorCacheStats>;
+    setVectorCacheBudget(bytes: number): Promise<VectorCacheStats>;
+    /** Omit the hint to restore the platform fallback; pressure remains active. */
+    setVectorCacheAdaptive(memoryBytes?: number): Promise<VectorCacheStats>;
+    /** Normal explicitly restores the baseline after a pressure signal. */
+    notifyMemoryPressure(level: MemoryPressure): Promise<VectorCacheStats>;
     searchVectors(field: string, vector: ArrayLike<number>, topK: number, filter?: Record<string, unknown>, options?: VectorQueryOptions): Promise<VectorQueryResult<T>>;
     /** Exact range search. Returns every matching document above the score threshold. */
     findWithin(field: string, vector: ArrayLike<number>, scoreThreshold: number, filter?: Record<string, unknown>): Promise<VectorQueryResult<T>>;
@@ -233,6 +254,13 @@ interface TextSearchOptions {
      * length; `1` normalises fully by length relative to the corpus average.
      */
     b?: number;
+    /**
+     * Drop common English words ("to", "the", "and", …) from the query before
+     * ranking, so they do not match nearly every document (default `true`). A
+     * query made only of such words is searched as typed. Documents are indexed
+     * in full either way, so changing this needs no reindex.
+     */
+    stopwords?: boolean;
 }
 interface HybridSearchResult<T extends Document = Document> {
     /** The matched document. */
@@ -813,6 +841,11 @@ interface DurabilityConfig {
 }
 /** Top-level TalaDB configuration. */
 interface TalaDbConfig {
+    /** Shared decoded search allowance in bytes, including active ANN scratch.
+     * Zero disables retention; short walks share a 64 KiB workspace. */
+    vector_cache_bytes?: number;
+    /** Device/host memory hint in bytes for adaptive sizing; fixed budgets take precedence. */
+    vector_cache_memory_bytes?: number;
     /** Outbound change-webhook configuration. Disabled by default. */
     webhook?: WebhookConfig;
     /** Storage durability configuration. */
@@ -1018,4 +1051,4 @@ interface OpenDBOptions {
  */
 declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorBuildProgress, type VectorClient, type VectorGraphOptions, type VectorIndexOptions, type VectorIndexStatus, type VectorMetric, type VectorQuantization, type VectorQueryOptions, type VectorQueryResult, type VectorRebuildOptions, type VectorRecall, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createVectorClient, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };
+export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type MemoryPressure, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorBuildProgress, type VectorCacheStats, type VectorClient, type VectorGraphOptions, type VectorIndexOptions, type VectorIndexStatus, type VectorMetric, type VectorQuantization, type VectorQueryOptions, type VectorQueryResult, type VectorRebuildOptions, type VectorRecall, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createVectorClient, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };

package/dist/index.d.ts

@@ -62,7 +62,28 @@ interface VectorRecall {
     exactMs: number;
     annMs: number;
 }
+type MemoryPressure = 'normal' | 'moderate' | 'critical';
+interface VectorCacheStats {
+    budgetBytes: number;
+    baselineBudgetBytes: number;
+    policy: 'adaptive' | 'fixed';
+    memoryHintBytes: number | null;
+    pressure: MemoryPressure;
+    retainedBytes: number;
+    memoryBudgetBytes: number;
+    activeBytes: number;
+    peakBytes: number;
+    vectorIndexes: number;
+    graphIndexes: number;
+}
 interface VectorClient<T> {
+    /** Cache controls apply to all collections in this database. */
+    vectorCacheStats(): Promise<VectorCacheStats>;
+    setVectorCacheBudget(bytes: number): Promise<VectorCacheStats>;
+    /** Omit the hint to restore the platform fallback; pressure remains active. */
+    setVectorCacheAdaptive(memoryBytes?: number): Promise<VectorCacheStats>;
+    /** Normal explicitly restores the baseline after a pressure signal. */
+    notifyMemoryPressure(level: MemoryPressure): Promise<VectorCacheStats>;
     searchVectors(field: string, vector: ArrayLike<number>, topK: number, filter?: Record<string, unknown>, options?: VectorQueryOptions): Promise<VectorQueryResult<T>>;
     /** Exact range search. Returns every matching document above the score threshold. */
     findWithin(field: string, vector: ArrayLike<number>, scoreThreshold: number, filter?: Record<string, unknown>): Promise<VectorQueryResult<T>>;
@@ -233,6 +254,13 @@ interface TextSearchOptions {
      * length; `1` normalises fully by length relative to the corpus average.
      */
     b?: number;
+    /**
+     * Drop common English words ("to", "the", "and", …) from the query before
+     * ranking, so they do not match nearly every document (default `true`). A
+     * query made only of such words is searched as typed. Documents are indexed
+     * in full either way, so changing this needs no reindex.
+     */
+    stopwords?: boolean;
 }
 interface HybridSearchResult<T extends Document = Document> {
     /** The matched document. */
@@ -813,6 +841,11 @@ interface DurabilityConfig {
 }
 /** Top-level TalaDB configuration. */
 interface TalaDbConfig {
+    /** Shared decoded search allowance in bytes, including active ANN scratch.
+     * Zero disables retention; short walks share a 64 KiB workspace. */
+    vector_cache_bytes?: number;
+    /** Device/host memory hint in bytes for adaptive sizing; fixed budgets take precedence. */
+    vector_cache_memory_bytes?: number;
     /** Outbound change-webhook configuration. Disabled by default. */
     webhook?: WebhookConfig;
     /** Storage durability configuration. */
@@ -1018,4 +1051,4 @@ interface OpenDBOptions {
  */
 declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorBuildProgress, type VectorClient, type VectorGraphOptions, type VectorIndexOptions, type VectorIndexStatus, type VectorMetric, type VectorQuantization, type VectorQueryOptions, type VectorQueryResult, type VectorRebuildOptions, type VectorRecall, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createVectorClient, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };
+export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type MemoryPressure, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorBuildProgress, type VectorCacheStats, type VectorClient, type VectorGraphOptions, type VectorIndexOptions, type VectorIndexStatus, type VectorMetric, type VectorQuantization, type VectorQueryOptions, type VectorQueryResult, type VectorRebuildOptions, type VectorRecall, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createVectorClient, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };

package/dist/index.js

@@ -67,6 +67,19 @@ function abortError() {
 }
 function createVectorClient(send) {
   const client = {
+    vectorCacheStats: () => send({ op: "cacheStats" }),
+    setVectorCacheBudget: async (bytes) => {
+      integer(bytes, "bytes");
+      return send({ op: "cacheBudget", bytes });
+    },
+    setVectorCacheAdaptive: async (memoryBytes) => {
+      if (memoryBytes !== void 0) integer(memoryBytes, "memoryBytes", 1, Number.MAX_SAFE_INTEGER);
+      return send({ op: "cacheAdaptive", memoryBytes });
+    },
+    notifyMemoryPressure: async (level) => {
+      if (!["normal", "moderate", "critical"].includes(level)) throw new Error("invalid memory pressure level");
+      return send({ op: "memoryPressure", level });
+    },
     searchVectors: async (field, vector, topK, filter, options = {}) => {
       integer(topK, "topK");
       return send({ op: "search", field, query: vectorValues(vector), topK, filter, options: queryOptions(options) });
@@ -407,7 +420,13 @@ function wrapCollectionWithWebhook(col, collection, webhook) {
 
 // src/config.ts
 function validateConfig(config) {
+  if (config.vector_cache_memory_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_memory_bytes) || config.vector_cache_memory_bytes <= 0)) {
+    throw new Error("TalaDB config: vector_cache_memory_bytes must be a positive safe integer");
+  }
   if (config.webhook) validateWebhookConfig(config.webhook);
+  if (config.vector_cache_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_bytes) || config.vector_cache_bytes < 0)) {
+    throw new Error("TalaDB config: vector_cache_bytes must be a nonnegative safe integer");
+  }
 }
 async function loadConfig(configPath) {
   if (typeof process === "undefined" || typeof process.cwd !== "function") {

package/dist/index.mjs

@@ -22,6 +22,19 @@ function abortError() {
 }
 function createVectorClient(send) {
   const client = {
+    vectorCacheStats: () => send({ op: "cacheStats" }),
+    setVectorCacheBudget: async (bytes) => {
+      integer(bytes, "bytes");
+      return send({ op: "cacheBudget", bytes });
+    },
+    setVectorCacheAdaptive: async (memoryBytes) => {
+      if (memoryBytes !== void 0) integer(memoryBytes, "memoryBytes", 1, Number.MAX_SAFE_INTEGER);
+      return send({ op: "cacheAdaptive", memoryBytes });
+    },
+    notifyMemoryPressure: async (level) => {
+      if (!["normal", "moderate", "critical"].includes(level)) throw new Error("invalid memory pressure level");
+      return send({ op: "memoryPressure", level });
+    },
     searchVectors: async (field, vector, topK, filter, options = {}) => {
       integer(topK, "topK");
       return send({ op: "search", field, query: vectorValues(vector), topK, filter, options: queryOptions(options) });
@@ -362,7 +375,13 @@ function wrapCollectionWithWebhook(col, collection, webhook) {
 
 // src/config.ts
 function validateConfig(config) {
+  if (config.vector_cache_memory_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_memory_bytes) || config.vector_cache_memory_bytes <= 0)) {
+    throw new Error("TalaDB config: vector_cache_memory_bytes must be a positive safe integer");
+  }
   if (config.webhook) validateWebhookConfig(config.webhook);
+  if (config.vector_cache_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_bytes) || config.vector_cache_bytes < 0)) {
+    throw new Error("TalaDB config: vector_cache_bytes must be a nonnegative safe integer");
+  }
 }
 async function loadConfig(configPath) {
   if (typeof process === "undefined" || typeof process.cwd !== "function") {

package/dist/index.react-native.mjs

@@ -22,6 +22,19 @@ function abortError() {
 }
 function createVectorClient(send) {
   const client = {
+    vectorCacheStats: () => send({ op: "cacheStats" }),
+    setVectorCacheBudget: async (bytes) => {
+      integer(bytes, "bytes");
+      return send({ op: "cacheBudget", bytes });
+    },
+    setVectorCacheAdaptive: async (memoryBytes) => {
+      if (memoryBytes !== void 0) integer(memoryBytes, "memoryBytes", 1, Number.MAX_SAFE_INTEGER);
+      return send({ op: "cacheAdaptive", memoryBytes });
+    },
+    notifyMemoryPressure: async (level) => {
+      if (!["normal", "moderate", "critical"].includes(level)) throw new Error("invalid memory pressure level");
+      return send({ op: "memoryPressure", level });
+    },
     searchVectors: async (field, vector, topK, filter, options = {}) => {
       integer(topK, "topK");
       return send({ op: "search", field, query: vectorValues(vector), topK, filter, options: queryOptions(options) });
@@ -92,6 +105,12 @@ var ENDPOINT_FIELDS = [
   "delete_endpoint"
 ];
 function validateConfig(config) {
+  if (config.vector_cache_memory_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_memory_bytes) || config.vector_cache_memory_bytes <= 0)) {
+    throw new Error("TalaDB config: vector_cache_memory_bytes must be a positive safe integer");
+  }
+  if (config.vector_cache_bytes !== void 0 && (!Number.isSafeInteger(config.vector_cache_bytes) || config.vector_cache_bytes < 0)) {
+    throw new Error("TalaDB config: vector_cache_bytes must be a nonnegative safe integer");
+  }
   const sync = config.sync;
   if (!sync) return;
   for (const key of ENDPOINT_FIELDS) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taladb",
-  "version": "0.11.7",
+  "version": "0.12.0",
   "description": "The embedded vector database for on-device AI — documents, similarity search, and offline sync for browser, React Native, and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -44,7 +44,7 @@
     "url": "https://github.com/taladb/taladb.git",
     "directory": "packages/clients/taladb"
   },
-  "homepage": "https://taladb.github.io/taladb/",
+  "homepage": "https://taladb.dev/",
   "bugs": {
     "url": "https://github.com/taladb/taladb/issues"
   },
@@ -62,8 +62,8 @@
     "vitest": "^3.2.0"
   },
   "peerDependencies": {
-    "@taladb/web": "0.11.7",
-    "@taladb/node": "0.11.7"
+    "@taladb/web": "0.12.0",
+    "@taladb/node": "0.12.0"
   },
   "peerDependenciesMeta": {
     "@taladb/web": {