@opendatalabs/vana-sdk 2.2.3 → 3.0.0

package/dist/storage/providers/dropbox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/dropbox.ts"],"sourcesContent":["/**\n * Dropbox Storage Provider for Vana SDK\n *\n * Implements the storage interface for Dropbox using its API.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface DropboxConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Root path for uploads (defaults to '/Vana Data') */\n  rootPath?: string;\n}\n\ninterface DropboxUploadResponse {\n  name: string;\n  path_lower: string;\n  path_display: string;\n  id: string;\n  size: number;\n}\n\ninterface DropboxSharedLinkResponse {\n  url: string;\n}\n\ninterface DropboxListResponse {\n  entries: Array<{\n    \".tag\": \"file\" | \"folder\";\n    name: string;\n    path_lower: string;\n    id: string;\n    server_modified: string;\n    size: number;\n  }>;\n  has_more: boolean;\n  cursor: string;\n}\n\n/**\n * Dropbox Storage Provider\n *\n * @remarks\n * Implements the storage interface for Dropbox. Requires OAuth2 authentication.\n *\n * @category Storage\n */\nexport class DropboxStorage implements StorageProvider {\n  private readonly apiUrl = \"https://api.dropboxapi.com/2\";\n  private readonly contentUrl = \"https://content.dropboxapi.com/2\";\n  private readonly rootPath: string;\n\n  constructor(private config: DropboxConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Dropbox access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"dropbox\",\n      );\n    }\n    this.rootPath = config.rootPath ?? \"/Vana Data\";\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n      const path = `${this.rootPath}/${fileName}`;\n\n      const response = await fetch(`${this.contentUrl}/files/upload`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/octet-stream\",\n          \"Dropbox-API-Arg\": JSON.stringify({\n            path,\n            mode: \"add\",\n            autorename: true,\n            mute: false,\n          }),\n        },\n        body: file,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Dropbox: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxUploadResponse;\n      const sharedLinkUrl = await this.createSharedLink(result.path_lower);\n\n      // Convert the shareable URL to a direct download URL before returning.\n      // This ensures the correct, raw-content URL is stored on-chain.\n      const directDownloadUrl = sharedLinkUrl\n        .replace(\"www.dropbox.com\", \"dl.dropboxusercontent.com\")\n        .replace(\"?dl=1\", \"\");\n\n      return {\n        url: directDownloadUrl,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          path: result.path_display,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    // URL to force a direct download instead of showing the preview page.\n    // This is done by changing the hostname from 'www.dropbox.com' to 'dl.dropboxusercontent.com'.\n    const downloadUrl = url.replace(\n      \"www.dropbox.com\",\n      \"dl.dropboxusercontent.com\",\n    );\n    try {\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from Dropbox: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n      return response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.config.accessToken) {\n      throw new StorageError(\n        \"Access token not provided\",\n        \"AUTH_ERROR\",\n        \"dropbox\",\n      );\n    }\n\n    try {\n      const response = await fetch(`${this.apiUrl}/files/list_folder`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path: this.rootPath,\n          limit: options?.limit ?? 100,\n          include_deleted: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to list Dropbox files: ${await response.text()}`,\n          \"LIST_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxListResponse;\n\n      return result.entries\n        .filter((entry) => entry[\".tag\"] === \"file\")\n        .map((file) => ({\n          id: file.id,\n          name: file.name,\n          url: `dropbox://${file.path_lower}`, // Placeholder URL\n          size: file.size,\n          contentType: \"application/octet-stream\", // Dropbox API doesn't provide this in list\n          createdAt: new Date(file.server_modified),\n        }));\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      const path = new URL(url).pathname; // Assuming a direct URL format that includes the path\n      const response = await fetch(`${this.apiUrl}/files/delete_v2`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ path }),\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Dropbox: ${error}`,\n          \"DELETE_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Dropbox\",\n      type: \"dropbox\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  private async createSharedLink(path: string): Promise<string> {\n    const response = await fetch(\n      `${this.apiUrl}/sharing/create_shared_link_with_settings`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path,\n          settings: {\n            requested_visibility: \"public\",\n          },\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json();\n      // If link already exists, Dropbox returns a 409 with the existing link\n      if (\n        response.status === 409 &&\n        errorData.error?.shared_link_already_exists\n      ) {\n        return errorData.error.shared_link_already_exists.metadata.url;\n      }\n      throw new StorageError(\n        `Failed to create shared link: ${JSON.stringify(errorData)}`,\n        \"LINK_CREATION_FAILED\",\n        \"dropbox\",\n      );\n    }\n\n    const result = (await response.json()) as DropboxSharedLinkResponse;\n    // Modify URL for direct download\n    return result.url.replace(\"?dl=0\", \"?dl=1\");\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/dropbox.ts"],"sourcesContent":["/**\n * Dropbox Storage Provider for Vana SDK\n *\n * Implements the storage interface for Dropbox using its API.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface DropboxConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Root path for uploads (defaults to '/Vana Data') */\n  rootPath?: string;\n}\n\ninterface DropboxUploadResponse {\n  name: string;\n  path_lower: string;\n  path_display: string;\n  id: string;\n  size: number;\n}\n\ninterface DropboxSharedLinkResponse {\n  url: string;\n}\n\ninterface DropboxListResponse {\n  entries: Array<{\n    \".tag\": \"file\" | \"folder\";\n    name: string;\n    path_lower: string;\n    id: string;\n    server_modified: string;\n    size: number;\n  }>;\n  has_more: boolean;\n  cursor: string;\n}\n\n/**\n * Dropbox Storage Provider\n *\n * @remarks\n * Implements the storage interface for Dropbox. Requires OAuth2 authentication.\n *\n * @category Storage\n */\nexport class DropboxStorage implements StorageProvider {\n  private readonly apiUrl = \"https://api.dropboxapi.com/2\";\n  private readonly contentUrl = \"https://content.dropboxapi.com/2\";\n  private readonly rootPath: string;\n\n  constructor(private config: DropboxConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Dropbox access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"dropbox\",\n      );\n    }\n    this.rootPath = config.rootPath ?? \"/Vana Data\";\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n      const path = `${this.rootPath}/${fileName}`;\n\n      const response = await fetch(`${this.contentUrl}/files/upload`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/octet-stream\",\n          \"Dropbox-API-Arg\": JSON.stringify({\n            path,\n            mode: \"add\",\n            autorename: true,\n            mute: false,\n          }),\n        },\n        body: file,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Dropbox: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxUploadResponse;\n      const sharedLinkUrl = await this.createSharedLink(result.path_lower);\n\n      // Convert the shareable URL to a direct download URL before returning.\n      // This ensures the correct, raw-content URL is stored on-chain.\n      const directDownloadUrl = sharedLinkUrl\n        .replace(\"www.dropbox.com\", \"dl.dropboxusercontent.com\")\n        .replace(\"?dl=1\", \"\");\n\n      return {\n        url: directDownloadUrl,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          path: result.path_display,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    // URL to force a direct download instead of showing the preview page.\n    // This is done by changing the hostname from 'www.dropbox.com' to 'dl.dropboxusercontent.com'.\n    const downloadUrl = url.replace(\n      \"www.dropbox.com\",\n      \"dl.dropboxusercontent.com\",\n    );\n    try {\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from Dropbox: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"dropbox\",\n        );\n      }\n      return response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    if (!this.config.accessToken) {\n      throw new StorageError(\n        \"Access token not provided\",\n        \"AUTH_ERROR\",\n        \"dropbox\",\n      );\n    }\n\n    try {\n      const response = await fetch(`${this.apiUrl}/files/list_folder`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path: this.rootPath,\n          limit: options?.limit ?? 100,\n          include_deleted: false,\n        }),\n      });\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to list Dropbox files: ${await response.text()}`,\n          \"LIST_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      const result = (await response.json()) as DropboxListResponse;\n\n      return result.entries\n        .filter((entry) => entry[\".tag\"] === \"file\")\n        .map((file) => ({\n          id: file.id,\n          name: file.name,\n          url: `dropbox://${file.path_lower}`, // Placeholder URL\n          size: file.size,\n          contentType: \"application/octet-stream\", // Dropbox API doesn't provide this in list\n          createdAt: new Date(file.server_modified),\n        }));\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      const path = new URL(url).pathname; // Assuming a direct URL format that includes the path\n      const response = await fetch(`${this.apiUrl}/files/delete_v2`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({ path }),\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Dropbox: ${error}`,\n          \"DELETE_FAILED\",\n          \"dropbox\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) throw error;\n      throw new StorageError(\n        `Dropbox delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"dropbox\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Dropbox\",\n      type: \"dropbox\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  private async createSharedLink(path: string): Promise<string> {\n    const response = await fetch(\n      `${this.apiUrl}/sharing/create_shared_link_with_settings`,\n      {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          path,\n          settings: {\n            requested_visibility: \"public\",\n          },\n        }),\n      },\n    );\n\n    if (!response.ok) {\n      const errorData = await response.json();\n      // If link already exists, Dropbox returns a 409 with the existing link\n      if (\n        response.status === 409 &&\n        errorData.error?.shared_link_already_exists\n      ) {\n        return errorData.error.shared_link_already_exists.metadata.url;\n      }\n      throw new StorageError(\n        `Failed to create shared link: ${JSON.stringify(errorData)}`,\n        \"LINK_CREATION_FAILED\",\n        \"dropbox\",\n      );\n    }\n\n    const result = (await response.json()) as DropboxSharedLinkResponse;\n    // Modify URL for direct download\n    return result.url.replace(\"?dl=0\", \"?dl=1\");\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -33,6 +33,7 @@ class GoogleDriveStorage {
       );
     }
   }
