@voyant-travel/storage

@voyant-travel/storage

Storage provider abstraction for Voyant. StorageProvider interface plus providers for local (in-memory), Cloudflare R2, and S3-compatible (AWS SigV4 via Web Crypto — works in Cloudflare Workers).

Install

pnpm add @voyant-travel/storage

Usage

import { createStorageService } from "@voyant-travel/storage"
import { s3Provider } from "@voyant-travel/storage/providers/s3"

const storage = createStorageService(
  s3Provider({
    region: "us-east-1",
    bucket: "my-bucket",
    accessKeyId: env.AWS_ACCESS_KEY_ID,
    secretAccessKey: env.AWS_SECRET_ACCESS_KEY,
  }),
)

await storage.upload({ key: "files/x.pdf", body: buffer })
const url = await storage.signedUrl({ key: "files/x.pdf", expiresIn: 300 })

The S3 provider supports forcePathStyle and a custom endpoint for S3-compatible services (Wasabi, MinIO, etc.). SigV4 signing is verified against AWS canonical test vectors.

The R2 binding provider cannot mint signed URLs by itself. Configure either publicBaseUrl or a custom signer before calling signedUrl; otherwise the provider throws instead of returning a raw storage key.

Exports

License

Apache-2.0