@absolutejs/rag 0.0.20 → 0.0.22

package/dist/src/adapters/sync.d.ts

@@ -0,0 +1,21 @@
+import type { SyncEngine } from "@absolutejs/sync/engine";
+import type { RAGVectorStore } from "@absolutejs/ai";
+import type { SyncRAGStoreOptions } from "../../types/adapters";
+/**
+ * A {@link RAGVectorStore} backed by the @absolutejs/sync engine: a drop-in for
+ * `createInMemoryRAGStore`, but retrieval is also **live**. Ingested chunks flow
+ * through the engine's change feed, so a registered search collection re-ranks as
+ * the corpus changes — subscribe to `store.retrievalCollection` over
+ * `store.engine`'s `syncSocket` and a query's results update with no refetch.
+ *
+ * Built on sync's `createVectorIndex` (one-shot semantic `query`) + a shared
+ * `createTextIndex` (one-shot `queryLexical` AND the live lexical collection). The
+ * vector stays in a server-side map keyed by chunk id, so emitted rows are light.
+ */
+export type SyncRAGStore = RAGVectorStore & {
+    /** The engine to mount with `syncSocket` for live retrieval. */
+    engine: SyncEngine;
+    /** Collection name to subscribe to (params = the query string) for live retrieval. */
+    retrievalCollection: string;
+};
+export declare const createSyncRAGStore: (options?: SyncRAGStoreOptions) => SyncRAGStore;

package/dist/src/index.d.ts

@@ -20,6 +20,8 @@ export { createRAGBunS3SyncClient, createRAGDirectorySyncSource, createRAGEmailS
 export { createRAGFileJobStateStore } from "./internal/jobState";
 export { createRAGCollection, ingestDocuments, ingestRAGDocuments, searchDocuments, } from "./retrieval/collection";
 export { createInMemoryRAGStore } from "./adapters/inMemory";
+export { createSyncRAGStore } from "./adapters/sync";
+export type { SyncRAGStore } from "./adapters/sync";
 export { createRAGVector, normalizeVector, querySimilarity, } from "./adapters/utils";
 export type { SQLiteRAGSearchTraceStoreOptions } from "./quality/quality";
 export type { AnthropicOCRConfig, CrossEncoderRerankerConfig, GeminiEmbeddingsConfig, GeminiOCRConfig, GmailEmailSyncConfig, GraphEmailSyncConfig, IMAPEmailSyncConfig, OllamaEmbeddingsConfig, OllamaOCRConfig, OllamaTranscriptionConfig, OpenAICompatibleEmbeddingsConfig, OpenAICompatibleOCRConfig, OpenAICompatibleTranscriptionConfig, OpenAIEmbeddingsConfig, OpenAIOCRConfig, OpenAITranscriptionConfig, } from "../types/providers";

package/dist/types/adapters.d.ts

@@ -1,4 +1,20 @@
+import type { RAGEmbeddingFunction } from "@absolutejs/ai";
+import type { SyncEngine } from "@absolutejs/sync/engine";
 export type InMemoryRAGStoreOptions = {
     dimensions?: number;
     mockEmbedding?: (text: string) => Promise<number[]>;
 };
+export type SyncRAGStoreOptions = {
+    /** Live retrieval collection name (subscribe with the query string). Default `ragRetrieval`. */
+    collection?: string;
+    /** Embedding dimensions for the deterministic fallback. */
+    dimensions?: number;
+    /** Real embedding provider (e.g. from @absolutejs/rag); falls back to a deterministic vector. */
+    embedding?: RAGEmbeddingFunction;
+    /** Engine to register on (one is created if omitted). */
+    engine?: SyncEngine;
+    /** Test/demo embedding by text. */
+    mockEmbedding?: (text: string) => Promise<number[]>;
+    /** Change-feed table name the live collection reads. Default `ragChunks`. */
+    table?: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/rag",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "Standalone RAG ingestion, sync, retrieval, evaluation, clients, and framework adapters extracted from AbsoluteJS",
   "license": "BSL-1.1",
   "type": "module",
@@ -54,7 +54,8 @@
   },
   "dependencies": {
     "@absolutejs/ai": "^0.0.9",
-    "@absolutejs/linked-providers": "0.0.2"
+    "@absolutejs/linked-providers": "0.0.2",
+    "@absolutejs/sync": "^1.8.1"
   },
   "peerDependencies": {
     "@angular/core": "^21.0.0",