@opendatalabs/vana-sdk 0.1.0-alpha.7e4db82 → 0.1.0-alpha.7ee7635

package/dist/storage/providers/callback-storage.js

@@ -0,0 +1,155 @@
+import {
+  StorageError
+} from "../../types/storage";
+class CallbackStorage {
+  constructor(callbacks) {
+    this.callbacks = callbacks;
+    if (!callbacks.upload || !callbacks.download) {
+      throw new Error(
+        "CallbackStorage requires both upload and download callbacks"
+      );
+    }
+  }
+  /**
+   * Upload a file using the provided callback
+   *
+   * @param file - The blob to upload
+   * @param filename - Optional filename for the upload
+   * @returns The upload result with URL and metadata
+   */
+  async upload(file, filename) {
+    try {
+      const result = await this.callbacks.upload(file, filename);
+      if (!result.url || result.url.trim() === "") {
+        throw new StorageError(
+          "Upload callback returned invalid result: missing or empty url",
+          "INVALID_UPLOAD_RESULT",
+          "callback-storage"
+        );
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof StorageError) {
+        throw error;
+      }
+      throw new StorageError(
+        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,
+        "UPLOAD_ERROR",
+        "callback-storage",
+        { cause: error instanceof Error ? error : void 0 }
+      );
+    }
+  }
+  /**
+   * Download a file using the provided callback
+   *
+   * @param url - The URL or identifier to download
+   * @returns The downloaded blob
+   */
+  async download(url) {
+    try {
+      const identifier = this.callbacks.extractIdentifier ? this.callbacks.extractIdentifier(url) : url;
+      const blob = await this.callbacks.download(identifier);
+      if (!(blob instanceof Blob)) {
+        throw new StorageError(
+          "Download callback returned invalid result: expected Blob",
+          "INVALID_DOWNLOAD_RESULT",
+          "callback-storage"
+        );
+      }
+      return blob;
+    } catch (error) {
+      if (error instanceof StorageError) {
+        throw error;
+      }
+      throw new StorageError(
+        `Download failed: ${error instanceof Error ? error.message : String(error)}`,
+        "DOWNLOAD_ERROR",
+        "callback-storage",
+        { cause: error instanceof Error ? error : void 0 }
+      );
+    }
+  }
+  /**
+   * List files using the provided callback (if available)
+   *
+   * @param options - Optional list options including filters and pagination
+   * @returns Array of storage files
+   */
+  async list(options) {
+    if (!this.callbacks.list) {
+      throw new StorageError(
+        "List operation not supported - no list callback provided",
+        "NOT_SUPPORTED",
+        "callback-storage"
+      );
+    }
+    try {
+      const result = await this.callbacks.list(options?.namePattern, options);
+      return result.items.map((item, index) => ({
+        id: item.identifier,
+        name: item.identifier.split("/").pop() || `file-${index}`,
+        url: item.identifier,
+        size: item.size || 0,
+        contentType: "application/octet-stream",
+        createdAt: item.lastModified || /* @__PURE__ */ new Date(),
+        metadata: item.metadata
+      }));
+    } catch (error) {
+      throw new StorageError(
+        `List failed: ${error instanceof Error ? error.message : String(error)}`,
+        "LIST_ERROR",
+        "callback-storage",
+        { cause: error instanceof Error ? error : void 0 }
+      );
+    }
+  }
+  /**
+   * Delete a file using the provided callback (if available)
+   *
+   * @param url - The URL or identifier to delete
+   * @returns True if deletion succeeded
+   */
+  async delete(url) {
+    if (!this.callbacks.delete) {
+      throw new StorageError(
+        "Delete operation not supported - no delete callback provided",
+        "NOT_SUPPORTED",
+        "callback-storage"
+      );
+    }
+    try {
+      const identifier = this.callbacks.extractIdentifier ? this.callbacks.extractIdentifier(url) : url;
+      return await this.callbacks.delete(identifier);
+    } catch (error) {
+      throw new StorageError(
+        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,
+        "DELETE_ERROR",
+        "callback-storage",
+        { cause: error instanceof Error ? error : void 0 }
+      );
+    }
+  }
+  /**
+   * Get provider configuration
+   *
+   * @returns Provider configuration metadata
+   */
+  getConfig() {
+    return {
+      name: "callback-storage",
+      type: "callback",
+      requiresAuth: false,
+      features: {
+        upload: true,
+        download: true,
+        list: !!this.callbacks.list,
+        delete: !!this.callbacks.delete
+      }
+    };
+  }
+}
+export {
+  CallbackStorage
+};
+//# sourceMappingURL=callback-storage.js.map

