@vectororm/adapter-pinecone 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# @vectororm/adapter-pinecone
+
+[![npm](https://img.shields.io/npm/v/@vectororm/adapter-pinecone)](https://www.npmjs.com/package/@vectororm/adapter-pinecone)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+[Pinecone](https://www.pinecone.io/) adapter for [Glyph VectorORM](https://github.com/aviramroi/VectorORM).
+
+## Installation
+
+```bash
+npm install @vectororm/core @vectororm/adapter-pinecone
+```
+
+## Prerequisites
+
+A Pinecone account and API key. Set up at [pinecone.io](https://www.pinecone.io/).
+
+## Usage
+
+### Standalone Adapter
+
+```typescript
+import { PineconeAdapter } from '@vectororm/adapter-pinecone';
+
+const adapter = new PineconeAdapter({
+  apiKey: process.env.PINECONE_API_KEY!,
+  environment: 'us-east-1-aws'
+});
+
+await adapter.connect();
+
+// Create an index
+await adapter.createCollection('my-index', 1536, 'cosine');
+
+// Upsert vectors
+await adapter.upsert('my-index', [
+  {
+    id: 'doc-1',
+    embedding: [0.1, 0.2, ...],
+    metadata: { title: 'My Document', __v_partition: 'finance' },
+    text: 'Document content...'
+  }
+]);
+
+// Search with filters
+const results = await adapter.search('my-index', queryVector, {
+  topK: 10,
+  filter: { field: '__v_partition', op: 'eq', value: 'finance' }
+});
+```
+
+### With RAGClient
+
+```typescript
+import { RAGClient } from '@vectororm/core';
+import { PineconeAdapter } from '@vectororm/adapter-pinecone';
+
+const client = new RAGClient({
+  adapter: new PineconeAdapter({
+    apiKey: process.env.PINECONE_API_KEY!,
+    environment: 'us-east-1-aws'
+  }),
+  embedder: myEmbedder,
+  llm: myLLM,
+  defaultCollection: 'docs'
+});
+
+await client.createCollection('docs');
+await client.ingest(['documents/*.pdf'], 'docs');
+const result = await client.retrieve('search query');
+```
+
+## Configuration
+
+```typescript
+interface PineconeConfig {
+  apiKey: string;       // Required: Pinecone API key
+  environment: string;  // Required: Pinecone environment (e.g., 'us-east-1-aws')
+}
+```
+
+Environment variable fallbacks: `PINECONE_API_KEY`, `PINECONE_ENVIRONMENT`.
+
+## Features
+
+- Full CRUD operations (upsert, fetch, delete)
+- Metadata filtering with Pinecone-native filter translation (`$eq`, `$in`, `$gt`, etc.)
+- Index management (create, delete, exists, stats)
+- Namespace support for multi-tenant isolation
+- Paginated iteration for enrichment pipelines
+
+## 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,349 @@
+"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, {
+  PineconeAdapter: () => PineconeAdapter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/pinecone-adapter.ts
+var import_core = require("@vectororm/core");
+var import_pinecone = require("@pinecone-database/pinecone");
+var PineconeAdapter = class extends import_core.VectorDBAdapter {
+  config;
+  client = null;
+  constructor(config) {
+    super();
+    if (!config.apiKey) {
+      throw new Error(
+        "PineconeAdapter: apiKey is required in config or PINECONE_API_KEY environment variable"
+      );
+    }
+    this.config = config;
+  }
+  // ============================================================================
+  // CONNECTION MANAGEMENT
+  // ============================================================================
+  async connect() {
+    try {
+      this.client = new import_pinecone.Pinecone({
+        apiKey: this.config.apiKey
+      });
+      await this.client.listIndexes();
+    } catch (error) {
+      throw new Error(
+        `Pinecone connection failed: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async disconnect() {
+    this.client = null;
+  }
+  async isConnected() {
+    return this.client !== null;
+  }
+  // ============================================================================
+  // COLLECTION MANAGEMENT
+  // ============================================================================
+  async createCollection(name, dimension, metric = "cosine") {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const pineconeMetric = metric === "dotProduct" ? "dotproduct" : metric;
+      await this.client.createIndex({
+        name,
+        dimension,
+        metric: pineconeMetric,
+        spec: {
+          serverless: {
+            cloud: "aws",
+            region: "us-east-1"
+          }
+        }
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to create Pinecone index ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async deleteCollection(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.client.deleteIndex(name);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete Pinecone index ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async collectionExists(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const indexes = await this.client.listIndexes();
+      return indexes.indexes?.some((idx) => idx.name === name) ?? false;
+    } catch (error) {
+      throw new Error(
+        `Failed to check if Pinecone index ${name} exists: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async getCollectionStats(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(name);
+      const stats = await index.describeIndexStats();
+      return {
+        vectorCount: stats.totalRecordCount ?? 0,
+        dimension: stats.dimension ?? 0,
+        metric: "cosine",
+        // Pinecone doesn't return metric in stats, default to cosine
+        ...stats
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to get Pinecone index stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // VECTOR OPERATIONS
+  // ============================================================================
+  async upsert(collection, records) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const pineconeRecords = records.map((record) => ({
+        id: record.id,
+        values: record.embedding,
+        metadata: record.metadata
+      }));
+      await index.upsert(pineconeRecords);
+    } catch (error) {
+      throw new Error(
+        `Failed to upsert vectors to Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async fetch(collection, ids) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const response = await index.fetch(ids);
+      return Object.entries(response.records || {}).map(([id, record]) => ({
+        id,
+        embedding: record.values || [],
+        metadata: record.metadata || {}
+      }));
+    } catch (error) {
+      throw new Error(
+        `Failed to fetch vectors from Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async delete(collection, ids) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      await index.deleteMany(ids);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete vectors from Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // METADATA OPERATIONS
+  // ============================================================================
+  async updateMetadata(collection, updates) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      for (const update of updates) {
+        await index.update({
+          id: update.id,
+          metadata: update.metadata
+        });
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to update metadata in Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // SEARCH OPERATIONS
+  // ============================================================================
+  async search(collection, queryVector, options) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const pineconeFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      const response = await index.query({
+        vector: queryVector,
+        topK: options?.topK || 10,
+        filter: pineconeFilter,
+        includeMetadata: options?.includeMetadata !== false,
+        includeValues: options?.includeValues || false
+      });
+      return {
+        records: (response.matches || []).map((match) => ({
+          id: match.id,
+          embedding: match.values || [],
+          metadata: match.metadata || {},
+          score: match.score
+        }))
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to search Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // FILTER TRANSLATION
+  // ============================================================================
+  translateFilter(filter) {
+    if ("and" in filter) {
+      const conditions = filter.and;
+      for (const condition of conditions) {
+        if ("and" in condition || "or" in condition) {
+          throw new Error(
+            "Nested compound filters not yet supported in PineconeAdapter. See TECH_DEBT.md",
+            { cause: { filter } }
+          );
+        }
+      }
+      return {
+        $and: conditions.map((c) => this.translateFilter(c))
+      };
+    }
+    if ("or" in filter) {
+      throw new Error(
+        "OR filters not yet supported in PineconeAdapter. See TECH_DEBT.md",
+        { cause: { filter } }
+      );
+    }
+    const { field, op, value } = filter;
+    const operatorMap = {
+      eq: "$eq",
+      ne: "$ne",
+      gt: "$gt",
+      gte: "$gte",
+      lt: "$lt",
+      lte: "$lte",
+      in: "$in",
+      nin: "$nin"
+    };
+    const pineconeOp = operatorMap[op];
+    if (!pineconeOp) {
+      throw new Error(
+        `Unsupported filter operator: ${op}`,
+        { cause: { filter } }
+      );
+    }
+    return {
+      [field]: {
+        [pineconeOp]: value
+      }
+    };
+  }
+  // ============================================================================
+  // ITERATION
+  // ============================================================================
+  async *iterate(collection, options) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const batchSize = options?.batchSize || 100;
+      const pineconeFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      let paginationToken = void 0;
+      let hasMore = true;
+      while (hasMore) {
+        const response = await index.listPaginated({
+          limit: batchSize,
+          paginationToken,
+          ...pineconeFilter && { filter: pineconeFilter }
+        });
+        if (response.vectors && response.vectors.length > 0) {
+          const ids = response.vectors.map((v) => v.id).filter((id) => id !== void 0);
+          if (ids.length > 0) {
+            const records = await this.fetch(collection, ids);
+            yield records;
+          }
+        }
+        paginationToken = response.pagination?.next;
+        hasMore = !!paginationToken;
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to iterate Pinecone index ${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 = {
+  PineconeAdapter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/pinecone-adapter.ts"],"sourcesContent":["// Pinecone adapter exports\nexport { PineconeAdapter } from './pinecone-adapter';\nexport type { PineconeConfig } 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 { Pinecone } from '@pinecone-database/pinecone';\nimport type { PineconeConfig } from './types.js';\n\n/**\n * PineconeAdapter implements VectorDBAdapter for Pinecone vector database.\n *\n * Supports all VectorORM features including CRUD operations, filtering,\n * and metadata updates.\n */\nexport class PineconeAdapter extends VectorDBAdapter {\n  private config: PineconeConfig;\n  private client: Pinecone | null = null;\n\n  constructor(config: PineconeConfig) {\n    super();\n\n    // Validate required config\n    if (!config.apiKey) {\n      throw new Error(\n        'PineconeAdapter: apiKey is required in config or PINECONE_API_KEY environment variable'\n      );\n    }\n\n    this.config = config;\n    // Client will be initialized in a separate step\n  }\n\n  // ============================================================================\n  // CONNECTION MANAGEMENT\n  // ============================================================================\n\n  async connect(): Promise<void> {\n    try {\n      this.client = new Pinecone({\n        apiKey: this.config.apiKey,\n      });\n\n      // Verify connection by listing indexes\n      await this.client.listIndexes();\n    } catch (error) {\n      throw new Error(\n        `Pinecone connection failed: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.client = null;\n  }\n\n  async isConnected(): Promise<boolean> {\n    return this.client !== null;\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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Map our metric to Pinecone metric\n      const pineconeMetric = metric === 'dotProduct' ? 'dotproduct' : metric;\n\n      await this.client.createIndex({\n        name,\n        dimension,\n        metric: pineconeMetric,\n        spec: {\n          serverless: {\n            cloud: 'aws',\n            region: 'us-east-1',\n          },\n        },\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to create Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.client.deleteIndex(name);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const indexes = await this.client.listIndexes();\n      return indexes.indexes?.some((idx) => idx.name === name) ?? false;\n    } catch (error) {\n      throw new Error(\n        `Failed to check if Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(name);\n      const stats = await index.describeIndexStats();\n\n      return {\n        vectorCount: stats.totalRecordCount ?? 0,\n        dimension: stats.dimension ?? 0,\n        metric: 'cosine', // Pinecone doesn't return metric in stats, default to cosine\n        ...stats,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get Pinecone index 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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      // Convert VectorRecord[] to Pinecone format\n      const pineconeRecords = records.map((record) => ({\n        id: record.id,\n        values: record.embedding,\n        metadata: record.metadata,\n      }));\n\n      await index.upsert(pineconeRecords);\n    } catch (error) {\n      throw new Error(\n        `Failed to upsert vectors to Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      const response = await index.fetch(ids);\n\n      return Object.entries(response.records || {}).map(([id, record]) => ({\n        id,\n        embedding: record.values || [],\n        metadata: record.metadata || {},\n      }));\n    } catch (error) {\n      throw new Error(\n        `Failed to fetch vectors from Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      await index.deleteMany(ids);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete vectors from Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      // Pinecone supports partial metadata updates via update()\n      for (const update of updates) {\n        await index.update({\n          id: update.id,\n          metadata: update.metadata,\n        });\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to update metadata in Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      const pineconeFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      const response = await index.query({\n        vector: queryVector,\n        topK: options?.topK || 10,\n        filter: pineconeFilter,\n        includeMetadata: options?.includeMetadata !== false,\n        includeValues: options?.includeValues || false,\n      });\n\n      return {\n        records: (response.matches || []).map((match) => ({\n          id: match.id,\n          embedding: match.values || [],\n          metadata: match.metadata || {},\n          score: match.score,\n        })),\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to search Pinecone index ${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      // Check for nested compound filters (not supported yet)\n      for (const condition of conditions) {\n        if ('and' in condition || 'or' in condition) {\n          throw new Error(\n            'Nested compound filters not yet supported in PineconeAdapter. See TECH_DEBT.md',\n            { cause: { filter } }\n          );\n        }\n      }\n\n      return {\n        $and: conditions.map((c) => this.translateFilter(c)),\n      };\n    }\n\n    // Handle compound OR filter (not supported)\n    if ('or' in filter) {\n      throw new Error(\n        'OR filters not yet supported in PineconeAdapter. See TECH_DEBT.md',\n        { cause: { filter } }\n      );\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: '$ne',\n      gt: '$gt',\n      gte: '$gte',\n      lt: '$lt',\n      lte: '$lte',\n      in: '$in',\n      nin: '$nin',\n    };\n\n    const pineconeOp = operatorMap[op];\n    if (!pineconeOp) {\n      throw new Error(\n        `Unsupported filter operator: ${op}`,\n        { cause: { filter } }\n      );\n    }\n\n    return {\n      [field]: {\n        [pineconeOp]: value,\n      },\n    };\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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      const batchSize = options?.batchSize || 100;\n      const pineconeFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      // Pinecone uses pagination with tokens\n      let paginationToken: string | undefined = undefined;\n      let hasMore = true;\n\n      while (hasMore) {\n        const response = await index.listPaginated({\n          limit: batchSize,\n          paginationToken,\n          ...(pineconeFilter && { filter: pineconeFilter }),\n        });\n\n        if (response.vectors && response.vectors.length > 0) {\n          // Fetch full records with embeddings\n          const ids = response.vectors\n            .map((v) => v.id)\n            .filter((id): id is string => id !== undefined);\n          if (ids.length > 0) {\n            const records = await this.fetch(collection, ids);\n            yield records;\n          }\n        }\n\n        // Check for more pages\n        paginationToken = response.pagination?.next;\n        hasMore = !!paginationToken;\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to iterate Pinecone index ${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; // Pinecone supports metadata updates\n  }\n\n  supportsFiltering(): boolean {\n    return true; // Pinecone supports metadata filtering\n  }\n\n  supportsBatchOperations(): boolean {\n    return true; // Pinecone supports batch operations\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAQO;AACP,sBAAyB;AASlB,IAAM,kBAAN,cAA8B,4BAAgB;AAAA,EAC3C;AAAA,EACA,SAA0B;AAAA,EAElC,YAAY,QAAwB;AAClC,UAAM;AAGN,QAAI,CAAC,OAAO,QAAQ;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,SAAK,SAAS;AAAA,EAEhB;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,UAAyB;AAC7B,QAAI;AACF,WAAK,SAAS,IAAI,yBAAS;AAAA,QACzB,QAAQ,KAAK,OAAO;AAAA,MACtB,CAAC;AAGD,YAAM,KAAK,OAAO,YAAY;AAAA,IAChC,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,+BAA+B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACrF,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,aAA4B;AAChC,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,cAAgC;AACpC,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,iBACJ,MACA,WACA,SAAyB,UACV;AACf,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AAEF,YAAM,iBAAiB,WAAW,eAAe,eAAe;AAEhE,YAAM,KAAK,OAAO,YAAY;AAAA,QAC5B;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR,MAAM;AAAA,UACJ,YAAY;AAAA,YACV,OAAO;AAAA,YACP,QAAQ;AAAA,UACV;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,mCAAmC,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAClG,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,iBAAiB,MAA6B;AAClD,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,KAAK,OAAO,YAAY,IAAI;AAAA,IACpC,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,mCAAmC,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAClG,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,iBAAiB,MAAgC;AACrD,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO,YAAY;AAC9C,aAAO,QAAQ,SAAS,KAAK,CAAC,QAAQ,IAAI,SAAS,IAAI,KAAK;AAAA,IAC9D,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,qCAAqC,IAAI,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QAC3G,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,mBAAmB,MAAwC;AAC/D,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;AACpC,YAAM,QAAQ,MAAM,MAAM,mBAAmB;AAE7C,aAAO;AAAA,QACL,aAAa,MAAM,oBAAoB;AAAA,QACvC,WAAW,MAAM,aAAa;AAAA,QAC9B,QAAQ;AAAA;AAAA,QACR,GAAG;AAAA,MACL;AAAA,IACF,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,0CAA0C,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACzG,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,YAAoB,SAAwC;AACvE,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAG1C,YAAM,kBAAkB,QAAQ,IAAI,CAAC,YAAY;AAAA,QAC/C,IAAI,OAAO;AAAA,QACX,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,MACnB,EAAE;AAEF,YAAM,MAAM,OAAO,eAAe;AAAA,IACpC,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,8CAA8C,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACnH,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,YAAoB,KAAwC;AACtE,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAC1C,YAAM,WAAW,MAAM,MAAM,MAAM,GAAG;AAEtC,aAAO,OAAO,QAAQ,SAAS,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,MAAM,OAAO;AAAA,QACnE;AAAA,QACA,WAAW,OAAO,UAAU,CAAC;AAAA,QAC7B,UAAU,OAAO,YAAY,CAAC;AAAA,MAChC,EAAE;AAAA,IACJ,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,+CAA+C,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACpH,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,YAAoB,KAA8B;AAC7D,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAC1C,YAAM,MAAM,WAAW,GAAG;AAAA,IAC5B,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,gDAAgD,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACrH,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,eACJ,YACA,SACe;AACf,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAG1C,iBAAW,UAAU,SAAS;AAC5B,cAAM,MAAM,OAAO;AAAA,UACjB,IAAI,OAAO;AAAA,UACX,UAAU,OAAO;AAAA,QACnB,CAAC;AAAA,MACH;AAAA,IACF,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,+CAA+C,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACpH,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OACJ,YACA,aACA,SAMuB;AACvB,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAE1C,YAAM,iBAAiB,SAAS,SAC5B,KAAK,gBAAgB,QAAQ,MAAM,IACnC;AAEJ,YAAM,WAAW,MAAM,MAAM,MAAM;AAAA,QACjC,QAAQ;AAAA,QACR,MAAM,SAAS,QAAQ;AAAA,QACvB,QAAQ;AAAA,QACR,iBAAiB,SAAS,oBAAoB;AAAA,QAC9C,eAAe,SAAS,iBAAiB;AAAA,MAC3C,CAAC;AAED,aAAO;AAAA,QACL,UAAU,SAAS,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW;AAAA,UAChD,IAAI,MAAM;AAAA,UACV,WAAW,MAAM,UAAU,CAAC;AAAA,UAC5B,UAAU,MAAM,YAAY,CAAC;AAAA,UAC7B,OAAO,MAAM;AAAA,QACf,EAAE;AAAA,MACJ;AAAA,IACF,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,mCAAmC,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACxG,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,gBAAgB,QAA8B;AAE5C,QAAI,SAAS,QAAQ;AACnB,YAAM,aAAa,OAAO;AAG1B,iBAAW,aAAa,YAAY;AAClC,YAAI,SAAS,aAAa,QAAQ,WAAW;AAC3C,gBAAM,IAAI;AAAA,YACR;AAAA,YACA,EAAE,OAAO,EAAE,OAAO,EAAE;AAAA,UACtB;AAAA,QACF;AAAA,MACF;AAEA,aAAO;AAAA,QACL,MAAM,WAAW,IAAI,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC;AAAA,MACrD;AAAA,IACF;AAGA,QAAI,QAAQ,QAAQ;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,QACA,EAAE,OAAO,EAAE,OAAO,EAAE;AAAA,MACtB;AAAA,IACF;AAGA,UAAM,EAAE,OAAO,IAAI,MAAM,IAAI;AAG7B,UAAM,cAAsC;AAAA,MAC1C,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,IAAI;AAAA,MACJ,KAAK;AAAA,MACL,IAAI;AAAA,MACJ,KAAK;AAAA,MACL,IAAI;AAAA,MACJ,KAAK;AAAA,IACP;AAEA,UAAM,aAAa,YAAY,EAAE;AACjC,QAAI,CAAC,YAAY;AACf,YAAM,IAAI;AAAA,QACR,gCAAgC,EAAE;AAAA,QAClC,EAAE,OAAO,EAAE,OAAO,EAAE;AAAA,MACtB;AAAA,IACF;AAEA,WAAO;AAAA,MACL,CAAC,KAAK,GAAG;AAAA,QACP,CAAC,UAAU,GAAG;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,QACL,YACA,SAIuC;AACvC,QAAI,CAAC,KAAK,QAAQ;AAChB,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AAEA,QAAI;AACF,YAAM,QAAQ,KAAK,OAAO,MAAM,UAAU;AAC1C,YAAM,YAAY,SAAS,aAAa;AACxC,YAAM,iBAAiB,SAAS,SAC5B,KAAK,gBAAgB,QAAQ,MAAM,IACnC;AAGJ,UAAI,kBAAsC;AAC1C,UAAI,UAAU;AAEd,aAAO,SAAS;AACd,cAAM,WAAW,MAAM,MAAM,cAAc;AAAA,UACzC,OAAO;AAAA,UACP;AAAA,UACA,GAAI,kBAAkB,EAAE,QAAQ,eAAe;AAAA,QACjD,CAAC;AAED,YAAI,SAAS,WAAW,SAAS,QAAQ,SAAS,GAAG;AAEnD,gBAAM,MAAM,SAAS,QAClB,IAAI,CAAC,MAAM,EAAE,EAAE,EACf,OAAO,CAAC,OAAqB,OAAO,MAAS;AAChD,cAAI,IAAI,SAAS,GAAG;AAClB,kBAAM,UAAU,MAAM,KAAK,MAAM,YAAY,GAAG;AAChD,kBAAM;AAAA,UACR;AAAA,QACF;AAGA,0BAAkB,SAAS,YAAY;AACvC,kBAAU,CAAC,CAAC;AAAA,MACd;AAAA,IACF,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,oCAAoC,UAAU,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,QACzG,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,yBAAkC;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,oBAA6B;AAC3B,WAAO;AAAA,EACT;AAAA,EAEA,0BAAmC;AACjC,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+import { VectorDBAdapter, DistanceMetric, CollectionStats, VectorRecord, MetadataUpdate, UniversalFilter, SearchResult } from '@vectororm/core';
+
+/**
+ * Configuration for PineconeAdapter.
+ *
+ * Supports hybrid config: explicit values or environment variables.
+ */
+interface PineconeConfig {
+    /**
+     * Pinecone API key.
+     * Falls back to PINECONE_API_KEY environment variable.
+     */
+    apiKey: string;
+    /**
+     * Pinecone environment (e.g., 'us-east1-gcp').
+     * Falls back to PINECONE_ENVIRONMENT environment variable.
+     */
+    environment?: string;
+    /**
+     * Pinecone project ID (optional).
+     */
+    projectId?: string;
+}
+
+/**
+ * PineconeAdapter implements VectorDBAdapter for Pinecone vector database.
+ *
+ * Supports all VectorORM features including CRUD operations, filtering,
+ * and metadata updates.
+ */
+declare class PineconeAdapter extends VectorDBAdapter {
+    private config;
+    private client;
+    constructor(config: PineconeConfig);
+    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 { PineconeAdapter, type PineconeConfig };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { VectorDBAdapter, DistanceMetric, CollectionStats, VectorRecord, MetadataUpdate, UniversalFilter, SearchResult } from '@vectororm/core';
+
+/**
+ * Configuration for PineconeAdapter.
+ *
+ * Supports hybrid config: explicit values or environment variables.
+ */
+interface PineconeConfig {
+    /**
+     * Pinecone API key.
+     * Falls back to PINECONE_API_KEY environment variable.
+     */
+    apiKey: string;
+    /**
+     * Pinecone environment (e.g., 'us-east1-gcp').
+     * Falls back to PINECONE_ENVIRONMENT environment variable.
+     */
+    environment?: string;
+    /**
+     * Pinecone project ID (optional).
+     */
+    projectId?: string;
+}
+
+/**
+ * PineconeAdapter implements VectorDBAdapter for Pinecone vector database.
+ *
+ * Supports all VectorORM features including CRUD operations, filtering,
+ * and metadata updates.
+ */
+declare class PineconeAdapter extends VectorDBAdapter {
+    private config;
+    private client;
+    constructor(config: PineconeConfig);
+    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 { PineconeAdapter, type PineconeConfig };

package/dist/index.js

@@ -0,0 +1,324 @@
+// src/pinecone-adapter.ts
+import {
+  VectorDBAdapter
+} from "@vectororm/core";
+import { Pinecone } from "@pinecone-database/pinecone";
+var PineconeAdapter = class extends VectorDBAdapter {
+  config;
+  client = null;
+  constructor(config) {
+    super();
+    if (!config.apiKey) {
+      throw new Error(
+        "PineconeAdapter: apiKey is required in config or PINECONE_API_KEY environment variable"
+      );
+    }
+    this.config = config;
+  }
+  // ============================================================================
+  // CONNECTION MANAGEMENT
+  // ============================================================================
+  async connect() {
+    try {
+      this.client = new Pinecone({
+        apiKey: this.config.apiKey
+      });
+      await this.client.listIndexes();
+    } catch (error) {
+      throw new Error(
+        `Pinecone connection failed: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async disconnect() {
+    this.client = null;
+  }
+  async isConnected() {
+    return this.client !== null;
+  }
+  // ============================================================================
+  // COLLECTION MANAGEMENT
+  // ============================================================================
+  async createCollection(name, dimension, metric = "cosine") {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const pineconeMetric = metric === "dotProduct" ? "dotproduct" : metric;
+      await this.client.createIndex({
+        name,
+        dimension,
+        metric: pineconeMetric,
+        spec: {
+          serverless: {
+            cloud: "aws",
+            region: "us-east-1"
+          }
+        }
+      });
+    } catch (error) {
+      throw new Error(
+        `Failed to create Pinecone index ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async deleteCollection(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      await this.client.deleteIndex(name);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete Pinecone index ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async collectionExists(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const indexes = await this.client.listIndexes();
+      return indexes.indexes?.some((idx) => idx.name === name) ?? false;
+    } catch (error) {
+      throw new Error(
+        `Failed to check if Pinecone index ${name} exists: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async getCollectionStats(name) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(name);
+      const stats = await index.describeIndexStats();
+      return {
+        vectorCount: stats.totalRecordCount ?? 0,
+        dimension: stats.dimension ?? 0,
+        metric: "cosine",
+        // Pinecone doesn't return metric in stats, default to cosine
+        ...stats
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to get Pinecone index stats for ${name}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // VECTOR OPERATIONS
+  // ============================================================================
+  async upsert(collection, records) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const pineconeRecords = records.map((record) => ({
+        id: record.id,
+        values: record.embedding,
+        metadata: record.metadata
+      }));
+      await index.upsert(pineconeRecords);
+    } catch (error) {
+      throw new Error(
+        `Failed to upsert vectors to Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async fetch(collection, ids) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const response = await index.fetch(ids);
+      return Object.entries(response.records || {}).map(([id, record]) => ({
+        id,
+        embedding: record.values || [],
+        metadata: record.metadata || {}
+      }));
+    } catch (error) {
+      throw new Error(
+        `Failed to fetch vectors from Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async delete(collection, ids) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      await index.deleteMany(ids);
+    } catch (error) {
+      throw new Error(
+        `Failed to delete vectors from Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // METADATA OPERATIONS
+  // ============================================================================
+  async updateMetadata(collection, updates) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      for (const update of updates) {
+        await index.update({
+          id: update.id,
+          metadata: update.metadata
+        });
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to update metadata in Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // SEARCH OPERATIONS
+  // ============================================================================
+  async search(collection, queryVector, options) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const pineconeFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      const response = await index.query({
+        vector: queryVector,
+        topK: options?.topK || 10,
+        filter: pineconeFilter,
+        includeMetadata: options?.includeMetadata !== false,
+        includeValues: options?.includeValues || false
+      });
+      return {
+        records: (response.matches || []).map((match) => ({
+          id: match.id,
+          embedding: match.values || [],
+          metadata: match.metadata || {},
+          score: match.score
+        }))
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to search Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // FILTER TRANSLATION
+  // ============================================================================
+  translateFilter(filter) {
+    if ("and" in filter) {
+      const conditions = filter.and;
+      for (const condition of conditions) {
+        if ("and" in condition || "or" in condition) {
+          throw new Error(
+            "Nested compound filters not yet supported in PineconeAdapter. See TECH_DEBT.md",
+            { cause: { filter } }
+          );
+        }
+      }
+      return {
+        $and: conditions.map((c) => this.translateFilter(c))
+      };
+    }
+    if ("or" in filter) {
+      throw new Error(
+        "OR filters not yet supported in PineconeAdapter. See TECH_DEBT.md",
+        { cause: { filter } }
+      );
+    }
+    const { field, op, value } = filter;
+    const operatorMap = {
+      eq: "$eq",
+      ne: "$ne",
+      gt: "$gt",
+      gte: "$gte",
+      lt: "$lt",
+      lte: "$lte",
+      in: "$in",
+      nin: "$nin"
+    };
+    const pineconeOp = operatorMap[op];
+    if (!pineconeOp) {
+      throw new Error(
+        `Unsupported filter operator: ${op}`,
+        { cause: { filter } }
+      );
+    }
+    return {
+      [field]: {
+        [pineconeOp]: value
+      }
+    };
+  }
+  // ============================================================================
+  // ITERATION
+  // ============================================================================
+  async *iterate(collection, options) {
+    if (!this.client) {
+      throw new Error("Not connected. Call connect() first.");
+    }
+    try {
+      const index = this.client.index(collection);
+      const batchSize = options?.batchSize || 100;
+      const pineconeFilter = options?.filter ? this.translateFilter(options.filter) : void 0;
+      let paginationToken = void 0;
+      let hasMore = true;
+      while (hasMore) {
+        const response = await index.listPaginated({
+          limit: batchSize,
+          paginationToken,
+          ...pineconeFilter && { filter: pineconeFilter }
+        });
+        if (response.vectors && response.vectors.length > 0) {
+          const ids = response.vectors.map((v) => v.id).filter((id) => id !== void 0);
+          if (ids.length > 0) {
+            const records = await this.fetch(collection, ids);
+            yield records;
+          }
+        }
+        paginationToken = response.pagination?.next;
+        hasMore = !!paginationToken;
+      }
+    } catch (error) {
+      throw new Error(
+        `Failed to iterate Pinecone index ${collection}: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  // ============================================================================
+  // CAPABILITY FLAGS
+  // ============================================================================
+  supportsMetadataUpdate() {
+    return true;
+  }
+  supportsFiltering() {
+    return true;
+  }
+  supportsBatchOperations() {
+    return true;
+  }
+};
+export {
+  PineconeAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pinecone-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 { Pinecone } from '@pinecone-database/pinecone';\nimport type { PineconeConfig } from './types.js';\n\n/**\n * PineconeAdapter implements VectorDBAdapter for Pinecone vector database.\n *\n * Supports all VectorORM features including CRUD operations, filtering,\n * and metadata updates.\n */\nexport class PineconeAdapter extends VectorDBAdapter {\n  private config: PineconeConfig;\n  private client: Pinecone | null = null;\n\n  constructor(config: PineconeConfig) {\n    super();\n\n    // Validate required config\n    if (!config.apiKey) {\n      throw new Error(\n        'PineconeAdapter: apiKey is required in config or PINECONE_API_KEY environment variable'\n      );\n    }\n\n    this.config = config;\n    // Client will be initialized in a separate step\n  }\n\n  // ============================================================================\n  // CONNECTION MANAGEMENT\n  // ============================================================================\n\n  async connect(): Promise<void> {\n    try {\n      this.client = new Pinecone({\n        apiKey: this.config.apiKey,\n      });\n\n      // Verify connection by listing indexes\n      await this.client.listIndexes();\n    } catch (error) {\n      throw new Error(\n        `Pinecone connection failed: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      );\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    this.client = null;\n  }\n\n  async isConnected(): Promise<boolean> {\n    return this.client !== null;\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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      // Map our metric to Pinecone metric\n      const pineconeMetric = metric === 'dotProduct' ? 'dotproduct' : metric;\n\n      await this.client.createIndex({\n        name,\n        dimension,\n        metric: pineconeMetric,\n        spec: {\n          serverless: {\n            cloud: 'aws',\n            region: 'us-east-1',\n          },\n        },\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to create Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      await this.client.deleteIndex(name);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const indexes = await this.client.listIndexes();\n      return indexes.indexes?.some((idx) => idx.name === name) ?? false;\n    } catch (error) {\n      throw new Error(\n        `Failed to check if Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(name);\n      const stats = await index.describeIndexStats();\n\n      return {\n        vectorCount: stats.totalRecordCount ?? 0,\n        dimension: stats.dimension ?? 0,\n        metric: 'cosine', // Pinecone doesn't return metric in stats, default to cosine\n        ...stats,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get Pinecone index 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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      // Convert VectorRecord[] to Pinecone format\n      const pineconeRecords = records.map((record) => ({\n        id: record.id,\n        values: record.embedding,\n        metadata: record.metadata,\n      }));\n\n      await index.upsert(pineconeRecords);\n    } catch (error) {\n      throw new Error(\n        `Failed to upsert vectors to Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      const response = await index.fetch(ids);\n\n      return Object.entries(response.records || {}).map(([id, record]) => ({\n        id,\n        embedding: record.values || [],\n        metadata: record.metadata || {},\n      }));\n    } catch (error) {\n      throw new Error(\n        `Failed to fetch vectors from Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      await index.deleteMany(ids);\n    } catch (error) {\n      throw new Error(\n        `Failed to delete vectors from Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      // Pinecone supports partial metadata updates via update()\n      for (const update of updates) {\n        await index.update({\n          id: update.id,\n          metadata: update.metadata,\n        });\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to update metadata in Pinecone index ${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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n\n      const pineconeFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      const response = await index.query({\n        vector: queryVector,\n        topK: options?.topK || 10,\n        filter: pineconeFilter,\n        includeMetadata: options?.includeMetadata !== false,\n        includeValues: options?.includeValues || false,\n      });\n\n      return {\n        records: (response.matches || []).map((match) => ({\n          id: match.id,\n          embedding: match.values || [],\n          metadata: match.metadata || {},\n          score: match.score,\n        })),\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to search Pinecone index ${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      // Check for nested compound filters (not supported yet)\n      for (const condition of conditions) {\n        if ('and' in condition || 'or' in condition) {\n          throw new Error(\n            'Nested compound filters not yet supported in PineconeAdapter. See TECH_DEBT.md',\n            { cause: { filter } }\n          );\n        }\n      }\n\n      return {\n        $and: conditions.map((c) => this.translateFilter(c)),\n      };\n    }\n\n    // Handle compound OR filter (not supported)\n    if ('or' in filter) {\n      throw new Error(\n        'OR filters not yet supported in PineconeAdapter. See TECH_DEBT.md',\n        { cause: { filter } }\n      );\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: '$ne',\n      gt: '$gt',\n      gte: '$gte',\n      lt: '$lt',\n      lte: '$lte',\n      in: '$in',\n      nin: '$nin',\n    };\n\n    const pineconeOp = operatorMap[op];\n    if (!pineconeOp) {\n      throw new Error(\n        `Unsupported filter operator: ${op}`,\n        { cause: { filter } }\n      );\n    }\n\n    return {\n      [field]: {\n        [pineconeOp]: value,\n      },\n    };\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.client) {\n      throw new Error('Not connected. Call connect() first.');\n    }\n\n    try {\n      const index = this.client.index(collection);\n      const batchSize = options?.batchSize || 100;\n      const pineconeFilter = options?.filter\n        ? this.translateFilter(options.filter)\n        : undefined;\n\n      // Pinecone uses pagination with tokens\n      let paginationToken: string | undefined = undefined;\n      let hasMore = true;\n\n      while (hasMore) {\n        const response = await index.listPaginated({\n          limit: batchSize,\n          paginationToken,\n          ...(pineconeFilter && { filter: pineconeFilter }),\n        });\n\n        if (response.vectors && response.vectors.length > 0) {\n          // Fetch full records with embeddings\n          const ids = response.vectors\n            .map((v) => v.id)\n            .filter((id): id is string => id !== undefined);\n          if (ids.length > 0) {\n            const records = await this.fetch(collection, ids);\n            yield records;\n          }\n        }\n\n        // Check for more pages\n        paginationToken = response.pagination?.next;\n        hasMore = !!paginationToken;\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to iterate Pinecone index ${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; // Pinecone supports metadata updates\n  }\n\n  supportsFiltering(): boolean {\n    return true; // Pinecone supports metadata filtering\n  }\n\n  supportsBatchOperations(): boolean {\n    return true; // Pinecone supports batch operations\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@vectororm/adapter-pinecone",
+  "version": "0.1.0",
+  "description": "Pinecone 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-pinecone"
+  },
+  "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": "*",
+    "@pinecone-database/pinecone": "^2.0.0"
+  },
+  "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",
+    "pinecone",
+    "vector-database",
+    "adapter"
+  ]
+}