npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

airs3

v0.4.0

Published

AirS3 is a lightweight S3 HTTP client for browsers. It's designed to feel as egonomic as other HTTP clients such as [ky](https://github.com/sindresorhus/ky), except that the request signing process happens automatically in the background.

Downloads

5

Readme

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.