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–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
NavojitAuth
✓ import { NavojitAuth } from 'navojit-auth'
✗ const NavojitAuth = require('navojit-auth')
ESM-only since v4. CommonJS require will fail.
AuthPayload
✓ import type { AuthPayload } from 'navojit-auth'
✗ import { AuthPayload } from 'navojit-auth'
AuthPayload is a TypeScript type, use `import type` for runtime safety.
fastifyAuth
✓ import { fastifyAuth } from 'navojit-auth/fastify'
✗ import { fastifyAuth } from 'navojit-auth'
Fastify plugin is exported from a subpath `navojit-auth/fastify`.
Initializes NavojitAuth with passkey provider and generates registration options.
import { NavojitAuth } from 'navojit-auth';
const auth = new NavojitAuth({
providers: {
passkey: { rpID: 'localhost', origin: 'http://localhost:3000' },
},
session: { secret: process.env.SESSION_SECRET ?? 'change-me' },
});
// Generate passkey registration options
const options = await auth.generateRegistrationOptions({ userId: 'user123' });
console.log('Registration options:', options);
Errors
Common errors & fixes
Cannot find module 'navojit-auth' or its corresponding type declarations.
Package not installed or ESM-only usage in CJS project.
fixInstall the package: `npm install navojit-auth` and ensure `type: 'module'` in package.json.
TypeError: NavojitAuth is not a constructor
Incorrect import using CommonJS `require` in v4.
fixChange to ESM import: `import { NavojitAuth } from 'navojit-auth'`. Missing required peer dependency: mongoose@>=8.0.0
Mongoose not installed or version too low.
fixInstall mongoose v8+: `npm install mongoose@8`.
Audit
Dependencies
drizzle-ormoptionalRequired for Drizzle ORM integration
fastifyoptionalRequired for Fastify plugin integration
mongooseoptionalRequired for Mongoose integration
postgresoptionalRequired for PostgreSQL native integration
Resources
No resource links recorded.