AbsoluteJS

RAG Adapters

@absolutejs/rag-adaptersworkspacealphaAI

Vector-store adapters for @absolutejs/rag (Pinecone, PostgreSQL/pgvector, SQLite)

#Installation

BASH
git clone https://github.com/absolutejs/rag-adapters.git

#Capabilities

Overview

Vector-store adapters for @absolutejs/rag — a private workspace monorepo. Each adapter is published as its own package and depends on @absolutejs/rag; install only the one for your backend.

Adapter — Package — Backend — Status

pinecone/ — @absolutejs/rag-pinecone — Pinecone — ✅

Show 2 more

postgres/ — @absolutejs/rag-postgres — PostgreSQL/pgvector — ✅

sqlite/ — @absolutejs/rag-sqlite — SQLite + optional native vec0 — ✅

Why a monorepo

Adapters share the RAGVectorStore contract from @absolutejs/rag. Keeping them in one workspace means a contract change can update every adapter in a single PR, with one CI and one bun install — while each still publishes independently so consumers pull only the backend (and its heavy deps) they actually use.

Repository composition

3 public packages and 0 private workspace projects are versioned and developed together.

Outcomes

What you can build

Overview

Vector-store adapters for @absolutejs/rag — a private workspace monorepo. Each adapter is published as its own package and depends on @absolutejs/rag; install only the one for your backend.

Why a monorepo

Adapters share the RAGVectorStore contract from @absolutejs/rag. Keeping them in one workspace means a contract change can update every adapter in a single PR, with one CI and one bun install — while each still publishes independently so consumers pull only the backend (and its heavy deps) they actually use.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/rag-adapters 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-adapters example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Develop

Partial snippet

Working example for Develop.

BASH
bun install          # installs every workspace member
bun run typecheck    # across all adapters
bun run test         # across all adapters
bun run build        # across all adapters

#Workspace contents

3 public packages and 0 private workspace projects are maintained in this repository.

#Package commands

Scripts declared by this project’s package manifest.

bun run buildbun run --filter './*' build
bun run formatprettier --write "./*/src/**/*.{ts,json,md}"
bun run testbun test
bun run typecheckbun run --filter './*' typecheck
Workspace project
This workspace project is not published as a standalone npm package. Use its repository and the accurately labeled public or private workspace contents below.