@blinkdotnew/sdk 0.4.2 → 0.5.0

package/README.md

@@ -52,6 +52,10 @@ const text = await blink.data.extractFromUrl("https://example.com/document.pdf")
 const { markdown, metadata, links } = await blink.data.scrape("https://competitor.com")
 const screenshotUrl = await blink.data.screenshot("https://competitor.com")
 
+// Web search (get real-time information)
+const searchResults = await blink.data.search("chatgpt latest news", { type: 'news' })
+const localResults = await blink.data.search("best restaurants", { location: "San Francisco,CA,United States" })
+
 // Secure API proxy (call external APIs with secret substitution)
 const response = await blink.data.fetch({
   url: "https://api.sendgrid.com/v3/mail/send",
@@ -84,7 +88,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 with web search, object generation, image creation, speech synthesis, and transcription
-- **📄 Data**: Extract text content from documents, secure API proxy with secret substitution, web scraping, and screenshots
+- **📄 Data**: Extract text content from documents, secure API proxy with secret substitution, web scraping, screenshots, and web search
 - **📁 Storage**: File upload, download, and management
 - **🌐 Universal**: Works on client-side and server-side
 - **📱 Framework Agnostic**: React, Vue, Svelte, vanilla JS, Node.js, Deno
@@ -329,8 +333,58 @@ const fullPageUrl = await blink.data.screenshot('https://example.com', {
   height: 1080
 });
 
+// 🔥 Web Search (NEW!) - Google search results with clean structure
+// Perfect for getting real-time information and current data
+
+// Basic web search - just provide a query
+const searchResults = await blink.data.search('chatgpt');
+console.log(searchResults.organic_results); // Main search results
+console.log(searchResults.related_searches); // Related search suggestions
+console.log(searchResults.people_also_ask); // People also ask questions
+
+// Search with location for local results
+const localResults = await blink.data.search('best restaurants', {
+  location: 'San Francisco,CA,United States'
+});
+console.log(localResults.local_results); // Local business results
+console.log(localResults.organic_results); // Regular web results
+
+// News search - get latest news articles
+const newsResults = await blink.data.search('artificial intelligence', {
+  type: 'news'
+});
+console.log(newsResults.news_results); // News articles with dates and sources
+
+// Image search - find images
+const imageResults = await blink.data.search('elon musk', {
+  type: 'images',
+  limit: 20
+});
+console.log(imageResults.image_results); // Image results with thumbnails
+
+// Search in different languages
+const spanishResults = await blink.data.search('noticias tecnología', {
+  language: 'es',
+  type: 'news'
+});
+
+// Shopping search - find products
+const shoppingResults = await blink.data.search('macbook pro', {
+  type: 'shopping'
+});
+console.log(shoppingResults.shopping_results); // Product results with prices
+
+// All search types return consistent, structured data:
+// - organic_results: Main search results (always included)
+// - related_searches: Related search suggestions
+// - people_also_ask: FAQ-style questions and answers
+// - local_results: Local businesses (when location provided)
+// - news_results: News articles (when type='news')
+// - image_results: Images (when type='images')
+// - shopping_results: Products (when type='shopping')
+// - ads: Sponsored results (when present)
+
 // 🔥 Secure API Proxy (NEW!) - Make API calls with secret substitution
-// Perfect for calling external APIs from frontend while keeping API keys safe
 
 // Basic API call with secret substitution
 const response = await blink.data.fetch({
@@ -563,6 +617,64 @@ function App() {
   return <div>Welcome, {user.email}!</div>
 }
 
+// React example with search functionality
+function SearchResults() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState(null)
+  const [loading, setLoading] = useState(false)
+  
+  const handleSearch = async () => {
+    if (!query.trim()) return
+    
+    setLoading(true)
+    try {
+      const searchResults = await blink.data.search(query, {
+        type: 'news', // Get latest news
+        limit: 10
+      })
+      setResults(searchResults)
+    } catch (error) {
+      console.error('Search failed:', error)
+    } finally {
+      setLoading(false)
+    }
+  }
+  
+  return (
+    <div>
+      <input 
+        value={query}
+        onChange={(e) => setQuery(e.target.value)}
+        placeholder="Search for news..."
+        onKeyPress={(e) => e.key === 'Enter' && handleSearch()}
+      />
+      <button onClick={handleSearch} disabled={loading}>
+        {loading ? 'Searching...' : 'Search'}
+      </button>
+      
+      {results && (
+        <div>
+          <h3>News Results:</h3>
+          {results.news_results?.map((article, i) => (
+            <div key={i}>
+              <h4><a href={article.link}>{article.title}</a></h4>
+              <p>{article.snippet}</p>
+              <small>{article.source} - {article.date}</small>
+            </div>
+          ))}
+          
+          <h3>Related Searches:</h3>
+          {results.related_searches?.map((suggestion, i) => (
+            <button key={i} onClick={() => setQuery(suggestion)}>
+              {suggestion}
+            </button>
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}
+
 // React example with secure API calls
 function EmailSender() {
   const [status, setStatus] = useState('')

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, SearchResponse, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } 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';
 
 /**
@@ -213,6 +213,12 @@ interface BlinkData {
     }): Promise<string>;
     fetch(request: FetchRequest): Promise<FetchResponse>;
     fetchAsync(request: Omit<FetchRequest, 'async'>): Promise<AsyncFetchResponse>;
+    search(query: string, options?: {
+        location?: string;
+        type?: 'news' | 'images' | 'videos' | 'shopping';
+        language?: string;
+        limit?: number;
+    }): Promise<SearchResponse>;
 }
 declare class BlinkDataImpl implements BlinkData {
     private httpClient;
@@ -234,6 +240,12 @@ declare class BlinkDataImpl implements BlinkData {
     }): Promise<string>;
     fetch(request: FetchRequest): Promise<FetchResponse>;
     fetchAsync(request: Omit<FetchRequest, 'async'>): Promise<AsyncFetchResponse>;
+    search(query: string, options?: {
+        location?: string;
+        type?: 'news' | 'images' | 'videos' | 'shopping';
+        language?: string;
+        limit?: number;
+    }): Promise<SearchResponse>;
 }
 
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, SearchResponse, BlinkStorage, BlinkAI, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse } 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';
 
 /**
@@ -213,6 +213,12 @@ interface BlinkData {
     }): Promise<string>;
     fetch(request: FetchRequest): Promise<FetchResponse>;
     fetchAsync(request: Omit<FetchRequest, 'async'>): Promise<AsyncFetchResponse>;
+    search(query: string, options?: {
+        location?: string;
+        type?: 'news' | 'images' | 'videos' | 'shopping';
+        language?: string;
+        limit?: number;
+    }): Promise<SearchResponse>;
 }
 declare class BlinkDataImpl implements BlinkData {
     private httpClient;
@@ -234,6 +240,12 @@ declare class BlinkDataImpl implements BlinkData {
     }): Promise<string>;
     fetch(request: FetchRequest): Promise<FetchResponse>;
     fetchAsync(request: Omit<FetchRequest, 'async'>): Promise<AsyncFetchResponse>;
+    search(query: string, options?: {
+        location?: string;
+        type?: 'news' | 'images' | 'videos' | 'shopping';
+        language?: string;
+        limit?: number;
+    }): Promise<SearchResponse>;
 }
 
 /**

package/dist/index.js

@@ -571,10 +571,10 @@ var HttpClient = class {
     });
   }
   async dataFetch(projectId, request) {
-    return this.request(`/api/data/${projectId}/fetch`, {
-      method: "POST",
-      body: JSON.stringify(request)
-    });
+    return this.post(`/api/data/${projectId}/fetch`, request);
+  }
+  async dataSearch(projectId, request) {
+    return this.post(`/api/data/${projectId}/search`, request);
   }
   /**
    * Private helper methods
@@ -2419,6 +2419,17 @@ var BlinkDataImpl = class {
     }
     throw new BlinkDataError("Unexpected response format from async fetch endpoint");
   }
+  async search(query, options) {
+    const request = {
+      q: query,
+      location: options?.location,
+      hl: options?.language || "en",
+      tbm: options?.type === "news" ? "nws" : options?.type === "images" ? "isch" : options?.type === "videos" ? "vid" : options?.type === "shopping" ? "shop" : void 0,
+      num: options?.limit
+    };
+    const response = await this.httpClient.dataSearch(this.projectId, request);
+    return response.data;
+  }
 };
 
 // src/client.ts