@blinkdotnew/sdk 0.6.2 → 0.7.1

package/README.md

@@ -56,6 +56,13 @@ const screenshotUrl = await blink.data.screenshot("https://competitor.com")
 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" })
 
+// Notifications (NEW!)
+const { success } = await blink.notifications.email({
+  to: 'customer@example.com',
+  subject: 'Your order has shipped!',
+  html: '<h1>Order Confirmation</h1><p>Your order #12345 is on its way.</p>'
+})
+
 // Secure API proxy (call external APIs with secret substitution)
 const response = await blink.data.fetch({
   url: "https://api.sendgrid.com/v3/mail/send",
@@ -100,6 +107,7 @@ This SDK powers every Blink-generated app with:
 - **🤖 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, screenshots, and web search
 - **📁 Storage**: File upload, download, and management
+- **📧 Notifications**: Email sending with attachments, custom branding, and delivery tracking
 - **⚡ Realtime**: WebSocket-based pub/sub messaging, presence tracking, and live updates
 - **🌐 Universal**: Works on client-side and server-side
 - **📱 Framework Agnostic**: React, Vue, Svelte, vanilla JS, Node.js, Deno
@@ -492,6 +500,56 @@ const { publicUrl } = await blink.storage.upload(
 await blink.storage.remove('file1.jpg', 'file2.jpg')
 ```
 
+### Notifications Operations
+
+```typescript
+// Send a simple email
+const { success, messageId } = await blink.notifications.email({
+  to: 'customer@example.com',
+  subject: 'Your order has shipped!',
+  html: '<h1>Order Confirmation</h1><p>Your order #12345 is on its way.</p>'
+})
+
+// Send an email with attachments and custom sender
+const { success } = await blink.notifications.email({
+  to: ['team@example.com', 'manager@example.com'],
+  from: 'Blink Invoicing', // Custom sender name
+  replyTo: 'support@example.com',
+  subject: 'New Invoice',
+  html: '<p>Please find the invoice attached.</p>',
+  text: 'Please find the invoice attached.', // Plain text fallback
+  cc: 'manager@example.com',
+  bcc: 'archive@example.com',
+  attachments: [
+    { 
+      url: 'https://example.com/invoice.pdf', 
+      filename: 'invoice.pdf',
+      type: 'application/pdf'
+    }
+  ]
+})
+
+// Send to multiple recipients
+const { success } = await blink.notifications.email({
+  to: ['user1@example.com', 'user2@example.com'],
+  subject: 'Team Update',
+  html: '<h2>Weekly Update</h2><p>Here are this week\'s highlights...</p>'
+})
+
+// Error handling
+try {
+  await blink.notifications.email({
+    to: 'customer@example.com',
+    subject: 'Welcome!',
+    html: '<p>Welcome to our service!</p>'
+  })
+} catch (error) {
+  if (error instanceof BlinkNotificationsError) {
+    console.error('Failed to send email:', error.message)
+  }
+}
+```
+
 ### Realtime Operations
 
 ```typescript
@@ -635,7 +693,7 @@ try {
 ### Error Handling
 
 ```typescript
-import { BlinkAuthError, BlinkAIError, BlinkStorageError, BlinkDataError, BlinkRealtimeError } from '@blinkdotnew/sdk'
+import { BlinkAuthError, BlinkAIError, BlinkStorageError, BlinkDataError, BlinkRealtimeError, BlinkNotificationsError } from '@blinkdotnew/sdk'
 
 try {
   const user = await blink.auth.me()
@@ -745,7 +803,7 @@ All `{{secret_name}}` placeholders are replaced with encrypted values from your
 
 ### React
 
-```typescript
+```typitten
 import { createClient } from '@blinkdotnew/sdk'
 import { useState, useEffect } from 'react'
 

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, SearchResponse, BlinkStorage, BlinkAI, BlinkRealtime, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, RealtimeChannel, RealtimeMessage, RealtimeSubscribeOptions, RealtimePublishOptions, PresenceUser } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, SearchResponse, BlinkStorage, BlinkAI, BlinkRealtime, BlinkNotifications, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, RealtimeChannel, RealtimeMessage, RealtimeSubscribeOptions, RealtimePublishOptions, PresenceUser } from '@blink/core';
 export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkRealtime, BlinkRealtimeError, BlinkStorage, BlinkUser, CreateOptions, DataExtraction, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, PresenceUser, QueryOptions, RealtimeChannel, RealtimeGetMessagesOptions, RealtimeMessage, RealtimePublishOptions, RealtimeSubscribeOptions, SearchRequest, SearchResponse, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
 
 /**
@@ -260,6 +260,7 @@ interface BlinkClient {
     ai: BlinkAI;
     data: BlinkData;
     realtime: BlinkRealtime;
+    notifications: BlinkNotifications;
 }
 /**
  * Create a new Blink client instance

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, SearchResponse, BlinkStorage, BlinkAI, BlinkRealtime, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, RealtimeChannel, RealtimeMessage, RealtimeSubscribeOptions, RealtimePublishOptions, PresenceUser } from '@blink/core';
+import { BlinkClientConfig, BlinkUser, AuthState, HttpClient, TableOperations, CreateOptions, UpsertOptions, QueryOptions, ListResponse, UpdateOptions, FilterCondition, ScrapeResult, FetchRequest, FetchResponse, AsyncFetchResponse, SearchResponse, BlinkStorage, BlinkAI, BlinkRealtime, BlinkNotifications, StorageUploadOptions, StorageUploadResponse, TextGenerationRequest, TextGenerationResponse, ObjectGenerationRequest, ObjectGenerationResponse, ImageGenerationRequest, ImageGenerationResponse, SpeechGenerationRequest, SpeechGenerationResponse, TranscriptionRequest, TranscriptionResponse, RealtimeChannel, RealtimeMessage, RealtimeSubscribeOptions, RealtimePublishOptions, PresenceUser } from '@blink/core';
 export { AuthState, AuthTokens, BlinkAI, BlinkClientConfig, BlinkRealtime, BlinkRealtimeError, BlinkStorage, BlinkUser, CreateOptions, DataExtraction, FileObject, FilterCondition, ImageGenerationRequest, ImageGenerationResponse, ListResponse, Message, ObjectGenerationRequest, ObjectGenerationResponse, PresenceUser, QueryOptions, RealtimeChannel, RealtimeGetMessagesOptions, RealtimeMessage, RealtimePublishOptions, RealtimeSubscribeOptions, SearchRequest, SearchResponse, SpeechGenerationRequest, SpeechGenerationResponse, StorageUploadOptions, StorageUploadResponse, TableOperations, TextGenerationRequest, TextGenerationResponse, TokenUsage, TranscriptionRequest, TranscriptionResponse, UpdateOptions, UpsertOptions } from '@blink/core';
 
 /**
@@ -260,6 +260,7 @@ interface BlinkClient {
     ai: BlinkAI;
     data: BlinkData;
     realtime: BlinkRealtime;
+    notifications: BlinkNotifications;
 }
 /**
  * Create a new Blink client instance

package/dist/index.js

@@ -59,6 +59,12 @@ var BlinkRealtimeError = class extends BlinkError {
     this.name = "BlinkRealtimeError";
   }
 };
+var BlinkNotificationsError = class extends BlinkError {
+  constructor(message, status, details) {
+    super(message, "NOTIFICATIONS_ERROR", status, details);
+    this.name = "BlinkNotificationsError";
+  }
+};
 
 // ../core/src/query-builder.ts
 function buildFilterQuery(condition) {
@@ -2807,6 +2813,73 @@ var BlinkRealtimeImpl = class {
   }
 };
 
+// src/notifications.ts
+var BlinkNotificationsImpl = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /**
+   * Sends an email using the Blink Notifications API.
+   *
+   * @param params - An object containing the details for the email.
+   *   - `to`: The recipient's email address or an array of addresses.
+   *   - `subject`: The subject line of the email.
+   *   - `html`: The HTML body of the email. For best results across all email
+   *             clients (like Gmail, Outlook), use inline CSS and table-based layouts.
+   *   - `text`: A plain-text version of the email body (optional).
+   *   - `from`: A custom sender name (e.g., "Acme Inc"). The email address will
+   *             be auto-generated by the project (e.g., "noreply@project.blink-email.com").
+   *   - `replyTo`: An email address for recipients to reply to (optional).
+   *   - `cc`: A CC recipient's email address or an array of addresses (optional).
+   *   - `bcc`: A BCC recipient's email address or an array of addresses (optional).
+   *   - `attachments`: An array of objects for files to attach, each with a `url`.
+   *                    The file at the URL will be fetched and attached by the server.
+   *
+   * @example
+   * ```ts
+   * // Send a simple email
+   * const { success, messageId } = await blink.notifications.email({
+   *   to: 'customer@example.com',
+   *   subject: 'Your order has shipped!',
+   *   html: '<h1>Order Confirmation</h1><p>Your order #12345 is on its way.</p>'
+   * });
+   *
+   * // Send an email with attachments and a custom from name
+   * const { success } = await blink.notifications.email({
+   *   to: ['team@example.com', 'manager@example.com'],
+   *   subject: 'New Invoice',
+   *   from: 'Blink Invoicing',
+   *   html: '<p>Please find the invoice attached.</p>',
+   *   attachments: [
+   *     { url: 'https://example.com/invoice.pdf', filename: 'invoice.pdf' }
+   *   ]
+   * });
+   * ```
+   *
+   * @returns A promise that resolves with an object containing the status of the email send.
+   *   - `success`: A boolean indicating if the email was sent successfully.
+   *   - `messageId`: The unique ID of the message from the email provider.
+   */
+  async email(params) {
+    try {
+      if (!params.to || !params.subject || !params.html && !params.text) {
+        throw new BlinkNotificationsError('The "to", "subject", and either "html" or "text" fields are required.');
+      }
+      const response = await this.httpClient.post("/notifications/email", params);
+      if (!response.data || typeof response.data.success !== "boolean") {
+        throw new BlinkNotificationsError("Invalid response from email API");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkNotificationsError) {
+        throw error;
+      }
+      const errorMessage = error.response?.data?.error?.message || error.message || "An unknown error occurred";
+      throw new BlinkNotificationsError(`Failed to send email: ${errorMessage}`, error.response?.status, error.response?.data?.error);
+    }
+  }
+};
+
 // src/client.ts
 var BlinkClientImpl = class {
   auth;
@@ -2815,6 +2888,7 @@ var BlinkClientImpl = class {
   ai;
   data;
   realtime;
+  notifications;
   httpClient;
   constructor(config) {
     this.auth = new BlinkAuth(config);
@@ -2828,6 +2902,7 @@ var BlinkClientImpl = class {
     this.ai = new BlinkAIImpl(this.httpClient);
     this.data = new BlinkDataImpl(this.httpClient, config.projectId);
     this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
+    this.notifications = new BlinkNotificationsImpl(this.httpClient);
   }
 };
 function createClient(config) {

package/dist/index.mjs

@@ -57,6 +57,12 @@ var BlinkRealtimeError = class extends BlinkError {
     this.name = "BlinkRealtimeError";
   }
 };
+var BlinkNotificationsError = class extends BlinkError {
+  constructor(message, status, details) {
+    super(message, "NOTIFICATIONS_ERROR", status, details);
+    this.name = "BlinkNotificationsError";
+  }
+};
 
 // ../core/src/query-builder.ts
 function buildFilterQuery(condition) {
@@ -2805,6 +2811,73 @@ var BlinkRealtimeImpl = class {
   }
 };
 
+// src/notifications.ts
+var BlinkNotificationsImpl = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /**
+   * Sends an email using the Blink Notifications API.
+   *
+   * @param params - An object containing the details for the email.
+   *   - `to`: The recipient's email address or an array of addresses.
+   *   - `subject`: The subject line of the email.
+   *   - `html`: The HTML body of the email. For best results across all email
+   *             clients (like Gmail, Outlook), use inline CSS and table-based layouts.
+   *   - `text`: A plain-text version of the email body (optional).
+   *   - `from`: A custom sender name (e.g., "Acme Inc"). The email address will
+   *             be auto-generated by the project (e.g., "noreply@project.blink-email.com").
+   *   - `replyTo`: An email address for recipients to reply to (optional).
+   *   - `cc`: A CC recipient's email address or an array of addresses (optional).
+   *   - `bcc`: A BCC recipient's email address or an array of addresses (optional).
+   *   - `attachments`: An array of objects for files to attach, each with a `url`.
+   *                    The file at the URL will be fetched and attached by the server.
+   *
+   * @example
+   * ```ts
+   * // Send a simple email
+   * const { success, messageId } = await blink.notifications.email({
+   *   to: 'customer@example.com',
+   *   subject: 'Your order has shipped!',
+   *   html: '<h1>Order Confirmation</h1><p>Your order #12345 is on its way.</p>'
+   * });
+   *
+   * // Send an email with attachments and a custom from name
+   * const { success } = await blink.notifications.email({
+   *   to: ['team@example.com', 'manager@example.com'],
+   *   subject: 'New Invoice',
+   *   from: 'Blink Invoicing',
+   *   html: '<p>Please find the invoice attached.</p>',
+   *   attachments: [
+   *     { url: 'https://example.com/invoice.pdf', filename: 'invoice.pdf' }
+   *   ]
+   * });
+   * ```
+   *
+   * @returns A promise that resolves with an object containing the status of the email send.
+   *   - `success`: A boolean indicating if the email was sent successfully.
+   *   - `messageId`: The unique ID of the message from the email provider.
+   */
+  async email(params) {
+    try {
+      if (!params.to || !params.subject || !params.html && !params.text) {
+        throw new BlinkNotificationsError('The "to", "subject", and either "html" or "text" fields are required.');
+      }
+      const response = await this.httpClient.post("/notifications/email", params);
+      if (!response.data || typeof response.data.success !== "boolean") {
+        throw new BlinkNotificationsError("Invalid response from email API");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkNotificationsError) {
+        throw error;
+      }
+      const errorMessage = error.response?.data?.error?.message || error.message || "An unknown error occurred";
+      throw new BlinkNotificationsError(`Failed to send email: ${errorMessage}`, error.response?.status, error.response?.data?.error);
+    }
+  }
+};
+
 // src/client.ts
 var BlinkClientImpl = class {
   auth;
@@ -2813,6 +2886,7 @@ var BlinkClientImpl = class {
   ai;
   data;
   realtime;
+  notifications;
   httpClient;
   constructor(config) {
     this.auth = new BlinkAuth(config);
@@ -2826,6 +2900,7 @@ var BlinkClientImpl = class {
     this.ai = new BlinkAIImpl(this.httpClient);
     this.data = new BlinkDataImpl(this.httpClient, config.projectId);
     this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
+    this.notifications = new BlinkNotificationsImpl(this.httpClient);
   }
 };
 function createClient(config) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.6.2",
-  "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth for modern SaaS/AI apps",
+  "version": "0.7.1",
+  "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",
     "sdk",
@@ -10,6 +10,8 @@
     "database",
     "ai",
     "storage",
+    "notifications",
+    "email",
     "crud",
     "client"
   ],