Storage Bubble

Cloudflare R2 storage operations for file management

Quick Start

import { StorageBubble } from '@bubblelab/bubble-core';
import { CredentialType } from '@bubblelab/shared-schemas';
const result = await new StorageBubble({
  operation: 'getUploadUrl',
  credentials: {
    [CredentialType.CLOUDFLARE_R2_ACCESS_KEY]: process.env.CLOUDFLARE_R2_ACCESS_KEY as string,
  },
}).action();

Operation Details

getUploadUrl

Input Schema

operation 'getUploadUrl' required

Generate presigned upload URL

bucketName string required

Name of the R2 bucket

fileName string required

Original filename for the upload

accountId string

Cloudflare Account ID - can be provided via credentials

region string

AWS region for R2 storage (defaults to auto)

expirationMinutes number

URL expiration time in minutes

contentType string

Content type for uploads

userId string

User ID for secure file isolation

credentials Record<CredentialType,string>

Object mapping credential types to values (injected at runtime)

Output Schema

operation 'getUploadUrl' required

Generate presigned upload URL

success boolean required

Whether the operation was successful

uploadUrl string

Presigned upload URL

fileName string

Secure filename generated for the upload

contentType string

Content type of the file

error string required

Error message if operation failed

getFile

Input Schema

operation 'getFile' required

Generate presigned download URL

bucketName string required

Name of the R2 bucket

fileName string required

Name of the file to retrieve

accountId string

Cloudflare Account ID - can be provided via credentials

region string

AWS region for R2 storage (defaults to auto)

expirationMinutes number

URL expiration time in minutes

userId string

User ID for secure file isolation

credentials Record<CredentialType,string>

Object mapping credential types to values (injected at runtime)

Output Schema

operation 'getFile' required

Generate presigned download URL

success boolean required

Whether the operation was successful

downloadUrl string

Presigned download URL

fileUrl string

Direct file access URL

fileName string

Name of the file

fileSize number

File size in bytes

contentType string

Content type of the file

lastModified string

Last modified timestamp in ISO format

error string required

Error message if operation failed

deleteFile

Input Schema

operation 'deleteFile' required

Delete file from bucket

bucketName string required

Name of the R2 bucket

fileName string required

Name of the file to delete

accountId string

Cloudflare Account ID - can be provided via credentials

region string

AWS region for R2 storage (defaults to auto)

credentials Record<CredentialType,string>

Object mapping credential types to values (injected at runtime)

Output Schema

operation 'deleteFile' required

Delete file from bucket

success boolean required

Whether the operation was successful

fileName string

Name of the deleted file

deleted boolean

Whether the file was successfully deleted

error string required

Error message if operation failed

updateFile

Input Schema

operation 'updateFile' required

Update/replace file content

bucketName string

fileName string required

Name of the file to update

accountId string

Cloudflare Account ID - can be provided via credentials

region string

AWS region for R2 storage (defaults to auto)

contentType string

Content type for uploads

fileContent string required

Base64 encoded file content or raw text content

credentials Record<CredentialType,string>

Object mapping credential types to values (injected at runtime)

Output Schema

operation 'updateFile' required

Update/replace file content and generate a new secure filename for the file

success boolean required

Whether the operation was successful

fileName string

Secure filename for the updated file (different from the original filename)

updated boolean

Whether the file was successfully updated

contentType string

Content type of the updated file

error string required

Error message if operation failed

getMultipleUploadUrls

Input Schema

operation 'getMultipleUploadUrls' required

Generate multiple presigned upload URLs for PDF + page images

bucketName string required

Name of the R2 bucket

pdfFileName string required

Original filename for the PDF

pageCount number required

Number of pages to generate upload URLs for

accountId string

Cloudflare Account ID - can be provided via credentials

region string

AWS region for R2 storage (defaults to auto)

expirationMinutes number

URL expiration time in minutes

userId string

User ID for secure file isolation

credentials Record<CredentialType,string>

Object mapping credential types to values (injected at runtime)

Output Schema

operation 'getMultipleUploadUrls' required

Generate multiple presigned upload URLs for PDF + page images

success boolean required

Whether the operation was successful

pdfUploadUrl string

Presigned upload URL for PDF

pdfFileName string

Secure filename for PDF

pageUploadUrls object[]

Array of upload URLs for page images

error string required

Error message if operation failed