AuthFI Node.js SDK

Official Node.js SDK for AuthFI — the identity control plane.

Install

npm install @queflyhq/authfi

Quick Start (Express)

const authfi = require('@queflyhq/authfi');

const auth = authfi({
  tenant: 'acme',
  apiKey: 'sk_live_...',
});

// Permission middleware
app.get('/api/users', auth.require('read:users'), (req, res) => {
  console.log(req.user); // decoded JWT claims
  res.json(users);
});

// Role middleware
app.get('/admin', auth.requireRole('admin'), handler);

// Start — syncs permissions + pre-fetches JWKS
auth.start().then(() => app.listen(3000));

Features

• JWKS + RS256 token verification with caching
• auth.require("read:users") — Express middleware
• auth.requireRole("admin") — role-based access
• auth.authenticate() — JWT only, no permission check
• Permission auto-sync on start()
• Cloud credentials (GCP/AWS/Azure/OCI)
• TypeScript definitions included
• Zero dependencies — uses Node.js crypto

Cloud Credentials (AuthFI Connect)

const creds = await auth.cloud.credentials(userToken, 'gcp', {
  project: 'my-project'
});

Running Tests

node --test test.js

13 unit tests — all passing.

License

MIT