package/dist/storage/providers/callback-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/storage/providers/callback-storage.ts"],"sourcesContent":["import type { StorageProvider } from \"../../types/storage\";\nimport type { StorageCallbacks } from \"../../types/config\";\nimport {\n  StorageError,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../../types/storage\";\n\n/**\n * Storage provider that delegates all operations to user-provided callbacks.\n *\n * This provider follows the same flexible pattern as relayer callbacks,\n * allowing users to implement storage operations in any way they choose\n * (HTTP, WebSocket, direct cloud APIs, local filesystem, etc.).\n *\n * @category Storage\n * @example\n * ```typescript\n * // HTTP-based implementation\n * const httpCallbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const formData = new FormData();\n *     formData.append('file', blob, filename);\n *     const response = await fetch('/api/storage/upload', {\n *       method: 'POST',\n *       body: formData\n *     });\n *     const data = await response.json();\n *     return {\n *       url: data.url,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const response = await fetch(`/api/storage/download/${identifier}`);\n *     return response.blob();\n *   }\n * };\n *\n * const storage = new CallbackStorage(httpCallbacks);\n *\n * // Direct S3 implementation\n * const s3Callbacks: StorageCallbacks = {\n *   async upload(blob, filename) {\n *     const url = await getPresignedUploadUrl(filename);\n *     await fetch(url, { method: 'PUT', body: blob });\n *     return {\n *       url: `s3://my-bucket/${filename}`,\n *       size: blob.size,\n *       contentType: blob.type\n *     };\n *   },\n *   async download(identifier) {\n *     const url = await getPresignedDownloadUrl(identifier);\n *     const response = await fetch(url);\n *     return response.blob();\n *   }\n * };\n * ```\n */\nexport class CallbackStorage implements StorageProvider {\n  constructor(private readonly callbacks: StorageCallbacks) {\n    if (!callbacks.upload || !callbacks.download) {\n      throw new Error(\n        \"CallbackStorage requires both upload and download callbacks\",\n      );\n    }\n  }\n\n  /**\n   * Upload a file using the provided callback\n   *\n   * @param file - The blob to upload\n   * @param filename - Optional filename for the upload\n   * @returns The upload result with URL and metadata\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const result = await this.callbacks.upload(file, filename);\n\n      // Validate the result has required fields\n      if (!result.url || result.url.trim() === \"\") {\n        throw new StorageError(\n          \"Upload callback returned invalid result: missing or empty url\",\n          \"INVALID_UPLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Upload failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"UPLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Download a file using the provided callback\n   *\n   * @param url - The URL or identifier to download\n   * @returns The downloaded blob\n   */\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      const blob = await this.callbacks.download(identifier);\n\n      if (!(blob instanceof Blob)) {\n        throw new StorageError(\n          \"Download callback returned invalid result: expected Blob\",\n          \"INVALID_DOWNLOAD_RESULT\",\n          \"callback-storage\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Download failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DOWNLOAD_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * List files using the provided callback (if available)\n   *\n   * @param options - Optional list options including filters and pagination\n   * @returns Array of storage files\n   */\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.callbacks.list) {\n      throw new StorageError(\n        \"List operation not supported - no list callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      const result = await this.callbacks.list(options?.namePattern, options);\n\n      // Convert list result to StorageFile format\n      return result.items.map((item, index) => ({\n        id: item.identifier,\n        name: item.identifier.split(\"/\").pop() || `file-${index}`,\n        url: item.identifier,\n        size: item.size || 0,\n        contentType: \"application/octet-stream\",\n        createdAt: item.lastModified || new Date(),\n        metadata: item.metadata,\n      }));\n    } catch (error) {\n      throw new StorageError(\n        `List failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"LIST_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Delete a file using the provided callback (if available)\n   *\n   * @param url - The URL or identifier to delete\n   * @returns True if deletion succeeded\n   */\n  async delete(url: string): Promise<boolean> {\n    if (!this.callbacks.delete) {\n      throw new StorageError(\n        \"Delete operation not supported - no delete callback provided\",\n        \"NOT_SUPPORTED\",\n        \"callback-storage\",\n      );\n    }\n\n    try {\n      // Extract identifier if callback is provided, otherwise use URL as-is\n      const identifier = this.callbacks.extractIdentifier\n        ? this.callbacks.extractIdentifier(url)\n        : url;\n\n      return await this.callbacks.delete(identifier);\n    } catch (error) {\n      throw new StorageError(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`,\n        \"DELETE_ERROR\",\n        \"callback-storage\",\n        { cause: error instanceof Error ? error : undefined },\n      );\n    }\n  }\n\n  /**\n   * Get provider configuration\n   *\n   * @returns Provider configuration metadata\n   */\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"callback-storage\",\n      type: \"callback\",\n      requiresAuth: false,\n      features: {\n        upload: true,\n        download: true,\n        list: !!this.callbacks.list,\n        delete: !!this.callbacks.delete,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/google-drive.cjs

@@ -0,0 +1,516 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var google_drive_exports = {};
+__export(google_drive_exports, {
+  GoogleDriveStorage: () => GoogleDriveStorage
+});
+module.exports = __toCommonJS(google_drive_exports);
+var import__ = require("../index");
+class GoogleDriveStorage {
+  constructor(config) {
+    this.config = config;
+    if (!config.accessToken) {
+      throw new import__.StorageError(
+        "Google Drive access token is required",
+        "MISSING_ACCESS_TOKEN",
+        "google-drive"
+      );
+    }
+  }
+  baseUrl = "https://www.googleapis.com/drive/v3";
+  uploadUrl = "https://www.googleapis.com/upload/drive/v3";
+  async upload(file, filename) {
+    try {
+      const fileName = filename || `vana-file-${Date.now()}.dat`;
+      const metadata = {
+        name: fileName,
+        parents: this.config.folderId ? [this.config.folderId] : void 0
+      };
+      const delimiter = "-------314159265358979323846";
+      const closeDelim = `\r
+--${delimiter}--`;
+      const metadataBlob = new Blob([JSON.stringify(metadata)], {
+        type: "application/json"
+      });
+      const multipartRequestBody = [
+        `--${delimiter}`,
+        "Content-Type: application/json",
+        "",
+        await metadataBlob.text(),
+        `--${delimiter}`,
+        `Content-Type: ${file.type || "application/octet-stream"}`,
+        "",
+        ""
+      ].join("\r\n");
+      const requestBody = new Blob([multipartRequestBody, file, closeDelim]);
+      const response = await fetch(
+        `${this.uploadUrl}/files?uploadType=multipart`,
+        {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.config.accessToken}`,
+            "Content-Type": `multipart/related; boundary="${delimiter}"`
+          },
+          body: requestBody
+        }
+      );
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to upload to Google Drive: ${error}`,
+          "UPLOAD_FAILED",
+          "google-drive"
+        );
+      }
+      const result = await response.json();
+      await this.makeFilePublic(result.id);
+      return {
+        url: `https://drive.google.com/uc?id=${result.id}&export=download`,
+        size: file.size,
+        contentType: file.type || "application/octet-stream",
+        metadata: {
+          id: result.id,
+          name: result.name,
+          driveUrl: `https://drive.google.com/file/d/${result.id}/view`
+        }
+      };
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive upload error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "UPLOAD_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  async download(url) {
+    try {
+      const fileId = this.extractFileId(url);
+      if (!fileId) {
+        throw new import__.StorageError(
+          "Invalid Google Drive URL format",
+          "INVALID_URL",
+          "google-drive"
+        );
+      }
+      const response = await fetch(
+        `${this.baseUrl}/files/${fileId}?alt=media`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.config.accessToken}`
+          }
+        }
+      );
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to download from Google Drive: ${error}`,
+          "DOWNLOAD_FAILED",
+          "google-drive"
+        );
+      }
+      const blob = await response.blob();
+      if (blob.type === "text/html") {
+        throw new import__.StorageError(
+          "Received HTML content instead of file data. This suggests an authentication or URL formatting issue with Google Drive.",
+          "AUTHENTICATION_ERROR",
+          "google-drive"
+        );
+      }
+      return blob;
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive download error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "DOWNLOAD_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  async list(options) {
+    try {
+      let query = "trashed = false";
+      if (this.config.folderId) {
+        query += ` and '${this.config.folderId}' in parents`;
+      }
+      if (options?.namePattern) {
+        query += ` and name contains '${options.namePattern}'`;
+      }
+      const params = new URLSearchParams({
+        q: query,
+        fields: "files(id,name,size,mimeType,createdTime,webViewLink)",
+        pageSize: (options?.limit || 100).toString()
+      });
+      if (options?.offset && typeof options.offset === "string") {
+        params.set("pageToken", options.offset);
+      }
+      const response = await fetch(`${this.baseUrl}/files?${params}`, {
+        headers: {
+          Authorization: `Bearer ${this.config.accessToken}`
+        }
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to list Google Drive files: ${error}`,
+          "LIST_FAILED",
+          "google-drive"
+        );
+      }
+      const result = await response.json();
+      return result.files.map((file) => ({
+        id: file.id,
+        name: file.name,
+        url: `https://drive.google.com/uc?id=${file.id}&export=download`,
+        size: parseInt(file.size) || 0,
+        contentType: file.mimeType,
+        createdAt: new Date(file.createdTime),
+        metadata: {
+          id: file.id,
+          driveUrl: file.webViewLink
+        }
+      }));
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive list error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "LIST_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  async delete(url) {
+    try {
+      const fileId = this.extractFileId(url);
+      if (!fileId) {
+        throw new import__.StorageError(
+          "Invalid Google Drive URL format",
+          "INVALID_URL",
+          "google-drive"
+        );
+      }
+      const response = await fetch(`${this.baseUrl}/files/${fileId}`, {
+        method: "DELETE",
+        headers: {
+          Authorization: `Bearer ${this.config.accessToken}`
+        }
+      });
+      if (!response.ok && response.status !== 404) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to delete from Google Drive: ${error}`,
+          "DELETE_FAILED",
+          "google-drive"
+        );
+      }
+      return true;
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive delete error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "DELETE_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  getConfig() {
+    return {
+      name: "Google Drive",
+      type: "google-drive",
+      requiresAuth: true,
+      features: {
+        upload: true,
+        download: true,
+        list: true,
+        delete: true
+      }
+    };
+  }
+  /**
+   * Make a Google Drive file publicly readable
+   *
+   * @param fileId - Google Drive file ID
+   */
+  async makeFilePublic(fileId) {
+    try {
+      await fetch(`${this.baseUrl}/files/${fileId}/permissions`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.accessToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          role: "reader",
+          type: "anyone"
+        })
+      });
+    } catch (error) {
+      console.warn("Failed to make Google Drive file public:", error);
+    }
+  }
+  /**
+   * Extract file ID from various Google Drive URL formats
+   *
+   * @param url - Google Drive URL
+   * @returns File ID or null if not found
+   */
+  extractFileId(url) {
+    const patterns = [
+      /\/file\/d\/([a-zA-Z0-9-_]+)/,
+      // https://drive.google.com/file/d/FILE_ID/view
+      /id=([a-zA-Z0-9-_]+)/,
+      // https://drive.google.com/uc?id=FILE_ID
+      /^([a-zA-Z0-9-_]+)$/
+      // Just the file ID
+    ];
+    for (const pattern of patterns) {
+      const match = url.match(pattern);
+      if (match) {
+        return match[1];
+      }
+    }
+    return null;
+  }
+  /**
+   * Searches for an existing folder by name within a specified parent folder
+   *
+   * @remarks
+   * This method queries the Google Drive API to find a folder with the exact name
+   * within the specified parent directory. Only searches for folders (not files)
+   * and excludes trashed items.
+   *
+   * @param name - The exact name of the folder to search for
+   * @param parentId - The ID of the parent folder to search within (defaults to 'root')
+   * @returns Promise that resolves to the folder ID if found, or `null` if not found
+   * @throws {StorageError} When the Google Drive API request fails
+   *
+   * @example
+   * ```typescript
+   * // Search for a folder in the root directory
+   * const folderId = await googleDriveStorage.findFolder("screenshots");
+   * if (folderId) {
+   *   console.log("Found folder:", folderId);
+   * } else {
+   *   console.log("Folder not found");
+   * }
+   *
+   * // Search for a subfolder within another folder
+   * const subFolderId = await googleDriveStorage.findFolder("roasts", parentFolderId);
+   * ```
+   */
+  async findFolder(name, parentId = "root") {
+    try {
+      const query = `name='${name}' and '${parentId}' in parents and mimeType='application/vnd.google-apps.folder' and trashed = false`;
+      const params = new URLSearchParams({
+        q: query,
+        fields: "files(id,name,mimeType)"
+      });
+      const response = await fetch(`${this.baseUrl}/files?${params}`, {
+        headers: {
+          Authorization: `Bearer ${this.config.accessToken}`
+        }
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to search Google Drive folders: ${error}`,
+          "FIND_FOLDER_FAILED",
+          "google-drive"
+        );
+      }
+      const result = await response.json();
+      if (result.files && result.files.length > 0) {
+        return result.files[0].id;
+      }
+      return null;
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive findFolder error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "FIND_FOLDER_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  /**
+   * Creates a new folder within a specified parent folder
+   *
+   * @remarks
+   * This method creates a new folder using the Google Drive API. The folder will be
+   * created with the specified name as a child of the parent folder. Requires the
+   * `https://www.googleapis.com/auth/drive.file` OAuth scope.
+   *
+   * @param name - The name for the new folder
+   * @param parentId - The ID of the parent folder where the new folder will be created (defaults to 'root')
+   * @returns Promise that resolves to the ID of the newly created folder
+   * @throws {StorageError} When the Google Drive API request fails or folder creation is denied
+   *
+   * @example
+   * ```typescript
+   * // Create a folder in the root directory
+   * const folderId = await googleDriveStorage.createFolder("my-documents");
+   * console.log("Created folder:", folderId);
+   *
+   * // Create a subfolder within another folder
+   * const subFolderId = await googleDriveStorage.createFolder("reports", parentFolderId);
+   * ```
+   */
+  async createFolder(name, parentId = "root") {
+    try {
+      const metadata = {
+        name,
+        mimeType: "application/vnd.google-apps.folder",
+        parents: [parentId]
+      };
+      const response = await fetch(`${this.baseUrl}/files`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.config.accessToken}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(metadata)
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to create Google Drive folder: ${error}`,
+          "CREATE_FOLDER_FAILED",
+          "google-drive"
+        );
+      }
+      const result = await response.json();
+      return result.id;
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive createFolder error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "CREATE_FOLDER_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  /**
+   * Finds an existing folder by name, or creates it if it doesn't exist
+   *
+   * @remarks
+   * This is a convenience method that combines `findFolder` and `createFolder`.
+   * It first searches for an existing folder with the specified name. If found,
+   * it returns the existing folder's ID. If not found, it creates a new folder
+   * and returns the new folder's ID.
+   *
+   * @param name - The name of the folder to find or create
+   * @param parentId - The ID of the parent folder to search within or create the folder in (defaults to 'root')
+   * @returns Promise that resolves to the folder ID (either existing or newly created)
+   * @throws {StorageError} When the Google Drive API request fails
+   *
+   * @example
+   * ```typescript
+   * // Ensure a folder exists, creating it if necessary
+   * const folderId = await googleDriveStorage.findOrCreateFolder("screenshots");
+   * console.log("Folder ID:", folderId); // Will be same ID if folder already existed
+   *
+   * // Create nested folder structure
+   * const parentId = await googleDriveStorage.findOrCreateFolder("projects");
+   * const childId = await googleDriveStorage.findOrCreateFolder("vana-app", parentId);
+   * ```
+   */
+  async findOrCreateFolder(name, parentId = "root") {
+    try {
+      const existingFolderId = await this.findFolder(name, parentId);
+      if (existingFolderId) {
+        return existingFolderId;
+      }
+      return await this.createFolder(name, parentId);
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive findOrCreateFolder error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "FIND_OR_CREATE_FOLDER_ERROR",
+        "google-drive"
+      );
+    }
+  }
+  /**
+   * Refresh the access token using refresh token
+   *
+   * @returns Promise with new access token
+   */
+  async refreshAccessToken() {
+    if (!this.config.refreshToken || !this.config.clientId || !this.config.clientSecret) {
+      throw new import__.StorageError(
+        "Refresh token, client ID, and client secret are required for token refresh",
+        "MISSING_REFRESH_CONFIG",
+        "google-drive"
+      );
+    }
+    try {
+      const response = await fetch("https://oauth2.googleapis.com/token", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: new URLSearchParams({
+          client_id: this.config.clientId,
+          client_secret: this.config.clientSecret,
+          refresh_token: this.config.refreshToken,
+          grant_type: "refresh_token"
+        })
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new import__.StorageError(
+          `Failed to refresh Google Drive token: ${error}`,
+          "TOKEN_REFRESH_FAILED",
+          "google-drive"
+        );
+      }
+      const result = await response.json();
+      this.config.accessToken = result.access_token;
+      return result.access_token;
+    } catch (error) {
+      if (error instanceof import__.StorageError) {
+        throw error;
+      }
+      throw new import__.StorageError(
+        `Google Drive token refresh error: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "TOKEN_REFRESH_ERROR",
+        "google-drive"
+      );
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GoogleDriveStorage
+});
+//# sourceMappingURL=google-drive.cjs.map