@askdb/rag 0.2.0-beta.3 → 0.2.0-beta.4

package/README.md

@@ -20,8 +20,12 @@ pnpm add ai @ai-sdk/openai
 
 ```ts
 import { ask, loadSchema } from "@askdb/core";
-import { buildSchemaIndex, loadChunkerSourcesFromDir } from "@askdb/rag";
-import { createMemoryStore } from "@askdb/rag/stores/memory";
+import {
+  buildSchemaIndex,
+  loadChunkerSourcesFromDir,
+  createMemoryStore,
+  createAiSdkEmbedder,
+} from "@askdb/rag";
 
 const schemaDir = "./fixtures/schemas/orders-users.schema";
 const schema = loadSchema(schemaDir);
@@ -58,14 +62,47 @@ The default CLI embedder is a deterministic mock for smoke tests. Use `--embedde
 
 ## Public Surface
 
+All exports are available from the root `@askdb/rag` import. Sub-path imports are also supported and point to the same modules — use whichever style you prefer.
+
+### Core
+
 - `chunkSchema`, `chunkSchemaDir`, `chunkSchemaBundle` — deterministic Schema v2 chunking.
 - `buildSchemaIndex` — chunk, embed, upsert, write `schema.lock.json`, and return a retriever.
 - `createRetriever` — bind an existing store and embedder without indexing.
-- `@askdb/rag/stores/memory` — in-memory cosine store.
-- `@askdb/rag/stores/file` — binary embedding file plus JSON metadata.
-- `@askdb/rag/stores/pgvector` — pgvector adapter with documented setup SQL.
-- `@askdb/rag/embedders/ai-sdk` — generic AI SDK `EmbeddingModel<string>` adapter.
-- `@askdb/rag/embedders/openai` — optional OpenAI convenience helper using `text-embedding-3-small` by default.
+
+### Stores
+
+| Root import | Sub-path import | Description |
+|---|---|---|
+| `createMemoryStore` | `@askdb/rag/stores/memory` | In-memory cosine store. Zero deps. |
+| `createFileStore` | `@askdb/rag/stores/file` | Binary embedding file + JSON metadata. |
+| `createPgvectorStore` | `@askdb/rag/stores/pgvector` | pgvector adapter with documented setup SQL. Requires `pg`. |
+
+### Embedders
+
+| Root import | Sub-path import | Description |
+|---|---|---|
+| `createAiSdkEmbedder` | `@askdb/rag/embedders/ai-sdk` | Generic AI SDK `EmbeddingModel<string>` adapter. Requires `ai`. |
+| `createOpenAiEmbedder` | `@askdb/rag/embedders/openai` | OpenAI convenience helper (`text-embedding-3-small` by default). Requires `ai` and `@ai-sdk/openai`. |
+
+### Import examples
+
+```ts
+// Everything from the root — simplest DX
+import {
+  buildSchemaIndex,
+  createMemoryStore,
+  createAiSdkEmbedder,
+  createPgvectorStore,
+} from "@askdb/rag";
+
+// Sub-path imports — same modules, explicit namespacing
+import { createMemoryStore } from "@askdb/rag/stores/memory";
+import { createFileStore } from "@askdb/rag/stores/file";
+import { createPgvectorStore } from "@askdb/rag/stores/pgvector";
+import { createAiSdkEmbedder } from "@askdb/rag/embedders/ai-sdk";
+import { createOpenAiEmbedder } from "@askdb/rag/embedders/openai";
+```
 
 ## Sensitive Fields
 

package/dist/index.d.ts

@@ -3,4 +3,9 @@ export { chunkSchema, chunkSchemaDir, chunkSchemaBundle, loadChunkerSourcesFromD
 export { buildSchemaIndex, createRetriever, chunkContentHash, readLockFile, writeLockFile, type BuildSchemaIndexOptions, type BuildSchemaIndexResult, type IndexProgressEvent, type SchemaLockFile, } from "./indexer/index.js";
 export { synthesizeRetrievedDdl } from "@askdb/core";
 export { AskDbRagLogEvent, type AskDbRagLogEventName } from "./log-events.js";
+export { createMemoryStore, type MemoryStore } from "./stores/memory.js";
+export { createFileStore, type FileStore, type FileStoreOptions } from "./stores/file.js";
+export { createPgvectorStore, type PgvectorStore, type PgClient, type PgvectorIndexStrategy, type CreatePgvectorStoreOptions, } from "./stores/pgvector.js";
+export { createAiSdkEmbedder, type CreateAiSdkEmbedderOptions, type AiSdkEmbedderUsage, } from "./embedders/ai-sdk.js";
+export { createOpenAiEmbedder, type CreateOpenAiEmbedderOptions } from "./embedders/openai.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,SAAS,EACT,MAAM,EACN,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,8 +1,9 @@
 // Public API surface for `@askdb/rag`.
 //
-// Adapters live behind `./stores/<name>` sub-exports so consumers only
-// pay for what they import. The core (`.`) export ships chunker, indexer,
-// retriever wiring, and the BYO interfaces.
+// All adapters (stores, embedders) are re-exported here for convenience so
+// consumers can import everything from `@askdb/rag`. Sub-path exports
+// (`@askdb/rag/stores/memory`, `@askdb/rag/embedders/ai-sdk`, etc.) remain
+// available and point to the same modules — use whichever style you prefer.
 export { chunkSchema, chunkSchemaDir, chunkSchemaBundle, loadChunkerSourcesFromDir, loadChunkerSourcesFromBundleJson, DEFAULT_CHUNK_MAX_CHARS, } from "./chunker/index.js";
 export { buildSchemaIndex, createRetriever, chunkContentHash, readLockFile, writeLockFile, } from "./indexer/index.js";
 // Re-export the synthesis helper from core so consumers can import it from
@@ -10,4 +11,11 @@ export { buildSchemaIndex, createRetriever, chunkContentHash, readLockFile, writ
 // because `ask()` calls it internally when a retriever is supplied.
 export { synthesizeRetrievedDdl } from "@askdb/core";
 export { AskDbRagLogEvent } from "./log-events.js";
+// Stores
+export { createMemoryStore } from "./stores/memory.js";
+export { createFileStore } from "./stores/file.js";
+export { createPgvectorStore, } from "./stores/pgvector.js";
+// Embedders
+export { createAiSdkEmbedder, } from "./embedders/ai-sdk.js";
+export { createOpenAiEmbedder } from "./embedders/openai.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,4CAA4C;AAc5C,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,GAKxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,GAKd,MAAM,oBAAoB,CAAC;AAE5B,2EAA2E;AAC3E,4EAA4E;AAC5E,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAA6B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAc5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,uBAAuB,GAKxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,GAKd,MAAM,oBAAoB,CAAC;AAE5B,2EAA2E;AAC3E,4EAA4E;AAC5E,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAA6B,MAAM,iBAAiB,CAAC;AAE9E,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAyC,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,mBAAmB,GAKpB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,mBAAmB,GAGpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAoC,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdb/rag",
-  "version": "0.2.0-beta.3",
+  "version": "0.2.0-beta.4",
   "description": "AskDB RAG layer: deterministic chunker over Schema v2, BYO embedder + vector store (in-memory, file-backed, pgvector), and an optional retriever wired into @askdb/core ask().",
   "keywords": [
     "askdb",
@@ -65,8 +65,8 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@askdb/core": "0.5.0-beta.4",
-    "@askdb/config": "0.3.0-beta.2"
+    "@askdb/config": "0.3.0-beta.2",
+    "@askdb/core": "0.5.0-beta.4"
   },
   "peerDependencies": {
     "@ai-sdk/openai": ">=1",