@mirk/store 0.4.1 → 0.4.2

package/dist/adapters/sqlite.js

@@ -2,8 +2,9 @@ import {
   assertDimensions,
   bufferToVector,
   cosineSimilarity,
+  isUsableVector,
   vectorToBuffer
-} from "../chunk-GC4MYP45.js";
+} from "../chunk-BXM3YDOC.js";
 
 // src/adapters/sqlite.ts
 import Database from "better-sqlite3";
@@ -25,15 +26,6 @@ function tryLoadSqliteVec(db) {
     return false;
   }
 }
-function isUsableVector(v) {
-  let nonZero = false;
-  for (let i = 0; i < v.length; i++) {
-    const x = v[i] ?? 0;
-    if (!Number.isFinite(x)) return false;
-    if (x !== 0) nonZero = true;
-  }
-  return nonZero;
-}
 var SqliteAdapter = class {
   db;
   kv;
@@ -337,6 +329,9 @@ var SqliteVectorFacet = class {
     return scored.slice(0, topK);
   }
 };
+function jsonPath(field) {
+  return `$."${field.replace(/"/g, '""')}"`;
+}
 function buildWhereClause(filter) {
   if (!filter?.where || Object.keys(filter.where).length === 0) {
     return { clause: "", params: [] };
@@ -344,18 +339,25 @@ function buildWhereClause(filter) {
   const conditions = [];
   const params = [];
   for (const [key, value] of Object.entries(filter.where)) {
-    conditions.push(`json_extract(data, '$.' || ?) = ?`);
-    const bound = typeof value === "boolean" ? value ? 1 : 0 : value;
-    params.push(key, bound);
+    const path = jsonPath(key);
+    if (value === null) {
+      conditions.push(`json_type(data, ?) = 'null'`);
+      params.push(path);
+    } else {
+      const bound = typeof value === "boolean" ? value ? 1 : 0 : value;
+      conditions.push(`json_extract(data, ?) = ?`);
+      params.push(path, bound);
+    }
   }
   return { clause: ` WHERE ${conditions.join(" AND ")}`, params };
 }
 function buildOrderBy(filter) {
   if (!filter?.sortBy) return { clause: "", params: [] };
   const dir = filter.sortDir === "desc" ? "DESC" : "ASC";
+  const path = jsonPath(filter.sortBy);
   return {
-    clause: ` ORDER BY json_extract(data, '$.' || ?) IS NULL, json_extract(data, '$.' || ?) ${dir}`,
-    params: [filter.sortBy, filter.sortBy]
+    clause: ` ORDER BY json_extract(data, ?) IS NULL, json_extract(data, ?) ${dir}`,
+    params: [path, path]
   };
 }
 function hashName(s) {

package/dist/{chunk-GC4MYP45.js → chunk-BXM3YDOC.js}

@@ -29,6 +29,15 @@ function bufferToVector(buf) {
   }
   return out;
 }
+function isUsableVector(v) {
+  let nonZero = false;
+  for (let i = 0; i < v.length; i++) {
+    const x = v[i] ?? 0;
+    if (!Number.isFinite(x)) return false;
+    if (x !== 0) nonZero = true;
+  }
+  return nonZero;
+}
 function assertDimensions(vector, dimensions) {
   if (vector.length !== dimensions) {
     throw new Error(`Vector dimension mismatch: expected ${dimensions}, got ${vector.length}`);
@@ -39,5 +48,6 @@ export {
   cosineSimilarity,
   vectorToBuffer,
   bufferToVector,
+  isUsableVector,
   assertDimensions
 };

package/dist/{chunk-ZFSKQHBT.js → chunk-EDVHBRXG.js}

@@ -1,7 +1,8 @@
 import {
   assertDimensions,
-  cosineSimilarity
-} from "./chunk-GC4MYP45.js";
+  cosineSimilarity,
+  isUsableVector
+} from "./chunk-BXM3YDOC.js";
 
 // src/vector/memory.ts
 var InMemoryVectorStore = class {
@@ -39,12 +40,13 @@ var InMemoryVectorStore = class {
     if (!coll) return [];
     const scored = [];
     for (const doc of coll.values()) {
+      if (!isUsableVector(doc.vector)) continue;
       const score = cosineSimilarity(query, doc.vector);
       if (!Number.isFinite(score)) continue;
       if (minScore !== void 0 && score < minScore) continue;
       scored.push({ id: doc.id, score, metadata: doc.metadata });
     }
-    scored.sort((a, b) => b.score - a.score);
+    scored.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
     return scored.slice(0, topK);
   }
   collectionFor(name) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { A as AsyncStore, S as StoreFilter, a as StoreMeta, b as SyncStore } from './types-DyQLNtxa.js';
 export { InMemoryKv, toAsync } from './kv.js';
 export { V as Vector, a as VectorDocument, b as VectorSearchOptions, c as VectorSearchResult, d as VectorStore, e as VectorStoreMeta } from './types-BqSZEMAB.js';
-export { InMemoryVectorStore, assertDimensions, bufferToVector, cosineSimilarity, vectorToBuffer } from './vector.js';
+export { InMemoryVectorStore, assertDimensions, bufferToVector, cosineSimilarity, isUsableVector, vectorToBuffer } from './vector.js';

package/dist/index.js

@@ -4,19 +4,21 @@ import {
 } from "./chunk-ZI4JA6IU.js";
 import {
   InMemoryVectorStore
-} from "./chunk-ZFSKQHBT.js";
+} from "./chunk-EDVHBRXG.js";
 import {
   assertDimensions,
   bufferToVector,
   cosineSimilarity,
+  isUsableVector,
   vectorToBuffer
-} from "./chunk-GC4MYP45.js";
+} from "./chunk-BXM3YDOC.js";
 export {
   InMemoryStore as InMemoryKv,
   InMemoryVectorStore,
   assertDimensions,
   bufferToVector,
   cosineSimilarity,
+  isUsableVector,
   toAsync,
   vectorToBuffer
 };

package/dist/vector.d.ts

@@ -10,6 +10,12 @@ declare function cosineSimilarity(a: Vector, b: Vector): number;
 declare function vectorToBuffer(vec: Vector): Buffer;
 /** Inverse of vectorToBuffer. */
 declare function bufferToVector(buf: Buffer | Uint8Array): Vector;
+/** A vector is usable for cosine similarity only if it is all-finite and has a
+ *  non-zero magnitude. A zero / non-finite vector has no cosine direction, so it is
+ *  EXCLUDED from search results on EVERY backend (in-memory, sqlite JS path, and
+ *  sqlite's vec0 path) — that keeps the backends in parity (vec0 would otherwise
+ *  return a zero vector with a null distance). Shared so the rule lives in one place. */
+declare function isUsableVector(v: Vector): boolean;
 /** Throw if a vector's length doesn't match the store's configured dimensions.
  *  Shared by every backend so the check and its message live in one place. */
 declare function assertDimensions(vector: Vector, dimensions: number): void;
@@ -32,4 +38,4 @@ declare class InMemoryVectorStore implements VectorStore {
     private collectionFor;
 }
 
-export { InMemoryVectorStore, Vector, VectorDocument, VectorSearchOptions, VectorSearchResult, VectorStore, VectorStoreMeta, assertDimensions, bufferToVector, cosineSimilarity, vectorToBuffer };
+export { InMemoryVectorStore, Vector, VectorDocument, VectorSearchOptions, VectorSearchResult, VectorStore, VectorStoreMeta, assertDimensions, bufferToVector, cosineSimilarity, isUsableVector, vectorToBuffer };

package/dist/vector.js

@@ -1,16 +1,18 @@
 import {
   InMemoryVectorStore
-} from "./chunk-ZFSKQHBT.js";
+} from "./chunk-EDVHBRXG.js";
 import {
   assertDimensions,
   bufferToVector,
   cosineSimilarity,
+  isUsableVector,
   vectorToBuffer
-} from "./chunk-GC4MYP45.js";
+} from "./chunk-BXM3YDOC.js";
 export {
   InMemoryVectorStore,
   assertDimensions,
   bufferToVector,
   cosineSimilarity,
+  isUsableVector,
   vectorToBuffer
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mirk/store",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Code-split storage ports + source adapters under one namespace. KV + collection store and vector similarity store as interface subpaths; the sqlite source-adapter implements both over one connection.",
   "license": "Apache-2.0",