veryfront 0.1.49 → 0.1.51

package/esm/src/embedding/embedding.js

@@ -1,5 +1,6 @@
 import { embed, embedMany } from "ai";
 import { resolveEmbeddingModel } from "./resolve.js";
+import { resolveConfiguredEmbeddingModel } from "./model-resolution.js";
 const DEFAULT_BATCH_SIZE = 100;
 /**
  * Creates an embedding facade.
@@ -13,7 +14,6 @@ const DEFAULT_BATCH_SIZE = 100;
  * @example
  * ```ts
  * const embedder = embedding({
- *   model: "openai/text-embedding-3-small",
  *   documentPrefix: "search_document: ",  // for Nomic, E5, BGE models
  *   queryPrefix: "search_query: ",
  * });
@@ -22,12 +22,13 @@ const DEFAULT_BATCH_SIZE = 100;
  * ```
  */
 export function embedding(config) {
-    const model = resolveEmbeddingModel(config.model);
+    const modelId = resolveConfiguredEmbeddingModel(config.model);
+    const model = resolveEmbeddingModel(modelId);
     const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
     const docPrefix = config.documentPrefix ?? "";
     const queryPrefix = config.queryPrefix ?? "";
     return {
-        model: config.model,
+        model: modelId,
         async embed(text) {
             const result = await embed({ model, value: queryPrefix + text });
             return result.embedding;

package/esm/src/embedding/index.d.ts

@@ -8,9 +8,9 @@
  *
  * @example
  * ```ts
- * import { uploadStore, createUploadHandler } from "veryfront/embedding";
+ * import { ragStore, createUploadHandler } from "veryfront/embedding";
  *
- * const store = uploadStore({ model: "openai/text-embedding-3-small" });
+ * const store = ragStore({});
  * export const { POST, GET, DELETE } = createUploadHandler(store);
  * ```
  */
@@ -19,11 +19,11 @@ export { embedding } from "./embedding.js";
 export { chunk } from "./chunk.js";
 export { cosineSimilarity as similarity } from "ai";
 export { vectorStore } from "./vector-store.js";
-export { uploadStore } from "./upload-store.js";
+export { ragStore } from "./rag-store.js";
 export { createUploadHandler } from "./upload-handler.js";
 export { loadUpload } from "./upload-loader.js";
 export { useUploads } from "./react/use-uploads.js";
 export type { UseUploadsOptions, UseUploadsResult } from "./react/use-uploads.js";
 export { clearEmbeddingProviders, registerEmbeddingProvider, resolveEmbeddingModel, } from "./resolve.js";
-export type { ChunkOptions, Embedding, EmbeddingConfig, SearchOptions, SearchResult, StoredChunk, UploadMeta, UploadSearchOptions, UploadSearchResult, UploadStore, UploadStoreConfig, UploadStoreData, VectorStore, VectorStoreConfig, } from "./types.js";
+export type { ChunkOptions, Embedding, EmbeddingConfig, RagChunk, RagDocumentMeta, RagSearchOptions, RagSearchResult, RagStore, RagStoreBackend, RagStoreConfig, RagStoreData, SearchOptions, SearchResult, VectorStore, VectorStoreConfig, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/embedding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/esm/src/embedding/index.js

@@ -8,9 +8,9 @@
  *
  * @example
  * ```ts
- * import { uploadStore, createUploadHandler } from "veryfront/embedding";
+ * import { ragStore, createUploadHandler } from "veryfront/embedding";
  *
- * const store = uploadStore({ model: "openai/text-embedding-3-small" });
+ * const store = ragStore({});
  * export const { POST, GET, DELETE } = createUploadHandler(store);
  * ```
  */
@@ -19,7 +19,7 @@ export { embedding } from "./embedding.js";
 export { chunk } from "./chunk.js";
 export { cosineSimilarity as similarity } from "ai";
 export { vectorStore } from "./vector-store.js";
-export { uploadStore } from "./upload-store.js";
+export { ragStore } from "./rag-store.js";
 export { createUploadHandler } from "./upload-handler.js";
 export { loadUpload } from "./upload-loader.js";
 export { useUploads } from "./react/use-uploads.js";

package/esm/src/embedding/model-resolution.d.ts

@@ -0,0 +1,4 @@
+export declare const AUTO_EMBEDDING_MODEL = "auto";
+export declare function normalizeEmbeddingModelConfig(model?: string): string;
+export declare function resolveConfiguredEmbeddingModel(model?: string): string;
+//# sourceMappingURL=model-resolution.d.ts.map

package/esm/src/embedding/model-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolution.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/model-resolution.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAE3C,wBAAgB,6BAA6B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAStE"}

package/esm/src/embedding/model-resolution.js

@@ -0,0 +1,16 @@
+import { getDefaultVeryfrontCloudEmbeddingModel, isVeryfrontCloudEnabled, } from "../platform/cloud/resolver.js";
+import { DEFAULT_LOCAL_EMBEDDING_MODEL } from "../provider/local/model-catalog.js";
+export const AUTO_EMBEDDING_MODEL = "auto";
+export function normalizeEmbeddingModelConfig(model) {
+    const normalized = model?.trim();
+    return normalized && normalized.length > 0 ? normalized : AUTO_EMBEDDING_MODEL;
+}
+export function resolveConfiguredEmbeddingModel(model) {
+    const normalized = normalizeEmbeddingModelConfig(model);
+    if (normalized !== AUTO_EMBEDDING_MODEL) {
+        return normalized;
+    }
+    return isVeryfrontCloudEnabled()
+        ? getDefaultVeryfrontCloudEmbeddingModel()
+        : `local/${DEFAULT_LOCAL_EMBEDDING_MODEL}`;
+}

package/esm/src/embedding/rag-store.d.ts

@@ -0,0 +1,27 @@
+import type { RagStore, RagStoreConfig } from "./types.js";
+/**
+ * Creates a persistent RAG store with lazy embedding and similarity search.
+ *
+ * Combines document ingestion, chunking, embedding, and vector search into
+ * a single factory. Documents are chunked on ingest; embeddings are generated
+ * lazily on the first search call to avoid blocking uploads on AI API calls.
+ *
+ * By default, this uses the local JSON store. When Veryfront Cloud bootstrap
+ * is present, it automatically upgrades to the cloud-backed store unless
+ * explicitly overridden.
+ *
+ * @example
+ * ```ts
+ * import { ragStore } from "veryfront/embedding";
+ *
+ * const store = ragStore({
+ *   storagePath: "data/index.json",
+ *   contentDir: "content",
+ * });
+ *
+ * await store.ingest("My Doc", text, { source: "upload:file.pdf", type: "pdf" });
+ * const results = await store.search("query", { topK: 5, threshold: 0.7 });
+ * ```
+ */
+export declare function ragStore(config: RagStoreConfig): RagStore;
+//# sourceMappingURL=rag-store.d.ts.map

package/esm/src/embedding/rag-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-store.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/rag-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAKV,QAAQ,EAER,cAAc,EAEf,MAAM,YAAY,CAAC;AAsBpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAkCzD"}

package/esm/src/embedding/{upload-store.js → rag-store.js}

@@ -2,24 +2,32 @@ import * as dntShim from "../../_dnt.shims.js";
 import { cosineSimilarity } from "ai";
 import { isNotFoundError, mkdir, readDir, readTextFile, writeTextFile, } from "../platform/compat/fs.js";
 import { dirname, extname, join } from "../platform/compat/path/basic-operations.js";
+import { serverLogger } from "../utils/index.js";
+import { isVeryfrontCloudEnabled } from "../platform/cloud/resolver.js";
+import { getEnv } from "../platform/compat/process.js";
 import { embedding } from "./embedding.js";
 import { chunk } from "./chunk.js";
+import { createVeryfrontCloudRagStore } from "./veryfront-cloud/rag-store.js";
+import { resolveConfiguredEmbeddingModel } from "./model-resolution.js";
+import { INVALID_ARGUMENT } from "../errors/index.js";
+/** Default number of top results returned by similarity search. */
+const DEFAULT_TOP_K = 5;
 /**
- * Creates a persistent upload store with lazy embedding and similarity search.
+ * Creates a persistent RAG store with lazy embedding and similarity search.
  *
- * Combines upload management, chunking, embedding, and vector search into
- * a single factory. Uploads are chunked on ingest; embeddings are generated
+ * Combines document ingestion, chunking, embedding, and vector search into
+ * a single factory. Documents are chunked on ingest; embeddings are generated
  * lazily on the first search call to avoid blocking uploads on AI API calls.
  *
- * Persistence is JSON-file-based (via the platform fs adapter), making it
- * suitable for prototypes, templates, and small-to-medium knowledge bases.
+ * By default, this uses the local JSON store. When Veryfront Cloud bootstrap
+ * is present, it automatically upgrades to the cloud-backed store unless
+ * explicitly overridden.
  *
  * @example
  * ```ts
- * import { uploadStore } from "veryfront/embedding";
+ * import { ragStore } from "veryfront/embedding";
  *
- * const store = uploadStore({
- *   model: "openai/text-embedding-3-small",
+ * const store = ragStore({
  *   storagePath: "data/index.json",
  *   contentDir: "content",
  * });
@@ -28,44 +36,137 @@ import { chunk } from "./chunk.js";
  * const results = await store.search("query", { topK: 5, threshold: 0.7 });
  * ```
  */
-export function uploadStore(config) {
+export function ragStore(config) {
+    const storeCache = new Map();
+    function getStore() {
+        const resolvedConfig = resolveRagStoreConfig(config);
+        const backend = resolveRagStoreBackend(config);
+        const cacheKey = JSON.stringify({ backend, config: resolvedConfig });
+        const cached = storeCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const store = backend === "veryfront-cloud"
+            ? createVeryfrontCloudRagStore(resolvedConfig)
+            : createLocalJsonRagStore(resolvedConfig);
+        storeCache.set(cacheKey, store);
+        return store;
+    }
+    return {
+        ingest(title, text, meta) {
+            return getStore().ingest(title, text, meta);
+        },
+        search(query, options) {
+            return getStore().search(query, options);
+        },
+        listDocuments() {
+            return getStore().listDocuments();
+        },
+        removeDocument(id) {
+            return getStore().removeDocument(id);
+        },
+        indexContentDir() {
+            return getStore().indexContentDir();
+        },
+    };
+}
+function resolveRagStoreConfig(config) {
+    return {
+        ...config,
+        model: resolveConfiguredEmbeddingModel(config.model),
+    };
+}
+function normalizeRagStoreBackend(value) {
+    const normalized = value?.trim().toLowerCase();
+    switch (normalized) {
+        case undefined:
+        case "":
+            return undefined;
+        case "auto":
+            return "auto";
+        case "local":
+        case "local-json":
+            return "local-json";
+        case "cloud":
+        case "veryfront-cloud":
+            return "veryfront-cloud";
+        default:
+            throw INVALID_ARGUMENT.create({
+                detail: `Invalid RAG backend "${value}". Expected "auto", "local-json", or "veryfront-cloud".`,
+            });
+    }
+}
+function resolveRagStoreBackend(config) {
+    const configured = normalizeRagStoreBackend(config.backend);
+    if (configured && configured !== "auto")
+        return configured;
+    const envOverride = normalizeRagStoreBackend(getEnv("VERYFRONT_RAG_BACKEND"));
+    if (envOverride && envOverride !== "auto")
+        return envOverride;
+    return isVeryfrontCloudEnabled() ? "veryfront-cloud" : "local-json";
+}
+function createLocalJsonRagStore(config) {
     const storagePath = config.storagePath ?? "data/index.json";
     const contentDir = config.contentDir;
     const contentExtensions = new Set(config.contentExtensions ?? [".md", ".mdx", ".txt"]);
     const chunkOptions = config.chunkOptions;
     const MAX_TEXT_LENGTH = 5 * 1024 * 1024; // 5 MB text limit per document
     // Serialize all load→modify→save operations to prevent concurrent overwrites.
+    // NOTE: This is a single-process, single-instance mutex. In multi-instance
+    // deployments, concurrent stores targeting the same file will race.
     let mutex = Promise.resolve();
     function withLock(fn) {
         const result = mutex.then(fn);
         mutex = result.then(() => { }, (err) => {
-            console.error("[upload-store] Lock operation failed:", err);
+            serverLogger.error("[rag-store] Lock operation failed:", err);
         });
         return result;
     }
-    const embedder = embedding({
-        model: config.model,
-        documentPrefix: config.documentPrefix,
-        queryPrefix: config.queryPrefix,
-        batchSize: config.batchSize,
-    });
+    function createEmbedder() {
+        return embedding({
+            model: config.model,
+            documentPrefix: config.documentPrefix,
+            queryPrefix: config.queryPrefix,
+            batchSize: config.batchSize,
+        });
+    }
+    function isLegacyUploadStoreData(value) {
+        if (!value || typeof value !== "object")
+            return false;
+        const data = value;
+        return Array.isArray(data.uploads) && Array.isArray(data.chunks);
+    }
+    function migrateLegacyUploadStoreData(data) {
+        return {
+            documents: data.uploads.map((upload) => ({ ...upload })),
+            chunks: data.chunks.map((chunk) => ({
+                id: chunk.id,
+                documentId: chunk.uploadId,
+                text: chunk.text,
+                embedding: chunk.embedding,
+                index: chunk.index,
+            })),
+        };
+    }
     async function load() {
         try {
             const data = await readTextFile(storagePath);
             const parsed = JSON.parse(data);
-            if (!parsed || !Array.isArray(parsed.uploads) || !Array.isArray(parsed.chunks)) {
-                console.warn("[upload-store] Corrupted store file, resetting:", storagePath);
-                return { uploads: [], chunks: [] };
+            if (isLegacyUploadStoreData(parsed)) {
+                return migrateLegacyUploadStoreData(parsed);
+            }
+            if (!parsed || !Array.isArray(parsed.documents) || !Array.isArray(parsed.chunks)) {
+                serverLogger.warn("[rag-store] Corrupted store file, resetting", { storagePath });
+                return { documents: [], chunks: [] };
             }
             return parsed;
         }
         catch (err) {
             // File not found is expected on first run; anything else is worth logging
             if (isNotFoundError(err)) {
-                return { uploads: [], chunks: [] };
+                return { documents: [], chunks: [] };
             }
-            console.warn("[upload-store] Failed to load store, resetting:", err);
-            return { uploads: [], chunks: [] };
+            serverLogger.warn("[rag-store] Failed to load store, resetting", err);
+            return { documents: [], chunks: [] };
         }
     }
     async function save(data) {
@@ -86,8 +187,8 @@ export function uploadStore(config) {
                 await fs.rename(tmpPath, storagePath);
             }
         }
-        catch {
-            // Fallback for environments where rename isn't available
+        catch (_) {
+            // expected: rename not available in all environments, fall back to direct write
             await writeTextFile(storagePath, payload);
         }
     }
@@ -95,6 +196,7 @@ export function uploadStore(config) {
         const unembedded = data.chunks.filter((c) => c.embedding.length === 0);
         if (unembedded.length === 0)
             return false;
+        const embedder = createEmbedder();
         const embeddings = await embedder.embedMany(unembedded.map((c) => c.text));
         for (let i = 0; i < unembedded.length; i++) {
             unembedded[i].embedding = embeddings[i];
@@ -114,8 +216,8 @@ export function uploadStore(config) {
                 }
             }
         }
-        catch {
-            // directory may not exist yet
+        catch (_) {
+            // expected: directory may not exist yet
         }
         return files;
     }
@@ -123,16 +225,18 @@ export function uploadStore(config) {
         async ingest(title, text, meta) {
             return withLock(async () => {
                 const data = await load();
-                const uploadId = dntShim.crypto.randomUUID();
+                const documentId = dntShim.crypto.randomUUID();
                 if (text.length > MAX_TEXT_LENGTH) {
-                    throw new Error(`Upload text exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB limit`);
+                    throw INVALID_ARGUMENT.create({
+                        detail: `Upload text exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB limit`,
+                    });
                 }
                 const chunks = await chunk(text, chunkOptions);
                 if (chunks.length === 0) {
-                    throw new Error("Upload contains no extractable text");
+                    throw INVALID_ARGUMENT.create({ detail: "Upload contains no extractable text" });
                 }
                 const doc = {
-                    id: uploadId,
+                    id: documentId,
                     title,
                     source: meta?.source ?? "",
                     type: meta?.type ?? "",
@@ -140,15 +244,15 @@ export function uploadStore(config) {
                 };
                 const chunkRecords = chunks.map((chunkText, i) => ({
                     id: dntShim.crypto.randomUUID(),
-                    uploadId,
+                    documentId,
                     text: chunkText,
                     embedding: [], // filled lazily on first search
                     index: i,
                 }));
-                data.uploads.push(doc);
+                data.documents.push(doc);
                 data.chunks.push(...chunkRecords);
                 await save(data);
-                return uploadId;
+                return documentId;
             });
         },
         async search(query, options) {
@@ -159,16 +263,17 @@ export function uploadStore(config) {
                 const updated = await ensureEmbeddings(data);
                 if (updated)
                     await save(data);
+                const embedder = createEmbedder();
                 const queryEmbedding = await embedder.embed(query);
-                const topK = options?.topK ?? 5;
+                const topK = options?.topK ?? DEFAULT_TOP_K;
                 const threshold = options?.threshold;
-                const docMap = new Map(data.uploads.map((d) => [d.id, d]));
+                const docMap = new Map(data.documents.map((d) => [d.id, d]));
                 const scored = data.chunks.map((c) => {
-                    const doc = docMap.get(c.uploadId);
+                    const doc = docMap.get(c.documentId);
                     return {
                         text: c.text,
                         score: cosineSimilarity(queryEmbedding, c.embedding),
-                        uploadId: c.uploadId,
+                        documentId: c.documentId,
                         title: doc?.title ?? "Unknown",
                         source: doc?.source ?? "",
                         type: doc?.type ?? "",
@@ -182,17 +287,17 @@ export function uploadStore(config) {
                 return results;
             });
         },
-        async listUploads() {
+        async listDocuments() {
             return withLock(async () => {
                 const data = await load();
-                return data.uploads;
+                return data.documents;
             });
         },
-        async removeUpload(id) {
+        async removeDocument(id) {
             return withLock(async () => {
                 const data = await load();
-                data.uploads = data.uploads.filter((d) => d.id !== id);
-                data.chunks = data.chunks.filter((c) => c.uploadId !== id);
+                data.documents = data.documents.filter((d) => d.id !== id);
+                data.chunks = data.chunks.filter((c) => c.documentId !== id);
                 await save(data);
             });
         },
@@ -201,7 +306,7 @@ export function uploadStore(config) {
                 return;
             return withLock(async () => {
                 const data = await load();
-                const indexedSources = new Set(data.uploads.map((d) => d.source));
+                const indexedSources = new Set(data.documents.map((d) => d.source));
                 const files = await listContentFiles(contentDir);
                 const newFiles = files.filter((f) => !indexedSources.has(f));
                 if (newFiles.length === 0)
@@ -211,19 +316,19 @@ export function uploadStore(config) {
                     if (!content?.trim())
                         continue;
                     if (content.length > MAX_TEXT_LENGTH) {
-                        console.warn(`[upload-store] Skipping ${file}: exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB text limit`);
+                        serverLogger.warn(`[rag-store] Skipping ${file}: exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB text limit`);
                         continue;
                     }
                     const title = file.startsWith(contentDir + "/")
                         ? file.slice(contentDir.length + 1).replace(/\.[^.]+$/, "")
                         : file.replace(/\.[^.]+$/, "");
-                    const uploadId = dntShim.crypto.randomUUID();
+                    const documentId = dntShim.crypto.randomUUID();
                     const type = extname(file).slice(1);
                     const chunks = await chunk(content, chunkOptions);
                     if (chunks.length === 0)
                         continue;
-                    data.uploads.push({
-                        id: uploadId,
+                    data.documents.push({
+                        id: documentId,
                         title,
                         source: file,
                         type,
@@ -231,7 +336,7 @@ export function uploadStore(config) {
                     });
                     data.chunks.push(...chunks.map((chunkText, i) => ({
                         id: dntShim.crypto.randomUUID(),
-                        uploadId,
+                        documentId,
                         text: chunkText,
                         embedding: [],
                         index: i,

package/esm/src/embedding/react/use-uploads.d.ts

@@ -5,14 +5,14 @@
  * Pairs with `createUploadHandler` on the server side.
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import type { UploadMeta } from "../types.js";
+import type { RagDocumentMeta } from "../types.js";
 export interface UseUploadsOptions {
     /** API endpoint, e.g. "/api/uploads" */
     api: string;
 }
 export interface UseUploadsResult {
     /** All uploads from the server */
-    uploads: UploadMeta[];
+    uploads: RagDocumentMeta[];
     /** True while an upload is in progress */
     uploading: boolean;
     /** User-facing error message, cleared on next action */

package/esm/src/embedding/react/use-uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-uploads.d.ts","sourceRoot":"","sources":["../../../../src/src/embedding/react/use-uploads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,6BAA6B;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAiEvE"}
+{"version":3,"file":"use-uploads.d.ts","sourceRoot":"","sources":["../../../../src/src/embedding/react/use-uploads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAIlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qCAAqC;IACrC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,6BAA6B;IAC7B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAmEvE"}

package/esm/src/embedding/react/use-uploads.js

@@ -6,6 +6,7 @@
  */
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useEffect, useRef, useState } from "react";
+import { API_ERROR } from "../../errors/index.js";
 /**
  * useUploads hook for managing RAG upload lifecycle.
  */
@@ -22,7 +23,8 @@ export function useUploads(options) {
             const data = await res.json();
             setUploads(data.uploads ?? []);
         }
-        catch {
+        catch (error) {
+            console.debug("useUploads: failed to load uploads", error);
             setError("Failed to load uploads");
         }
     }, [options.api]);
@@ -44,7 +46,7 @@ export function useUploads(options) {
             });
             const data = await res.json();
             if (!res.ok)
-                throw new Error(data.error ?? "Upload failed");
+                throw API_ERROR.create({ detail: data.error ?? "Upload failed" });
             await refresh();
         }
         catch (err) {
@@ -63,7 +65,8 @@ export function useUploads(options) {
             await dntShim.fetch(`${options.api}/${id}`, { method: "DELETE" });
             await refresh();
         }
-        catch {
+        catch (error) {
+            console.debug("useUploads: failed to delete upload", error);
             setError("Failed to delete upload");
         }
     }, [options.api, refresh]);

package/esm/src/embedding/resolve.d.ts

@@ -1,5 +1,5 @@
 import type { EmbeddingModel } from "ai";
-export type EmbeddingProviderFactory = (modelId: string) => EmbeddingModel;
+type EmbeddingProviderFactory = (modelId: string) => EmbeddingModel;
 /**
  * Register an embedding provider factory.
  *
@@ -24,4 +24,5 @@ export declare function resolveEmbeddingModel(modelString: string): EmbeddingMod
  * Clear all registered embedding providers (for testing).
  */
 export declare function clearEmbeddingProviders(): void;
+export {};
 //# sourceMappingURL=resolve.d.ts.map

package/esm/src/embedding/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAOzC,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;AAK3E;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAEN;AA2CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAuCzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/src/embedding/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAQzC,KAAK,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;AAKpE;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAEN;AA+CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAuCzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/esm/src/embedding/resolve.js

@@ -3,6 +3,7 @@ import { createOpenAI } from "@ai-sdk/openai";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { getGoogleGenAIEnvConfig, getOpenAIEnvConfig } from "../config/env.js";
 import { createLocalEmbeddingModel } from "../provider/local/local-embedding-adapter.js";
+import { createVeryfrontCloudEmbeddingModel } from "./veryfront-cloud/provider.js";
 const providers = new Map();
 let autoInitialized = false;
 /**
@@ -49,6 +50,9 @@ function autoInitializeFromEnv() {
     if (!providers.has("local")) {
         providers.set("local", createLocalEmbeddingModel);
     }
+    if (!providers.has("veryfront-cloud")) {
+        providers.set("veryfront-cloud", createVeryfrontCloudEmbeddingModel);
+    }
 }
 /**
  * Resolve a "provider/model" string to an AI SDK EmbeddingModel instance.