TypeScript icon, indicating that this package has built-in type declarations

1.0.21 • Public • Published


NAuth is a library to authenticate users of your TrixCMS site in NodeJS.


Before using NAuth you must install the Auth plugin on your CMS


You can install the library via npm:

npm install @trixcms/nauth

How to use ?

First you need to define an instance of NAuth. The manufacturer will take the URL of your TrixCMS site as the first parameter and an optional second parameter, a timeout in milliseconds:

const NAuth = require('@trixcms/nauth')

const auth = new NAuth('http://website.domain')

Verify that a user exist

You can verify that a user exists with the exists (username: string): Promise <boolean> method which will take the username as a parameter. The method will return a promise to you.

const username = 'username'

    .then((exists) => {

        if(exists) {
            console.log('The account exists.')
        } else {
            console.log('The account does not exists.')

    .catch(() => {
        console.error('An error has occurred.')

Retrieve user information

You can verify that a user exists with the login (username: string, password: string): Promise <Profile> method which will take the username and password as parameters. The method will return you a promise with the profile:

const username = 'username'
const password = 'password'

auth.login(username, password)
    .then((profile) => {
    .catch(err => {
        if(err.code === 'INVALID_CREDENTIALS') {
            console.error('Bad credentials')
        } else {
            console.error('An error has occurred.')

List of properties available in the profile:

Property Type Description
id string The user ID.
uuid string User UUID.
username string Username of the user.
email string User email address.
money number Number of user store points.
hasAvatar boolean Does the user have an avatar.
isBanned boolean Is the user banned.
banReason string | null The reason for the ban if the user is banned.
isConfirmed boolean Has the user confirmed their email address.
hasTwoAuth boolean Has the user enabled dual authentication.
ranks string[] List of user ranks.
token string User token.
createdAt Date Date of creation of the account.
updatedAt Date Date of last modification of the account.

Code example

const NAuth = require('@trixcms/nauth')

// We create an instance of NAuth
const auth = new NAuth('https://example.domain/', 10000)

// We verify that the 'admin' account exists.
    .then((exists) => {
        if (exists) {
            // The 'admin' account exists!

            // We retrieve the account profile using the login method.
            auth.login('admin', '123456789')
                .then((profile) => {

                    // optional
                    if (profile.isBanned) {
                        // This account is banned
                        return console.log('This account is banned')

                    // optional
                    if (!profile.isConfirmed) {
                        // This account has not validated its email address.
                        return console.log('This account has not validated its email address.')

                    // You can retrieve account information:
                    const uuid = profile.uuid
                    const username = profile.username
                    const email = profile.email
                    const token = profile.token

                    console.log('Here is the information about the admin account:', uuid, username, email, token)
                .catch((err) => {
                    if (err.code === 'INVALID_CREDENTIALS') {
                        // Account credentials are invalid.
                        console.log('Account credentials are invalid.')
                    } else {
                        // An error has occurred.
                        console.log('An error has occurred.')
        } else {
            // The 'admin' account does not exist!
            console.log('This account does not exist')
    .catch(() => {
        console.log('An error has occurred.')

GitHub code size in bytes GitHub issues GitHub pull requests NPM GitHub package.json version

Package Sidebar


npm i @trixcms/nauth

Weekly Downloads






Unpacked Size

41.7 kB

Total Files


Last publish


  • nodenxt