airs3 v0.4.0

AirS3

AirS3 is a lightweight S3 HTTP client for browsers. It's designed to feel as egonomic as other HTTP clients such as ky, except that the request signing process happens automatically in the background.

What This Solves

Amazon claims that S3 has a REST API. While this is technically true, the request signing process is so convoluted that practically speaking, you can't actually use it like a normal REST API. You need to access it via the Amazon SDK which is a JavaScript dependency that weighs in at about 15 ZB. Ok, so that's a bit of an exaggeration. But it's certainly not small.

The purpose of this library is to enable ergonomic access to the S3 REST API, and let the signing process take care of itself. This is handy when dealing with other S3-compatible services like Airbox and Cloudian that have proprietary features in their S3-compatible APIs.

This library is certainly more low-level than using the AWS SDK directly. You'll probably need to keep the AWS S3 API documentation open while using it. But there are efficiency wins by going this route.

Features

• Lightweight, only 3.7kb (GZipped + Minified)
• No dependencies
• Written in TypeScript (compiles with all strict options enabled)
• Code is well commented, optimized for readability, debuggability, and IntelliSense.
• Promise-based, fetch-style API, but uses XMLHttpRequest in order to support upload progress events.
• Distributes as a single JavaScript file.
• Uses the browser's DOMParser class to efficiently convert JSON POST/PUT bodies into XML.

Installation

With npm:

npm install airs3

Include directly from jsDelivr:

<script src="https://cdn.jsdelivr.net/npm/airs3/build/airs3.min.js"></script>

Code Examples

Coming soon.

Funding

The development of this library is funded by Airbox. This library is being used by Airbox's upcoming browser-based S3 file manager (which may also be open-sourced at some point). If you'd like to support this project, consider moving off of Amazon S3 and giving Airbox a try.