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

@nexuss0781/envx-sdk

v0.1.0

Published

Typed TypeScript client for the ENVX project, environment, and API-key REST API.

Readme

@nexuss0781/envx-sdk

@nexuss0781/envx-sdk is a typed ESM client for the ENVX authenticated REST API. It is a separate library from the envx command-line package; it does not wrap or launch CLI commands.

Install

Install the SDK with:

npm install @nexuss0781/envx-sdk

The package can be built locally from this directory with npm test (TypeScript build, consumer type-check, and HTTP-mocked tests).

Create a client

The ENVX API authenticates requests with a Supabase user access token. Supply the token from your own Supabase Auth session; the SDK does not sign users in, persist tokens, refresh them, or include credentials in a URL. In the example, supabase is your application's configured Supabase client.

import { EnvxClient } from '@nexuss0781/envx-sdk';

const client = new EnvxClient({
  apiUrl: process.env.ENVX_API_URL!,
  // Read the current session token when each request is made.
  accessToken: async () => {
    const { data, error } = await supabase.auth.getSession();
    if (error || !data.session) throw new Error('Sign in to ENVX first.');
    return data.session.access_token;
  },
});

const projects = await client.listProjects();
const project = await client.createProject({ name: 'storefront', description: 'Commerce API' });
const environments = await client.listEnvironments(project.id);
const matches = await client.searchApiKeys('PAYMENT', { environmentId: environments[0]?.id });

Avoid hardcoding an access token in source code. Use a session/token provider appropriate to your runtime, and pass the server's public ENVX origin as apiUrl (for example https://envx-lemon.vercel.app). The deployment must have Supabase and the server-only encryption key configured before authenticated operations or secret writes can succeed.

Supported methods

  • Projects: listProjects, getProject, createProject, updateProject, deleteProject.
  • Environments: listEnvironments, createEnvironment, updateEnvironment, deleteEnvironment.
  • API keys: searchApiKeys, createApiKey, updateApiKey, deleteApiKey, revealApiKey.

Deletes require an explicit { confirm: true } argument in the SDK. Project deletion cascades to its environments and keys; environment deletion cascades to its keys. Label search returns metadata only (up to the API's 500-result limit); it never returns secret values. revealApiKey fetches one value on demand with cache: 'no-store' and returns it to the caller. The SDK does not cache or log that value, so handle it carefully in your application.

Errors are exposed as EnvxError, which includes an HTTP status and a safe message from the API response. Provide an updated token through the access-token callback after a 401; the SDK intentionally leaves authentication/session lifecycle to your app.