+  config;
   baseUrl = "https://www.googleapis.com/drive/v3";
   uploadUrl = "https://www.googleapis.com/upload/drive/v3";
   async upload(file, filename) {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/google-drive.ts"],"sourcesContent":["/**\n * Google Drive Storage Provider for Vana SDK\n *\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Based on patterns from dlp-ui-template with NextAuth integration.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface GoogleDriveConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Parent folder ID to upload files to */\n  folderId?: string;\n}\n\ninterface GoogleDriveFile {\n  id: string;\n  name: string;\n  webViewLink: string;\n  size: string;\n  mimeType: string;\n  createdTime: string;\n}\n\ninterface GoogleDriveUploadResponse {\n  id: string;\n  name: string;\n}\n\ninterface GoogleDriveListResponse {\n  files: GoogleDriveFile[];\n}\n\ninterface GoogleDriveTokenResponse {\n  access_token: string;\n}\n\n/**\n * Google Drive Storage Provider with folder management capabilities\n *\n * @remarks\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Provides file upload/download operations and advanced folder management\n * including search, creation, and nested folder structures. Requires the\n * `https://www.googleapis.com/auth/drive.file` OAuth scope for full functionality.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * const googleDriveStorage = new GoogleDriveStorage({\n *   accessToken: \"your-oauth-access-token\",\n *   refreshToken: \"your-oauth-refresh-token\",\n *   clientId: \"your-oauth-client-id\",\n *   clientSecret: \"your-oauth-client-secret\",\n * });\n *\n * // Create folder structure and upload file\n * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n * const result = await googleDriveStorage.upload(fileBlob, \"image.png\");\n * ```\n */\nexport class GoogleDriveStorage implements StorageProvider {\n  private readonly baseUrl = \"https://www.googleapis.com/drive/v3\";\n  private readonly uploadUrl = \"https://www.googleapis.com/upload/drive/v3\";\n\n  constructor(private config: GoogleDriveConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Google Drive access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n\n      // Create file metadata\n      const metadata = {\n        name: fileName,\n        parents: this.config.folderId ? [this.config.folderId] : undefined,\n      };\n\n      // Create multipart upload request\n      const delimiter = \"-------314159265358979323846\";\n      const closeDelim = `\\r\\n--${delimiter}--`;\n\n      const metadataBlob = new Blob([JSON.stringify(metadata)], {\n        type: \"application/json\",\n      });\n\n      const multipartRequestBody = [\n        `--${delimiter}`,\n        \"Content-Type: application/json\",\n        \"\",\n        await metadataBlob.text(),\n        `--${delimiter}`,\n        `Content-Type: ${file.type || \"application/octet-stream\"}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\");\n\n      const requestBody = new Blob([multipartRequestBody, file, closeDelim]);\n\n      const response = await fetch(\n        `${this.uploadUrl}/files?uploadType=multipart`,\n        {\n          method: \"POST\",\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n            \"Content-Type\": `multipart/related; boundary=\"${delimiter}\"`,\n          },\n          body: requestBody,\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Google Drive: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n\n      // Make file publicly readable\n      await this.makeFilePublic(result.id);\n\n      return {\n        url: `https://drive.google.com/uc?id=${result.id}&export=download`,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          name: result.name,\n          driveUrl: `https://drive.google.com/file/d/${result.id}/view`,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/files/${fileId}?alt=media`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to download from Google Drive: ${error}`,\n          \"DOWNLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const blob = await response.blob();\n\n      // Check if we got HTML content instead of the actual file (authentication issue)\n      if (blob.type === \"text/html\") {\n        throw new StorageError(\n          \"Received HTML content instead of file data. This suggests an authentication or URL formatting issue with Google Drive.\",\n          \"AUTHENTICATION_ERROR\",\n          \"google-drive\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    try {\n      let query = \"trashed = false\";\n\n      // Add parent folder filter if configured\n      if (this.config.folderId) {\n        query += ` and '${this.config.folderId}' in parents`;\n      }\n\n      // Add name pattern filter\n      if (options?.namePattern) {\n        query += ` and name contains '${options.namePattern}'`;\n      }\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,size,mimeType,createdTime,webViewLink)\",\n        pageSize: (options?.limit ?? 100).toString(),\n      });\n\n      if (options?.offset && typeof options.offset === \"string\") {\n        params.set(\"pageToken\", options.offset);\n      }\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to list Google Drive files: ${error}`,\n          \"LIST_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      return result.files.map((file: GoogleDriveFile) => ({\n        id: file.id,\n        name: file.name,\n        url: `https://drive.google.com/uc?id=${file.id}&export=download`,\n        size: parseInt(file.size) || 0,\n        contentType: file.mimeType,\n        createdAt: new Date(file.createdTime),\n        metadata: {\n          id: file.id,\n          driveUrl: file.webViewLink,\n        },\n      }));\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(`${this.baseUrl}/files/${fileId}`, {\n        method: \"DELETE\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Google Drive: ${error}`,\n          \"DELETE_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Google Drive\",\n      type: \"google-drive\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  /**\n   * Make a Google Drive file publicly readable\n   *\n   * @param fileId - Google Drive file ID\n   */\n  private async makeFilePublic(fileId: string): Promise<void> {\n    try {\n      await fetch(`${this.baseUrl}/files/${fileId}/permissions`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          role: \"reader\",\n          type: \"anyone\",\n        }),\n      });\n    } catch (error) {\n      // Non-critical error - file upload succeeded but sharing failed\n      console.warn(\"Failed to make Google Drive file public:\", error);\n    }\n  }\n\n  /**\n   * Extract file ID from various Google Drive URL formats\n   *\n   * @param url - Google Drive URL\n   * @returns File ID or null if not found\n   */\n  private extractFileId(url: string): string | null {\n    // Handle various Google Drive URL formats\n    const patterns = [\n      /\\/file\\/d\\/([a-zA-Z0-9-_]+)/, // https://drive.google.com/file/d/FILE_ID/view\n      /id=([a-zA-Z0-9-_]+)/, // https://drive.google.com/uc?id=FILE_ID\n      /^([a-zA-Z0-9-_]+)$/, // Just the file ID\n    ];\n\n    for (const pattern of patterns) {\n      const match = url.match(pattern);\n      if (match) {\n        return match[1];\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Searches for an existing folder by name within a specified parent folder\n   *\n   * @remarks\n   * This method queries the Google Drive API to find a folder with the exact name\n   * within the specified parent directory. Only searches for folders (not files)\n   * and excludes trashed items.\n   *\n   * @param name - The exact name of the folder to search for\n   * @param parentId - The ID of the parent folder to search within (defaults to 'root')\n   * @returns Promise that resolves to the folder ID if found, or `null` if not found\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Search for a folder in the root directory\n   * const folderId = await googleDriveStorage.findFolder(\"screenshots\");\n   * if (folderId) {\n   *   console.log(\"Found folder:\", folderId);\n   * } else {\n   *   console.log(\"Folder not found\");\n   * }\n   *\n   * // Search for a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.findFolder(\"roasts\", parentFolderId);\n   * ```\n   */\n  async findFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string | null> {\n    try {\n      const query = `name='${name}' and '${parentId}' in parents and mimeType='application/vnd.google-apps.folder' and trashed = false`;\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,mimeType)\",\n      });\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to search Google Drive folders: ${error}`,\n          \"FIND_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      if (result.files && result.files.length > 0) {\n        return result.files[0].id;\n      }\n\n      return null;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Creates a new folder within a specified parent folder\n   *\n   * @remarks\n   * This method creates a new folder using the Google Drive API. The folder will be\n   * created with the specified name as a child of the parent folder. Requires the\n   * `https://www.googleapis.com/auth/drive.file` OAuth scope.\n   *\n   * @param name - The name for the new folder\n   * @param parentId - The ID of the parent folder where the new folder will be created (defaults to 'root')\n   * @returns Promise that resolves to the ID of the newly created folder\n   * @throws {StorageError} When the Google Drive API request fails or folder creation is denied\n   *\n   * @example\n   * ```typescript\n   * // Create a folder in the root directory\n   * const folderId = await googleDriveStorage.createFolder(\"my-documents\");\n   * console.log(\"Created folder:\", folderId);\n   *\n   * // Create a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.createFolder(\"reports\", parentFolderId);\n   * ```\n   */\n  async createFolder(name: string, parentId: string = \"root\"): Promise<string> {\n    try {\n      const metadata = {\n        name,\n        mimeType: \"application/vnd.google-apps.folder\",\n        parents: [parentId],\n      };\n\n      const response = await fetch(`${this.baseUrl}/files`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(metadata),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to create Google Drive folder: ${error}`,\n          \"CREATE_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n      return result.id;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive createFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Finds an existing folder by name, or creates it if it doesn't exist\n   *\n   * @remarks\n   * This is a convenience method that combines `findFolder` and `createFolder`.\n   * It first searches for an existing folder with the specified name. If found,\n   * it returns the existing folder's ID. If not found, it creates a new folder\n   * and returns the new folder's ID.\n   *\n   * @param name - The name of the folder to find or create\n   * @param parentId - The ID of the parent folder to search within or create the folder in (defaults to 'root')\n   * @returns Promise that resolves to the folder ID (either existing or newly created)\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Ensure a folder exists, creating it if necessary\n   * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n   * console.log(\"Folder ID:\", folderId); // Will be same ID if folder already existed\n   *\n   * // Create nested folder structure\n   * const parentId = await googleDriveStorage.findOrCreateFolder(\"projects\");\n   * const childId = await googleDriveStorage.findOrCreateFolder(\"vana-app\", parentId);\n   * ```\n   */\n  async findOrCreateFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string> {\n    try {\n      const existingFolderId = await this.findFolder(name, parentId);\n\n      if (existingFolderId) {\n        return existingFolderId;\n      }\n\n      return await this.createFolder(name, parentId);\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findOrCreateFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_OR_CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Refresh the access token using refresh token\n   *\n   * @returns Promise with new access token\n   */\n  async refreshAccessToken(): Promise<string> {\n    if (\n      !this.config.refreshToken ||\n      !this.config.clientId ||\n      !this.config.clientSecret\n    ) {\n      throw new StorageError(\n        \"Refresh token, client ID, and client secret are required for token refresh\",\n        \"MISSING_REFRESH_CONFIG\",\n        \"google-drive\",\n      );\n    }\n\n    try {\n      const response = await fetch(\"https://oauth2.googleapis.com/token\", {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/x-www-form-urlencoded\",\n        },\n        body: new URLSearchParams({\n          client_id: this.config.clientId,\n          client_secret: this.config.clientSecret,\n          refresh_token: this.config.refreshToken,\n          grant_type: \"refresh_token\",\n        }),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to refresh Google Drive token: ${error}`,\n          \"TOKEN_REFRESH_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveTokenResponse;\n      this.config.accessToken = result.access_token;\n\n      return result.access_token;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive token refresh error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"TOKEN_REFRESH_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/google-drive.ts"],"sourcesContent":["/**\n * Google Drive Storage Provider for Vana SDK\n *\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Based on patterns from dlp-ui-template with NextAuth integration.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface GoogleDriveConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Parent folder ID to upload files to */\n  folderId?: string;\n}\n\ninterface GoogleDriveFile {\n  id: string;\n  name: string;\n  webViewLink: string;\n  size: string;\n  mimeType: string;\n  createdTime: string;\n}\n\ninterface GoogleDriveUploadResponse {\n  id: string;\n  name: string;\n}\n\ninterface GoogleDriveListResponse {\n  files: GoogleDriveFile[];\n}\n\ninterface GoogleDriveTokenResponse {\n  access_token: string;\n}\n\n/**\n * Google Drive Storage Provider with folder management capabilities\n *\n * @remarks\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Provides file upload/download operations and advanced folder management\n * including search, creation, and nested folder structures. Requires the\n * `https://www.googleapis.com/auth/drive.file` OAuth scope for full functionality.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * const googleDriveStorage = new GoogleDriveStorage({\n *   accessToken: \"your-oauth-access-token\",\n *   refreshToken: \"your-oauth-refresh-token\",\n *   clientId: \"your-oauth-client-id\",\n *   clientSecret: \"your-oauth-client-secret\",\n * });\n *\n * // Create folder structure and upload file\n * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n * const result = await googleDriveStorage.upload(fileBlob, \"image.png\");\n * ```\n */\nexport class GoogleDriveStorage implements StorageProvider {\n  private readonly baseUrl = \"https://www.googleapis.com/drive/v3\";\n  private readonly uploadUrl = \"https://www.googleapis.com/upload/drive/v3\";\n\n  constructor(private config: GoogleDriveConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Google Drive access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n\n      // Create file metadata\n      const metadata = {\n        name: fileName,\n        parents: this.config.folderId ? [this.config.folderId] : undefined,\n      };\n\n      // Create multipart upload request\n      const delimiter = \"-------314159265358979323846\";\n      const closeDelim = `\\r\\n--${delimiter}--`;\n\n      const metadataBlob = new Blob([JSON.stringify(metadata)], {\n        type: \"application/json\",\n      });\n\n      const multipartRequestBody = [\n        `--${delimiter}`,\n        \"Content-Type: application/json\",\n        \"\",\n        await metadataBlob.text(),\n        `--${delimiter}`,\n        `Content-Type: ${file.type || \"application/octet-stream\"}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\");\n\n      const requestBody = new Blob([multipartRequestBody, file, closeDelim]);\n\n      const response = await fetch(\n        `${this.uploadUrl}/files?uploadType=multipart`,\n        {\n          method: \"POST\",\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n            \"Content-Type\": `multipart/related; boundary=\"${delimiter}\"`,\n          },\n          body: requestBody,\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Google Drive: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n\n      // Make file publicly readable\n      await this.makeFilePublic(result.id);\n\n      return {\n        url: `https://drive.google.com/uc?id=${result.id}&export=download`,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          name: result.name,\n          driveUrl: `https://drive.google.com/file/d/${result.id}/view`,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/files/${fileId}?alt=media`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to download from Google Drive: ${error}`,\n          \"DOWNLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const blob = await response.blob();\n\n      // Check if we got HTML content instead of the actual file (authentication issue)\n      if (blob.type === \"text/html\") {\n        throw new StorageError(\n          \"Received HTML content instead of file data. This suggests an authentication or URL formatting issue with Google Drive.\",\n          \"AUTHENTICATION_ERROR\",\n          \"google-drive\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    try {\n      let query = \"trashed = false\";\n\n      // Add parent folder filter if configured\n      if (this.config.folderId) {\n        query += ` and '${this.config.folderId}' in parents`;\n      }\n\n      // Add name pattern filter\n      if (options?.namePattern) {\n        query += ` and name contains '${options.namePattern}'`;\n      }\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,size,mimeType,createdTime,webViewLink)\",\n        pageSize: (options?.limit ?? 100).toString(),\n      });\n\n      if (options?.offset && typeof options.offset === \"string\") {\n        params.set(\"pageToken\", options.offset);\n      }\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to list Google Drive files: ${error}`,\n          \"LIST_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      return result.files.map((file: GoogleDriveFile) => ({\n        id: file.id,\n        name: file.name,\n        url: `https://drive.google.com/uc?id=${file.id}&export=download`,\n        size: parseInt(file.size) || 0,\n        contentType: file.mimeType,\n        createdAt: new Date(file.createdTime),\n        metadata: {\n          id: file.id,\n          driveUrl: file.webViewLink,\n        },\n      }));\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(`${this.baseUrl}/files/${fileId}`, {\n        method: \"DELETE\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Google Drive: ${error}`,\n          \"DELETE_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Google Drive\",\n      type: \"google-drive\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  /**\n   * Make a Google Drive file publicly readable\n   *\n   * @param fileId - Google Drive file ID\n   */\n  private async makeFilePublic(fileId: string): Promise<void> {\n    try {\n      await fetch(`${this.baseUrl}/files/${fileId}/permissions`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          role: \"reader\",\n          type: \"anyone\",\n        }),\n      });\n    } catch (error) {\n      // Non-critical error - file upload succeeded but sharing failed\n      console.warn(\"Failed to make Google Drive file public:\", error);\n    }\n  }\n\n  /**\n   * Extract file ID from various Google Drive URL formats\n   *\n   * @param url - Google Drive URL\n   * @returns File ID or null if not found\n   */\n  private extractFileId(url: string): string | null {\n    // Handle various Google Drive URL formats\n    const patterns = [\n      /\\/file\\/d\\/([a-zA-Z0-9-_]+)/, // https://drive.google.com/file/d/FILE_ID/view\n      /id=([a-zA-Z0-9-_]+)/, // https://drive.google.com/uc?id=FILE_ID\n      /^([a-zA-Z0-9-_]+)$/, // Just the file ID\n    ];\n\n    for (const pattern of patterns) {\n      const match = url.match(pattern);\n      if (match) {\n        return match[1];\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Searches for an existing folder by name within a specified parent folder\n   *\n   * @remarks\n   * This method queries the Google Drive API to find a folder with the exact name\n   * within the specified parent directory. Only searches for folders (not files)\n   * and excludes trashed items.\n   *\n   * @param name - The exact name of the folder to search for\n   * @param parentId - The ID of the parent folder to search within (defaults to 'root')\n   * @returns Promise that resolves to the folder ID if found, or `null` if not found\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Search for a folder in the root directory\n   * const folderId = await googleDriveStorage.findFolder(\"screenshots\");\n   * if (folderId) {\n   *   console.log(\"Found folder:\", folderId);\n   * } else {\n   *   console.log(\"Folder not found\");\n   * }\n   *\n   * // Search for a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.findFolder(\"roasts\", parentFolderId);\n   * ```\n   */\n  async findFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string | null> {\n    try {\n      const query = `name='${name}' and '${parentId}' in parents and mimeType='application/vnd.google-apps.folder' and trashed = false`;\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,mimeType)\",\n      });\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to search Google Drive folders: ${error}`,\n          \"FIND_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      if (result.files && result.files.length > 0) {\n        return result.files[0].id;\n      }\n\n      return null;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Creates a new folder within a specified parent folder\n   *\n   * @remarks\n   * This method creates a new folder using the Google Drive API. The folder will be\n   * created with the specified name as a child of the parent folder. Requires the\n   * `https://www.googleapis.com/auth/drive.file` OAuth scope.\n   *\n   * @param name - The name for the new folder\n   * @param parentId - The ID of the parent folder where the new folder will be created (defaults to 'root')\n   * @returns Promise that resolves to the ID of the newly created folder\n   * @throws {StorageError} When the Google Drive API request fails or folder creation is denied\n   *\n   * @example\n   * ```typescript\n   * // Create a folder in the root directory\n   * const folderId = await googleDriveStorage.createFolder(\"my-documents\");\n   * console.log(\"Created folder:\", folderId);\n   *\n   * // Create a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.createFolder(\"reports\", parentFolderId);\n   * ```\n   */\n  async createFolder(name: string, parentId: string = \"root\"): Promise<string> {\n    try {\n      const metadata = {\n        name,\n        mimeType: \"application/vnd.google-apps.folder\",\n        parents: [parentId],\n      };\n\n      const response = await fetch(`${this.baseUrl}/files`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(metadata),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to create Google Drive folder: ${error}`,\n          \"CREATE_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n      return result.id;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive createFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Finds an existing folder by name, or creates it if it doesn't exist\n   *\n   * @remarks\n   * This is a convenience method that combines `findFolder` and `createFolder`.\n   * It first searches for an existing folder with the specified name. If found,\n   * it returns the existing folder's ID. If not found, it creates a new folder\n   * and returns the new folder's ID.\n   *\n   * @param name - The name of the folder to find or create\n   * @param parentId - The ID of the parent folder to search within or create the folder in (defaults to 'root')\n   * @returns Promise that resolves to the folder ID (either existing or newly created)\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Ensure a folder exists, creating it if necessary\n   * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n   * console.log(\"Folder ID:\", folderId); // Will be same ID if folder already existed\n   *\n   * // Create nested folder structure\n   * const parentId = await googleDriveStorage.findOrCreateFolder(\"projects\");\n   * const childId = await googleDriveStorage.findOrCreateFolder(\"vana-app\", parentId);\n   * ```\n   */\n  async findOrCreateFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string> {\n    try {\n      const existingFolderId = await this.findFolder(name, parentId);\n\n      if (existingFolderId) {\n        return existingFolderId;\n      }\n\n      return await this.createFolder(name, parentId);\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findOrCreateFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_OR_CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Refresh the access token using refresh token\n   *\n   * @returns Promise with new access token\n   */\n  async refreshAccessToken(): Promise<string> {\n    if (\n      !this.config.refreshToken ||\n      !this.config.clientId ||\n      !this.config.clientSecret\n    ) {\n      throw new StorageError(\n        \"Refresh token, client ID, and client secret are required for token refresh\",\n        \"MISSING_REFRESH_CONFIG\",\n        \"google-drive\",\n      );\n    }\n\n    try {\n      const response = await fetch(\"https://oauth2.googleapis.com/token\", {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/x-www-form-urlencoded\",\n        },\n        body: new URLSearchParams({\n          client_id: this.config.clientId,\n          client_secret: this.config.clientSecret,\n          refresh_token: this.config.refreshToken,\n          grant_type: \"refresh_token\",\n        }),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to refresh Google Drive token: ${error}`,\n          \"TOKEN_REFRESH_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveTokenResponse;\n      this.config.accessToken = result.access_token;\n\n      return result.access_token;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive token refresh error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"TOKEN_REFRESH_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -12,6 +12,7 @@ class GoogleDriveStorage {
       );
     }
   }
