AbsoluteJS

@absolutejs/rag-pinecone

@absolutejs/rag-pineconev0.0.13betaAI

Pinecone vector-store adapter for @absolutejs/rag

#Installation

BASH
bun add @absolutejs/rag-pinecone

#Capabilities

Overview

Pinecone vector-store adapter for @absolutejs/rag. Treats Pinecone as the backend boundary: server-side filtering, native vector search, and explicit opt-in index provisioning helpers.

Usage

Index provisioning

The Pinecone index is not auto-provisioned at runtime. For explicit, opt-in provisioning use the exported helpers:

Outcomes

What you can build

Build on the supported package contract

Use @absolutejs/rag-pinecone through its supported public entry points.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/rag-pinecone version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/rag-pinecone example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Usage

Partial snippet

Working example for 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

Partial snippet

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
});

#Public entry points

Supported entry points declared by this package manifest.

Package entry point declared in package.json.

@absolutejs/rag-pinecone@absolutejs/rag-pinecone/manifest@absolutejs/rag-pinecone/manifest.json

#Package commands

Scripts declared by this package manifest.

bun run buildrm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --sourcemap --target=bun --external @absolutejs/rag --external @absolutejs/rag/adapter-kit --external @absolutejs/ai --external @pinecone-database/pinecone && tsc --project tsconfig.build.json && absolute-manifest emit
bun run formatprettier --write "./**/*.{ts,json,md}"
bun run testbun test
bun run typechecktsc --noEmit