@blinkdotnew/sdk 0.2.1 → 0.2.2

package/README.md

@@ -45,6 +45,11 @@ const { text } = await blink.ai.generateText({
   prompt: "Write a summary of the user's todos"
 })
 
+// Data operations (extract text from documents)
+const { chunks } = await blink.data.extractFromUrl(
+  "https://example.com/document.pdf"
+)
+
 // Storage operations (instant - returns public URL directly)
 const { publicUrl } = await blink.storage.upload(
   file,
@@ -69,6 +74,7 @@ This SDK powers every Blink-generated app with:
 - **🔐 Authentication**: JWT-based auth with automatic token management
 - **🗄️ Database**: PostgREST-compatible CRUD operations with advanced filtering  
 - **🤖 AI**: Text generation, object generation, image creation, speech synthesis, and transcription
+- **📄 Data**: Extract text content from documents, spreadsheets, and more
 - **📁 Storage**: File upload, download, and management
 - **🌐 Universal**: Works on client-side and server-side
 - **📱 Framework Agnostic**: React, Vue, Svelte, vanilla JS, Node.js, Deno
@@ -241,6 +247,46 @@ await blink.ai.streamText(
 )
 ```
 
+### Data Operations
+
+```typescript
+// Simple text extraction (default - returns single string)
+const text = await blink.data.extractFromUrl('https://example.com/document.pdf');
+console.log(typeof text); // 'string'
+
+// Extract with chunking enabled
+const chunks = await blink.data.extractFromUrl('https://example.com/document.pdf', {
+  chunking: true,
+  chunkSize: 2000
+});
+console.log(Array.isArray(chunks)); // true
+
+// Extract from different file types
+const csvText = await blink.data.extractFromUrl('https://example.com/data.csv');
+const htmlText = await blink.data.extractFromUrl('https://example.com/page.html');
+const jsonText = await blink.data.extractFromUrl('https://example.com/config.json');
+
+// Extract from uploaded file blob (simple)
+const fileInput = document.getElementById('fileInput') as HTMLInputElement;
+const file = fileInput.files[0];
+const extractedText = await blink.data.extractFromBlob(file);
+
+// Extract from uploaded file blob (with chunking)
+const chunks = await blink.data.extractFromBlob(file, {
+  chunking: true,
+  chunkSize: 3000
+});
+
+// Error handling for data extraction
+try {
+  const result = await blink.data.extractFromUrl('https://example.com/huge-file.pdf');
+} catch (error) {
+  if (error instanceof BlinkDataError) {
+    console.error('Data processing error:', error.message);
+  }
+}
+```
+
 ### Storage Operations
 
 ```typescript
@@ -263,7 +309,7 @@ await blink.storage.remove('file1.jpg', 'file2.jpg')
 ### Error Handling
 
 ```typescript
-import { BlinkAuthError, BlinkAIError, BlinkStorageError } from '@blinkdotnew/sdk'
+import { BlinkAuthError, BlinkAIError, BlinkStorageError, BlinkDataError } from '@blinkdotnew/sdk'
 
 try {
   const user = await blink.auth.me()

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } from '@blink/core';
-export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkStorage, BlinkUser, CreateOptions, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, QueryOptions, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, BlinkStorage, BlinkAI, BlinkData, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, DataExtraction } from '@blink/core';
+export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkData, BlinkStorage, BlinkUser, CreateOptions, DataExtraction, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, QueryOptions, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
 
 /**
  * Blink Auth Module - Client-side authentication management
@@ -206,6 +206,7 @@ interface BlinkClient {
     db: BlinkDatabase;
     storage: BlinkStorage;
     ai: BlinkAI;
+    data: BlinkData;
 }
 /**
  * Create a new Blink client instance
@@ -596,4 +597,10 @@ declare class BlinkAIImpl implements BlinkAI {
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
 
-export { type AuthStateChangeCallback, BlinkAIImpl, type BlinkClient, BlinkDatabase, BlinkStorageImpl, BlinkTable, createClient };
+declare class BlinkDataImpl implements BlinkData {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    extractFromUrl(url: string, filename?: string): Promise<DataExtraction>;
+}
+
+export { type AuthStateChangeCallback, BlinkAIImpl, type BlinkClient, BlinkDataImpl, BlinkDatabase, BlinkStorageImpl, BlinkTable, createClient };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } from '@blink/core';
-export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkStorage, BlinkUser, CreateOptions, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, QueryOptions, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, BlinkStorage, BlinkAI, BlinkData, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, DataExtraction } from '@blink/core';
+export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkData, BlinkStorage, BlinkUser, CreateOptions, DataExtraction, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, QueryOptions, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
 
 /**
  * Blink Auth Module - Client-side authentication management
@@ -206,6 +206,7 @@ interface BlinkClient {
     db: BlinkDatabase;
     storage: BlinkStorage;
     ai: BlinkAI;
+    data: BlinkData;
 }
 /**
  * Create a new Blink client instance
@@ -596,4 +597,10 @@ declare class BlinkAIImpl implements BlinkAI {
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
 
-export { type AuthStateChangeCallback, BlinkAIImpl, type BlinkClient, BlinkDatabase, BlinkStorageImpl, BlinkTable, createClient };
+declare class BlinkDataImpl implements BlinkData {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    extractFromUrl(url: string, filename?: string): Promise<DataExtraction>;
+}
+
+export { type AuthStateChangeCallback, BlinkAIImpl, type BlinkClient, BlinkDataImpl, BlinkDatabase, BlinkStorageImpl, BlinkTable, createClient };

package/dist/index.js

@@ -40,6 +40,12 @@ var BlinkAIError = class extends BlinkError {
     this.name = "BlinkAIError";
   }
 };
+var BlinkDataError = class extends BlinkError {
+  constructor(message, status, details) {
+    super(message, "DATA_ERROR", status, details);
+    this.name = "BlinkDataError";
+  }
+};
 
 // ../core/src/query-builder.ts
 function buildFilterQuery(condition) {
@@ -529,6 +535,15 @@ var HttpClient = class {
       signal
     });
   }
+  /**
+   * Data-specific requests
+   */
+  async dataExtractFromUrl(url, filename) {
+    return this.request(`/api/data/${this.projectId}/extract-from-url`, {
+      method: "POST",
+      body: { url, filename }
+    });
+  }
   /**
    * Private helper methods
    */
@@ -2279,12 +2294,41 @@ var BlinkAIImpl = class {
   }
 };
 
+// src/data.ts
+var BlinkDataImpl = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async extractFromUrl(url, filename) {
+    try {
+      const response = await this.httpClient.dataExtractFromUrl(url, filename);
+      if (response.data?.chunks) {
+        return {
+          chunks: response.data.chunks
+        };
+      } else {
+        throw new BlinkDataError("Invalid response format: missing chunks");
+      }
+    } catch (error) {
+      if (error instanceof BlinkDataError) {
+        throw error;
+      }
+      throw new BlinkDataError(
+        `Data extraction failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        { originalError: error }
+      );
+    }
+  }
+};
+
 // src/client.ts
 var BlinkClientImpl = class {
   auth;
   db;
   storage;
   ai;
+  data;
   httpClient;
   constructor(config) {
     this.auth = new BlinkAuth(config);
@@ -2296,6 +2340,7 @@ var BlinkClientImpl = class {
     this.db = new BlinkDatabase(this.httpClient);
     this.storage = new BlinkStorageImpl(this.httpClient);
     this.ai = new BlinkAIImpl(this.httpClient);
+    this.data = new BlinkDataImpl(this.httpClient);
   }
 };
 function createClient(config) {
@@ -2310,6 +2355,7 @@ function createClient(config) {
 }
 
 exports.BlinkAIImpl = BlinkAIImpl;
+exports.BlinkDataImpl = BlinkDataImpl;
 exports.BlinkDatabase = BlinkDatabase;
 exports.BlinkStorageImpl = BlinkStorageImpl;
 exports.BlinkTable = BlinkTable;