refactor: update uploadFile method to accept both file paths and Buffers

.changeset/dry-dodos-push.md

@@ -0,0 +1,5 @@
+---
+"@google/generative-ai": patch
+---
+
+the code was refactored to accept both file paths and Buffers as inputs for uploading files with metadata

common/api-review/generative-ai-server.api.md

@@ -4,6 +4,8 @@
 
 ```ts
 
+/// <reference types="node" />
+
 // @public
 export interface CachedContent extends CachedContentBase {
     createTime?: string;
@@ -357,7 +359,7 @@ export class GoogleAIFileManager {
     deleteFile(fileId: string): Promise<void>;
     getFile(fileId: string): Promise<FileMetadataResponse>;
     listFiles(listParams?: ListParams): Promise<ListFilesResponse>;
-    uploadFile(filePath: string, fileMetadata: FileMetadata): Promise<UploadFileResponse>;
+    uploadFile(fileInput: string | Buffer, fileMetadata: FileMetadata): Promise<UploadFileResponse>;
 }
 
 // @public

docs/reference/server/generative-ai.googleaifilemanager.md

@@ -31,5 +31,5 @@ export declare class GoogleAIFileManager
 |  [deleteFile(fileId)](./generative-ai.googleaifilemanager.deletefile.md) |  | Delete file with given ID |
 |  [getFile(fileId)](./generative-ai.googleaifilemanager.getfile.md) |  | Get metadata for file with given ID |
 |  [listFiles(listParams)](./generative-ai.googleaifilemanager.listfiles.md) |  | List all uploaded files |
-|  [uploadFile(filePath, fileMetadata)](./generative-ai.googleaifilemanager.uploadfile.md) |  | Upload a file |
+|  [uploadFile(fileInput, fileMetadata)](./generative-ai.googleaifilemanager.uploadfile.md) |  | Upload a file |
 

docs/reference/server/generative-ai.googleaifilemanager.uploadfile.md

@@ -9,14 +9,14 @@ Upload a file
 **Signature:**
 
 ```typescript
-uploadFile(filePath: string, fileMetadata: FileMetadata): Promise<UploadFileResponse>;
+uploadFile(fileInput: string | Buffer, fileMetadata: FileMetadata): Promise<UploadFileResponse>;
 ```
 
 ## Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
-|  filePath | string |  |
+|  fileInput | string \| Buffer |  |
 |  fileMetadata | [FileMetadata](./generative-ai.filemetadata.md) |  |
 
 **Returns:**

packages/main/src/server/file-manager.ts

@@ -16,7 +16,7 @@
  */
 
 import { RequestOptions } from "../../types";
-import { readFileSync } from "fs";
+import { readFile } from "fs/promises";
 import { FilesRequestUrl, getHeaders, makeServerRequest } from "./request";
 import {
   FileMetadata,
@@ -51,10 +51,18 @@ export class GoogleAIFileManager {
    * Upload a file
    */
   async uploadFile(
-    filePath: string,
+    fileInput: string | Buffer,
     fileMetadata: FileMetadata,
   ): Promise<UploadFileResponse> {
-    const file = readFileSync(filePath);
+    let file: Buffer | string;
+
+    if (typeof fileInput === "string") {
+      file = await readFile(fileInput);
+    } else if (Buffer.isBuffer(fileInput)) {
+      file = fileInput;
+    } else {
+      throw Error("fileInput must be filePath or buffer");
+    }
     const url = new FilesRequestUrl(
       RpcTask.UPLOAD,
       this.apiKey,