@blinkdotnew/sdk 0.6.1 → 0.7.0

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",
@@ -635,7 +642,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 +752,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'
 
@@ -1038,4 +1045,36 @@ MIT © Blink Team
 
 **Made with ❤️ by the Blink team**
 
-🤖 **Ready to build your next app?** Visit [blink.new](https://blink.new) and let our AI create it for you in seconds! 
+🤖 **Ready to build your next app?** Visit [blink.new](https://blink.new) and let our AI create it for you in seconds! 
+
+### Notifications (NEW!)
+
+```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, a custom 'from' name, and a 'replyTo' address
+const { success } = await blink.notifications.email({
+  to: ['team@example.com', 'manager@example.com'],
+  from: 'Blink Invoicing', // Displays as: "Blink Invoicing" <noreply@project.blink-email.com>
+  replyTo: 'support@example.com',
+  subject: 'New Invoice',
+  html: '<p>Please find the invoice attached.</p>',
+  attachments: [
+    { url: 'https://example.com/invoice.pdf', filename: 'invoice.pdf' }
+  ]
+});
+
+// Handle errors
+try {
+  await blink.notifications.email({ to: 'invalid-email' });
+} catch (error) {
+  if (error instanceof BlinkNotificationsError) {
+    console.error('Failed to send email:', error.message);
+  }
+}
+``` 

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,8 @@ var BlinkRealtimeError = class extends BlinkError {
     this.name = "BlinkRealtimeError";
   }
 };
+var BlinkNotificationsError = class extends BlinkError {
+};
 
 // ../core/src/query-builder.ts
 function buildFilterQuery(condition) {
@@ -2612,7 +2614,9 @@ var BlinkRealtimeChannel = class {
     }
     return new Promise((resolve, reject) => {
       try {
-        const baseUrl = this.httpClient.projectId.includes("localhost") ? "ws://localhost:3000" : "wss://core.blink.new";
+        const httpClient = this.httpClient;
+        const coreUrl = httpClient.coreUrl || "https://core.blink.new";
+        const baseUrl = coreUrl.includes("localhost") ? "ws://localhost:3000" : coreUrl.replace("https://", "wss://").replace("http://", "ws://");
         const wsUrl = `${baseUrl}?project_id=${this.projectId}`;
         const WSClass = getWebSocketClass();
         this.websocket = new WSClass(wsUrl);
@@ -2805,6 +2809,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?.data?.error);
+    }
+  }
+};
+
 // src/client.ts
 var BlinkClientImpl = class {
   auth;
@@ -2813,6 +2884,7 @@ var BlinkClientImpl = class {
   ai;
   data;
   realtime;
+  notifications;
   httpClient;
   constructor(config) {
     this.auth = new BlinkAuth(config);
@@ -2826,6 +2898,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,8 @@ var BlinkRealtimeError = class extends BlinkError {
     this.name = "BlinkRealtimeError";
   }
 };
+var BlinkNotificationsError = class extends BlinkError {
+};
 
 // ../core/src/query-builder.ts
 function buildFilterQuery(condition) {
@@ -2610,7 +2612,9 @@ var BlinkRealtimeChannel = class {
     }
     return new Promise((resolve, reject) => {
       try {
-        const baseUrl = this.httpClient.projectId.includes("localhost") ? "ws://localhost:3000" : "wss://core.blink.new";
+        const httpClient = this.httpClient;
+        const coreUrl = httpClient.coreUrl || "https://core.blink.new";
+        const baseUrl = coreUrl.includes("localhost") ? "ws://localhost:3000" : coreUrl.replace("https://", "wss://").replace("http://", "ws://");
         const wsUrl = `${baseUrl}?project_id=${this.projectId}`;
         const WSClass = getWebSocketClass();
         this.websocket = new WSClass(wsUrl);
@@ -2803,6 +2807,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?.data?.error);
+    }
+  }
+};
+
 // src/client.ts
 var BlinkClientImpl = class {
   auth;
@@ -2811,6 +2882,7 @@ var BlinkClientImpl = class {
   ai;
   data;
   realtime;
+  notifications;
   httpClient;
   constructor(config) {
     this.auth = new BlinkAuth(config);
@@ -2824,6 +2896,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,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth for modern SaaS/AI apps",
   "keywords": [
     "blink",