@functional-systems/lambdadb 0.4.3 → 0.5.0-rc.2

package/test/integration/qdrant-compat-external.test.mjs

@@ -1,351 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-
-import { Document as LangChainDocument } from "@langchain/core/documents";
-import { QdrantVectorStore as LangChainQdrantVectorStore } from "@langchain/qdrant";
-import { Settings } from "@llamaindex/core/global";
-import { TextNode } from "@llamaindex/core/schema";
-import { QdrantVectorStore as LlamaIndexQdrantVectorStore } from "@llamaindex/qdrant";
-
-import { QdrantCompatClient } from "../../dist/esm/compat/qdrant.js";
-
-const shouldRun = process.env.LAMBDADB_RUN_EXTERNAL_INTEGRATION_TESTS === "1";
-
-class StaticEmbeddings {
-  async embedDocuments(texts) {
-    return texts.map(vectorForText);
-  }
-
-  async embedQuery(text) {
-    return vectorForText(text);
-  }
-}
-
-class InMemoryDocs {
-  constructor(collection) {
-    this.collection = collection;
-  }
-
-  async upsert(body) {
-    for (const doc of body.docs) {
-      this.collection.docs.set(String(doc.id), doc);
-    }
-    return { message: "ok" };
-  }
-
-  async fetch(body) {
-    return {
-      docs: body.ids
-        .map((id) => this.collection.docs.get(String(id)))
-        .filter(Boolean)
-        .map((doc) => ({ collection: this.collection.name, doc: projectDoc(doc, body.fields) })),
-      total: body.ids.length,
-      took: 0,
-      isDocsInline: true,
-    };
-  }
-
-  async delete(body) {
-    if (body.ids) {
-      for (const id of body.ids) {
-        this.collection.docs.delete(String(id));
-      }
-    }
-    if (body.filter) {
-      for (const [id, doc] of this.collection.docs.entries()) {
-        if (matchesLambdaDBFilter(doc, body.filter)) this.collection.docs.delete(id);
-      }
-    }
-    return { message: "ok" };
-  }
-
-  async list(body = {}) {
-    return {
-      docs: Array.from(this.collection.docs.values())
-        .slice(0, body.size ?? 10)
-        .map((doc) => ({ collection: this.collection.name, doc: projectDoc(doc, body.fields) })),
-      isDocsInline: true,
-      total: this.collection.docs.size,
-    };
-  }
-}
-
-class InMemoryCollection {
-  constructor(owner, name) {
-    this.owner = owner;
-    this.name = name;
-    this.docs = new Map();
-    this.docApi = new InMemoryDocs(this);
-    this.indexConfigs = {};
-  }
-
-  handle() {
-    return {
-      docs: this.docApi,
-      get: async () => ({
-        collection: {
-          collectionName: this.name,
-          indexConfigs: this.indexConfigs,
-          numDocs: this.docs.size,
-          collectionStatus: "ACTIVE",
-        },
-      }),
-      update: async (body) => {
-        this.indexConfigs = body.indexConfigs;
-        return { collection: { collectionName: this.name, indexConfigs: this.indexConfigs } };
-      },
-      delete: async () => {
-        this.owner.collections.delete(this.name);
-        return { message: "ok" };
-      },
-      query: async (body) => {
-        const knn = body.query.knn;
-        const queryVector = knn.queryVector;
-        const docs = Array.from(this.docs.values())
-          .filter((doc) => matchesLambdaDBFilter(doc, knn.filter))
-          .map((doc) => ({
-            collection: this.name,
-            doc: projectDoc(doc, body.fields),
-            score: dot(queryVector, doc[knn.field]),
-          }))
-          .sort((a, b) => b.score - a.score)
-          .slice(0, body.size ?? knn.k ?? 10);
-        return {
-          docs,
-          total: docs.length,
-          took: 0,
-          isDocsInline: true,
-        };
-      },
-    };
-  }
-}
-
-class InMemoryLambdaDB {
-  constructor() {
-    this.collections = new Map();
-  }
-
-  async listCollections() {
-    return {
-      collections: Array.from(this.collections.keys()).map((collectionName) => ({
-        collectionName,
-      })),
-    };
-  }
-
-  async createCollection(body) {
-    const collection = this.ensureCollection(body.collectionName);
-    collection.indexConfigs = body.indexConfigs ?? {};
-    return { collection: { collectionName: body.collectionName } };
-  }
-
-  collection(name) {
-    return this.ensureCollection(name).handle();
-  }
-
-  ensureCollection(name) {
-    if (!this.collections.has(name)) {
-      this.collections.set(name, new InMemoryCollection(this, name));
-    }
-    return this.collections.get(name);
-  }
-}
-
-test("langchain qdrant vector store works with QdrantCompatClient", {
-  skip: shouldRun ? false : "Set LAMBDADB_RUN_EXTERNAL_INTEGRATION_TESTS=1",
-}, async () => {
-  Settings.embedModel = {
-    getTextEmbedding: async (text) => vectorForText(text),
-    getQueryEmbedding: async (text) => vectorForText(text),
-  };
-  const client = new QdrantCompatClient(new InMemoryLambdaDB());
-  const embeddings = new StaticEmbeddings();
-
-  const store = await LangChainQdrantVectorStore.fromDocuments(
-    [
-      new LangChainDocument({
-        pageContent: "alpha",
-        metadata: { tenant: "acme" },
-      }),
-      new LangChainDocument({
-        pageContent: "beta",
-        metadata: { tenant: "acme" },
-      }),
-    ],
-    embeddings,
-    {
-      client,
-      collectionName: "langchain-docs",
-    },
-  );
-
-  const results = await store.similaritySearchVectorWithScore([1, 0, 0], 1);
-
-  assert.equal(results.length, 1);
-  assert.equal(results[0][0].pageContent, "alpha");
-  assert.equal(results[0][0].metadata.tenant, "acme");
-});
-
-test("langchain qdrant vector store supports filter search and delete", {
-  skip: shouldRun ? false : "Set LAMBDADB_RUN_EXTERNAL_INTEGRATION_TESTS=1",
-}, async () => {
-  const client = new QdrantCompatClient(new InMemoryLambdaDB());
-  const embeddings = new StaticEmbeddings();
-
-  const store = await LangChainQdrantVectorStore.fromDocuments(
-    [
-      new LangChainDocument({
-        pageContent: "alpha",
-        metadata: { tenant: "acme", group: "keep" },
-      }),
-      new LangChainDocument({
-        pageContent: "beta",
-        metadata: { tenant: "other", group: "remove" },
-      }),
-    ],
-    embeddings,
-    {
-      client,
-      collectionName: "langchain-filter-docs",
-    },
-  );
-
-  const filteredResults = await store.similaritySearchVectorWithScore([1, 0, 0], 2, {
-    must: [{ key: "content", match: { value: "alpha" } }],
-  });
-
-  assert.equal(filteredResults.length, 1);
-  assert.equal(filteredResults[0][0].pageContent, "alpha");
-
-  await store.delete({
-    filter: {
-      must: [{ key: "content", match: { value: "beta" } }],
-    },
-  });
-
-  const remainingResults = await store.similaritySearchVectorWithScore([0, 1, 0], 2);
-  assert.equal(remainingResults.length, 1);
-  assert.equal(remainingResults[0][0].pageContent, "alpha");
-});
-
-test("llamaindex qdrant vector store works with QdrantCompatClient", {
-  skip: shouldRun ? false : "Set LAMBDADB_RUN_EXTERNAL_INTEGRATION_TESTS=1",
-}, async () => {
-  const client = new QdrantCompatClient(new InMemoryLambdaDB());
-  const store = new LlamaIndexQdrantVectorStore({
-    client,
-    collectionName: "llamaindex-docs",
-  });
-
-  const alpha = new TextNode({
-    text: "alpha",
-    metadata: { tenant: "acme" },
-  });
-  alpha.id_ = "alpha";
-  alpha.embedding = [1, 0, 0];
-
-  const beta = new TextNode({
-    text: "beta",
-    metadata: { tenant: "acme" },
-  });
-  beta.id_ = "beta";
-  beta.embedding = [0, 1, 0];
-
-  const ids = await store.add([alpha, beta]);
-  assert.deepEqual(ids, ["alpha", "beta"]);
-
-  const results = await store.query({
-    queryEmbedding: [1, 0, 0],
-    similarityTopK: 1,
-  });
-
-  assert.equal(results.ids[0], "alpha");
-  assert.equal(results.nodes[0].getContent(), "alpha");
-});
-
-test("llamaindex qdrant vector store supports delete by filter", {
-  skip: shouldRun ? false : "Set LAMBDADB_RUN_EXTERNAL_INTEGRATION_TESTS=1",
-}, async () => {
-  const client = new QdrantCompatClient(new InMemoryLambdaDB());
-  const store = new LlamaIndexQdrantVectorStore({
-    client,
-    collectionName: "llamaindex-delete-docs",
-  });
-
-  const alpha = new TextNode({
-    text: "alpha",
-    metadata: { tenant: "acme" },
-    relationships: { SOURCE: { nodeId: "alpha-ref" } },
-  });
-  alpha.id_ = "alpha";
-  alpha.embedding = [1, 0, 0];
-
-  const beta = new TextNode({
-    text: "beta",
-    metadata: { tenant: "acme" },
-    relationships: { SOURCE: { nodeId: "beta-ref" } },
-  });
-  beta.id_ = "beta";
-  beta.embedding = [0, 1, 0];
-
-  await store.add([alpha, beta]);
-  await store.delete("alpha-ref");
-
-  const results = await store.query({
-    queryEmbedding: [1, 0, 0],
-    similarityTopK: 2,
-  });
-
-  assert.deepEqual(results.ids, ["beta"]);
-});
-
-function vectorForText(text) {
-  if (text.includes("alpha")) return [1, 0, 0];
-  if (text.includes("beta")) return [0, 1, 0];
-  return [0, 0, 1];
-}
-
-function dot(left, right) {
-  if (!Array.isArray(left) || !Array.isArray(right)) return 0;
-  return left.reduce((sum, value, index) => sum + value * (right[index] ?? 0), 0);
-}
-
-function projectDoc(doc, fields) {
-  const include = fields?.include;
-  if (!Array.isArray(include)) return doc;
-  const projected = { id: doc.id };
-  for (const field of include) {
-    if (field in doc) projected[field] = doc[field];
-  }
-  return projected;
-}
-
-function matchesLambdaDBFilter(doc, filter) {
-  if (!filter || Object.keys(filter).length === 0) return true;
-  if (filter.queryString) return matchesQueryString(doc, filter.queryString.query);
-  if (Array.isArray(filter.bool)) return matchesBoolClauses(doc, filter.bool);
-  if (filter.bool?.clauses) return matchesBoolClauses(doc, filter.bool.clauses);
-  return true;
-}
-
-function matchesBoolClauses(doc, clauses) {
-  const shouldClauses = [];
-  for (const clause of clauses) {
-    const matched = matchesLambdaDBFilter(doc, clause);
-    if (clause.occur === "must_not") {
-      if (matched) return false;
-    } else if (clause.occur === "should") {
-      shouldClauses.push(matched);
-    } else if (!matched) {
-      return false;
-    }
-  }
-  return shouldClauses.length === 0 || shouldClauses.some(Boolean);
-}
-
-function matchesQueryString(doc, query) {
-  const [field, ...rest] = String(query).split(":");
-  const expected = rest.join(":");
-  return String(doc[field]) === expected;
-}

