@vectororm/adapter-turbopuffer 0.1.0

package/README.md

@@ -0,0 +1,134 @@
+# @vectororm/adapter-turbopuffer
+
+[![npm](https://img.shields.io/npm/v/@vectororm/adapter-turbopuffer)](https://www.npmjs.com/package/@vectororm/adapter-turbopuffer)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+[Turbopuffer](https://turbopuffer.com/) adapter for [Glyph VectorORM](https://github.com/aviramroi/VectorORM).
+
+## Installation
+
+```bash
+npm install @vectororm/adapter-turbopuffer @vectororm/core
+```
+
+## Usage
+
+```typescript
+import { TurbopufferAdapter } from '@vectororm/adapter-turbopuffer';
+
+// Create adapter
+const adapter = new TurbopufferAdapter({
+  apiKey: process.env.TURBOPUFFER_API_KEY || 'your-api-key',
+  // Optional: custom base URL
+  baseUrl: 'https://api.turbopuffer.com',
+});
+
+// Connect
+await adapter.connect();
+
+// Create a collection (namespace)
+await adapter.createCollection('my-vectors', 128, 'cosine');
+
+// Upsert vectors
+await adapter.upsert('my-vectors', [
+  {
+    id: 'vec1',
+    embedding: [0.1, 0.2, ...],
+    metadata: { title: 'Document 1', category: 'tech' }
+  }
+]);
+
+// Search
+const results = await adapter.search('my-vectors', queryVector, {
+  topK: 10,
+  filter: { field: 'category', op: 'eq', value: 'tech' }
+});
+
+// Disconnect
+await adapter.disconnect();
+```
+
+## Configuration
+
+### TurbopufferConfig
+
+- `apiKey` (required): Your Turbopuffer API key
+- `baseUrl` (optional): Custom API base URL (defaults to `https://api.turbopuffer.com`)
+
+## Features
+
+- Full CRUD operations on vectors
+- Metadata filtering with compound AND/OR filters
+- Vector similarity search
+- Metadata updates
+- Batch operations
+- Async iteration over collections
+- Multiple distance metrics (cosine, euclidean)
+
+## Supported Operations
+
+### Connection Management
+- `connect()` - Establish connection to Turbopuffer
+- `disconnect()` - Close connection
+- `isConnected()` - Check connection status
+
+### Collection Management
+- `createCollection(name, dimension, metric)` - Create namespace
+- `deleteCollection(name)` - Delete namespace
+- `collectionExists(name)` - Check if namespace exists
+- `getCollectionStats(name)` - Get vector count and stats
+
+### Vector Operations
+- `upsert(collection, records)` - Insert or update vectors
+- `fetch(collection, ids)` - Fetch vectors by IDs
+- `delete(collection, ids)` - Delete vectors by IDs
+- `search(collection, queryVector, options)` - Vector similarity search
+- `updateMetadata(collection, updates)` - Update vector metadata
+- `iterate(collection, options)` - Async iteration over vectors
+
+### Filter Translation
+- Converts UniversalFilter to Turbopuffer filter format
+- Supports: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`
+- Supports compound `and`/`or` filters
+- Supports nested filter combinations
+
+## Implementation Notes
+
+### REST API
+This adapter uses Turbopuffer's REST API directly with `fetch` (no SDK dependency) to avoid Node.js version constraints. The implementation is compatible with Node.js 18+.
+
+### Namespaces
+Turbopuffer uses "namespaces" instead of "collections". This adapter transparently maps collection operations to namespace operations.
+
+### Distance Metrics
+- `cosine` → `cosine_distance`
+- `euclidean` → `euclidean_squared`
+
+### Pagination
+Turbopuffer uses attribute-based pagination. The `iterate()` method paginates by ID using greater-than filters.
+
+### Fetch Operation
+Turbopuffer doesn't have a direct fetch-by-ID endpoint. The adapter uses filtered queries to implement this functionality.
+
+## Limitations
+
+See [TECH_DEBT.md](./TECH_DEBT.md) for known limitations and future enhancements.
+
+## Testing
+
+```bash
+# Run unit tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## Documentation
+
+- [API Guide](https://github.com/aviramroi/VectorORM/blob/main/docs/guide.md)
+- [Full Project](https://github.com/aviramroi/VectorORM)
+
+## License
+
+Apache-2.0

package/dist/index.cjs

@@ -0,0 +1,427 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TurbopufferAdapter: () => TurbopufferAdapter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/turbopuffer-adapter.ts
+var import_core = require("@vectororm/core");
+var TurbopufferAdapter = class extends import_core.VectorDBAdapter {
+  config;
+  baseUrl;
+  connected = false;
+  namespaceMetrics = /* @__PURE__ */ new Map();
+  constructor(config) {
+    super();
+    if (!config.apiKey) {
+      throw new Error(
+        "TurbopufferAdapter: apiKey is required in config or TURBOPUFFER_API_KEY environment variable"
+      );
+    }
+    this.config = config;
+    this.baseUrl = config.baseUrl || "https://api.turbopuffer.com";
+  }
+  // ============================================================================
+  // HTTP HELPERS
+  // ============================================================================
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Authorization": `Bearer ${this.config.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      let errorMessage = `Turbopuffer API error: ${response.status} ${response.statusText}`;
+      try {
+        const errorData = JSON.parse(errorText);
+        if (errorData.error) {
+          errorMessage += ` - ${errorData.error}`;
+        }
+      } catch {
+        if (errorText) {
+          errorMessage += ` - ${errorText}`;
+        }
+      }
+      throw new Error(errorMessage);
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : null;
+  }
+  // ============================================================================
+  // CONNECTION MANAGEMENT
+  // ============================================================================
+  async connect() {
+    try {
+      await this.request("GET", "/v2/namespaces");
+      this.connected = true;
+    } catch (error) {
+      throw new Error(
+        `Turbopuffer connection failed: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async disconnect() {
+    this.connected = false;
+    this.namespaceMetrics.clear();
+  }
+  async isConnected() {
+    return this.connected;
+  }
+  // ============================================================================
+  // COLLECTION MANAGEMENT
+  // ============================================================================
+  async createCollection(name, dimension, metric = "cosine") {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const distanceMetric = metric === "euclidean" ? "euclidean_squared" : "cosine_distance";
+      this.namespaceMetrics.set(name, { dimension, metric });
+      await this.request("POST", `/v2/namespaces/${name}`, {
+        upsert_rows: [{
+          id: "__init__",
+          vector: new Array(dimension).fill(0),
+          attributes: { __init__: true }
+        }],
+        distance_metric: distanceMetric
+      });
+      await this.request("POST", `/v2/namespaces/${name}`, {
+        deletes: ["__init__"]
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to create Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async deleteCollection(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.request("DELETE", `/v2/namespaces/${name}`);
+      this.namespaceMetrics.delete(name);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async collectionExists(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const response = await this.request("GET", "/v2/namespaces");
+      const namespaces = response.namespaces || [];
+      return namespaces.some((ns) => ns.name === name);
+    } catch (error) {
+      throw new Error(
+        `Failed to check if Turbopuffer namespace ${name} exists: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async getCollectionStats(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const result = await this.request("POST", `/v2/namespaces/${name}/query`, {
+        top_k: 0,
+        aggregate_by: { Count: "*" }
+      });
+      const vectorCount = result.aggregations?.Count ?? 0;
+      let dimension = this.namespaceMetrics.get(name)?.dimension ?? 0;
+      let metric = this.namespaceMetrics.get(name)?.metric ?? "cosine";
+      if (dimension === 0 && vectorCount > 0) {
+        const sample = await this.request("POST", `/v2/namespaces/${name}/query`, {
+          top_k: 1,
+          include_vectors: true
+        });
+        if (sample.rows && sample.rows.length > 0) {
+          dimension = sample.rows[0].vector?.length ?? 0;
+        }
+      }
+      return {
+        vectorCount: typeof vectorCount === "number" ? vectorCount : 0,
+        dimension,
+        metric
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to get Turbopuffer namespace stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // VECTOR OPERATIONS
+  // ============================================================================
+  async upsert(collection, records) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const storedMetric = this.namespaceMetrics.get(collection);
+      const distanceMetric = storedMetric?.metric === "euclidean" ? "euclidean_squared" : "cosine_distance";
+      const rows = records.map((record) => ({
+        id: record.id,
+        vector: record.embedding,
+        ...record.metadata
+      }));
+      await this.request("POST", `/v2/namespaces/${collection}`, {
+        upsert_rows: rows,
+        distance_metric: distanceMetric
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to upsert vectors to Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async fetch(collection, ids) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const results = [];
+      if (ids.length > 0) {
+        const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+          top_k: ids.length,
+          filters: ["id", "In", ids],
+          include_vectors: true
+        });
+        if (result.rows) {
+          for (const row of result.rows) {
+            const { id, vector, ...metadata } = row;
+            results.push({
+              id: String(id),
+              embedding: vector || [],
+              metadata
+            });
+          }
+        }
+      }
+      return results;
+    } catch (error) {
+      throw new Error(
+        `Failed to fetch vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async delete(collection, ids) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.request("POST", `/v2/namespaces/${collection}`, {
+        deletes: ids
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to delete vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // METADATA OPERATIONS
+  // ============================================================================
+  async updateMetadata(collection, updates) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      for (const update of updates) {
+        const existing = await this.fetch(collection, [update.id]);
+        if (existing.length === 0) {
+          throw new Error(`Vector ${update.id} not found for metadata update`);
+        }
+        const merged = { ...existing[0].metadata, ...update.metadata };
+        await this.request("POST", `/v2/namespaces/${collection}`, {
+          upsert_rows: [{
+            id: update.id,
+            vector: existing[0].embedding,
+            ...merged
+          }]
+        });
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to update metadata in Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // SEARCH OPERATIONS
+  // ============================================================================
+  async search(collection, queryVector, options) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const turbopufferFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+        rank_by: ["vector", "ANN", queryVector],
+        top_k: options?.topK || 10,
+        filters: turbopufferFilter,
+        include_vectors: options?.includeValues || false
+      });
+      const records = [];
+      if (result.rows) {
+        for (const row of result.rows) {
+          const { id, vector, $dist, ...metadata } = row;
+          const record = {
+            id: String(id),
+            embedding: options?.includeValues ? vector || [] : [],
+            metadata: options?.includeMetadata !== false ? metadata : {},
+            score: $dist !== void 0 ? 1 / (1 + $dist) : void 0
+          };
+          records.push(record);
+        }
+      }
+      return { records };
+    } catch (error) {
+      throw new Error(
+        `Failed to search Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // FILTER TRANSLATION
+  // ============================================================================
+  translateFilter(filter) {
+    if ("and" in filter) {
+      const conditions = filter.and;
+      const translated = conditions.map((c) => this.translateFilter(c));
+      return ["And", translated];
+    }
+    if ("or" in filter) {
+      const conditions = filter.or;
+      const translated = conditions.map((c) => this.translateFilter(c));
+      return ["Or", translated];
+    }
+    const { field, op, value } = filter;
+    const operatorMap = {
+      eq: "Eq",
+      ne: "Neq",
+      gt: "Gt",
+      gte: "Gte",
+      lt: "Lt",
+      lte: "Lte",
+      in: "In",
+      nin: "Nin"
+    };
+    const turbopufferOp = operatorMap[op];
+    if (!turbopufferOp) {
+      throw new Error(
+        `Unsupported filter operator: ${op}`,
+        { cause: { filter } }
+      );
+    }
+    return [field, turbopufferOp, value];
+  }
+  // ============================================================================
+  // ITERATION
+  // ============================================================================
+  async *iterate(collection, options) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const batchSize = options?.batchSize || 100;
+      const turbopufferFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      let lastId = null;
+      let hasMore = true;
+      while (hasMore) {
+        let filters = turbopufferFilter;
+        if (lastId !== null) {
+          const paginationFilter = ["id", "Gt", lastId];
+          if (filters) {
+            filters = ["And", [filters, paginationFilter]];
+          } else {
+            filters = paginationFilter;
+          }
+        }
+        const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+          top_k: batchSize,
+          filters,
+          include_vectors: true,
+          rank_by: ["id", "Asc"]
+        });
+        if (result.rows && result.rows.length > 0) {
+          const records = [];
+          for (const row of result.rows) {
+            const { id, vector, ...metadata } = row;
+            records.push({
+              id: String(id),
+              embedding: vector || [],
+              metadata
+            });
+            lastId = String(id);
+          }
+          yield records;
+          hasMore = result.rows.length === batchSize;
+        } else {
+          hasMore = false;
+        }
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to iterate Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // CAPABILITY FLAGS
+  // ============================================================================
+  supportsMetadataUpdate() {
+    return true;
+  }
+  supportsFiltering() {
+    return true;
+  }
+  supportsBatchOperations() {
+    return true;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TurbopufferAdapter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/turbopuffer-adapter.ts"],"sourcesContent":["// Turbopuffer adapter exports\nexport { TurbopufferAdapter } from './turbopuffer-adapter';\nexport type { TurbopufferConfig } from './types';\n","import {\n  VectorDBAdapter,\n  type VectorRecord,\n  type SearchResult,\n  type UniversalFilter,\n  type CollectionStats,\n  type MetadataUpdate,\n  type DistanceMetric,\n} from '@vectororm/core';\nimport type { TurbopufferConfig } from './types.js';\n\n/**\n * TurbopufferAdapter implements VectorDBAdapter for Turbopuffer vector database.\n *\n * Uses REST API with fetch (no SDK dependency to avoid Node version constraints).\n * Supports all VectorORM features including CRUD operations, filtering,\n * and metadata updates.\n */\nexport class TurbopufferAdapter extends VectorDBAdapter {\n  private config: TurbopufferConfig;\n  private baseUrl: string;\n  private connected: boolean = false;\n  private namespaceMetrics: Map<string, { dimension: number; metric: DistanceMetric }> = new Map();\n\n  constructor(config: TurbopufferConfig) {\n    super();\n\n    // Validate required config\n    if (!config.apiKey) {\n      throw new Error(\n        'TurbopufferAdapter: apiKey is required in config or TURBOPUFFER_API_KEY environment variable'\n      );\n    }\n\n    this.config = config;\n    this.baseUrl = config.baseUrl || 'https://api.turbopuffer.com';\n  }\n\n  // ============================================================================\n  // HTTP HELPERS\n  // ============================================================================\n\n  private async request(\n    method: string,\n    path: string,\n    body?: any\n  ): Promise<any> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      'Authorization': `Bearer ${this.config.apiKey}`,\n      'Content-Type': 'application/json',\n    };\n\n    const response = await fetch(url, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      let errorMessage = `Turbopuffer API error: ${response.status} ${response.statusText}`;\n\n      try {\n        const errorData = JSON.parse(errorText);\n        if (errorData.error) {\n          errorMessage += ` - ${errorData.error}`;\n        }\n      } catch {\n        if (errorText) {\n          errorMessage += ` - ${errorText}`;\n        }\n      }\n\n      throw new Error(errorMessage);\n    }\n\n    const text = await response.text();\n    return text ? JSON.parse(text) : null;\n  }\n\n  // ============================================================================\n  // CONNECTION MANAGEMENT\n  // ============================================================================\n\n  async connect(): Promise<void> {\n    try {\n      // Verify connection by listing namespaces\n      await this.request('GET', '/v2/namespaces');\n      this.connected = true;\n    } catch (error) {\n      throw new Error(\n        `Turbopuffer connection failed: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false;\n    this.namespaceMetrics.clear();\n  }\n\n  async isConnected(): Promise<boolean> {\n    return this.connected;\n  }\n\n  // ============================================================================\n  // COLLECTION MANAGEMENT\n  // ============================================================================\n\n  async createCollection(\n    name: string,\n    dimension: number,\n    metric: DistanceMetric = 'cosine'\n  ): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer creates namespaces implicitly on first upsert\n      // We'll store metadata locally and create with a dummy vector\n      const distanceMetric = metric === 'euclidean' ? 'euclidean_squared' : 'cosine_distance';\n\n      // Store metrics for later use\n      this.namespaceMetrics.set(name, { dimension, metric });\n\n      // Create namespace with initial dummy vector to set schema\n      await this.request('POST', `/v2/namespaces/${name}`, {\n        upsert_rows: [{\n          id: '__init__',\n          vector: new Array(dimension).fill(0),\n          attributes: { __init__: true }\n        }],\n        distance_metric: distanceMetric,\n      });\n\n      // Delete the initialization vector\n      await this.request('POST', `/v2/namespaces/${name}`, {\n        deletes: ['__init__'],\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to create Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async deleteCollection(name: string): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.request('DELETE', `/v2/namespaces/${name}`);\n      this.namespaceMetrics.delete(name);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async collectionExists(name: string): Promise<boolean> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const response = await this.request('GET', '/v2/namespaces');\n      const namespaces = response.namespaces || [];\n      return namespaces.some((ns: any) => ns.name === name);\n    } catch (error) {\n      throw new Error(\n        `Failed to check if Turbopuffer namespace ${name} exists: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async getCollectionStats(name: string): Promise<CollectionStats> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Use query with limit 0 to get aggregation stats\n      const result = await this.request('POST', `/v2/namespaces/${name}/query`, {\n        top_k: 0,\n        aggregate_by: { Count: '*' },\n      });\n\n      const vectorCount = result.aggregations?.Count ?? 0;\n\n      // Get dimension from stored metrics or estimate from a sample vector\n      let dimension = this.namespaceMetrics.get(name)?.dimension ?? 0;\n      let metric = this.namespaceMetrics.get(name)?.metric ?? 'cosine';\n\n      if (dimension === 0 && vectorCount > 0) {\n        // Query one vector to get dimension\n        const sample = await this.request('POST', `/v2/namespaces/${name}/query`, {\n          top_k: 1,\n          include_vectors: true,\n        });\n\n        if (sample.rows && sample.rows.length > 0) {\n          dimension = sample.rows[0].vector?.length ?? 0;\n        }\n      }\n\n      return {\n        vectorCount: typeof vectorCount === 'number' ? vectorCount : 0,\n        dimension,\n        metric,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get Turbopuffer namespace stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // VECTOR OPERATIONS\n  // ============================================================================\n\n  async upsert(collection: string, records: VectorRecord[]): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Get or infer distance metric\n      const storedMetric = this.namespaceMetrics.get(collection);\n      const distanceMetric = storedMetric?.metric === 'euclidean'\n        ? 'euclidean_squared'\n        : 'cosine_distance';\n\n      // Convert VectorRecord[] to Turbopuffer format\n      const rows = records.map((record) => ({\n        id: record.id,\n        vector: record.embedding,\n        ...record.metadata,\n      }));\n\n      await this.request('POST', `/v2/namespaces/${collection}`, {\n        upsert_rows: rows,\n        distance_metric: distanceMetric,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to upsert vectors to Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async fetch(collection: string, ids: string[]): Promise<VectorRecord[]> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer doesn't have a direct fetch by IDs\n      // We need to use query with filters for each ID\n      const results: VectorRecord[] = [];\n\n      // Query with In filter for multiple IDs\n      if (ids.length > 0) {\n        const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n          top_k: ids.length,\n          filters: ['id', 'In', ids],\n          include_vectors: true,\n        });\n\n        if (result.rows) {\n          for (const row of result.rows) {\n            const { id, vector, ...metadata } = row;\n            results.push({\n              id: String(id),\n              embedding: vector || [],\n              metadata,\n            });\n          }\n        }\n      }\n\n      return results;\n    } catch (error) {\n      throw new Error(\n        `Failed to fetch vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async delete(collection: string, ids: string[]): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.request('POST', `/v2/namespaces/${collection}`, {\n        deletes: ids,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to delete vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // METADATA OPERATIONS\n  // ============================================================================\n\n  async updateMetadata(\n    collection: string,\n    updates: MetadataUpdate[]\n  ): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer supports patch operations\n      // We'll fetch existing records and patch them\n      for (const update of updates) {\n        // Fetch the existing record\n        const existing = await this.fetch(collection, [update.id]);\n\n        if (existing.length === 0) {\n          throw new Error(`Vector ${update.id} not found for metadata update`);\n        }\n\n        // Merge metadata\n        const merged = { ...existing[0].metadata, ...update.metadata };\n\n        // Upsert with updated metadata\n        await this.request('POST', `/v2/namespaces/${collection}`, {\n          upsert_rows: [{\n            id: update.id,\n            vector: existing[0].embedding,\n            ...merged,\n          }],\n        });\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to update metadata in Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // SEARCH OPERATIONS\n  // ============================================================================\n\n  async search(\n    collection: string,\n    queryVector: number[],\n    options?: {\n      topK?: number;\n      filter?: UniversalFilter;\n      includeMetadata?: boolean;\n      includeValues?: boolean;\n    }\n  ): Promise<SearchResult> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const turbopufferFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n        rank_by: ['vector', 'ANN', queryVector],\n        top_k: options?.topK || 10,\n        filters: turbopufferFilter,\n        include_vectors: options?.includeValues || false,\n      });\n\n      const records: VectorRecord[] = [];\n\n      if (result.rows) {\n        for (const row of result.rows) {\n          const { id, vector, $dist, ...metadata } = row;\n          const record: VectorRecord = {\n            id: String(id),\n            embedding: options?.includeValues ? (vector || []) : [],\n            metadata: options?.includeMetadata !== false ? metadata : {},\n            score: $dist !== undefined ? (1 / (1 + $dist)) : undefined,\n          };\n\n          records.push(record);\n        }\n      }\n\n      return { records };\n    } catch (error) {\n      throw new Error(\n        `Failed to search Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // FILTER TRANSLATION\n  // ============================================================================\n\n  translateFilter(filter: UniversalFilter): any {\n    // Handle compound AND filter\n    if ('and' in filter) {\n      const conditions = filter.and;\n\n      // Convert all conditions\n      const translated = conditions.map((c) => this.translateFilter(c));\n\n      return ['And', translated];\n    }\n\n    // Handle compound OR filter\n    if ('or' in filter) {\n      const conditions = filter.or;\n\n      const translated = conditions.map((c) => this.translateFilter(c));\n\n      return ['Or', translated];\n    }\n\n    // Handle basic filter condition\n    const { field, op, value } = filter as any;\n\n    // Operator mapping\n    const operatorMap: Record<string, string> = {\n      eq: 'Eq',\n      ne: 'Neq',\n      gt: 'Gt',\n      gte: 'Gte',\n      lt: 'Lt',\n      lte: 'Lte',\n      in: 'In',\n      nin: 'Nin',\n    };\n\n    const turbopufferOp = operatorMap[op];\n    if (!turbopufferOp) {\n      throw new Error(\n        `Unsupported filter operator: ${op}`,\n        { cause: { filter } }\n      );\n    }\n\n    return [field, turbopufferOp, value];\n  }\n\n  // ============================================================================\n  // ITERATION\n  // ============================================================================\n\n  async *iterate(\n    collection: string,\n    options?: {\n      batchSize?: number;\n      filter?: UniversalFilter;\n    }\n  ): AsyncIterableIterator<VectorRecord[]> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const batchSize = options?.batchSize || 100;\n\n      const turbopufferFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      // Turbopuffer uses attribute-based pagination\n      // We'll paginate by ID using greater-than filters\n      let lastId: string | null = null;\n      let hasMore = true;\n\n      while (hasMore) {\n        // Build filters for pagination\n        let filters = turbopufferFilter;\n\n        if (lastId !== null) {\n          const paginationFilter = ['id', 'Gt', lastId];\n\n          if (filters) {\n            // Combine with existing filters\n            filters = ['And', [filters, paginationFilter]];\n          } else {\n            filters = paginationFilter;\n          }\n        }\n\n        const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n          top_k: batchSize,\n          filters,\n          include_vectors: true,\n          rank_by: ['id', 'Asc'],\n        });\n\n        if (result.rows && result.rows.length > 0) {\n          const records: VectorRecord[] = [];\n\n          for (const row of result.rows) {\n            const { id, vector, ...metadata } = row;\n            records.push({\n              id: String(id),\n              embedding: vector || [],\n              metadata,\n            });\n\n            lastId = String(id);\n          }\n\n          yield records;\n\n          // Check if we got fewer records than requested\n          hasMore = result.rows.length === batchSize;\n        } else {\n          hasMore = false;\n        }\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to iterate Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // CAPABILITY FLAGS\n  // ============================================================================\n\n  supportsMetadataUpdate(): boolean {\n    return true; // Turbopuffer supports metadata updates via upsert\n  }\n\n  supportsFiltering(): boolean {\n    return true; // Turbopuffer supports metadata filtering\n  }\n\n  supportsBatchOperations(): boolean {\n    return true; // Turbopuffer supports batch operations\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import { VectorDBAdapter, DistanceMetric, CollectionStats, VectorRecord, MetadataUpdate, UniversalFilter, SearchResult } from '@vectororm/core';
+
+/**
+ * Configuration for TurbopufferAdapter.
+ *
+ * Supports hybrid config: explicit values or environment variables.
+ */
+interface TurbopufferConfig {
+    /**
+     * Turbopuffer API key.
+     * Falls back to TURBOPUFFER_API_KEY environment variable.
+     */
+    apiKey: string;
+    /**
+     * Base URL for Turbopuffer API (optional).
+     * Defaults to https://api.turbopuffer.com
+     * Falls back to TURBOPUFFER_BASE_URL environment variable.
+     */
+    baseUrl?: string;
+}
+
+/**
+ * TurbopufferAdapter implements VectorDBAdapter for Turbopuffer vector database.
+ *
+ * Uses REST API with fetch (no SDK dependency to avoid Node version constraints).
+ * Supports all VectorORM features including CRUD operations, filtering,
+ * and metadata updates.
+ */
+declare class TurbopufferAdapter extends VectorDBAdapter {
+    private config;
+    private baseUrl;
+    private connected;
+    private namespaceMetrics;
+    constructor(config: TurbopufferConfig);
+    private request;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): Promise<boolean>;
+    createCollection(name: string, dimension: number, metric?: DistanceMetric): Promise<void>;
+    deleteCollection(name: string): Promise<void>;
+    collectionExists(name: string): Promise<boolean>;
+    getCollectionStats(name: string): Promise<CollectionStats>;
+    upsert(collection: string, records: VectorRecord[]): Promise<void>;
+    fetch(collection: string, ids: string[]): Promise<VectorRecord[]>;
+    delete(collection: string, ids: string[]): Promise<void>;
+    updateMetadata(collection: string, updates: MetadataUpdate[]): Promise<void>;
+    search(collection: string, queryVector: number[], options?: {
+        topK?: number;
+        filter?: UniversalFilter;
+        includeMetadata?: boolean;
+        includeValues?: boolean;
+    }): Promise<SearchResult>;
+    translateFilter(filter: UniversalFilter): any;
+    iterate(collection: string, options?: {
+        batchSize?: number;
+        filter?: UniversalFilter;
+    }): AsyncIterableIterator<VectorRecord[]>;
+    supportsMetadataUpdate(): boolean;
+    supportsFiltering(): boolean;
+    supportsBatchOperations(): boolean;
+}
+
+export { TurbopufferAdapter, type TurbopufferConfig };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { VectorDBAdapter, DistanceMetric, CollectionStats, VectorRecord, MetadataUpdate, UniversalFilter, SearchResult } from '@vectororm/core';
+
+/**
+ * Configuration for TurbopufferAdapter.
+ *
+ * Supports hybrid config: explicit values or environment variables.
+ */
+interface TurbopufferConfig {
+    /**
+     * Turbopuffer API key.
+     * Falls back to TURBOPUFFER_API_KEY environment variable.
+     */
+    apiKey: string;
+    /**
+     * Base URL for Turbopuffer API (optional).
+     * Defaults to https://api.turbopuffer.com
+     * Falls back to TURBOPUFFER_BASE_URL environment variable.
+     */
+    baseUrl?: string;
+}
+
+/**
+ * TurbopufferAdapter implements VectorDBAdapter for Turbopuffer vector database.
+ *
+ * Uses REST API with fetch (no SDK dependency to avoid Node version constraints).
+ * Supports all VectorORM features including CRUD operations, filtering,
+ * and metadata updates.
+ */
+declare class TurbopufferAdapter extends VectorDBAdapter {
+    private config;
+    private baseUrl;
+    private connected;
+    private namespaceMetrics;
+    constructor(config: TurbopufferConfig);
+    private request;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): Promise<boolean>;
+    createCollection(name: string, dimension: number, metric?: DistanceMetric): Promise<void>;
+    deleteCollection(name: string): Promise<void>;
+    collectionExists(name: string): Promise<boolean>;
+    getCollectionStats(name: string): Promise<CollectionStats>;
+    upsert(collection: string, records: VectorRecord[]): Promise<void>;
+    fetch(collection: string, ids: string[]): Promise<VectorRecord[]>;
+    delete(collection: string, ids: string[]): Promise<void>;
+    updateMetadata(collection: string, updates: MetadataUpdate[]): Promise<void>;
+    search(collection: string, queryVector: number[], options?: {
+        topK?: number;
+        filter?: UniversalFilter;
+        includeMetadata?: boolean;
+        includeValues?: boolean;
+    }): Promise<SearchResult>;
+    translateFilter(filter: UniversalFilter): any;
+    iterate(collection: string, options?: {
+        batchSize?: number;
+        filter?: UniversalFilter;
+    }): AsyncIterableIterator<VectorRecord[]>;
+    supportsMetadataUpdate(): boolean;
+    supportsFiltering(): boolean;
+    supportsBatchOperations(): boolean;
+}
+
+export { TurbopufferAdapter, type TurbopufferConfig };

package/dist/index.js

@@ -0,0 +1,402 @@
+// src/turbopuffer-adapter.ts
+import {
+  VectorDBAdapter
+} from "@vectororm/core";
+var TurbopufferAdapter = class extends VectorDBAdapter {
+  config;
+  baseUrl;
+  connected = false;
+  namespaceMetrics = /* @__PURE__ */ new Map();
+  constructor(config) {
+    super();
+    if (!config.apiKey) {
+      throw new Error(
+        "TurbopufferAdapter: apiKey is required in config or TURBOPUFFER_API_KEY environment variable"
+      );
+    }
+    this.config = config;
+    this.baseUrl = config.baseUrl || "https://api.turbopuffer.com";
+  }
+  // ============================================================================
+  // HTTP HELPERS
+  // ============================================================================
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Authorization": `Bearer ${this.config.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      let errorMessage = `Turbopuffer API error: ${response.status} ${response.statusText}`;
+      try {
+        const errorData = JSON.parse(errorText);
+        if (errorData.error) {
+          errorMessage += ` - ${errorData.error}`;
+        }
+      } catch {
+        if (errorText) {
+          errorMessage += ` - ${errorText}`;
+        }
+      }
+      throw new Error(errorMessage);
+    }
+    const text = await response.text();
+    return text ? JSON.parse(text) : null;
+  }
+  // ============================================================================
+  // CONNECTION MANAGEMENT
+  // ============================================================================
+  async connect() {
+    try {
+      await this.request("GET", "/v2/namespaces");
+      this.connected = true;
+    } catch (error) {
+      throw new Error(
+        `Turbopuffer connection failed: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async disconnect() {
+    this.connected = false;
+    this.namespaceMetrics.clear();
+  }
+  async isConnected() {
+    return this.connected;
+  }
+  // ============================================================================
+  // COLLECTION MANAGEMENT
+  // ============================================================================
+  async createCollection(name, dimension, metric = "cosine") {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const distanceMetric = metric === "euclidean" ? "euclidean_squared" : "cosine_distance";
+      this.namespaceMetrics.set(name, { dimension, metric });
+      await this.request("POST", `/v2/namespaces/${name}`, {
+        upsert_rows: [{
+          id: "__init__",
+          vector: new Array(dimension).fill(0),
+          attributes: { __init__: true }
+        }],
+        distance_metric: distanceMetric
+      });
+      await this.request("POST", `/v2/namespaces/${name}`, {
+        deletes: ["__init__"]
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to create Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async deleteCollection(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.request("DELETE", `/v2/namespaces/${name}`);
+      this.namespaceMetrics.delete(name);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async collectionExists(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const response = await this.request("GET", "/v2/namespaces");
+      const namespaces = response.namespaces || [];
+      return namespaces.some((ns) => ns.name === name);
+    } catch (error) {
+      throw new Error(
+        `Failed to check if Turbopuffer namespace ${name} exists: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async getCollectionStats(name) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const result = await this.request("POST", `/v2/namespaces/${name}/query`, {
+        top_k: 0,
+        aggregate_by: { Count: "*" }
+      });
+      const vectorCount = result.aggregations?.Count ?? 0;
+      let dimension = this.namespaceMetrics.get(name)?.dimension ?? 0;
+      let metric = this.namespaceMetrics.get(name)?.metric ?? "cosine";
+      if (dimension === 0 && vectorCount > 0) {
+        const sample = await this.request("POST", `/v2/namespaces/${name}/query`, {
+          top_k: 1,
+          include_vectors: true
+        });
+        if (sample.rows && sample.rows.length > 0) {
+          dimension = sample.rows[0].vector?.length ?? 0;
+        }
+      }
+      return {
+        vectorCount: typeof vectorCount === "number" ? vectorCount : 0,
+        dimension,
+        metric
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to get Turbopuffer namespace stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // VECTOR OPERATIONS
+  // ============================================================================
+  async upsert(collection, records) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const storedMetric = this.namespaceMetrics.get(collection);
+      const distanceMetric = storedMetric?.metric === "euclidean" ? "euclidean_squared" : "cosine_distance";
+      const rows = records.map((record) => ({
+        id: record.id,
+        vector: record.embedding,
+        ...record.metadata
+      }));
+      await this.request("POST", `/v2/namespaces/${collection}`, {
+        upsert_rows: rows,
+        distance_metric: distanceMetric
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to upsert vectors to Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async fetch(collection, ids) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const results = [];
+      if (ids.length > 0) {
+        const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+          top_k: ids.length,
+          filters: ["id", "In", ids],
+          include_vectors: true
+        });
+        if (result.rows) {
+          for (const row of result.rows) {
+            const { id, vector, ...metadata } = row;
+            results.push({
+              id: String(id),
+              embedding: vector || [],
+              metadata
+            });
+          }
+        }
+      }
+      return results;
+    } catch (error) {
+      throw new Error(
+        `Failed to fetch vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async delete(collection, ids) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.request("POST", `/v2/namespaces/${collection}`, {
+        deletes: ids
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to delete vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // METADATA OPERATIONS
+  // ============================================================================
+  async updateMetadata(collection, updates) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      for (const update of updates) {
+        const existing = await this.fetch(collection, [update.id]);
+        if (existing.length === 0) {
+          throw new Error(`Vector ${update.id} not found for metadata update`);
+        }
+        const merged = { ...existing[0].metadata, ...update.metadata };
+        await this.request("POST", `/v2/namespaces/${collection}`, {
+          upsert_rows: [{
+            id: update.id,
+            vector: existing[0].embedding,
+            ...merged
+          }]
+        });
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to update metadata in Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // SEARCH OPERATIONS
+  // ============================================================================
+  async search(collection, queryVector, options) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const turbopufferFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+        rank_by: ["vector", "ANN", queryVector],
+        top_k: options?.topK || 10,
+        filters: turbopufferFilter,
+        include_vectors: options?.includeValues || false
+      });
+      const records = [];
+      if (result.rows) {
+        for (const row of result.rows) {
+          const { id, vector, $dist, ...metadata } = row;
+          const record = {
+            id: String(id),
+            embedding: options?.includeValues ? vector || [] : [],
+            metadata: options?.includeMetadata !== false ? metadata : {},
+            score: $dist !== void 0 ? 1 / (1 + $dist) : void 0
+          };
+          records.push(record);
+        }
+      }
+      return { records };
+    } catch (error) {
+      throw new Error(
+        `Failed to search Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // FILTER TRANSLATION
+  // ============================================================================
+  translateFilter(filter) {
+    if ("and" in filter) {
+      const conditions = filter.and;
+      const translated = conditions.map((c) => this.translateFilter(c));
+      return ["And", translated];
+    }
+    if ("or" in filter) {
+      const conditions = filter.or;
+      const translated = conditions.map((c) => this.translateFilter(c));
+      return ["Or", translated];
+    }
+    const { field, op, value } = filter;
+    const operatorMap = {
+      eq: "Eq",
+      ne: "Neq",
+      gt: "Gt",
+      gte: "Gte",
+      lt: "Lt",
+      lte: "Lte",
+      in: "In",
+      nin: "Nin"
+    };
+    const turbopufferOp = operatorMap[op];
+    if (!turbopufferOp) {
+      throw new Error(
+        `Unsupported filter operator: ${op}`,
+        { cause: { filter } }
+      );
+    }
+    return [field, turbopufferOp, value];
+  }
+  // ============================================================================
+  // ITERATION
+  // ============================================================================
+  async *iterate(collection, options) {
+    if (!this.connected) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const batchSize = options?.batchSize || 100;
+      const turbopufferFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      let lastId = null;
+      let hasMore = true;
+      while (hasMore) {
+        let filters = turbopufferFilter;
+        if (lastId !== null) {
+          const paginationFilter = ["id", "Gt", lastId];
+          if (filters) {
+            filters = ["And", [filters, paginationFilter]];
+          } else {
+            filters = paginationFilter;
+          }
+        }
+        const result = await this.request("POST", `/v2/namespaces/${collection}/query`, {
+          top_k: batchSize,
+          filters,
+          include_vectors: true,
+          rank_by: ["id", "Asc"]
+        });
+        if (result.rows && result.rows.length > 0) {
+          const records = [];
+          for (const row of result.rows) {
+            const { id, vector, ...metadata } = row;
+            records.push({
+              id: String(id),
+              embedding: vector || [],
+              metadata
+            });
+            lastId = String(id);
+          }
+          yield records;
+          hasMore = result.rows.length === batchSize;
+        } else {
+          hasMore = false;
+        }
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to iterate Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // CAPABILITY FLAGS
+  // ============================================================================
+  supportsMetadataUpdate() {
+    return true;
+  }
+  supportsFiltering() {
+    return true;
+  }
+  supportsBatchOperations() {
+    return true;
+  }
+};
+export {
+  TurbopufferAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/turbopuffer-adapter.ts"],"sourcesContent":["import {\n  VectorDBAdapter,\n  type VectorRecord,\n  type SearchResult,\n  type UniversalFilter,\n  type CollectionStats,\n  type MetadataUpdate,\n  type DistanceMetric,\n} from '@vectororm/core';\nimport type { TurbopufferConfig } from './types.js';\n\n/**\n * TurbopufferAdapter implements VectorDBAdapter for Turbopuffer vector database.\n *\n * Uses REST API with fetch (no SDK dependency to avoid Node version constraints).\n * Supports all VectorORM features including CRUD operations, filtering,\n * and metadata updates.\n */\nexport class TurbopufferAdapter extends VectorDBAdapter {\n  private config: TurbopufferConfig;\n  private baseUrl: string;\n  private connected: boolean = false;\n  private namespaceMetrics: Map<string, { dimension: number; metric: DistanceMetric }> = new Map();\n\n  constructor(config: TurbopufferConfig) {\n    super();\n\n    // Validate required config\n    if (!config.apiKey) {\n      throw new Error(\n        'TurbopufferAdapter: apiKey is required in config or TURBOPUFFER_API_KEY environment variable'\n      );\n    }\n\n    this.config = config;\n    this.baseUrl = config.baseUrl || 'https://api.turbopuffer.com';\n  }\n\n  // ============================================================================\n  // HTTP HELPERS\n  // ============================================================================\n\n  private async request(\n    method: string,\n    path: string,\n    body?: any\n  ): Promise<any> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      'Authorization': `Bearer ${this.config.apiKey}`,\n      'Content-Type': 'application/json',\n    };\n\n    const response = await fetch(url, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      let errorMessage = `Turbopuffer API error: ${response.status} ${response.statusText}`;\n\n      try {\n        const errorData = JSON.parse(errorText);\n        if (errorData.error) {\n          errorMessage += ` - ${errorData.error}`;\n        }\n      } catch {\n        if (errorText) {\n          errorMessage += ` - ${errorText}`;\n        }\n      }\n\n      throw new Error(errorMessage);\n    }\n\n    const text = await response.text();\n    return text ? JSON.parse(text) : null;\n  }\n\n  // ============================================================================\n  // CONNECTION MANAGEMENT\n  // ============================================================================\n\n  async connect(): Promise<void> {\n    try {\n      // Verify connection by listing namespaces\n      await this.request('GET', '/v2/namespaces');\n      this.connected = true;\n    } catch (error) {\n      throw new Error(\n        `Turbopuffer connection failed: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false;\n    this.namespaceMetrics.clear();\n  }\n\n  async isConnected(): Promise<boolean> {\n    return this.connected;\n  }\n\n  // ============================================================================\n  // COLLECTION MANAGEMENT\n  // ============================================================================\n\n  async createCollection(\n    name: string,\n    dimension: number,\n    metric: DistanceMetric = 'cosine'\n  ): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer creates namespaces implicitly on first upsert\n      // We'll store metadata locally and create with a dummy vector\n      const distanceMetric = metric === 'euclidean' ? 'euclidean_squared' : 'cosine_distance';\n\n      // Store metrics for later use\n      this.namespaceMetrics.set(name, { dimension, metric });\n\n      // Create namespace with initial dummy vector to set schema\n      await this.request('POST', `/v2/namespaces/${name}`, {\n        upsert_rows: [{\n          id: '__init__',\n          vector: new Array(dimension).fill(0),\n          attributes: { __init__: true }\n        }],\n        distance_metric: distanceMetric,\n      });\n\n      // Delete the initialization vector\n      await this.request('POST', `/v2/namespaces/${name}`, {\n        deletes: ['__init__'],\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to create Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async deleteCollection(name: string): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.request('DELETE', `/v2/namespaces/${name}`);\n      this.namespaceMetrics.delete(name);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete Turbopuffer namespace ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async collectionExists(name: string): Promise<boolean> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const response = await this.request('GET', '/v2/namespaces');\n      const namespaces = response.namespaces || [];\n      return namespaces.some((ns: any) => ns.name === name);\n    } catch (error) {\n      throw new Error(\n        `Failed to check if Turbopuffer namespace ${name} exists: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async getCollectionStats(name: string): Promise<CollectionStats> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Use query with limit 0 to get aggregation stats\n      const result = await this.request('POST', `/v2/namespaces/${name}/query`, {\n        top_k: 0,\n        aggregate_by: { Count: '*' },\n      });\n\n      const vectorCount = result.aggregations?.Count ?? 0;\n\n      // Get dimension from stored metrics or estimate from a sample vector\n      let dimension = this.namespaceMetrics.get(name)?.dimension ?? 0;\n      let metric = this.namespaceMetrics.get(name)?.metric ?? 'cosine';\n\n      if (dimension === 0 && vectorCount > 0) {\n        // Query one vector to get dimension\n        const sample = await this.request('POST', `/v2/namespaces/${name}/query`, {\n          top_k: 1,\n          include_vectors: true,\n        });\n\n        if (sample.rows && sample.rows.length > 0) {\n          dimension = sample.rows[0].vector?.length ?? 0;\n        }\n      }\n\n      return {\n        vectorCount: typeof vectorCount === 'number' ? vectorCount : 0,\n        dimension,\n        metric,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get Turbopuffer namespace stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // VECTOR OPERATIONS\n  // ============================================================================\n\n  async upsert(collection: string, records: VectorRecord[]): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Get or infer distance metric\n      const storedMetric = this.namespaceMetrics.get(collection);\n      const distanceMetric = storedMetric?.metric === 'euclidean'\n        ? 'euclidean_squared'\n        : 'cosine_distance';\n\n      // Convert VectorRecord[] to Turbopuffer format\n      const rows = records.map((record) => ({\n        id: record.id,\n        vector: record.embedding,\n        ...record.metadata,\n      }));\n\n      await this.request('POST', `/v2/namespaces/${collection}`, {\n        upsert_rows: rows,\n        distance_metric: distanceMetric,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to upsert vectors to Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async fetch(collection: string, ids: string[]): Promise<VectorRecord[]> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer doesn't have a direct fetch by IDs\n      // We need to use query with filters for each ID\n      const results: VectorRecord[] = [];\n\n      // Query with In filter for multiple IDs\n      if (ids.length > 0) {\n        const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n          top_k: ids.length,\n          filters: ['id', 'In', ids],\n          include_vectors: true,\n        });\n\n        if (result.rows) {\n          for (const row of result.rows) {\n            const { id, vector, ...metadata } = row;\n            results.push({\n              id: String(id),\n              embedding: vector || [],\n              metadata,\n            });\n          }\n        }\n      }\n\n      return results;\n    } catch (error) {\n      throw new Error(\n        `Failed to fetch vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async delete(collection: string, ids: string[]): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.request('POST', `/v2/namespaces/${collection}`, {\n        deletes: ids,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to delete vectors from Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // METADATA OPERATIONS\n  // ============================================================================\n\n  async updateMetadata(\n    collection: string,\n    updates: MetadataUpdate[]\n  ): Promise<void> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Turbopuffer supports patch operations\n      // We'll fetch existing records and patch them\n      for (const update of updates) {\n        // Fetch the existing record\n        const existing = await this.fetch(collection, [update.id]);\n\n        if (existing.length === 0) {\n          throw new Error(`Vector ${update.id} not found for metadata update`);\n        }\n\n        // Merge metadata\n        const merged = { ...existing[0].metadata, ...update.metadata };\n\n        // Upsert with updated metadata\n        await this.request('POST', `/v2/namespaces/${collection}`, {\n          upsert_rows: [{\n            id: update.id,\n            vector: existing[0].embedding,\n            ...merged,\n          }],\n        });\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to update metadata in Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // SEARCH OPERATIONS\n  // ============================================================================\n\n  async search(\n    collection: string,\n    queryVector: number[],\n    options?: {\n      topK?: number;\n      filter?: UniversalFilter;\n      includeMetadata?: boolean;\n      includeValues?: boolean;\n    }\n  ): Promise<SearchResult> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const turbopufferFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n        rank_by: ['vector', 'ANN', queryVector],\n        top_k: options?.topK || 10,\n        filters: turbopufferFilter,\n        include_vectors: options?.includeValues || false,\n      });\n\n      const records: VectorRecord[] = [];\n\n      if (result.rows) {\n        for (const row of result.rows) {\n          const { id, vector, $dist, ...metadata } = row;\n          const record: VectorRecord = {\n            id: String(id),\n            embedding: options?.includeValues ? (vector || []) : [],\n            metadata: options?.includeMetadata !== false ? metadata : {},\n            score: $dist !== undefined ? (1 / (1 + $dist)) : undefined,\n          };\n\n          records.push(record);\n        }\n      }\n\n      return { records };\n    } catch (error) {\n      throw new Error(\n        `Failed to search Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // FILTER TRANSLATION\n  // ============================================================================\n\n  translateFilter(filter: UniversalFilter): any {\n    // Handle compound AND filter\n    if ('and' in filter) {\n      const conditions = filter.and;\n\n      // Convert all conditions\n      const translated = conditions.map((c) => this.translateFilter(c));\n\n      return ['And', translated];\n    }\n\n    // Handle compound OR filter\n    if ('or' in filter) {\n      const conditions = filter.or;\n\n      const translated = conditions.map((c) => this.translateFilter(c));\n\n      return ['Or', translated];\n    }\n\n    // Handle basic filter condition\n    const { field, op, value } = filter as any;\n\n    // Operator mapping\n    const operatorMap: Record<string, string> = {\n      eq: 'Eq',\n      ne: 'Neq',\n      gt: 'Gt',\n      gte: 'Gte',\n      lt: 'Lt',\n      lte: 'Lte',\n      in: 'In',\n      nin: 'Nin',\n    };\n\n    const turbopufferOp = operatorMap[op];\n    if (!turbopufferOp) {\n      throw new Error(\n        `Unsupported filter operator: ${op}`,\n        { cause: { filter } }\n      );\n    }\n\n    return [field, turbopufferOp, value];\n  }\n\n  // ============================================================================\n  // ITERATION\n  // ============================================================================\n\n  async *iterate(\n    collection: string,\n    options?: {\n      batchSize?: number;\n      filter?: UniversalFilter;\n    }\n  ): AsyncIterableIterator<VectorRecord[]> {\n    if (!this.connected) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const batchSize = options?.batchSize || 100;\n\n      const turbopufferFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      // Turbopuffer uses attribute-based pagination\n      // We'll paginate by ID using greater-than filters\n      let lastId: string | null = null;\n      let hasMore = true;\n\n      while (hasMore) {\n        // Build filters for pagination\n        let filters = turbopufferFilter;\n\n        if (lastId !== null) {\n          const paginationFilter = ['id', 'Gt', lastId];\n\n          if (filters) {\n            // Combine with existing filters\n            filters = ['And', [filters, paginationFilter]];\n          } else {\n            filters = paginationFilter;\n          }\n        }\n\n        const result = await this.request('POST', `/v2/namespaces/${collection}/query`, {\n          top_k: batchSize,\n          filters,\n          include_vectors: true,\n          rank_by: ['id', 'Asc'],\n        });\n\n        if (result.rows && result.rows.length > 0) {\n          const records: VectorRecord[] = [];\n\n          for (const row of result.rows) {\n            const { id, vector, ...metadata } = row;\n            records.push({\n              id: String(id),\n              embedding: vector || [],\n              metadata,\n            });\n\n            lastId = String(id);\n          }\n\n          yield records;\n\n          // Check if we got fewer records than requested\n          hasMore = result.rows.length === batchSize;\n        } else {\n          hasMore = false;\n        }\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to iterate Turbopuffer namespace ${collection}: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  // ============================================================================\n  // CAPABILITY FLAGS\n  // ============================================================================\n\n  supportsMetadataUpdate(): boolean {\n    return true; // Turbopuffer supports metadata updates via upsert\n  }\n\n  supportsFiltering(): boolean {\n    return true; // Turbopuffer supports metadata filtering\n  }\n\n  supportsBatchOperations(): boolean {\n    return true; // Turbopuffer supports batch operations\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@vectororm/adapter-turbopuffer",
+  "version": "0.1.0",
+  "description": "Turbopuffer adapter for Glyph VectorORM",
+  "author": "Aviram Roisman",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/aviramroi/VectorORM",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aviramroi/VectorORM.git",
+    "directory": "packages/adapter-turbopuffer"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts"
+  },
+  "dependencies": {
+    "@vectororm/core": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "@vectororm/core": "^0.1.0"
+  },
+  "keywords": [
+    "glyph",
+    "vectororm",
+    "turbopuffer",
+    "vector-database",
+    "adapter"
+  ]
+}