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

@easypics/sdk

v0.0.1

Published

Official TypeScript SDK for the EasyPics Developer API.

Readme

EasyPics SDK

Official TypeScript SDK for the EasyPics Developer API.

Current status: early development (0.0.x). The public API may still change between releases.

The SDK is intentionally server-side only. EasyPics API keys are secrets and must not be shipped in browser bundles.

Install

npm install @easypics/sdk

Node.js 22 or newer is required.

Quick start

import { EasyPics } from '@easypics/sdk';

const easypics = new EasyPics({
  apiKey: process.env.EASYPICS_API_KEY!,
});

const media = await easypics.media.upload({
  file: './capture.png',
  visibility: 'UNLISTED',
});

console.log(media.url);

API access is request-only. See the Developer API page for access requirements and current limits.

Albums

const album = await easypics.albums.create({
  title: 'Project Screenshots',
  visibility: 'UNLISTED',
});

await easypics.media.upload({
  file: './build.png',
  albumId: album.id,
});

Available album methods:

await easypics.albums.create(input);
await easypics.albums.list({ limit: 20, cursor });
await easypics.albums.get(albumId);
await easypics.albums.update(albumId, input);
await easypics.albums.delete(albumId);
await easypics.albums.listMedia(albumId, { limit: 20, cursor });
await easypics.albums.attachMedia(albumId, mediaId);
await easypics.albums.removeMedia(albumId, mediaId);

Upload inputs

media.upload() accepts a filesystem path, Blob, Uint8Array, or ArrayBuffer.

await easypics.media.upload({
  file: bytes,
  fileName: 'avatar.png',
  title: 'Avatar',
  description: 'Generated during account setup',
  visibility: 'PRIVATE',
});

When uploading raw bytes or a nameless Blob, pass fileName explicitly.

Errors

API and transport failures throw EasyPicsError.

import { EasyPicsError } from '@easypics/sdk';

try {
  await easypics.albums.list();
} catch (error) {
  if (error instanceof EasyPicsError) {
    console.error(error.code, error.status);

    if (error.retryAfter) {
      console.error(`Retry after ${error.retryAfter}s`);
    }
  }
}

The SDK does not automatically retry requests. Some EasyPics operations create resources, so retry policy is left to the application instead of risking duplicate work.

Configuration

const easypics = new EasyPics({
  apiKey: process.env.EASYPICS_API_KEY!,
  timeoutMs: 30_000,
});

baseUrl and fetch can be overridden for testing and development.

Development

npm install
npm run typecheck
npm test
npm run build

The package has no runtime dependencies.

Release policy

The project starts at 0.0.1. During the early development phase, each published update increments the patch version (0.0.2, 0.0.3, and so on). See RELEASES.md for the stability and release policy.

Safety

The SDK is not a security boundary. API keys, authorization, rate limits, file validation, ownership checks, and quotas are enforced by the EasyPics API. The client intentionally does not retry write requests automatically.

See SECURITY.md for credential handling and vulnerability reporting.

License

MIT