feat: update version to 0.2.0 and enhance BrightClient with document and search operations

Author: MagicFun1241

package.json

@@ -1,6 +1,6 @@
 {
   "name": "bright-client",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "TypeScript client library for Bright search database",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",

src/index.ts

@@ -24,6 +24,23 @@ export interface BrightClientOptions {
   fetch?: typeof fetch;
 }
 
+export interface IndexHandle<T = Record<string, any>> {
+  readonly id: string;
+
+  // Index operations
+  update(config: Partial<IndexConfig>): Promise<IndexConfig>;
+  delete(): Promise<void>;
+
+  // Document operations
+  addDocuments(documents: T[], format?: 'jsoneachrow'): Promise<{ indexed: number }>;
+  updateDocument(documentId: string, updates: Partial<T>): Promise<T>;
+  deleteDocument(documentId: string): Promise<void>;
+  deleteDocuments(options: { ids?: string[]; filter?: string }): Promise<void>;
+
+  // Search
+  search(params?: SearchParams): Promise<SearchResponse<T>>;
+}
+
 export class BrightClient {
   private baseUrl: string;
   private fetchFn: typeof fetch;
@@ -84,26 +101,26 @@ export class BrightClient {
 
   // Document Operations
 
-  async addDocuments(
+  async addDocuments<T = Record<string, any>>(
     indexId: string,
-    documents: Record<string, any>[],
+    documents: T[],
     format: 'jsoneachrow' = 'jsoneachrow'
   ): Promise<{ indexed: number }> {
     const body = documents.map(doc => JSON.stringify(doc)).join('\n');
     const params = new URLSearchParams({ format });
-    
+
     return this.request<{ indexed: number }>(`/indexes/${indexId}/documents?${params}`, {
       method: 'POST',
       body,
     });
   }
 
-  async updateDocument(
+  async updateDocument<T = Record<string, any>>(
     indexId: string,
     documentId: string,
-    updates: Record<string, any>
-  ): Promise<Record<string, any>> {
-    return this.request<Record<string, any>>(`/indexes/${indexId}/documents/${documentId}`, {
+    updates: Partial<T>
+  ): Promise<T> {
+    return this.request<T>(`/indexes/${indexId}/documents/${documentId}`, {
       method: 'PATCH',
       body: JSON.stringify(updates),
     });
@@ -141,32 +158,50 @@ export class BrightClient {
     params?: SearchParams
   ): Promise<SearchResponse<T>> {
     const searchParams = new URLSearchParams();
-    
+
     if (params?.q) searchParams.append('q', params.q);
     if (params?.offset) searchParams.append('offset', params.offset.toString());
     if (params?.limit) searchParams.append('limit', params.limit.toString());
     if (params?.page) searchParams.append('page', params.page.toString());
-    
+
     if (params?.sort) {
       params.sort.forEach(s => searchParams.append('sort[]', s));
     }
-    
+
     if (params?.attributesToRetrieve) {
-      params.attributesToRetrieve.forEach(attr => 
+      params.attributesToRetrieve.forEach(attr =>
         searchParams.append('attributesToRetrieve[]', attr)
       );
     }
-    
+
     if (params?.attributesToExclude) {
-      params.attributesToExclude.forEach(attr => 
+      params.attributesToExclude.forEach(attr =>
         searchParams.append('attributesToExclude[]', attr)
       );
     }
-    
+
     return this.request<SearchResponse<T>>(`/indexes/${indexId}/searches?${searchParams}`, {
       method: 'POST',
     });
   }
+
+  // Typed Index Handle
+
+  index<T = Record<string, any>>(indexId: string): IndexHandle<T> {
+    return {
+      id: indexId,
+
+      update: (config) => this.updateIndex(indexId, config),
+      delete: () => this.deleteIndex(indexId),
+
+      addDocuments: (documents, format) => this.addDocuments<T>(indexId, documents, format),
+      updateDocument: (documentId, updates) => this.updateDocument<T>(indexId, documentId, updates),
+      deleteDocument: (documentId) => this.deleteDocument(indexId, documentId),
+      deleteDocuments: (options) => this.deleteDocuments(indexId, options),
+
+      search: (params) => this.search<T>(indexId, params),
+    };
+  }
 }
 
 // Convenience function