s3mini

Name: s3mini
Author: Unclaimed listing

Developer tools

Tiny and fast S3 client for node, bun and edge platforms.

Unclaimed listing

Found via hacker-news ↗

Visit ↗

Unclaimed listingDid you build s3mini?

Verify ownership to edit the listing, publish updates, access analytics, and use launch tools.

What it does

s3mini is a lightweight TypeScript S3-compatible object storage client built for Node.js, Bun, and edge runtimes like Cloudflare Workers. It focuses on the essential S3 APIs in a small, dependency-free package, making it a fit for developers who want to interact with S3 buckets from serverless and edge environments without pulling in large SDKs (no browser support).

Use s3mini when you need to upload, download, list, copy/move, or delete objects in an S3-compatible bucket across providers such as Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Ceph, Oracle Object Storage, Garage, and MinIO. You configure an endpoint (path-style or virtual-hosted style), credentials, and optional settings like region (defaults to “auto”), multipart thresholds, range-request chunk sizing, timeouts, custom logging, and a custom fetch implementation.

The core workflow starts by instantiating an S3mini client with access key, secret, and endpoint. From there, you can upload content using putObject for direct single-request uploads, or use putAnyObject (recommended) to automatically choose between a single PUT and multipart upload based on size. Multipart uploads include parallel part uploads, retries with exponential backoff, and cleanup by aborting incomplete uploads on failure. For advanced cases, s3mini also exposes manual multipart primitives (initialize upload, uploadPart, completeMultipartUpload), plus helpers for concurrency batching and cleanup of orphaned multipart uploads.

For reads, s3mini supports retrieving objects as text, ArrayBuffer, parsed JSON, or as a full Response for access to headers and streaming. It also supports AWS SigV4 signing, pre-signed URLs, conditional requests, and server-side encryption with customer-provided keys (SSE-C headers, tested on Cloudflare). Practical outcomes include smaller deploys for serverless/edge functions, a simpler API surface for common S3 tasks, and multipart uploads for large objects when needed—without adding extra dependencies.

Launch details