package/test/integration/qdrant-compat-live.test.mjs

@@ -1,122 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-
-import {
-  QdrantCompatClient,
-  UnsupportedQdrantFeatureError,
-  models,
-} from "../../dist/esm/compat/qdrant.js";
-
-const shouldRun = process.env.LAMBDADB_RUN_LIVE_TESTS === "1";
-const projectApiKey = process.env.LAMBDADB_PROJECT_API_KEY;
-const projectName = process.env.LAMBDADB_PROJECT_NAME || "playground";
-const baseUrl = process.env.LAMBDADB_BASE_URL || "https://api.lambdadb.ai";
-
-test("qdrant compatibility live smoke", {
-  skip: shouldRun && projectApiKey
-    ? false
-    : "Set LAMBDADB_RUN_LIVE_TESTS=1 and LAMBDADB_PROJECT_API_KEY to run live tests",
-}, async () => {
-  const client = new QdrantCompatClient({
-    projectApiKey,
-    projectName,
-    baseUrl,
-  });
-  const collectionName = `qdrant-live-${Date.now()}`;
-
-  try {
-    await client.createCollection(collectionName, {
-      vectorsConfig: new models.VectorParams({
-        size: 3,
-        distance: models.Distance.COSINE,
-      }),
-      payloadSchema: {
-        tenant: models.PayloadSchemaType.KEYWORD,
-      },
-    });
-
-    assert.equal(await client.collectionExists(collectionName), true);
-
-    const upsertResult = await client.upsert(collectionName, {
-      points: [
-        new models.PointStruct({
-          id: 1,
-          vector: [1.0, 0.0, 0.0],
-          payload: { tenant: "acme", title: "alpha" },
-        }),
-        new models.PointStruct({
-          id: 2,
-          vector: [0.0, 1.0, 0.0],
-          payload: { tenant: "acme", title: "beta" },
-        }),
-        new models.PointStruct({
-          id: 3,
-          vector: [0.0, 0.0, 1.0],
-          payload: { tenant: "other", title: "gamma" },
-        }),
-      ],
-    });
-    assert.equal(upsertResult.status, models.UpdateStatus.COMPLETED);
-
-    const queryResult = await client.queryPoints(collectionName, {
-      query: [1.0, 0.0, 0.0],
-      queryFilter: new models.Filter({
-        must: [
-          new models.FieldCondition({
-            key: "tenant",
-            match: new models.MatchValue({ value: "acme" }),
-          }),
-        ],
-      }),
-      limit: 2,
-    });
-    assert.ok(queryResult.points.length > 0);
-    assert.equal(queryResult.points[0].payload?.tenant, "acme");
-
-    const records = await client.retrieve(collectionName, { ids: [1] });
-    assert.equal(records[0]?.id, 1);
-    assert.equal(records[0]?.payload?.tenant, "acme");
-
-    const deleteResult = await client.delete(collectionName, {
-      pointsSelector: [1],
-    });
-    assert.equal(deleteResult.status, models.UpdateStatus.COMPLETED);
-
-    const deleteByFilterResult = await client.delete(collectionName, {
-      pointsSelector: {
-        filter: new models.Filter({
-          must: [
-            new models.FieldCondition({
-              key: "tenant",
-              match: new models.MatchValue({ value: "other" }),
-            }),
-          ],
-        }),
-      },
-    });
-    assert.equal(deleteByFilterResult.status, models.UpdateStatus.COMPLETED);
-
-    const deletedByFilterRecords = await client.retrieve(collectionName, { ids: [3] });
-    assert.equal(deletedByFilterRecords.length, 0);
-
-    await assert.rejects(
-      client.scroll(collectionName, {
-        scrollFilter: new models.Filter({
-          must: [
-            new models.FieldCondition({
-              key: "tenant",
-              match: new models.MatchValue({ value: "acme" }),
-            }),
-          ],
-        }),
-      }),
-      UnsupportedQdrantFeatureError,
-    );
-  } finally {
-    try {
-      await client.deleteCollection(collectionName);
-    } catch (error) {
-      if (error?.name !== "ResourceNotFoundError") throw error;
-    }
-  }
-});

