@blinkdotnew/sdk 2.6.1 → 2.7.0

package/dist/index.d.mts

@@ -313,6 +313,31 @@ declare class BlinkError extends Error {
     details?: any | undefined;
     constructor(message: string, code?: string | undefined, status?: number | undefined, details?: any | undefined);
 }
+/**
+ * A React Native / Expo local file descriptor.
+ *
+ * On React Native the networking layer streams the file directly from `uri` when
+ * a `{ uri, name, type }` object is appended to FormData. This is the only
+ * reliable way to multipart-upload a local file on RN — wrapping the file's bytes
+ * in a `Blob` (e.g. `new Blob([blob])`) loses the underlying data and produces a
+ * 0-byte upload. Pass the descriptor returned by expo-image-picker /
+ * expo-camera (its `uri`) straight to `blink.storage.upload`.
+ *
+ * @example
+ * ```ts
+ * await blink.storage.upload(
+ *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+ *   `corrections/${id}`
+ * )
+ * ```
+ */
+interface ReactNativeFile {
+    uri: string;
+    name?: string;
+    type?: string;
+}
+/** Anything Blink storage can upload, across web / Node.js / React Native. */
+type BlinkUploadFile = File | Blob | Buffer | ArrayBuffer | ReactNativeFile;
 interface StorageUploadOptions {
     /**
      * @deprecated Blink storage uploads are add-only by default. This option is ignored.
@@ -341,7 +366,7 @@ interface FileObject {
     user_metadata?: Record<string, any>;
 }
 interface BlinkStorage {
-    upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    upload(file: BlinkUploadFile, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
     download(path: string, options?: {
         filename?: string;
     }): Promise<StorageDownloadResponse>;
@@ -1013,7 +1038,7 @@ declare class HttpClient {
     /**
      * Upload file with progress tracking
      */
-    uploadFile(path: string, file: File | Blob | Buffer, filePath: string, options?: {
+    uploadFile(path: string, file: BlinkUploadFile, filePath: string, options?: {
         upsert?: boolean;
         onProgress?: (percent: number) => void;
         contentType?: string;
@@ -1262,7 +1287,13 @@ declare class HttpClient {
  * Platform detection for cross-platform compatibility
  * Detects whether code is running on web, React Native, Node.js, or Deno
  */
+
 type Platform = 'web' | 'react-native' | 'node' | 'deno';
+/**
+ * True when `file` is a React Native / Expo file descriptor (`{ uri, name?, type? }`),
+ * as opposed to a File / Blob / Buffer / ArrayBuffer.
+ */
+declare function isReactNativeFile(file: unknown): file is ReactNativeFile;
 /**
  * Current platform
  */
@@ -2586,7 +2617,8 @@ declare class BlinkStorageImpl implements BlinkStorage {
     /**
      * Upload a file to project storage
      *
-     * @param file - File, Blob, or Buffer to upload
+     * @param file - File, Blob, Buffer, ArrayBuffer, or a React Native file
+     *   descriptor (`{ uri, name?, type? }`) to upload
      * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
      * @param options - Upload options including upsert and progress callback
      * @returns Promise resolving to upload response with public URL
@@ -2601,6 +2633,13 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * );
      * // If file is PNG, final path will be: avatars/user123.png
      *
+     * // React Native / Expo: pass the picker/camera result's uri directly.
+     * // Do NOT wrap it in a Blob — that uploads a 0-byte file on RN.
+     * const { publicUrl } = await blink.storage.upload(
+     *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+     *   `corrections/${id}`
+     * );
+     *
      * // Or with extension (will be corrected if wrong)
      * const { publicUrl } = await blink.storage.upload(
      *   pngFile,
@@ -2610,12 +2649,22 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * // Final path will be: avatars/user123.png (auto-corrected!)
      * ```
      */
-    upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    upload(file: BlinkUploadFile, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
     /**
      * Detect file type from actual file content and correct path extension
      * This ensures the path extension always matches the actual file type
      */
     private detectFileTypeAndCorrectPath;
+    /**
+     * Replace (or append) the extension on the last path segment.
+     */
+    private rebuildPathWithExtension;
+    /**
+     * Pull a lowercase extension out of a filename, path, or uri (no dot, '' if
+     * none). Strips any query/fragment (RN content:// uris carry them) and only
+     * accepts a sane extension so junk never leaks into the storage path.
+     */
+    private getExtensionFromName;
     /**
      * Get the first few bytes of a file to analyze its signature
      */
@@ -3968,4 +4017,4 @@ declare const mediaTools: readonly ["generate_image", "edit_image", "generate_vi
  */
 declare function serializeTools(tools: string[]): string[];
 
-export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkQueue, BlinkQueueCreditError, BlinkQueueImpl, type BlinkQueueSchedule, type BlinkQueueStats, type BlinkQueueTask, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type QueueOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type ScheduleOptions, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkQueue, BlinkQueueCreditError, BlinkQueueImpl, type BlinkQueueSchedule, type BlinkQueueStats, type BlinkQueueTask, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUploadFile, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type QueueOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type ReactNativeFile, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type ScheduleOptions, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isReactNativeFile, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };

package/dist/index.d.ts

@@ -313,6 +313,31 @@ declare class BlinkError extends Error {
     details?: any | undefined;
     constructor(message: string, code?: string | undefined, status?: number | undefined, details?: any | undefined);
 }
+/**
+ * A React Native / Expo local file descriptor.
+ *
+ * On React Native the networking layer streams the file directly from `uri` when
+ * a `{ uri, name, type }` object is appended to FormData. This is the only
+ * reliable way to multipart-upload a local file on RN — wrapping the file's bytes
+ * in a `Blob` (e.g. `new Blob([blob])`) loses the underlying data and produces a
+ * 0-byte upload. Pass the descriptor returned by expo-image-picker /
+ * expo-camera (its `uri`) straight to `blink.storage.upload`.
+ *
+ * @example
+ * ```ts
+ * await blink.storage.upload(
+ *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+ *   `corrections/${id}`
+ * )
+ * ```
+ */
+interface ReactNativeFile {
+    uri: string;
+    name?: string;
+    type?: string;
+}
+/** Anything Blink storage can upload, across web / Node.js / React Native. */
+type BlinkUploadFile = File | Blob | Buffer | ArrayBuffer | ReactNativeFile;
 interface StorageUploadOptions {
     /**
      * @deprecated Blink storage uploads are add-only by default. This option is ignored.
@@ -341,7 +366,7 @@ interface FileObject {
     user_metadata?: Record<string, any>;
 }
 interface BlinkStorage {
-    upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    upload(file: BlinkUploadFile, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
     download(path: string, options?: {
         filename?: string;
     }): Promise<StorageDownloadResponse>;
@@ -1013,7 +1038,7 @@ declare class HttpClient {
     /**
      * Upload file with progress tracking
      */
-    uploadFile(path: string, file: File | Blob | Buffer, filePath: string, options?: {
+    uploadFile(path: string, file: BlinkUploadFile, filePath: string, options?: {
         upsert?: boolean;
         onProgress?: (percent: number) => void;
         contentType?: string;
@@ -1262,7 +1287,13 @@ declare class HttpClient {
  * Platform detection for cross-platform compatibility
  * Detects whether code is running on web, React Native, Node.js, or Deno
  */
+
 type Platform = 'web' | 'react-native' | 'node' | 'deno';
+/**
+ * True when `file` is a React Native / Expo file descriptor (`{ uri, name?, type? }`),
+ * as opposed to a File / Blob / Buffer / ArrayBuffer.
+ */
+declare function isReactNativeFile(file: unknown): file is ReactNativeFile;
 /**
  * Current platform
  */
@@ -2586,7 +2617,8 @@ declare class BlinkStorageImpl implements BlinkStorage {
     /**
      * Upload a file to project storage
      *
-     * @param file - File, Blob, or Buffer to upload
+     * @param file - File, Blob, Buffer, ArrayBuffer, or a React Native file
+     *   descriptor (`{ uri, name?, type? }`) to upload
      * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
      * @param options - Upload options including upsert and progress callback
      * @returns Promise resolving to upload response with public URL
@@ -2601,6 +2633,13 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * );
      * // If file is PNG, final path will be: avatars/user123.png
      *
+     * // React Native / Expo: pass the picker/camera result's uri directly.
+     * // Do NOT wrap it in a Blob — that uploads a 0-byte file on RN.
+     * const { publicUrl } = await blink.storage.upload(
+     *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+     *   `corrections/${id}`
+     * );
+     *
      * // Or with extension (will be corrected if wrong)
      * const { publicUrl } = await blink.storage.upload(
      *   pngFile,
@@ -2610,12 +2649,22 @@ declare class BlinkStorageImpl implements BlinkStorage {
      * // Final path will be: avatars/user123.png (auto-corrected!)
      * ```
      */
-    upload(file: File | Blob | Buffer, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
+    upload(file: BlinkUploadFile, path: string, options?: StorageUploadOptions): Promise<StorageUploadResponse>;
     /**
      * Detect file type from actual file content and correct path extension
      * This ensures the path extension always matches the actual file type
      */
     private detectFileTypeAndCorrectPath;
+    /**
+     * Replace (or append) the extension on the last path segment.
+     */
+    private rebuildPathWithExtension;
+    /**
+     * Pull a lowercase extension out of a filename, path, or uri (no dot, '' if
+     * none). Strips any query/fragment (RN content:// uris carry them) and only
+     * accepts a sane extension so junk never leaks into the storage path.
+     */
+    private getExtensionFromName;
     /**
      * Get the first few bytes of a file to analyze its signature
      */
@@ -3968,4 +4017,4 @@ declare const mediaTools: readonly ["generate_image", "edit_image", "generate_vi
  */
 declare function serializeTools(tools: string[]): string[];
 
-export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkQueue, BlinkQueueCreditError, BlinkQueueImpl, type BlinkQueueSchedule, type BlinkQueueStats, type BlinkQueueTask, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type QueueOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type ScheduleOptions, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { type AISearchOptions, Agent, type AgentBilling, type AgentConfig, type AgentNonStreamMessagesRequest, type AgentNonStreamPromptRequest, type AgentOptions, type AgentRequest, type AgentResponse, type AgentStep, type AgentStreamRequest, type TokenUsage as AgentTokenUsage, type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkQueue, BlinkQueueCreditError, BlinkQueueImpl, type BlinkQueueSchedule, type BlinkQueueStats, type BlinkQueueTask, type BlinkRAG, BlinkRAGImpl, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkSandbox, BlinkSandboxImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkTokenType, type BlinkUploadFile, type BlinkUser, type ClientTool, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type ContextPolicy, type CreateCollectionOptions, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type GenerateOptions, type ImageGenerationRequest, type ImageGenerationResponse, type JSONSchema, type ListDocumentsOptions, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type QueueOptions, type RAGAISearchResult, type RAGAISearchSource, type RAGCollection, type RAGDocument, type RAGSearchResponse, type RAGSearchResult, type ReactNativeFile, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, SANDBOX_TEMPLATES, type Sandbox, type SandboxConnectOptions, SandboxConnectionError, type SandboxCreateOptions, type SandboxTemplate, type ScheduleOptions, type SearchOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StopCondition, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type StreamOptions, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenIntrospectionResult, type TokenUsage$1 as TokenUsage, type ToolCall, type ToolResult, type TranscriptionRequest, type TranscriptionResponse, type UIMessage, type UIMessagePart, type UpdateOptions, type UploadOptions, type UpsertOptions, type WaitForReadyOptions, type WebBrowserModule, WebStorageAdapter, type WebhookTool, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isReactNativeFile, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };

package/dist/index.js

@@ -8,6 +8,9 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // ../core/src/platform.ts
+function isReactNativeFile(file) {
+  return typeof file === "object" && file !== null && typeof file.uri === "string";
+}
 function detectPlatform() {
   if (typeof Deno !== "undefined") {
     return "deno";
@@ -659,11 +662,26 @@ var HttpClient = class {
   async uploadFile(path, file, filePath, options = {}) {
     const url = this.buildUrl(path);
     const formData = new FormData();
-    if (file instanceof File) {
+    const fallbackName = filePath.split("/").pop() || "file";
+    if (isReactNativeFile(file)) {
+      const part = {
+        uri: file.uri,
+        name: file.name || fallbackName,
+        type: file.type || options.contentType || "application/octet-stream"
+      };
+      formData.append("file", part);
+    } else if (typeof File !== "undefined" && file instanceof File) {
       formData.append("file", file);
-    } else if (file instanceof Blob) {
-      const blobWithType = options.contentType ? new Blob([file], { type: options.contentType }) : file;
-      formData.append("file", blobWithType);
+    } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+      if (isReactNative) {
+        formData.append("file", file, fallbackName);
+      } else {
+        const blobWithType = options.contentType ? new Blob([file], { type: options.contentType }) : file;
+        formData.append("file", blobWithType);
+      }
+    } else if (file instanceof ArrayBuffer) {
+      const blob = new Blob([new Uint8Array(file)], { type: options.contentType || "application/octet-stream" });
+      formData.append("file", blob);
     } else if (typeof Buffer !== "undefined" && file instanceof Buffer) {
       const blob = new Blob([new Uint8Array(file)], { type: options.contentType || "application/octet-stream" });
       formData.append("file", blob);
@@ -3571,12 +3589,13 @@ var BlinkStorageImpl = class {
   }
   /**
    * Upload a file to project storage
-   * 
-   * @param file - File, Blob, or Buffer to upload
+   *
+   * @param file - File, Blob, Buffer, ArrayBuffer, or a React Native file
+   *   descriptor (`{ uri, name?, type? }`) to upload
    * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
    * @param options - Upload options including upsert and progress callback
    * @returns Promise resolving to upload response with public URL
-   * 
+   *
    * @example
    * ```ts
    * // Extension automatically corrected to match actual file type
@@ -3586,7 +3605,14 @@ var BlinkStorageImpl = class {
    *   { upsert: true }
    * );
    * // If file is PNG, final path will be: avatars/user123.png
-   * 
+   *
+   * // React Native / Expo: pass the picker/camera result's uri directly.
+   * // Do NOT wrap it in a Blob — that uploads a 0-byte file on RN.
+   * const { publicUrl } = await blink.storage.upload(
+   *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+   *   `corrections/${id}`
+   * );
+   *
    * // Or with extension (will be corrected if wrong)
    * const { publicUrl } = await blink.storage.upload(
    *   pngFile,
@@ -3606,8 +3632,12 @@ var BlinkStorageImpl = class {
       }
       const maxSize = 50 * 1024 * 1024;
       let fileSize = 0;
-      if (file instanceof File || file instanceof Blob) {
+      if (typeof File !== "undefined" && file instanceof File) {
         fileSize = file.size;
+      } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+        fileSize = file.size;
+      } else if (file instanceof ArrayBuffer) {
+        fileSize = file.byteLength;
       } else if (typeof Buffer !== "undefined" && file instanceof Buffer) {
         fileSize = file.length;
       }
@@ -3659,29 +3689,30 @@ var BlinkStorageImpl = class {
    */
   async detectFileTypeAndCorrectPath(file, originalPath) {
     try {
-      const fileSignature = await this.getFileSignature(file);
-      const detectedType = this.detectFileTypeFromSignature(fileSignature);
-      let detectedContentType = detectedType.mimeType;
-      let detectedExtension = detectedType.extension;
-      if (!detectedContentType && file instanceof File && file.type) {
-        detectedContentType = file.type;
-        detectedExtension = this.getExtensionFromMimeType(file.type);
+      let detectedContentType = "";
+      let detectedExtension = "";
+      if (isReactNativeFile(file)) {
+        detectedContentType = file.type || "";
+        const mimeExt = detectedContentType ? this.getExtensionFromMimeType(detectedContentType) : "";
+        detectedExtension = (mimeExt && mimeExt !== "bin" ? mimeExt : "") || this.getExtensionFromName(file.name) || this.getExtensionFromName(file.uri) || this.getExtensionFromName(originalPath);
+      } else {
+        const fileSignature = await this.getFileSignature(file);
+        const detectedType = this.detectFileTypeFromSignature(fileSignature);
+        detectedContentType = detectedType.mimeType;
+        detectedExtension = detectedType.extension;
+        if (!detectedContentType && typeof File !== "undefined" && file instanceof File && file.type) {
+          detectedContentType = file.type;
+          detectedExtension = this.getExtensionFromMimeType(file.type);
+        }
       }
       if (!detectedContentType) {
         detectedContentType = "application/octet-stream";
-        detectedExtension = "bin";
       }
-      const pathParts = originalPath.split("/");
-      const fileName = pathParts[pathParts.length - 1];
-      const directory = pathParts.slice(0, -1).join("/");
-      if (!fileName) {
-        throw new Error("Invalid path: filename cannot be empty");
+      if (!detectedExtension) {
+        detectedExtension = "bin";
       }
-      const nameWithoutExt = fileName.includes(".") ? fileName.substring(0, fileName.lastIndexOf(".")) : fileName;
-      const correctedFileName = `${nameWithoutExt}.${detectedExtension}`;
-      const correctedPath = directory ? `${directory}/${correctedFileName}` : correctedFileName;
       return {
-        correctedPath,
+        correctedPath: this.rebuildPathWithExtension(originalPath, detectedExtension),
         detectedContentType
       };
     } catch (error) {
@@ -3691,15 +3722,45 @@ var BlinkStorageImpl = class {
       };
     }
   }
+  /**
+   * Replace (or append) the extension on the last path segment.
+   */
+  rebuildPathWithExtension(originalPath, extension) {
+    const pathParts = originalPath.split("/");
+    const fileName = pathParts[pathParts.length - 1];
+    const directory = pathParts.slice(0, -1).join("/");
+    if (!fileName) {
+      throw new Error("Invalid path: filename cannot be empty");
+    }
+    const nameWithoutExt = fileName.includes(".") ? fileName.substring(0, fileName.lastIndexOf(".")) : fileName;
+    const correctedFileName = `${nameWithoutExt}.${extension}`;
+    return directory ? `${directory}/${correctedFileName}` : correctedFileName;
+  }
+  /**
+   * Pull a lowercase extension out of a filename, path, or uri (no dot, '' if
+   * none). Strips any query/fragment (RN content:// uris carry them) and only
+   * accepts a sane extension so junk never leaks into the storage path.
+   */
+  getExtensionFromName(name) {
+    if (!name) return "";
+    const base = (name.split(/[?#]/)[0] || "").split("/").pop() || "";
+    const dot = base.lastIndexOf(".");
+    if (dot <= 0) return "";
+    const ext = base.substring(dot + 1).toLowerCase();
+    return /^[a-z0-9]{1,8}$/.test(ext) ? ext : "";
+  }
   /**
    * Get the first few bytes of a file to analyze its signature
    */
   async getFileSignature(file) {
     const bytesToRead = 12;
+    if (file instanceof ArrayBuffer) {
+      return new Uint8Array(file.slice(0, bytesToRead));
+    }
     if (typeof Buffer !== "undefined" && file instanceof Buffer) {
       return new Uint8Array(file.slice(0, bytesToRead));
     }
-    if (file instanceof File || file instanceof Blob) {
+    if (typeof File !== "undefined" && file instanceof File || typeof Blob !== "undefined" && file instanceof Blob) {
       const slice = file.slice(0, bytesToRead);
       const arrayBuffer = await slice.arrayBuffer();
       return new Uint8Array(arrayBuffer);
@@ -5199,6 +5260,9 @@ var BlinkAIImpl = class {
    * ```
    */
   createAgent(options) {
+    if (!options) {
+      throw new BlinkAIError("createAgent(options) requires an options object with at least a `model`.");
+    }
     const agent = new Agent(options);
     agent._setHttpClient(this.httpClient);
     return agent;
@@ -5213,6 +5277,11 @@ var BlinkAIImpl = class {
    * @returns The same Agent instance (with httpClient set)
    */
   bindAgent(agent) {
+    if (!agent) {
+      throw new BlinkAIError(
+        "bindAgent(agent) requires an Agent instance but received null/undefined. Create one first with `new Agent({...})` or `blink.ai.createAgent({...})`. (The useAgent() hook stays idle while its `agent` is null, so this only fires on a direct bindAgent() call with a missing agent.)"
+      );
+    }
     agent._setHttpClient(this.httpClient);
     return agent;
   }
@@ -7099,6 +7168,7 @@ exports.isBrowser = isBrowser;
 exports.isDeno = isDeno;
 exports.isNode = isNode;
 exports.isReactNative = isReactNative;
+exports.isReactNativeFile = isReactNativeFile;
 exports.isServer = isServer;
 exports.isWeb = isWeb;
 exports.listDir = listDir;

package/dist/index.mjs

@@ -6,6 +6,9 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // ../core/src/platform.ts
+function isReactNativeFile(file) {
+  return typeof file === "object" && file !== null && typeof file.uri === "string";
+}
 function detectPlatform() {
   if (typeof Deno !== "undefined") {
     return "deno";
@@ -657,11 +660,26 @@ var HttpClient = class {
   async uploadFile(path, file, filePath, options = {}) {
     const url = this.buildUrl(path);
     const formData = new FormData();
-    if (file instanceof File) {
+    const fallbackName = filePath.split("/").pop() || "file";
+    if (isReactNativeFile(file)) {
+      const part = {
+        uri: file.uri,
+        name: file.name || fallbackName,
+        type: file.type || options.contentType || "application/octet-stream"
+      };
+      formData.append("file", part);
+    } else if (typeof File !== "undefined" && file instanceof File) {
       formData.append("file", file);
-    } else if (file instanceof Blob) {
-      const blobWithType = options.contentType ? new Blob([file], { type: options.contentType }) : file;
-      formData.append("file", blobWithType);
+    } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+      if (isReactNative) {
+        formData.append("file", file, fallbackName);
+      } else {
+        const blobWithType = options.contentType ? new Blob([file], { type: options.contentType }) : file;
+        formData.append("file", blobWithType);
+      }
+    } else if (file instanceof ArrayBuffer) {
+      const blob = new Blob([new Uint8Array(file)], { type: options.contentType || "application/octet-stream" });
+      formData.append("file", blob);
     } else if (typeof Buffer !== "undefined" && file instanceof Buffer) {
       const blob = new Blob([new Uint8Array(file)], { type: options.contentType || "application/octet-stream" });
       formData.append("file", blob);
@@ -3569,12 +3587,13 @@ var BlinkStorageImpl = class {
   }
   /**
    * Upload a file to project storage
-   * 
-   * @param file - File, Blob, or Buffer to upload
+   *
+   * @param file - File, Blob, Buffer, ArrayBuffer, or a React Native file
+   *   descriptor (`{ uri, name?, type? }`) to upload
    * @param path - Destination path within project storage (extension will be auto-corrected to match file type)
    * @param options - Upload options including upsert and progress callback
    * @returns Promise resolving to upload response with public URL
-   * 
+   *
    * @example
    * ```ts
    * // Extension automatically corrected to match actual file type
@@ -3584,7 +3603,14 @@ var BlinkStorageImpl = class {
    *   { upsert: true }
    * );
    * // If file is PNG, final path will be: avatars/user123.png
-   * 
+   *
+   * // React Native / Expo: pass the picker/camera result's uri directly.
+   * // Do NOT wrap it in a Blob — that uploads a 0-byte file on RN.
+   * const { publicUrl } = await blink.storage.upload(
+   *   { uri: photo.uri, name: 'photo.jpg', type: 'image/jpeg' },
+   *   `corrections/${id}`
+   * );
+   *
    * // Or with extension (will be corrected if wrong)
    * const { publicUrl } = await blink.storage.upload(
    *   pngFile,
@@ -3604,8 +3630,12 @@ var BlinkStorageImpl = class {
       }
       const maxSize = 50 * 1024 * 1024;
       let fileSize = 0;
-      if (file instanceof File || file instanceof Blob) {
+      if (typeof File !== "undefined" && file instanceof File) {
         fileSize = file.size;
+      } else if (typeof Blob !== "undefined" && file instanceof Blob) {
+        fileSize = file.size;
+      } else if (file instanceof ArrayBuffer) {
+        fileSize = file.byteLength;
       } else if (typeof Buffer !== "undefined" && file instanceof Buffer) {
         fileSize = file.length;
       }
@@ -3657,29 +3687,30 @@ var BlinkStorageImpl = class {
    */
   async detectFileTypeAndCorrectPath(file, originalPath) {
     try {
-      const fileSignature = await this.getFileSignature(file);
-      const detectedType = this.detectFileTypeFromSignature(fileSignature);
-      let detectedContentType = detectedType.mimeType;
-      let detectedExtension = detectedType.extension;
-      if (!detectedContentType && file instanceof File && file.type) {
-        detectedContentType = file.type;
-        detectedExtension = this.getExtensionFromMimeType(file.type);
+      let detectedContentType = "";
+      let detectedExtension = "";
+      if (isReactNativeFile(file)) {
+        detectedContentType = file.type || "";
+        const mimeExt = detectedContentType ? this.getExtensionFromMimeType(detectedContentType) : "";
+        detectedExtension = (mimeExt && mimeExt !== "bin" ? mimeExt : "") || this.getExtensionFromName(file.name) || this.getExtensionFromName(file.uri) || this.getExtensionFromName(originalPath);
+      } else {
+        const fileSignature = await this.getFileSignature(file);
+        const detectedType = this.detectFileTypeFromSignature(fileSignature);
+        detectedContentType = detectedType.mimeType;
+        detectedExtension = detectedType.extension;
+        if (!detectedContentType && typeof File !== "undefined" && file instanceof File && file.type) {
+          detectedContentType = file.type;
+          detectedExtension = this.getExtensionFromMimeType(file.type);
+        }
       }
       if (!detectedContentType) {
         detectedContentType = "application/octet-stream";
-        detectedExtension = "bin";
       }
-      const pathParts = originalPath.split("/");
-      const fileName = pathParts[pathParts.length - 1];
-      const directory = pathParts.slice(0, -1).join("/");
-      if (!fileName) {
-        throw new Error("Invalid path: filename cannot be empty");
+      if (!detectedExtension) {
+        detectedExtension = "bin";
       }
-      const nameWithoutExt = fileName.includes(".") ? fileName.substring(0, fileName.lastIndexOf(".")) : fileName;
-      const correctedFileName = `${nameWithoutExt}.${detectedExtension}`;
-      const correctedPath = directory ? `${directory}/${correctedFileName}` : correctedFileName;
       return {
-        correctedPath,
+        correctedPath: this.rebuildPathWithExtension(originalPath, detectedExtension),
         detectedContentType
       };
     } catch (error) {
@@ -3689,15 +3720,45 @@ var BlinkStorageImpl = class {
       };
     }
   }
+  /**
+   * Replace (or append) the extension on the last path segment.
+   */
+  rebuildPathWithExtension(originalPath, extension) {
+    const pathParts = originalPath.split("/");
+    const fileName = pathParts[pathParts.length - 1];
+    const directory = pathParts.slice(0, -1).join("/");
+    if (!fileName) {
+      throw new Error("Invalid path: filename cannot be empty");
+    }
+    const nameWithoutExt = fileName.includes(".") ? fileName.substring(0, fileName.lastIndexOf(".")) : fileName;
+    const correctedFileName = `${nameWithoutExt}.${extension}`;
+    return directory ? `${directory}/${correctedFileName}` : correctedFileName;
+  }
+  /**
+   * Pull a lowercase extension out of a filename, path, or uri (no dot, '' if
+   * none). Strips any query/fragment (RN content:// uris carry them) and only
+   * accepts a sane extension so junk never leaks into the storage path.
+   */
+  getExtensionFromName(name) {
+    if (!name) return "";
+    const base = (name.split(/[?#]/)[0] || "").split("/").pop() || "";
+    const dot = base.lastIndexOf(".");
+    if (dot <= 0) return "";
+    const ext = base.substring(dot + 1).toLowerCase();
+    return /^[a-z0-9]{1,8}$/.test(ext) ? ext : "";
+  }
   /**
    * Get the first few bytes of a file to analyze its signature
    */
   async getFileSignature(file) {
     const bytesToRead = 12;
+    if (file instanceof ArrayBuffer) {
+      return new Uint8Array(file.slice(0, bytesToRead));
+    }
     if (typeof Buffer !== "undefined" && file instanceof Buffer) {
       return new Uint8Array(file.slice(0, bytesToRead));
     }
-    if (file instanceof File || file instanceof Blob) {
+    if (typeof File !== "undefined" && file instanceof File || typeof Blob !== "undefined" && file instanceof Blob) {
       const slice = file.slice(0, bytesToRead);
       const arrayBuffer = await slice.arrayBuffer();
       return new Uint8Array(arrayBuffer);
@@ -5197,6 +5258,9 @@ var BlinkAIImpl = class {
    * ```
    */
   createAgent(options) {
+    if (!options) {
+      throw new BlinkAIError("createAgent(options) requires an options object with at least a `model`.");
+    }
     const agent = new Agent(options);
     agent._setHttpClient(this.httpClient);
     return agent;
@@ -5211,6 +5275,11 @@ var BlinkAIImpl = class {
    * @returns The same Agent instance (with httpClient set)
    */
   bindAgent(agent) {
+    if (!agent) {
+      throw new BlinkAIError(
+        "bindAgent(agent) requires an Agent instance but received null/undefined. Create one first with `new Agent({...})` or `blink.ai.createAgent({...})`. (The useAgent() hook stays idle while its `agent` is null, so this only fires on a direct bindAgent() call with a missing agent.)"
+      );
+    }
     agent._setHttpClient(this.httpClient);
     return agent;
   }
@@ -7056,6 +7125,6 @@ function createClient(config) {
   return client;
 }
 
-export { Agent, AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkConnectorsImpl, BlinkDataImpl, BlinkDatabase, BlinkQueueCreditError, BlinkQueueImpl, BlinkRAGImpl, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkSandboxImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, SANDBOX_TEMPLATES, SandboxConnectionError, WebStorageAdapter, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
+export { Agent, AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkConnectorsImpl, BlinkDataImpl, BlinkDatabase, BlinkQueueCreditError, BlinkQueueImpl, BlinkRAGImpl, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkSandboxImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, SANDBOX_TEMPLATES, SandboxConnectionError, WebStorageAdapter, coreTools, createClient, dbDelete, dbGet, dbInsert, dbList, dbTools, dbUpdate, editImage, fetchUrl, generateImage, generateVideo, getDefaultClient, getDefaultStorageAdapter, getHost, globFileSearch, grep, imageToVideo, isBrowser, isDeno, isNode, isReactNative, isReactNativeFile, isServer, isWeb, listDir, mediaTools, platform, ragSearch, ragTools, readFile, runCode, runTerminalCmd, sandboxTools, searchReplace, serializeTools, stepCountIs, storageCopy, storageDelete, storageDownload, storageList, storageMove, storagePublicUrl, storageTools, storageUpload, webSearch, writeFile };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",