@seaverse/dataservice 1.2.0 → 1.3.0

package/README.md

@@ -22,9 +22,9 @@ npm install @seaverse/dataservice
 ```typescript
 import { createClient } from '@seaverse/dataservice';
 
-// Create client (uses default SeaVerse API, appId auto-extracted from URL)
+// Create client (Bearer prefix auto-added, uses default SeaVerse API, appId auto-extracted from URL)
 const client = createClient({
-  token: 'Bearer your-jwt-token',
+  token: 'your-jwt-token',
 });
 
 // Access user data table
@@ -47,8 +47,11 @@ const pending = await orders
 // Update data
 await orders.patch(order.id, { status: 'completed' });
 
-// Delete data
+// Delete single record
 await orders.delete(order.id);
+
+// Or delete all records in collection
+const deletedCount = await orders.deleteAll();
 ```
 
 ## Core Concepts
@@ -134,7 +137,7 @@ interface DataRecord<T> {
 import { createClient } from '@seaverse/dataservice';
 
 const client = createClient({
-  token: string;            // JWT token (must contain user_id)
+  token: string;            // JWT token (Bearer prefix optional, auto-added if missing)
   url?: string;             // PostgREST API URL (default: https://dataservice-api.seaverse.ai)
   options?: {
     timeout?: number;       // Request timeout in ms (default: 30000)
@@ -146,7 +149,12 @@ const client = createClient({
 **Examples:**
 
 ```typescript
-// Use default SeaVerse API
+// Use default SeaVerse API (Bearer prefix auto-added)
+const client = createClient({
+  token: 'your-jwt-token',
+});
+
+// Or with explicit Bearer prefix (both work)
 const client = createClient({
   token: 'Bearer your-jwt-token',
 });
@@ -154,7 +162,7 @@ const client = createClient({
 // Use custom API endpoint
 const client = createClient({
   url: 'https://your-custom-api.example.com',
-  token: 'Bearer your-jwt-token',
+  token: 'your-jwt-token',
 });
 ```
 
@@ -213,9 +221,12 @@ collection.patch(id: string, partial: Partial<T>): Promise<DataRecord<T>>
 #### Delete
 
 ```typescript
-// Hard delete (permanent)
+// Hard delete single record (permanent)
 collection.delete(id: string): Promise<void>
 
+// Hard delete all records in collection (returns count of deleted records)
+collection.deleteAll(): Promise<number>
+
 // Soft delete (sets deleted_at timestamp)
 collection.softDelete(id: string): Promise<boolean>
 
@@ -336,6 +347,13 @@ await orders.patch(order.id, { status: 'shipped' });
 const customerOrders = await orders.search({
   customer_email: 'customer@example.com',
 });
+
+// Delete a specific order
+await orders.delete(order.id);
+
+// Delete all orders (useful for cleanup)
+const deletedCount = await orders.deleteAll();
+console.log(`Deleted ${deletedCount} orders`);
 ```
 
 ### Chat Conversations

package/dist/index.d.mts

@@ -195,6 +195,8 @@ interface Collection<T = any> {
     patch(id: string, partial: Partial<T>): Promise<DataRecord<T>>;
     /** Hard delete a record by ID */
     delete(id: string): Promise<void>;
+    /** Hard delete all records in this collection */
+    deleteAll(): Promise<number>;
     /** Soft delete a record by ID (sets deleted_at) */
     softDelete(id: string): Promise<boolean>;
     /** Restore a soft-deleted record */
@@ -254,7 +256,12 @@ interface DataServiceClient {
  *
  * @example
  * ```typescript
- * // Use default SeaVerse API endpoint
+ * // Use default SeaVerse API endpoint (Bearer prefix auto-added)
+ * const client = createClient({
+ *   token: 'your-jwt-token-here',
+ * });
+ *
+ * // Or with explicit Bearer prefix (both work)
  * const client = createClient({
  *   token: 'Bearer your-jwt-token-here',
  * });
@@ -262,7 +269,7 @@ interface DataServiceClient {
  * // Or specify custom endpoint
  * const client = createClient({
  *   url: 'https://your-postgrest-api.example.com',
- *   token: 'Bearer your-jwt-token-here',
+ *   token: 'your-jwt-token-here',
  * });
  *
  * // appId is automatically extracted from current URL
@@ -284,9 +291,9 @@ declare function createClient(config: ClientConfig): DataServiceClient;
  * ```typescript
  * import { createClient } from '@seaverse/dataservice';
  *
- * // Create client (uses default SeaVerse API)
+ * // Create client (Bearer prefix auto-added, uses default SeaVerse API)
  * const client = createClient({
- *   token: 'Bearer your-jwt-token',
+ *   token: 'your-jwt-token',
  * });
  *
  * // appId is automatically extracted from current URL

package/dist/index.d.ts

@@ -195,6 +195,8 @@ interface Collection<T = any> {
     patch(id: string, partial: Partial<T>): Promise<DataRecord<T>>;
     /** Hard delete a record by ID */
     delete(id: string): Promise<void>;
+    /** Hard delete all records in this collection */
+    deleteAll(): Promise<number>;
     /** Soft delete a record by ID (sets deleted_at) */
     softDelete(id: string): Promise<boolean>;
     /** Restore a soft-deleted record */
@@ -254,7 +256,12 @@ interface DataServiceClient {
  *
  * @example
  * ```typescript
- * // Use default SeaVerse API endpoint
+ * // Use default SeaVerse API endpoint (Bearer prefix auto-added)
+ * const client = createClient({
+ *   token: 'your-jwt-token-here',
+ * });
+ *
+ * // Or with explicit Bearer prefix (both work)
  * const client = createClient({
  *   token: 'Bearer your-jwt-token-here',
  * });
@@ -262,7 +269,7 @@ interface DataServiceClient {
  * // Or specify custom endpoint
  * const client = createClient({
  *   url: 'https://your-postgrest-api.example.com',
- *   token: 'Bearer your-jwt-token-here',
+ *   token: 'your-jwt-token-here',
  * });
  *
  * // appId is automatically extracted from current URL
@@ -284,9 +291,9 @@ declare function createClient(config: ClientConfig): DataServiceClient;
  * ```typescript
  * import { createClient } from '@seaverse/dataservice';
  *
- * // Create client (uses default SeaVerse API)
+ * // Create client (Bearer prefix auto-added, uses default SeaVerse API)
  * const client = createClient({
- *   token: 'Bearer your-jwt-token',
+ *   token: 'your-jwt-token',
  * });
  *
  * // appId is automatically extracted from current URL

package/dist/index.js

@@ -60,8 +60,9 @@ var HTTPClient = class {
     this.baseUrl = (config.url || "https://dataservice-api.seaverse.ai").replace(/\/$/, "");
     this.fetchFn = config.options?.fetch || globalThis.fetch;
     this.timeout = config.options?.timeout || 3e4;
+    const token = config.token.startsWith("Bearer ") ? config.token : `Bearer ${config.token}`;
     this.headers = {
-      "Authorization": config.token,
+      "Authorization": token,
       "Content-Type": "application/json",
       "Prefer": "return=representation",
       ...config.options?.headers
@@ -285,6 +286,18 @@ var CollectionImpl = class {
       `/user_data?id=eq.${id}&app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
     );
   }
+  async deleteAll() {
+    const records = await this.client.get(
+      `/user_data?app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
+    );
+    const count = records.length;
+    if (count > 0) {
+      await this.client.delete(
+        `/user_data?app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
+      );
+    }
+    return count;
+  }
   async softDelete(id) {
     const response = await this.client.post("/rpc/soft_delete_user_data", {
       p_id: id

package/dist/index.mjs

@@ -32,8 +32,9 @@ var HTTPClient = class {
     this.baseUrl = (config.url || "https://dataservice-api.seaverse.ai").replace(/\/$/, "");
     this.fetchFn = config.options?.fetch || globalThis.fetch;
     this.timeout = config.options?.timeout || 3e4;
+    const token = config.token.startsWith("Bearer ") ? config.token : `Bearer ${config.token}`;
     this.headers = {
-      "Authorization": config.token,
+      "Authorization": token,
       "Content-Type": "application/json",
       "Prefer": "return=representation",
       ...config.options?.headers
@@ -257,6 +258,18 @@ var CollectionImpl = class {
       `/user_data?id=eq.${id}&app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
     );
   }
+  async deleteAll() {
+    const records = await this.client.get(
+      `/user_data?app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
+    );
+    const count = records.length;
+    if (count > 0) {
+      await this.client.delete(
+        `/user_data?app_id=eq.${this.appId}&collection_name=eq.${this.collectionName}`
+      );
+    }
+    return count;
+  }
   async softDelete(id) {
     const response = await this.client.post("/rpc/soft_delete_user_data", {
       p_id: id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seaverse/dataservice",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "AI-Friendly Universal Data Storage SDK for TypeScript/JavaScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",