package/test/null-response.test.mjs

@@ -1,73 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-
-import { LambdaDBClient } from "../dist/esm/index.js";
-import { HTTPClient } from "../dist/esm/lib/http.js";
-import { ResponseValidationError } from "../dist/esm/models/errors/responsevalidationerror.js";
-import { QueryCollectionResponse$inboundSchema } from "../dist/esm/models/operations/querycollection.js";
-
-function jsonResponse(body, init = {}) {
-  return new Response(JSON.stringify(body), {
-    status: 200,
-    headers: { "content-type": "application/json" },
-    ...init,
-  });
-}
-
-test("response schemas accept null for optional response fields", () => {
-  const parsed = QueryCollectionResponse$inboundSchema.parse({
-    took: 1,
-    maxScore: null,
-    total: 1,
-    docs: [{ collection: "items", score: null, doc: { id: "a" } }],
-    isDocsInline: false,
-    docsUrl: null,
-  });
-
-  assert.equal(parsed.maxScore, undefined);
-  assert.equal(parsed.docsUrl, undefined);
-  assert.equal(parsed.docs[0].score, undefined);
-});
-
-test("safe methods return ResponseValidationError for invalid JSON bodies", async () => {
-  const httpClient = new HTTPClient({
-    fetcher: async () =>
-      new Response("{", {
-        status: 200,
-        headers: { "content-type": "application/json" },
-      }),
-  });
-  const client = new LambdaDBClient({ httpClient, projectApiKey: "test-key" });
-
-  const result = await client.listCollectionsSafe();
-
-  assert.equal(result.ok, false);
-  assert.ok(result.error instanceof ResponseValidationError);
-  assert.equal(result.error.rawValue, "{");
-});
-
-test("docsUrl fetches treat null document payloads as an empty docs array", async () => {
-  const originalFetch = globalThis.fetch;
-  globalThis.fetch = async () => jsonResponse(null);
-
-  try {
-    const httpClient = new HTTPClient({
-      fetcher: async () =>
-        jsonResponse({
-          total: 1,
-          docs: [],
-          isDocsInline: false,
-          docsUrl: "https://example.test/docs.json",
-        }),
-    });
-    const client = new LambdaDBClient({ httpClient, projectApiKey: "test-key" });
-
-    const result = await client.collection("items").docs.listSafe();
-
-    assert.equal(result.ok, true);
-    assert.deepEqual(result.value.docs, []);
-    assert.equal(result.value.isDocsInline, true);
-  } finally {
-    globalThis.fetch = originalFetch;
-  }
-});