@babav/knowledge-core-client 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -108,6 +108,14 @@ export interface ContentUrl {
     content_type: string;
     filename: string;
 }
+/** Document tally for a corpus or folder. `indexed` = searchable; `in_flight` =
+ *  pending + ingesting (still processing); `failed` = terminal; `total` = all. */
+export interface DocumentCount {
+    total: number;
+    indexed: number;
+    in_flight: number;
+    failed: number;
+}
 export interface Conversation {
     id: UUID;
     title: string | null;
@@ -266,8 +274,16 @@ export declare class KnowledgeCoreClient extends HttpBase {
             limit?: number;
             cursor?: string;
         }) => Promise<Page<Document>>;
-        /** Upload a file and ingest it SYNCHRONOUSLY — resolves once the document is
-         *  indexed (or rejects 502 on a pipeline failure). */
+        /** Count documents in the corpus: { total, indexed, in_flight, failed }. */
+        countDocuments: (id: UUID) => Promise<DocumentCount>;
+        /** Documents in the corpus whose filename contains `q` (case-insensitive), paginated. */
+        searchDocuments: (id: UUID, q: string, opts?: {
+            limit?: number;
+            cursor?: string;
+        }) => Promise<Page<Document>>;
+        /** Upload a file and ingest it ASYNCHRONOUSLY — resolves with the created
+         *  document at status `pending` (HTTP 202); track via documents.get() polling
+         *  the status to `indexed`/`failed`, or the tenant result webhook. */
         ingestDocument: (id: UUID, a: {
             file: FileData;
             filename: string;
@@ -292,6 +308,13 @@ export declare class KnowledgeCoreClient extends HttpBase {
             limit?: number;
             cursor?: string;
         }) => Promise<Page<Document>>;
+        /** Count documents in the folder: { total, indexed, in_flight, failed }. */
+        countDocuments: (folderId: UUID) => Promise<DocumentCount>;
+        /** Documents in the folder whose filename contains `q` (case-insensitive), paginated. */
+        searchDocuments: (folderId: UUID, q: string, opts?: {
+            limit?: number;
+            cursor?: string;
+        }) => Promise<Page<Document>>;
     };
     documents: {
         get: (id: UUID) => Promise<Document>;

package/dist/index.js

@@ -164,8 +164,13 @@ export class KnowledgeCoreClient extends HttpBase {
         delete: (id, confirmName) => this.request("DELETE", `/v1/corpora/${id}`, { query: { confirm: confirmName } }),
         listFolders: (id) => this.pageAll(`/v1/corpora/${id}/folders`),
         listDocuments: (id, q) => this.request("GET", `/v1/corpora/${id}/documents`, { query: q }),
-        /** Upload a file and ingest it SYNCHRONOUSLY — resolves once the document is
-         *  indexed (or rejects 502 on a pipeline failure). */
+        /** Count documents in the corpus: { total, indexed, in_flight, failed }. */
+        countDocuments: (id) => this.request("GET", `/v1/corpora/${id}/documents/count`),
+        /** Documents in the corpus whose filename contains `q` (case-insensitive), paginated. */
+        searchDocuments: (id, q, opts) => this.request("GET", `/v1/corpora/${id}/documents/search`, { query: { q, ...opts } }),
+        /** Upload a file and ingest it ASYNCHRONOUSLY — resolves with the created
+         *  document at status `pending` (HTTP 202); track via documents.get() polling
+         *  the status to `indexed`/`failed`, or the tenant result webhook. */
         ingestDocument: (id, a) => {
             const fd = new FormData();
             fd.append("file", toBlob(a.file, a.content_type), a.filename);
@@ -190,6 +195,10 @@ export class KnowledgeCoreClient extends HttpBase {
         rename: (folderId, name) => this.request("PATCH", `/v1/folders/${folderId}`, { json: { name } }),
         delete: (folderId) => this.request("DELETE", `/v1/folders/${folderId}`),
         listDocuments: (folderId, q) => this.request("GET", `/v1/folders/${folderId}/documents`, { query: q }),
+        /** Count documents in the folder: { total, indexed, in_flight, failed }. */
+        countDocuments: (folderId) => this.request("GET", `/v1/folders/${folderId}/documents/count`),
+        /** Documents in the folder whose filename contains `q` (case-insensitive), paginated. */
+        searchDocuments: (folderId, q, opts) => this.request("GET", `/v1/folders/${folderId}/documents/search`, { query: { q, ...opts } }),
     };
     // --- documents ---
     documents = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babav/knowledge-core-client",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "TypeScript client for the Babav Knowledge Core API (Deno + Node 18+, zero deps).",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -122,6 +122,14 @@ export interface ContentUrl {
   content_type: string;
   filename: string;
 }
+/** Document tally for a corpus or folder. `indexed` = searchable; `in_flight` =
+ *  pending + ingesting (still processing); `failed` = terminal; `total` = all. */
+export interface DocumentCount {
+  total: number;
+  indexed: number;
+  in_flight: number;
+  failed: number;
+}
 export interface Conversation {
   id: UUID;
   title: string | null;
@@ -381,8 +389,15 @@ export class KnowledgeCoreClient extends HttpBase {
     listFolders: (id: UUID) => this.pageAll<Folder>(`/v1/corpora/${id}/folders`),
     listDocuments: (id: UUID, q?: { limit?: number; cursor?: string }) =>
       this.request<Page<Document>>("GET", `/v1/corpora/${id}/documents`, { query: q }),
-    /** Upload a file and ingest it SYNCHRONOUSLY — resolves once the document is
-     *  indexed (or rejects 502 on a pipeline failure). */
+    /** Count documents in the corpus: { total, indexed, in_flight, failed }. */
+    countDocuments: (id: UUID) =>
+      this.request<DocumentCount>("GET", `/v1/corpora/${id}/documents/count`),
+    /** Documents in the corpus whose filename contains `q` (case-insensitive), paginated. */
+    searchDocuments: (id: UUID, q: string, opts?: { limit?: number; cursor?: string }) =>
+      this.request<Page<Document>>("GET", `/v1/corpora/${id}/documents/search`, { query: { q, ...opts } }),
+    /** Upload a file and ingest it ASYNCHRONOUSLY — resolves with the created
+     *  document at status `pending` (HTTP 202); track via documents.get() polling
+     *  the status to `indexed`/`failed`, or the tenant result webhook. */
     ingestDocument: (id: UUID, a: { file: FileData; filename: string; content_type?: string; visibility?: Visibility; folder_id?: UUID; custom_metadata?: Record<string, unknown> }) => {
       const fd = new FormData();
       fd.append("file", toBlob(a.file, a.content_type), a.filename);
@@ -407,6 +422,12 @@ export class KnowledgeCoreClient extends HttpBase {
     delete: (folderId: UUID) => this.request<void>("DELETE", `/v1/folders/${folderId}`),
     listDocuments: (folderId: UUID, q?: { limit?: number; cursor?: string }) =>
       this.request<Page<Document>>("GET", `/v1/folders/${folderId}/documents`, { query: q }),
+    /** Count documents in the folder: { total, indexed, in_flight, failed }. */
+    countDocuments: (folderId: UUID) =>
+      this.request<DocumentCount>("GET", `/v1/folders/${folderId}/documents/count`),
+    /** Documents in the folder whose filename contains `q` (case-insensitive), paginated. */
+    searchDocuments: (folderId: UUID, q: string, opts?: { limit?: number; cursor?: string }) =>
+      this.request<Page<Document>>("GET", `/v1/folders/${folderId}/documents/search`, { query: { q, ...opts } }),
   };
 
   // --- documents ---