Skip to main content

Authentication & JWT

Authentication & JWT

NodeStack provides native authentication with zero external dependencies.


Auth Collections (users)​

The users collection is a specialized auth collection with built-in:

  • Email address validation and uniqueness enforcement.
  • Password hashing with bcryptjs (salt rounds: 12).
  • Session token issuance with signed JSON Web Tokens (JWT).
  • Password reset and email change flows.

Authenticating with Password​

Via REST API​

Send a POST request to /api/collections/users/auth-with-password:

curl -X POST http://localhost:8090/api/collections/users/auth-with-password \
-H "Content-Type: application/json" \
-d '{
"identity": "user@example.com",
"password": "UserSecretPassword123!"
}'

Response:

{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"record": {
"id": "usr_9x8172ab",
"email": "user@example.com",
"created": "2026-10-15T08:00:00.000Z",
"updated": "2026-10-15T08:00:00.000Z"
}
}

Passing the Token in Subsequent Requests​

Add the Authorization header to protected requests:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Using nodestack-client​

The TypeScript client handles token storage and auto-header injection automatically:

import NodeStackClient from 'nodestack-client';

const client = new NodeStackClient('http://localhost:8090');

// Login
const authData = await client.collection('users').authWithPassword(
'user@example.com',
'UserSecretPassword123!'
);

console.log('Logged in user ID:', client.authStore.record.id);
console.log('Valid token:', client.authStore.isValid);

// Logout
client.authStore.clear();