@blinkdotnew/sdk 0.4.1 → 0.5.0

package/README.md

@@ -52,6 +52,18 @@ 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",
+  method: "POST",
+  headers: { "Authorization": "Bearer {{sendgrid_api_key}}" },
+  body: { /* email data */ }
+})
+
 // Storage operations (instant - returns public URL directly)
 const { publicUrl } = await blink.storage.upload(
   file,
@@ -76,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, spreadsheets, and more
+- **📄 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
@@ -321,6 +333,127 @@ 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
+
+// Basic API call with secret substitution
+const response = await blink.data.fetch({
+  url: 'https://api.sendgrid.com/v3/mail/send',
+  method: 'POST',
+  headers: {
+    'Authorization': 'Bearer {{sendgrid_api_key}}', // Secret replaced server-side
+    'Content-Type': 'application/json'
+  },
+  body: {
+    from: { email: 'me@example.com' },
+    personalizations: [{ to: [{ email: 'user@example.com' }] }],
+    subject: 'Hello from Blink',
+    content: [{ type: 'text/plain', value: 'Sent securely through Blink!' }]
+  }
+});
+
+console.log('Email sent:', response.status === 200);
+console.log('Response:', response.body);
+console.log('Took:', response.durationMs, 'ms');
+
+// GET request with secret in URL and query params
+const weatherData = await blink.data.fetch({
+  url: 'https://api.openweathermap.org/data/2.5/weather',
+  method: 'GET',
+  query: {
+    q: 'London',
+    appid: '{{openweather_api_key}}', // Secret replaced in query params
+    units: 'metric'
+  }
+});
+
+console.log('Weather:', weatherData.body.main.temp, '°C');
+
+// Async/background requests (fire-and-forget)
+const asyncResponse = await blink.data.fetchAsync({
+  url: 'https://api.stripe.com/v1/customers',
+  method: 'POST',
+  headers: {
+    'Authorization': 'Bearer {{stripe_secret_key}}',
+    'Content-Type': 'application/x-www-form-urlencoded'
+  },
+  body: 'email=customer@example.com&name=John Doe'
+});
+
+console.log(asyncResponse.status); // 'triggered'
+console.log(asyncResponse.message); // 'Request triggered in background'
+
+// Multiple secrets in different places
+const complexRequest = await blink.data.fetch({
+  url: 'https://api.github.com/repos/{{github_username}}/{{repo_name}}/issues',
+  method: 'POST',
+  headers: {
+    'Authorization': 'token {{github_token}}',
+    'Accept': 'application/vnd.github.v3+json',
+    'User-Agent': '{{app_name}}'
+  },
+  body: {
+    title: 'Bug Report',
+    body: 'Found via {{app_name}} monitoring'
+  }
+});
+
+// Secret substitution works everywhere:
+// - URL path: /api/{{version}}/users
+// - Query params: ?key={{api_key}}&user={{user_id}}
+// - Headers: Authorization: Bearer {{token}}
+// - Body: { "apiKey": "{{secret}}", "data": "{{value}}" }
+
 // Error handling for data extraction
 try {
   const result = await blink.data.extractFromUrl('https://example.com/huge-file.pdf');
@@ -418,6 +551,47 @@ const todos = await blink.db.todos.list<Todo>({
 // todos is fully typed as ListResponse<Todo>
 ```
 
+### Secret Management for API Proxy
+
+The `blink.data.fetch()` method allows you to make secure API calls with automatic secret substitution. Here's how to set it up:
+
+**Step 1: Store your secrets in your Blink project**
+Visit your project dashboard at [blink.new](https://blink.new) and add your API keys in the "Secrets" section:
+- `sendgrid_api_key` → `SG.abc123...`
+- `openweather_api_key` → `d4f5g6h7...`
+- `stripe_secret_key` → `sk_live_abc123...`
+
+**Step 2: Use secrets in your API calls**
+```typescript
+// Secrets are automatically substituted server-side - never exposed to frontend
+const result = await blink.data.fetch({
+  url: 'https://api.example.com/endpoint',
+  headers: {
+    'Authorization': 'Bearer {{your_secret_key}}' // Replaced with actual value
+  }
+})
+```
+
+**Step 3: Secret substitution works everywhere**
+```typescript
+await blink.data.fetch({
+  url: 'https://api.{{service_domain}}/v{{api_version}}/users/{{user_id}}',
+  query: { 
+    key: '{{api_key}}',
+    format: 'json' 
+  },
+  headers: { 
+    'X-API-Key': '{{secondary_key}}' 
+  },
+  body: {
+    token: '{{auth_token}}',
+    data: 'regular string data'
+  }
+})
+```
+
+All `{{secret_name}}` placeholders are replaced with encrypted values from your project's secret store. Secrets never leave the server and are never visible to your frontend code.
+
 ## 🌍 Framework Examples
 
 ### React
@@ -442,6 +616,100 @@ 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('')
+  
+  const sendEmail = async () => {
+    setStatus('Sending...')
+    try {
+      const response = await blink.data.fetch({
+        url: 'https://api.sendgrid.com/v3/mail/send',
+        method: 'POST',
+        headers: {
+          'Authorization': 'Bearer {{sendgrid_api_key}}', // Secret safe on server
+          'Content-Type': 'application/json'
+        },
+        body: {
+          from: { email: 'app@example.com' },
+          personalizations: [{ to: [{ email: user.email }] }],
+          subject: 'Welcome to our app!',
+          content: [{ type: 'text/plain', value: 'Thanks for signing up!' }]
+        }
+      })
+      
+      setStatus(response.status === 202 ? 'Email sent!' : 'Failed to send')
+    } catch (error) {
+      setStatus('Error: ' + error.message)
+    }
+  }
+  
+  return (
+    <div>
+      <button onClick={sendEmail}>Send Welcome Email</button>
+      <p>{status}</p>
+    </div>
+  )
+}
 ```
 
 ### Next.js API Routes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, 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';
 
 /**
@@ -211,6 +211,14 @@ interface BlinkData {
         width?: number;
         height?: number;
     }): 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;
@@ -230,6 +238,14 @@ declare class BlinkDataImpl implements BlinkData {
         width?: number;
         height?: number;
     }): 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, 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';
 
 /**
@@ -211,6 +211,14 @@ interface BlinkData {
         width?: number;
         height?: number;
     }): 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;
@@ -230,6 +238,14 @@ declare class BlinkDataImpl implements BlinkData {
         width?: number;
         height?: number;
     }): 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

@@ -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) {
@@ -564,6 +570,12 @@ var HttpClient = class {
       body: JSON.stringify(request)
     });
   }
+  async dataFetch(projectId, request) {
+    return this.post(`/api/data/${projectId}/fetch`, request);
+  }
+  async dataSearch(projectId, request) {
+    return this.post(`/api/data/${projectId}/search`, request);
+  }
   /**
    * Private helper methods
    */
@@ -2392,6 +2404,32 @@ var BlinkDataImpl = class {
     const response = await this.httpClient.dataScreenshot(this.projectId, request);
     return response.data.url;
   }
+  async fetch(request) {
+    const response = await this.httpClient.dataFetch(this.projectId, request);
+    if ("status" in response.data && "headers" in response.data) {
+      return response.data;
+    }
+    throw new BlinkDataError("Unexpected response format from fetch endpoint");
+  }
+  async fetchAsync(request) {
+    const asyncRequest = { ...request, async: true };
+    const response = await this.httpClient.dataFetch(this.projectId, asyncRequest);
+    if ("status" in response.data && response.data.status === "triggered") {
+      return response.data;
+    }
+    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