Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
authMiddleware
✓ import { authMiddleware } from 'detexter-auth-kit'
✗ import authMiddleware from 'detexter-auth-kit'
Named export, not default. CommonJS: const { authMiddleware } = require('detexter-auth-kit')
signToken
✓ import { signToken } from 'detexter-auth-kit'
✗ const signToken = require('detexter-auth-kit').signToken
Named export, works in both ESM and CJS
verifyToken
✓ import { verifyToken } from 'detexter-auth-kit'
✗ import { verify } from 'detexter-auth-kit'
Exact function name is verifyToken, not verify
Shows login token generation and protected route with middleware; includes secret from environment variable.
import express from 'express';
import { authMiddleware, signToken, verifyToken } from 'detexter-auth-kit';
const app = express();
app.use(express.json());
app.post('/login', (req, res) => {
const payload = { id: 1, email: 'user@example.com' };
const token = signToken(payload, { secret: process.env.JWT_SECRET ?? 'fallback', expiresIn: '1h' });
res.json({ token });
});
app.get('/profile', authMiddleware({ secret: process.env.JWT_SECRET ?? 'fallback' }), (req, res) => {
res.json({ user: req.user });
});
app.listen(3000, () => console.log('Server running on port 3000'));
Errors
Common errors & fixes
TypeError: Cannot destructure property 'secret' of 'options' as it is undefined
authMiddleware or signToken called without options object or missing secret property.
fixCall authMiddleware({ secret: 'your-secret' }) or signToken(payload, { secret: 'your-secret' }) Error: secretOrPrivateKey must have a value
Secret is empty or undefined when calling signToken or verifyToken.
fixProvide a non-empty string as secret; check environment variable is set.
JsonWebTokenError: jwt malformed
Token string is corrupted, not a valid JWT, or contains extra whitespace.
fixEnsure token is exactly the JWT string; remove any extra quotes or spaces.
Audit
Dependencies
jsonwebtokenrequiredRequired for signToken and verifyToken functions