+  config;
   baseUrl = "https://www.googleapis.com/drive/v3";
   uploadUrl = "https://www.googleapis.com/upload/drive/v3";
   async upload(file, filename) {

package/dist/storage/providers/google-drive.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/google-drive.ts"],"sourcesContent":["/**\n * Google Drive Storage Provider for Vana SDK\n *\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Based on patterns from dlp-ui-template with NextAuth integration.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface GoogleDriveConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Parent folder ID to upload files to */\n  folderId?: string;\n}\n\ninterface GoogleDriveFile {\n  id: string;\n  name: string;\n  webViewLink: string;\n  size: string;\n  mimeType: string;\n  createdTime: string;\n}\n\ninterface GoogleDriveUploadResponse {\n  id: string;\n  name: string;\n}\n\ninterface GoogleDriveListResponse {\n  files: GoogleDriveFile[];\n}\n\ninterface GoogleDriveTokenResponse {\n  access_token: string;\n}\n\n/**\n * Google Drive Storage Provider with folder management capabilities\n *\n * @remarks\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Provides file upload/download operations and advanced folder management\n * including search, creation, and nested folder structures. Requires the\n * `https://www.googleapis.com/auth/drive.file` OAuth scope for full functionality.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * const googleDriveStorage = new GoogleDriveStorage({\n *   accessToken: \"your-oauth-access-token\",\n *   refreshToken: \"your-oauth-refresh-token\",\n *   clientId: \"your-oauth-client-id\",\n *   clientSecret: \"your-oauth-client-secret\",\n * });\n *\n * // Create folder structure and upload file\n * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n * const result = await googleDriveStorage.upload(fileBlob, \"image.png\");\n * ```\n */\nexport class GoogleDriveStorage implements StorageProvider {\n  private readonly baseUrl = \"https://www.googleapis.com/drive/v3\";\n  private readonly uploadUrl = \"https://www.googleapis.com/upload/drive/v3\";\n\n  constructor(private config: GoogleDriveConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Google Drive access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n\n      // Create file metadata\n      const metadata = {\n        name: fileName,\n        parents: this.config.folderId ? [this.config.folderId] : undefined,\n      };\n\n      // Create multipart upload request\n      const delimiter = \"-------314159265358979323846\";\n      const closeDelim = `\\r\\n--${delimiter}--`;\n\n      const metadataBlob = new Blob([JSON.stringify(metadata)], {\n        type: \"application/json\",\n      });\n\n      const multipartRequestBody = [\n        `--${delimiter}`,\n        \"Content-Type: application/json\",\n        \"\",\n        await metadataBlob.text(),\n        `--${delimiter}`,\n        `Content-Type: ${file.type || \"application/octet-stream\"}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\");\n\n      const requestBody = new Blob([multipartRequestBody, file, closeDelim]);\n\n      const response = await fetch(\n        `${this.uploadUrl}/files?uploadType=multipart`,\n        {\n          method: \"POST\",\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n            \"Content-Type\": `multipart/related; boundary=\"${delimiter}\"`,\n          },\n          body: requestBody,\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Google Drive: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n\n      // Make file publicly readable\n      await this.makeFilePublic(result.id);\n\n      return {\n        url: `https://drive.google.com/uc?id=${result.id}&export=download`,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          name: result.name,\n          driveUrl: `https://drive.google.com/file/d/${result.id}/view`,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/files/${fileId}?alt=media`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to download from Google Drive: ${error}`,\n          \"DOWNLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const blob = await response.blob();\n\n      // Check if we got HTML content instead of the actual file (authentication issue)\n      if (blob.type === \"text/html\") {\n        throw new StorageError(\n          \"Received HTML content instead of file data. This suggests an authentication or URL formatting issue with Google Drive.\",\n          \"AUTHENTICATION_ERROR\",\n          \"google-drive\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    try {\n      let query = \"trashed = false\";\n\n      // Add parent folder filter if configured\n      if (this.config.folderId) {\n        query += ` and '${this.config.folderId}' in parents`;\n      }\n\n      // Add name pattern filter\n      if (options?.namePattern) {\n        query += ` and name contains '${options.namePattern}'`;\n      }\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,size,mimeType,createdTime,webViewLink)\",\n        pageSize: (options?.limit ?? 100).toString(),\n      });\n\n      if (options?.offset && typeof options.offset === \"string\") {\n        params.set(\"pageToken\", options.offset);\n      }\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to list Google Drive files: ${error}`,\n          \"LIST_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      return result.files.map((file: GoogleDriveFile) => ({\n        id: file.id,\n        name: file.name,\n        url: `https://drive.google.com/uc?id=${file.id}&export=download`,\n        size: parseInt(file.size) || 0,\n        contentType: file.mimeType,\n        createdAt: new Date(file.createdTime),\n        metadata: {\n          id: file.id,\n          driveUrl: file.webViewLink,\n        },\n      }));\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(`${this.baseUrl}/files/${fileId}`, {\n        method: \"DELETE\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Google Drive: ${error}`,\n          \"DELETE_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Google Drive\",\n      type: \"google-drive\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  /**\n   * Make a Google Drive file publicly readable\n   *\n   * @param fileId - Google Drive file ID\n   */\n  private async makeFilePublic(fileId: string): Promise<void> {\n    try {\n      await fetch(`${this.baseUrl}/files/${fileId}/permissions`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          role: \"reader\",\n          type: \"anyone\",\n        }),\n      });\n    } catch (error) {\n      // Non-critical error - file upload succeeded but sharing failed\n      console.warn(\"Failed to make Google Drive file public:\", error);\n    }\n  }\n\n  /**\n   * Extract file ID from various Google Drive URL formats\n   *\n   * @param url - Google Drive URL\n   * @returns File ID or null if not found\n   */\n  private extractFileId(url: string): string | null {\n    // Handle various Google Drive URL formats\n    const patterns = [\n      /\\/file\\/d\\/([a-zA-Z0-9-_]+)/, // https://drive.google.com/file/d/FILE_ID/view\n      /id=([a-zA-Z0-9-_]+)/, // https://drive.google.com/uc?id=FILE_ID\n      /^([a-zA-Z0-9-_]+)$/, // Just the file ID\n    ];\n\n    for (const pattern of patterns) {\n      const match = url.match(pattern);\n      if (match) {\n        return match[1];\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Searches for an existing folder by name within a specified parent folder\n   *\n   * @remarks\n   * This method queries the Google Drive API to find a folder with the exact name\n   * within the specified parent directory. Only searches for folders (not files)\n   * and excludes trashed items.\n   *\n   * @param name - The exact name of the folder to search for\n   * @param parentId - The ID of the parent folder to search within (defaults to 'root')\n   * @returns Promise that resolves to the folder ID if found, or `null` if not found\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Search for a folder in the root directory\n   * const folderId = await googleDriveStorage.findFolder(\"screenshots\");\n   * if (folderId) {\n   *   console.log(\"Found folder:\", folderId);\n   * } else {\n   *   console.log(\"Folder not found\");\n   * }\n   *\n   * // Search for a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.findFolder(\"roasts\", parentFolderId);\n   * ```\n   */\n  async findFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string | null> {\n    try {\n      const query = `name='${name}' and '${parentId}' in parents and mimeType='application/vnd.google-apps.folder' and trashed = false`;\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,mimeType)\",\n      });\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to search Google Drive folders: ${error}`,\n          \"FIND_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      if (result.files && result.files.length > 0) {\n        return result.files[0].id;\n      }\n\n      return null;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Creates a new folder within a specified parent folder\n   *\n   * @remarks\n   * This method creates a new folder using the Google Drive API. The folder will be\n   * created with the specified name as a child of the parent folder. Requires the\n   * `https://www.googleapis.com/auth/drive.file` OAuth scope.\n   *\n   * @param name - The name for the new folder\n   * @param parentId - The ID of the parent folder where the new folder will be created (defaults to 'root')\n   * @returns Promise that resolves to the ID of the newly created folder\n   * @throws {StorageError} When the Google Drive API request fails or folder creation is denied\n   *\n   * @example\n   * ```typescript\n   * // Create a folder in the root directory\n   * const folderId = await googleDriveStorage.createFolder(\"my-documents\");\n   * console.log(\"Created folder:\", folderId);\n   *\n   * // Create a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.createFolder(\"reports\", parentFolderId);\n   * ```\n   */\n  async createFolder(name: string, parentId: string = \"root\"): Promise<string> {\n    try {\n      const metadata = {\n        name,\n        mimeType: \"application/vnd.google-apps.folder\",\n        parents: [parentId],\n      };\n\n      const response = await fetch(`${this.baseUrl}/files`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(metadata),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to create Google Drive folder: ${error}`,\n          \"CREATE_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n      return result.id;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive createFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Finds an existing folder by name, or creates it if it doesn't exist\n   *\n   * @remarks\n   * This is a convenience method that combines `findFolder` and `createFolder`.\n   * It first searches for an existing folder with the specified name. If found,\n   * it returns the existing folder's ID. If not found, it creates a new folder\n   * and returns the new folder's ID.\n   *\n   * @param name - The name of the folder to find or create\n   * @param parentId - The ID of the parent folder to search within or create the folder in (defaults to 'root')\n   * @returns Promise that resolves to the folder ID (either existing or newly created)\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Ensure a folder exists, creating it if necessary\n   * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n   * console.log(\"Folder ID:\", folderId); // Will be same ID if folder already existed\n   *\n   * // Create nested folder structure\n   * const parentId = await googleDriveStorage.findOrCreateFolder(\"projects\");\n   * const childId = await googleDriveStorage.findOrCreateFolder(\"vana-app\", parentId);\n   * ```\n   */\n  async findOrCreateFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string> {\n    try {\n      const existingFolderId = await this.findFolder(name, parentId);\n\n      if (existingFolderId) {\n        return existingFolderId;\n      }\n\n      return await this.createFolder(name, parentId);\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findOrCreateFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_OR_CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Refresh the access token using refresh token\n   *\n   * @returns Promise with new access token\n   */\n  async refreshAccessToken(): Promise<string> {\n    if (\n      !this.config.refreshToken ||\n      !this.config.clientId ||\n      !this.config.clientSecret\n    ) {\n      throw new StorageError(\n        \"Refresh token, client ID, and client secret are required for token refresh\",\n        \"MISSING_REFRESH_CONFIG\",\n        \"google-drive\",\n      );\n    }\n\n    try {\n      const response = await fetch(\"https://oauth2.googleapis.com/token\", {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/x-www-form-urlencoded\",\n        },\n        body: new URLSearchParams({\n          client_id: this.config.clientId,\n          client_secret: this.config.clientSecret,\n          refresh_token: this.config.refreshToken,\n          grant_type: \"refresh_token\",\n        }),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to refresh Google Drive token: ${error}`,\n          \"TOKEN_REFRESH_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveTokenResponse;\n      this.config.accessToken = result.access_token;\n\n      return result.access_token;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive token refresh error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"TOKEN_REFRESH_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/google-drive.ts"],"sourcesContent":["/**\n * Google Drive Storage Provider for Vana SDK\n *\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Based on patterns from dlp-ui-template with NextAuth integration.\n */\n\nimport {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\n\nexport interface GoogleDriveConfig {\n  /** OAuth2 access token */\n  accessToken: string;\n  /** Optional refresh token for token renewal */\n  refreshToken?: string;\n  /** OAuth2 client ID */\n  clientId?: string;\n  /** OAuth2 client secret */\n  clientSecret?: string;\n  /** Parent folder ID to upload files to */\n  folderId?: string;\n}\n\ninterface GoogleDriveFile {\n  id: string;\n  name: string;\n  webViewLink: string;\n  size: string;\n  mimeType: string;\n  createdTime: string;\n}\n\ninterface GoogleDriveUploadResponse {\n  id: string;\n  name: string;\n}\n\ninterface GoogleDriveListResponse {\n  files: GoogleDriveFile[];\n}\n\ninterface GoogleDriveTokenResponse {\n  access_token: string;\n}\n\n/**\n * Google Drive Storage Provider with folder management capabilities\n *\n * @remarks\n * Implements storage interface for Google Drive using OAuth2 authentication.\n * Provides file upload/download operations and advanced folder management\n * including search, creation, and nested folder structures. Requires the\n * `https://www.googleapis.com/auth/drive.file` OAuth scope for full functionality.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * const googleDriveStorage = new GoogleDriveStorage({\n *   accessToken: \"your-oauth-access-token\",\n *   refreshToken: \"your-oauth-refresh-token\",\n *   clientId: \"your-oauth-client-id\",\n *   clientSecret: \"your-oauth-client-secret\",\n * });\n *\n * // Create folder structure and upload file\n * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n * const result = await googleDriveStorage.upload(fileBlob, \"image.png\");\n * ```\n */\nexport class GoogleDriveStorage implements StorageProvider {\n  private readonly baseUrl = \"https://www.googleapis.com/drive/v3\";\n  private readonly uploadUrl = \"https://www.googleapis.com/upload/drive/v3\";\n\n  constructor(private config: GoogleDriveConfig) {\n    if (!config.accessToken) {\n      throw new StorageError(\n        \"Google Drive access token is required\",\n        \"MISSING_ACCESS_TOKEN\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `vana-file-${Date.now()}.dat`;\n\n      // Create file metadata\n      const metadata = {\n        name: fileName,\n        parents: this.config.folderId ? [this.config.folderId] : undefined,\n      };\n\n      // Create multipart upload request\n      const delimiter = \"-------314159265358979323846\";\n      const closeDelim = `\\r\\n--${delimiter}--`;\n\n      const metadataBlob = new Blob([JSON.stringify(metadata)], {\n        type: \"application/json\",\n      });\n\n      const multipartRequestBody = [\n        `--${delimiter}`,\n        \"Content-Type: application/json\",\n        \"\",\n        await metadataBlob.text(),\n        `--${delimiter}`,\n        `Content-Type: ${file.type || \"application/octet-stream\"}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\");\n\n      const requestBody = new Blob([multipartRequestBody, file, closeDelim]);\n\n      const response = await fetch(\n        `${this.uploadUrl}/files?uploadType=multipart`,\n        {\n          method: \"POST\",\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n            \"Content-Type\": `multipart/related; boundary=\"${delimiter}\"`,\n          },\n          body: requestBody,\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to Google Drive: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n\n      // Make file publicly readable\n      await this.makeFilePublic(result.id);\n\n      return {\n        url: `https://drive.google.com/uc?id=${result.id}&export=download`,\n        size: file.size,\n        contentType: file.type || \"application/octet-stream\",\n        metadata: {\n          id: result.id,\n          name: result.name,\n          driveUrl: `https://drive.google.com/file/d/${result.id}/view`,\n        },\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async download(url: string): Promise<Blob> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/files/${fileId}?alt=media`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.config.accessToken}`,\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to download from Google Drive: ${error}`,\n          \"DOWNLOAD_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const blob = await response.blob();\n\n      // Check if we got HTML content instead of the actual file (authentication issue)\n      if (blob.type === \"text/html\") {\n        throw new StorageError(\n          \"Received HTML content instead of file data. This suggests an authentication or URL formatting issue with Google Drive.\",\n          \"AUTHENTICATION_ERROR\",\n          \"google-drive\",\n        );\n      }\n\n      return blob;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async list(options?: StorageListOptions): Promise<StorageFile[]> {\n    try {\n      let query = \"trashed = false\";\n\n      // Add parent folder filter if configured\n      if (this.config.folderId) {\n        query += ` and '${this.config.folderId}' in parents`;\n      }\n\n      // Add name pattern filter\n      if (options?.namePattern) {\n        query += ` and name contains '${options.namePattern}'`;\n      }\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,size,mimeType,createdTime,webViewLink)\",\n        pageSize: (options?.limit ?? 100).toString(),\n      });\n\n      if (options?.offset && typeof options.offset === \"string\") {\n        params.set(\"pageToken\", options.offset);\n      }\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to list Google Drive files: ${error}`,\n          \"LIST_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      return result.files.map((file: GoogleDriveFile) => ({\n        id: file.id,\n        name: file.name,\n        url: `https://drive.google.com/uc?id=${file.id}&export=download`,\n        size: parseInt(file.size) || 0,\n        contentType: file.mimeType,\n        createdAt: new Date(file.createdTime),\n        metadata: {\n          id: file.id,\n          driveUrl: file.webViewLink,\n        },\n      }));\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive list error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"LIST_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  async delete(url: string): Promise<boolean> {\n    try {\n      // Extract file ID from Google Drive URL\n      const fileId = this.extractFileId(url);\n      if (!fileId) {\n        throw new StorageError(\n          \"Invalid Google Drive URL format\",\n          \"INVALID_URL\",\n          \"google-drive\",\n        );\n      }\n\n      const response = await fetch(`${this.baseUrl}/files/${fileId}`, {\n        method: \"DELETE\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok && response.status !== 404) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to delete from Google Drive: ${error}`,\n          \"DELETE_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      return true;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive delete error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DELETE_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"Google Drive\",\n      type: \"google-drive\",\n      requiresAuth: true,\n      features: {\n        upload: true,\n        download: true,\n        list: true,\n        delete: true,\n      },\n    };\n  }\n\n  /**\n   * Make a Google Drive file publicly readable\n   *\n   * @param fileId - Google Drive file ID\n   */\n  private async makeFilePublic(fileId: string): Promise<void> {\n    try {\n      await fetch(`${this.baseUrl}/files/${fileId}/permissions`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          role: \"reader\",\n          type: \"anyone\",\n        }),\n      });\n    } catch (error) {\n      // Non-critical error - file upload succeeded but sharing failed\n      console.warn(\"Failed to make Google Drive file public:\", error);\n    }\n  }\n\n  /**\n   * Extract file ID from various Google Drive URL formats\n   *\n   * @param url - Google Drive URL\n   * @returns File ID or null if not found\n   */\n  private extractFileId(url: string): string | null {\n    // Handle various Google Drive URL formats\n    const patterns = [\n      /\\/file\\/d\\/([a-zA-Z0-9-_]+)/, // https://drive.google.com/file/d/FILE_ID/view\n      /id=([a-zA-Z0-9-_]+)/, // https://drive.google.com/uc?id=FILE_ID\n      /^([a-zA-Z0-9-_]+)$/, // Just the file ID\n    ];\n\n    for (const pattern of patterns) {\n      const match = url.match(pattern);\n      if (match) {\n        return match[1];\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Searches for an existing folder by name within a specified parent folder\n   *\n   * @remarks\n   * This method queries the Google Drive API to find a folder with the exact name\n   * within the specified parent directory. Only searches for folders (not files)\n   * and excludes trashed items.\n   *\n   * @param name - The exact name of the folder to search for\n   * @param parentId - The ID of the parent folder to search within (defaults to 'root')\n   * @returns Promise that resolves to the folder ID if found, or `null` if not found\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Search for a folder in the root directory\n   * const folderId = await googleDriveStorage.findFolder(\"screenshots\");\n   * if (folderId) {\n   *   console.log(\"Found folder:\", folderId);\n   * } else {\n   *   console.log(\"Folder not found\");\n   * }\n   *\n   * // Search for a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.findFolder(\"roasts\", parentFolderId);\n   * ```\n   */\n  async findFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string | null> {\n    try {\n      const query = `name='${name}' and '${parentId}' in parents and mimeType='application/vnd.google-apps.folder' and trashed = false`;\n\n      const params = new URLSearchParams({\n        q: query,\n        fields: \"files(id,name,mimeType)\",\n      });\n\n      const response = await fetch(`${this.baseUrl}/files?${params}`, {\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to search Google Drive folders: ${error}`,\n          \"FIND_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveListResponse;\n\n      if (result.files && result.files.length > 0) {\n        return result.files[0].id;\n      }\n\n      return null;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Creates a new folder within a specified parent folder\n   *\n   * @remarks\n   * This method creates a new folder using the Google Drive API. The folder will be\n   * created with the specified name as a child of the parent folder. Requires the\n   * `https://www.googleapis.com/auth/drive.file` OAuth scope.\n   *\n   * @param name - The name for the new folder\n   * @param parentId - The ID of the parent folder where the new folder will be created (defaults to 'root')\n   * @returns Promise that resolves to the ID of the newly created folder\n   * @throws {StorageError} When the Google Drive API request fails or folder creation is denied\n   *\n   * @example\n   * ```typescript\n   * // Create a folder in the root directory\n   * const folderId = await googleDriveStorage.createFolder(\"my-documents\");\n   * console.log(\"Created folder:\", folderId);\n   *\n   * // Create a subfolder within another folder\n   * const subFolderId = await googleDriveStorage.createFolder(\"reports\", parentFolderId);\n   * ```\n   */\n  async createFolder(name: string, parentId: string = \"root\"): Promise<string> {\n    try {\n      const metadata = {\n        name,\n        mimeType: \"application/vnd.google-apps.folder\",\n        parents: [parentId],\n      };\n\n      const response = await fetch(`${this.baseUrl}/files`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.config.accessToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(metadata),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to create Google Drive folder: ${error}`,\n          \"CREATE_FOLDER_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveUploadResponse;\n      return result.id;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive createFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Finds an existing folder by name, or creates it if it doesn't exist\n   *\n   * @remarks\n   * This is a convenience method that combines `findFolder` and `createFolder`.\n   * It first searches for an existing folder with the specified name. If found,\n   * it returns the existing folder's ID. If not found, it creates a new folder\n   * and returns the new folder's ID.\n   *\n   * @param name - The name of the folder to find or create\n   * @param parentId - The ID of the parent folder to search within or create the folder in (defaults to 'root')\n   * @returns Promise that resolves to the folder ID (either existing or newly created)\n   * @throws {StorageError} When the Google Drive API request fails\n   *\n   * @example\n   * ```typescript\n   * // Ensure a folder exists, creating it if necessary\n   * const folderId = await googleDriveStorage.findOrCreateFolder(\"screenshots\");\n   * console.log(\"Folder ID:\", folderId); // Will be same ID if folder already existed\n   *\n   * // Create nested folder structure\n   * const parentId = await googleDriveStorage.findOrCreateFolder(\"projects\");\n   * const childId = await googleDriveStorage.findOrCreateFolder(\"vana-app\", parentId);\n   * ```\n   */\n  async findOrCreateFolder(\n    name: string,\n    parentId: string = \"root\",\n  ): Promise<string> {\n    try {\n      const existingFolderId = await this.findFolder(name, parentId);\n\n      if (existingFolderId) {\n        return existingFolderId;\n      }\n\n      return await this.createFolder(name, parentId);\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive findOrCreateFolder error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"FIND_OR_CREATE_FOLDER_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n\n  /**\n   * Refresh the access token using refresh token\n   *\n   * @returns Promise with new access token\n   */\n  async refreshAccessToken(): Promise<string> {\n    if (\n      !this.config.refreshToken ||\n      !this.config.clientId ||\n      !this.config.clientSecret\n    ) {\n      throw new StorageError(\n        \"Refresh token, client ID, and client secret are required for token refresh\",\n        \"MISSING_REFRESH_CONFIG\",\n        \"google-drive\",\n      );\n    }\n\n    try {\n      const response = await fetch(\"https://oauth2.googleapis.com/token\", {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/x-www-form-urlencoded\",\n        },\n        body: new URLSearchParams({\n          client_id: this.config.clientId,\n          client_secret: this.config.clientSecret,\n          refresh_token: this.config.refreshToken,\n          grant_type: \"refresh_token\",\n        }),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to refresh Google Drive token: ${error}`,\n          \"TOKEN_REFRESH_FAILED\",\n          \"google-drive\",\n        );\n      }\n\n      const result = (await response.json()) as GoogleDriveTokenResponse;\n      this.config.accessToken = result.access_token;\n\n      return result.access_token;\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `Google Drive token refresh error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"TOKEN_REFRESH_ERROR\",\n        \"google-drive\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/ipfs.cjs

@@ -36,6 +36,7 @@ class IpfsStorage {
     this.gatewayUrl = config.gatewayUrl ?? "https://gateway.pinata.cloud/ipfs";
     this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);
   }
+  config;
   gatewayUrl;
   hasAuth;
   /**

package/dist/storage/providers/ipfs.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/ipfs.ts"],"sourcesContent":["import {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\nimport { toBase64 } from \"../../utils/encoding\";\n\nexport interface IpfsConfig {\n  /** IPFS API endpoint for uploads */\n  apiEndpoint: string;\n  /** Gateway URL for downloads (optional, defaults to public gateway) */\n  gatewayUrl?: string;\n  /** Additional headers for API requests */\n  headers?: Record<string, string>;\n}\n\ninterface IpfsUploadResponse {\n  Hash?: string;\n  Size?: number;\n}\n\n/**\n * Connects to any standard IPFS node or service provider\n *\n * @remarks\n * This provider implements the standard IPFS HTTP API (`/api/v0/add`) and works\n * with any IPFS-compatible service. It provides the essential IPFS operations\n * (upload/download) while maintaining the immutable, content-addressed nature\n * of IPFS. Use static factory methods for common providers like Infura or local nodes.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * // Use with Infura (recommended for production)\n * const ipfsStorage = IpfsStorage.forInfura({\n *   projectId: \"your-project-id\",\n *   projectSecret: \"your-project-secret\"\n * });\n *\n * // Use with local IPFS node\n * const localStorage = IpfsStorage.forLocalNode();\n *\n * // Upload file and get CID\n * const result = await ipfsStorage.upload(fileBlob, \"document.pdf\");\n * console.log(\"Uploaded to IPFS:\", result.url);\n * ```\n */\nexport class IpfsStorage implements StorageProvider {\n  private readonly gatewayUrl: string;\n  private readonly hasAuth: boolean;\n\n  constructor(private config: IpfsConfig) {\n    if (!config.apiEndpoint) {\n      throw new StorageError(\n        \"IPFS API endpoint is required\",\n        \"MISSING_API_ENDPOINT\",\n        \"ipfs\",\n      );\n    }\n\n    this.gatewayUrl = config.gatewayUrl ?? \"https://gateway.pinata.cloud/ipfs\";\n    this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for Infura\n   *\n   * @remarks\n   * Infura provides reliable, scalable IPFS infrastructure with global availability.\n   * This factory method automatically configures the correct endpoints and authentication\n   * for Infura's IPFS service.\n   *\n   * @param credentials - Infura project credentials\n   * @param credentials.projectId - Your Infura project ID\n   * @param credentials.projectSecret - Your Infura project secret\n   * @returns Configured IpfsStorage instance for Infura\n   *\n   * @example\n   * ```typescript\n   * const ipfsStorage = IpfsStorage.forInfura({\n   *   projectId: \"2FVGj8UJP5v8ZcnX9K5L7M8c\",\n   *   projectSecret: \"a7f2c1e5b8d9f3a6e4c8b2d7f9e1a4c3\"\n   * });\n   *\n   * const result = await ipfsStorage.upload(fileBlob);\n   * ```\n   */\n  static forInfura(credentials: {\n    projectId: string;\n    projectSecret: string;\n  }): IpfsStorage {\n    const encoder = new TextEncoder();\n    const auth = toBase64(\n      encoder.encode(`${credentials.projectId}:${credentials.projectSecret}`),\n    );\n    return new IpfsStorage({\n      apiEndpoint: \"https://ipfs.infura.io:5001/api/v0/add\",\n      gatewayUrl: \"https://ipfs.infura.io/ipfs\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n    });\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for a local IPFS node\n   *\n   * @remarks\n   * This factory method configures the storage provider to connect to a local IPFS node,\n   * typically running on your development machine or server. Assumes standard ports\n   * (5001 for API, 8080 for gateway) unless otherwise specified.\n   *\n   * @param options - Local node configuration options\n   * @param options.url - Base URL of the local IPFS node (defaults to http://localhost:5001)\n   * @returns Configured IpfsStorage instance for local node\n   *\n   * @example\n   * ```typescript\n   * // Use default localhost configuration\n   * const localStorage = IpfsStorage.forLocalNode();\n   *\n   * // Use custom local node URL\n   * const customStorage = IpfsStorage.forLocalNode({\n   *   url: \"http://192.168.1.100:5001\"\n   * });\n   *\n   * const result = await localStorage.upload(fileBlob, \"local-file.txt\");\n   * ```\n   */\n  static forLocalNode(options?: { url?: string }): IpfsStorage {\n    const baseUrl = options?.url ?? \"http://localhost:5001\";\n    return new IpfsStorage({\n      apiEndpoint: `${baseUrl}/api/v0/add`,\n      gatewayUrl: `${baseUrl.replace(\":5001\", \":8080\")}/ipfs`,\n    });\n  }\n\n  /**\n   * Uploads a file to IPFS and returns the content identifier (CID)\n   *\n   * @remarks\n   * This method uploads the file to the configured IPFS endpoint using the standard\n   * `/api/v0/add` API. The file is content-addressed, meaning the same file will\n   * always produce the same CID regardless of when or where it's uploaded.\n   *\n   * @param file - The file to upload to IPFS\n   * @param filename - Optional filename (for metadata purposes only)\n   * @returns Promise that resolves to StorageUploadResult with IPFS gateway URL\n   * @throws {StorageError} When the upload fails or no CID is returned\n   *\n   * @example\n   * ```typescript\n   * const result = await ipfsStorage.upload(fileBlob, \"report.pdf\");\n   * console.log(\"File uploaded to IPFS:\", result.url);\n   * // Example URL: \"https://gateway.pinata.cloud/ipfs/QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\"\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `ipfs-file-${Date.now()}.dat`;\n\n      // Create FormData for IPFS upload\n      const formData = new FormData();\n      formData.append(\"file\", file, fileName);\n\n      const response = await fetch(this.config.apiEndpoint, {\n        method: \"POST\",\n        headers: this.config.headers ?? {},\n        body: formData,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to IPFS: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      const result = (await response.json()) as IpfsUploadResponse;\n      const hash = result.Hash;\n\n      if (!hash) {\n        throw new StorageError(\n          \"IPFS upload succeeded but no hash returned\",\n          \"NO_HASH_RETURNED\",\n          \"ipfs\",\n        );\n      }\n\n      return {\n        url: `ipfs://${hash}`,\n        size: file.size,\n        contentType: file.type ?? \"application/octet-stream\",\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  /**\n   * Downloads a file from IPFS using its content identifier (CID)\n   *\n   * @remarks\n   * This method retrieves the file from IPFS using the configured gateway.\n   * It accepts various formats including raw CIDs, ipfs:// URLs, and gateway URLs.\n   * The file is downloaded from the globally distributed IPFS network.\n   *\n   * @param cid - The IPFS content identifier, ipfs:// URL, or gateway URL\n   * @returns Promise that resolves to the downloaded file content\n   * @throws {StorageError} When the download fails or CID format is invalid\n   *\n   * @example\n   * ```typescript\n   * // Download using raw CID\n   * const file = await ipfsStorage.download(\"QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Download using ipfs:// URL\n   * const file2 = await ipfsStorage.download(\"ipfs://QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Create download link\n   * const url = URL.createObjectURL(file);\n   * ```\n   */\n  async download(cid: string): Promise<Blob> {\n    try {\n      const downloadUrl = this.buildDownloadUrl(cid);\n\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from IPFS: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  async list(_options?: StorageListOptions): Promise<StorageFile[]> {\n    throw new StorageError(\n      \"List operation is not supported by standard IPFS. Use a service-specific provider like Pinata.\",\n      \"LIST_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  async delete(_url: string): Promise<boolean> {\n    throw new StorageError(\n      \"Delete operation is not supported by IPFS. Files are immutable once uploaded.\",\n      \"DELETE_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"IPFS\",\n      type: \"ipfs\",\n      requiresAuth: this.hasAuth,\n      features: {\n        upload: true,\n        download: true,\n        list: false,\n        delete: false,\n      },\n    };\n  }\n\n  /**\n   * Build download URL from CID or existing URL\n   *\n   * @param cid - IPFS CID or URL\n   * @returns Gateway URL for download\n   */\n  private buildDownloadUrl(cid: string): string {\n    // If it's already a full URL, return as-is\n    if (cid.startsWith(\"http://\") || cid.startsWith(\"https://\")) {\n      return cid;\n    }\n\n    // Handle ipfs:// URLs\n    if (cid.startsWith(\"ipfs://\")) {\n      const hash = cid.replace(\"ipfs://\", \"\");\n      return `${this.gatewayUrl}/${hash}`;\n    }\n\n    // Validate CID format (basic validation)\n    if (!this.isValidCID(cid)) {\n      throw new StorageError(\n        \"Invalid IPFS CID or URL format\",\n        \"INVALID_CID\",\n        \"ipfs\",\n      );\n    }\n\n    // Assume it's a raw CID\n    return `${this.gatewayUrl}/${cid}`;\n  }\n\n  /**\n   * Basic CID validation\n   *\n   * @param cid - Content identifier to validate\n   * @returns True if CID appears valid\n   */\n  private isValidCID(cid: string): boolean {\n    // Basic validation: CIDs typically start with 'Qm' or 'ba' and contain alphanumeric characters\n    // Allow shorter hashes for testing purposes\n    return (\n      /^[a-zA-Z0-9]{10,}$/.test(cid) &&\n      (cid.startsWith(\"Qm\") || cid.startsWith(\"ba\") || cid.includes(\"Test\"))\n    );\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/ipfs.ts"],"sourcesContent":["import {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\nimport { toBase64 } from \"../../utils/encoding\";\n\nexport interface IpfsConfig {\n  /** IPFS API endpoint for uploads */\n  apiEndpoint: string;\n  /** Gateway URL for downloads (optional, defaults to public gateway) */\n  gatewayUrl?: string;\n  /** Additional headers for API requests */\n  headers?: Record<string, string>;\n}\n\ninterface IpfsUploadResponse {\n  Hash?: string;\n  Size?: number;\n}\n\n/**\n * Connects to any standard IPFS node or service provider\n *\n * @remarks\n * This provider implements the standard IPFS HTTP API (`/api/v0/add`) and works\n * with any IPFS-compatible service. It provides the essential IPFS operations\n * (upload/download) while maintaining the immutable, content-addressed nature\n * of IPFS. Use static factory methods for common providers like Infura or local nodes.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * // Use with Infura (recommended for production)\n * const ipfsStorage = IpfsStorage.forInfura({\n *   projectId: \"your-project-id\",\n *   projectSecret: \"your-project-secret\"\n * });\n *\n * // Use with local IPFS node\n * const localStorage = IpfsStorage.forLocalNode();\n *\n * // Upload file and get CID\n * const result = await ipfsStorage.upload(fileBlob, \"document.pdf\");\n * console.log(\"Uploaded to IPFS:\", result.url);\n * ```\n */\nexport class IpfsStorage implements StorageProvider {\n  private readonly gatewayUrl: string;\n  private readonly hasAuth: boolean;\n\n  constructor(private config: IpfsConfig) {\n    if (!config.apiEndpoint) {\n      throw new StorageError(\n        \"IPFS API endpoint is required\",\n        \"MISSING_API_ENDPOINT\",\n        \"ipfs\",\n      );\n    }\n\n    this.gatewayUrl = config.gatewayUrl ?? \"https://gateway.pinata.cloud/ipfs\";\n    this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for Infura\n   *\n   * @remarks\n   * Infura provides reliable, scalable IPFS infrastructure with global availability.\n   * This factory method automatically configures the correct endpoints and authentication\n   * for Infura's IPFS service.\n   *\n   * @param credentials - Infura project credentials\n   * @param credentials.projectId - Your Infura project ID\n   * @param credentials.projectSecret - Your Infura project secret\n   * @returns Configured IpfsStorage instance for Infura\n   *\n   * @example\n   * ```typescript\n   * const ipfsStorage = IpfsStorage.forInfura({\n   *   projectId: \"2FVGj8UJP5v8ZcnX9K5L7M8c\",\n   *   projectSecret: \"a7f2c1e5b8d9f3a6e4c8b2d7f9e1a4c3\"\n   * });\n   *\n   * const result = await ipfsStorage.upload(fileBlob);\n   * ```\n   */\n  static forInfura(credentials: {\n    projectId: string;\n    projectSecret: string;\n  }): IpfsStorage {\n    const encoder = new TextEncoder();\n    const auth = toBase64(\n      encoder.encode(`${credentials.projectId}:${credentials.projectSecret}`),\n    );\n    return new IpfsStorage({\n      apiEndpoint: \"https://ipfs.infura.io:5001/api/v0/add\",\n      gatewayUrl: \"https://ipfs.infura.io/ipfs\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n    });\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for a local IPFS node\n   *\n   * @remarks\n   * This factory method configures the storage provider to connect to a local IPFS node,\n   * typically running on your development machine or server. Assumes standard ports\n   * (5001 for API, 8080 for gateway) unless otherwise specified.\n   *\n   * @param options - Local node configuration options\n   * @param options.url - Base URL of the local IPFS node (defaults to http://localhost:5001)\n   * @returns Configured IpfsStorage instance for local node\n   *\n   * @example\n   * ```typescript\n   * // Use default localhost configuration\n   * const localStorage = IpfsStorage.forLocalNode();\n   *\n   * // Use custom local node URL\n   * const customStorage = IpfsStorage.forLocalNode({\n   *   url: \"http://192.168.1.100:5001\"\n   * });\n   *\n   * const result = await localStorage.upload(fileBlob, \"local-file.txt\");\n   * ```\n   */\n  static forLocalNode(options?: { url?: string }): IpfsStorage {\n    const baseUrl = options?.url ?? \"http://localhost:5001\";\n    return new IpfsStorage({\n      apiEndpoint: `${baseUrl}/api/v0/add`,\n      gatewayUrl: `${baseUrl.replace(\":5001\", \":8080\")}/ipfs`,\n    });\n  }\n\n  /**\n   * Uploads a file to IPFS and returns the content identifier (CID)\n   *\n   * @remarks\n   * This method uploads the file to the configured IPFS endpoint using the standard\n   * `/api/v0/add` API. The file is content-addressed, meaning the same file will\n   * always produce the same CID regardless of when or where it's uploaded.\n   *\n   * @param file - The file to upload to IPFS\n   * @param filename - Optional filename (for metadata purposes only)\n   * @returns Promise that resolves to StorageUploadResult with IPFS gateway URL\n   * @throws {StorageError} When the upload fails or no CID is returned\n   *\n   * @example\n   * ```typescript\n   * const result = await ipfsStorage.upload(fileBlob, \"report.pdf\");\n   * console.log(\"File uploaded to IPFS:\", result.url);\n   * // Example URL: \"https://gateway.pinata.cloud/ipfs/QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\"\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `ipfs-file-${Date.now()}.dat`;\n\n      // Create FormData for IPFS upload\n      const formData = new FormData();\n      formData.append(\"file\", file, fileName);\n\n      const response = await fetch(this.config.apiEndpoint, {\n        method: \"POST\",\n        headers: this.config.headers ?? {},\n        body: formData,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to IPFS: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      const result = (await response.json()) as IpfsUploadResponse;\n      const hash = result.Hash;\n\n      if (!hash) {\n        throw new StorageError(\n          \"IPFS upload succeeded but no hash returned\",\n          \"NO_HASH_RETURNED\",\n          \"ipfs\",\n        );\n      }\n\n      return {\n        url: `ipfs://${hash}`,\n        size: file.size,\n        contentType: file.type ?? \"application/octet-stream\",\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  /**\n   * Downloads a file from IPFS using its content identifier (CID)\n   *\n   * @remarks\n   * This method retrieves the file from IPFS using the configured gateway.\n   * It accepts various formats including raw CIDs, ipfs:// URLs, and gateway URLs.\n   * The file is downloaded from the globally distributed IPFS network.\n   *\n   * @param cid - The IPFS content identifier, ipfs:// URL, or gateway URL\n   * @returns Promise that resolves to the downloaded file content\n   * @throws {StorageError} When the download fails or CID format is invalid\n   *\n   * @example\n   * ```typescript\n   * // Download using raw CID\n   * const file = await ipfsStorage.download(\"QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Download using ipfs:// URL\n   * const file2 = await ipfsStorage.download(\"ipfs://QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Create download link\n   * const url = URL.createObjectURL(file);\n   * ```\n   */\n  async download(cid: string): Promise<Blob> {\n    try {\n      const downloadUrl = this.buildDownloadUrl(cid);\n\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from IPFS: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  async list(_options?: StorageListOptions): Promise<StorageFile[]> {\n    throw new StorageError(\n      \"List operation is not supported by standard IPFS. Use a service-specific provider like Pinata.\",\n      \"LIST_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  async delete(_url: string): Promise<boolean> {\n    throw new StorageError(\n      \"Delete operation is not supported by IPFS. Files are immutable once uploaded.\",\n      \"DELETE_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"IPFS\",\n      type: \"ipfs\",\n      requiresAuth: this.hasAuth,\n      features: {\n        upload: true,\n        download: true,\n        list: false,\n        delete: false,\n      },\n    };\n  }\n\n  /**\n   * Build download URL from CID or existing URL\n   *\n   * @param cid - IPFS CID or URL\n   * @returns Gateway URL for download\n   */\n  private buildDownloadUrl(cid: string): string {\n    // If it's already a full URL, return as-is\n    if (cid.startsWith(\"http://\") || cid.startsWith(\"https://\")) {\n      return cid;\n    }\n\n    // Handle ipfs:// URLs\n    if (cid.startsWith(\"ipfs://\")) {\n      const hash = cid.replace(\"ipfs://\", \"\");\n      return `${this.gatewayUrl}/${hash}`;\n    }\n\n    // Validate CID format (basic validation)\n    if (!this.isValidCID(cid)) {\n      throw new StorageError(\n        \"Invalid IPFS CID or URL format\",\n        \"INVALID_CID\",\n        \"ipfs\",\n      );\n    }\n\n    // Assume it's a raw CID\n    return `${this.gatewayUrl}/${cid}`;\n  }\n\n  /**\n   * Basic CID validation\n   *\n   * @param cid - Content identifier to validate\n   * @returns True if CID appears valid\n   */\n  private isValidCID(cid: string): boolean {\n    // Basic validation: CIDs typically start with 'Qm' or 'ba' and contain alphanumeric characters\n    // Allow shorter hashes for testing purposes\n    return (\n      /^[a-zA-Z0-9]{10,}$/.test(cid) &&\n      (cid.startsWith(\"Qm\") || cid.startsWith(\"ba\") || cid.includes(\"Test\"))\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/ipfs.js

@@ -15,6 +15,7 @@ class IpfsStorage {
     this.gatewayUrl = config.gatewayUrl ?? "https://gateway.pinata.cloud/ipfs";
     this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);
   }
+  config;
   gatewayUrl;
   hasAuth;
   /**

package/dist/storage/providers/ipfs.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/storage/providers/ipfs.ts"],"sourcesContent":["import {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\nimport { toBase64 } from \"../../utils/encoding\";\n\nexport interface IpfsConfig {\n  /** IPFS API endpoint for uploads */\n  apiEndpoint: string;\n  /** Gateway URL for downloads (optional, defaults to public gateway) */\n  gatewayUrl?: string;\n  /** Additional headers for API requests */\n  headers?: Record<string, string>;\n}\n\ninterface IpfsUploadResponse {\n  Hash?: string;\n  Size?: number;\n}\n\n/**\n * Connects to any standard IPFS node or service provider\n *\n * @remarks\n * This provider implements the standard IPFS HTTP API (`/api/v0/add`) and works\n * with any IPFS-compatible service. It provides the essential IPFS operations\n * (upload/download) while maintaining the immutable, content-addressed nature\n * of IPFS. Use static factory methods for common providers like Infura or local nodes.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * // Use with Infura (recommended for production)\n * const ipfsStorage = IpfsStorage.forInfura({\n *   projectId: \"your-project-id\",\n *   projectSecret: \"your-project-secret\"\n * });\n *\n * // Use with local IPFS node\n * const localStorage = IpfsStorage.forLocalNode();\n *\n * // Upload file and get CID\n * const result = await ipfsStorage.upload(fileBlob, \"document.pdf\");\n * console.log(\"Uploaded to IPFS:\", result.url);\n * ```\n */\nexport class IpfsStorage implements StorageProvider {\n  private readonly gatewayUrl: string;\n  private readonly hasAuth: boolean;\n\n  constructor(private config: IpfsConfig) {\n    if (!config.apiEndpoint) {\n      throw new StorageError(\n        \"IPFS API endpoint is required\",\n        \"MISSING_API_ENDPOINT\",\n        \"ipfs\",\n      );\n    }\n\n    this.gatewayUrl = config.gatewayUrl ?? \"https://gateway.pinata.cloud/ipfs\";\n    this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for Infura\n   *\n   * @remarks\n   * Infura provides reliable, scalable IPFS infrastructure with global availability.\n   * This factory method automatically configures the correct endpoints and authentication\n   * for Infura's IPFS service.\n   *\n   * @param credentials - Infura project credentials\n   * @param credentials.projectId - Your Infura project ID\n   * @param credentials.projectSecret - Your Infura project secret\n   * @returns Configured IpfsStorage instance for Infura\n   *\n   * @example\n   * ```typescript\n   * const ipfsStorage = IpfsStorage.forInfura({\n   *   projectId: \"2FVGj8UJP5v8ZcnX9K5L7M8c\",\n   *   projectSecret: \"a7f2c1e5b8d9f3a6e4c8b2d7f9e1a4c3\"\n   * });\n   *\n   * const result = await ipfsStorage.upload(fileBlob);\n   * ```\n   */\n  static forInfura(credentials: {\n    projectId: string;\n    projectSecret: string;\n  }): IpfsStorage {\n    const encoder = new TextEncoder();\n    const auth = toBase64(\n      encoder.encode(`${credentials.projectId}:${credentials.projectSecret}`),\n    );\n    return new IpfsStorage({\n      apiEndpoint: \"https://ipfs.infura.io:5001/api/v0/add\",\n      gatewayUrl: \"https://ipfs.infura.io/ipfs\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n    });\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for a local IPFS node\n   *\n   * @remarks\n   * This factory method configures the storage provider to connect to a local IPFS node,\n   * typically running on your development machine or server. Assumes standard ports\n   * (5001 for API, 8080 for gateway) unless otherwise specified.\n   *\n   * @param options - Local node configuration options\n   * @param options.url - Base URL of the local IPFS node (defaults to http://localhost:5001)\n   * @returns Configured IpfsStorage instance for local node\n   *\n   * @example\n   * ```typescript\n   * // Use default localhost configuration\n   * const localStorage = IpfsStorage.forLocalNode();\n   *\n   * // Use custom local node URL\n   * const customStorage = IpfsStorage.forLocalNode({\n   *   url: \"http://192.168.1.100:5001\"\n   * });\n   *\n   * const result = await localStorage.upload(fileBlob, \"local-file.txt\");\n   * ```\n   */\n  static forLocalNode(options?: { url?: string }): IpfsStorage {\n    const baseUrl = options?.url ?? \"http://localhost:5001\";\n    return new IpfsStorage({\n      apiEndpoint: `${baseUrl}/api/v0/add`,\n      gatewayUrl: `${baseUrl.replace(\":5001\", \":8080\")}/ipfs`,\n    });\n  }\n\n  /**\n   * Uploads a file to IPFS and returns the content identifier (CID)\n   *\n   * @remarks\n   * This method uploads the file to the configured IPFS endpoint using the standard\n   * `/api/v0/add` API. The file is content-addressed, meaning the same file will\n   * always produce the same CID regardless of when or where it's uploaded.\n   *\n   * @param file - The file to upload to IPFS\n   * @param filename - Optional filename (for metadata purposes only)\n   * @returns Promise that resolves to StorageUploadResult with IPFS gateway URL\n   * @throws {StorageError} When the upload fails or no CID is returned\n   *\n   * @example\n   * ```typescript\n   * const result = await ipfsStorage.upload(fileBlob, \"report.pdf\");\n   * console.log(\"File uploaded to IPFS:\", result.url);\n   * // Example URL: \"https://gateway.pinata.cloud/ipfs/QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\"\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `ipfs-file-${Date.now()}.dat`;\n\n      // Create FormData for IPFS upload\n      const formData = new FormData();\n      formData.append(\"file\", file, fileName);\n\n      const response = await fetch(this.config.apiEndpoint, {\n        method: \"POST\",\n        headers: this.config.headers ?? {},\n        body: formData,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to IPFS: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      const result = (await response.json()) as IpfsUploadResponse;\n      const hash = result.Hash;\n\n      if (!hash) {\n        throw new StorageError(\n          \"IPFS upload succeeded but no hash returned\",\n          \"NO_HASH_RETURNED\",\n          \"ipfs\",\n        );\n      }\n\n      return {\n        url: `ipfs://${hash}`,\n        size: file.size,\n        contentType: file.type ?? \"application/octet-stream\",\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  /**\n   * Downloads a file from IPFS using its content identifier (CID)\n   *\n   * @remarks\n   * This method retrieves the file from IPFS using the configured gateway.\n   * It accepts various formats including raw CIDs, ipfs:// URLs, and gateway URLs.\n   * The file is downloaded from the globally distributed IPFS network.\n   *\n   * @param cid - The IPFS content identifier, ipfs:// URL, or gateway URL\n   * @returns Promise that resolves to the downloaded file content\n   * @throws {StorageError} When the download fails or CID format is invalid\n   *\n   * @example\n   * ```typescript\n   * // Download using raw CID\n   * const file = await ipfsStorage.download(\"QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Download using ipfs:// URL\n   * const file2 = await ipfsStorage.download(\"ipfs://QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Create download link\n   * const url = URL.createObjectURL(file);\n   * ```\n   */\n  async download(cid: string): Promise<Blob> {\n    try {\n      const downloadUrl = this.buildDownloadUrl(cid);\n\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from IPFS: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  async list(_options?: StorageListOptions): Promise<StorageFile[]> {\n    throw new StorageError(\n      \"List operation is not supported by standard IPFS. Use a service-specific provider like Pinata.\",\n      \"LIST_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  async delete(_url: string): Promise<boolean> {\n    throw new StorageError(\n      \"Delete operation is not supported by IPFS. Files are immutable once uploaded.\",\n      \"DELETE_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"IPFS\",\n      type: \"ipfs\",\n      requiresAuth: this.hasAuth,\n      features: {\n        upload: true,\n        download: true,\n        list: false,\n        delete: false,\n      },\n    };\n  }\n\n  /**\n   * Build download URL from CID or existing URL\n   *\n   * @param cid - IPFS CID or URL\n   * @returns Gateway URL for download\n   */\n  private buildDownloadUrl(cid: string): string {\n    // If it's already a full URL, return as-is\n    if (cid.startsWith(\"http://\") || cid.startsWith(\"https://\")) {\n      return cid;\n    }\n\n    // Handle ipfs:// URLs\n    if (cid.startsWith(\"ipfs://\")) {\n      const hash = cid.replace(\"ipfs://\", \"\");\n      return `${this.gatewayUrl}/${hash}`;\n    }\n\n    // Validate CID format (basic validation)\n    if (!this.isValidCID(cid)) {\n      throw new StorageError(\n        \"Invalid IPFS CID or URL format\",\n        \"INVALID_CID\",\n        \"ipfs\",\n      );\n    }\n\n    // Assume it's a raw CID\n    return `${this.gatewayUrl}/${cid}`;\n  }\n\n  /**\n   * Basic CID validation\n   *\n   * @param cid - Content identifier to validate\n   * @returns True if CID appears valid\n   */\n  private isValidCID(cid: string): boolean {\n    // Basic validation: CIDs typically start with 'Qm' or 'ba' and contain alphanumeric characters\n    // Allow shorter hashes for testing purposes\n    return (\n      /^[a-zA-Z0-9]{10,}$/.test(cid) &&\n      (cid.startsWith(\"Qm\") || cid.startsWith(\"ba\") || cid.includes(\"Test\"))\n    );\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/storage/providers/ipfs.ts"],"sourcesContent":["import {\n  StorageError,\n  type StorageProvider,\n  type StorageUploadResult,\n  type StorageFile,\n  type StorageListOptions,\n  type StorageProviderConfig,\n} from \"../index\";\nimport { toBase64 } from \"../../utils/encoding\";\n\nexport interface IpfsConfig {\n  /** IPFS API endpoint for uploads */\n  apiEndpoint: string;\n  /** Gateway URL for downloads (optional, defaults to public gateway) */\n  gatewayUrl?: string;\n  /** Additional headers for API requests */\n  headers?: Record<string, string>;\n}\n\ninterface IpfsUploadResponse {\n  Hash?: string;\n  Size?: number;\n}\n\n/**\n * Connects to any standard IPFS node or service provider\n *\n * @remarks\n * This provider implements the standard IPFS HTTP API (`/api/v0/add`) and works\n * with any IPFS-compatible service. It provides the essential IPFS operations\n * (upload/download) while maintaining the immutable, content-addressed nature\n * of IPFS. Use static factory methods for common providers like Infura or local nodes.\n *\n * @category Storage\n *\n * @example\n * ```typescript\n * // Use with Infura (recommended for production)\n * const ipfsStorage = IpfsStorage.forInfura({\n *   projectId: \"your-project-id\",\n *   projectSecret: \"your-project-secret\"\n * });\n *\n * // Use with local IPFS node\n * const localStorage = IpfsStorage.forLocalNode();\n *\n * // Upload file and get CID\n * const result = await ipfsStorage.upload(fileBlob, \"document.pdf\");\n * console.log(\"Uploaded to IPFS:\", result.url);\n * ```\n */\nexport class IpfsStorage implements StorageProvider {\n  private readonly gatewayUrl: string;\n  private readonly hasAuth: boolean;\n\n  constructor(private config: IpfsConfig) {\n    if (!config.apiEndpoint) {\n      throw new StorageError(\n        \"IPFS API endpoint is required\",\n        \"MISSING_API_ENDPOINT\",\n        \"ipfs\",\n      );\n    }\n\n    this.gatewayUrl = config.gatewayUrl ?? \"https://gateway.pinata.cloud/ipfs\";\n    this.hasAuth = !!(config.headers && Object.keys(config.headers).length > 0);\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for Infura\n   *\n   * @remarks\n   * Infura provides reliable, scalable IPFS infrastructure with global availability.\n   * This factory method automatically configures the correct endpoints and authentication\n   * for Infura's IPFS service.\n   *\n   * @param credentials - Infura project credentials\n   * @param credentials.projectId - Your Infura project ID\n   * @param credentials.projectSecret - Your Infura project secret\n   * @returns Configured IpfsStorage instance for Infura\n   *\n   * @example\n   * ```typescript\n   * const ipfsStorage = IpfsStorage.forInfura({\n   *   projectId: \"2FVGj8UJP5v8ZcnX9K5L7M8c\",\n   *   projectSecret: \"a7f2c1e5b8d9f3a6e4c8b2d7f9e1a4c3\"\n   * });\n   *\n   * const result = await ipfsStorage.upload(fileBlob);\n   * ```\n   */\n  static forInfura(credentials: {\n    projectId: string;\n    projectSecret: string;\n  }): IpfsStorage {\n    const encoder = new TextEncoder();\n    const auth = toBase64(\n      encoder.encode(`${credentials.projectId}:${credentials.projectSecret}`),\n    );\n    return new IpfsStorage({\n      apiEndpoint: \"https://ipfs.infura.io:5001/api/v0/add\",\n      gatewayUrl: \"https://ipfs.infura.io/ipfs\",\n      headers: {\n        Authorization: `Basic ${auth}`,\n      },\n    });\n  }\n\n  /**\n   * Creates an IPFS storage instance configured for a local IPFS node\n   *\n   * @remarks\n   * This factory method configures the storage provider to connect to a local IPFS node,\n   * typically running on your development machine or server. Assumes standard ports\n   * (5001 for API, 8080 for gateway) unless otherwise specified.\n   *\n   * @param options - Local node configuration options\n   * @param options.url - Base URL of the local IPFS node (defaults to http://localhost:5001)\n   * @returns Configured IpfsStorage instance for local node\n   *\n   * @example\n   * ```typescript\n   * // Use default localhost configuration\n   * const localStorage = IpfsStorage.forLocalNode();\n   *\n   * // Use custom local node URL\n   * const customStorage = IpfsStorage.forLocalNode({\n   *   url: \"http://192.168.1.100:5001\"\n   * });\n   *\n   * const result = await localStorage.upload(fileBlob, \"local-file.txt\");\n   * ```\n   */\n  static forLocalNode(options?: { url?: string }): IpfsStorage {\n    const baseUrl = options?.url ?? \"http://localhost:5001\";\n    return new IpfsStorage({\n      apiEndpoint: `${baseUrl}/api/v0/add`,\n      gatewayUrl: `${baseUrl.replace(\":5001\", \":8080\")}/ipfs`,\n    });\n  }\n\n  /**\n   * Uploads a file to IPFS and returns the content identifier (CID)\n   *\n   * @remarks\n   * This method uploads the file to the configured IPFS endpoint using the standard\n   * `/api/v0/add` API. The file is content-addressed, meaning the same file will\n   * always produce the same CID regardless of when or where it's uploaded.\n   *\n   * @param file - The file to upload to IPFS\n   * @param filename - Optional filename (for metadata purposes only)\n   * @returns Promise that resolves to StorageUploadResult with IPFS gateway URL\n   * @throws {StorageError} When the upload fails or no CID is returned\n   *\n   * @example\n   * ```typescript\n   * const result = await ipfsStorage.upload(fileBlob, \"report.pdf\");\n   * console.log(\"File uploaded to IPFS:\", result.url);\n   * // Example URL: \"https://gateway.pinata.cloud/ipfs/QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\"\n   * ```\n   */\n  async upload(file: Blob, filename?: string): Promise<StorageUploadResult> {\n    try {\n      const fileName = filename ?? `ipfs-file-${Date.now()}.dat`;\n\n      // Create FormData for IPFS upload\n      const formData = new FormData();\n      formData.append(\"file\", file, fileName);\n\n      const response = await fetch(this.config.apiEndpoint, {\n        method: \"POST\",\n        headers: this.config.headers ?? {},\n        body: formData,\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new StorageError(\n          `Failed to upload to IPFS: ${error}`,\n          \"UPLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      const result = (await response.json()) as IpfsUploadResponse;\n      const hash = result.Hash;\n\n      if (!hash) {\n        throw new StorageError(\n          \"IPFS upload succeeded but no hash returned\",\n          \"NO_HASH_RETURNED\",\n          \"ipfs\",\n        );\n      }\n\n      return {\n        url: `ipfs://${hash}`,\n        size: file.size,\n        contentType: file.type ?? \"application/octet-stream\",\n      };\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS upload error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"UPLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  /**\n   * Downloads a file from IPFS using its content identifier (CID)\n   *\n   * @remarks\n   * This method retrieves the file from IPFS using the configured gateway.\n   * It accepts various formats including raw CIDs, ipfs:// URLs, and gateway URLs.\n   * The file is downloaded from the globally distributed IPFS network.\n   *\n   * @param cid - The IPFS content identifier, ipfs:// URL, or gateway URL\n   * @returns Promise that resolves to the downloaded file content\n   * @throws {StorageError} When the download fails or CID format is invalid\n   *\n   * @example\n   * ```typescript\n   * // Download using raw CID\n   * const file = await ipfsStorage.download(\"QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Download using ipfs:// URL\n   * const file2 = await ipfsStorage.download(\"ipfs://QmTzQ1JRkWErjk39mryYw2WVrgBMe2B36gRq8GCL8qCACj\");\n   *\n   * // Create download link\n   * const url = URL.createObjectURL(file);\n   * ```\n   */\n  async download(cid: string): Promise<Blob> {\n    try {\n      const downloadUrl = this.buildDownloadUrl(cid);\n\n      const response = await fetch(downloadUrl);\n\n      if (!response.ok) {\n        throw new StorageError(\n          `Failed to download from IPFS: ${response.statusText}`,\n          \"DOWNLOAD_FAILED\",\n          \"ipfs\",\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (error instanceof StorageError) {\n        throw error;\n      }\n      throw new StorageError(\n        `IPFS download error: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        \"DOWNLOAD_ERROR\",\n        \"ipfs\",\n      );\n    }\n  }\n\n  async list(_options?: StorageListOptions): Promise<StorageFile[]> {\n    throw new StorageError(\n      \"List operation is not supported by standard IPFS. Use a service-specific provider like Pinata.\",\n      \"LIST_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  async delete(_url: string): Promise<boolean> {\n    throw new StorageError(\n      \"Delete operation is not supported by IPFS. Files are immutable once uploaded.\",\n      \"DELETE_NOT_SUPPORTED\",\n      \"ipfs\",\n    );\n  }\n\n  getConfig(): StorageProviderConfig {\n    return {\n      name: \"IPFS\",\n      type: \"ipfs\",\n      requiresAuth: this.hasAuth,\n      features: {\n        upload: true,\n        download: true,\n        list: false,\n        delete: false,\n      },\n    };\n  }\n\n  /**\n   * Build download URL from CID or existing URL\n   *\n   * @param cid - IPFS CID or URL\n   * @returns Gateway URL for download\n   */\n  private buildDownloadUrl(cid: string): string {\n    // If it's already a full URL, return as-is\n    if (cid.startsWith(\"http://\") || cid.startsWith(\"https://\")) {\n      return cid;\n    }\n\n    // Handle ipfs:// URLs\n    if (cid.startsWith(\"ipfs://\")) {\n      const hash = cid.replace(\"ipfs://\", \"\");\n      return `${this.gatewayUrl}/${hash}`;\n    }\n\n    // Validate CID format (basic validation)\n    if (!this.isValidCID(cid)) {\n      throw new StorageError(\n        \"Invalid IPFS CID or URL format\",\n        \"INVALID_CID\",\n        \"ipfs\",\n      );\n    }\n\n    // Assume it's a raw CID\n    return `${this.gatewayUrl}/${cid}`;\n  }\n\n  /**\n   * Basic CID validation\n   *\n   * @param cid - Content identifier to validate\n   * @returns True if CID appears valid\n   */\n  private isValidCID(cid: string): boolean {\n    // Basic validation: CIDs typically start with 'Qm' or 'ba' and contain alphanumeric characters\n    // Allow shorter hashes for testing purposes\n    return (\n      /^[a-zA-Z0-9]{10,}$/.test(cid) &&\n      (cid.startsWith(\"Qm\") || cid.startsWith(\"ba\") || cid.includes(\"Test\"))\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/storage/providers/pinata.cjs

@@ -34,6 +34,7 @@ class PinataStorage {
       );
     }
   }
+  config;
   apiUrl = "https://api.pinata.cloud";
   gatewayUrl;
   /**