superauth-js

A tiny auth helper for Supabase + JWT, using jose.

Installation

npm install superauth-js

Usage

import { createSuperAuth } from 'superauth-js';

const superAuth = createSuperAuth({
  superAuthUrl: 'https://auth.yourdomain.com',
  superAuthPublicKey: 'YOUR_BASE64_ENCODED_PUBLIC_KEY',
  supabaseClient: supabase,
});

// Get URLs for auth pages
const signInUrl = superAuth.getSignInUrl(window.location.href);
const createAccountUrl = superAuth.getCreateAccountUrl(window.location.href);
const forgotPasswordUrl = superAuth.getForgotPasswordUrl(window.location.href);
const updatePasswordUrl = superAuth.getUpdatePasswordUrl(window.location.href);
const verifyEmailUrl = superAuth.getVerifyEmailUrl(window.location.href);

// Sign out
await superAuth.signOut();

// Handle token from URL (auto-called on creation in browser)
await superAuth.handleTokenFromUrl();

Development

Build

npm run build

Watch mode

npm run watch

Create local package for testing

npm run pack:local

This creates a .tgz file you can install in other projects:

# In your other project
npm install /path/to/superauth-js/superauth-js-0.1.x.tgz

Publishing to NPM

First-time setup

1. Create an NPM account at https://www.npmjs.com/signup
2. Login from the command line:

   npm login

Publishing a new version

1. Update the version in package.json:

   # Patch version (0.1.8 -> 0.1.9)
   npm version patch
   
   # Minor version (0.1.8 -> 0.2.0)
   npm version minor
   
   # Major version (0.1.8 -> 1.0.0)
   npm version major

2. Publish to NPM:

   npm publish

   The prepublishOnly script will automatically run npm run build before publishing.

3. Update consuming projects:

   # In your other project (e.g., simmer.io)
   npm update superauth-js
   # or for a specific version
   npm install [email protected]

Quick publish (one-liner)

npm version patch && npm publish