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 🙏

© 2026 – Pkg Stats / Ryan Hefner

@delimitus/ssc-files

v0.0.3

Published

Keep files through the SSC cell's file broker: signed links, no storage credentials. Zero dependencies.

Readme

@delimitus/ssc-files

Keep files from an SSC app: photos, uploads, exports. Zero dependencies; Node 22 or newer. An ES module; a CommonJS app can require() it on Node 22.12 or newer.

npm install @delimitus/ssc-files

Ask for file storage in ssc.toml:

[files]

The first deploy that asks sets up the cell's data gateway once (a few minutes); after that it is there.

import { get, link, put, remove } from '@delimitus/ssc-files';

await put('photos/cat.png', bytes, { contentType: 'image/png' });
const data = await get('photos/cat.png'); // Uint8Array
const { url } = await link('get', 'photos/cat.png'); // redirect a browser here to download
await remove('photos/cat.png');

Each call asks the data gateway for a signed link with the app's own identity, then sends the bytes to Cloud Storage; the app holds no storage credentials. The files belong to this environment alone: production and preview each have their own.

  • A file is at most 25 MB; an environment keeps at most 1 GB. remove frees space.
  • A name is /-separated segments of A-Z a-z 0-9 . _ -, each starting with a letter or digit, at most 256 characters.
  • A link lasts 10 minutes. A download always arrives as an attachment, so a stored HTML file is saved, never shown as a page.
  • Upload from the app's server, not from the browser: the bucket allows no browser-direct upload.
  • Files are not scanned for viruses.
  • When the app is disabled, no new link is given.

Errors are FilesError with a code: the data gateway's (FILE_NOT_FOUND, FILES_QUOTA_EXCEEDED, APP_NOT_ACTIVE, VALIDATION_FAILED, ...), STORAGE_<status> when Cloud Storage refused the transfer, or UNREACHABLE. The data gateway starts from zero, so a call to it is tried once more on a timeout, a lost connection or a 502, 503 or 504.

The gateway's address comes from the metadata server; SSC_DATAGW_URL replaces it. The Python helper is ssc_app.files, with the same names (delete for remove). The contract is docs/contracts/data-gateway.md#files.