@absolutejs/rag-pinecone 0.0.2

package/README.md

@@ -0,0 +1,66 @@
+# @absolutejs/rag-pinecone
+
+Pinecone vector-store adapter for [`@absolutejs/rag`](https://github.com/absolutejs/rag).
+Treats Pinecone as the backend boundary: server-side filtering, native vector search,
+and explicit opt-in index provisioning helpers.
+
+## Install
+
+```bash
+bun add @absolutejs/rag @absolutejs/rag-pinecone @pinecone-database/pinecone
+```
+
+## Usage
+
+```ts
+import { createPineconeRAG } from '@absolutejs/rag-pinecone';
+
+const rag = createPineconeRAG({
+	apiKey: process.env.PINECONE_API_KEY,
+	indexName: 'absolute-rag-demo',
+	namespace: 'production',
+	vector: {
+		provider: 'pinecone',
+		dimensions: 1536,
+		distanceMetric: 'cosine'
+	}
+});
+
+await rag.store.upsert({
+	chunks: [
+		{
+			chunkId: 'doc-1#0',
+			text: 'Pinecone stores vectors with attached metadata.',
+			title: 'Pinecone overview',
+			source: 'https://docs.pinecone.io',
+			metadata: { tags: ['vector', 'managed'] }
+		}
+	]
+});
+
+const hits = await rag.collection.search({ query: 'vector database', topK: 4 });
+```
+
+### Index provisioning
+
+The Pinecone index is **not** auto-provisioned at runtime. For explicit, opt-in
+provisioning use the exported helpers:
+
+```ts
+import {
+	describePineconeIndex,
+	ensurePineconeIndex
+} from '@absolutejs/rag-pinecone';
+
+await ensurePineconeIndex({
+	apiKey: process.env.PINECONE_API_KEY,
+	indexName: 'absolute-rag-demo',
+	dimensions: 1536,
+	metric: 'cosine',
+	waitUntilReady: true
+});
+```
+
+## License
+
+CC BY-NC 4.0

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import type { RAGBackendCapabilities, RAGCollection, RAGVectorStore } from '@absolutejs/rag';
+export declare const ABSOLUTE_PINECONE_RAG_PACKAGE_NAME = "@absolutejs/rag-pinecone";
+export declare const PINECONE_DISTANCE_METRICS: readonly ["cosine", "euclidean", "dotproduct"];
+export type PineconeDistanceMetric = 'cosine' | 'euclidean' | 'dotproduct';
+export type PineconeIndexClient = {
+    upsert: (records: unknown[]) => Promise<unknown>;
+    query: (input: Record<string, unknown>) => Promise<{
+        matches?: Array<{
+            id: string;
+            score?: number;
+            values?: number[];
+            metadata?: Record<string, unknown>;
+        }>;
+    }>;
+    fetch: (ids: string[]) => Promise<{
+        records?: Record<string, unknown>;
+    }>;
+    deleteMany: (input: string[] | Record<string, unknown>) => Promise<unknown>;
+    deleteAll: () => Promise<unknown>;
+    describeIndexStats: () => Promise<{
+        totalRecordCount?: number;
+        namespaces?: Record<string, {
+            recordCount?: number;
+        }>;
+    }>;
+    namespace?: (namespace: string) => PineconeIndexClient;
+};
+export type PineconeRAGVectorConfig = {
+    provider: 'pinecone';
+    dimensions: number;
+    distanceMetric?: PineconeDistanceMetric;
+};
+export type PineconeRAGOptions = {
+    apiKey?: string;
+    indexName?: string;
+    indexHost?: string;
+    namespace?: string;
+    client?: PineconeIndexClient;
+    vector: PineconeRAGVectorConfig;
+    embedding?: RAGVectorStore['embed'];
+};
+export type PineconeRAG = {
+    store: RAGVectorStore;
+    collection: RAGCollection;
+    getCapabilities: () => RAGBackendCapabilities | undefined;
+};
+export type PineconeServerlessSpec = {
+    serverless: {
+        cloud: 'aws' | 'gcp' | 'azure';
+        region: string;
+    };
+};
+export type PineconePodSpec = {
+    pod: {
+        environment: string;
+        podType: string;
+        pods?: number;
+        replicas?: number;
+        shards?: number;
+        metadataConfig?: {
+            indexed?: string[];
+        };
+        sourceCollection?: string;
+    };
+};
+export type PineconeIndexSpec = PineconeServerlessSpec | PineconePodSpec;
+export type PineconeIndexDescription = {
+    name: string;
+    dimension: number;
+    metric: PineconeDistanceMetric;
+    host?: string;
+    spec?: PineconeIndexSpec;
+    status?: {
+        ready?: boolean;
+        state?: string;
+    };
+    deletionProtection?: 'enabled' | 'disabled';
+};
+export type DescribePineconeIndexOptions = {
+    apiKey?: string;
+    indexName: string;
+};
+export type EnsurePineconeIndexOptions = {
+    apiKey?: string;
+    indexName: string;
+    dimensions: number;
+    metric?: PineconeDistanceMetric;
+    spec?: PineconeIndexSpec;
+    deletionProtection?: 'enabled' | 'disabled';
+    waitUntilReady?: boolean;
+    waitTimeoutMs?: number;
+    pollIntervalMs?: number;
+};
+export type EnsurePineconeIndexResult = {
+    created: boolean;
+    description: PineconeIndexDescription | undefined;
+};
+export declare const createPineconeStore: (options: PineconeRAGOptions) => RAGVectorStore;
+export declare const describePineconeIndex: (options: DescribePineconeIndexOptions) => Promise<PineconeIndexDescription | undefined>;
+export declare const ensurePineconeIndex: (options: EnsurePineconeIndexOptions) => Promise<EnsurePineconeIndexResult>;
+export declare const createPineconeRAGCollection: (options: PineconeRAGOptions) => RAGCollection;
+export declare const createPineconeRAG: (options: PineconeRAGOptions) => PineconeRAG;

package/dist/index.js

@@ -0,0 +1,518 @@
+// @bun
+var __require = import.meta.require;
+
+// src/index.ts
+import {
+  createRAGCollection,
+  createRAGVector,
+  normalizeVector
+} from "@absolutejs/rag";
+var ABSOLUTE_PINECONE_RAG_PACKAGE_NAME = "@absolutejs/rag-pinecone";
+var PINECONE_DISTANCE_METRICS = [
+  "cosine",
+  "euclidean",
+  "dotproduct"
+];
+var PKG = ABSOLUTE_PINECONE_RAG_PACKAGE_NAME;
+var DEFAULT_DIMENSIONS = 1536;
+var DEFAULT_DISTANCE_METRIC = "cosine";
+var PINECONE_UPSERT_BATCH_SIZE = 100;
+var PINECONE_FETCH_BATCH_SIZE = 1000;
+var PINECONE_FILTERED_COUNT_TOPK = 1e4;
+var RESERVED_METADATA_KEYS = new Set(["chunkId", "text", "title", "source"]);
+var isObjectRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var isOperatorRecord = (value) => isObjectRecord(value) && Object.keys(value).length > 0 && Object.keys(value).every((key) => key.startsWith("$"));
+var chunkArray = (input, size) => {
+  const out = [];
+  for (let i = 0;i < input.length; i += size) {
+    out.push(input.slice(i, i + size));
+  }
+  return out;
+};
+var resolveVectorConfig = (options) => {
+  const vector = options?.vector;
+  if (!vector || vector.provider !== "pinecone") {
+    throw new Error(`${PKG}: Pinecone RAG requires vector.provider = "pinecone"`);
+  }
+  const dimensions = vector.dimensions ?? DEFAULT_DIMENSIONS;
+  if (!Number.isInteger(dimensions) || dimensions <= 0) {
+    throw new Error(`${PKG}: vector.dimensions must be a positive integer (received ${String(dimensions)})`);
+  }
+  const distanceMetric = vector.distanceMetric ?? DEFAULT_DISTANCE_METRIC;
+  if (!PINECONE_DISTANCE_METRICS.includes(distanceMetric)) {
+    throw new Error(`${PKG}: unsupported distanceMetric "${distanceMetric}". Allowed: ${PINECONE_DISTANCE_METRICS.join(", ")}`);
+  }
+  return { provider: "pinecone", dimensions, distanceMetric };
+};
+var pineconeModulePromise;
+var loadPineconeSDK = () => {
+  if (!pineconeModulePromise) {
+    pineconeModulePromise = import("@pinecone-database/pinecone").catch((error) => {
+      pineconeModulePromise = undefined;
+      throw new Error(`${PKG}: failed to load @pinecone-database/pinecone \u2014 install it as a dependency. (${error instanceof Error ? error.message : String(error)})`);
+    });
+  }
+  return pineconeModulePromise;
+};
+var resolveIndexClientFactory = (options) => {
+  const namespace = typeof options.namespace === "string" && options.namespace.length > 0 ? options.namespace : undefined;
+  let cached;
+  const applyNamespace = (idx) => {
+    if (!namespace || typeof idx.namespace !== "function")
+      return idx;
+    return idx.namespace(namespace);
+  };
+  if (options.client) {
+    const injectedClient = options.client;
+    return async () => {
+      if (cached)
+        return cached;
+      cached = applyNamespace(injectedClient);
+      return cached;
+    };
+  }
+  const indexName = options.indexName;
+  if (typeof indexName !== "string" || indexName.length === 0) {
+    throw new Error(`${PKG}: indexName is required when client is not provided`);
+  }
+  const apiKey = options.apiKey ?? process.env.PINECONE_API_KEY;
+  if (!apiKey) {
+    throw new Error(`${PKG}: missing Pinecone apiKey (pass options.apiKey or set PINECONE_API_KEY)`);
+  }
+  return async () => {
+    if (cached)
+      return cached;
+    const { Pinecone } = await loadPineconeSDK();
+    const pc = new Pinecone({ apiKey });
+    const baseIndex = options.indexHost ? pc.index(indexName, options.indexHost) : pc.index(indexName);
+    cached = applyNamespace(baseIndex);
+    return cached;
+  };
+};
+var sanitizeMetadataValue = (value) => {
+  if (value === null || value === undefined)
+    return;
+  if (typeof value === "string" || typeof value === "boolean")
+    return value;
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : undefined;
+  }
+  if (Array.isArray(value)) {
+    const strings = [];
+    for (const entry of value) {
+      if (entry === null || entry === undefined)
+        continue;
+      if (typeof entry === "string") {
+        strings.push(entry);
+        continue;
+      }
+      if (typeof entry === "number" && Number.isFinite(entry)) {
+        strings.push(String(entry));
+        continue;
+      }
+      if (typeof entry === "boolean") {
+        strings.push(String(entry));
+        continue;
+      }
+    }
+    return strings;
+  }
+  if (typeof value === "object") {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return;
+    }
+  }
+  return;
+};
+var sanitizeMetadata = (metadata) => {
+  if (!isObjectRecord(metadata))
+    return {};
+  const out = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    if (RESERVED_METADATA_KEYS.has(key))
+      continue;
+    const sanitized = sanitizeMetadataValue(value);
+    if (sanitized === undefined)
+      continue;
+    out[key] = sanitized;
+  }
+  return out;
+};
+var translateOperatorFilter = (field, operatorRecord) => {
+  const direct = {};
+  const expanded = [];
+  for (const [op, value] of Object.entries(operatorRecord)) {
+    switch (op) {
+      case "$eq":
+      case "$ne":
+      case "$gt":
+      case "$gte":
+      case "$lt":
+      case "$lte":
+        direct[op] = value;
+        break;
+      case "$in":
+        if (Array.isArray(value))
+          direct.$in = value;
+        break;
+      case "$exists":
+        direct.$exists = Boolean(value);
+        break;
+      case "$contains":
+        direct.$in = [value];
+        break;
+      case "$containsAny":
+        if (Array.isArray(value))
+          direct.$in = value;
+        break;
+      case "$containsAll":
+        if (Array.isArray(value)) {
+          for (const entry of value) {
+            expanded.push({ [field]: { $in: [entry] } });
+          }
+        }
+        break;
+      default:
+        throw new Error(`${PKG}: unsupported filter operator "${op}"`);
+    }
+  }
+  if (expanded.length === 0) {
+    return Object.keys(direct).length > 0 ? { [field]: direct } : undefined;
+  }
+  if (Object.keys(direct).length === 0) {
+    return expanded.length === 1 ? expanded[0] : { $and: expanded };
+  }
+  return { $and: [{ [field]: direct }, ...expanded] };
+};
+var translateFilter = (filter) => {
+  if (!isObjectRecord(filter) || Object.keys(filter).length === 0) {
+    return;
+  }
+  const clauses = [];
+  for (const [key, value] of Object.entries(filter)) {
+    if (key === "$and" || key === "$or") {
+      if (!Array.isArray(value))
+        continue;
+      const subs = value.map((entry) => translateFilter(entry)).filter((entry) => entry !== undefined);
+      if (subs.length > 0)
+        clauses.push({ [key]: subs });
+      continue;
+    }
+    if (key === "$not") {
+      throw new Error(`${PKG}: $not is not supported by Pinecone`);
+    }
+    if (key.includes(".")) {
+      throw new Error(`${PKG}: nested key paths ("${key}") are not supported by Pinecone (metadata is flat)`);
+    }
+    if (isOperatorRecord(value)) {
+      const translated = translateOperatorFilter(key, value);
+      if (translated)
+        clauses.push(translated);
+      continue;
+    }
+    clauses.push({ [key]: { $eq: value } });
+  }
+  if (clauses.length === 0)
+    return;
+  if (clauses.length === 1)
+    return clauses[0];
+  return { $and: clauses };
+};
+var scoreForMetric = (rawScore, distanceMetric) => {
+  if (typeof rawScore !== "number" || !Number.isFinite(rawScore))
+    return 0;
+  switch (distanceMetric) {
+    case "euclidean":
+      return 1 / (1 + Math.abs(rawScore));
+    case "dotproduct":
+    case "cosine":
+    default:
+      return rawScore;
+  }
+};
+var buildPineconeRecord = (chunk, values) => {
+  const metadata = {
+    ...sanitizeMetadata(chunk.metadata),
+    chunkId: chunk.chunkId,
+    text: chunk.text
+  };
+  if (chunk.title)
+    metadata.title = chunk.title;
+  if (chunk.source)
+    metadata.source = chunk.source;
+  return { id: chunk.chunkId, values, metadata };
+};
+var extractQueryResult = (match, distanceMetric) => {
+  const meta = isObjectRecord(match.metadata) ? match.metadata : {};
+  const userMetadata = {};
+  for (const [key, value] of Object.entries(meta)) {
+    if (RESERVED_METADATA_KEYS.has(key))
+      continue;
+    userMetadata[key] = value;
+  }
+  const chunkId = typeof meta.chunkId === "string" ? meta.chunkId : String(match.id);
+  const chunkText = typeof meta.text === "string" ? meta.text : "";
+  return {
+    chunkId,
+    chunkText,
+    title: typeof meta.title === "string" ? meta.title : undefined,
+    source: typeof meta.source === "string" ? meta.source : undefined,
+    metadata: Object.keys(userMetadata).length > 0 ? userMetadata : undefined,
+    score: scoreForMetric(match.score, distanceMetric)
+  };
+};
+var createPineconeStore = (options) => {
+  const vector = resolveVectorConfig(options ?? {});
+  const namespace = typeof options.namespace === "string" && options.namespace.length > 0 ? options.namespace : undefined;
+  const getClient = resolveIndexClientFactory(options ?? {});
+  const embed = async (input) => {
+    if (typeof options.embedding === "function") {
+      const result = await options.embedding(input);
+      return normalizeVector(result);
+    }
+    return normalizeVector([
+      ...createRAGVector(input.text, vector.dimensions)
+    ]);
+  };
+  const upsert = async (input) => {
+    if (!input?.chunks || input.chunks.length === 0)
+      return;
+    const client = await getClient();
+    const records = await Promise.all(input.chunks.map(async (chunk) => {
+      const values = Array.isArray(chunk.embedding) && chunk.embedding.length > 0 ? normalizeVector(chunk.embedding) : await embed({ text: chunk.text });
+      return buildPineconeRecord(chunk, values);
+    }));
+    for (const batch of chunkArray(records, PINECONE_UPSERT_BATCH_SIZE)) {
+      await client.upsert(batch);
+    }
+  };
+  const query = async (input) => {
+    const client = await getClient();
+    const filter = translateFilter(input.filter);
+    const queryInput = {
+      vector: normalizeVector(input.queryVector),
+      topK: input.topK,
+      includeMetadata: true,
+      includeValues: false
+    };
+    if (filter)
+      queryInput.filter = filter;
+    const result = await client.query(queryInput);
+    const matches = Array.isArray(result?.matches) ? result.matches : [];
+    return matches.map((match) => extractQueryResult(match, vector.distanceMetric));
+  };
+  const count = async (input = {}) => {
+    const client = await getClient();
+    if (Array.isArray(input.chunkIds) && input.chunkIds.length > 0) {
+      let total = 0;
+      for (const batch of chunkArray(input.chunkIds, PINECONE_FETCH_BATCH_SIZE)) {
+        const response = await client.fetch(batch);
+        total += Object.keys(response?.records ?? {}).length;
+      }
+      return total;
+    }
+    if (isObjectRecord(input.filter) && Object.keys(input.filter).length > 0) {
+      const filter = translateFilter(input.filter);
+      const probeVector = new Array(vector.dimensions).fill(0);
+      const queryInput = {
+        vector: probeVector,
+        topK: PINECONE_FILTERED_COUNT_TOPK,
+        includeMetadata: false,
+        includeValues: false
+      };
+      if (filter)
+        queryInput.filter = filter;
+      const result = await client.query(queryInput);
+      return Array.isArray(result?.matches) ? result.matches.length : 0;
+    }
+    const stats = await client.describeIndexStats();
+    if (namespace) {
+      return stats?.namespaces?.[namespace]?.recordCount ?? 0;
+    }
+    return stats?.totalRecordCount ?? 0;
+  };
+  const remove = async (input = {}) => {
+    const client = await getClient();
+    if (Array.isArray(input.chunkIds) && input.chunkIds.length > 0) {
+      for (const batch of chunkArray(input.chunkIds, PINECONE_FETCH_BATCH_SIZE)) {
+        try {
+          await client.deleteMany(batch);
+        } catch (error) {
+          if (!isPineconeNotFound(error))
+            throw error;
+        }
+      }
+      return input.chunkIds.length;
+    }
+    if (isObjectRecord(input.filter) && Object.keys(input.filter).length > 0) {
+      const filter = translateFilter(input.filter);
+      if (!filter)
+        return 0;
+      const counted = await count({ filter: input.filter });
+      try {
+        await client.deleteMany({ filter });
+      } catch (error) {
+        if (!isPineconeNotFound(error))
+          throw error;
+      }
+      return counted;
+    }
+    return 0;
+  };
+  const clear = async () => {
+    const client = await getClient();
+    try {
+      await client.deleteAll();
+    } catch (error) {
+      if (!isPineconeNotFound(error))
+        throw error;
+    }
+  };
+  return {
+    embed,
+    query,
+    upsert,
+    count,
+    delete: remove,
+    clear,
+    getCapabilities: () => ({
+      backend: "custom",
+      persistence: "external",
+      nativeVectorSearch: true,
+      serverSideFiltering: true,
+      streamingIngestStatus: false
+    })
+  };
+};
+var DEFAULT_INDEX_READY_TIMEOUT_MS = 120000;
+var DEFAULT_INDEX_READY_POLL_MS = 1500;
+var DEFAULT_SERVERLESS_SPEC = {
+  serverless: { cloud: "aws", region: "us-east-1" }
+};
+var isPineconeNotFound = (error) => {
+  if (!error)
+    return false;
+  const err = error;
+  const status = err.status ?? err.statusCode ?? err.response?.status ?? undefined;
+  if (status === 404)
+    return true;
+  const name = String(err.name ?? "");
+  if (name === "PineconeNotFoundError")
+    return true;
+  const message = String(err.message ?? "").toLowerCase();
+  return message.includes("not found") || message.includes("does not exist") || message.includes("404");
+};
+var resolveProvisioningClient = async (options) => {
+  const apiKey = options.apiKey ?? process.env.PINECONE_API_KEY;
+  if (!apiKey) {
+    throw new Error(`${PKG}: missing Pinecone apiKey (pass options.apiKey or set PINECONE_API_KEY)`);
+  }
+  if (typeof options.indexName !== "string" || options.indexName.length === 0) {
+    throw new Error(`${PKG}: indexName is required`);
+  }
+  const { Pinecone } = await loadPineconeSDK();
+  return new Pinecone({ apiKey });
+};
+var waitForIndexReady = async (pc, indexName, timeoutMs, pollIntervalMs) => {
+  const deadline = Date.now() + timeoutMs;
+  for (;; ) {
+    const description = await pc.describeIndex(indexName);
+    const status = description?.status;
+    const ready = status?.ready === true || status?.state === "Ready" || status?.state === "ScalingUp";
+    if (ready)
+      return description;
+    if (Date.now() >= deadline) {
+      throw new Error(`${PKG}: index "${indexName}" did not become ready within ${timeoutMs}ms (last state: ${status?.state ?? "unknown"})`);
+    }
+    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+  }
+};
+var describePineconeIndex = async (options) => {
+  const pc = await resolveProvisioningClient(options);
+  try {
+    return await pc.describeIndex(options.indexName);
+  } catch (error) {
+    if (isPineconeNotFound(error))
+      return;
+    throw error;
+  }
+};
+var ensurePineconeIndex = async (options) => {
+  if (!Number.isInteger(options.dimensions) || options.dimensions <= 0) {
+    throw new Error(`${PKG}: dimensions must be a positive integer (received ${String(options.dimensions)})`);
+  }
+  const metric = options.metric ?? "cosine";
+  if (!PINECONE_DISTANCE_METRICS.includes(metric)) {
+    throw new Error(`${PKG}: unsupported metric "${metric}". Allowed: ${PINECONE_DISTANCE_METRICS.join(", ")}`);
+  }
+  const pc = await resolveProvisioningClient(options);
+  const timeoutMs = options.waitTimeoutMs ?? DEFAULT_INDEX_READY_TIMEOUT_MS;
+  const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_INDEX_READY_POLL_MS;
+  const shouldWait = options.waitUntilReady !== false;
+  let existing;
+  try {
+    existing = await pc.describeIndex(options.indexName);
+  } catch (error) {
+    if (!isPineconeNotFound(error))
+      throw error;
+  }
+  if (existing) {
+    if (existing.dimension !== options.dimensions) {
+      throw new Error(`${PKG}: index "${options.indexName}" already exists with dimension=${existing.dimension}, but ${options.dimensions} was requested`);
+    }
+    if (existing.metric && existing.metric !== metric) {
+      throw new Error(`${PKG}: index "${options.indexName}" already exists with metric="${existing.metric}", but "${metric}" was requested`);
+    }
+    if (shouldWait && existing.status?.ready !== true) {
+      const description2 = await waitForIndexReady(pc, options.indexName, timeoutMs, pollIntervalMs);
+      return { created: false, description: description2 };
+    }
+    return { created: false, description: existing };
+  }
+  const spec = options.spec ?? DEFAULT_SERVERLESS_SPEC;
+  await pc.createIndex({
+    name: options.indexName,
+    dimension: options.dimensions,
+    metric,
+    spec,
+    ...options.deletionProtection ? { deletionProtection: options.deletionProtection } : {}
+  });
+  if (!shouldWait) {
+    let description2;
+    try {
+      description2 = await pc.describeIndex(options.indexName);
+    } catch (error) {
+      if (!isPineconeNotFound(error))
+        throw error;
+    }
+    return { created: true, description: description2 };
+  }
+  const description = await waitForIndexReady(pc, options.indexName, timeoutMs, pollIntervalMs);
+  return { created: true, description };
+};
+var createPineconeRAGCollection = (options) => createRAGCollection({
+  store: createPineconeStore(options)
+});
+var createPineconeRAG = (options) => {
+  const store = createPineconeStore(options);
+  const collection = createRAGCollection({ store });
+  return {
+    store,
+    collection,
+    getCapabilities: () => store.getCapabilities?.()
+  };
+};
+export {
+  ensurePineconeIndex,
+  describePineconeIndex,
+  createPineconeStore,
+  createPineconeRAGCollection,
+  createPineconeRAG,
+  PINECONE_DISTANCE_METRICS,
+  ABSOLUTE_PINECONE_RAG_PACKAGE_NAME
+};
+
+//# debugId=2B01AEA5BCA9D5E464756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "import type {\n\tRAGBackendCapabilities,\n\tRAGCollection,\n\tRAGQueryInput,\n\tRAGQueryResult,\n\tRAGUpsertInput,\n\tRAGVectorStore\n} from '@absolutejs/rag';\nimport {\n\tcreateRAGCollection,\n\tcreateRAGVector,\n\tnormalizeVector\n} from '@absolutejs/rag';\n\nexport const ABSOLUTE_PINECONE_RAG_PACKAGE_NAME = '@absolutejs/rag-pinecone';\n\nexport const PINECONE_DISTANCE_METRICS = [\n\t'cosine',\n\t'euclidean',\n\t'dotproduct'\n] as const;\n\nexport type PineconeDistanceMetric = 'cosine' | 'euclidean' | 'dotproduct';\n\nexport type PineconeIndexClient = {\n\tupsert: (records: unknown[]) => Promise<unknown>;\n\tquery: (input: Record<string, unknown>) => Promise<{\n\t\tmatches?: Array<{\n\t\t\tid: string;\n\t\t\tscore?: number;\n\t\t\tvalues?: number[];\n\t\t\tmetadata?: Record<string, unknown>;\n\t\t}>;\n\t}>;\n\tfetch: (ids: string[]) => Promise<{\n\t\trecords?: Record<string, unknown>;\n\t}>;\n\tdeleteMany: (input: string[] | Record<string, unknown>) => Promise<unknown>;\n\tdeleteAll: () => Promise<unknown>;\n\tdescribeIndexStats: () => Promise<{\n\t\ttotalRecordCount?: number;\n\t\tnamespaces?: Record<string, { recordCount?: number }>;\n\t}>;\n\tnamespace?: (namespace: string) => PineconeIndexClient;\n};\n\nexport type PineconeRAGVectorConfig = {\n\tprovider: 'pinecone';\n\tdimensions: number;\n\tdistanceMetric?: PineconeDistanceMetric;\n};\n\nexport type PineconeRAGOptions = {\n\tapiKey?: string;\n\tindexName?: string;\n\tindexHost?: string;\n\tnamespace?: string;\n\tclient?: PineconeIndexClient;\n\tvector: PineconeRAGVectorConfig;\n\tembedding?: RAGVectorStore['embed'];\n};\n\nexport type PineconeRAG = {\n\tstore: RAGVectorStore;\n\tcollection: RAGCollection;\n\tgetCapabilities: () => RAGBackendCapabilities | undefined;\n};\n\nexport type PineconeServerlessSpec = {\n\tserverless: {\n\t\tcloud: 'aws' | 'gcp' | 'azure';\n\t\tregion: string;\n\t};\n};\n\nexport type PineconePodSpec = {\n\tpod: {\n\t\tenvironment: string;\n\t\tpodType: string;\n\t\tpods?: number;\n\t\treplicas?: number;\n\t\tshards?: number;\n\t\tmetadataConfig?: { indexed?: string[] };\n\t\tsourceCollection?: string;\n\t};\n};\n\nexport type PineconeIndexSpec = PineconeServerlessSpec | PineconePodSpec;\n\nexport type PineconeIndexDescription = {\n\tname: string;\n\tdimension: number;\n\tmetric: PineconeDistanceMetric;\n\thost?: string;\n\tspec?: PineconeIndexSpec;\n\tstatus?: { ready?: boolean; state?: string };\n\tdeletionProtection?: 'enabled' | 'disabled';\n};\n\nexport type DescribePineconeIndexOptions = {\n\tapiKey?: string;\n\tindexName: string;\n};\n\nexport type EnsurePineconeIndexOptions = {\n\tapiKey?: string;\n\tindexName: string;\n\tdimensions: number;\n\tmetric?: PineconeDistanceMetric;\n\tspec?: PineconeIndexSpec;\n\tdeletionProtection?: 'enabled' | 'disabled';\n\twaitUntilReady?: boolean;\n\twaitTimeoutMs?: number;\n\tpollIntervalMs?: number;\n};\n\nexport type EnsurePineconeIndexResult = {\n\tcreated: boolean;\n\tdescription: PineconeIndexDescription | undefined;\n};\n\ntype ResolvedPineconeVectorConfig = {\n\tprovider: 'pinecone';\n\tdimensions: number;\n\tdistanceMetric: PineconeDistanceMetric;\n};\n\ntype MetadataValue = string | number | boolean | string[];\n\ntype PineconeRecord = {\n\tid: string;\n\tvalues: number[];\n\tmetadata: Record<string, MetadataValue>;\n};\n\ntype PineconeQueryMatch = {\n\tid: string;\n\tscore?: number;\n\tvalues?: number[];\n\tmetadata?: Record<string, unknown>;\n};\n\ntype PineconeFilter = Record<string, unknown>;\n\nconst PKG = ABSOLUTE_PINECONE_RAG_PACKAGE_NAME;\nconst DEFAULT_DIMENSIONS = 1536;\nconst DEFAULT_DISTANCE_METRIC: PineconeDistanceMetric = 'cosine';\nconst PINECONE_UPSERT_BATCH_SIZE = 100;\nconst PINECONE_FETCH_BATCH_SIZE = 1000;\nconst PINECONE_FILTERED_COUNT_TOPK = 10000;\nconst RESERVED_METADATA_KEYS = new Set(['chunkId', 'text', 'title', 'source']);\n\nconst isObjectRecord = (value: unknown): value is Record<string, unknown> =>\n\tBoolean(value) && typeof value === 'object' && !Array.isArray(value);\n\nconst isOperatorRecord = (value: unknown): value is Record<string, unknown> =>\n\tisObjectRecord(value) &&\n\tObject.keys(value).length > 0 &&\n\tObject.keys(value).every((key) => key.startsWith('$'));\n\nconst chunkArray = <T>(input: readonly T[], size: number): T[][] => {\n\tconst out: T[][] = [];\n\tfor (let i = 0; i < input.length; i += size) {\n\t\tout.push(input.slice(i, i + size));\n\t}\n\n\treturn out;\n};\n\nconst resolveVectorConfig = (\n\toptions: Partial<PineconeRAGOptions>\n): ResolvedPineconeVectorConfig => {\n\tconst vector = options?.vector;\n\tif (!vector || vector.provider !== 'pinecone') {\n\t\tthrow new Error(\n\t\t\t`${PKG}: Pinecone RAG requires vector.provider = \"pinecone\"`\n\t\t);\n\t}\n\tconst dimensions = vector.dimensions ?? DEFAULT_DIMENSIONS;\n\tif (!Number.isInteger(dimensions) || dimensions <= 0) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: vector.dimensions must be a positive integer (received ${String(\n\t\t\t\tdimensions\n\t\t\t)})`\n\t\t);\n\t}\n\tconst distanceMetric = vector.distanceMetric ?? DEFAULT_DISTANCE_METRIC;\n\tif (!PINECONE_DISTANCE_METRICS.includes(distanceMetric)) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: unsupported distanceMetric \"${distanceMetric}\". Allowed: ${PINECONE_DISTANCE_METRICS.join(\n\t\t\t\t', '\n\t\t\t)}`\n\t\t);\n\t}\n\n\treturn { provider: 'pinecone', dimensions, distanceMetric };\n};\n\ntype PineconeSDKModule = {\n\tPinecone: new (config: { apiKey: string }) => {\n\t\tindex: (name: string, host?: string) => PineconeIndexClient;\n\t\tcreateIndex: (input: Record<string, unknown>) => Promise<unknown>;\n\t\tdescribeIndex: (name: string) => Promise<PineconeIndexDescription>;\n\t};\n};\n\nlet pineconeModulePromise: Promise<PineconeSDKModule> | undefined;\nconst loadPineconeSDK = (): Promise<PineconeSDKModule> => {\n\tif (!pineconeModulePromise) {\n\t\tpineconeModulePromise = (\n\t\t\timport('@pinecone-database/pinecone') as Promise<unknown> as Promise<PineconeSDKModule>\n\t\t).catch((error: unknown) => {\n\t\t\tpineconeModulePromise = undefined;\n\t\t\tthrow new Error(\n\t\t\t\t`${PKG}: failed to load @pinecone-database/pinecone — install it as a dependency. (${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t})`\n\t\t\t);\n\t\t});\n\t}\n\n\treturn pineconeModulePromise;\n};\n\nconst resolveIndexClientFactory = (\n\toptions: PineconeRAGOptions\n): (() => Promise<PineconeIndexClient>) => {\n\tconst namespace =\n\t\ttypeof options.namespace === 'string' && options.namespace.length > 0\n\t\t\t? options.namespace\n\t\t\t: undefined;\n\n\tlet cached: PineconeIndexClient | undefined;\n\n\tconst applyNamespace = (idx: PineconeIndexClient): PineconeIndexClient => {\n\t\tif (!namespace || typeof idx.namespace !== 'function') return idx;\n\n\t\treturn idx.namespace(namespace);\n\t};\n\n\tif (options.client) {\n\t\tconst injectedClient = options.client;\n\n\t\treturn async () => {\n\t\t\tif (cached) return cached;\n\t\t\tcached = applyNamespace(injectedClient);\n\n\t\t\treturn cached;\n\t\t};\n\t}\n\n\tconst indexName = options.indexName;\n\tif (typeof indexName !== 'string' || indexName.length === 0) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: indexName is required when client is not provided`\n\t\t);\n\t}\n\tconst apiKey = options.apiKey ?? process.env.PINECONE_API_KEY;\n\tif (!apiKey) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: missing Pinecone apiKey (pass options.apiKey or set PINECONE_API_KEY)`\n\t\t);\n\t}\n\n\treturn async () => {\n\t\tif (cached) return cached;\n\t\tconst { Pinecone } = await loadPineconeSDK();\n\t\tconst pc = new Pinecone({ apiKey });\n\t\tconst baseIndex = options.indexHost\n\t\t\t? pc.index(indexName, options.indexHost)\n\t\t\t: pc.index(indexName);\n\t\tcached = applyNamespace(baseIndex);\n\n\t\treturn cached;\n\t};\n};\n\nconst sanitizeMetadataValue = (value: unknown): MetadataValue | undefined => {\n\tif (value === null || value === undefined) return undefined;\n\tif (typeof value === 'string' || typeof value === 'boolean') return value;\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : undefined;\n\t}\n\tif (Array.isArray(value)) {\n\t\tconst strings: string[] = [];\n\t\tfor (const entry of value) {\n\t\t\tif (entry === null || entry === undefined) continue;\n\t\t\tif (typeof entry === 'string') {\n\t\t\t\tstrings.push(entry);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (typeof entry === 'number' && Number.isFinite(entry)) {\n\t\t\t\tstrings.push(String(entry));\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (typeof entry === 'boolean') {\n\t\t\t\tstrings.push(String(entry));\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\treturn strings;\n\t}\n\tif (typeof value === 'object') {\n\t\ttry {\n\t\t\treturn JSON.stringify(value);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\treturn undefined;\n};\n\nconst sanitizeMetadata = (\n\tmetadata: unknown\n): Record<string, MetadataValue> => {\n\tif (!isObjectRecord(metadata)) return {};\n\tconst out: Record<string, MetadataValue> = {};\n\tfor (const [key, value] of Object.entries(metadata)) {\n\t\tif (RESERVED_METADATA_KEYS.has(key)) continue;\n\t\tconst sanitized = sanitizeMetadataValue(value);\n\t\tif (sanitized === undefined) continue;\n\t\tout[key] = sanitized;\n\t}\n\n\treturn out;\n};\n\nconst translateOperatorFilter = (\n\tfield: string,\n\toperatorRecord: Record<string, unknown>\n): PineconeFilter | undefined => {\n\tconst direct: Record<string, unknown> = {};\n\tconst expanded: PineconeFilter[] = [];\n\tfor (const [op, value] of Object.entries(operatorRecord)) {\n\t\tswitch (op) {\n\t\t\tcase '$eq':\n\t\t\tcase '$ne':\n\t\t\tcase '$gt':\n\t\t\tcase '$gte':\n\t\t\tcase '$lt':\n\t\t\tcase '$lte':\n\t\t\t\tdirect[op] = value;\n\t\t\t\tbreak;\n\t\t\tcase '$in':\n\t\t\t\tif (Array.isArray(value)) direct.$in = value;\n\t\t\t\tbreak;\n\t\t\tcase '$exists':\n\t\t\t\tdirect.$exists = Boolean(value);\n\t\t\t\tbreak;\n\t\t\tcase '$contains':\n\t\t\t\tdirect.$in = [value];\n\t\t\t\tbreak;\n\t\t\tcase '$containsAny':\n\t\t\t\tif (Array.isArray(value)) direct.$in = value;\n\t\t\t\tbreak;\n\t\t\tcase '$containsAll':\n\t\t\t\tif (Array.isArray(value)) {\n\t\t\t\t\tfor (const entry of value) {\n\t\t\t\t\t\texpanded.push({ [field]: { $in: [entry] } });\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tthrow new Error(`${PKG}: unsupported filter operator \"${op}\"`);\n\t\t}\n\t}\n\tif (expanded.length === 0) {\n\t\treturn Object.keys(direct).length > 0 ? { [field]: direct } : undefined;\n\t}\n\tif (Object.keys(direct).length === 0) {\n\t\treturn expanded.length === 1 ? expanded[0] : { $and: expanded };\n\t}\n\n\treturn { $and: [{ [field]: direct }, ...expanded] };\n};\n\nconst translateFilter = (filter: unknown): PineconeFilter | undefined => {\n\tif (!isObjectRecord(filter) || Object.keys(filter).length === 0) {\n\t\treturn undefined;\n\t}\n\tconst clauses: PineconeFilter[] = [];\n\tfor (const [key, value] of Object.entries(filter)) {\n\t\tif (key === '$and' || key === '$or') {\n\t\t\tif (!Array.isArray(value)) continue;\n\t\t\tconst subs = value\n\t\t\t\t.map((entry) => translateFilter(entry))\n\t\t\t\t.filter(\n\t\t\t\t\t(entry): entry is PineconeFilter => entry !== undefined\n\t\t\t\t);\n\t\t\tif (subs.length > 0) clauses.push({ [key]: subs });\n\t\t\tcontinue;\n\t\t}\n\t\tif (key === '$not') {\n\t\t\tthrow new Error(`${PKG}: $not is not supported by Pinecone`);\n\t\t}\n\t\tif (key.includes('.')) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PKG}: nested key paths (\"${key}\") are not supported by Pinecone (metadata is flat)`\n\t\t\t);\n\t\t}\n\t\tif (isOperatorRecord(value)) {\n\t\t\tconst translated = translateOperatorFilter(key, value);\n\t\t\tif (translated) clauses.push(translated);\n\t\t\tcontinue;\n\t\t}\n\t\tclauses.push({ [key]: { $eq: value } });\n\t}\n\tif (clauses.length === 0) return undefined;\n\tif (clauses.length === 1) return clauses[0];\n\n\treturn { $and: clauses };\n};\n\nconst scoreForMetric = (\n\trawScore: unknown,\n\tdistanceMetric: PineconeDistanceMetric\n): number => {\n\tif (typeof rawScore !== 'number' || !Number.isFinite(rawScore)) return 0;\n\tswitch (distanceMetric) {\n\t\tcase 'euclidean':\n\t\t\treturn 1 / (1 + Math.abs(rawScore));\n\t\tcase 'dotproduct':\n\t\tcase 'cosine':\n\t\tdefault:\n\t\t\treturn rawScore;\n\t}\n};\n\nconst buildPineconeRecord = (\n\tchunk: RAGUpsertInput['chunks'][number],\n\tvalues: number[]\n): PineconeRecord => {\n\tconst metadata: Record<string, MetadataValue> = {\n\t\t...sanitizeMetadata(chunk.metadata),\n\t\tchunkId: chunk.chunkId,\n\t\ttext: chunk.text\n\t};\n\tif (chunk.title) metadata.title = chunk.title;\n\tif (chunk.source) metadata.source = chunk.source;\n\n\treturn { id: chunk.chunkId, values, metadata };\n};\n\nconst extractQueryResult = (\n\tmatch: PineconeQueryMatch,\n\tdistanceMetric: PineconeDistanceMetric\n): RAGQueryResult => {\n\tconst meta = isObjectRecord(match.metadata) ? match.metadata : {};\n\tconst userMetadata: Record<string, unknown> = {};\n\tfor (const [key, value] of Object.entries(meta)) {\n\t\tif (RESERVED_METADATA_KEYS.has(key)) continue;\n\t\tuserMetadata[key] = value;\n\t}\n\tconst chunkId =\n\t\ttypeof meta.chunkId === 'string' ? meta.chunkId : String(match.id);\n\tconst chunkText = typeof meta.text === 'string' ? meta.text : '';\n\n\treturn {\n\t\tchunkId,\n\t\tchunkText,\n\t\ttitle: typeof meta.title === 'string' ? meta.title : undefined,\n\t\tsource: typeof meta.source === 'string' ? meta.source : undefined,\n\t\tmetadata:\n\t\t\tObject.keys(userMetadata).length > 0 ? userMetadata : undefined,\n\t\tscore: scoreForMetric(match.score, distanceMetric)\n\t};\n};\n\nexport const createPineconeStore = (\n\toptions: PineconeRAGOptions\n): RAGVectorStore => {\n\tconst vector = resolveVectorConfig(options ?? {});\n\tconst namespace =\n\t\ttypeof options.namespace === 'string' && options.namespace.length > 0\n\t\t\t? options.namespace\n\t\t\t: undefined;\n\tconst getClient = resolveIndexClientFactory(options ?? {});\n\n\tconst embed: RAGVectorStore['embed'] = async (input) => {\n\t\tif (typeof options.embedding === 'function') {\n\t\t\tconst result = await options.embedding(input);\n\n\t\t\treturn normalizeVector(result);\n\t\t}\n\n\t\treturn normalizeVector([\n\t\t\t...createRAGVector(input.text, vector.dimensions)\n\t\t]);\n\t};\n\n\tconst upsert = async (input: RAGUpsertInput): Promise<void> => {\n\t\tif (!input?.chunks || input.chunks.length === 0) return;\n\t\tconst client = await getClient();\n\t\tconst records = await Promise.all(\n\t\t\tinput.chunks.map(async (chunk) => {\n\t\t\t\tconst values =\n\t\t\t\t\tArray.isArray(chunk.embedding) && chunk.embedding.length > 0\n\t\t\t\t\t\t? normalizeVector(chunk.embedding)\n\t\t\t\t\t\t: await embed({ text: chunk.text });\n\n\t\t\t\treturn buildPineconeRecord(chunk, values);\n\t\t\t})\n\t\t);\n\t\tfor (const batch of chunkArray(records, PINECONE_UPSERT_BATCH_SIZE)) {\n\t\t\tawait client.upsert(batch);\n\t\t}\n\t};\n\n\tconst query = async (input: RAGQueryInput): Promise<RAGQueryResult[]> => {\n\t\tconst client = await getClient();\n\t\tconst filter = translateFilter(input.filter);\n\t\tconst queryInput: Record<string, unknown> = {\n\t\t\tvector: normalizeVector(input.queryVector),\n\t\t\ttopK: input.topK,\n\t\t\tincludeMetadata: true,\n\t\t\tincludeValues: false\n\t\t};\n\t\tif (filter) queryInput.filter = filter;\n\t\tconst result = await client.query(queryInput);\n\t\tconst matches = Array.isArray(result?.matches) ? result.matches : [];\n\n\t\treturn matches.map((match) =>\n\t\t\textractQueryResult(match, vector.distanceMetric)\n\t\t);\n\t};\n\n\tconst count = async (\n\t\tinput: { chunkIds?: string[]; filter?: Record<string, unknown> } = {}\n\t): Promise<number> => {\n\t\tconst client = await getClient();\n\t\tif (Array.isArray(input.chunkIds) && input.chunkIds.length > 0) {\n\t\t\tlet total = 0;\n\t\t\tfor (const batch of chunkArray(\n\t\t\t\tinput.chunkIds,\n\t\t\t\tPINECONE_FETCH_BATCH_SIZE\n\t\t\t)) {\n\t\t\t\tconst response = await client.fetch(batch);\n\t\t\t\ttotal += Object.keys(response?.records ?? {}).length;\n\t\t\t}\n\n\t\t\treturn total;\n\t\t}\n\t\tif (\n\t\t\tisObjectRecord(input.filter) &&\n\t\t\tObject.keys(input.filter).length > 0\n\t\t) {\n\t\t\tconst filter = translateFilter(input.filter);\n\t\t\tconst probeVector = new Array(vector.dimensions).fill(0);\n\t\t\tconst queryInput: Record<string, unknown> = {\n\t\t\t\tvector: probeVector,\n\t\t\t\ttopK: PINECONE_FILTERED_COUNT_TOPK,\n\t\t\t\tincludeMetadata: false,\n\t\t\t\tincludeValues: false\n\t\t\t};\n\t\t\tif (filter) queryInput.filter = filter;\n\t\t\tconst result = await client.query(queryInput);\n\n\t\t\treturn Array.isArray(result?.matches) ? result.matches.length : 0;\n\t\t}\n\t\tconst stats = await client.describeIndexStats();\n\t\tif (namespace) {\n\t\t\treturn stats?.namespaces?.[namespace]?.recordCount ?? 0;\n\t\t}\n\n\t\treturn stats?.totalRecordCount ?? 0;\n\t};\n\n\tconst remove = async (\n\t\tinput: { chunkIds?: string[]; filter?: Record<string, unknown> } = {}\n\t): Promise<number> => {\n\t\tconst client = await getClient();\n\t\tif (Array.isArray(input.chunkIds) && input.chunkIds.length > 0) {\n\t\t\tfor (const batch of chunkArray(\n\t\t\t\tinput.chunkIds,\n\t\t\t\tPINECONE_FETCH_BATCH_SIZE\n\t\t\t)) {\n\t\t\t\ttry {\n\t\t\t\t\tawait client.deleteMany(batch);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!isPineconeNotFound(error)) throw error;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn input.chunkIds.length;\n\t\t}\n\t\tif (\n\t\t\tisObjectRecord(input.filter) &&\n\t\t\tObject.keys(input.filter).length > 0\n\t\t) {\n\t\t\tconst filter = translateFilter(input.filter);\n\t\t\tif (!filter) return 0;\n\t\t\tconst counted = await count({ filter: input.filter });\n\t\t\ttry {\n\t\t\t\tawait client.deleteMany({ filter });\n\t\t\t} catch (error) {\n\t\t\t\tif (!isPineconeNotFound(error)) throw error;\n\t\t\t}\n\n\t\t\treturn counted;\n\t\t}\n\n\t\treturn 0;\n\t};\n\n\tconst clear = async (): Promise<void> => {\n\t\tconst client = await getClient();\n\t\ttry {\n\t\t\tawait client.deleteAll();\n\t\t} catch (error) {\n\t\t\tif (!isPineconeNotFound(error)) throw error;\n\t\t}\n\t};\n\n\treturn {\n\t\tembed,\n\t\tquery,\n\t\tupsert,\n\t\tcount,\n\t\tdelete: remove,\n\t\tclear,\n\t\tgetCapabilities: () => ({\n\t\t\tbackend: 'custom',\n\t\t\tpersistence: 'external',\n\t\t\tnativeVectorSearch: true,\n\t\t\tserverSideFiltering: true,\n\t\t\tstreamingIngestStatus: false\n\t\t})\n\t} as RAGVectorStore;\n};\n\nconst DEFAULT_INDEX_READY_TIMEOUT_MS = 120000;\nconst DEFAULT_INDEX_READY_POLL_MS = 1500;\nconst DEFAULT_SERVERLESS_SPEC: PineconeServerlessSpec = {\n\tserverless: { cloud: 'aws', region: 'us-east-1' }\n};\n\ntype PineconeErrorLike = {\n\tstatus?: number;\n\tstatusCode?: number;\n\tresponse?: { status?: number };\n\tname?: string;\n\tmessage?: string;\n};\n\nconst isPineconeNotFound = (error: unknown): boolean => {\n\tif (!error) return false;\n\tconst err = error as PineconeErrorLike;\n\tconst status = err.status ?? err.statusCode ?? err.response?.status ?? undefined;\n\tif (status === 404) return true;\n\tconst name = String(err.name ?? '');\n\tif (name === 'PineconeNotFoundError') return true;\n\tconst message = String(err.message ?? '').toLowerCase();\n\n\treturn (\n\t\tmessage.includes('not found') ||\n\t\tmessage.includes('does not exist') ||\n\t\tmessage.includes('404')\n\t);\n};\n\nconst resolveProvisioningClient = async (\n\toptions: DescribePineconeIndexOptions | EnsurePineconeIndexOptions\n): Promise<InstanceType<PineconeSDKModule['Pinecone']>> => {\n\tconst apiKey = options.apiKey ?? process.env.PINECONE_API_KEY;\n\tif (!apiKey) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: missing Pinecone apiKey (pass options.apiKey or set PINECONE_API_KEY)`\n\t\t);\n\t}\n\tif (\n\t\ttypeof options.indexName !== 'string' ||\n\t\toptions.indexName.length === 0\n\t) {\n\t\tthrow new Error(`${PKG}: indexName is required`);\n\t}\n\tconst { Pinecone } = await loadPineconeSDK();\n\n\treturn new Pinecone({ apiKey });\n};\n\nconst waitForIndexReady = async (\n\tpc: InstanceType<PineconeSDKModule['Pinecone']>,\n\tindexName: string,\n\ttimeoutMs: number,\n\tpollIntervalMs: number\n): Promise<PineconeIndexDescription> => {\n\tconst deadline = Date.now() + timeoutMs;\n\tfor (;;) {\n\t\tconst description = await pc.describeIndex(indexName);\n\t\tconst status = description?.status;\n\t\tconst ready =\n\t\t\tstatus?.ready === true ||\n\t\t\tstatus?.state === 'Ready' ||\n\t\t\tstatus?.state === 'ScalingUp';\n\t\tif (ready) return description;\n\t\tif (Date.now() >= deadline) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PKG}: index \"${indexName}\" did not become ready within ${timeoutMs}ms (last state: ${\n\t\t\t\t\tstatus?.state ?? 'unknown'\n\t\t\t\t})`\n\t\t\t);\n\t\t}\n\t\tawait new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n\t}\n};\n\nexport const describePineconeIndex = async (\n\toptions: DescribePineconeIndexOptions\n): Promise<PineconeIndexDescription | undefined> => {\n\tconst pc = await resolveProvisioningClient(options);\n\ttry {\n\t\treturn await pc.describeIndex(options.indexName);\n\t} catch (error) {\n\t\tif (isPineconeNotFound(error)) return undefined;\n\t\tthrow error;\n\t}\n};\n\nexport const ensurePineconeIndex = async (\n\toptions: EnsurePineconeIndexOptions\n): Promise<EnsurePineconeIndexResult> => {\n\tif (!Number.isInteger(options.dimensions) || options.dimensions <= 0) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: dimensions must be a positive integer (received ${String(\n\t\t\t\toptions.dimensions\n\t\t\t)})`\n\t\t);\n\t}\n\tconst metric = options.metric ?? 'cosine';\n\tif (!PINECONE_DISTANCE_METRICS.includes(metric)) {\n\t\tthrow new Error(\n\t\t\t`${PKG}: unsupported metric \"${metric}\". Allowed: ${PINECONE_DISTANCE_METRICS.join(\n\t\t\t\t', '\n\t\t\t)}`\n\t\t);\n\t}\n\tconst pc = await resolveProvisioningClient(options);\n\tconst timeoutMs = options.waitTimeoutMs ?? DEFAULT_INDEX_READY_TIMEOUT_MS;\n\tconst pollIntervalMs = options.pollIntervalMs ?? DEFAULT_INDEX_READY_POLL_MS;\n\tconst shouldWait = options.waitUntilReady !== false;\n\n\tlet existing: PineconeIndexDescription | undefined;\n\ttry {\n\t\texisting = await pc.describeIndex(options.indexName);\n\t} catch (error) {\n\t\tif (!isPineconeNotFound(error)) throw error;\n\t}\n\n\tif (existing) {\n\t\tif (existing.dimension !== options.dimensions) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PKG}: index \"${options.indexName}\" already exists with dimension=${existing.dimension}, but ${options.dimensions} was requested`\n\t\t\t);\n\t\t}\n\t\tif (existing.metric && existing.metric !== metric) {\n\t\t\tthrow new Error(\n\t\t\t\t`${PKG}: index \"${options.indexName}\" already exists with metric=\"${existing.metric}\", but \"${metric}\" was requested`\n\t\t\t);\n\t\t}\n\t\tif (shouldWait && existing.status?.ready !== true) {\n\t\t\tconst description = await waitForIndexReady(\n\t\t\t\tpc,\n\t\t\t\toptions.indexName,\n\t\t\t\ttimeoutMs,\n\t\t\t\tpollIntervalMs\n\t\t\t);\n\n\t\t\treturn { created: false, description };\n\t\t}\n\n\t\treturn { created: false, description: existing };\n\t}\n\n\tconst spec = options.spec ?? DEFAULT_SERVERLESS_SPEC;\n\tawait pc.createIndex({\n\t\tname: options.indexName,\n\t\tdimension: options.dimensions,\n\t\tmetric,\n\t\tspec,\n\t\t...(options.deletionProtection\n\t\t\t? { deletionProtection: options.deletionProtection }\n\t\t\t: {})\n\t});\n\n\tif (!shouldWait) {\n\t\tlet description: PineconeIndexDescription | undefined;\n\t\ttry {\n\t\t\tdescription = await pc.describeIndex(options.indexName);\n\t\t} catch (error) {\n\t\t\tif (!isPineconeNotFound(error)) throw error;\n\t\t}\n\n\t\treturn { created: true, description };\n\t}\n\n\tconst description = await waitForIndexReady(\n\t\tpc,\n\t\toptions.indexName,\n\t\ttimeoutMs,\n\t\tpollIntervalMs\n\t);\n\n\treturn { created: true, description };\n};\n\nexport const createPineconeRAGCollection = (\n\toptions: PineconeRAGOptions\n): RAGCollection =>\n\tcreateRAGCollection({\n\t\tstore: createPineconeStore(options)\n\t});\n\nexport const createPineconeRAG = (options: PineconeRAGOptions): PineconeRAG => {\n\tconst store = createPineconeStore(options);\n\tconst collection = createRAGCollection({ store });\n\n\treturn {\n\t\tstore,\n\t\tcollection,\n\t\tgetCapabilities: () => store.getCapabilities?.()\n\t};\n};\n"
+  ],
+  "mappings": ";;;;AAQA;AAAA;AAAA;AAAA;AAAA;AAMO,IAAM,qCAAqC;AAE3C,IAAM,4BAA4B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACD;AA4HA,IAAM,MAAM;AACZ,IAAM,qBAAqB;AAC3B,IAAM,0BAAkD;AACxD,IAAM,6BAA6B;AACnC,IAAM,4BAA4B;AAClC,IAAM,+BAA+B;AACrC,IAAM,yBAAyB,IAAI,IAAI,CAAC,WAAW,QAAQ,SAAS,QAAQ,CAAC;AAE7E,IAAM,iBAAiB,CAAC,UACvB,QAAQ,KAAK,KAAK,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAEpE,IAAM,mBAAmB,CAAC,UACzB,eAAe,KAAK,KACpB,OAAO,KAAK,KAAK,EAAE,SAAS,KAC5B,OAAO,KAAK,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,WAAW,GAAG,CAAC;AAEtD,IAAM,aAAa,CAAI,OAAqB,SAAwB;AAAA,EACnE,MAAM,MAAa,CAAC;AAAA,EACpB,SAAS,IAAI,EAAG,IAAI,MAAM,QAAQ,KAAK,MAAM;AAAA,IAC5C,IAAI,KAAK,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC;AAAA,EAClC;AAAA,EAEA,OAAO;AAAA;AAGR,IAAM,sBAAsB,CAC3B,YACkC;AAAA,EAClC,MAAM,SAAS,SAAS;AAAA,EACxB,IAAI,CAAC,UAAU,OAAO,aAAa,YAAY;AAAA,IAC9C,MAAM,IAAI,MACT,GAAG,yDACJ;AAAA,EACD;AAAA,EACA,MAAM,aAAa,OAAO,cAAc;AAAA,EACxC,IAAI,CAAC,OAAO,UAAU,UAAU,KAAK,cAAc,GAAG;AAAA,IACrD,MAAM,IAAI,MACT,GAAG,+DAA+D,OACjE,UACD,IACD;AAAA,EACD;AAAA,EACA,MAAM,iBAAiB,OAAO,kBAAkB;AAAA,EAChD,IAAI,CAAC,0BAA0B,SAAS,cAAc,GAAG;AAAA,IACxD,MAAM,IAAI,MACT,GAAG,oCAAoC,6BAA6B,0BAA0B,KAC7F,IACD,GACD;AAAA,EACD;AAAA,EAEA,OAAO,EAAE,UAAU,YAAY,YAAY,eAAe;AAAA;AAW3D,IAAI;AACJ,IAAM,kBAAkB,MAAkC;AAAA,EACzD,IAAI,CAAC,uBAAuB;AAAA,IAC3B,wBACQ,sCACN,MAAM,CAAC,UAAmB;AAAA,MAC3B,wBAAwB;AAAA,MACxB,MAAM,IAAI,MACT,GAAG,uFACF,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,IAEvD;AAAA,KACA;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAGR,IAAM,4BAA4B,CACjC,YAC0C;AAAA,EAC1C,MAAM,YACL,OAAO,QAAQ,cAAc,YAAY,QAAQ,UAAU,SAAS,IACjE,QAAQ,YACR;AAAA,EAEJ,IAAI;AAAA,EAEJ,MAAM,iBAAiB,CAAC,QAAkD;AAAA,IACzE,IAAI,CAAC,aAAa,OAAO,IAAI,cAAc;AAAA,MAAY,OAAO;AAAA,IAE9D,OAAO,IAAI,UAAU,SAAS;AAAA;AAAA,EAG/B,IAAI,QAAQ,QAAQ;AAAA,IACnB,MAAM,iBAAiB,QAAQ;AAAA,IAE/B,OAAO,YAAY;AAAA,MAClB,IAAI;AAAA,QAAQ,OAAO;AAAA,MACnB,SAAS,eAAe,cAAc;AAAA,MAEtC,OAAO;AAAA;AAAA,EAET;AAAA,EAEA,MAAM,YAAY,QAAQ;AAAA,EAC1B,IAAI,OAAO,cAAc,YAAY,UAAU,WAAW,GAAG;AAAA,IAC5D,MAAM,IAAI,MACT,GAAG,wDACJ;AAAA,EACD;AAAA,EACA,MAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAAA,EAC7C,IAAI,CAAC,QAAQ;AAAA,IACZ,MAAM,IAAI,MACT,GAAG,4EACJ;AAAA,EACD;AAAA,EAEA,OAAO,YAAY;AAAA,IAClB,IAAI;AAAA,MAAQ,OAAO;AAAA,IACnB,QAAQ,aAAa,MAAM,gBAAgB;AAAA,IAC3C,MAAM,KAAK,IAAI,SAAS,EAAE,OAAO,CAAC;AAAA,IAClC,MAAM,YAAY,QAAQ,YACvB,GAAG,MAAM,WAAW,QAAQ,SAAS,IACrC,GAAG,MAAM,SAAS;AAAA,IACrB,SAAS,eAAe,SAAS;AAAA,IAEjC,OAAO;AAAA;AAAA;AAIT,IAAM,wBAAwB,CAAC,UAA8C;AAAA,EAC5E,IAAI,UAAU,QAAQ,UAAU;AAAA,IAAW;AAAA,EAC3C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU;AAAA,IAAW,OAAO;AAAA,EACpE,IAAI,OAAO,UAAU,UAAU;AAAA,IAC9B,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EACzC;AAAA,EACA,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,IACzB,MAAM,UAAoB,CAAC;AAAA,IAC3B,WAAW,SAAS,OAAO;AAAA,MAC1B,IAAI,UAAU,QAAQ,UAAU;AAAA,QAAW;AAAA,MAC3C,IAAI,OAAO,UAAU,UAAU;AAAA,QAC9B,QAAQ,KAAK,KAAK;AAAA,QAClB;AAAA,MACD;AAAA,MACA,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,GAAG;AAAA,QACxD,QAAQ,KAAK,OAAO,KAAK,CAAC;AAAA,QAC1B;AAAA,MACD;AAAA,MACA,IAAI,OAAO,UAAU,WAAW;AAAA,QAC/B,QAAQ,KAAK,OAAO,KAAK,CAAC;AAAA,QAC1B;AAAA,MACD;AAAA,IACD;AAAA,IAEA,OAAO;AAAA,EACR;AAAA,EACA,IAAI,OAAO,UAAU,UAAU;AAAA,IAC9B,IAAI;AAAA,MACH,OAAO,KAAK,UAAU,KAAK;AAAA,MAC1B,MAAM;AAAA,MACP;AAAA;AAAA,EAEF;AAAA,EAEA;AAAA;AAGD,IAAM,mBAAmB,CACxB,aACmC;AAAA,EACnC,IAAI,CAAC,eAAe,QAAQ;AAAA,IAAG,OAAO,CAAC;AAAA,EACvC,MAAM,MAAqC,CAAC;AAAA,EAC5C,YAAY,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG;AAAA,IACpD,IAAI,uBAAuB,IAAI,GAAG;AAAA,MAAG;AAAA,IACrC,MAAM,YAAY,sBAAsB,KAAK;AAAA,IAC7C,IAAI,cAAc;AAAA,MAAW;AAAA,IAC7B,IAAI,OAAO;AAAA,EACZ;AAAA,EAEA,OAAO;AAAA;AAGR,IAAM,0BAA0B,CAC/B,OACA,mBACgC;AAAA,EAChC,MAAM,SAAkC,CAAC;AAAA,EACzC,MAAM,WAA6B,CAAC;AAAA,EACpC,YAAY,IAAI,UAAU,OAAO,QAAQ,cAAc,GAAG;AAAA,IACzD,QAAQ;AAAA,WACF;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,WACA;AAAA,QACJ,OAAO,MAAM;AAAA,QACb;AAAA,WACI;AAAA,QACJ,IAAI,MAAM,QAAQ,KAAK;AAAA,UAAG,OAAO,MAAM;AAAA,QACvC;AAAA,WACI;AAAA,QACJ,OAAO,UAAU,QAAQ,KAAK;AAAA,QAC9B;AAAA,WACI;AAAA,QACJ,OAAO,MAAM,CAAC,KAAK;AAAA,QACnB;AAAA,WACI;AAAA,QACJ,IAAI,MAAM,QAAQ,KAAK;AAAA,UAAG,OAAO,MAAM;AAAA,QACvC;AAAA,WACI;AAAA,QACJ,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACzB,WAAW,SAAS,OAAO;AAAA,YAC1B,SAAS,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AAAA,UAC5C;AAAA,QACD;AAAA,QACA;AAAA;AAAA,QAEA,MAAM,IAAI,MAAM,GAAG,qCAAqC,KAAK;AAAA;AAAA,EAEhE;AAAA,EACA,IAAI,SAAS,WAAW,GAAG;AAAA,IAC1B,OAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,GAAG,QAAQ,OAAO,IAAI;AAAA,EAC/D;AAAA,EACA,IAAI,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG;AAAA,IACrC,OAAO,SAAS,WAAW,IAAI,SAAS,KAAK,EAAE,MAAM,SAAS;AAAA,EAC/D;AAAA,EAEA,OAAO,EAAE,MAAM,CAAC,GAAG,QAAQ,OAAO,GAAG,GAAG,QAAQ,EAAE;AAAA;AAGnD,IAAM,kBAAkB,CAAC,WAAgD;AAAA,EACxE,IAAI,CAAC,eAAe,MAAM,KAAK,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG;AAAA,IAChE;AAAA,EACD;AAAA,EACA,MAAM,UAA4B,CAAC;AAAA,EACnC,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IAClD,IAAI,QAAQ,UAAU,QAAQ,OAAO;AAAA,MACpC,IAAI,CAAC,MAAM,QAAQ,KAAK;AAAA,QAAG;AAAA,MAC3B,MAAM,OAAO,MACX,IAAI,CAAC,UAAU,gBAAgB,KAAK,CAAC,EACrC,OACA,CAAC,UAAmC,UAAU,SAC/C;AAAA,MACD,IAAI,KAAK,SAAS;AAAA,QAAG,QAAQ,KAAK,GAAG,MAAM,KAAK,CAAC;AAAA,MACjD;AAAA,IACD;AAAA,IACA,IAAI,QAAQ,QAAQ;AAAA,MACnB,MAAM,IAAI,MAAM,GAAG,wCAAwC;AAAA,IAC5D;AAAA,IACA,IAAI,IAAI,SAAS,GAAG,GAAG;AAAA,MACtB,MAAM,IAAI,MACT,GAAG,2BAA2B,wDAC/B;AAAA,IACD;AAAA,IACA,IAAI,iBAAiB,KAAK,GAAG;AAAA,MAC5B,MAAM,aAAa,wBAAwB,KAAK,KAAK;AAAA,MACrD,IAAI;AAAA,QAAY,QAAQ,KAAK,UAAU;AAAA,MACvC;AAAA,IACD;AAAA,IACA,QAAQ,KAAK,GAAG,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;AAAA,EACvC;AAAA,EACA,IAAI,QAAQ,WAAW;AAAA,IAAG;AAAA,EAC1B,IAAI,QAAQ,WAAW;AAAA,IAAG,OAAO,QAAQ;AAAA,EAEzC,OAAO,EAAE,MAAM,QAAQ;AAAA;AAGxB,IAAM,iBAAiB,CACtB,UACA,mBACY;AAAA,EACZ,IAAI,OAAO,aAAa,YAAY,CAAC,OAAO,SAAS,QAAQ;AAAA,IAAG,OAAO;AAAA,EACvE,QAAQ;AAAA,SACF;AAAA,MACJ,OAAO,KAAK,IAAI,KAAK,IAAI,QAAQ;AAAA,SAC7B;AAAA,SACA;AAAA;AAAA,MAEJ,OAAO;AAAA;AAAA;AAIV,IAAM,sBAAsB,CAC3B,OACA,WACoB;AAAA,EACpB,MAAM,WAA0C;AAAA,OAC5C,iBAAiB,MAAM,QAAQ;AAAA,IAClC,SAAS,MAAM;AAAA,IACf,MAAM,MAAM;AAAA,EACb;AAAA,EACA,IAAI,MAAM;AAAA,IAAO,SAAS,QAAQ,MAAM;AAAA,EACxC,IAAI,MAAM;AAAA,IAAQ,SAAS,SAAS,MAAM;AAAA,EAE1C,OAAO,EAAE,IAAI,MAAM,SAAS,QAAQ,SAAS;AAAA;AAG9C,IAAM,qBAAqB,CAC1B,OACA,mBACoB;AAAA,EACpB,MAAM,OAAO,eAAe,MAAM,QAAQ,IAAI,MAAM,WAAW,CAAC;AAAA,EAChE,MAAM,eAAwC,CAAC;AAAA,EAC/C,YAAY,KAAK,UAAU,OAAO,QAAQ,IAAI,GAAG;AAAA,IAChD,IAAI,uBAAuB,IAAI,GAAG;AAAA,MAAG;AAAA,IACrC,aAAa,OAAO;AAAA,EACrB;AAAA,EACA,MAAM,UACL,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,OAAO,MAAM,EAAE;AAAA,EAClE,MAAM,YAAY,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO;AAAA,EAE9D,OAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA,IACrD,QAAQ,OAAO,KAAK,WAAW,WAAW,KAAK,SAAS;AAAA,IACxD,UACC,OAAO,KAAK,YAAY,EAAE,SAAS,IAAI,eAAe;AAAA,IACvD,OAAO,eAAe,MAAM,OAAO,cAAc;AAAA,EAClD;AAAA;AAGM,IAAM,sBAAsB,CAClC,YACoB;AAAA,EACpB,MAAM,SAAS,oBAAoB,WAAW,CAAC,CAAC;AAAA,EAChD,MAAM,YACL,OAAO,QAAQ,cAAc,YAAY,QAAQ,UAAU,SAAS,IACjE,QAAQ,YACR;AAAA,EACJ,MAAM,YAAY,0BAA0B,WAAW,CAAC,CAAC;AAAA,EAEzD,MAAM,QAAiC,OAAO,UAAU;AAAA,IACvD,IAAI,OAAO,QAAQ,cAAc,YAAY;AAAA,MAC5C,MAAM,SAAS,MAAM,QAAQ,UAAU,KAAK;AAAA,MAE5C,OAAO,gBAAgB,MAAM;AAAA,IAC9B;AAAA,IAEA,OAAO,gBAAgB;AAAA,MACtB,GAAG,gBAAgB,MAAM,MAAM,OAAO,UAAU;AAAA,IACjD,CAAC;AAAA;AAAA,EAGF,MAAM,SAAS,OAAO,UAAyC;AAAA,IAC9D,IAAI,CAAC,OAAO,UAAU,MAAM,OAAO,WAAW;AAAA,MAAG;AAAA,IACjD,MAAM,SAAS,MAAM,UAAU;AAAA,IAC/B,MAAM,UAAU,MAAM,QAAQ,IAC7B,MAAM,OAAO,IAAI,OAAO,UAAU;AAAA,MACjC,MAAM,SACL,MAAM,QAAQ,MAAM,SAAS,KAAK,MAAM,UAAU,SAAS,IACxD,gBAAgB,MAAM,SAAS,IAC/B,MAAM,MAAM,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,MAEpC,OAAO,oBAAoB,OAAO,MAAM;AAAA,KACxC,CACF;AAAA,IACA,WAAW,SAAS,WAAW,SAAS,0BAA0B,GAAG;AAAA,MACpE,MAAM,OAAO,OAAO,KAAK;AAAA,IAC1B;AAAA;AAAA,EAGD,MAAM,QAAQ,OAAO,UAAoD;AAAA,IACxE,MAAM,SAAS,MAAM,UAAU;AAAA,IAC/B,MAAM,SAAS,gBAAgB,MAAM,MAAM;AAAA,IAC3C,MAAM,aAAsC;AAAA,MAC3C,QAAQ,gBAAgB,MAAM,WAAW;AAAA,MACzC,MAAM,MAAM;AAAA,MACZ,iBAAiB;AAAA,MACjB,eAAe;AAAA,IAChB;AAAA,IACA,IAAI;AAAA,MAAQ,WAAW,SAAS;AAAA,IAChC,MAAM,SAAS,MAAM,OAAO,MAAM,UAAU;AAAA,IAC5C,MAAM,UAAU,MAAM,QAAQ,QAAQ,OAAO,IAAI,OAAO,UAAU,CAAC;AAAA,IAEnE,OAAO,QAAQ,IAAI,CAAC,UACnB,mBAAmB,OAAO,OAAO,cAAc,CAChD;AAAA;AAAA,EAGD,MAAM,QAAQ,OACb,QAAmE,CAAC,MAC/C;AAAA,IACrB,MAAM,SAAS,MAAM,UAAU;AAAA,IAC/B,IAAI,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM,SAAS,SAAS,GAAG;AAAA,MAC/D,IAAI,QAAQ;AAAA,MACZ,WAAW,SAAS,WACnB,MAAM,UACN,yBACD,GAAG;AAAA,QACF,MAAM,WAAW,MAAM,OAAO,MAAM,KAAK;AAAA,QACzC,SAAS,OAAO,KAAK,UAAU,WAAW,CAAC,CAAC,EAAE;AAAA,MAC/C;AAAA,MAEA,OAAO;AAAA,IACR;AAAA,IACA,IACC,eAAe,MAAM,MAAM,KAC3B,OAAO,KAAK,MAAM,MAAM,EAAE,SAAS,GAClC;AAAA,MACD,MAAM,SAAS,gBAAgB,MAAM,MAAM;AAAA,MAC3C,MAAM,cAAc,IAAI,MAAM,OAAO,UAAU,EAAE,KAAK,CAAC;AAAA,MACvD,MAAM,aAAsC;AAAA,QAC3C,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,iBAAiB;AAAA,QACjB,eAAe;AAAA,MAChB;AAAA,MACA,IAAI;AAAA,QAAQ,WAAW,SAAS;AAAA,MAChC,MAAM,SAAS,MAAM,OAAO,MAAM,UAAU;AAAA,MAE5C,OAAO,MAAM,QAAQ,QAAQ,OAAO,IAAI,OAAO,QAAQ,SAAS;AAAA,IACjE;AAAA,IACA,MAAM,QAAQ,MAAM,OAAO,mBAAmB;AAAA,IAC9C,IAAI,WAAW;AAAA,MACd,OAAO,OAAO,aAAa,YAAY,eAAe;AAAA,IACvD;AAAA,IAEA,OAAO,OAAO,oBAAoB;AAAA;AAAA,EAGnC,MAAM,SAAS,OACd,QAAmE,CAAC,MAC/C;AAAA,IACrB,MAAM,SAAS,MAAM,UAAU;AAAA,IAC/B,IAAI,MAAM,QAAQ,MAAM,QAAQ,KAAK,MAAM,SAAS,SAAS,GAAG;AAAA,MAC/D,WAAW,SAAS,WACnB,MAAM,UACN,yBACD,GAAG;AAAA,QACF,IAAI;AAAA,UACH,MAAM,OAAO,WAAW,KAAK;AAAA,UAC5B,OAAO,OAAO;AAAA,UACf,IAAI,CAAC,mBAAmB,KAAK;AAAA,YAAG,MAAM;AAAA;AAAA,MAExC;AAAA,MAEA,OAAO,MAAM,SAAS;AAAA,IACvB;AAAA,IACA,IACC,eAAe,MAAM,MAAM,KAC3B,OAAO,KAAK,MAAM,MAAM,EAAE,SAAS,GAClC;AAAA,MACD,MAAM,SAAS,gBAAgB,MAAM,MAAM;AAAA,MAC3C,IAAI,CAAC;AAAA,QAAQ,OAAO;AAAA,MACpB,MAAM,UAAU,MAAM,MAAM,EAAE,QAAQ,MAAM,OAAO,CAAC;AAAA,MACpD,IAAI;AAAA,QACH,MAAM,OAAO,WAAW,EAAE,OAAO,CAAC;AAAA,QACjC,OAAO,OAAO;AAAA,QACf,IAAI,CAAC,mBAAmB,KAAK;AAAA,UAAG,MAAM;AAAA;AAAA,MAGvC,OAAO;AAAA,IACR;AAAA,IAEA,OAAO;AAAA;AAAA,EAGR,MAAM,QAAQ,YAA2B;AAAA,IACxC,MAAM,SAAS,MAAM,UAAU;AAAA,IAC/B,IAAI;AAAA,MACH,MAAM,OAAO,UAAU;AAAA,MACtB,OAAO,OAAO;AAAA,MACf,IAAI,CAAC,mBAAmB,KAAK;AAAA,QAAG,MAAM;AAAA;AAAA;AAAA,EAIxC,OAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO;AAAA,MACvB,SAAS;AAAA,MACT,aAAa;AAAA,MACb,oBAAoB;AAAA,MACpB,qBAAqB;AAAA,MACrB,uBAAuB;AAAA,IACxB;AAAA,EACD;AAAA;AAGD,IAAM,iCAAiC;AACvC,IAAM,8BAA8B;AACpC,IAAM,0BAAkD;AAAA,EACvD,YAAY,EAAE,OAAO,OAAO,QAAQ,YAAY;AACjD;AAUA,IAAM,qBAAqB,CAAC,UAA4B;AAAA,EACvD,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EACnB,MAAM,MAAM;AAAA,EACZ,MAAM,SAAS,IAAI,UAAU,IAAI,cAAc,IAAI,UAAU,UAAU;AAAA,EACvE,IAAI,WAAW;AAAA,IAAK,OAAO;AAAA,EAC3B,MAAM,OAAO,OAAO,IAAI,QAAQ,EAAE;AAAA,EAClC,IAAI,SAAS;AAAA,IAAyB,OAAO;AAAA,EAC7C,MAAM,UAAU,OAAO,IAAI,WAAW,EAAE,EAAE,YAAY;AAAA,EAEtD,OACC,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,KAAK;AAAA;AAIxB,IAAM,4BAA4B,OACjC,YAC0D;AAAA,EAC1D,MAAM,SAAS,QAAQ,UAAU,QAAQ,IAAI;AAAA,EAC7C,IAAI,CAAC,QAAQ;AAAA,IACZ,MAAM,IAAI,MACT,GAAG,4EACJ;AAAA,EACD;AAAA,EACA,IACC,OAAO,QAAQ,cAAc,YAC7B,QAAQ,UAAU,WAAW,GAC5B;AAAA,IACD,MAAM,IAAI,MAAM,GAAG,4BAA4B;AAAA,EAChD;AAAA,EACA,QAAQ,aAAa,MAAM,gBAAgB;AAAA,EAE3C,OAAO,IAAI,SAAS,EAAE,OAAO,CAAC;AAAA;AAG/B,IAAM,oBAAoB,OACzB,IACA,WACA,WACA,mBACuC;AAAA,EACvC,MAAM,WAAW,KAAK,IAAI,IAAI;AAAA,EAC9B,UAAS;AAAA,IACR,MAAM,cAAc,MAAM,GAAG,cAAc,SAAS;AAAA,IACpD,MAAM,SAAS,aAAa;AAAA,IAC5B,MAAM,QACL,QAAQ,UAAU,QAClB,QAAQ,UAAU,WAClB,QAAQ,UAAU;AAAA,IACnB,IAAI;AAAA,MAAO,OAAO;AAAA,IAClB,IAAI,KAAK,IAAI,KAAK,UAAU;AAAA,MAC3B,MAAM,IAAI,MACT,GAAG,eAAe,0CAA0C,4BAC3D,QAAQ,SAAS,YAEnB;AAAA,IACD;AAAA,IACA,MAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,cAAc,CAAC;AAAA,EACnE;AAAA;AAGM,IAAM,wBAAwB,OACpC,YACmD;AAAA,EACnD,MAAM,KAAK,MAAM,0BAA0B,OAAO;AAAA,EAClD,IAAI;AAAA,IACH,OAAO,MAAM,GAAG,cAAc,QAAQ,SAAS;AAAA,IAC9C,OAAO,OAAO;AAAA,IACf,IAAI,mBAAmB,KAAK;AAAA,MAAG;AAAA,IAC/B,MAAM;AAAA;AAAA;AAID,IAAM,sBAAsB,OAClC,YACwC;AAAA,EACxC,IAAI,CAAC,OAAO,UAAU,QAAQ,UAAU,KAAK,QAAQ,cAAc,GAAG;AAAA,IACrE,MAAM,IAAI,MACT,GAAG,wDAAwD,OAC1D,QAAQ,UACT,IACD;AAAA,EACD;AAAA,EACA,MAAM,SAAS,QAAQ,UAAU;AAAA,EACjC,IAAI,CAAC,0BAA0B,SAAS,MAAM,GAAG;AAAA,IAChD,MAAM,IAAI,MACT,GAAG,4BAA4B,qBAAqB,0BAA0B,KAC7E,IACD,GACD;AAAA,EACD;AAAA,EACA,MAAM,KAAK,MAAM,0BAA0B,OAAO;AAAA,EAClD,MAAM,YAAY,QAAQ,iBAAiB;AAAA,EAC3C,MAAM,iBAAiB,QAAQ,kBAAkB;AAAA,EACjD,MAAM,aAAa,QAAQ,mBAAmB;AAAA,EAE9C,IAAI;AAAA,EACJ,IAAI;AAAA,IACH,WAAW,MAAM,GAAG,cAAc,QAAQ,SAAS;AAAA,IAClD,OAAO,OAAO;AAAA,IACf,IAAI,CAAC,mBAAmB,KAAK;AAAA,MAAG,MAAM;AAAA;AAAA,EAGvC,IAAI,UAAU;AAAA,IACb,IAAI,SAAS,cAAc,QAAQ,YAAY;AAAA,MAC9C,MAAM,IAAI,MACT,GAAG,eAAe,QAAQ,4CAA4C,SAAS,kBAAkB,QAAQ,0BAC1G;AAAA,IACD;AAAA,IACA,IAAI,SAAS,UAAU,SAAS,WAAW,QAAQ;AAAA,MAClD,MAAM,IAAI,MACT,GAAG,eAAe,QAAQ,0CAA0C,SAAS,iBAAiB,uBAC/F;AAAA,IACD;AAAA,IACA,IAAI,cAAc,SAAS,QAAQ,UAAU,MAAM;AAAA,MAClD,MAAM,eAAc,MAAM,kBACzB,IACA,QAAQ,WACR,WACA,cACD;AAAA,MAEA,OAAO,EAAE,SAAS,OAAO,0BAAY;AAAA,IACtC;AAAA,IAEA,OAAO,EAAE,SAAS,OAAO,aAAa,SAAS;AAAA,EAChD;AAAA,EAEA,MAAM,OAAO,QAAQ,QAAQ;AAAA,EAC7B,MAAM,GAAG,YAAY;AAAA,IACpB,MAAM,QAAQ;AAAA,IACd,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA;AAAA,OACI,QAAQ,qBACT,EAAE,oBAAoB,QAAQ,mBAAmB,IACjD,CAAC;AAAA,EACL,CAAC;AAAA,EAED,IAAI,CAAC,YAAY;AAAA,IAChB,IAAI;AAAA,IACJ,IAAI;AAAA,MACH,eAAc,MAAM,GAAG,cAAc,QAAQ,SAAS;AAAA,MACrD,OAAO,OAAO;AAAA,MACf,IAAI,CAAC,mBAAmB,KAAK;AAAA,QAAG,MAAM;AAAA;AAAA,IAGvC,OAAO,EAAE,SAAS,MAAM,0BAAY;AAAA,EACrC;AAAA,EAEA,MAAM,cAAc,MAAM,kBACzB,IACA,QAAQ,WACR,WACA,cACD;AAAA,EAEA,OAAO,EAAE,SAAS,MAAM,YAAY;AAAA;AAG9B,IAAM,8BAA8B,CAC1C,YAEA,oBAAoB;AAAA,EACnB,OAAO,oBAAoB,OAAO;AACnC,CAAC;AAEK,IAAM,oBAAoB,CAAC,YAA6C;AAAA,EAC9E,MAAM,QAAQ,oBAAoB,OAAO;AAAA,EACzC,MAAM,aAAa,oBAAoB,EAAE,MAAM,CAAC;AAAA,EAEhD,OAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA,iBAAiB,MAAM,MAAM,kBAAkB;AAAA,EAChD;AAAA;",
+  "debugId": "2B01AEA5BCA9D5E464756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@absolutejs/rag-pinecone",
+	"version": "0.0.2",
+	"description": "Pinecone vector-store adapter for @absolutejs/rag",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/rag-adapters.git",
+		"directory": "pinecone"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "CC BY-NC 4.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"absolutejs",
+		"rag",
+		"pinecone",
+		"vector"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/rag --external @pinecone-database/pinecone && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run build && bun publish"
+	},
+	"dependencies": {
+		"@absolutejs/rag": "^0.0.19"
+	},
+	"peerDependencies": {
+		"@pinecone-database/pinecone": ">=5.0.0 <7.0.0"
+	},
+	"devDependencies": {
+		"@pinecone-database/pinecone": ">=5.0.0 <7.0.0",
+		"@types/bun": "1.2.9",
+		"prettier": "3.5.3",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	]
+}